← 博客
10 分钟阅读
|
发布于
|
更新于

NFT 功能与 estimateGas:2021 年发布

Chaingateway 的 NFT 功能可读取 ERC-721、BEP-721 或 TRC-721 代币的所有者与元数据 URI,并将其发送到另一个地址。本文介绍 2021 年 11 月版本新增的 getNFTOwner、getNFTURI、sendNFT 和 estimateGas 及其 v2 API 用法。

章节
C
Chaingateway Team
区块链专家

审核: 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 字段均为可选。

Terminal window
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 参考。

C
Chaingateway Team
区块链专家

Chaingateway 团队致力于为全球开发者简化区块链集成。