Triển Khai Chương Trình

SDK có thể triển khai một chương trình từ các tệp build cục bộ chỉ trong một lần gọi. Có hai cách: tự động phát hiện dành cho các workspace Anchor/Agave theo cấu trúc thư mục thông thường, và triển khai tường minh khi bạn muốn kiểm soát nguồn gốc của các byte.

Cả hai cách đều đăng ký chương trình tại địa chỉ đã khai báo trong IDL (hoặc tại khóa công khai của tệp keypair) và, nếu có IDL, đăng ký nó với runtime thông qua surfnet_registerIdl để các RPC client có thể giải mã dữ liệu tài khoản.

Tự Động Phát Hiện Workspace Anchor

deployProgram / deploy_program nhận tên chương trình và tìm kiếm các tệp sau theo đường dẫn tương đối từ thư mục làm việc hiện tại:

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

Triển Khai Tường Minh

Khi các tệp build nằm ở vị trí không theo chuẩn — một tệp artifact từ CI, một fixture test được chuẩn bị sẵn, hoặc một đoạn byte nhúng sẵn — hãy truyền cấu hình triển khai tường minh.

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

Triển Khai Từ Byte Thô

Khi bytecode đã có sẵn trong bộ nhớ — được tạo ra từ một bước build, tải xuống từ một kho artifact, hoặc nhúng qua include_bytes! — hãy bỏ qua hoàn toàn hệ thống tệp.

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

Tài Liệu Tham Khảo DeployProgram Builder (Rust)

Tài Liệu Tham Khảo Kiểu 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 và soBytes loại trừ lẫn nhau — chỉ cung cấp một trong hai.

Những Gì Được Đăng Ký

Sau khi triển khai thành công, runtime thực hiện ba việc:

1. Ghi program account tại programId với các byte .so thông qua surfnet_writeProgram.
2. Đánh dấu tài khoản là có thể thực thi để nó có thể được gọi thông qua các lệnh gọi RPC thông thường.
3. Đăng ký IDL (nếu được cung cấp) thông qua surfnet_registerIdl, cho phép các client RPC giải mã dữ liệu tài khoản bằng schema IDL của chương trình.

Lỗi