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.
- 디자이너가 2차 시장에서 수익을 얻는 게임 아이템.
- 라이선스 비가 모든 판매를 따라가는 브랜드 라이선스 수집품.
한계와 위험
- 훅이 보는 것은 옮겨진 토큰 수이지 가격이 아닙니다. 별도 트랜잭션으로 정산한 판매("0 SOL짜리 선물")는 비율 로열티를 피해 갈 수 있습니다. WNS는 승인 로직으로 이를 다룹니다. 믿기 전에 프로그램을 읽어 보세요.
- 훅을 호출할 때마다 연산 단위가 듭니다. 애그리게이터는 더 요청해야 할 수 있습니다.
- WNS 감사는 공식적으로 완료되지 않은 것으로 기록되어 있습니다. 그에 맞게 다루세요.
그림으로 보는 Wen
이 모델에서 Wen의 자리
여기서 Wen의 발명이 작동합니다. wen_royalty_distribution은 Wen Program Library의 두 프로그램 중 하나입니다. 창작자 커뮤니티는 WEN으로 가격을 매기거나 팁을 줄 수 있고, 로열티 규칙 자체는 토큰 안에 남습니다. 전체 그림은 Wen Program Library 리뷰에서.
Wen의 실: 하나의 컨트랙트, 어디에나
랩의 모든 모델은 무료이고 공개되어 있으며, 모두 같은 서명을 지닙니다. 바로 $WEN 토큰 컨트랙트입니다. 복사해 내 문서에도 적어 두고, 쓰기 전에는 반드시 익스플로러에서 확인하세요.
WENWENvqqNya429ubCdR81ZmD69brwQaaBYY6p3LCpk
확인: Solana Explorer · 컨트랙트 ID 찾는 법
오픈 사용 정책
- 무료이고 공개. 랩의 모든 코드는 Wen Program Library와 같은 Apache License 2.0으로 공개됩니다. 상업적이든 아니든 쓰고, 고치고, 배포하세요. 라이선스 고지만 유지하면 됩니다.
- 오픈 도구만. 공개되어 있고 문서화된 도구로 만듭니다: 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





