第 2 阶段:创作者版税钩子读取已验证
- 0 · 路线图
- 1 · 收据与保修
- 2 · 创作者版税
- 3 · B2B 发票
- 4 · 支付桥
- 5 · 模拟器
- 6 · Devnet:亲自复现
- 7 · 收银台
- 7.1 · 安全
- ✓ · 信任链
- ★ · 益处与用途
- ✎ · 十篇导读
- ▶ · 视频
- ? · 读者发现

多年来,NFT 版税取决于交易市场愿不愿意支付。WNS 把这条规则放进了代币:每次转移都会运行转账钩子,强制执行创作者的分成。这个模型展示如何看出哪个程序在守护一个 NFT,以及如何转移 NFT 才能让这道守护真正运行。
任务
确保创作者在每次转售时都拿到分成,无论 NFT 是在大型市场、小型市场出售,还是在钱包之间直接转手。
模型
- NFT 铸币带有 Token-2022 的 Transfer Hook 扩展,指定一个钩子程序。对 WNS 资产而言,这个程序就是 WNS 版税分配:
diste3nXmK7ddDTs1zb6uday6j4etCa9RChD8fJ1xay。 - 每次转移时,Token-2022 都会调用钩子。如果钩子的条件不满足,整笔交易就会回滚。
- 钩子需要额外的账户。官方辅助函数
createTransferCheckedWithTransferHookInstruction会从链上读取它们,钱包和市场无需猜测。
| 以前(经典 NFT) | 有了 WNS 转账钩子 | |
|---|---|---|
| 谁来执行版税 | 各个市场,看它愿不愿意 | 代币本身,每次转移都执行 |
| 钱包之间的直接出售 | 版税很容易被绕过 | 钩子照样运行 |
| 集成 | 每个市场各自定制 | 所有人共用一套标准流程 |
代码
文件:lab/code/src/02-royalty-transfer.ts · Apache-2.0
// Model 2: creator royalties. Inspect which program enforces royalties on an NFT,
// then transfer it so that the transfer hook (e.g. WNS royalty distribution) runs.
// License: Apache-2.0. Example code, not audited. Devnet first.
import { PublicKey, Transaction, sendAndConfirmTransaction } from '@solana/web3.js';
import {
TOKEN_2022_PROGRAM_ID, createAssociatedTokenAccountIdempotentInstruction,
createTransferCheckedWithTransferHookInstruction, getAssociatedTokenAddressSync, getMint, getTransferHook,
} from '@solana/spl-token';
import { WNS_ROYALTY_PROGRAM_ID, detectTokenProgram, getConnection, loadKeypair } from './common.js';
/** Read the transfer-hook program attached to a mint. */
export async function inspectRoyaltyHook(mintAddress: string) {
const connection = getConnection();
const mint = new PublicKey(mintAddress);
const program = await detectTokenProgram(connection, mint);
if (!program.equals(TOKEN_2022_PROGRAM_ID)) return { mint: mintAddress, hook: null, note: 'Classic SPL token: no transfer hooks' };
const info = await getMint(connection, mint, 'confirmed', TOKEN_2022_PROGRAM_ID);
const hook = getTransferHook(info);
const hookProgram = hook?.programId ?? null;
return {
mint: mintAddress,
hook: hookProgram?.toBase58() ?? null,
isWnsRoyalty: hookProgram ? hookProgram.equals(WNS_ROYALTY_PROGRAM_ID) : false,
};
}
/** Transfer one NFT. The helper resolves the hook's extra accounts on-chain, so royalties logic runs. */
export async function transferWithRoyalties(mintAddress: string, to: string) {
const connection = getConnection();
const owner = loadKeypair();
const mint = new PublicKey(mintAddress);
const recipient = new PublicKey(to);
const source = getAssociatedTokenAddressSync(mint, owner.publicKey, false, TOKEN_2022_PROGRAM_ID);
const destination = getAssociatedTokenAddressSync(mint, recipient, false, TOKEN_2022_PROGRAM_ID);
const transferIx = await createTransferCheckedWithTransferHookInstruction(
connection, source, mint, destination, owner.publicKey, 1n, 0, [], 'confirmed', TOKEN_2022_PROGRAM_ID,
);
const tx = new Transaction().add(
createAssociatedTokenAccountIdempotentInstruction(owner.publicKey, destination, recipient, mint, TOKEN_2022_PROGRAM_ID),
transferIx,
);
// If the hook rejects the transfer (for example, royalties not approved), the whole transaction rolls back.
return sendAndConfirmTransaction(connection, tx, [owner]);
}
// Example: npx tsx src/02-royalty-transfer.ts <MINT_ADDRESS>
if (process.argv[2]) inspectRoyaltyHook(process.argv[2]).then(r => console.log(r)).catch(e => { console.error(e); process.exit(1); });
已验证的内容
在 LiteSVM 中:创建一个转账钩子指向 WNS 版税程序的 NFT 铸币,检查逻辑能从铸币正确读回该程序。转账函数已对照官方 @solana/spl-token API 做类型检查;端到端运行需要真实的 WNS 程序,这是路线图中 devnet 阶段的任务。
用在哪里
- 数字艺术、音乐和视频 NFT。
- 让设计者从二级市场获得收益的游戏道具。
- 品牌授权收藏品,授权费随每次销售而来。
局限与风险
- 钩子看到的是转移的代币数量,而不是价格。在另一笔交易中结算的销售(“0 SOL 的礼物”)可能躲过按百分比计的版税。WNS 用审批逻辑处理这种情况;依赖它之前请先读懂程序。
- 每次钩子调用都会消耗计算单元,聚合器可能需要申请更多。
- WNS 的审计记录显示尚未正式完成,请据此对待。
图说 Wen
Wen 在此模型中的位置
这正是 Wen 自己的发明在发挥作用:wen_royalty_distribution 是 Wen Program Library 的两个程序之一。创作者社区可以选择用 WEN 标价或打赏,而版税规则本身留在代币里。完整情况请阅读Wen Program Library 综述。
Wen 的主线:一个合约,处处可见
实验室的每个模型都免费且开放,并带着同一个签名:$WEN 代币合约。复制它,在你自己的文档中重复它,使用前务必在浏览器上核验。
WENWENvqqNya429ubCdR81ZmD69brwQaaBYY6p3LCpk
核验:Solana Explorer · 如何找到合约 ID
开放使用政策
- 免费且开放。实验室的全部代码以 Apache License 2.0 发布,与 Wen Program Library 相同。无论是否商用,都可以使用、修改、发布;请保留许可声明。
- 只用开放工具。基于公开且有文档的工具构建:Solana SPL Token-2022(Token Extensions)、Wen New Standard(WNS)的代币布局、Solana Pay,以及用于本地测试的 LiteSVM。
- 规则:始终核验你自己的模型。运行测试,从 devnet 开始,阅读官方文档,检查每个账户和金额,并在任何主网使用之前获得独立审计。未经核验的模型不是模型,而是猜测。
- 未经审计,不构成建议。这些是教学示例,不构成金融、法律或税务建议,也不是持牌的支付或银行产品。在大多数国家,支付、稳定币和收单都是受监管的活动。
- 安全。切勿把私钥粘贴到任何网站。不要安装 npm 包
@wen-community/wen-new-standard:npm 已因恶意将其移除。请从官方来源构建。
由 Wen 为社区讲述。更多内容见我们的编辑与数据政策。
Wen Open Lab · 路线图 · 全部代码 · GitHub 上的 Wen Program Library





