# Galene

> A local Sui sandbox, filled with real mainnet state. Run Sui mainnet locally, with real on-chain state. Fork, fund, break, and reshape it safely, never touching the real chain.

Galene is a copy-on-read fork of Sui mainnet that runs on your machine. It fetches real on-chain objects and packages from mainnet on demand, runs a real Move VM you can submit transactions to, and exposes state cheatcodes over JSON-RPC. A single command starts the fork plus two dashboards: a live terminal UI and Galene Studio in the browser.

## Quick start

Install a prebuilt binary on macOS or Linux. No toolchain, no compilation; the dashboard is embedded.

```bash
curl -fsSL https://galene.ariessa.xyz/install.sh | sh

# Boot the local fork: JSON-RPC on 127.0.0.1:9123, plus the terminal and web dashboards.
galene start
```

## Features

- Copy-on-read fork. Compose against live mainnet locally. Run a PTB that touches real on-chain objects and packages with zero manual dumping; Galene fetches what it needs on demand and caches it.
- A real Move execution engine. Fork live mainnet objects into an in-process VM and submit transactions against them. Galene auto-forks every object a transaction references, then runs it.
- State cheatcodes over JSON-RPC. Mint any coin to any address, auto-fund gas, execute as any address, overwrite any object, register a patched package, and travel through epochs and time.
- Historical replay. Replay any past mainnet transaction locally and inspect its full effects, gas, and trace.
- Object-graph time-travel debugging. Step through a PTB command by command and see exactly which objects each command reads, mutates, creates, or deletes.
- Galene Studio. A local web dashboard: object-graph debugger, faucet, object-diff inspector, and execution panel.

## Cheatcodes (custom JSON-RPC methods)

- `galene_mintCoin(type, amount, recipient)`: fabricate a Coin<T> with any balance and owner.
- `galene_faucet(coinSymbol, amount, recipient)`: mint a known coin (SUI, USDC, USDT, WAL, DEEP) or any full type.
- `galene_setGas(address, amount?)`: auto-fund any address with SUI gas.
- `galene_setObject(objectId, contents, owner, type?)`: overwrite any object's contents or owner.
- `galene_warpEpoch(n)` and `galene_setClock(timestampMs)`: time-travel for epoch- and time-locked logic.
- `galene_impersonate(address)`: execute as any address, auto-funded with gas.
- `galene_overridePackage(packageId, bytecode)`: register a patched package.
- `galene_forkObject(objectId)`: fork a real mainnet object into the execution engine.
- `galene_executeTransactionBlock(txBytes)`: submit a serialized transaction; auto-forks referenced objects, then executes.

## CLI

```bash
galene start            # boot the fork plus the terminal and web dashboards
galene replay <digest>  # replay a historical mainnet transaction and capture its trace
galene graph <digest>   # print a transaction's per-command object graph
galene studio           # open Galene Studio (the web dashboard)
```

## Links

- Website: https://galene.ariessa.xyz
- Docs: https://docs.galene.ariessa.xyz
- GitHub: https://github.com/ariessa/galene
- Install script: https://galene.ariessa.xyz/install.sh