For the complete documentation index, see llms.txt. This page is also available as Markdown.

Frequently asked questions

Who this is for: anyone using Lumia (developer, issuer, node operator, or general user) with a question that isn't specific to one section of the docs. At the end of this page you'll have an answer, or a link to the page that does.

Which network should I be using, mainnet or Beam?

Use mainnet for anything real: production apps, real assets, real funds. Use Beam testnet for development and testing. Every value you need to configure either (chain ID, RPC, explorer, and anything else confirmed) lives at Networks; copy it from there rather than from an old bookmark.

There is also a retired network that is not a live Lumia network and is not another name for Beam. If a tutorial or config file points at it, it's stale; see Retired testnet for what it was and how to tell you're on it.

Why doesn't my contract behave the same as on Ethereum mainnet?

Lumia is EVM-equivalent but not identical at the opcode level. Some opcodes and precompiles are modified or unsupported. The full, canonical table is at EVM opcodes; don't rely on assumptions carried over from another chain.

How do I get a wallet set up for Lumia?

Start at Getting a wallet for the general path, or Add Lumia to MetaMask / Add Lumia to FoxWallet if you already know which wallet you're using and just need the network added.

How do I move assets on or off Lumia?

That's bridging, not swapping. See Bridging assets for the user-facing walkthrough, or Bridge assets to/from Lumia L2 (technical) for the developer/contract-level view.

Where do I find node-operator documentation?

Run a Node. It covers running your own RPC node, zkNode/validium node, or DA light client: hardware requirements, setup, and troubleshooting.

Is Run a Node the same thing as HyperNodes?

No. Run a Node is generic, self-run node infrastructure that anyone can set up. HyperNodes is Lumia's separate commercial node product. If you're trying to run your own infrastructure, you want Run a Node. If you're asking about your existing HyperNodes, start on the HyperNodes page, and use Contact & support channels for anything account-specific.

I don't see my term defined here

Check the Glossary. Jargon used across these docs (RWA, Validium, sequencer, DA, and the rest) is defined there once, with a link to the full page for each.

My question isn't answered here

Use Contact & support channels. The Telegram bot is the fastest general-purpose channel if you're not sure which email applies.

Was this helpful?