This repo contains examples how to use @tgrospic/rnode-grpc-js helper library to generate RNode API for Nodejs and the browser. There you can find more information about API, how to install it and use it.
Web example is published from gh-pages branch on this url https://tgrospic.github.io/rnode-client-js.
RNode has support for Ethereum type of signatures so Metamask can be used for signing deploys e.g. making transfers of REVs. In Web example, button to add selected Metamask account should be visible next to REV import textbox.
Helper functions are in eth-wrapper.js which contains the code for communication with Metamask, getting selected ETH address and sending deploys for signing.
In eth-sign.js are functions to verify deploy signature and to extract public key.
This is all that is needed for communication with Metamask and also for connected hardware wallets (Ledger). How to use these functions and send deploys to RNode is in node-web.js.
Changes on the web page are only saved in memory so it will be lost after refreshing the page.
RChain networks available for selection are in rchain-networks.js file.
Install project dependencies (in ./node_modules folder).
# Post-install script will run generator automatically
npm installGenerate JS bindings (default in ./rnode-grpc-gen).
# Defined as script command in package.json
npm run rnode-generate
# Or call executable script directly from npm bin folder
# - which is in the PATH when npm scripts are executed
node_modules/.bin/rnode-grpcRNode now supports HTTP but propose is only available on gRPC endpoint which is not yet supported in browsers. So in Web example Envoy proxy is used to call propose.
In the project is Docker compose configuration to run local RChain network and also for Envoy proxy.
# Starts RNode and Envoy proxy in daemon mode
docker-compose up -d
# If read-only node is not initially connected, it can be restarted
docker-compose restart readRun Nodejs example (src/nodejs/client.js)
In src/nodejs/client.js script is an example of how to connect to RNode from Nodejs.
# Run nodejs example / sample requests to RChain testnet
npm run start-nodejsRun Browser example (src/web/index.js)
This will start local Nodejs dev server in watch mode http://localhost:1234.
Test page contains a list of testnet validators with a button to make sample requests and print outputs.
The code for Nodejs is almost the same as for the browser, the only difference is gRPC protocol implementation. @grpc/grpc-js, grpc for Nodejs or grpc-web for the browser.
# Run web example / sample request to Envoy proxy
# - proxy is available for RChain testnet
npm run start-webTypeScript version (src/web-ts/index.ts)
npm run start-web-tsWeb site can be compiled to static page which can be opened with double click on index.html in ./dist directory where the page is built. This is exactly what we need for offline wallet. :)
Because it's a static page it can be published directly on Github via gh-pages branch which contains compiled files from ./dist directory. It is visible on this url https://tgrospic.github.io/rnode-client-js. If you fork this repo you can do this with you own version of app.
# Compile static web site (to ./dist folder)
npm run build-webrnode-grpc-js library also generates a TypeScript definition file that can be referenced in your code and can provide IntelliSense support in VSCode.
/// <reference path="../../rnode-grpc-gen/js/rnode-grpc-js.d.ts" />
List of proxies to validators in RChain testnet network.
gRPC node{0-n}.NETWORK.rchain-dev.tk:40401
HTTP https://NETWORK-{0-n}.grpc.rchain.isotypic.com
| gRPC | HTTP |
|---|---|
| node0.testnet.rchain-dev.tk:40401 | https://testnet-0.grpc.rchain.isotypic.com |
| node1.testnet.rchain-dev.tk:40401 | https://testnet-1.grpc.rchain.isotypic.com |
| node2.testnet.rchain-dev.tk:40401 | https://testnet-2.grpc.rchain.isotypic.com |
| node3.testnet.rchain-dev.tk:40401 | https://testnet-3.grpc.rchain.isotypic.com |
| node4.testnet.rchain-dev.tk:40401 | https://testnet-4.grpc.rchain.isotypic.com |
| node5.testnet.rchain-dev.tk:40401 | https://testnet-5.grpc.rchain.isotypic.com |
| node6.testnet.rchain-dev.tk:40401 | https://testnet-6.grpc.rchain.isotypic.com |
| node7.testnet.rchain-dev.tk:40401 | https://testnet-7.grpc.rchain.isotypic.com |
| node8.testnet.rchain-dev.tk:40401 | https://testnet-8.grpc.rchain.isotypic.com |
| node9.testnet.rchain-dev.tk:40401 | https://testnet-9.grpc.rchain.isotypic.com |