פיתוח טוקנים של Solana: מהנפקה ועד Transfer Hook

import { createMint, createAssociatedTokenAccount, mintTo, TOKEN_2022_PROGRAM_ID, ExtensionType, getMintLen, createInitializeMintInstruction, createInitializeTransferFeeConfigInstruction, } from "@solana/spl-token";
import { Connection, Keypair, SystemProgram, Transaction } from "@solana/web3.js";

async function createTokenWithTransferFee(
  connection: Connection,
  payer: Keypair,
  mintAuthority: PublicKey,
  decimals: number,
  feeBasisPoints: number, // 100 = 1%
  maxFee: bigint, // максимальная комиссия в lamports
) {
  const mintKeypair = Keypair.generate();

  // вычисляем размер аккаунта с нужными extensions
  const extensions = [ExtensionType.TransferFeeConfig];
  const mintLen = getMintLen(extensions);
  const lamports = await connection.getMinimumBalanceForRentExemption(mintLen);

  const transaction = new Transaction().add(
    SystemProgram.createAccount({
      fromPubkey: payer.publicKey,
      newAccountPubkey: mintKeypair.publicKey,
      space: mintLen,
      lamports,
      programId: TOKEN_2022_PROGRAM_ID,
    }),
    createInitializeTransferFeeConfigInstruction(
      mintKeypair.publicKey,
      payer.publicKey,
      payer.publicKey,
      feeBasisPoints,
      maxFee,
      TOKEN_2022_PROGRAM_ID,
    ),
    createInitializeMintInstruction(
      mintKeypair.publicKey,
      decimals,
      mintAuthority,
      null,
      TOKEN_2022_PROGRAM_ID,
    ),
  );

  await sendAndConfirmTransaction(connection, transaction, [payer, mintKeypair]);

  return mintKeypair.publicKey;
}

חשוב: הרחבות מאותחלות לפני InitializeMint. סדר זה מבלבל לעתים קרובות מפתחים הרגילים ל-EVM.

Transfer Hook: סקירה ושימוש

Transfer Hook הוא ההרחבה החזקה ביותר של Token Extensions. הוא קורא לתוכנית מותאמת אישית בכל העברת טוקן. תרחישים טיפוסיים: רשימת היתרים/חסימה של כתובות, צבירת תמלוגים, חסימת העברות בתקופת נעילה. התוכנית כתובה ב-Rust עם Anchor ונרשמת בהגדרת ה-Mint. ניתן להגדיר עמלה של עד 2% (200 נקודות בסיס).

// Фрагмент Transfer Hook программы (Anchor)
use anchor_lang::prelude::*;
use spl_transfer_hook_interface::instruction::ExecuteInstruction;

#[program]
pub mod transfer_hook {
    use super::*;

    pub fn transfer_hook(ctx: Context<TransferHook>, amount: u64) -> Result<()> {
        let sender = &ctx.accounts.source_token;
        let receiver = &ctx.accounts.destination_token;
        let config = &ctx.accounts.hook_config;

        require!(
            config.whitelist.contains(&receiver.owner),
            TransferError::ReceiverNotWhitelisted
        );

        emit!(TransferEvent {
            from: sender.owner,
            to: receiver.owner,
            amount,
            timestamp: Clock::get()?.unix_timestamp,
        });

        Ok(())
    }
}

Transfer Hook דורש שכל החשבונות הנוספים יועברו בעסקה. אנחנו הופכים זאת לאוטומטי עם import { createMint, createAssociatedTokenAccount, mintTo, TOKEN_2022_PROGRAM_ID, ExtensionType, getMintLen, createInitializeMintInstruction, createInitializeTransferFeeConfigInstruction, } from "@solana/spl-token"; import { Connection, Keypair, SystemProgram, Transaction } from "@solana/web3.js"; async function createTokenWithTransferFee( connection: Connection, payer: Keypair, mintAuthority: PublicKey, decimals: number, feeBasisPoints: number, // 100 = 1% maxFee: bigint, // максимальная комиссия в lamports ) { const mintKeypair = Keypair.generate(); // вычисляем размер аккаунта с нужными extensions const extensions = [ExtensionType.TransferFeeConfig]; const mintLen = getMintLen(extensions); const lamports = await connection.getMinimumBalanceForRentExemption(mintLen); const transaction = new Transaction().add( SystemProgram.createAccount({ fromPubkey: payer.publicKey, newAccountPubkey: mintKeypair.publicKey, space: mintLen, lamports, programId: TOKEN_2022_PROGRAM_ID, }), createInitializeTransferFeeConfigInstruction( mintKeypair.publicKey, payer.publicKey, payer.publicKey, feeBasisPoints, maxFee, TOKEN_2022_PROGRAM_ID, ), createInitializeMintInstruction( mintKeypair.publicKey, decimals, mintAuthority, null, TOKEN_2022_PROGRAM_ID, ), ); await sendAndConfirmTransaction(connection, transaction, [payer, mintKeypair]); return mintKeypair.publicKey; } , ומפשטים את אינטגרציית הלקוח. עוד על Transfer Hook: מאגר דוגמאות של Solana Transfer Hook.

אפשרויות מטא-דאטה: Metaplex לעומת Token Metadata Extension

מטא-דאטה (שם, סמל, אייקון) מאוחסן או דרך Metaplex (חשבון נפרד) או דרך הרחבת Token Extensions המובנית. עבור טוקנים פונגיביליים ב-DeFi, אנחנו ממליצים על Metaplex בשל התמיכה הרחבה שלו. עבור טוקנים דמויי NFT או soulbound, השתמש בהרחבת NonTransferable.

יתרונות של Token Extensions לפרויקט חדש

Token Extensions מספק עמלות מובנות, hooks והעברות פרטיות ללא תוכניות נוספות. העברנו 15+ פרויקטים מ-Token Program ל-Token Extensions—חיסכון ממוצע של 30% בגז הודות לאגרגציית הוראות. Transfer Hook מפחית את מורכבות יישום הלוגיקה המותאמת אישית פי 2 בהשוואה לכתיבת תוכנית נפרדת ללא ה-hook.

מה כלול בעבודה?

• יצירת חשבון Mint עם ההרחבות הנבחרות (TransferFee, TransferHook, Metadata וכו')
• כתיבה ובדיקה של תוכנית Transfer Hook מותאמת אישית (אם נדרש)
• אינטגרציה עם ארנקים (Phantom, Solflare, Backpack) ו-DEXים (Raydium, Orca)
• ביקורת קוד: ניתוח סטטי (Slither עבור Rust), fuzzing (Echidna), סקירת קוד
• תיעוד: מפרט טכני, מדריך פריסה, הפניה ל-API
• העברת הרשאות וגישות
• שבועיים של תמיכה לאחר השחרור

לוחות זמנים ועלות משוערים

העלות מחושבת באופן אישי. צור קשר—נעריך את הפרויקט שלך תוך יום אחד.

על הניסיון שלנו

אנחנו מפתחי Solana עם תיק של 30+ פרויקטים: טוקני DeFi, אוספי NFT, משחקי Web3. אנחנו מתמחים ב-Token Extensions, Transfer Hook ו-Anchor. אנו מספקים אחריות ל-3 חודשים על פונקציונליות החוזה החכם לאחר הפריסה. הזמינו פיתוח טוקן SPL—קבלו ייעוץ חינם.