Instrucciones de compilación

Construye instrucciones tipadas a partir de clientes Codama generados.

Receta

import { getIncrementInstruction } from "./generated/clients/js";
import { appendTransactionMessageInstruction } from "@solana/kit";

Cuándo usar esto:

• Componer llamadas a programas en flujos de billetera.
• Transacciones parciales creadas en el servidor.
• Rutas DeFi de múltiples instrucciones.

Ejemplo práctico

import {
  createTransactionMessage,
  pipe,
  setTransactionMessageFeePayerSigner,
  setTransactionMessageLifetimeUsingBlockhash,
  appendTransactionMessageInstruction,
  createSolanaRpc,
} from "@solana/kit";
import { getIncrementInstruction } from "./generated/clients/js";
 
const rpc = createSolanaRpc(process.env.RPC_URL!);
const { value: bh } = await rpc.getLatestBlockhash().send();
 
const ix = getIncrementInstruction({
  counter: counterAddress,
  authority: walletSigner,
});
 
const message = pipe(
  createTransactionMessage({ version: 0 }),
  (m) => setTransactionMessageFeePayerSigner(walletSigner, m),
  (m) => setTransactionMessageLifetimeUsingBlockhash(bh, m),
  (m) => appendTransactionMessageInstruction(ix, m)
);

Lo que esto demuestra:

• El generador generado codifica el discriminador + argumentos Borsh.
• Los objetos Signer satisfacen los requisitos de metadatos de autoridad.
• Combina múltiples ix de programa en un solo mensaje.

Análisis profundo

Cómo funciona

• Datos de instrucción = discriminador de 8 bytes + argumentos serializados.
• Las Account metas incluyen indicadores signer/writable por IDL.
• Las cuentas restantes para CPI se muestran también en la IDL.
• Simula para detectar fallos de restricciones de forma temprana.

Errores comunes

• Orden incorrecto de cuentas - error del programa 0x... Solución: nunca reordenes manualmente las metas.
• Cadenas Pubkey en lugar de Signer - falta firma. Solución: pasa el tipo Signer para las firmas.
• Cuentas de inicialización faltantes - necesita system + rent. Solución: incluye instrucciones de inicialización de los ayudantes de la IDL.
• Incompatibilidad de tipos de argumento - BN vs bigint. Solución: usa los tipos TS generados literalmente.
• Profundidad CU de CPI - OOM de simulación. Solución: aumenta el límite de unidades de cómputo.

Alternativas

Preguntas frecuentes

Relacionado

• Construcción de mensajes de transacción - componer tx
• Firma del lado del cliente - enviar desde billetera
• Codama - generar generadores

Versiones de la pila: Esta página se escribió 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.