Rust On-Chain

10 pages in this section.

How on-chain Rust differs from ordinary Rust: no_std and limited alloc, entrypoint style, Borsh, safe arithmetic, errors, and CU/size discipline - and how that maps to sBPF on Agave.

Explainer Rust For Solana Programs Rust No Std

Rust for Solana Basics

The on-chain Rust subset and constraints.

Rust Rust For Solana Programs Basics Solana

no_std & the Program Environment

What's available inside a program.

Rust No Std Solana Program Bpf

Borsh Serialization

The standard on-chain (de)serialization format.

Rust Borsh Serialization Accounts

Zero-Copy with bytemuck

Rust Bytemuck Zero Copy Pod

Safe Arithmetic

`checked_*`/`saturating_*` and overflow protection.

Rust Overflow Checked Math Security

Working with Pubkeys & Accounts

`Pubkey`, `AccountInfo`, and slices.

Rust Pubkey Account Info Validation

Program Size & CU Discipline

Rust Compute Units Optimization Binary Size

Error Handling On-Chain

`ProgramError`, custom errors, and `?`.

Rust Errors Program Error Thiserror

Rust for Solana Best Practices

Idiomatic, efficient on-chain Rust.

Rust Best Practices List On Chain

Rust On-Chain

Search Documentation

Rust On-Chain