跨链桥接与兑换

对于您要转移的具体资产对，Puffin 会自动选择最快、最安全的路径进行跨链转账——您只需调用一个端点，路径的选择与执行都由我们完成。

工作原理

智能路由

每笔转账都会根据涉及的资产和链进行评估，并按能最快、最可靠完成的方式路由——没有封装资产，也无需自行计算流动性池的滑点。

始终只有一个端点

同资产跨链转账和跨资产兑换都通过同一个调用完成。您永远不需要自己选择具体机制。

POST /bridge/quote 会在您确认之前告知网络费用和预计到账时间——响应中的 route 是仅供支持排查使用的内部路由标识符，客户端无需据此做任何判断。

先报价，再执行

curl -X POST https://api.puffinmoney.com/v1/gateway/api/bridge/quote \
  -H "X-API-Key: mk_live_..." \
  -d '{
    "walletId": "8f2a1c...",
    "toChain": "BASE",
    "toToken": "USDC_BASE",
    "amount": "1000.00",
    "destinationAddress": "0xabc..."
  }'

{
  "quote": { "route": "auto", "networkFee": "0.10", "estimatedOutAmount": "999.90", "etaSeconds": 30 },
  "ourFee": { "platformFee": "1.00", "gasFee": "0.05", "totalFee": "1.05" }
}

ourFee 是 Puffin 在报价网络费用之上收取的平台费 + gas 恢复费——具体如何配置请参见定价。准备好后：

curl -X POST https://api.puffinmoney.com/v1/gateway/api/bridge \
  -H "X-API-Key: mk_live_..." \
  -H "Idempotency-Key: bridge_2026-07-22_001" \
  -d '{
    "walletId": "8f2a1c...",
    "toChain": "BASE",
    "toToken": "USDC_BASE",
    "amount": "1000.00",
    "destinationAddress": "0xabc..."
  }'

这会立即扣除源钱包的资金，并返回一个可供您轮询的 bridgeTransfer——或者直接等待 webhook 通知。

curl https://api.puffinmoney.com/v1/gateway/api/bridge/<id> \
  -H "X-API-Key: mk_live_..."

状态	含义
`pending` / `source_sent`	已扣款，正在广播源端交易
`attesting`	正在确认转账，随后才能在目标链上完成交付
`completed`	资金已交付到 `toChain` 上的 `destinationAddress`
`failed` / `refunded`	未能完成——详情请查看 `metadata`

Webhooks

订阅 bridge.completed 和 bridge.failed——完整的 payload 结构请参见 Webhooks。

目前跨链桥接仅支持 USDC/USDT，与钱包即服务的链/代币矩阵一致（Solana、Polygon、BSC、Base）。对未配置路径的桥接请求会返回 bridge_not_configured——这是我们这边在开通某条通道过程中的运营性限制，无法通过客户端方式绕过。

快速开始

接受付款的方式

Wallet-as-a-Service

深入了解

跨链桥接与兑换

工作原理

智能路由

始终只有一个端点

先报价，再执行

Webhooks

​工作原理

智能路由

始终只有一个端点

​先报价，再执行

​Webhooks

工作原理

先报价，再执行

Webhooks