Déploiement de programmes

Le SDK peut déployer un programme à partir d'artefacts de build locaux en un seul appel. Il existe deux approches : la détection automatique pour les espaces de travail Anchor/Agave suivant des chemins conventionnels, et le déploiement explicite lorsque vous souhaitez contrôler l'origine des octets.

Ces deux approches enregistrent le programme à l'adresse déclarée dans l'IDL (ou à la clé publique du fichier keypair) et, si un IDL est disponible, l'enregistrent auprès du runtime via surfnet_registerIdl afin que les clients RPC puissent décoder les données de compte.

Détection automatique d'un espace de travail Anchor

deployProgram / deploy_program prend le nom du programme et recherche ces fichiers relativement au répertoire de travail courant :

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

Déploiement explicite

Lorsque les artefacts se trouvent à un emplacement non standard — un artefact de CI compilé, un fixture de test préconstruit, un tableau d'octets embarqué — passez une configuration de déploiement explicite.

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

Déploiement à partir d'octets bruts

Lorsque le bytecode est déjà en mémoire — généré par une étape de build, téléchargé depuis un dépôt d'artefacts, ou embarqué via include_bytes! — ignorez entièrement le système de fichiers.

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

Référence du constructeur DeployProgram (Rust)

Référence du type 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 et soBytes sont mutuellement exclusifs — fournissez exactement l'un des deux.

Ce qui est enregistré

Après un déploiement réussi, le runtime effectue trois opérations :

1. Écrit le program account à programId avec les octets .so via surfnet_writeProgram.
2. Marque le compte comme exécutable afin qu'il puisse être invoqué via des appels RPC normaux.
3. Enregistre l'IDL (si fourni) via surfnet_registerIdl, ce qui permet aux clients RPC de décoder les données de compte à l'aide du schéma IDL du programme.

Erreurs