Programas y Anchor

​

Modelo de despliegue de programas

1. Cuenta de programa: pequeña cuenta de metadatos en el ID del programa. Propietario: BPF Upgradable Loader.
2. Cuenta ProgramData: contiene el bytecode real. Derivada como [program_id, "programdata"].
3. Cuenta Buffer (transitoria): contiene el nuevo bytecode durante una actualización. Se descarta después de la actualización.

​

Verificar un programa desplegado

# Descargar el programa desde mainnet
solana program dump CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C cpmm-onchain.so

# Compilar desde fuente conocida
cargo build-bpf --manifest-path raydium-cp-swap/programs/cp-amm/Cargo.toml
cp target/deploy/raydium_cp_swap.so cpmm-source.so

# Comparar
sha256sum cpmm-onchain.so cpmm-source.so

​

Anchor: un framework sobre Solana

pub fn process_instruction(
    program_id: &Pubkey,
    accounts: &[AccountInfo],
    instruction_data: &[u8],
) -> ProgramResult {
    // Analizar manualmente instruction_data
    // Validar manualmente cuentas
    // Deserializar manualmente datos de cuenta
    // Verificar manualmente banderas de firmante/escribible
    // ... luego hacer el trabajo real
}

#[program]
pub mod cpmm {
    use super::*;

    pub fn swap_base_input(
        ctx: Context<Swap>,
        amount_in: u64,
        min_out: u64,
    ) -> Result<()> {
        // Solo la lógica de negocio — ctx está prevalidado
    }
}

#[derive(Accounts)]
pub struct Swap<'info> {
    pub payer: Signer<'info>,
    #[account(mut, seeds = [b"pool", config.key().as_ref(), ...], bump)]
    pub pool_state: AccountLoader<'info, PoolState>,
    #[account(mut)]
    pub input_vault: Box<Account<'info, TokenAccount>>,
    // ... más cuentas
}

• Genera automáticamente un discriminador determinista de 8 bytes para cada instrucción y cada tipo de cuenta.
• Valida restricciones de cuenta (propietario, seeds, escribible, firmante, coincidencia de mint, coincidencia de programa de token) antes de que se ejecute tu código.
• Genera un IDL — un archivo de descripción de interfaz que los clientes usan para llamar al programa.
• Se envía con una biblioteca de cliente de Rust, TypeScript y Python.

​

El discriminador de 8 bytes

Discriminador de cuenta:     sha256("account:PoolState")[0..8]
Discriminador de instrucción: sha256("global:swap_base_input")[0..8]

​

Errores

#[error_code]
pub enum ErrorCode {
    #[msg("Slippage tolerance exceeded")]
    SlippageExceeded,
    #[msg("Pool is disabled")]
    PoolDisabled,
    // ...
}

​

El IDL

anchor idl fetch CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C -o cpmm.idl.json

​

Estructura del IDL

{
  "version":      "0.1.0",
  "name":         "raydium_cp_swap",
  "instructions": [ { "name": "swap_base_input", "accounts": [ ... ], "args": [ ... ] }, ... ],
  "accounts":     [ { "name": "PoolState", "type": { ... } }, ... ],
  "types":        [ { "name": "AmmConfig", "type": { ... } }, ... ],
  "errors":       [ { "code": 6000, "name": "SlippageExceeded", "msg": "..." }, ... ],
  "events":       [ { "name": "SwapEvent", "fields": [ ... ] }, ... ]
}

​

Generar un cliente desde el IDL

anchor idl build -o target/idl/cpmm.json
# Tipos de TypeScript generados automáticamente por el ts-client de Anchor
# El SDK de Raydium ya incluye estos

​

Cuándo el IDL es tu aliado

1. Obtén el IDL (en vivo desde la cadena o desde la fuente del SDK).
2. Busca la instrucción que deseas (p. ej., swap_base_input).
3. Construye los datos de instrucción: discriminador de 8 bytes + argumentos codificados.
4. Pasa cuentas en el orden que especifica el IDL.

​

Programas anteriores a Anchor: AMM v4 y Farm v3/v5

• Envío manual de instrucciones: una etiqueta u8 en instruction_data con una declaración match.
• Validación manual de cuentas: if accounts[0].owner != &expected_program { ... }.
• Argumentos de instrucción serializados con Borsh: sin discriminador, solo instruction_data[1..].
• Diseño mediante #[repr(C, packed)]: diseño binario de estructura C.

import { liquidityStateV4Layout, swapInstructionData }
  from "@raydium-io/raydium-sdk-v2";

const data = swapInstructionData.encode({
  instruction: 9,   // swap
  amountIn:    1_000_000n,
  minAmountOut: 950_000n,
});

​

Mecánica de actualización de programas

1. Compilar el nuevo bytecode.
2. Escribirlo en una cuenta buffer (solana program write-buffer).
3. Enviar una instrucción de actualización: BpfLoaderUpgradeable::Upgrade { buffer, program, authority }.
4. El tiempo de ejecución reemplaza atómicamente el bytecode del programa con el contenido del buffer.

​

Hacer un programa inmutable

​

Programas y renta

• Un programa de 50 KB: ~0.35 SOL en renta.
• Un programa de 200 KB: ~1.4 SOL en renta.

​

Depuración de programas de Anchor

​

Salida de registro

const sim = await connection.simulateTransaction(tx);
console.log(sim.value.logs);

• Invocación de programa (Program CPMMoo8... invoke [1]).
• Llamadas msg! desde el código del programa.
• Consumo de unidades de cómputo (consumed 137842 of 400000 compute units).
• Éxito o error del programa.

​

Códigos de error

Program CPMMoo8... failed: custom program error: 0x1770

​

Desajustes de diseño de cuenta

AnchorError: AccountNotInitialized. Error Number: 3012

​

Referencias

• solana-fundamentals/account-model — cómo los programas poseen cuentas.
• solana-fundamentals/pdas-and-cpis — PDAs como los declara Anchor.
• sdk-api/anchor-idl — obtener y usar los IDLs de Raydium.
• reference/program-addresses — IDs de programa.
• reference/error-codes — referencia de códigos de error.
• security/admin-and-multisig — controles de autoridad de actualización.

• Documentación de Anchor.
• Despliegue de programas de Solana.
• IDLs de Raydium (publicados en SDK src/raydium/*/idl/*.json).