A Extensão Memo Transfer

Name: Token2022 com Web3.js
Availability: InStock

A extensão MemoTransfer é uma extensão de conta de Token que exige que todas as transferências recebidas em uma conta de token incluam um memo, facilitando o rastreamento aprimorado de transações e a identificação de usuários.

Inicializando a Conta de Token

Para inicializar a extensão MemoTransfer em uma conta de Token, vamos precisar da função enableRequiredMemoTransfers().

Veja como criar um token com a extensão Memo Transfer:

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

const tokenAccount = Keypair.generate();

// Calcula o tamanho necessário para uma conta de Token com a extensão Memo Transfer
const accountLen = getAccountLen([ExtensionType.MemoTransfer]);

// Calcula o mínimo de lamports necessários para isenção de aluguel
const lamports = await connection.getMinimumBalanceForRentExemption(accountLen);

// Cria a conta com o tamanho e owner corretos
const createAccountInstruction = SystemProgram.createAccount({
    fromPubkey: keypair.publicKey,
    newAccountPubkey: tokenAccount.publicKey,
    space: accountLen,
    lamports,
    programId: TOKEN_2022_PROGRAM_ID,
});

// Inicializa a extensão Memo Transfer
const enableMemoTransferInstruction = createEnableRequiredMemoTransfersInstruction(
    destinationTokenAccount.publicKey,
    destinationKeypair.publicKey,
    undefined,
    TOKEN_2022_PROGRAM_ID,
);

// Inicializa a conta de Token em si
const initializeAccountInstruction = createInitializeAccountInstruction(
    tokenAccount.publicKey,
    mint.publicKey,
    keypair.publicKey,
    TOKEN_2022_PROGRAM_ID,
);

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

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

console.log(`Contas de token criadas! Confira sua transação aqui: https://explorer.solana.com/tx/${signature}?cluster=devnet`);

Transferindo Token com um Memo

Para usar o programa Memo na Solana, temos duas opções viáveis.

Construindo nossa própria instrução memo "raw" assim:

const message = "Hello, Solana";

new TransactionInstruction({
    keys: [{ pubkey: keypair.publicKey, isSigner: true, isWritable: true }],
    data: Buffer.from(message, "utf-8"), // Mensagem do memo. Neste caso é "Hello, Solana"
    programId: new PublicKey("MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr"), // Programa Memo que valida as chaves e a mensagem do memo
}),

Ou podemos usar o SDK do programa Memo após instalar o pacote assim:

text

npm i @solana/spl-memo

No nosso exemplo, vamos usar a segunda opção e ficará assim:

const memoInstruction = createMemoInstruction(
    "Hello, world!",
    [keypair.publicKey],
);

const transferInstruction = createTransferCheckedInstruction(
    tokenAccount,
    mint.publicKey,
    destinationTokenAccount.publicKey,
    keypair.publicKey,
    BigInt(100e6),
    6,
    undefined,
    TOKEN_2022_PROGRAM_ID,
);

const transferTransaction = new Transaction().add(
    memoInstruction,
    transferInstruction,
);

const transferSignature = await sendAndConfirmTransaction(connection, transferTransaction, [keypair]);

console.log(`Tokens transferidos com memo! Confira sua transação aqui: https://explorer.solana.com/tx/${transferSignature}?cluster=devnet`);

Desabilitando e Habilitando o Memo

Se não quisermos exigir que a transferência venha com um memo, podemos fazer isso usando a função disableRequiredMemoTransfer e ficaria assim:

const disableRequiredMemoTransfersInstruction = createDisableRequiredMemoTransfersInstruction(
    destinationTokenAccount,
    destinationKeypair.publicKey,
    undefined,
    TOKEN_2022_PROGRAM_ID,
);

const transferInstruction = createTransferCheckedInstruction(
    tokenAccount,
    mint.publicKey,
    destinationTokenAccount,
    keypair.publicKey,
    BigInt(100e6),
    6,
    undefined,
    TOKEN_2022_PROGRAM_ID,
);

const transaction = new Transaction().add(
    disableRequiredMemoTransfersInstruction,
    transferInstruction,
);

const signature = await sendAndConfirmTransaction(connection, transaction, [keypair, destinationKeypair]);

console.log(`Tokens transferidos e estado da conta alterado! Confira sua transação aqui: https://explorer.solana.com/tx/${signature}?cluster=devnet`);

E se quisermos habilitá-la novamente, podemos simplesmente usar a função enableRequiredMemoTransfers() assim:

const enableRequiredMemoTransfersInstruction = createEnableRequiredMemoTransfersInstruction(
    destinationTokenAccount,
    destinationKeypair.publicKey,
    undefined,
    TOKEN_2022_PROGRAM_ID,
);

const transferInstruction = createTransferCheckedInstruction(
    tokenAccount,
    mint.publicKey,
    destinationTokenAccount,
    keypair.publicKey,
    BigInt(100e6),
    6,
    undefined,
    TOKEN_2022_PROGRAM_ID,
);

const transaction = new Transaction().add(
    enableRequiredMemoTransfersInstruction,
    transferInstruction,
);

const signature = await sendAndConfirmTransaction(connection, transaction, [keypair, destinationKeypair]);

console.log(`Tokens transferidos e estado da conta alterado! Confira sua transação aqui: https://explorer.solana.com/tx/${signature}?cluster=devnet`);