RChain client for node.js, browsers
npm install rchain-client-apiAn API for dApp frontends to communicate with the RChain blockchain.
The [RChain Cooperative][1] is developing a decentralized, economically sustainable public compute infrastructure. Decentralized applications or "dApps" will run their business logic as smart contracts on the blockchain. Their user interfaces will be more traditional programs that interact with the blockchain as a backend. This separation allows dApp developers to create nice abstract interfaces, and allows end users to create their own sovereign interfaces should they choose to do so.
[1]: https://www.rchain.coop/
Install with npm install rchain-community/rchain-api. Then,
to get current block info from testnet:
``js
import { RNode } = from 'rchain-api';
const obs = RNode(fetch)
.observer('https://observer.testnet.rchain.coop');
(async () => {
const blocks = await rnode.getBlocks(1);
assert.ok(blocks[0].blockHash);
})();
`
If your node is a validator and you have a key to authorize payment, you can deploy code:
`js
const grpc = require('grpc');
const { RNode, signDeploy } = require('rchain-api');
const val = RNode(fetch)
.validator('https://node1.testnet.rchain-dev.tk');
const term = '@"world"!("Hello!")';
const myKey = '11'.repeat(32);
const timestamp = new Date('2019-04-12T17:59:29.274Z').valueOf();
const [recent] = await observer.getBlocks(1);
const info = signDeploy(myKey, { timestamp, term, phloLimit: 10000, phloPrice: 1, validAfterBlockNumber: recent.blockNumber });
rnode.deploy(info).then((message) => { assert(message.startsWith('Success')); });
`
Choices include:
- [RChain testnet][testnet] nodes such as node4.testnet.rchain-dev.tk
- a community node at
- [running your own RNode][2]
[testnet]: https://rchain.atlassian.net/wiki/spaces/CORE/pages/678756429/RChain+public+testnet+information
[2]: https://rchain.atlassian.net/wiki/spaces/CORE/pages/428376065/User+guide+for+running+RNode
Apache 2.0 License (See LICENSE.txt)
Contributions welcome (See CONTRIBUTING.md)