Развёртывание программ

SDK позволяет развернуть программу из локальных артефактов сборки за один вызов. Существует два варианта: автоматическое обнаружение для воркспейсов Anchor/Agave со стандартными путями и явное развёртывание, когда вы хотите контролировать источник байт.

Оба варианта регистрируют программу по адресу, указанному в IDL (или по открытому ключу файла keypair), и, если IDL доступен, регистрируют его в среде выполнения через surfnet_registerIdl, чтобы RPC-клиенты могли декодировать данные аккаунта.

Автоматическое обнаружение Anchor-воркспейса

deployProgram / deploy_program принимает имя программы и ищет следующие файлы относительно текущего рабочего каталога:

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

Явное развёртывание

Когда артефакты находятся в нестандартном месте — артефакт CI, заранее подготовленная тестовая точка, встроенный байтовый срез — передайте явную конфигурацию развёртывания.

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

Развёртывание из сырых байт

Когда байткод уже находится в памяти — сгенерирован на этапе сборки, загружен из хранилища артефактов или встроен через include_bytes! — полностью пропустите файловую систему.

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

Справочник по билдеру DeployProgram (Rust)

Справочник по типу 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 и soBytes являются взаимоисключающими — укажите ровно одно из двух.

Что регистрируется

После успешного деплоя среда выполнения делает три вещи:

1. Записывает program account по адресу programId с байтами .so через surfnet_writeProgram.
2. Помечает аккаунт как исполняемый, чтобы его можно было вызвать через обычные RPC-вызовы.
3. Регистрирует IDL (если указан) через surfnet_registerIdl, что позволяет RPC-клиентам декодировать данные аккаунта, используя IDL-схему программы.

Ошибки