elf-magic 0.5.1

Automatic compile-time ELF exports for Solana programs. One-liner integration, zero config, just works. ✨
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

mod builder;
mod codegen;
pub mod config;
mod error;
mod programs;
mod workspace;

use std::{env, path::PathBuf};

use crate::{
    config::Config,
    error::Error,
    programs::{deduplicate_programs, BuildResults, SolanaProgram},
};

#[deprecated(note = "use build() instead")]
pub fn generate() -> Result<BuildResults, Error> {
    build()
}

/// Generate Rust bindings for Solana programs
pub fn build() -> Result<BuildResults, Error> {
    let cargo_manifest_dir = env::var("CARGO_MANIFEST_DIR")
        .map(PathBuf::from)
        .map_err(|e| Error::WorkspaceDiscovery(format!("CARGO_MANIFEST_DIR not set: {}", e)))?;

    // Clean pipeline: load → discover → build → generate → save
    let config = Config::load(&cargo_manifest_dir)?;
    let workspaces = workspace::load_workspaces(&cargo_manifest_dir, &config)?;
    let discovered_programs = workspaces
        .iter()
        .map(|w| w.discover_programs())
        .collect::<Result<Vec<_>, _>>()?;

    // Extract and deduplicate included programs
    let included_programs: Vec<SolanaProgram> = discovered_programs
        .iter()
        .flat_map(|w| w.included.iter().cloned())
        .collect();
    let included_programs = deduplicate_programs(included_programs);

    // Build, generate, and save
    let build_result = builder::build_programs(&included_programs);
    let code = codegen::generate(&build_result)?;
    codegen::save(&cargo_manifest_dir, &code)?;

    builder::enable_incremental_builds(&cargo_manifest_dir, &included_programs)?;

    Ok(BuildResults::new(
        config.mode_name().to_string(),
        discovered_programs,
    ))
}