Filesystem guide
Bloom’s VFS is normally mounted at /bloom. Use standard shell tools against that mount: reads are cat/ls, writes are file writes.
Top-level layout
| Path | Purpose |
|---|---|
/bloom/chains/<chain>/ | Chain heads, blocks, addresses, contracts, gas, txs, receipts, mempool, and Etherscan-backed history. |
/bloom/wallets/<name>/ | Managed wallets, balances, nonce, outbox, and signing surfaces. |
/bloom/defi/intents/<wallet>/ | Natural-language and structured DeFi routing through Enso. |
/bloom/watch/<id>/ | Polling subscriptions for balances, blocks, gas, and events. |
/bloom/simulate/<session>/ | eth_call and state-override sandboxes without signing or broadcast. |
/bloom/tools/ | Hashes, ABI, RLP, base64, hex, units, EIP-712, and address helpers. |
/bloom/prices/ | DefiLlama spot prices and 24h changes. |
/bloom/addressbook/ | Local petname directory. |
/bloom/ens/ | ENS forward resolution. |
/bloom/status/ | Daemon health, backend declarations, audit state, cache counts, and policy flags. |
/bloom/docs/ | In-tree operational docs vendored into the VFS. |
Read examples
cat /bloom/chains/base/head/number
cat /bloom/chains/ethereum/gas
cat /bloom/chains/ethereum/contracts/<address>/abi
cat /bloom/prices/spot/eth.usd
cat /bloom/ens/vitalik.ethWrite examples
echo alice > /bloom/wallets/new
echo 0x... > /bloom/addressbook/treasury
echo 'send 0.01 eth to 0x... on anvil' \
> /bloom/wallets/alice/chains/anvil/outbox/new.txEvery write surface should produce inspectable state rather than surprising side effects.