Build Solana programs in Zig using the standard BPF target and sbpf-linker.
- ✅ Uses standard Zig BPF target (no custom forks)
- ✅ Zero external dependencies
- ✅ Zignocchio SDK - Full-featured Zig SDK for Solana
- ✅ LLVM bitcode generation via
-femit-llvm-bc - ✅ Direct syscall invocation via function pointers
- ✅ Auto-generated syscall bindings with MurmurHash3
- ✅ Automated build pipeline with
zig build - ✅ Jest-based integration tests with solana-test-validator
# Install sbpf-linker from master (includes latest fixes) cargo install --git https://github.com/blueshift-gg/sbpf-linker.git # Install Zig 0.15.2 or later # Install Node.js for testing
Note: SPL Token support requires sbpf-linker PR #14 to be merged (adds .rodata.cst32 section support for 32-byte constants).
zig build
This generates:
entrypoint.bc- LLVM bitcode from Zig sourcezig-out/lib/program_name.so- Final Solana program
npm install
npm testTests will:
- Build the program
- Start solana-test-validator
- Deploy the program
- Execute and verify "Hello world!" log output
All Solana syscalls are auto-generated from definitions using MurmurHash3-32:
zig run tools/gen_syscalls.zig -- src/syscalls.zig
This creates function pointers for all syscalls:
const syscalls = @import("syscalls.zig"); syscalls.log(&message); // Calls sol_log_ with hash 0x207559bd
The hash 0x207559bd is computed as murmur3_32("sol_log_", 0) and resolved by Solana VM at runtime via call -0x1.
To prevent sbpf-linker from stripping .rodata, we inline string data:
const message = [_]u8{'H','e','l','l','o',' ','w','o','r','l','d','!'};
sbpf-linker is an LTO compiler, not a traditional linker. It needs LLVM IR:
zig build-lib -target bpfel-freestanding -femit-llvm-bc=entrypoint.bc sbpf-linker --cpu v3 --export entrypoint -o program.so entrypoint.bc
This project includes Zignocchio, a zero-dependency SDK for building Solana programs in Zig, inspired by Pinocchio.
const sdk = @import("sdk/zignocchio.zig"); export fn entrypoint(input: [*]u8) u64 { return @call(.always_inline, sdk.createEntrypoint(processInstruction), .{input}); } fn processInstruction( program_id: *const sdk.Pubkey, accounts: []sdk.AccountInfo, instruction_data: []const u8, ) sdk.ProgramResult { sdk.logMsg("Hello from Zignocchio!"); const account = accounts[0]; var data = try account.tryBorrowMutData(); defer data.release(); data.value[0] = 42; return .{}; }
- Zero-copy input deserialization - Direct memory access to Solana's input buffer
- RAII borrow tracking - Safe mutable access with automatic cleanup
- Type-safe API - Strong typing for all Solana primitives
- PDAs - Program Derived Address functions
- CPI - Cross-program invocation support
- Efficient - Bit-packed borrow state, optimized syscalls
See sdk/README.md for complete documentation and examples/ for working programs.
.
├── build.zig # Automated build pipeline
├── build.zig.zon # Zero dependencies
├── sdk/ # Zignocchio SDK
│ ├── zignocchio.zig # Main SDK module
│ ├── types.zig # Core types (Pubkey, AccountInfo)
│ ├── entrypoint.zig # Input deserialization
│ ├── syscalls.zig # Auto-generated syscalls
│ ├── pda.zig # Program Derived Addresses
│ ├── cpi.zig # Cross-program invocation
│ ├── allocator.zig # BumpAllocator
│ ├── log.zig # Logging utilities
│ └── errors.zig # Error types
├── examples/ # Example programs
│ ├── hello.zig # Minimal example (default build target)
│ ├── counter.zig # Full-featured example
│ ├── hello.test.ts # Tests for hello program
│ ├── counter.test.ts # Tests for counter program
│ └── README.md # Examples documentation
└── tools/
├── murmur3.zig # MurmurHash3-32 implementation
├── syscall_defs.zig # Syscall definitions
└── gen_syscalls.zig # Syscall generator
MIT