A Extensão Default Account State

Name: Token2022 com Web3.js
Availability: InStock

A extensão DefaultAccountState é uma extensão de Mint que permite que todas as contas Token recém-criadas para aquela mint específica sejam congeladas por padrão. A Freeze Authority da mint pode então descongelar (thaw) essas contas Token para que se tornem utilizáveis.

Inicializando a Conta Mint

Para inicializar a extensão DefaultAccountState em uma conta Mint vamos precisar da função initializeDefaultAccountState().

Aqui está como criar uma mint com a extensão Default Account State:

import { Keypair, SystemProgram, Transaction, sendAndConfirmTransaction } from "@solana/web3.js";
import {
  createInitializeMintInstruction,
  createInitializeDefaultAccountStateInstruction,
  getMintLen,
  ExtensionType,
  TOKEN_2022_PROGRAM_ID,
} from "@solana/spl-token";

const mint = Keypair.generate();

// Calcular o tamanho necessário para uma conta Mint com extensão Default Account State
const mintLen = getMintLen([ExtensionType.DefaultAccountState]);

// Calcular lamports mínimos necessários para isenção de aluguel
const lamports = await connection.getMinimumBalanceForRentExemption(mintLen);

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

// Inicializar a extensão Default Account State
const initializeDefaultAccountState = createInitializeDefaultAccountStateInstruction(
  mint.publicKey,
  AccountState.Frozen,
  TOKEN_2022_PROGRAM_ID,
);

// Inicializar a própria mint
const initializeMintInstruction = createInitializeMintInstruction(
  mint.publicKey,
  6,
  keypair.publicKey,
  keypair.publicKey, // autoridade de freeze é OBRIGATÓRIA
  TOKEN_2022_PROGRAM_ID,
);

// Combinar todas as instruções na ordem correta
const transaction = new Transaction().add(
  createAccountInstruction,
  initializeDefaultAccountState,
  initializeMintInstruction,
);

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

console.log(
  `Mint criada! Veja sua TX aqui: https://explorer.solana.com/tx/${signature}?cluster=devnet`,
);

Expand

[39 more lines]

Lembre-se de que a Freeze Authority na Mint é obrigatória para esta extensão ou não poderemos descongelar nenhuma conta Token na criação.

Descongelando a Conta Token

Ter a extensão DefaultAccountState significa que todas as contas Token que são inicializadas vão estar congeladas por padrão.

Isso significa que não é possível fazer Mint, Transfer ou praticamente qualquer coisa com essas contas Token se não as descongelarmos (thaw).

Podemos facilmente descongelar uma conta Token usando a instrução thawAccount assim:

const ata = await getAssociatedTokenAddress(
  mint.publicKey,
  keypair.publicKey,
  false,
  TOKEN_2022_PROGRAM_ID,
);

const createAtaInstruction = createAssociatedTokenAccountIdempotentInstruction(
  keypair.publicKey, // pagador
  ata, // endereço da conta associated token
  keypair.publicKey, // dono
  mint.publicKey, // mint
  TOKEN_2022_PROGRAM_ID,
);

const thawAtaInstruction = createThawAccountInstruction(
  ata,
  mint.publicKey,
  keypair.publicKey,
  undefined,
  TOKEN_2022_PROGRAM_ID,
);

const transaction = new Transaction().add(createAtaInstruction, thawAtaInstruction);

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

console.log(
  `Contas de token criadas e descongeladas! Veja sua TX aqui: https://explorer.solana.com/tx/${signature}?cluster=devnet`,
);

Expand

[17 more lines]

Alterando o Estado Padrão da Conta

Uma vez que não precisamos ter maior controle sobre a distribuição de tokens e queremos deixar todos negociarem nosso token livremente, podemos mudar o estado padrão da conta usando a instrução updateDefaultAccountState assim:

const updateDefaultAccountStateInstruction = createUpdateDefaultAccountStateInstruction(
  mint.publicKey,
  AccountState.Initialized,
  keypair.publicKey,
  undefined,
  TOKEN_2022_PROGRAM_ID,
);

const transaction = new Transaction().add(updateDefaultAccountStateInstruction);

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

console.log(
  `Estado padrão da conta alterado! Veja sua TX aqui: https://explorer.solana.com/tx/${signature}?cluster=devnet`,
);