hummingbird
/
jdchain
Not watched
2
0
Fork 0
Code
Releases 31 Wiki Activity
Issues 0 Pull Requests 0 Datasets Model Cloudbrain
You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.
Tree: 1.5.1
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '1.5.1'
${ noResults }
jdchain/docs/cli/tx.md

22 kB
Raw Permalink Blame History

交易

:bin$ ./jdchain-cli.sh tx -h
Usage: git status [<options>...] [--] [<pathspec>...]
Build, sign or send transaction.
      --export=<export>    Transaction export directory
      --gw-host=<gwHost>   Set the gateway host. Default: 127.0.0.1
                             Default: 127.0.0.1
      --gw-port=<gwPort>   Set the gateway port. Default: 8080
                             Default: 8080
  -h, --help               Show this help message and exit.
      --home=<path>        Set the home directory.
                             Default: ../
      --pretty             Pretty json print
  -V, --version            Print version information and exit.
Commands:
  user-register           Register new user.
  role                    Create or config role.
  authorization           User role authorization.
  data-account-register   Register new data account.
  kv                      Set key-value.
  event                   Publish event.
  contract-deploy         Deploy or update contract.
  contract                Call contract method.
  event-account-register  Register event account.
  sign                    Sign transaction.
  send                    Send transaction.
  help                    Displays help information about the specified command

参数：

  • export，导出交易到指定位置，用于离线交易相关命令
  • gw-host，网关服务地址，默认127.0.0.1
  • gw-port，网关服务端口，默认8080
  • home，指定密钥存储相关目录，${home}/config/keys

命令：

注册用户

:bin$ ./jdchain-cli.sh tx user-register -h
Register new user.
Usage: jdchain-cli tx user-register [-hV] [--pretty] [--export=<export>]
                                    [--gw-host=<gwHost>] [--gw-port=<gwPort>]
                                    [--home=<path>]
      --export=<export>    Transaction export directory
      --gw-host=<gwHost>   Set the gateway host. Default: 127.0.0.1
      --gw-port=<gwPort>   Set the gateway port. Default: 8080
  -h, --help               Show this help message and exit.
      --home=<path>        Set the home directory.
      --pretty             Pretty json print
  -V, --version            Print version information and exit.

从${home}/config/keys目录下密钥对选择密钥注册到网关服务对应的区块链网络。

如：

:bin$ ./jdchain-cli.sh tx user-register
select ledger, input the index:
INDEX  LEDGER
0      j5sB3sVTFgTqTYzo7KtQjBLSy8YQGPpJpvQZaW9Eqk46dg
// 选择账本，当前网关服务只有上面一个可用账本
> 0
select keypair to register:
INDEX  KEY                                     ADDRESS
0      peer0                                   LdeNyibeafrAQXgHjBxgQxoLbna6hL4BcXZiw
1      k1                                      LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC
// 选择公私钥对用于注册用户
> 1
input password of the key:
// 输入所选择公私钥对密钥密码
> 1
select keypair to sign tx:
INDEX  KEY                                     ADDRESS
0      peer0                                   LdeNyibeafrAQXgHjBxgQxoLbna6hL4BcXZiw
1      k1                                      LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC
// 选择链上已存在且有注册用户权限的用户所对应的公私钥对，用于交易签名
> 0
input password of the key:
// 输入签名私钥密码
> 1
register user: [LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC]

会在链上注册地址为LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC的用户账户信息。

角色管理

:bin$ ./jdchain-cli.sh tx role -h
Create or config role.
Usage: jdchain-cli tx role [-hV] [--pretty] [--export=<export>]
                           [--gw-host=<gwHost>] [--gw-port=<gwPort>]
                           [--home=<path>] --name=<role>
                           [--disable-ledger-perms=<disableLedgerPerms>[,
                           <disableLedgerPerms>...]]...
                           [--disable-transaction-perms=<disableTransactionPerms
                           >[,<disableTransactionPerms>...]]...
                           [--enable-ledger-perms=<enableLedgerPerms>[,
                           <enableLedgerPerms>...]]...
                           [--enable-transaction-perms=<enableTransactionPerms>
                           [,<enableTransactionPerms>...]]...
      --disable-ledger-perms=<disableLedgerPerms>[,<disableLedgerPerms>...]
                           Disable ledger permissions
      --disable-transaction-perms=<disableTransactionPerms>[,
        <disableTransactionPerms>...]
                           Disable transaction permissions
      --enable-ledger-perms=<enableLedgerPerms>[,<enableLedgerPerms>...]
                           Enable ledger permissions
      --enable-transaction-perms=<enableTransactionPerms>[,
        <enableTransactionPerms>...]
                           Enable transaction permissions
      --export=<export>    Transaction export directory
      --gw-host=<gwHost>   Set the gateway host. Default: 127.0.0.1
      --gw-port=<gwPort>   Set the gateway port. Default: 8080
  -h, --help               Show this help message and exit.
      --home=<path>        Set the home directory.
      --name=<role>        Role name
      --pretty             Pretty json print
  -V, --version            Print version information and exit.
  • name，角色名称，不存在则创建
  • disable-ledger-perms，禁用的账本权限列表，半角逗号分割
  • disable-transaction-perms，禁用的交易权限列表，半角逗号分割
  • enable-ledger-perms，的账本权限列表，半角逗号分割
  • enable-transaction-perms，禁用的交易权限列表，半角逗号分割

如：

:bin$ ./jdchain-cli.sh tx role --name ROLE1 --enable-ledger-perms REGISTER_USER,REGISTER_DATA_ACCOUNT --enable-transaction-perms DIRECT_OPERATION,CONTRACT_OPERATION
select ledger, input the index:
INDEX  LEDGER
0      j5sB3sVTFgTqTYzo7KtQjBLSy8YQGPpJpvQZaW9Eqk46dg
// 选择账本
> 0
select keypair to sign tx:
INDEX  KEY                                     ADDRESS
0      peer0                                   LdeNyibeafrAQXgHjBxgQxoLbna6hL4BcXZiw
1      k1                                      LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC
// 选择签名账户
> 0
input password of the key:
// 输入签名账户私钥密码
> 1
Role config success!

权限配置

:bin$ ./jdchain-cli.sh tx authorization -h
User role authorization.
Usage: jdchain-cli tx authorization [-hV] [--pretty] --address=<address>
                                    [--export=<export>] [--gw-host=<gwHost>]
                                    [--gw-port=<gwPort>] [--home=<path>]
                                    [--policy=<policy>]
                                    [--authorize=<authorizeRoles>[,
                                    <authorizeRoles>...]]...
                                    [--unauthorize=<unauthorizeRoles>[,
                                    <unauthorizeRoles>...]]...
      --address=<address>   User address
      --authorize=<authorizeRoles>[,<authorizeRoles>...]
                            Authorize roles
      --export=<export>     Transaction export directory
      --gw-host=<gwHost>    Set the gateway host. Default: 127.0.0.1
      --gw-port=<gwPort>    Set the gateway port. Default: 8080
  -h, --help                Show this help message and exit.
      --home=<path>         Set the home directory.
      --policy=<policy>     Role policy
      --pretty              Pretty json print
      --unauthorize=<unauthorizeRoles>[,<unauthorizeRoles>...]
                            Unauthorize roles
  -V, --version             Print version information and exit.
  • address，用户地址
  • authorize，赋予角色列表，半角逗号分割
  • unauthorize，移除角色列表，半角逗号分割
  • policy，角色策略，UNION/INTERSECT，默认UNION合并所有角色权限

如：

:bin$ ./jdchain-cli.sh tx authorization --address LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC --authorize ROLE1
select ledger, input the index:
INDEX  LEDGER
0      j5sB3sVTFgTqTYzo7KtQjBLSy8YQGPpJpvQZaW9Eqk46dg
> 0
select keypair to sign tx:
INDEX  KEY                                     ADDRESS
0      peer0                                   LdeNyibeafrAQXgHjBxgQxoLbna6hL4BcXZiw
1      k1                                      LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC
> 0
input password of the key:
> 1
Authorization config success!

注册数据账户

:bin$ ./jdchain-cli.sh tx data-account-register -h
Register new data account.
Usage: jdchain-cli tx data-account-register [-hV] [--pretty]
       [--export=<export>] [--gw-host=<gwHost>] [--gw-port=<gwPort>]
       [--home=<path>] [--pubkey=<pubkey>]
      --export=<export>    Transaction export directory
      --gw-host=<gwHost>   Set the gateway host. Default: 127.0.0.1
      --gw-port=<gwPort>   Set the gateway port. Default: 8080
  -h, --help               Show this help message and exit.
      --home=<path>        Set the home directory.
      --pretty             Pretty json print
      --pubkey=<pubkey>    The pubkey of the exist data account
  -V, --version            Print version information and exit.
  • pubkey，待注册数据账户私钥

如：

:bin$ ./jdchain-cli.sh tx data-account-register --pubkey 7VeRFk4ANQHjWjAmAoL7492fuykTpXujihJeAgbXT2J9H9Yk
select ledger, input the index:
INDEX  LEDGER
0      j5sB3sVTFgTqTYzo7KtQjBLSy8YQGPpJpvQZaW9Eqk46dg
> 0
select keypair to sign tx:
INDEX  KEY                                     ADDRESS
0      peer0                                   LdeNyibeafrAQXgHjBxgQxoLbna6hL4BcXZiw
1      k1                                      LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC
> 0
input password of the key:
> 1
register data account: [LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC]

会在链上注册地址为LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC的数据账户信息。

KV设值

:bin$ ./jdchain-cli.sh tx kv -h
Set key-value.
Usage: jdchain-cli tx kv [-hV] [--pretty] --address=<address>
                         [--export=<export>] [--gw-host=<gwHost>]
                         [--gw-port=<gwPort>] [--home=<path>] --key=<key>
                         --value=<value> [--ver=<version>]
      --address=<address>   Data account address
      --export=<export>     Transaction export directory
      --gw-host=<gwHost>    Set the gateway host. Default: 127.0.0.1
      --gw-port=<gwPort>    Set the gateway port. Default: 8080
  -h, --help                Show this help message and exit.
      --home=<path>         Set the home directory.
      --key=<key>           Key to set
      --pretty              Pretty json print
  -V, --version             Print version information and exit.
      --value=<value>       Value to set
      --ver=<version>       Version of the key-value
  • address，数据账户地址
  • key，键
  • value，值
  • ver，版本

如向账户地址LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC写入k1:v1:-1键值对数据：

:bin$ ./jdchain-cli.sh tx kv --address LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC --key k1 --value v1 --ver -1
select ledger, input the index:
INDEX  LEDGER
0      j5sB3sVTFgTqTYzo7KtQjBLSy8YQGPpJpvQZaW9Eqk46dg
> 0
select keypair to sign tx:
INDEX  KEY                                     ADDRESS
0      peer0                                   LdeNyibeafrAQXgHjBxgQxoLbna6hL4BcXZiw
1      k1                                      LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC
> 0
input password of the key:
> 1
set kv success

注册事件账户

:bin$ ./jdchain-cli.sh tx event-account-register -h
Register event account.
Usage: jdchain-cli tx event-account-register [-hV] [--pretty]
       [--export=<export>] [--gw-host=<gwHost>] [--gw-port=<gwPort>]
       [--home=<path>] [--pubkey=<pubkey>]
      --export=<export>    Transaction export directory
      --gw-host=<gwHost>   Set the gateway host. Default: 127.0.0.1
      --gw-port=<gwPort>   Set the gateway port. Default: 8080
  -h, --help               Show this help message and exit.
      --home=<path>        Set the home directory.
      --pretty             Pretty json print
      --pubkey=<pubkey>    The pubkey of the exist event account
  -V, --version            Print version information and exit.
  • pubkey，待注册事件账户私钥

如：

:bin$ ./jdchain-cli.sh tx event-account-register --pubkey 7VeRFk4ANQHjWjAmAoL7492fuykTpXujihJeAgbXT2J9H9Yk
select ledger, input the index:
INDEX  LEDGER
0      j5sB3sVTFgTqTYzo7KtQjBLSy8YQGPpJpvQZaW9Eqk46dg
> 0
select keypair to sign tx:
INDEX  KEY                                     ADDRESS
0      peer0                                   LdeNyibeafrAQXgHjBxgQxoLbna6hL4BcXZiw
1      k1                                      LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC
> 0
input password of the key:
> 1
register event account: [LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC]

会在链上注册地址为LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC的事件账户信息。

发布事件

:bin$ ./jdchain-cli.sh tx event -h
Publish event.
Usage: jdchain-cli tx event [-hV] [--pretty] --address=<address>
                            --content=<value> [--export=<export>]
                            [--gw-host=<gwHost>] [--gw-port=<gwPort>]
                            [--home=<path>] [--sequence=<sequence>]
                            --name=<name>
      --address=<address>   Contract address
      --content=<value>     Event content
      --export=<export>     Transaction export directory
      --gw-host=<gwHost>    Set the gateway host. Default: 127.0.0.1
      --gw-port=<gwPort>    Set the gateway port. Default: 8080
  -h, --help                Show this help message and exit.
      --home=<path>         Set the home directory.
      --pretty              Pretty json print
      --sequence=<sequence> Sequence of the event
      --name=<name>         Event name
  -V, --version             Print version information and exit.
  • address，事件账户地址
  • name，事件名
  • content，事件内容
  • sequence，事件序号

如向账户地址LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC发布事件n1:c1:-1：

:bin$ ./jdchain-cli.sh tx event --address LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC --name n1 --content c1 --sequence -1
select ledger, input the index:
INDEX  LEDGER
0      j5sB3sVTFgTqTYzo7KtQjBLSy8YQGPpJpvQZaW9Eqk46dg
> 0
select keypair to sign tx:
INDEX  KEY                                     ADDRESS
0      peer0                                   LdeNyibeafrAQXgHjBxgQxoLbna6hL4BcXZiw
1      k1                                      LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC
> 0
input password of the key:
> 1
event publish success

部署合约

:bin$ ./jdchain-cli.sh tx contract-deploy -h
Deploy or update contract.
Usage: jdchain-cli tx contract-deploy [-hV] [--pretty] --car=<car>
                                      [--export=<export>] [--gw-host=<gwHost>]
                                      [--gw-port=<gwPort>] [--home=<path>]
                                      [--pubkey=<pubkey>]
      --car=<car>          The car file path
      --export=<export>    Transaction export directory
      --gw-host=<gwHost>   Set the gateway host. Default: 127.0.0.1
      --gw-port=<gwPort>   Set the gateway port. Default: 8080
  -h, --help               Show this help message and exit.
      --home=<path>        Set the home directory.
      --pretty             Pretty json print
      --pubkey=<pubkey>    The pubkey of the exist contract
  -V, --version            Print version information and exit.
  • pubkey，合约公钥，更新合约时使用
  • car，合约car文件

如将contract-samples-1.5.0.RELEASE.car文件中的合约部署上链：

:bin$ ./jdchain-cli.sh tx contract-deploy --car /home/imuge/Desktop/jdchain-cli/1.5.0/contract-samples-1.5.0.RELEASE.car
select ledger, input the index:
INDEX  LEDGER
0      j5sB3sVTFgTqTYzo7KtQjBLSy8YQGPpJpvQZaW9Eqk46dg
> 0
select keypair to sign tx:
INDEX  KEY                                     ADDRESS
0      peer0                                   LdeNyibeafrAQXgHjBxgQxoLbna6hL4BcXZiw
1      k1                                      LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC
> 0
input password of the key:
> 1
deploy contract: [LdeNyF6jdNry5iCqmHdAFTQPvC8UkbJ9avoXH]

合约地址：LdeNyF6jdNry5iCqmHdAFTQPvC8UkbJ9avoXH

合约调用

:bin$ ./jdchain-cli.sh tx contract -h
Call contract method.
Usage: jdchain-cli tx contract [-hV] [--pretty] --address=<address>
                               [--export=<export>] [--gw-host=<gwHost>]
                               [--gw-port=<gwPort>] [--home=<path>]
                               --method=<method> [--args=<args>[,<args>...]]...
      --address=<address>   Contract address
      --args=<args>[,<args>...]
                            Method arguments
      --export=<export>     Transaction export directory
      --gw-host=<gwHost>    Set the gateway host. Default: 127.0.0.1
      --gw-port=<gwPort>    Set the gateway port. Default: 8080
  -h, --help                Show this help message and exit.
      --home=<path>         Set the home directory.
      --method=<method>     Contract method
      --pretty              Pretty json print
  -V, --version             Print version information and exit.
  • address，合约地址
  • method，合约方法
  • args，合约参数，半角逗号分割，命令行中会将所有参数处理为字符串，非字符串参数方法调用暂无法通过命令行工具调用

如调用合约LdeNyF6jdNry5iCqmHdAFTQPvC8UkbJ9avoXH中registerUser方法，传参ed386a148fcb48b281b325f66103c805：

:bin$ ./jdchain-cli.sh tx contract --address LdeNyF6jdNry5iCqmHdAFTQPvC8UkbJ9avoXH --method registerUser --args ed386a148fcb48b281b325f66103c805
select ledger, input the index:
INDEX  LEDGER
0      j5sB3sVTFgTqTYzo7KtQjBLSy8YQGPpJpvQZaW9Eqk46dg
> 0
select keypair to sign tx:
INDEX  KEY                                     ADDRESS
0      peer0                                   LdeNyibeafrAQXgHjBxgQxoLbna6hL4BcXZiw
1      k1                                      LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC
> 0
input password of the key:
> 1
call contract success
return string: LdeNqvSjL4izfpMNsGpQiBpTBse4g6qLxZ6j5

调用成功并返回了字符串：LdeNqvSjL4izfpMNsGpQiBpTBse4g6qLxZ6j5

离线交易签名

  1. 离线交易

执行以上所有交易时，若export参数不为空，则会执行交易写入本地操作，而非签名并发送交易

如构造合约调用操作交易并保存到本地：

:bin$ ./jdchain-cli.sh tx contract --address LdeNyF6jdNry5iCqmHdAFTQPvC8UkbJ9avoXH --method registerUser --args ed386a148fcb48b281b325f66103c810 --export /txs
select ledger, input the index:
INDEX  LEDGER
0      j5sB3sVTFgTqTYzo7KtQjBLSy8YQGPpJpvQZaW9Eqk46dg
> 0
export transaction success: /txs/j5xR8ty8YbujTYKNRshmbfMYsL4jfe3yRUtMparmeHppd3

交易内容会被序列化保存在/txs/j5xR8ty8YbujTYKNRshmbfMYsL4jfe3yRUtMparmeHppd3中，其中j5xR8ty8YbujTYKNRshmbfMYsL4jfe3yRUtMparmeHppd3是该交易哈希。

  1. 离线签名
:bin$ ./jdchain-cli.sh tx sign -h
Sign transaction.
Usage: jdchain-cli tx sign [-hV] [--pretty] [--export=<export>]
                           [--gw-host=<gwHost>] [--gw-port=<gwPort>]
                           [--home=<path>] [--tx=<txFile>]
      --export=<export>    Transaction export directory
      --gw-host=<gwHost>   Set the gateway host. Default: 127.0.0.1
      --gw-port=<gwPort>   Set the gateway port. Default: 8080
  -h, --help               Show this help message and exit.
      --home=<path>        Set the home directory.
      --tx=<txFile>        Local transaction file
      --pretty             Pretty json print
  -V, --version            Print version information and exit.
  • tx，离线交易路径

如对步骤1中创建的离线交易添加终端用户（此用户需是链上存在的且有相关权限的用户）签名：

:bin$ ./jdchain-cli.sh tx sign --tx /txs/j5xR8ty8YbujTYKNRshmbfMYsL4jfe3yRUtMparmeHppd3
select keypair to sign tx:
INDEX  KEY                                     ADDRESS
0      peer0                                   LdeNyibeafrAQXgHjBxgQxoLbna6hL4BcXZiw
1      k1                                      LdeNwQWabrf6WSjZ35saFo52MfQFhVKvm11aC
> 0
input password of the key:
> 1
Sign transaction success!

离线交易发送

发送本地已经签名完成的交易

:bin$ ./jdchain-cli.sh tx send -h
Send transaction.
Usage: jdchain-cli tx send [-hV] [--pretty] [--export=<export>]
                           [--gw-host=<gwHost>] [--gw-port=<gwPort>]
                           [--home=<path>] [--tx=<txFile>]
      --export=<export>    Transaction export directory
      --gw-host=<gwHost>   Set the gateway host. Default: 127.0.0.1
      --gw-port=<gwPort>   Set the gateway port. Default: 8080
  -h, --help               Show this help message and exit.
      --home=<path>        Set the home directory.
      --tx=<txFile>		   Local transaction file
      --pretty             Pretty json print
  -V, --version            Print version information and exit.
  • tx，离线交易路径

如发送/txs/j5xR8ty8YbujTYKNRshmbfMYsL4jfe3yRUtMparmeHppd3中包含的交易数据：

:bin$ ./jdchain-cli.sh tx send --tx /home/imuge/Desktop/jdchain-cli/1.5.0/txs/j5xR8ty8YbujTYKNRshmbfMYsL4jfe3yRUtMparmeHppd3
select ledger, input the index:
INDEX  LEDGER
0      j5sB3sVTFgTqTYzo7KtQjBLSy8YQGPpJpvQZaW9Eqk46dg
> 0
Send transaction success: j5xR8ty8YbujTYKNRshmbfMYsL4jfe3yRUtMparmeHppd3