使用 injectived
Last updated
Last updated
以下页面介绍了如何使用 injectived
,这是一个连接到 Injective 的命令行界面。您可以使用 injectived
与 Injective 区块链交互,例如上传智能合约、查询数据、管理质押活动、处理治理提案等。
请参阅 获取更多信息。如果您已成功安装 injectived
,您应该能够运行以下命令:
请调整您的命令以正确使用主目录。
如果从 Docker 运行,您需要将主目录挂载到容器中。
使用 Docker 化的 CLI 添加密钥很简单。
以下是该命令的解析:
docker
运行镜像 injectivelabs/injective-core:v1.14.1
。
injectived
是在容器内运行 CLI 的命令。
keys add
是用于添加密钥的命令。
my_key
是密钥的名称。
--home /root/.injective
指定 CLI 在容器内的主目录。
-v ~/.injective:/root/.injective
将主机的 ~/.injective
目录挂载到容器的 /root/.injective
目录。
此命令将创建一个密钥对,并将其保存到容器的 /root/.injective/keyring-file
目录,该目录与主机的 ~/.injective/keyring-file
目录相同。
你可以运行以下命令列出所有密钥:
在访问 Injective 区块链之前,你需要运行一个节点。你可以选择运行自己的完整节点,或者连接到其他人的节点。
要查询状态并发送交易,你必须连接到一个节点,它是整个网络的访问入口。你可以选择运行自己的完整节点,或者连接到其他人的节点。
要设置 RPC 端点,你可以使用以下命令:
现在试着查询状态:
关于使用 injectived 的通用信息
, 运行:
要获取有关特定 injectived
命令的更多信息,可以在命令后附加 -h
或 --help
标志。例如:
injectived
客户端要配置 injectived
的更多选项,请编辑 ~/.injective/config/
目录中的 config.toml
文件。当 keyring-backend
设置为 file
时,密钥存储文件位于 ~/.injective/keyring-file
目录中。此外,keyring-backend
也可以设置为 test
或 os
。
如果设置为 test
,密钥将存储在 ~/.injective/keyring-test
文件中,但不会受密码保护。
配置文件中的所有选项都可以使用 CLI 进行设置:
injectived config set client <option> <value>
运行以下命令可将 INJ 代币从发送方账户转账至接收方账户。1000inj
表示要发送的 INJ 代币数量,其中 1 INJ = 10¹⁸ inj,因此 1000inj
是一个非常小的数额。
以下步骤被执行:
生成一个包含 MsgSend
(x/bank
的 MsgSend
)的交易,并在控制台打印生成的交易。
请求用户确认是否从 $MY_WALLET
账户发送交易。
从密钥存储(keyring)中获取 $MY_WALLET
,这可以实现是因为在前面的步骤中已设置 CLI 的密钥存储。
使用密钥存储中的账户对生成的交易进行签名。
将已签名的交易广播到网络,这可以实现是因为 CLI 连接到了 Injective 公共节点的 RPC 端点。
CLI 将所有必要的步骤整合在一起,提供了简洁易用的用户体验。但也可以分别运行每个步骤来完成交易。
生成交易可以通过在任何交易命令后添加 --generate-only
标志来简单完成,例如:
这将把未签名的交易以 JSON 格式输出到控制台。我们还可以通过在上述命令后添加 > unsigned_tx.json
将未签名的交易保存到文件中(以便在签名者之间更方便地传递)。
使用 CLI 签名交易需要将未签名的交易保存到文件中。假设未签名的交易保存在当前目录中的一个名为 unsigned_tx.json
的文件中(参考前一段了解如何操作)。然后,只需运行以下命令:
此命令将解码未签名的交易,并使用我们在密钥存储中已经设置的 MY_WALLET 的密钥以 SIGN_MODE_DIRECT
模式对其进行签名。签名后的交易将以 JSON 格式输出到控制台,像上面一样,我们可以通过在命令后添加 > signed_tx.json
将其保存到文件中。
在 tx sign
命令中,有一些有用的标志可以考虑:
--sign-mode
:你可以使用 amino-json
来通过 SIGN_MODE_LEGACY_AMINO_JSON
签名交易。
--offline
:在离线模式下签名。这意味着 tx sign
命令不会连接到节点以获取签名者的账户号码和序列号,这两个信息在签名时需要。在这种情况下,你必须手动提供 --account-number
和 --sequence
标志。这对于离线签名非常有用,例如在没有互联网连接的安全环境中进行签名。
使用多个签名者进行签名是通过 tx multi-sign
命令完成的。此命令假设所有签名者使用 SIGN_MODE_LEGACY_AMINO_JSON
。其流程与 tx sign
命令类似,但不同之处在于,代替签署未签名的交易文件,每个签名者都会签署前一个签名者签署过的文件。tx multi-sign
命令将签名附加到现有的交易上。重要的是,签名者必须按照交易中给定的顺序签署交易,可以通过 GetSigners()
方法检索该顺序。
例如,从 unsigned_tx.json
开始,假设交易有 4 个签名者,我们将运行:
广播交易是通过以下命令完成的:
你可以选择性地传递 --broadcast-mode
标志来指定从节点接收哪种响应:
block
:CLI 等待交易被包含在区块中。
sync
:CLI 仅等待 CheckTx
执行响应,手动查询交易结果以确保它已被包含。
async
:CLI 立即返回(交易可能失败)- 不要使用。
要查询交易结果,你可以使用以下命令:
有时候配置可能没有正确设置。你可以通过在命令行中添加以下内容来强制使用正确的节点 RPC 端点。在与他人分享命令时,建议在命令行中明确设置所有标志(如 chain-id
、node
、keyring-backend
等)。
仅适用于高级用户。对于大多数用户,建议连接到公共节点。