Warning

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

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

0x972a7a92d92796a98801a8818bcf91f1648f2f68

通过仪表板跨链（UI 指南）

仪表板是最简单的跨链桥接方式。它会自动为您处理密钥派生（参见地址与密钥），因此您无需手动导入私钥或计算地址。

Tip

如果你不熟悉命令行工具（CLI）或不希望手动处理私钥，建议使用仪表板。手动操作的 CLI 流程详见存入 USDT、提取 USDT、存入 GNK 和提取 GNK。

仪表板的功能

自动推导正确的地址。 连接你用于跨链的以太坊钱包后，仪表板会显示对应的 gonka1… 地址，即跨链桥将代币发送到的目标地址——这样你始终清楚你的包装代币将到达何处。
警告助记词账户风险。 如果你使用的钱包其以太坊和 Gonka 密钥源自相同的助记词（mnemonic），仪表板会检测到并发出警告，因为由助记词生成的账户在不同链上使用不同的密钥——你的 Gonka 钱包默认不会显示跨链代币。你仍然控制接收地址（可以从同一助记词中派生出匹配的密钥），但需要额外的手动派生步骤。详见地址与密钥了解完整说明。
显示你的跨链余额，在"Bridge Assets"部分展示，以便确认充值是否到账。
报告链的运行状态，让你在发起转账前确认链是否处于异常状态。
提示更新跨链桥纪元（epoch），当以太坊跨链桥落后于 Gonka 链时。如果看到 A Bridge needs epoch update，点击 Update bridge 以提交缺失的纪元密钥。这是一笔普通的以太坊交易，因此由连接的钱包支付 Gas 费。详见跨链桥纪元更新。

支持的操作流程

仪表板支持全套跨链操作，无需使用命令行工具（CLI）：

ETH 跨链桥 — 将任意 ERC-20 代币（USDT、USDC、WETH 等）从以太坊存入 Gonka，或提现回以太坊。
GNK 跨链桥 — 将原生 GNK 跨链为以太坊上的 WGNK，或反向赎回。
IBC 跨链桥 — 在 Gonka 与已连接的 Cosmos 链（Kava）之间转移 IBC 原生代币（如 USDT）。

处理时间与费用

跨链桥类型	方向	处理时间	Gas 支付币种
ETH 跨链桥 (ERC-20)	以太坊 → Gonka	~15–20 分钟（等待以太坊最终确认）	ETH
ETH 跨链桥 (ERC-20)	Gonka → 以太坊	~1–5 分钟	ETH
GNK 跨链桥	Gonka → 以太坊（铸造 WGNK）	~1–5 分钟	ETH
GNK 跨链桥	以太坊 → Gonka（销毁 WGNK）	~15–20 分钟	ETH
IBC	Kava → Gonka	~1–3 分钟	KAVA
IBC	Gonka → Kava	~1–3 分钟	GNK（0 费用）

存入代币到 Gonka

本节将引导您使用跨链桥组件将代币存入 Gonka。从 Token 下拉菜单中选择代币——组件会自动检测跨链桥类型：

ERC-20 代币（USDC、USDT、WETH 等）和 GNK（作为 WGNK）通过以太坊跨链桥。
IBC 代币（USDT IBC 等）通过 IBC 连接到 Cosmos 链。

ETH / GNK 跨链桥存入流程

在以太坊上锁定代币 — 您的代币被发送至跨链桥合约并锁定。
验证者签名 — Gonka 验证者观察已最终确认的以太坊充值并收集 BLS 签名。
在 Gonka 上铸造 — 包装代币在 Gonka 上被铸造并发送到您派生的 gonka1… 地址。

IBC 存入流程

在钱包中批准转账 — 您在源链（如 Kava）上签署 IBC 转账。
IBC 数据包中继 — 数据包被中继到 Gonka。
代币到达 Gonka — IBC 代币出现在您的 Gonka 钱包中。

1. 打开仪表板

在浏览器中打开任一创世节点：

在左侧边栏中导航到 Developers 部分。您将在页面底部看到带有 WITHDRAW / DEPOSIT 切换按钮的跨链桥组件。

2. 连接您的 Keplr 钱包

确认 DEPOSIT 切换按钮已选中。点击 CONNECT WALLET。

弹出对话框将显示可用的钱包选项。选择 KEPLR。

Keplr 显示"Not Installed"？

如果看到"Not Installed"消息，您需要先安装 Keplr 浏览器扩展。请按照创建 Gonka 账户 → Keplr 浏览器扩展中的说明进行设置，然后返回此处。

如果提示输入 Keplr 密码，请输入。连接成功后，组件将显示 Keplr Connected 及您的 Gonka 地址缩写和 GNK 余额。点击 CONTINUE 继续。

助记词（mnemonic）账户

如果您的 Gonka 账户是通过助记词（mnemonic） 而非原始私钥创建的，跨链桥组件会检测到地址不匹配并发出警告。这是因为以太坊和 Gonka 从同一助记词派生出不同的密钥，因此代币将被发送到与钱包当前显示不同的 gonka1… 地址。资金不会丢失——您可以从同一助记词派生出匹配的密钥——但需要手动派生步骤。如果看到此警告，请停止操作并阅读地址与密钥。

3. 选择代币和金额

在步骤 2 中，从 Token 下拉菜单中选择您要存入的代币，并输入 Amount（金额）。组件会显示您的当前余额，Receiving address on Gonka 会从您连接的钱包中自动填入。

组件还会显示预计的处理时间和大致费用（费用币种取决于跨链桥类型——参见上方表格）。

ERC-20 (USDC)GNKIBC (USDT)

点击 REVIEW & BRIDGE。

4. 确认交易

您的钱包将打开一个确认交易界面。在批准之前请仔细核对详情：

ERC-20 (USDC)GNKIBC (USDT)

Token and amount — 验证正确的代币和金额。
From — 您的以太坊地址（发送方）。
To — 跨链桥合约地址（0x972a7A92…648f2F68）。这是预期行为——您正在将代币发送至跨链桥，跨链桥随后将在 Gonka 上铸造包装代币。
Tx Fee — 以太坊 Gas 费用。

Token and amount — 验证正确的代币和金额。
To — 跨链桥合约地址。
Tx Fee — 以太坊 Gas 费用。

消息类型 — IBC Transfer。
金额和目标 — 例如 "Send 0.1 USDt to gonka1… via channel-161"。
Tx Fee — 以 KAVA 支付（例如 0.05 KAVA）。

点击 Approve 提交交易。

Warning

确认前请仔细核对所有信息。跨链转账不可逆。如有任何异常，请点击 ✕ 取消并重新开始。

5. 充值完成

组件将显示 Deposit complete 界面，包含操作摘要。

ERC-20 (USDC)GNKIBC (USDT)

进度指示器显示：

Approve transfer in wallet — done
IBC packet relay transfer — done

在此界面您可以：

点击 VIEW ON EXPLORER 查看交易详情。
点击 TRANSFER MORE TOKENS 进行下一笔充值。
点击 DISCONNECT 断开钱包连接。

6. 验证充值结果

您可以通过以下方式确认包装代币已到账：

在仪表板中：打开 https://node2.gonka.ai:8443/dashboard/gonka/account/<your_gonka_address> 查看余额。
通过交易链接：查看充值完成界面上显示的交易链接。
在 Keplr 中：包装代币（CW-20）不会自动出现在 Keplr 中——请按照以下步骤手动添加。

在 Keplr 中添加包装代币

包装的 ERC-20 代币（如 wUSDC 和 wUSDT）是 Gonka 链上的 CW-20 代币。Keplr 不会自动检测 CW-20 代币，因此您需要将其作为自定义代币添加。

Note

IBC 代币（通过 IBC 而非以太坊跨链桥转入的）会在 Keplr 中自动显示。以下手动步骤仅适用于跨链桥包装的 CW-20 代币。

步骤 1. 打开您的 Keplr 钱包，点击右上角的菜单图标（三条横线），选择 Manage Asset List。

步骤 2. 点击右上角的 + 按钮添加自定义代币。

步骤 3. 在 Add Custom Token 页面，从链下拉菜单中选择 Gonka。将 CW-20 合约地址粘贴到 Contract Address 字段中。代币元数据（名称、符号、精度）将自动填入。点击 Confirm。

已知合约地址：

代币	Gonka 上的 CW-20 合约地址
USDC	`gonka1fa83z7np903k9vh63guy82qthtv373d7vjeq0y7xeqh50rzn8vtssffkre`
USDT	`gonka15ggwj9un6qrmu4nj5ev6l7kpdcr00td03ff2mmj4cyhl8u8vjd2qnl3hgk`

步骤 4. 完成——该代币现在会以 Gonka CW20 代币的形式出现在您的 Keplr 钱包中。

从 Gonka 提现代币

本节将引导您使用跨链桥组件从 Gonka 提现代币。从 Token 下拉菜单中选择代币——组件会自动检测跨链桥类型：

ERC-20 代币和 GNK 通过以太坊跨链桥。
IBC 代币（USDT IBC 等）通过 IBC 连接到 Cosmos 链。

ETH / GNK 跨链桥提现流程

在 Gonka 上销毁代币 — 包装代币在 Gonka 链上被销毁（或原生 GNK 被锁定）。
验证者签名 — Gonka 验证者生成 BLS 聚合签名以授权释放操作。
在以太坊上释放 — 原始代币从以太坊上的跨链桥合约中释放（或铸造 WGNK）。

IBC 提现流程

在钱包中批准转账 — 您在 Gonka 上签署 IBC 转账。
IBC 数据包中继 — 数据包被中继到目标链。
代币到达 — IBC 代币出现在目标链（如 Kava）上的钱包中。

1. 打开仪表板

在浏览器中打开任一创世节点：

在左侧边栏中导航到 Developers 部分。在跨链桥组件中选择 WITHDRAW 切换按钮。

2. 连接您的 Keplr 钱包

确认 WITHDRAW 切换按钮已选中。点击 CONNECT WALLET。

弹出对话框将显示可用的钱包选项。选择 KEPLR。

Keplr 显示"Not Installed"？

如果看到"Not Installed"消息，您需要先安装 Keplr 浏览器扩展。请按照创建 Gonka 账户 → Keplr 浏览器扩展中的说明进行设置，然后返回此处。

如果提示输入 Keplr 密码，请输入。连接成功后，组件将显示 Keplr Connected 及您的 Gonka 地址缩写和 GNK 余额。点击 CONTINUE 继续。

助记词（mnemonic）账户

如果您的 Gonka 账户是通过助记词（mnemonic） 而非原始私钥创建的，跨链桥组件会检测到地址不匹配并发出警告。这是因为以太坊和 Gonka 从同一助记词派生出不同的密钥，因此代币将被释放到与钱包当前显示不同的以太坊地址。资金不会丢失——您可以从同一助记词派生出匹配的密钥——但需要手动派生步骤。如果看到此警告，请停止操作并阅读地址与密钥。