Wen Open Lab · 开放集成

第 2 阶段:创作者版税钩子读取已验证

English · Italiano · 中文 · 한국어

由 Wen 与 AI 一起从英文译出。以英文页面为准;欢迎指正。

Wen 创作者硬币艺术
为创作者付费的艺术

多年来,NFT 版税取决于交易市场愿不愿意支付。WNS 把这条规则放进了代币:每次转移都会运行转账钩子,强制执行创作者的分成。这个模型展示如何看出哪个程序在守护一个 NFT,以及如何转移 NFT 才能让这道守护真正运行。

任务

确保创作者在每次转售时都拿到分成,无论 NFT 是在大型市场、小型市场出售,还是在钱包之间直接转手。

模型

  1. NFT 铸币带有 Token-2022 的 Transfer Hook 扩展,指定一个钩子程序。对 WNS 资产而言,这个程序就是 WNS 版税分配:diste3nXmK7ddDTs1zb6uday6j4etCa9RChD8fJ1xay。
  2. 每次转移时,Token-2022 都会调用钩子。如果钩子的条件不满足,整笔交易就会回滚。
  3. 钩子需要额外的账户。官方辅助函数 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 阶段的任务。

视频 02/10:30 秒看懂写进 NFT 的版税。播放器只会在你点击播放后才从 YouTube 加载。

用在哪里

  • 数字艺术、音乐和视频 NFT。
  • 让设计者从二级市场获得收益的游戏道具。
  • 品牌授权收藏品,授权费随每次销售而来。

局限与风险

  • 钩子看到的是转移的代币数量,而不是价格。在另一笔交易中结算的销售(“0 SOL 的礼物”)可能躲过按百分比计的版税。WNS 用审批逻辑处理这种情况;依赖它之前请先读懂程序。
  • 每次钩子调用都会消耗计算单元,聚合器可能需要申请更多。
  • WNS 的审计记录显示尚未正式完成,请据此对待。

图说 Wen

Wen 版税硬币设计
写进代币的版税
Wen 梗艺术家画廊
梗文化,公平回报
动漫风格的 Wen 猫创作者
创作者优先
Wen 版税动漫故事
每次转售都记得艺术家
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

Wen 手持发光的光刃,站在雾林中一座古老雕刻神庙的门前
刻在石头上的规则:版税规则就在 NFT 里,转移代币前先读一读。