chintwoweb v1.0.1
What is ChintwoWeb?
ChintwoWeb aims to deliver a unified, seamless development experience influenced by Ethereum's Web3 implementation. We have taken the core ideas and expanded upon it to unlock the functionality of CHINTWO's unique feature set along with offering new tools for integrating DApps in the browser, Node.js and IoT devices.
Compatibility
- Version built for Node.js v6 and above
- Version built for browsers with more than 0.25% market share
You can access either version specifically from the dist folder.
ChintwoWeb is also compatible with frontend frameworks such as:
- Angular
- React
- Vue.
You can also ship ChintwoWeb in a Chrome extension.
Installation
Node.js
npm install chintwoweb
or
yarn add chintwoweb
Browser
First, don't use the release section of this repo, it has not updated in a long time.
Then easiest way to use ChintwoWeb in a browser is to install it as above and copy the dist file to your working folder. For example:
cp node_modules/chintwoweb/dist/ChintwoWeb.js ./js/chintwoweb.js
so that you can call it in your HTML page as
<script src="./js/chintwoweb.js"><script>
Your local private network for heavy testing
You can set up your own private network, running Chintwo Quickstart. To do it you must install Docker and, when ready, run a command like
docker run -it --rm \
-p 9090:9090 \
-e "defaultBalance=100000" \
-e "showQueryString=true" \
-e "showBody=true" \
-e "formatJson=true" \
--name chintwo \
chintwotools/quickstart
Creating an Instance
First off, in your javascript file, define ChintwoWeb:
const ChintwoWeb = require('chintwoweb')
The easiest way to instantiate chintwoWeb is to run
const chintwoWeb = new ChintwoWeb({
fullHost: 'http://ip:port',
solidityNode: 'http://ip:port'
eventServer: 'http://ip:port',
privateKey: '...'
})
but you can continue to use the old way:
const chintwoWeb = new ChintwoWeb(fullNode, solidityNode, eventServer, privateKey)
## A full example
The better way to understand how to work with Chintwo is to clone the [MetaCoin example]
## Contributions
In order to contribute you can
* fork this repo and clone it locally
* install the dependencies — `npm i`
* do your changes to the code
* build the ChintwoWeb dist files — `npm run build`
* run a local private network using Chintwo Quickstart
* run the tests — `npm test:node`
* push your changes and open a pull request