Local Development

Quick Access

Explore program and test scripts for both Anchor and Native Rust:

GitHub

Anchor Implementation

GitHub

Native Rust Implementation

Local Environment

⚠️ When using a local ER validator, you need to connect it to your preferred base layer (e.g., mainnet-beta, devnet, or localhost) where the accounts are delegated.

These public validators are supported for development. Make sure to add the specific ER validator account when delegating:

Asia (devnet-as.magicblock.app): MAS1Dt9qreoRMQ14YQuhg8UTZMMzDdKhmkZMECCzk57
EU (devnet-eu.magicblock.app): MEUGGrYPxKk17hCr7wpT6s8dtNokZj5U2L57vjYMS8e
US (devnet-us.magicblock.app): MUS3hc9TCw4cGC12vHNoYcCGzJG1txjgQLZWVoeNHNd
TEE (tee.magicblock.app): FnE6VJT5QNZdedZPnCoLsARgBwoE6DeJNjBs2H1gySXA
Local ER (localhost): mAGicPQYBMvcYveUZA5F5UNNwyHvfYh5xkLS2Fr1mev

solana-test-validator (localhost)
devnet

Set up Solana Test Validator (Localhost) and deploy your upgraded program

Install solana-test-validator:

sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

Install the latest MagicBlock Ephemeral Validator:

npm install -g @magicblock-labs/ephemeral-validator@latest

Run solana-test-validator with cloned delegation program and accounts from Devnet:

mb-test-validator --reset

Upgrade and deploy your program to localhost:

Rust Native
Anchor

cargo build-sbf
solana config set --url localhost
solana program deploy YOUR_PROGRAM_PATH

anchor build && anchor deploy \
--provider.cluster localnet

Run MagicBlock ER validator (Localhost)

Run the local ephemeral validator pointing to localhost:

RUST_LOG=info ephemeral-validator \
  --accounts-lifecycle ephemeral \
  --remote-cluster development \
  --remote-url http://127.0.0.1:8899 \
  --remote-ws-url ws://127.0.0.1:8900 \
  --rpc-port 7799

Test program instructions and delegation (Localhost)

Run your tests against the local ephemeral validator:

Rust Native
Anchor

EPHEMERAL_PROVIDER_ENDPOINT=http://localhost:7799 \
EPHEMERAL_WS_ENDPOINT=ws://localhost:7800 \
PROVIDER_ENDPOINT=http://localhost:8899 \
WS_ENDPOINT=ws://localhost:8900 \
yarn test

EPHEMERAL_PROVIDER_ENDPOINT="http://localhost:7799" \
EPHEMERAL_WS_ENDPOINT="ws://localhost:7800" \
anchor test \
--provider.cluster localnet \
--skip-local-validator \
--skip-build \
--skip-deploy

Upgrade and deploy program on Devnet

Upgrade your program with MagicBlock delegation and deploy it to Devnet:

Rust Native
Anchor

cargo build-sbf
solana config set --url devnet
solana program deploy YOUR_PROGRAM_PATH

anchor build && anchor deploy \
--provider.cluster devnet

Install and run MagicBlock ER validator (Devnet)

Install the latest MagicBlock Ephemeral Validator:

npm install -g @magicblock-labs/ephemeral-validator@latest

Run the local ephemeral validator pointing to Devnet:

RUST_LOG=info ephemeral-validator \
  --accounts-lifecycle ephemeral \
  --remote-url "https://rpc.magicblock.app/devnet" \
  --rpc-port 7799

Test program instructions and delegation (Devnet)

Run your tests against the local ephemeral validator:

Rust Native
Anchor

EPHEMERAL_PROVIDER_ENDPOINT=http://localhost:7799 \
EPHEMERAL_WS_ENDPOINT=ws://localhost:7800 \
yarn test

EPHEMERAL_PROVIDER_ENDPOINT="http://localhost:7799" \
EPHEMERAL_WS_ENDPOINT="ws://localhost:7800" \
anchor test \
--provider.cluster devnet \
--skip-local-validator \
--skip-build \
--skip-deploy

How-to-Guide

Reference Material

API

Quick Access

GitHub

GitHub

Local Environment

​Quick Access

GitHub

GitHub

​Local Environment

Quick Access

Local Environment