Agent index (llms.txt) — fetch this first, then the page it names.

What works today

This page is the honest inventory. It is written against the code on the nightly branch (network version 0.3.0). When a page elsewhere in these docs describes something not listed as live here, treat this page as the authority and report the mismatch.

Services you can use

ServiceStateNotes
Static, Next.js, Node.js and Go hostingLiveFive runtimes: static, nextjs-static, nextjs, nodejs-backend, go-backend
Namespace database (RQLite)LiveReplicated across the namespace's three nodes
Per-app SQLiteLiveBackups to content storage
Cache (Olric)LiveDistributed maps with TTLs
File storage (IPFS)LivePrivate swarm, pinned across the cluster. Quotas exist but are opt-in
Pub/sub and presenceLiveWebSocket and REST
Serverless functionsLiveWebAssembly, HTTP/WebSocket/pub-sub/cron triggers
HTTPS for deploymentsLiveUnder the cluster's own domain
Custom domainsPartialVerified by TXT record. Certificates for custom domains are not issued, see Domains
Voice and videoLiveSFU plus TURN, relay-only by design
Stealth TURNLive, optional per nodeTURN over TLS on port 443, routed by server name
Push notificationsLiveDirect APNs, self-hosted ntfy, Expo
Anonymity proxy and tunnelLiveTor client on every node. Not a private Tor network, see Privacy network
Relayed fetchLiveDownload a stored object without the storing node learning your address
VaultPartialShamir-split secrets across guardian nodes. Do not use as the only copy of anything important
Sign-in with wallets, devices, scoped keysLiveSee Sign-in
Audit trailLive90 days, orama audit

Running a cluster

CapabilityState
Install a cluster of 3 or more nodes with orama node setupLive
One-machine evaluation clusterLive, not highly available
Rolling upgrades with signed archivesLive
Releases through a TUF release root, with reproducible builds and opt-in auto-update (notify by default)Live
Monitoring from your own machine (orama status, orama status)Live
Public /status page, telemetry APILive
Node replacement runbookLive
OramaOS (locked-down node OS)Built, never booted on a live network
Disk encryption for Ubuntu nodesDesign only
Billing, meteringNot built
DashboardNot built, and not planned
Tenant metrics endpoint and alertingNot built

The chain

The chain is implemented and tested in the repository. It is not what orama maint node install starts, it is not on the request path of any app, and nothing about it has run on a public network.

PartState
ORAMA token, emission schedule, fees, voting powerImplemented
Staking, delegation, slashingImplemented
Two-house governance (x/houses)Implemented, gated closed at genesis
Storage deals with proofs and repairImplemented. A lost piece is rebuilt by the deal's repair delegate or by the owner with orama storage repair
Relay registry, reporting and payoutImplemented. The end block settles each reported epoch and splits pay 90/5/5. No relay is registered or running yet
Token factoryImplemented, including a CosmWasm contract as a token's transfer hook
Compressed NFTs and marketImplemented
Shielded poolImplemented. A node accepts shielded bundles only when both verifiers are present. Shielding is optional: a public send between accounts works, and orama chain send is private unless --public. The RootWallet does not build shielded bundles yet, so a private send stops with that explanation
CosmWasm contractsImplemented in builds with cgo. Five standard contracts in genesis
Block explorerThe page reads the chain through the gateway's /v1/chain/ routes and the chain indexer, with no demo data
Public chainNot built. Devnet, stagenet and localnet only

Details are in the Blockchain section.

The privacy network

PartState
Tor client on every node, anonymity proxy, tunnel, anon_fetchLive
Relayed fetch over TorLive (Node.js clients)
Submitting chain transactions to a validator over an onion addressClient and server side built (--onion, --onion-network, orama global install --services onion). Never run against a real Tor network
A private Orama Tor network (directory authorities, relays, opt-in exits)Code and installer built, one tor-network.json. Never run on a real network; Orama runs every authority
orama maint vpn up and orama maint vpn checkA loopback SOCKS5 proxy client for a private network. Not a system-wide tunnel
Public VPNNot built. The launch gate (chain/x/vpnlaunch) is off in every build

RootWallet

PartState
CLI (rw)Stable
Desktop app (macOS, Linux)Stable. No Windows build
Mobile app (iOS, Android)In active development
Independent security auditPlanned

See RootWallet.

Other things people ask about

  • +Public sign-up. Not open. Namespaces exist only on clusters whose operators allow them.
  • +Open sign-in for end users. A namespace can allow any wallet to sign in to it. See Sign-in policy.
  • +Mainnet. There is none. The chain has not run on a public network.