Codama desde un IDL de Anchor

Codama transforma el IDL de Anchor en TypeScript compatible con @solana/kit 7.0.0: codecs de instrucciones, decodificadores de cuentas y enums de errores.

Receta

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";

Cuándo usar esto: Las dApps Greenfield se estandarizan en @solana/kit en lugar de web3.js v1.

Ejemplo de Trabajo

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 a constructores de mensajes de transacción (patrones de kit 7)

Lo que esto demuestra:

• Codama lee el JSON del IDL de Anchor
• Genera ayudantes de instrucciones nativos de kit
• Regenera cuando el IDL cambia
• Emparejar con pruebas de surfpool/litesvm

Análisis Profundo

Pipeline

1. anchor build produce el IDL.
2. Codama genera módulos TS.
3. La aplicación importa solo codecs generados (sin codificación manual).

CI

Falla la compilación si la carpeta generada difiere de una ejecución reciente de Codama.

Trampas Comunes

• Carpeta generada obsoleta - Discriminadores incorrectos. Solución: Paso de Codama en CI pre-compilación.
• Características del IDL que Codama no mapea - Se necesitan parches manuales. Solución: Seguir las notas de la versión de Codama.
• Mezclar kit y web3 en una tx - Fricción de tipos. Solución: Migrar el ensamblaje de transacciones a kit.
• Tipos RPC incorrectos con decodificadores generados - Fallos de decodificación. Solución: Usar RPC de kit en todo momento.
• No fijar la versión de Codama - Deriva en la generación de código. Solución: Bloquear la versión de CLI en package.json.

Alternativas

Preguntas Frecuentes

Relacionado

• Codama y gill de solana/kit - crates
• Construyendo Instrucciones - ix de kit
• Generando Clientes TS - Cliente de Anchor

Versiones de Stack: Esta página fue 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, y LiteSVM 0.6.x.