跳转至

Warning

务必先进行小额测试交易。跨链转账是不可逆的，因此在转移大额资金之前，请先发送少量金额，并确认其如期到账。

由 Gonka 共识控制的专用跨链桥智能合约已在以太坊上部署，地址为：

0x972a7a92d92796a98801a8818bcf91f1648f2f68

地址与密钥

这是在进行跨链操作前最需要理解的关键页面。请在首次转账前务必仔细阅读。

一个密钥，两个地址

以太坊（Ethereum）和 Gonka 均使用相同类型的加密密钥（secp256k1 密钥对）。因此，一个私钥可以同时控制两条链上的账户。两条链唯一的区别在于如何将公钥转换为人类可读的地址：

链 地址格式 地址如何从公钥派生
以太坊 0x...（20 字节，十六进制） keccak256(未压缩公钥) → 取最后 20 字节
Gonka gonka1...（bech32 格式） ripemd160(sha256(压缩公钥)) → 使用 gonka 前缀编码为 bech32

因此，同一个私钥会生成两个外观不同的地址——一个以 0x… 开头，另一个以 gonka1… 开头——但这两个地址都由同一个私钥控制。

跨链桥如何决定代币去向

当你将代币从以太坊跨链到 Gonka 时，你会将代币发送到桥接合约，并使用你的以太坊私钥签署该交易。Gonka 跨链桥会：

  1. 检测以太坊上已最终确认的充值交易。
  2. 从交易签名中恢复出公钥。
  3. 根据该公钥计算对应的 Gonka 地址（即上述 gonka1… 的标准派生方式）。
  4. 将跨链代币铸造/释放到该 gonka1… 地址。

换句话说：包装代币会被发送到由同一公钥生成的 Gonka 地址——该地址由签署以太坊充值交易的同一私钥所控制。要使用这些代币，你必须在 Gonka 链上使用相同的私钥。

反向操作则有所不同：当你从 Gonka 跨回以太坊时，你可以在提现交易中显式指定目标地址；而当你跨到 Gonka 时，你无法选择接收地址——它由你的密钥唯一确定。

助记词陷阱（请务必阅读！）

大多数用户从未直接接触过原始私钥——他们通过助记词（mnemonic）由钱包自动生成密钥。这虽然方便，但在跨链时容易陷入陷阱：

一个助记词并不对应单一密钥。钱包通过 BIP-44 派生路径从助记词生成密钥，而不同区块链使用不同的路径：

  • 以太坊钱包使用币种类型 60 → 路径为 m/44'/60'/0'/0/0
  • Cosmos/Gonka 钱包使用币种类型 118 → 路径为 m/44'/118'/0'/0/0

由于路径不同，同一个助记词会为以太坊和 Gonka 生成完全不同的私钥——从而产生两个互不相关的地址。如果你从一个由助记词派生的以太坊账户发起充值，然后查看同一助记词在钱包中生成的 Gonka 账户，这两个账户并非同一个密钥，因此跨链代币会到达一个你的钱包当前未显示的 gonka1… 地址。你仍然控制该地址（可以从同一助记词中使用币种类型 60 派生出以太坊私钥，并在 Gonka 上使用），但需要额外的手动派生步骤。

Danger

不要认为"相同的助记词 = 两条链上的相同账户"。跨链桥需要的是在两条链上使用相同的私钥，而不是相同的助记词。使用标准的不同派生路径会导致资金被发送到由你以太坊密钥推导出的 Gonka 地址——而你的 Gonka 钱包因使用不同路径派生，可能无法访问该地址。这并非永久丢失，你仍然可以从同一助记词中派生出原始的以太坊私钥，该私钥即可控制 Gonka 链上的接收账户。

如何获取匹配的 Gonka 地址

你有两种选择。

选项 A — 使用仪表盘（推荐）

Gonka 仪表盘可自动解决密钥派生问题。只需使用你用于跨链的同一个以太坊钱包连接，仪表盘便会自动计算并显示跨链桥将使用的正确 gonka1… 地址，展示你的封装代币余额，并引导完成存款/提现流程。这种方式无需手动处理私钥，也能避免上述助记词派生混乱的问题。

访问仪表盘地址：

https://node1.gonka.ai:8443/dashboard/

选项 B — 将相同的私钥导入 Gonka 密钥环

如果你使用命令行操作，请将控制你以太坊账户的完全相同的 secp256k1 私钥（十六进制格式）导入到 Gonka 密钥环中。生成的 gonka1… 地址即为桥接合约铸币的目标地址：

inferenced keys import-hex <key_name> <YOUR_PRIVATE_KEY_HEX>

# 显示派生的 Gonka 地址
inferenced keys show <key_name> -a

此处打印的地址正是将接收您跨链代币的 gonka1… 地址，该密钥可为其签署 Gonka 交易（转账、提现等）。

Warning

导入原始私钥会将其暴露于您导入的设备和密钥环中。建议在安全设备上使用基于文件的密钥环（--keyring-backend file），切勿在不受信任的主机上粘贴保护大量以太坊资金的私钥。如有疑问，请使用仪表板（dashboard）。

快速检查清单

  • 在开始之前，确定您将使用哪个密钥进行跨链。
  • 如果您的以太坊地址上已有 USDT/ETH：从该密钥推导出对应的 gonka1… 地址（通过仪表板或 import-hex 命令）。
  • 如果您想使用现有的 Gonka 地址：从该密钥推导出对应的 0x… 以太坊地址，并用代币及足够的 ETH（用于支付 Gas）进行充值。
  • 务必先发送少量测试金额，并确认其已到达预期的 gonka1… 地址。