solana-program-rosetta

Multiple implementations of Solana programs across languages: Rust, Zig, C, and even assembly.

More programs will be added over time!

Getting started

Prerequisite for all languages

• Install Rust: https://www.rust-lang.org/tools/install

Rust

• Install Solana tools

./install-solana.sh

• Go to a program directory

cd helloworld

• Build a program

cargo build-sbf

• Test a program

cargo test-sbf

Zig

• Get the compiler

./install-solana-zig.sh

• Go to the Zig implementation of a program

cd helloworld/zig

• Build the program

../../solana-zig/zig build

• Test it

cd ..
SBF_OUT_DIR="./zig/zig-out/lib" cargo test

• OR use the helper from the root of this repo to build and test

./test-zig.sh helloworld

C

• Install Solana C compiler

./install-solana-c.sh

• Install Solana tools

./install-solana.sh

• Go to a program directory

cd helloworld/c

• Build a program

make

• Test it

cd ..
SBF_OUT_DIR="./c/out" cargo test

• OR use the helper from the root of this repo to build and test

./test-c.sh helloworld

Assembly

• Install Solana LLVM tools

./install-solana-llvm.sh

• Go to a program directory

cd helloworld/asm

• Build a program

make

• Test it

cd ..
SBF_OUT_DIR="./asm/out" cargo test

• OR use the helper from the root of this repo to build and test

./test-asm.sh helloworld

Current Programs

Helloworld

Logs a static string using the sol_log_ syscall.

Language	CU Usage
Rust	105
Zig	105
C	105
Assembly	104

Since this is just doing a syscall, all the languages behave the same. The only difference is that the Assembly version doesn't set the return code to 0, and lets the VM assume it worked.

Transfer-Lamports

Moves lamports from a source account to a destination, with the amount given by a little-endian u64 in instruction data.

Language	CU Usage
Rust	459
Zig	38
C	104
Assembly	30
Rust (pinocchio)	32

This one starts to get interesting since it requires parsing the instruction input. Since the assembly version knows exactly where to find everything, it can be hyper-optimized. The pinocchio version performs very closely to the assembly implementation!

CPI

Allocates a PDA given by the seed "You pass butter" and a bump seed in the instruction data. This requires a call to create_program_address to check the address and invoke_signed to CPI to the system program.

Language	CU Usage	CU Usage (minus syscalls)
Rust	3698	1198
Zig	2825	325
C	3122	622
Rust (pinocchio)	2816	316

Note: create_program_address consumes 1500 CUs, and invoke consumes 1000, so we can subtract 2500 CUs from each program to see the actual cost of the program logic.

Pubkey

A program to compare two Pubkey instances. This operation is very common in on-chain programs, but it can be expensive.

Language	CU Usage
Rust	14
Zig	15

Token

A reduced instruction set from SPL-Token. Includes an entrypoint, instruction deserialization, and account serde. The Rust version is the full SPL Token program.

• Initialize Mint

Language	CU Usage
Rust	1115
Zig	158

• Initialize Account

Language	CU Usage
Rust	2071
Zig	176

• Mint To

Language	CU Usage
Rust	2189
Zig	179

• Transfer

Language	CU Usage
Rust	2208
Zig	148

• Burn

Language	CU Usage
Rust	2045
Zig	145

• Close Account

Language	CU Usage
Rust	1483
Zig	130