Live Web3 Config
Chain, network, wallets, creator share and the generated runtime. This page is part of the Building apps chapter of the TokenOS documentation.
- Live Web3 Config The modal that appears before every first build decides whether your app is real or a demo . Fill it in and the generated app ships with real wallet connect, balances, prices and transaction handlers wired to the chain you chose. Skip it and you get a UI-only build with a yellow Demo banner and blocked transactions. Previews and deployed apps run identical code — hosting does not make things real. An app is live when (1) it was built with Live Web3 Config and (2) its contract is deployed on the network the config points at. Metrics that cannot be read on chain yet carry a yellow Simulated badge by design. Fields What the generated app receives config.js is written at build time and must not be edited by hand (it is a protected runtime file): For EVM builds the object also carries evmChain , chainId , chainIdHex , chainName , explorerBase and addChainParams (ready for wallet_addEthereumChain ). The runtime: lib/web3.js Hand-tested, zero-LLM-token JavaScript injected into every live build. Pages import from it instead of talking to RPC directly. Wallet access comes from hooks/useWallet.js and lib/walletBridge.js : inside the IDE preview they talk to your real wallet through the consent-gated bridge; on a hosted app they talk to the browser's wallet extension directly. Pages always receive wallet as an address string . Demo mode Changing the config later Network, wallets and token are baked at build time. Use the Project Config action in the workspace to change them and rebuild — for example after deploying to mainnet, set Network to mainnet so RPC endpoints follow. The Launch Checklist shows whether a project has a live config and where it has been deployed.
“My app shows fake data / nothing works”
Which runtime is injected (Solana web3.js + wallet adapter, or EVM with injected wallets).
Chain id, RPC and explorer (Base 8453 / Base Sepolia 84532; Robinhood Chain 4663 / testnet 46630).
RPC endpoint and explorer base. Choose a test network first; rebuild on mainnet when ready.
The only wallet that sees admin pages (isAdmin). Defaults to the connected wallet.
Where in-app payments land. Can be the same as the admin wallet.
Stored as creator_share_bps; the runtime splits every payment between the payments wallet and the platform fee automatically.
No token · Use existing (mint / address) · Launch new (Pump.fun, Solana only)
Bakes the token into the app (TOKENS map, balances, transfers). The in-build launch requires the issuer acknowledgement (Terms §12.2).
Sends a payment and performs the platform-fee + creator-share split in the same flow; resolves with the signature and explorer link.
Native and token transfers with txStatus states (idle → signing → confirming → confirmed / failed).
Calls the deployed program / contract recorded by Deploy Contract.
Live market prices and the token map for the app.
True only for the configured admin wallet — gate admin UI on it.
Correct explorer links per chain and network.
A yellow “Demo Mode” banner at the bottom of every page.
Transaction handlers are blocked with a friendly “UI demo build — rebuild with Live Web3 config” message.
Reads still work where possible; everything else is clearly labelled Simulated.
To make the app real, rebuild it and click “⚡ Build with Live Web3” instead of Skip.
Browse the full TokenOS documentation or jump to the API reference, credits & pricing or FAQ.
About TokenOS
TokenOS is the AI operating system for the autonomous Web3 economy. It combines an agentic IDE that turns a prompt into a deployed dApp, a marketplace of x402-paid AI agents, a peer-to-peer AI inference market where anyone can sell spare API quota or GPU time for USDC, MCP and A2A connectors for Claude, Cursor and ChatGPT, and the $TOS utility and governance token on Solana.
Builders pay with prepaid credits; sellers and agent creators are paid for work actually delivered; TokenOS indexes, verifies and settles. Nothing on this site is investment advice, and node payouts, agent payments and referral credits are fees for usage — not token distributions or returns.