跳转到内容

发送 ERC20 和 TRC20 代币转账

用 Chaingateway 发送 ERC20、BEP20 或 TRC20 代币时,你要把发送方、接收方、金额和代币的合约地址,连同钱包密码或私钥,提交到该链的代币端点。代币转账是一次智能合约调用,所以发送方还需要持有该链的原生币来支付手续费:ETH、BNB、MATIC 或 TRX。响应会返回交易哈希。

API token 的获取方式见快速入门。在 Ethereum、BNB Smart Chain 和 Polygon 上,发送地址必须是通过 Chaingateway API 创建的,或已导入其中,否则签名步骤会失败。创建地址的方法见创建地址。

代币转账:检查代币余额,确认发送方持有支付手续费的原生币,用合约地址提交转账,读取交易哈希 GET/api/v2/{chain}/balances/{address}/erc20/{contract} 发送方的代币够吗? 发送方持有支付手续费的原生币 ETH、BNB、MATIC 或 TRX POST /api/v2/{chain}/transactions/erc20 from、to、amount、contractaddress,以及 password 或 privatekey 响应:txid 状态码 201
余额检查和手续费检查都要在转账之前完成。

每条链都有以代币标准命名的独立代币端点,所有 EVM 链的请求体相同。

区块链API 路由标准
Ethereum/api/v2/ethereum/transactions/erc20ERC-20
Binance Smart Chain/api/v2/bsc/transactions/bep20BEP20
Polygon/api/v2/polygon/transactions/erc20ERC-20
Arbitrum/api/v2/arbitrum/transactions/erc20ERC-20
Tron/api/v2/tron/transactions/trc20TRC20
Solana/api/v2/solana/transactions/SPLSPL

要在测试网上运行请求,请添加请求头 X-Network: testnet。测试网列表见支持的网络。Bitcoin 没有代币端点。

把下列字段提交到你所用链的路由。示例在 Ethereum 上发送 ERC20 代币。

  • from:发送方地址。
  • to:接收方地址。
  • amount:要发送的代币数量。
  • contractaddress:代币的合约地址。
  • password:钱包密码,没有 privatekey 时必填。
  • privatekey:发送方的私钥,用于不带密码创建的地址。

gas、gasprice、maxPriorityFeePerGas、maxFeePerGas 和 nonce 是可选的。

Terminal window
curl --request POST \
--url https://app.chaingateway.io/api/v2/ethereum/transactions/erc20 \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--data '{
"from": "0xYourSenderAddress",
"to": "0xRecipientAddress",
"amount": 100,
"contractaddress": "0xTokenContractAddress",
"password": "YourPassword"
}'

代码会返回交易哈希:

{
"status": 201,
"ok": true,
"message": "Succesfully created",
"data": {
"txid": "0x73344d178812d4919e9002c560781f288030edf72ece88823ef1c377dfb71f27"
}
}

TRC20 请求与 ERC20 请求几乎相同。路由是 /api/v2/tron/transactions/trc20,地址是 Tron 地址,签名使用 password 或 privatekey。OpenAPI 文件把 from、to、contractaddress 和 amount 列为必填。示例使用的是不带密码创建的地址的私钥。

Terminal window
curl --request POST \
--url https://app.chaingateway.io/api/v2/tron/transactions/trc20 \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--data '{
"from": "TYourSenderAddress",
"to": "TRecipientAddress",
"amount": 100,
"contractaddress": "TTokenContractAddress",
"privatekey": "YourPrivateKey"
}'

创建 TRC20 代币交易完整讲解了 TRC20 的整个流程,包括读取合约和自行签名的端点。

请先读取余额,以免发出一笔注定失败的交易。在 EVM 链上,GET /api/v2/ethereum/balances/{address}/erc20/{contract_address} 返回某个代币的余额,GET /api/v2/ethereum/balances/{address}/erc20 列出一个钱包的代币余额。在 BNB Smart Chain 上,路径中的片段是 bep20;在 Tron 上是 GET /api/v2/tron/balances/{address}/trc20/{contract_address}。GET /api/v2/ethereum/erc20/{contract_address} 返回代币的合约信息。

大多数失败属于下面三种原因之一,每种对应的消息不同。

  • 密码错误会返回状态码 401 和 Wrong password provided。
  • 缺少字段或字段格式错误会返回状态码 422 和 Data validation failed,字段名列在 errors 中。
  • 发送方的原生币不足会返回状态码 422 和节点给出的消息,例如 insufficient funds for gas * price + value。在 Tron 上,对应的消息是 balance is not sufficient。

最后一种原因常让只持有代币的人意外:手续费用 ETH、BNB、MATIC 或 TRX 支付,从来不用代币支付。EVM 链的手续费模型请阅读 Ethereum gas 文档,energy 和 bandwidth 请阅读 TRON 的资源模型。如果你的 TRON 地址持有代币却没有 TRX,请参阅代付 TRC20 手续费中列出的方案。

NFT 转账使用 ERC721 端点,例如 POST /api/v2/ethereum/transactions/erc721。请求体的签名字段与上文相同,但用 NFT 的 id tokenId 取代 amount。from、contractaddress、to 和 tokenId 是必填项。GET /api/v2/ethereum/nfts/{contract_address}/owner/{token_id} 返回当前所有者,.../uri/{token_id} 返回代币 URI。该标准定义在 EIP-721 中。