Implantando Programas

O SDK pode implantar um programa a partir de artefatos de build locais em uma única chamada. Existem duas abordagens: descoberta automática para workspaces Anchor/Agave com caminhos convencionais, e implantação explícita quando você deseja controlar a origem dos bytes.

Ambas as abordagens registram o programa no endereço declarado pelo IDL (ou na chave pública do arquivo keypair) e, se um IDL estiver disponível, o registram no runtime via surfnet_registerIdl para que clientes RPC possam decodificar dados de conta.

Descoberta Automática de um Workspace Anchor

deployProgram / deploy_program recebe o nome do programa e procura estes arquivos relativos ao diretório de trabalho atual:

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

Implantação Explícita

Quando os artefatos estão em um local não convencional — um artefato de CI compilado, um fixture de teste pré-configurado, um slice de bytes embutido — forneça uma configuração explícita de implantação.

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"),
)?;

Implantar a Partir de Bytes Brutos

Quando o bytecode já está em memória — gerado por uma etapa de build, baixado de um repositório de artefatos, ou embutido via include_bytes! — ignore completamente o sistema de arquivos.

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()),
)?;

Referência do Builder DeployProgram (Rust)

Referência do Tipo 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 são mutuamente exclusivos — forneça exatamente um.

O Que É Registrado

Após um deploy bem-sucedido, o runtime executa três ações:

1. Grava o program account em programId com os bytes .so via surfnet_writeProgram.
2. Marca a conta como executável para que possa ser invocada por meio de chamadas RPC normais.
3. Registra o IDL (se fornecido) via surfnet_registerIdl, o que permite que clientes RPC decodifiquem dados de conta usando o esquema IDL do programa.

Erros