repla-cli

Launch and manage Solana game-specific L3 rollups from your terminal.

repla-cli is the command-line side of the REPLA framework — a workbench for app-specific rollups for games, settling to Solana via an Anchor program and running game state inside a MagicBlock-backed sequencer runtime.

Install

npm i -g repla-cli
# or, no install:
npx repla-cli --help

Requires Node ≥ 20.

Commands

repla init <name>              # scaffold a new L3 project (repla.config.json + metadata)
repla connect <network>        # save mainnet | devnet | localnet to ~/.repla/config.json
repla deploy l3 --id <l3_id>   # register an L3 on-chain (real register_l3 tx; the owner signs)
repla stake <amount>           # register as a sequencer + stake (REAL on-chain transaction)
repla withdraw [amount|all]    # withdraw escrowed stake back to the operator (real tx)
repla settle --l3-id --from --to --state-root --actions   # self-sequencer settle_state (real tx)
repla status                   # show sequencer + settler status from the REPLA API

Run repla <command> --help for flags.

The write commands (deploy l3, stake, withdraw, settle) submit real on-chain transactions — run repla connect <network> first and pass a funded --keypair. They auto-detect the settler era from the on-chain registry: the SOL era escrows lamports; the $REPLA token era transfers/burns $REPLA (so stake and the L3 publish fee are paid in $REPLA). repla deploy l3 with no --id mints a new L3 id and prints the exact --id command to register it.

repla init writes a starter repla.config.json, a project README.md, a .gitignore, and a .repla-meta.json recording the engine and game type. Pass -e, --engine <unity|unreal|godot|web> to tag the target engine and -t, --type <rpg|shooter|puzzle|rts|simulation|other> to tag the genre.

Companion packages

The CLI builds on two libraries you can also install directly:

• @repla/sdk-ts — TypeScript client for the REPLA API and Anchor settler. Contains the byte-identical hash function that the Rust sequencer runtime and the TypeScript twin share.
• @repla/magicblock-adapter — binds the sequencer runtime to a MagicBlock Ephemeral Rollup session.

Anchor settler is live on Solana mainnet at 42LxZbUQHUSiBvuVzo1YtAxbjDbxLDLHNmQhyG5wabVV (explorer). Now live on Solana mainnet.

Links

• Site — https://repla.fun
• Diorama (browser-side designer) — https://repla.fun/diorama
• Bench (L3 launcher) — https://repla.fun/bench
• Kit (engine SDK downloads) — https://repla.fun/kit
• Manual — https://repla.fun/manual
• Reference crate (open) — https://github.com/replalabs/repla-core
• X — https://x.com/replagg

License

Apache-2.0.