injective-cli

Injective CLI，技能指南

概述

使用 injectived 二进制文件查询 Injective 链并进行交易，以统一处理钱包、端点选择和 Gas 配置。使用随附的 CLI 命令映射和参考文档，快速找到合适的子命令和标志。 调用此技能中的任何脚本，即表示你同意 TERMS_OF_USE 中的使用条款。

工作流

1) 查找或安装二进制文件

尽可能使用本地的 injectived 二进制文件。如果它不在 PATH 中，

npm i -g injective-core@latest

也可以通过 npx injective-core 运行一次性命令，例如：npx injective-core --version。 本文档其余部分将使用 injectived 作为示例。

2) 使用 CLI 操作链

通过运行 injectived <path> --help，抽查关键路径（例如 query、tx、keys）。

3) 刷新 CLI 命令映射（按需）

命令映射应与已安装的 injectived 二进制文件保持一致。如果怀疑文档与本地二进制文件存在差异，请使用 scripts/ 中的脚本重新生成映射，并与当前映射进行差异比较。

示例：

python3 scripts/map_injectived_cli.py --output /tmp/injectived-cli-map.new.md
diff -u references/injectived-cli-map.md /tmp/injectived-cli-map.new.md

账户和端点约定

• 除非用户另有指定，否则使用 ~/.injectived 作为配置和密钥材料的主目录。
• 从 ~/.injectived/config/client.toml 读取端点和 chain-id（字段：node、chain-id）。
• 配置客户端时使用以下默认值：
  • 主网端点：https://sentry.tm.injective.network:443
  • 主网 chain-id：injective-1
  • 测试网端点：https://testnet.sentry.tm.injective.network:443
  • 测试网 chain-id：injective-888
• 密钥环处理：
  • 默认使用受密码短语保护的文件密钥环。
  • 如果密钥库提示输入密码短语，请通过管道传入：
    • yes "passphrase" | timeout 10s injectived tx ...（一次性／手动输入密码短语的方式）
    • cat ~/.injectived/keystore_password.txt | timeout 10s injectived tx ...（选择存储密码短语时使用）
  • Agent 处理已持久化的密码短语文件时：
    • 仅当用户明确选择将密码短语存储在磁盘上时，才使用 ~/.injectived/keystore_password.txt。
    • 将其视为敏感的本地机密材料（文件权限为 600），并且不要在命令输出或日志中打印密码短语内容。
    • 对涉及密钥环的命令保留 timeout 10s，以免在等待解锁输入时挂起。
  • --keyring-backend test 可用且不会提示输入密码短语，但不安全，会暴露私钥。仅用于本地、可随时丢弃的工作流。
  • 原始 Ethereum 私钥的导入／导出使用不安全命令：
    • injectived keys unsafe-export-eth-key <key_name>
    • injectived keys unsafe-import-eth-key <key_name> <hex_private_key>
  • 这些命令被标记为不安全，但它们是处理原始 HEX 私钥所必需的途径。
  • 切勿在公开频道或公共交流中分享原始 HEX 私钥。
• Ledger 签名：
  • 对由 Ledger 支持的交易使用 --ledger 标志。
  • 示例：
    • injectived tx bank send <from> <to> <amount> --ledger --chain-id injective-1 --gas auto --gas-prices 160000000inj --yes
• 在交易中使用 --yes 跳过交互式确认。
• 使用 --gas auto --gas-adjustment 1.5 --gas-prices 160000000inj 估算费用。
• 广播后，使用 injectived q tx <tx_hash> 验证。
• 创建新密钥库时，将密码短语存储在 ~/.injectived/new_keystore_password.txt 中，提醒用户记住它，并在使用后删除该文件。

资源

scripts/

• map_injectived_cli.py：递归运行 injectived <cmd> --help，以刷新 CLI 命令映射。

references/

• injectived-cli-map.md：injectived 二进制文件的命令映射。