Pruebas TS de Anchor

anchor test es la ruta de integración predeterminada para los proyectos de Anchor 0.32.1: compila programas, implementa en un validador local y ejecuta pruebas de TypeScript contra el IDL. Úsalo para flujos de extremo a extremo con semántica RPC real.

Receta

Tarjeta de receta de referencia rápida, lista para copiar y pegar.

anchor test
# o con un validador existente:
anchor test --skip-local-validator

import * as anchor from "@coral-xyz/anchor";
const provider = anchor.AnchorProvider.env();
anchor.setProvider(provider);
const program = anchor.workspace.MyProgram as Program<MyProgram>;

Cuándo usar esto:

• Pruebas de integración completas con CPIs de SPL Token.
• Pruebas de resolución de cuentas de Anchor y tipos de IDL.
• Validación de CI antes de la implementación en devnet/mainnet.
• Pruebas de contrato del SDK del cliente junto con el programa.

Ejemplo de trabajo

import * as anchor from "@coral-xyz/anchor";
import { Program } from "@coral-xyz/anchor";
import { MyProgram } from "../target/types/my_program";
import { Keypair, PublicKey, SystemProgram } from "@solana/web3.js";
import { TOKEN_PROGRAM_ID, createMint, getOrCreateAssociatedTokenAccount } from "@solana/spl-token";
import { assert } from "chai";
 
describe("my_program", () => {
  const provider = anchor.AnchorProvider.env();
  anchor.setProvider(provider);
  const program = anchor.workspace.MyProgram as Program<MyProgram>;
  const payer = (provider.wallet as anchor.Wallet).payer;
 
  it("inicializa la bóveda", async () => {
    const user = Keypair.generate();
    await provider.connection.confirmTransaction(
      await provider.connection.requestAirdrop(user.publicKey, 2e9)
    );
 
    const mint = await createMint(provider.connection, payer, payer.publicKey, null, 6);
    const ata = await getOrCreateAssociatedTokenAccount(
      provider.connection, payer, mint, user.publicKey
    );
 
    const [vaultPda] = PublicKey.findProgramAddressSync(
      [Buffer.from("vault"), user.publicKey.toBuffer()],
      program.programId
    );
 
    await program.methods
      .initVault()
      .accounts({
        user: user.publicKey,
        vault: vaultPda,
        mint: mint,
        userToken: ata.address,
        tokenProgram: TOKEN_PROGRAM_ID,
        systemProgram: SystemProgram.programId,
      })
      .signers([user])
      .rpc();
 
    const vault = await program.account.vault.fetch(vaultPda);
    assert.ok(vault.authority.equals(user.publicKey));
  });
});

Lo que esto demuestra:

• El proveedor lee el clúster de Anchor.toml.
• Las utilidades de SPL crean la menta y la ATA en el validador local.
• .rpc() envía la transacción firmada y espera la confirmación.

Inmersión Profunda

Cómo funciona

• anchor test ejecuta anchor build, inicia el validador (a menos que se omita), implementa programas y ejecuta tests/**/*.ts.
• Mocha es el ejecutor predeterminado; las aserciones de chai son comunes.
• El IDL se genera en target/idl y los tipos en target/types.
• La billetera en Anchor.toml paga las tarifas de implementación y prueba.

Configuración de prueba de Anchor.toml

Notas de TypeScript

// Coincide con los códigos de error de Rust #[error_code]
import { AnchorError } from "@coral-xyz/anchor";
try {
  await program.methods.badIx().rpc();
} catch (e) {
  const err = e as AnchorError;
  console.log(err.error.errorCode.code);
}

Trampas

• Desajuste de clúster - Anchor.toml en devnet pero validador en localnet. Solución: Alinea la URL del proveedor con el clúster en ejecución.
• Fallos de Airdrop - Límites del grifo local. Solución: Financia al pagador en la génesis del validador o un solo airdrop por prueba.
• IDL no regenerado - Errores de nombre de cuenta después de renombrar Rust. Solución: anchor build antes de la prueba.
• Puerto 8899 ocupado - Validador huérfano. Solución: pkill solana-test-validator en el paso previo de CI.
• CI lenta - Implementación completa en cada ejecución. Solución: Agrega la capa LiteSVM/Bankrun; reserva anchor test para el trabajo de integración.
• Falta --skip-local-validator - Doble inicio de validador falla. Solución: Documenta el ciclo de vida del validador de CI.

Alternativas

Preguntas Frecuentes

Relacionado

• Bankrun (TS) - VM de TS más rápida
• Pruebas contra un Validador - operaciones del validador
• Pruebas de CPIs y PDAs - configuración de cuentas
• Conceptos básicos de pruebas - pirámide

Versiones de Stack: 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.