node-red nodes for Tezos

Tezos is an open-source blockchain for assets and applications that can evolve by upgrading itself. Stakeholders govern upgrades to the core protocol, including upgrades to the amendment process itself.

This package provides the following node-red nodes to interact with the Tezos blockchain:

• transfer
• originate
• call-contract
• generate-keys
• get-contrat
• confirm

The RPC provider is set in the configuration panel of the nodes.

transfer

Transfers Tezis from an account to another.

Parameter	Desc	Msg.payload entry
RPC provider	RPC provider URL	-
Secret	Private key of sender	secret
Faucet	Faucet in JSON format of sender (if no private key)	faucet
Destination	Address of receiver	destination
Amount	Amount of Tezis to transfer	amount

This node may be paramterized by the following payload JSON object:

{
    "secret": "... sender's private key ...",
    "destination": "tz1... receiver address...",
    "amount": ... number of tezis ...
}

If success, the node returns the following payload:

{
    "res": true,
    "op": { ... operation object ... }
}

If fail:

{
    "res": false
}

originate

Originates a smart contract.

Parameter	Desc	Msg.payload entry
RPC provider	RPC provider URL	-
Secret	Private key of originator	secret
Faucet	Faucet in JSON format of originator (if no private key)	faucet
Code	Michelin codes for code in JSON	code
Storage	Michelin codes for storage in JSON	storage

This node may be paramterized by the following payload JSON object:

{
    "secret": "... originator's private key ...",
    "code": [ ... Michelin code of contract ... ],
    "storage": { ... Michelin code of contract  storage ... }
}

The Michelin code may be obtained from Tezos client's originate command in dry and verbose mode.

If success, the node returns the following payload:

{
    "res": true,
    "op": { ... operation object ... }
}

If fail:

{
    "res": false
}

call-contract

Calls a smart contract's entry point.

Parameter	Desc	Msg.payload entry
RPC provider	RPC provider URL	-
Secret	Private key of originator	secret
Faucet	Faucet in JSON format of originator (if no private key)	faucet
Address	Address of the smart contract	addr
Entry	Name of the entry point to call	entry
Arguments	List of arguments to pass	args
Amount	Amount of tezis to transfer to the call (0 if not specified)	amount

This node may be paramterized by the following payload JSON object:

{
    "secret": "... originator's private key ...",
    "addr": "KT1... address of the smart contract ... ",
    "entry": "... name of the entry point ...",
    "args": [ ... list of arguments ... ],
    "amount" : ... number of tezis to transfer ...
}

For example, say the contract has an exec entry point which takes a string and an integer as argments; the following is an example value of the args entry:

{
    "args" : [ "this is a string", 1 ]
}

The order in which arguments are passed may be derived for example from the "interact" panel of you.better-call.dev

If success, the node returns the following payload:

{
    "res": true,
    "op": { ... operation object ... }
}

If fail:

{
    "res": false
}

generate-keys

Generates keys for a new account.

Parameter	Desc	Msg.payload entry
Mnemonic	List of mnemonic words (optional)	mnemonic

If no menomic is provided, the node generates a random one.

It generates the following payload structure:

{
    "mnemonic" : [... list of mnemonic words ...],
    "publicKeyHash": "...",
    "publicKey": "...",
    "privateKey": "..."
}

get-contract

Set msg.payload to be the POJO version of the storage of a smart contract.

Parameter	Desc	Msg.payload entry
RPC provider	RPC provider URL	-
Address	Address of the smart contract	addr

This node does not currently work for big maps.

confirm

Confirms an operation.

Parameter	Desc	Msg.payload entry
Confirmation	Number of confirmations to wait for	-
Operation	operation object	op

Operations object are currently too big for node-red to be passed from one node to the other ...

---

All nodes except generate-keys use the Taquito library.

The generate-key node uses the Conseiljs library.

---

Nodes developped by

a service by edukera.