Quickstart

From zero to a running mainnet fork you can drive.

Boot the fork

This starts the JSON-RPC server on http://127.0.0.1:9123.


galene start

This forks mainnet by default. To fork testnet, devnet, localnet, or a private fullnode, set fork.rpc in galene.toml.

Mint a million USDC

Open another shell. Fabricate a coin and give it an owner.


curl -X POST http://127.0.0.1:9123/ \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "galene_faucet",
    "params": {
      "coinSymbol": "USDC",
      "amount": "1000000",
      "recipient": "0xalice"
    }
  }'

Fork a real mainnet object

Pull a live object into the engine. Here it is the on-chain Clock at 0x6.


curl -X POST http://127.0.0.1:9123/ \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "galene_forkObject",
    "params": {
      "objectId": "0x6"
    }
  }'

Open the dashboard


galene studio

Submitting a full transaction? galene_executeTransactionBlock forks every object the transaction needs before it runs. You do not fork them by hand. See the cheatcode reference.

Replay a past transaction

Replay any mainnet transaction locally. You get its full object and trace artifacts.


galene replay <tx-digest>

Then render its object graph, one command at a time.


galene graph <tx-digest>

Next steps

How it works. The copy-on-read fork, end to end.
Cheatcodes. Every galene_* method.
Studio. The local dashboard.