Codama a partir de uma IDL do Anchor

Codama transforma a IDL do Anchor em TypeScript compatível com @solana/kit 7.0.0: codecs de instrução, decodificadores de conta e enums de erro.

Receita

anchor build
npx @codama/cli@latest run --idl target/idl/my_program.json --out clients/ts/src/generated

import { createSolanaRpc, pipe } from "@solana/kit";
import { getIncrementInstruction } from "./generated/instructions";

Quando usar isso: Novas dApps padronizam com @solana/kit em vez de web3.js v1.

Exemplo de Trabalho

import { address, createSolanaRpc, pipe, setTransactionMessageLifetime } from "@solana/kit";
import { getIncrementInstruction } from "./generated/instructions";
 
const rpc = createSolanaRpc("https://api.devnet.solana.com");
const programId = address("Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS");
 
const ix = getIncrementInstruction({
  counter: counterPda,
  authority: signerAddress,
});
 
// Pipe para construtores de mensagens de transação (padrões do kit 7)

O que isso demonstra:

• Codama lê o JSON da IDL do Anchor
• Gera helpers de instrução nativos do kit
• Regenera quando a IDL muda
• Emparelha com testes surfpool/litesvm

Análise Profunda

Pipeline

1. anchor build produz a IDL.
2. Codama gera módulos TS.
3. O aplicativo importa apenas codecs gerados (sem codificação manual).

CI

Falha na compilação se a pasta gerada diferir de uma execução recente do Codama.

Armadilhas

• Pasta gerada desatualizada - Discriminadores errados. Correção: Etapa do Codama no pré-build da CI.
• Recursos da IDL que o Codama não mapeia - Correções manuais necessárias. Correção: Acompanhe as notas de lançamento do Codama.
• Misturar kit e web3 em uma tx - Fricção de tipo. Correção: Migre a montagem da transação para o kit.
• Tipos de RPC incorretos com decodificadores gerados - Falhas na decodificação. Correção: Use o RPC do kit em todo o lado.
• Não fixar a versão do Codama - Derivação do codegen. Correção: Trave a versão da CLI em package.json.

Alternativas

FAQs

Relacionado

• solana/kit Codama e gill - crates
• Construindo Instruções - kit ix
• Gerando Clientes TS - Cliente Anchor

Versões da Pilha: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0 e LiteSVM 0.6.x.