Desplegando Programas

El SDK puede desplegar un programa desde artefactos de compilación locales en una sola llamada. Existen dos modalidades: detección automática para workspaces de Anchor/Agave con rutas convencionales, y despliegue explícito cuando se desea controlar el origen de los bytes.

Ambas modalidades registran el programa en la dirección declarada por el IDL (o en la clave pública del archivo keypair) y, si hay un IDL disponible, lo registran en el runtime mediante surfnet_registerIdl para que los clientes RPC puedan decodificar los datos de las cuentas.

Detección Automática de un Workspace de Anchor

deployProgram / deploy_program recibe el nombre del programa y busca estos archivos relativos al directorio de trabajo actual:

use surfpool_sdk::Surfnet;

let surfnet = Surfnet::start().await?;
let cheats = surfnet.cheatcodes();

let program_id = cheats.deploy_program("my_program")?;
println!("deployed at {program_id}");

Despliegue Explícito

Cuando los artefactos se encuentran en una ubicación no estándar — un artefacto de CI compilado, un fixture de prueba predefinido, un fragmento de bytes embebido — proporciona una configuración de despliegue explícita.

use surfpool_sdk::cheatcodes::builders::DeployProgram;
use surfpool_sdk::Surfnet;

let cheats = Surfnet::start().await?.cheatcodes();

// Derive the program ID from a keypair file.
let program_id = cheats.deploy(
    DeployProgram::from_keypair_path("fixtures/my_program-keypair.json")?
        .so_path("fixtures/my_program.so")
        .idl_path("fixtures/my_program.idl.json"),
)?;

Despliegue desde Bytes sin Procesar

Cuando el bytecode ya está en memoria — generado por un paso de compilación, descargado desde un almacén de artefactos, o embebido mediante include_bytes! — omite el sistema de archivos por completo.

use surfpool_sdk::cheatcodes::builders::DeployProgram;
use surfpool_sdk::{Pubkey, Surfnet};

const PROGRAM_BYTES: &[u8] = include_bytes!("../fixtures/my_program.so");

let cheats = Surfnet::start().await?.cheatcodes();
let program_id: Pubkey = "DemoProgram111111111111111111111111111111111".parse()?;

cheats.deploy(
    DeployProgram::new(program_id).so_bytes(PROGRAM_BYTES.to_vec()),
)?;

Referencia del Constructor DeployProgram (Rust)

Referencia de Tipos DeployOptions (JS)

type ByteArrayLike = Uint8Array | number[];

interface DeployOptions {
  programId: string; // base58 address to deploy at
  soPath?: string; // path to .so on disk
  soBytes?: ByteArrayLike; // or raw bytes in memory
  idlPath?: string; // optional Anchor IDL JSON
}

soPath e soBytes son mutuamente exclusivos — proporcione exactamente uno.

Qué Se Registra

Tras un despliegue exitoso, el entorno de ejecución realiza tres acciones:

1. Escribe el program account en programId con los bytes de .so mediante surfnet_writeProgram.
2. Marca la cuenta como ejecutable para que pueda invocarse mediante llamadas RPC normales.
3. Registra el IDL (si se proporciona) mediante surfnet_registerIdl, lo que permite a los clientes RPC decodificar datos de cuenta usando el esquema IDL del programa.

Errores