List of commands for interact with the shared funds transactions.
- EMIT DELEGATE HOLD - holds funds on the shared funds account
- EMIT DELEGATE REFILL - refills funds on the specified shared funds transaction
- EMIT DELEGATE TAKE - takes funds from the conditional out of the shared funds transaction
- EMIT DELEGATE SIGN - sings debit transaction with valid public key
- EMIT DELEGATE INFO - shows info about the specified shared funds transaction
Usage example of all commands - Shared Funds Usage Example
Node Command - EMIT DELEGATE HOLD
Holds funds on the shared funds account
CLI Example
Command syntax:
emit_delegate hold
-net <net_name>
-w <wallet_name>
-token <ticker>
-value <value>
-fee <value>
-signs_minimum <value_int>
-pkey_hashes <hash1[,hash2,...,hashN]>
[-chain <chain_name>]
[-H {hex(default) | base58}
Options:
-net - name of the Cellframe Network. The list of networks can be found in the <Config_dir> \ etc \ network folder or received by The Cellframe-Node-CLI using command - net list
-w - the name of the wallet from which funds will be taken
-token - ticker of the token
-value - amount of funds being taken for holding
-fee - commission for transaction
-signs_minimum - quantity of required valid signatures fot funds debit
-pkey_hashes - public keys of users who have the right to participate in the consensus of the funds withdrawal (minimum - 1)
-chain - name of the preferred chain where transaction will be put: zerochain or mainchain (optional)
-H - hash format: HEX or base58 (optional)
Example:
Command:
cellframe-node-cli emit_delegate hold -net raiden -w main_wallet -token tCELL -value 1000.0 -fee 1.0 -signs_minimum 2 -pkey_hashes 0x0E9D0534BD148C2373CC78C5834D08246A52F6D169DEAB99F8D7CCEAF107A1CE,0xF8DA3298DFC838741ABAA8D8AA5056E54D0FC15E8FC0EF3A89290476778FC1D5,0x011FCE96B76FBA54F5EB67AA134A013C3BD52EB88A4132A7F5C1939807F3D5A7
Response:
status: succes
tx_hash: 0x8A19FC2BA2BEBFAD5F8FEA9E56902D059E391CD05E1A692AD47BCA00FA601F41**
JSON-RPC Example
Command:
curl -s --unix-socket /opt/cellframe-node/var/run/node_cli -X POST http://localhost/connect -d '{"method":"emit_delegate", "subcommand":["hold"], "arguments":{"net":"raiden","w":"main_wallet","token":"tCELL","value":"1000.0","fee":"1.0","signs_minimum":"2","pkey_hashes":"0x0E9D0534BD148C2373CC78C5834D08246A52F6D169DEAB99F8D7CCEAF107A1CE,0xF8DA3298DFC838741ABAA8D8AA5056E54D0FC15E8FC0EF3A89290476778FC1D5,0x011FCE96B76FBA54F5EB67AA134A013C3BD52EB88A4132A7F5C1939807F3D5A7"}, "id":"1"}'
Response:
{
"type": 2,
"result": [
{
"status": "success",
"tx_hash": "0x392D426B48EC0B66A333EBB074F1E8F2A3D1CFD7F7C5E5DC71BD25FE0D2363F0"
}
],
"id": 1
}
Node Command - EMIT DELEGATE HOLD
Holds funds on the shared funds account
CLI Example
Command syntax:
emit_delegate hold
-net <net_name>
-w <wallet_name>
-token <ticker>
-value <value>
-fee <value>
-signs_minimum <value_int>
-pkey_hashes <hash1[,hash2,...,hashN]>
[-chain <chain_name>]
[-H {hex(default) | base58}Options:
-net - name of the Cellframe Network. The list of networks can be found in the <Config_dir> \ etc \ network folder or received by The Cellframe-Node-CLI using command - net list
-w - the name of the wallet from which funds will be taken
-token - ticker of the token
-value - amount of funds being taken for holding
-fee - commission for transaction
-signs_minimum - quantity of required valid signatures fot funds debit
-pkey_hashes - public keys of users who have the right to participate in the consensus of the funds withdrawal (minimum - 1)
-chain - name of the preferred chain where transaction will be put: zerochain or mainchain (optional)
-H - hash format: HEX or base58 (optional)Example:
Command:
cellframe-node-cli emit_delegate hold -net raiden -w main_wallet -token tCELL -value 1000.0 -fee 1.0 -signs_minimum 2 -pkey_hashes 0x0E9D0534BD148C2373CC78C5834D08246A52F6D169DEAB99F8D7CCEAF107A1CE,0xF8DA3298DFC838741ABAA8D8AA5056E54D0FC15E8FC0EF3A89290476778FC1D5,0x011FCE96B76FBA54F5EB67AA134A013C3BD52EB88A4132A7F5C1939807F3D5A7Response:
status: succes
tx_hash: 0x8A19FC2BA2BEBFAD5F8FEA9E56902D059E391CD05E1A692AD47BCA00FA601F41**JSON-RPC Example
Command:
curl -s --unix-socket /opt/cellframe-node/var/run/node_cli -X POST http://localhost/connect -d '{"method":"emit_delegate", "subcommand":["hold"], "arguments":{"net":"raiden","w":"main_wallet","token":"tCELL","value":"1000.0","fee":"1.0","signs_minimum":"2","pkey_hashes":"0x0E9D0534BD148C2373CC78C5834D08246A52F6D169DEAB99F8D7CCEAF107A1CE,0xF8DA3298DFC838741ABAA8D8AA5056E54D0FC15E8FC0EF3A89290476778FC1D5,0x011FCE96B76FBA54F5EB67AA134A013C3BD52EB88A4132A7F5C1939807F3D5A7"}, "id":"1"}'Response:
{
"type": 2,
"result": [
{
"status": "success",
"tx_hash": "0x392D426B48EC0B66A333EBB074F1E8F2A3D1CFD7F7C5E5DC71BD25FE0D2363F0"
}
],
"id": 1
}Node Command - EMIT DELEGATE REFILL
Refills funds on the specified shared funds transaction
CLI Example
Command syntax:
emit_delegate refill
-net <net_name>
-w <wallet_name> - wallet to writeoff value and pay fee
-value <value> - value to refill
-fee <value> - fee value
-tx <transaction_hash> - emit delegate tx hash to refill
[-H {hex(default) | base58}] - datum hash return format
Options:
-net - name of the Cellframe Network. The list of networks can be found in the <Config_dir> \ etc \ network folder or received by The Cellframe-Node-CLI using command - net list
-w - the name of the wallet from which funds will be taken
-value - amount of funds being taken for refill
-fee - commission for transaction
-tx - hash of the shared funds transaction is being refilled
-H - hash format: HEX or base58 (optional)
Example:
Command:
cellframe-node-cli emit_delegate refill -net foobar -w foobar_root_0 -value 10000.0 -fee 5.0 -tx 0x6F6C94C2810E62B791E62E73985901B1E21B568E0AFE78744385F4D38FD5F84
Response:
status: success
tx_hash: 0xE3180D8A8AF9859242303D082A87E2B4EA128EEF4AC490BB40A85E2C02F173B4
JSON-RPC Example
Command:
curl -s --unix-socket /opt/cellframe-node/var/run/node_cli -X POST http://localhost/connect -d '{"method":"emit_delegate", "subcommand":["refill"], "arguments":{"net":"foobar","w":"foobar_root_0","value":"10000.0","fee":"5.0","tx":"0x6F6C94C2810E62B791E62E73985901B1E21B568E0AFE78744385F4D38FD5F84E"}, "id":"1"}'
Response:
{
"type": 2,
"result": [
{
"status": "success",
"tx_hash": "0xDD0F74060740BCF7B9844D10FE2A058B48F9265C74752D1459738F00512EBE4F"
}
],
"id": 1
}
Node Command - EMIT DELEGATE REFILL
Refills funds on the specified shared funds transaction
CLI Example
Command syntax:
emit_delegate refill
-net <net_name>
-w <wallet_name> - wallet to writeoff value and pay fee
-value <value> - value to refill
-fee <value> - fee value
-tx <transaction_hash> - emit delegate tx hash to refill
[-H {hex(default) | base58}] - datum hash return formatOptions:
-net - name of the Cellframe Network. The list of networks can be found in the <Config_dir> \ etc \ network folder or received by The Cellframe-Node-CLI using command - net list
-w - the name of the wallet from which funds will be taken
-value - amount of funds being taken for refill
-fee - commission for transaction
-tx - hash of the shared funds transaction is being refilled
-H - hash format: HEX or base58 (optional)Example:
Command:
cellframe-node-cli emit_delegate refill -net foobar -w foobar_root_0 -value 10000.0 -fee 5.0 -tx 0x6F6C94C2810E62B791E62E73985901B1E21B568E0AFE78744385F4D38FD5F84Response:
status: success
tx_hash: 0xE3180D8A8AF9859242303D082A87E2B4EA128EEF4AC490BB40A85E2C02F173B4JSON-RPC Example
Command:
curl -s --unix-socket /opt/cellframe-node/var/run/node_cli -X POST http://localhost/connect -d '{"method":"emit_delegate", "subcommand":["refill"], "arguments":{"net":"foobar","w":"foobar_root_0","value":"10000.0","fee":"5.0","tx":"0x6F6C94C2810E62B791E62E73985901B1E21B568E0AFE78744385F4D38FD5F84E"}, "id":"1"}'Response:
{
"type": 2,
"result": [
{
"status": "success",
"tx_hash": "0xDD0F74060740BCF7B9844D10FE2A058B48F9265C74752D1459738F00512EBE4F"
}
],
"id": 1
}Node Command - EMIT DELEGATE TAKE
Takes funds from the conditional out of the Shared Funds transaction
Important
You can use hash of the original shared funds transaction and also hash of the all subsequent debit transactions as well - example. But the actual information about remaining funds you can see only using hash of the last transaction.
CLI Example
Command syntax:
emit_delegate take
-net <net_name>
-w <wallet_name>
-tx <transaction_hash>
-to_addr <addr>
-value <value>
-fee <value>
[-chain <chain_name>]
[-H {hex(default) | base58}]
Options:
-net - name of the Cellframe Network. The list of networks can be found in the <Config_dir> \ etc \ network folder or received by The Cellframe-Node-CLI using command - net list
-w - the name of the wallet which has a right to debit funds
-tx - hash of the shared funds transcaction
-to_addr - wallet address where funds will be transferred
-value - amount of funds being taken
-fee - commission for transaction
-chain - name of the preferred chain where transaction will be put: zerochain or mainchain (optional)
-H - hash format: HEX or base58 (optional)
Example:
Command:
cellframe-node-cli emit_delegate take -net raiden -w second_wallet -tx 0x8A19FC2BA2BEBFAD5F8FEA9E56902D059E391CD05E1A692AD47BCA00FA601F41 -to_addr jrmnGqeeds4Dp67AZE9LY5uWW5zrbm8ugCYn5BJ6GXFdZiZkDgkAPPPvQkTTZxzjLj3LsabF8Zz96kkcmXZf4phyUskWZYSNW3TpKjqF -value 100.0 -fee 1.0
Response:
status: success
tx_hash: 0x195CA09401AC37B5C559B15B435BBA431733902DB4ACF110F77AA1CE60756DD6
JSON-RPC Example
Command:
curl -s --unix-socket /opt/cellframe-node/var/run/node_cli -X POST http://localhost/connect -d '{"method":"emit_delegate", "subcommand":["take"], "arguments":{"net":"raiden","w":"second_wallet","tx":"0x392D426B48EC0B66A333EBB074F1E8F2A3D1CFD7F7C5E5DC71BD25FE0D2363F0","to_addr":"jrmnGqeeds4Dp67AZE9LY5uWW5zrbm8ugCYn5BJ6GXFdZiZkDgkAPPPvQkTTZxzjLj3LsabF8Zz96kkcmXZf4phyUskWZYSNW3TpKjqF","value":"100.0","fee":"1.0"}, "id":"1"}'
Response:
{
"type": 2,
"result": [
{
"status": "success",
"tx_hash": "0x81868733C221B9B0B78251CBA81E5CD3066DF0E51FBB62BD2B1FFAD70FBE5579"
}
],
"id": 1
}
Node Command - EMIT DELEGATE TAKE
Takes funds from the conditional out of the Shared Funds transaction
Important
You can use hash of the original shared funds transaction and also hash of the all subsequent debit transactions as well - example. But the actual information about remaining funds you can see only using hash of the last transaction.
CLI Example
Command syntax:
emit_delegate take
-net <net_name>
-w <wallet_name>
-tx <transaction_hash>
-to_addr <addr>
-value <value>
-fee <value>
[-chain <chain_name>]
[-H {hex(default) | base58}]Options:
-net - name of the Cellframe Network. The list of networks can be found in the <Config_dir> \ etc \ network folder or received by The Cellframe-Node-CLI using command - net list
-w - the name of the wallet which has a right to debit funds
-tx - hash of the shared funds transcaction
-to_addr - wallet address where funds will be transferred
-value - amount of funds being taken
-fee - commission for transaction
-chain - name of the preferred chain where transaction will be put: zerochain or mainchain (optional)
-H - hash format: HEX or base58 (optional)Example:
Command:
cellframe-node-cli emit_delegate take -net raiden -w second_wallet -tx 0x8A19FC2BA2BEBFAD5F8FEA9E56902D059E391CD05E1A692AD47BCA00FA601F41 -to_addr jrmnGqeeds4Dp67AZE9LY5uWW5zrbm8ugCYn5BJ6GXFdZiZkDgkAPPPvQkTTZxzjLj3LsabF8Zz96kkcmXZf4phyUskWZYSNW3TpKjqF -value 100.0 -fee 1.0Response:
status: success
tx_hash: 0x195CA09401AC37B5C559B15B435BBA431733902DB4ACF110F77AA1CE60756DD6JSON-RPC Example
Command:
curl -s --unix-socket /opt/cellframe-node/var/run/node_cli -X POST http://localhost/connect -d '{"method":"emit_delegate", "subcommand":["take"], "arguments":{"net":"raiden","w":"second_wallet","tx":"0x392D426B48EC0B66A333EBB074F1E8F2A3D1CFD7F7C5E5DC71BD25FE0D2363F0","to_addr":"jrmnGqeeds4Dp67AZE9LY5uWW5zrbm8ugCYn5BJ6GXFdZiZkDgkAPPPvQkTTZxzjLj3LsabF8Zz96kkcmXZf4phyUskWZYSNW3TpKjqF","value":"100.0","fee":"1.0"}, "id":"1"}'Response:
{
"type": 2,
"result": [
{
"status": "success",
"tx_hash": "0x81868733C221B9B0B78251CBA81E5CD3066DF0E51FBB62BD2B1FFAD70FBE5579"
}
],
"id": 1
}Node Command - EMIT DELEGATE SIGN
Sings debit transaction with valid public key
CLI Example
Command syntax:
emit_delegate sign
-net <net_name>
-w <wallet_name>
-tx <transaction_hash>
[-chain <chain_name>]
[-H {hex(default) | base58}]
Options:
-net - name of the Cellframe Network. The list of networks can be found in the <Config_dir> \ etc \ network folder or received by The Cellframe-Node-CLI using command - net list
-w - the name of the signing wallet
-tx - hash of the debit transaction
-chain - name of the preferred chain where transaction will be put: zerochain or mainchain (optional)
-H - hash format: HEX or base58 (optional)
Example:
Command:
cellframe-node-cli emit_delegate sign -net raiden -w third_wallet -tx 0x075051A67F29290D73192C13685D173C1017A973DC5E0AC7DFDA0AB3CF60AAE9
Response:
status: success
tx_hash: 0x61B12392FDD90D9A8247DFC7EDDF85DF18CC372240769EE78DC521BDF3B659AF
JSON-RPC Example
Command:
curl -s --unix-socket /opt/cellframe-node/var/run/node_cli -X POST http://localhost/connect -d '{"method":"emit_delegate", "subcommand":["sign"], "arguments":{"net":"raiden","w":"third_wallet","tx":"0x81868733C221B9B0B78251CBA81E5CD3066DF0E51FBB62BD2B1FFAD70FBE5579"}, "id":"1"}'
Response:
{
"type": 2,
"result": [
{
"status": "success",
"tx_hash": "0x9DEF553A0190E3448DFDEB4278C46718FEF94AD4D134695338075388EF31B00F"
}
],
"id": 1
}
Node Command - EMIT DELEGATE SIGN
Sings debit transaction with valid public key
CLI Example
Command syntax:
emit_delegate sign
-net <net_name>
-w <wallet_name>
-tx <transaction_hash>
[-chain <chain_name>]
[-H {hex(default) | base58}]Options:
-net - name of the Cellframe Network. The list of networks can be found in the <Config_dir> \ etc \ network folder or received by The Cellframe-Node-CLI using command - net list
-w - the name of the signing wallet
-tx - hash of the debit transaction
-chain - name of the preferred chain where transaction will be put: zerochain or mainchain (optional)
-H - hash format: HEX or base58 (optional)Example:
Command:
cellframe-node-cli emit_delegate sign -net raiden -w third_wallet -tx 0x075051A67F29290D73192C13685D173C1017A973DC5E0AC7DFDA0AB3CF60AAE9Response:
status: success
tx_hash: 0x61B12392FDD90D9A8247DFC7EDDF85DF18CC372240769EE78DC521BDF3B659AFJSON-RPC Example
Command:
curl -s --unix-socket /opt/cellframe-node/var/run/node_cli -X POST http://localhost/connect -d '{"method":"emit_delegate", "subcommand":["sign"], "arguments":{"net":"raiden","w":"third_wallet","tx":"0x81868733C221B9B0B78251CBA81E5CD3066DF0E51FBB62BD2B1FFAD70FBE5579"}, "id":"1"}'Response:
{
"type": 2,
"result": [
{
"status": "success",
"tx_hash": "0x9DEF553A0190E3448DFDEB4278C46718FEF94AD4D134695338075388EF31B00F"
}
],
"id": 1
}Node Command - EMIT DELEGATE INFO
Shows info about the specified shared funds transaction
CLI Example
Command syntax:
emit_delegate info - get info about emit delegate tx by hash
-net <net_name>
-tx <transaction_hash> - emit delegate tx hash to get info
[-H {hex(default) | base58}] - tx hash format
Options:
-net - name of the Cellframe Network. The list of networks can be found in the <Config_dir> \ etc \ network folder or received by The Cellframe-Node-CLI using command - net list
-tx - hash of the shared funds transaction
-H - hash format: HEX or base58 (optional)
Example:
Command:
cellframe-node-cli emit_delegate info -net foobar -tx 0x6F6C94C2810E62B791E62E73985901B1E21B568E0AFE78744385F4D38FD5F84E
Response:
tx_hash: 0x6F6C94C2810E62B791E62E73985901B1E21B568E0AFE78744385F4D38FD5F84E
tx_hash_final: 0x6F6C94C2810E62B791E62E73985901B1E21B568E0AFE78744385F4D38FD5F84E
balance:
coins: 6666.0
datoshi: 6666000000000000000000
take_verify:
signs_minimum: 2
owner_hashes:
0x1C2FF55650EEF6BD9505794636F3F7F21C1525410DF44CD8CFBC3F1DAC2D1380,
0x9A6B3651BB2CA1C07CF9F6EA9306E7E5BFE61D5D6CB23F97A96D03656403BA09
token:
ticker: BUZ
description:
JSON-RPC Example
Command:
curl -s --unix-socket /opt/cellframe-node/var/run/node_cli -X POST http://localhost/connect -d '{"method":"emit_delegate", "subcommand":["info"], "arguments":{"net":"foobar","tx":"0x6F6C94C2810E62B791E62E73985901B1E21B568E0AFE78744385F4D38FD5F84E"}, "id":"1"}'
Response:
{
"type": 2,
"result": [
{
"tx_hash": "0x6F6C94C2810E62B791E62E73985901B1E21B568E0AFE78744385F4D38FD5F84E",
"tx_hash_final": "0x6F6C94C2810E62B791E62E73985901B1E21B568E0AFE78744385F4D38FD5F84E",
"balance": {
"coins": "6666.0",
"datoshi": "6666000000000000000000"
},
"take_verify": {
"signs_minimum": 2,
"owner_hashes": [
"0x1C2FF55650EEF6BD9505794636F3F7F21C1525410DF44CD8CFBC3F1DAC2D1380",
"0x9A6B3651BB2CA1C07CF9F6EA9306E7E5BFE61D5D6CB23F97A96D03656403BA09"
]
},
"token": {
"ticker": "BUZ",
"description": null
}
}
],
"id": 1
}
Node Command - EMIT DELEGATE INFO
Shows info about the specified shared funds transaction
CLI Example
Command syntax:
emit_delegate info - get info about emit delegate tx by hash
-net <net_name>
-tx <transaction_hash> - emit delegate tx hash to get info
[-H {hex(default) | base58}] - tx hash formatOptions:
-net - name of the Cellframe Network. The list of networks can be found in the <Config_dir> \ etc \ network folder or received by The Cellframe-Node-CLI using command - net list
-tx - hash of the shared funds transaction
-H - hash format: HEX or base58 (optional)Example:
Command:
cellframe-node-cli emit_delegate info -net foobar -tx 0x6F6C94C2810E62B791E62E73985901B1E21B568E0AFE78744385F4D38FD5F84EResponse:
tx_hash: 0x6F6C94C2810E62B791E62E73985901B1E21B568E0AFE78744385F4D38FD5F84E
tx_hash_final: 0x6F6C94C2810E62B791E62E73985901B1E21B568E0AFE78744385F4D38FD5F84E
balance:
coins: 6666.0
datoshi: 6666000000000000000000
take_verify:
signs_minimum: 2
owner_hashes:
0x1C2FF55650EEF6BD9505794636F3F7F21C1525410DF44CD8CFBC3F1DAC2D1380,
0x9A6B3651BB2CA1C07CF9F6EA9306E7E5BFE61D5D6CB23F97A96D03656403BA09
token:
ticker: BUZ
description:JSON-RPC Example
Command:
curl -s --unix-socket /opt/cellframe-node/var/run/node_cli -X POST http://localhost/connect -d '{"method":"emit_delegate", "subcommand":["info"], "arguments":{"net":"foobar","tx":"0x6F6C94C2810E62B791E62E73985901B1E21B568E0AFE78744385F4D38FD5F84E"}, "id":"1"}'Response:
{
"type": 2,
"result": [
{
"tx_hash": "0x6F6C94C2810E62B791E62E73985901B1E21B568E0AFE78744385F4D38FD5F84E",
"tx_hash_final": "0x6F6C94C2810E62B791E62E73985901B1E21B568E0AFE78744385F4D38FD5F84E",
"balance": {
"coins": "6666.0",
"datoshi": "6666000000000000000000"
},
"take_verify": {
"signs_minimum": 2,
"owner_hashes": [
"0x1C2FF55650EEF6BD9505794636F3F7F21C1525410DF44CD8CFBC3F1DAC2D1380",
"0x9A6B3651BB2CA1C07CF9F6EA9306E7E5BFE61D5D6CB23F97A96D03656403BA09"
]
},
"token": {
"ticker": "BUZ",
"description": null
}
}
],
"id": 1
}