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: NFT에 새겨진 로열티, 30초. 플레이어는 재생을 누른 뒤에만 YouTube에서 불러옵니다.

쓸모 있는 곳

  • 디지털 아트, 음악, 영상 NFT.
  • 디자이너가 2차 시장에서 수익을 얻는 게임 아이템.
  • 라이선스 비가 모든 판매를 따라가는 브랜드 라이선스 수집품.

한계와 위험

  • 훅이 보는 것은 옮겨진 토큰 수이지 가격이 아닙니다. 별도 트랜잭션으로 정산한 판매("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 찾는 법

오픈 사용 정책

  • 무료이고 공개. 랩의 모든 코드는 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

빛나는 칼날을 든 Wen이 안개 낀 숲속 오래된 조각 사원의 문 앞에 서 있다
돌에 새긴 규칙: 로열티 규칙은 NFT 안에 있습니다. 토큰을 옮기기 전에 읽어 보세요.