Plug Chain 文档

# Tx

签名、广播、查询交易

# 可用命令

名称 描述
sign 签名生成的离线交易文件
broadcast 广播一个已签名交易到网络
multisig 用多个账户为同一交易签名
tx 使用交易hash查询交易
txs 使用Tag查询交易

# plugchaind tx sign

签名生成的离线交易文件。该文件由generate-only标志生成。

plugchaind tx sign <file> [flags]

# 标志

命令，速记 类型 必须 默认 描述
-h，--help 打印帮助
--append bool true 将签名附加到现有签名
--multisig string true 代表交易签名的multisig帐户的地址
--from string 是 用于签名的私钥名称
--offline bool false 离线模式
--signature-only bool false 仅打印生成的签名，然后退出

# 生成离线交易

提示

任意类型的离线交易都可以通过追加--generate-only标志来生成

下面示例中使用Transfer交易：

plugchaind tx bank send gx1l7422f2ljgmrnzwxgd9rxr8cw3yz63wx89tnqs gx1rkecwy9pjsfd058w0pwa2perquc8xe639n92ms 900000uplugcn --fees 20uplugcn --generate-only > unsigned.json

unsigned.json 看起来是这样的：

{
    "body": {
        "messages": [
            {
                "@type": "/cosmos.bank.v1beta1.MsgSend",
                "from_address": "gx1l7422f2ljgmrnzwxgd9rxr8cw3yz63wx89tnqs",
                "to_address": "gx1rkecwy9pjsfd058w0pwa2perquc8xe639n92ms",
                "amount": [
                    {
                        "denom": "uplugcn",
                        "amount": "900000"
                    }
                ]
            }
        ],
        "memo": "",
        "timeout_height": "0",
        "extension_options": [],
        "non_critical_extension_options": []
    },
    "auth_info": {
        "signer_infos": [],
        "fee": {
            "amount": [
                {
                    "denom": "uplugcn",
                    "amount": "20"
                }
            ],
            "gas_limit": "200000",
            "payer": "",
            "granter": ""
        }
    },
    "signatures": []
}

# 签名离线交易

plugchaind tx sign unsigned.json  --from gx1l7422f2ljgmrnzwxgd9rxr8cw3yz63wx89tnqs --chain-id plugchain_520-1 > signed.json

signed.json 看起来是这样的：

{
    "body": {
        "messages": [
            {
                "@type": "/cosmos.bank.v1beta1.MsgSend",
                "from_address": "gx1l7422f2ljgmrnzwxgd9rxr8cw3yz63wx89tnqs",
                "to_address": "gx1rkecwy9pjsfd058w0pwa2perquc8xe639n92ms",
                "amount": [
                    {
                        "denom": "uplugcn",
                        "amount": "900000"
                    }
                ]
            }
        ],
        "memo": "",
        "timeout_height": "0",
        "extension_options": [],
        "non_critical_extension_options": []
    },
    "auth_info": {
        "signer_infos": [
            {
                "public_key": {
                    "@type": "/cosmos.crypto.secp256k1.PubKey",
                    "key": "Auouudrg0P86v2kq2lykdr97AJYGHyD6BJXAQtjR1gzd"
                },
                "mode_info": {
                    "single": {
                        "mode": "SIGN_MODE_DIRECT"
                    }
                },
                "sequence": "1"
            }
        ],
        "fee": {
            "amount": [
                {
                    "denom": "uplugcn",
                    "amount": "20"
                }
            ],
            "gas_limit": "200000",
            "payer": "",
            "granter": ""
        }
    },
    "signatures": [
        "sJewd6lKjma49rAiGVfdT+V0YYerKNx6ZksdumVCvuItqGm24bEN9msh7IJ12Sil1lYjqQjdAcjVCX/77FKlIQ=="
    ]
}

签名之后，signed.json中的signature字段将不再为空。

现在准备广播这个已签名交易到Plug Chain Hub。

# plugchaind tx broadcast

这个命令用于广播已离线签名的交易到网络。

# 广播离线签名的交易

plugchaind tx broadcast signed.json --chain-id=plugchain_520-1

# plugchaind tx multisign

用多个账户为一个交易签名。这个交易只有在签名数满足multisig-threshold时才可以广播。

plugchaind tx multisign <file> <key-name> <[signature]...> [flags]

# 用多签密钥创建离线交易

提示

没有多签密钥？创建一个

plugchaind tx bank send <from> <to> 10uplugcn --fees=20uplugcn --chain-id=plugchain_520-1 --from=<multisig-keyname> --generate-only > unsigned.json

# 签名多签交易

# 查询多签地址

plugchaind keys show <multisig-keyname>

# 签名unsigned.json

假定multisig-threshold是2，我们使用2个签名者签名unsigned.json

用signer-1签名：

plugchaind tx sign unsigned.json --from=<signer-keyname-1> --chain-id=plugchain_520-1 --multisig=<multisig-address> --signature-only > signed-1.json

用signer-2签名：

plugchaind tx sign unsigned.json --from=<signer-keyname-2> --chain-id=plugchain_520-1 --multisig=<multisig-address> --signature-only > signed-2.json

# 合并签名

合并所有签名到 signed.json

plugchaind tx multisign --chain-id=plugchain_520-1 unsigned.json <multisig-keyname> signed-1.json signed-2.json > signed.json

现在可以广播这个已签名交易了。

# plugchaind query tx

plugchaind query tx [hash] [flags]

# plugchaind query txs

plugchaind query txs --events 'message.sender=<gx...>&message.action=xxxx' --page 1 --limit 30

其中message.action可取值：

module Msg action
bank cosmos-sdk/MsgSend transfer
cosmos-sdk/MsgMultiSend transfer
distribution cosmos-sdk/MsgModifyWithdrawAddress set_withdraw_address
cosmos-sdk/MsgWithdrawValidatorCommission withdraw_commission
cosmos-sdk/MsgWithdrawDelegatorReward withdraw_rewards
gov cosmos-sdk/MsgSubmitProposal submit_proposal
cosmos-sdk/MsgDeposit proposal_deposit
cosmos-sdk/MsgVote proposal_vote
stake cosmos-sdk/MsgCreateValidator create_validator
cosmos-sdk/MsgEditValidator edit_validator
cosmos-sdk/MsgDelegate delegate
cosmos-sdk/MsgBeginRedelegate redelegate
cosmos-sdk/MsgUndelegate unbond
slashing cosmos-sdk/MsgUnjail unjail

← Upgrade →