钱包与转账指南

本指南解释了如何在网络中使用钱包和代币：如何获取您的钱包地址、检查余额、发送代币以及跟踪交易。在执行任何钱包操作之前，您需要访问您的账户。请根据您在网络中的角色，按照以下说明操作。

您是主机吗？

您提供计算资源并获得代币作为奖励。在继续之前，您需要访问您的钱包，该钱包在 chain-node 容器首次运行时自动创建。

您是开发者吗？

如果您仅需要推理（发送提示并接收完成内容），则无需 Gonka 账户 —— 请前往开发者快速入门使用社区代理开始使用。

如果您运行自己的网关或需要在链上持有和转移 GNK，请先创建 Gonka 账户，然后返回此处。

一旦您已访问账户，请返回本指南学习如何：

面额

链上唯一的有效面额是 ngonka。所有余额、费用和交易必须 exclusively 使用 ngonka。 Cosmos SDK 可能允许定义其他面额，但这些面额无效 —— SDK 不会在它们之间执行自动转换。 gonka 仅用作链下、用户友好的显示单位。它代表 10 亿 ngonka，本身并不存在于链上。

有效单位

单位	用途	链上？	比例
`ngonka`	网络上使用的基单位	是	1
`gonka`	人类可读的显示单位	否	1 `gonka` = 1,000,000,000 `ngonka`

获取您的钱包地址

在检查余额或发送资金之前，您需要知道您的钱包地址。

inferenced keys list [--keyring-backend test]

此命令列出您本地创建的所有钱包密钥（账户）及其地址和公钥。示例输出：

- address: gonka1f85frkfw89cgpva0vgpyuldjgu6uhyd82hmjzr
  name: genesis
  pubkey: '{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"A+Qpbyhtsdl5N/6O6S/qJ9uvtbI7OFFsO5dcNrpEU0nv"}'
  type: local

记下地址（用于接收代币和查询余额）。

查询余额

要检查余额，请在转账前确保您有足够的资金，或验证转账是否成功，请使用以下命令：

inferenced query bank balances <address> [--node <node_rpc_url>]

这将显示您的钱包中有多少代币。

示例：

inferenced query bank balances gonka1ddswmmmn38esxegjf6qw36mt4aqyw6etvysy5x --node http://node2.gonka.ai:8000/chain-rpc/

发送代币

在 Cosmos 中，资金转账是指在基于 Cosmos 的区块链内从一个账户（钱包地址）向另一个账户发送代币。这些转账用于支付服务或在用户之间传递价值。

您还可以在 Tangem（硬件钱包加移动应用）中发送和接收 GNK。

CLI

您可以使用 Cosmos SDK 命令行工具执行转账 —— 特别是 inferenced CLI。每个转账都会记录在区块链上，需要有效的发送方、接收方、金额和代币面额。

一旦您知道余额并拥有接收方地址，就可以发送代币。

银行转账属于 cosmos 费用组。在主网上，该组费用为 每单位燃气 1 ngonka。--gas auto 设置燃气上限。--gas-prices 1ngonka 设置费用。若转账费用为空，则会被拒绝并返回 insufficient fee。请参阅为您的账户密钥充值。

```bash
inferenced tx bank send <sender-key-name> <recipient-address> <coins> \
  --chain-id gonka-mainnet \
  --gas auto \
  --gas-adjustment 2.0 \
  --gas-prices 1ngonka \
  [--node <node_rpc_url>] \
  [--keyring-backend test]
```

!!! note

    `<sender-key-name>` 是您的密钥环中的**本地密钥名称**——即创建密钥时您选择的标签。使用 `inferenced keys list` 查看此机器上的名称。

    **示例：**

```bash
inferenced tx bank send genesis gonka1a3jpdl4epdts64gns3a3fy9hjv2n9e3v7kxx0e 100ngonka \
  --chain-id gonka-mainnet \
  --gas auto \
  --gas-adjustment 2.0 \
  --gas-prices 1ngonka
```

Keplr（网页扩展）

要使用 Keplr 钱包在 Gonka 链上进行 Gonka 账户之间的转账，请登录并打开您的 Keplr 钱包。

在主页上搜索 Gonka 链。

点击“发送”。

如果您已知接收方的 Gonka 钱包地址

将接收方的 Gonka 钱包地址粘贴到地址字段中。指定您要发送的金额。

如果您不知道接收方的 Gonka 钱包地址

接收方应打开其已添加 Gonka 账户的 Keplr 钱包。点击余额上方的“复制地址”。

他们搜索 Gonka 链。

他们复制并发送给您他们的地址。

将接收方的 Gonka 钱包地址粘贴到地址字段中。指定您要发送的金额。

确认交易。

等待交易成功的通知。由于 Gonka 是非原生链，您不会在活动标签中看到该交易。

Keplr（移动应用）

要使用 Keplr 钱包在 Gonka 链上进行 Gonka 账户之间的转账，请登录并打开您的 Keplr 钱包。

在主页上搜索 Gonka 链。

点击“发送”。

如果您已知接收方的 Gonka 钱包地址

将接收方的 Gonka 钱包地址粘贴到地址字段中。指定您要发送的金额。

如果您不知道接收方的 Gonka 钱包地址

接收方应打开其已添加 Gonka 账户的 Keplr 钱包。

他们搜索 Gonka 链并点击。

他们将地址复制到余额上方，或点击“接收”并在下一步中复制地址。

他们复制并发送给你他们的地址。

将接收者的 Gonka 钱包地址粘贴到地址字段中。指定您要发送的金额。

确认交易。

等待屏幕显示交易成功的确认信息。由于 Gonka 是非原生链，您不会在活动标签中看到该交易。

检查交易状态

发送交易后，您可能希望验证交易是否已成功处理并包含在区块中。每个交易都会分配一个唯一的哈希（TXHASH），您可以使用它在区块链上查询其状态。要检查交易状态，请使用以下命令：

inferenced query tx <TXHASH> --chain-id gonka-mainnet [--node <node_rpc_url>]

将 <TXHASH> 替换为您从转账命令中收到的实际交易哈希。
如有需要，您可以选择指定节点和链 ID。

示例：

inferenced query tx 9712D97F127A1908C4DC4A1F4409AE380DC3BF0D662FA8D7E394422989CFFE2F --chain-id gonka-mainnet

如果交易成功，输出将包含：

code: 0 — 表示成功
区块 height — 交易被包含的区块
timestamp — 区块被提交的时间
交易消息的详细信息（例如使用的 sender、receiver、amount、module、gas）

示例响应（为清晰起见已简化）：

code: 0
txhash: 9712D97F127A1908C4DC4A1F4409AE380DC3BF0D662FA8D7E394422989CFFE2F
height: "233596"
timestamp: "2025-04-24T02:21:24Z"
tx:
  ...
  body:
    messages:
    - '@type': /cosmos.bank.v1beta1.MsgSend
      from_address: gonka17ek5qgf94zsp024kppcyze37p95drr3wnt6jp3
      to_address: gonka1ydt57pmnsd508ckw4fh6ey6h299v50zljpylla
      amount:
      - amount: "10"
        denom: ngonka

如果代码非零，则交易失败。请检查 raw_log 或 info 字段以获取错误信息。