跳转至

Warning

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

由 Gonka 共识控制的专用跨链桥智能合约已在以太坊上激活，合约地址为：text 0x972a7a92d92796a98801a8818bcf91f1648f2f68---

地址与密钥

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

一把密钥，两个地址

以太坊和 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 时，你无法选择接收地址 —— 它由你的密钥固定决定。

种子短语陷阱（请务必阅读！）

大多数用户从未直接看到自己的原始私钥 —— 他们仅持有助记词（种子短语），并由钱包自动从中派生密钥。这虽然方便，但在跨链时却容易陷入陷阱：

一个种子短语并不对应单一密钥。钱包使用 BIP-44 派生路径 从种子短语生成密钥，而每条区块链使用不同的路径：

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

由于路径不同，同一个种子短语会为以太坊和 Gonka 生成完全不同的私钥，因此也对应两个毫无关联的地址。如果你从一个由种子派生的以太坊账户发起存款，然后在钱包中查看由种子派生的 Gonka 账户，这两个账户并非同一把密钥，因此跨链的代币将到达一个你的钱包未显示、甚至可能无法控制的 gonka1… 地址。

Danger

不要假设“相同的种子短语 = 两条链上的同一账户”。对于桥接，你需要的是在两条链上使用相同的私钥，而不是相同的种子短语。使用标准但不同的派生路径，会导致资金被发送到由你的以太坊密钥派生出的地址 —— 而你的 Gonka 钱包使用不同路径派生，因此无法控制该地址。这并非永久性损失，你仍可从同一种子短语中派生出原始的以太坊私钥，该私钥即控制着 Gonka 链上的接收账户。

如何获取匹配的 Gonka 地址

你有两种选择。

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

Gonka 仪表盘可自动为你解决派生问题。使用你进行跨链操作的同一个以太坊钱包连接仪表盘，它将自动计算并显示桥接器将使用的正确 gonka1… 地址，展示你的封装代币余额，并引导你完成存款/取款流程。这避免了手动处理原始私钥，也消除了上述种子短语带来的混淆问题。

访问仪表盘地址：text https://node1.gonka.ai:8443/dashboard/### 选项 B — 将相同的私钥导入 Gonka 密钥环

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

Show the derived Gonka address

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

Warning

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

快速检查清单

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