node-red-contrib-casper v1.0.5

About Casper Node-RED

Provide a set of nodes to communicate with the Casper's blockchain

How to install

We assume that you have Node-RED installed (https://nodered.org/docs/getting-started/local)

Use the Palette to install this package or follow this how-to for local dev : https://nodered.org/docs/creating-nodes/first-node (section : Testing your node in Node-RED)

cd ~/.node-red
npm install node-red-contrib-casper
sudo service nodered restart

How to create your first flow

• You have to find a peer where you can connect.

  You can find the list here : https://cspr.live/tools/peers

  Select one peer in the list and take only his IP address.

• Drop any node on your flow and double-click on it to configure it

• You have to configure a "client". Use the IP Address found on cpsr.live. The default port is "7777" and the default protocol is "http".

List of available nodes

Get data from the Casper's blockchain

• get-state-root-hash
• get-account-uref-by-account-hash
• get-account-uref-by-public-key
• get-account-balance-by-uref
• get-block-info
• get-latest-block-info
• get-block-info-by-height
• get-era-switch-block-info
• get-block-state
• get-deploy
• get-dictionary-item-by-uref
• get-peers
• get-status
• get-transfers
• get-validators-info

Each node is documented inside Node-RED, you'll find what are the input and the output of each node.

Interact with contracts of the Casper's Blockchain

• convert-to-runtime-args
• module-bytes
• stored-contract-by-hash
• stored-contract-by-name
• stored-versioned-contract-by-hash
• stored-versioned-contract-by-name
• transfer
• put-depoy

Each node is documented inside Node-RED, you'll find what are the input and the output of each node.

Casper Sign

When you want to interact with a contract, you have to add the information of the account who will interact with it.

In order to do that, we have implemented a node where you can specify your information. These information will be used to sign the transaction.

DO NOT SHARE THESE INFORMATION WITH OTHER PEOPLE

You have to specify the private key pem and the public key pem of your account in order to sign the transaction correctly. Copy only the necessary information not the "---- BEGIN/END ----".

The private key comes from cspr.live.

You can generate the public key pem using the following openssl command :

For Ed25519 :

openssl pkey -in private_key_from_csprlive.pem -out public_key.pem -pubout -outform PEM

For Secp256K1 :

openssl pkey -in private_key_from_csprlive.pem -out public_key.pem -pubout -outform PEM -conv_form compressed

How to test

Run the following command :

git clone git@github.com:caspercommunityio/node-red-contrib-casper.git
cd node-red-contrib-casper
npm i
npm test

Examples

You can find different example inside the folder "examples".

License

The Casper NodeRED package is an open-sourced software licensed under the MIT license.