Die Cpi Guard-Erweiterung

Die CpiGuardErweiterung ist eine TokenKontoerweiterung, die bestimmte Aktionen innerhalb von programmübergreifenden Aufrufen (Cross-Program Invocations) verbietet und Benutzer vor bösartigen Programmen schützt, die versuchen könnten, ihre Token-Konten ohne ausdrückliche Zustimmung zu manipulieren.

Initialisierung des Token-Kontos

Um die CpiGuardErweiterung auf einem TokenKonto zu initialisieren, benötigen wir die enableCpiGuard()Funktion.

Hier ist, wie man einen Token mit der Cpi Guard-Erweiterung erstellt:

ts
import {
    Keypair,
    SystemProgram,
    Transaction,
    sendAndConfirmTransaction,
} from '@solana/web3.js';
import {
    createInitializeAccountInstruction,
    createEnableCpiGuardInstruction,
    getAccountLen,
    ExtensionType,
    TOKEN_2022_PROGRAM_ID,
} from '@solana/spl-token';

const tokenAccount = Keypair.generate();

// Calculate the size needed for a Token account with Cpi Guard extension
const accountLen = getAccountLen([ExtensionType.CpiGuard]);

// Calculate minimum lamports required for rent exemption
const lamports = await connection.getMinimumBalanceForRentExemption(accountLen);

// Create the account with the correct size and owner
const createAccountInstruction = SystemProgram.createAccount({
    fromPubkey: keypair.publicKey,
    newAccountPubkey: tokenAccount.publicKey,
    space: accountLen,
    lamports,
    programId: TOKEN_2022_PROGRAM_ID,
});

// Initialize the Cpi Guard extension
const enableCpiGuardInstruction = createEnableCpiGuardInstruction(
    tokenAccount.publicKey,
    keypair.publicKey,
    undefined,
    TOKEN_2022_PROGRAM_ID,
);

// Initialize the Token account itself
const initializeAccountInstruction = createInitializeAccountInstruction(
    tokenAccount.publicKey,
    mint.publicKey,
    keypair.publicKey,
    TOKEN_2022_PROGRAM_ID,
);

const transaction = new Transaction().add(
    createAccountInstruction,
    initializeAccountInstruction,
    enableCpiGuardInstruction
);

const signature = await sendAndConfirmTransaction(connection, transaction, [keypair, tokenAccount], {skipPreflight: false});

console.log(`Token accounts created! Check out your TX here: https://explorer.solana.com/tx/${signature}?cluster=devnet`);

Deaktivieren des CPI Guards

Wenn wir einige der durch den Cpi Guard blockierten Verhaltensweisen aktivieren möchten, können wir den Guard einfach mit der disableCpiGuardAnweisung deaktivieren, wie folgt:

ts
const disableCpiGuardInstruction = createDisableCpiGuardInstruction(
    tokenAccount,
    keypair.publicKey,
    undefined,
    TOKEN_2022_PROGRAM_ID,
);

Und wenn wir fertig sind und die Sicherheitsebene wieder hinzufügen möchten, können wir sie mit der enableCpiGuardAnweisung wie folgt wieder aktivieren:

ts
const enableCpiGuardInstruction = createEnableCpiGuardInstruction(
    tokenAccount,
    keypair.publicKey,
    undefined,
    TOKEN_2022_PROGRAM_ID,
);

Token2022 mit Web3.js

Die Cpi Guard-Erweiterung

Initialisierung des Token-Kontos

Deaktivieren des CPI Guards