royaltyInfo 怎么查？用 ERC-2981 接口核验版税声明

你要解决的问题

想了解某个 NFT 系列的版税到底声明了多少、付给谁？如果合约实现了 ERC-2981，链上就有唯一权威答案：royaltyInfo() 函数。本文给出免写代码的查询方法。

这个接口长什么样

ERC-2981 定义了一个查询函数：

function royaltyInfo(uint256 tokenId, uint256 salePrice)
    external view
    returns (address receiver, uint256 royaltyAmount);

给它一个代币编号和一个假设的售价，它返回两样东西：版税收款地址 receiver，以及该售价下应付的版税金额 royaltyAmount。金额用与售价相同的货币单位计算（售价用 ETH 回答就用 ETH）。OpenZeppelin 的常见实现把比例以基点（万分比）存储，例如 500 即 5%。

关键前提，标准原文写得很直白：版税支付是自愿的（voluntary），这个接口只负责“声明应付多少”，不强制任何市场付款。

三种查询步骤

方法一：区块浏览器（最常用）

打开 Etherscan 等浏览器，搜索该 NFT 的合约地址；
进入 Contract Read as Proxy（读取）标签，连接或不连接钱包均可；
找到 royaltyInfo，tokenId 填你想查的编号，salePrice 填一个 Wei 单位的测试值（如查 1 ETH 售价下的版税就填 1000000000000000000）；
点击 Query：返回的 receiver 就是版税地址，royaltyAmount 换算回 ETH 就是版税金额。

方法二：市场合约页

在 OpenSea 等市场的 Collection 页面点开合约地址，同样能进入上述读取界面，适合从藏品页顺藤摸瓜。

方法三：编程调用

用任何合约交互库调用 royaltyInfo(tokenId, 1e18)，把返回值当百分比读。适合批量核验一个系列是否所有代币用同一收款地址。

查不到怎么办

调用报错或返回全零：合约大概率没实现 ERC-2981，版税只能依据市场政策（见平台规则区别）。
用 supportsInterface(0x2a55205a) 可快速探测是否声明支持该接口。
部分系列用链下注册表或自己的合约逻辑计算版税，链上查询结果以合约实现为准。

看懂结果的三条纪律

声明比例高，不代表你在任何平台卖出都会被收取；声明为 0，也不代表创作者不希望你付款——标准依赖市场自觉。
版税地址指向匿名合约时，先查该合约是否项目方公开认领。
不同 salePrice 可能对应不同比例（标准允许阶梯设计），多测几个价位更稳妥。

读结果时的两个单位陷阱

第一，单位换算。salePrice 与 royaltyAmount 都以 Wei 计，1 ETH 等于 10 的 18 次方 Wei；返回 250000000000000000 对应 0.25 ETH，即 2.5% 版税。第二，基点陷阱。OpenZeppelin 实现用万分比存比例，看到 330 别读成 33%，它是 3.3%；不同实现的分母可能不是 10000，所以最稳妥的读法仍然是固定填 1 ETH 的 Wei 值、直接读返回的 ETH 数，把换算问题绕开。若某合约对 1 ETH 售价返回了明显异常的值（比如整笔售价都给了收款人），应立即核查合约实现——标准允许最高 100% 的设置，这类设置在任何真实交易场景里都值得警惕。