Galene

A local Sui sandbox, filled with real mainnet state.

Galene runs a copy of Sui mainnet on your machine.

You fork it. You fund it. You break it. You reshape it.

Then you step back to the real chain. Nothing you did touched mainnet.

Mainnet is the default, not the only option. Point Galene at any Sui network, testnet, devnet, localnet, or a private fullnode, and it forks that one instead. See Configuration.

The problem

Local Sui dev gives you two bad options.

An empty localnet. sui start has no mainnet state. So you dump every object and package your PTB touches, by hand. That falls apart after a few dependencies.

A real network. It is slow. It costs gas. You cannot change state.

Galene is the missing third option. A lazy fork of any Sui network. With cheatcodes. And a real engine you can submit transactions to.

What you get

Copy-on-read fork. Run a PTB against real objects and packages; Galene fetches what it needs on demand and caches it. No manual dumping. Forks mainnet by default, or any Sui network you point it at.
A real Move engine. Submit transactions to a real Move VM. Galene forks every object the transaction needs, then runs it.
State cheatcodes. Mint any coin. Fund any address. Act as anyone. Overwrite any object. Patch any package. Jump through epochs and time.
Standard Sui interfaces. Drive the fork with the tools you already use: the canonical JSON-RPC surface, plus the modern Sui gRPC (sui.rpc.v2). Point any SDK, the Sui CLI, grpcurl, or Postman at it.
Deploy your own contracts. Publish a freshly-built Move package and call it against forked state. No testnet round-trip.
Snapshot and persist. Snapshot and revert the fork in place, or dump it to JSON and reload it later. Declare a starting sandbox in galene.toml.
Historical replay. Replay any past transaction. Inspect its effects, gas, and trace.
Object-graph debugging. Step through a PTB, one command at a time. See what each command reads, mutates, creates, and deletes.
Galene Studio. A local dashboard: object-graph debugger, faucet, and a transaction inspector.

Start here

Installation Quickstart How it works Cheatcode reference

The cast

Galene is a Nereid of the calm sea. Each part is named for one of her kin.

Part	Name	What it does
Execution engine	Poseidon	Runs transactions against forked state on a real Move VM.
Copy-on-read fork	Oceanus	Fetches objects and packages from mainnet on demand. Caches them locally.
Faucet and minting	Plouto	Mints any `Coin<T>`, at any balance. No more hunting for tokens.
Object-graph debugger	Proteus	Steps through a PTB and shows the object graph shift.
Initial-state scenarios	Thalassa	Applies a declarative starting sandbox on boot, from `galene.toml` or a `--scenario` file.
Sui gRPC (v2) server	Triton	Serves the `sui.rpc.v2` services (ledger, execution, subscriptions) over the same fork, with reflection.