The node is not answering, so the live figures on this page are missing. Everything else reads the same.
MiniChain

A whole chain, inside one Ethereum contract.

Deposit ETH, deploy contracts, call them, withdraw. The contracts live in the chain's own state and run in an interpreter, so every transaction on a MiniChain is an Ethereum transaction. There is no token, no sequencer and no bridge.

The chain on the right is real and running on a local Ethereum fork. MiniChain is not yet deployed to mainnet and has not been externally audited.

Connecting to the node
Genesis
MiniChain #1, a sapphire

The first MiniChain. Its token is a gemstone drawn on-chain from the chain's own state.

Latest blocks, one per operationAll blocks
  1. Waiting for the node's latest blocks.

One contract holds the ledger, the code and the history.

Contracts on a MiniChain are guests. They are not Ethereum contracts: their code and storage sit in the MiniChain's state, and an interpreter built into the chain runs them when you call it.

Your wallet Sends an ordinary Ethereum transaction to one address. Your wallet address is your account inside.
depositdeploycreatetransactwithdraw
A relayer or a front end Submits requests you signed, or reads a guest with eth_call and commits nothing.
executeexecuteBatchwithdrawForread
Ethereum
MiniChain contract

Ledger

ETH is the only asset. Every internal wei is backed one to one by ETH the contract holds.

HeldETH Owedto accounts

Guests hold and move internal ETH too. Fees are a transfer inside the same ledger, so the two bars always match.

Guest contracts

Code and storage kept in the chain's state, at their own addresses.

Two interpreters, and your own

Execution is bounded by a step budget you set per call, separate from gas.

MiniVM16 registers, four-byte instructions, close to native cost.
EVMRuns Solidity bytecode as compiled. Uniswap V2 runs unmodified.
Custom enginesA chain's owner can add up to eight interpreters of their own, once, at launch. They are sandboxed: each can act only for the guests deployed to it. How engines work

History

Each operation commits one block: it is hashed into head and height goes up by one.

blockblockhead

head = hash(previous head, height, operation)

Newest block
What it did, who sent it and the fee it paid are all in Ethereum's logs.
See every block
Ethereum supplies ordering and finality Solidity guests can read Ethereum contracts, never write to them
No tokenFees, balances and payments are all ETH.
No sequencerWhoever sends the Ethereum transaction orders it. There are no validators either.
No bridgeThe ETH never leaves Ethereum. Withdrawing is one call.
No admin keyNobody can pause, upgrade or censor a chain, its owner included.

Four calls, start to finish.

These are the real commands, using Foundry's cast against the chain shown above. The guest is the 20-byte counter from the repository's examples.

# the node and chain this page is reading; add your own signer, e.g. --private-key export ETH_RPC_URL=http://127.0.0.1:8545 export MINICHAIN=<MiniChain address> ME=<your address>
  1. Deposit

    Send ETH to the chain. The contract keeps it and credits the same amount to your account inside. Deposits pay no chain fee.

    $ cast send $MINICHAIN "deposit(address)" $ME --value 1ether
    Internal balance 1 ETH, contract holds 1 ETH more
  2. Deploy

    Store a program in the chain at its own address. Kind 1 is MiniVM, kind 2 is EVM runtime bytecode; create runs a Solidity constructor instead.

    $ cast send $MINICHAIN "deploy(uint8,bytes,bytes32)" 1 \
        0x130100001602000003020201170002001a020000 $(cast keccak counter)
    Emits ContractDeployed with the guest's address, here $COUNTER
  3. Transact

    Call the guest with a value, calldata and a step budget. A failure rolls the whole call back. read runs the same guest without a transaction.

    $ cast send $MINICHAIN "transact(address,uint256,bytes,uint256)" \
        $COUNTER 0 $(cast abi-encode "f(uint256)" 7) 100000
    $ cast call $MINICHAIN "read(address,bytes,uint256)(bytes)" \
        $COUNTER $(cast abi-encode "f(uint256)" 0) 100000
    Counter is 7, one block committed, fee paid in internal ETH
  4. Withdraw

    Turn internal ETH back into ETH on Ethereum, to any recipient, in the same transaction. No waiting period and no chain fee.

    $ cast send $MINICHAIN "withdraw(uint256,address)" 0.25ether $ME
    0.25 ETH arrives in your wallet, the rest stays inside

Examples on MiniChain

Two programs written for MiniVM that ship with the code. Anyone can deploy a copy to any chain. The figures here are examples.

MiniUni

A constant-product pool in 712 bytes

ETH against one token, on Uniswap V2's curve

Every trade pays a 0.3% fee, in ETH, to whoever seeded the pool.

ETH in the pool
–
Tokens in the pool
–
A trade takes 31 to 39 instructions.How MiniUni works

MiniNFT

A collection in 420 bytes

One storage slot per item: its owner

Its creator sets a price and a supply cap once. Mints and transfers are logged as ERC-721 transfers, which is how an explorer knows who holds what.

    Items are coloured by owner.How MiniNFT works

    Every transaction pays Ethereum first.

    A MiniChain transaction is executed in full by Ethereum and pays Ethereum's base fee, which is burned. The chain's own fee is a tenth of that again, paid in ETH to two owners.

    A MiniChain

    One user transaction is one Ethereum transaction. Ethereum burns the base fee on all of its gas.

    Your transaction an Ethereum transaction gas × base fee all of it Burned by Ethereum The base fee, as on any other half half This chain's owner Owner of MiniChain #1 + a tenth
    Widths are to scale: the chain's fee is one tenth of the burn.

    A typical L2

    Many user transactions are compressed into one posting, so each pays Ethereum almost nothing.

    manyusers The L2's sequencer collects the users' fees Kept by the operator Often alongside its own token Burned one batch
    Schematic: the split varies by rollup and is not drawn to scale.

    The trade-off, stated plainly: a MiniChain does not make transactions cheaper.

    An L2 exists to scale. A MiniChain does the opposite of batching, and running a guest in an interpreter costs more gas than running the same code natively. What it gives you instead is your own ledger, your own fee stream and outright ownership, with nothing between you and Ethereum.

    • Uniswap V2 swap, native on Ethereumabout 93,000 gas
    • MiniUni trade, written for MiniVM145,000 to 160,000 gas
    • Uniswap V2 swap, interpreted inside a MiniChainabout 2,800,000 gas
    Measured in the repository's Foundry benchmarks. MiniUni is a single pool with a built-in token, so the comparison with Uniswap is not like for like.

    Where the ETH goes

    Enter a transaction's gas and Ethereum's base fee.

    gas
    gwei
    Burned by Ethereumgas × base fee
    Fee to this chain's ownerhalf of a tenth
    Fee to the owner of MiniChain #1the other half

    The exact fee is (gas measured in the call + 37,700) × base fee ÷ 10, which came to between 88% and 100% of a tenth in every measured case, so the two fees shown are upper bounds. Priority tips are not counted. The sender pays the fee in internal ETH; deposits, withdrawals and fee claims pay none. On MiniChain #1 both halves go to the same owner.

    A chain can be made to end.

    An event, a season, a sale: some chains have a natural last day. A MiniChain can be launched with an end date, fixed and public from its first block. Chains created without one never end.

    Before the end date
    Createdday 0
    30 daysthe minimum
    End dateday 45 here
    Sweepby anyone
    No end date can fall in here
    From the end date

    Set once, by the creator

    The end date is chosen when the chain is minted and must be at least 30 days away. Nobody can move it afterwards, the owner included.

    Withdraw before it

    From the end date the chain accepts nothing: no deposits, no calls, no withdrawals. Anyone can then sweep it, which sends all remaining ETH to the token's owner, other users' balances included.

    The stone stays

    The token is not destroyed and the chain's history stays readable. Its gemstone turns grey and still, at the size and cut it had when the chain stopped.

    Each chain is a token, and the token is a stone.

    Every MiniChain is an ERC-721 token in one registry. Whoever holds the token owns the chain. Its picture is an SVG built entirely on-chain from the chain's live state, with no server behind it.

    Stone
    Sapphire
    Cut
    Marquise
    1. Facets from operations

      One more row of facets at 10, 100, 1,000 and 10,000 operations. Every operation also moves the light.

      1101001,00010,000

      A new chain starts with one row.

    2. Size from ETH held

      The stone is 35% of full size when empty, half at 5 ETH and full at 1,000 ETH, on a logarithmic curve.

      35%halffull

      Size follows the ETH the chain holds.

    3. Glints from fees

      One glint to begin with, and one more each time the fees earned double from 0.01 ETH, up to ten.

      Glints follow the fees a chain has earned.

    What owning a chain gives you

    • Half of every fee the chain collects. The other half goes to the owner of MiniChain #1.
    • The right to name it. The name travels with the token when it is sold.
    • Whatever ETH is left in it when it ends, if it was created with an end date.

    What it does not

    • No way to change the fee rate or the split. Both are constants in the code.
    • No way to pause the chain, upgrade it or move its end date.
    • No access to anyone's balance while the chain is running.

      Fourteen stones and eleven cuts, chosen by the chain's id and address. Diamond and onyx are rarer. Swatches here are approximate.

      There can be 512 MiniChains, and never more.

      The registry itself refuses a 513th, whatever rule mints them. The default minter allows one more MiniChain for every 0.01 ETH of fees MiniChain #1 has collected, free apart from gas and open to anyone once the owner of MiniChain #1 opens minting. The owner of MiniChain #1 can also give tokens away.

      Exists Can be minted now Not yet minted