NFT 功能与 estimateGas:2021 年发布
Chaingateway 的 NFT 功能可读取 ERC-721、BEP-721 或 TRC-721 代币的所有者与元数据 URI,并将其发送到另一个地址。本文介绍 2021 年 11 月版本新增的 getNFTOwner、getNFTURI、sendNFT 和 estimateGas 及其 v2 API 用法。
审核: Maurice Sobiera
Chaingateway 的 NFT 功能可以读取 ERC-721、BEP-721 或 TRC-721 代币的所有者和元数据 URI,并将其发送到另一个地址。2021 年 11 月的版本为以太坊、Tron 和 BSC 新增了 getNFTOwner、getNFTURI 和 sendNFT。它还为以太坊和 BSC 新增了 estimateGas,该函数可在不发送交易的情况下返回交易的 gas 估算值。
什么是 NFT?
非同质化代币(NFT)是一种每个单位都拥有独立代币 ID 的代币。它最早在以太坊上以 ERC-721 的形式实现了标准化。ERC-20 代币可以互换:任何一个单位都与另一个相同。ERC-721 代币则不同,因为每个代币 ID 都可以拥有自己的所有者和自己的元数据。
该标准定义于 EIP-721。它规定 ownerOf(tokenId) 返回所有者,safeTransferFrom 用于转移代币。可选的元数据扩展增加了 tokenURI(tokenId),它返回指向代币元数据的链接。BNB 智能链上的 BEP-721 和 Tron 上的 TRC-721 遵循相同的模型。
EIP-721 标准化了一个安全转账函数 safeTransferFrom,以及一个不安全的函数 transferFrom。使用 transferFrom 时,调用方必须确认接收地址能够处理 NFT。该标准警告,否则代币可能会永久丢失。在把代币发送到合约地址之前,请先检查接收方。如需更完整的介绍,请阅读ERC721 代币标准。
2021 年的版本新增了哪些 NFT 函数?
该版本新增了三个 NFT 函数。三者均可用于以太坊、Tron 和币安智能链 API。
| 函数 | 功能 | 参数 |
|---|---|---|
| getNFTOwner | 返回一个 NFT 的所有者地址 | 代币 ID、代币合约地址 |
| getNFTURI | 返回一个 NFT 的 URI | 与 getNFTOwner 相同 |
| sendNFT | 将一个 NFT 发送到另一个地址 | 发送方地址、目标地址、合约地址、代币 ID |
这些名称描述的是 2021 年公布时的函数。当时的文档是其确切用法的参考。
Chaingateway 能铸造 NFT 吗?
本次版本不包含专门的铸造函数。您仍可以自行对合约调用进行编码,并将编码后的数据作为普通交易发送,从而完成铸造。
这与该标准一致,因为 EIP-721 没有定义铸造。规范中写明,NFT 的创建和销毁不包括在内,合约可以通过其他方式实现它们。因此,铸造的运作方式因合约而异。2021 年,团队表示缺少用于测试铸造函数的环境,并请 ERC-721、BEP-721 或 TRC-721 合约的所有者协助测试。
estimateGas 做什么?
estimateGas 在您发送交易之前,返回该交易预计需要的 gas 数量。对于以太坊和 BSC,它接收与普通交易相同的参数,但不包括密码。之所以新增该功能,是因为许多用户要求更简便的 gas 费计算方式。
其底层机制是以太坊 JSON-RPC 接口的 eth_estimateGas 方法。根据以太坊开发者文档,它在不把交易添加到区块链的情况下生成估算值。同一页面提醒,估算值可能显著高于交易实际使用的 gas。请把该结果视为 gas limit 的上限,而非最终费用。例如,普通的以太币转账使用 21000 gas,同一页面将其显示为 0x5208。
今天可以使用哪些功能?
上述函数名称来自 2021 年的 API 版本。当前公开的 OpenAPI 规范(版本 2.1.0)组织方式不同,因此本节列出截至 2026 年 11 月 5 日它所包含的内容。
| 任务 | v2 规范中的端点 |
|---|---|
| 在以太坊上发送 ERC-721 代币 | POST /api/v2/ethereum/transactions/erc721 |
| 在 BSC 上发送 BEP-721 代币 | POST /api/v2/bsc/transactions/bep721 |
| 在 Tron 上发送 TRC-721 代币 | POST /api/v2/tron/transactions/trc721 |
| 在 Polygon 或 Arbitrum 上发送 ERC-721 代币 | POST /api/v2/polygon/transactions/erc721、POST /api/v2/arbitrum/transactions/erc721 |
| 读取当前 gas 价格 | GET /api/v2/ethereum/gasprice,以及 bsc、polygon 和 arbitrum 下的相同路径 |
规范中没有列出独立的 getNFTOwner、getNFTURI 或 estimateGas 端点。若要读取所有者或 URI,请通过任一 JSON-RPC 端点在代币合约上调用 ownerOf 或 tokenURI。若要估算 gas,同样使用 eth_estimateGas。关于计算方法,请参阅如何估算 gas 费一文。
在以太坊上发送请求时,需要 from、contractaddress、to 和 tokenId。除非您传入 privatekey,否则必须提供 password 字段。gas、gasprice 或 maxFeePerGas 等 gas 字段均为可选。
curl -X POST https://app.chaingateway.io/api/v2/ethereum/transactions/erc721 \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "from": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2", "contractaddress": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2", "to": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2", "tokenId": 1, "password": "your-wallet-password" }'调用成功时返回状态 201,交易哈希位于 data.txid 中。钱包密码错误会返回 401。钱包余额不足以支付 gas 时返回 422,例如消息为“insufficient funds for gas * price + value”。上述地址是规范中的占位值。完整的操作步骤请参阅如何通过 API 转移 NFT。
想讨论新功能吗?
欢迎在 Chaingateway Telegram 群组中留言反馈。
准备好自己动手构建了吗? 获取你的 API key — 7 天试用,无需信用卡 — 或查看 区块链 API 获取完整的 endpoint 参考。