Loading...
Demo mode lets you experience the full Metalos governance interface without connecting a wallet or interacting with the blockchain. Perfect for learning how futarchy prediction markets work before participating with real funds.
What is Demo Mode?
Demo mode is a fully functional governance interface that uses simulated data instead of blockchain transactions. Everything you see—proposals, markets, trades, balances—works exactly like the real system, but with mock data stored locally in your browser.
Demo mode uses localStorage for persistence. Your demo data stays on your device and never touches the blockchain or real contracts.
Features Available in Demo Mode
✅ What You Can Do
- Create Draft Proposals: Write governance proposals using real templates
- Pledge Liquidity: Simulate crowdfunding to activate proposals
- Trade Prediction Markets: Buy and sell PASS/FAIL tokens
- Vote with Tokens: Express opinions by trading on outcomes
- Track Positions: See your simulated token holdings and P&L
- Redeem Outcomes: Simulate claiming winnings after proposals conclude
- Explore UI: Learn the interface before using real funds
❌ What's Simulated
- No wallet connection required
- No blockchain transactions
- No real funds at risk
- No gas fees
- Data stored locally (not on-chain)
- Reset anytime with
window.resetGovernanceDemo()
Getting Started with Demo Mode
Access Governance Page
Navigate to metalos.xyz/governance
You'll see a blue banner indicating you're in demo mode.
Explore Existing Proposals
The demo loads with sample proposals to explore:
- Active proposals with live prediction markets
- Completed proposals showing final outcomes
- Draft proposals gathering community support
Create Your Own Proposal
Click "Create Proposal" to try the proposal creation flow:
- Choose a template (New Vault, Vault Change, etc.)
- Fill in the details
- Submit to create a draft
- See it appear in the Drafts tab
Trade Prediction Markets
On any active proposal:
- Click to open the proposal details
- Use the trade panel to buy PASS or FAIL tokens
- See how your trades affect market prices
- Track your position in the "Your Position" section
Watch Markets Evolve
Demo mode simulates other traders:
- Prices fluctuate based on market activity
- Volume and liquidity change over time
- Proposals advance through lifecycle stages
Demo Mode Controls
Reset Demo Data
Clear all demo data and start fresh:
// Open browser console (F12) and run:
window.resetGovernanceDemo()
This resets:
- All proposals to initial state
- Your demo balances
- Trade history
- Draft proposals you created
Export Demo Data
Save your demo session data:
// Export to clipboard
window.exportDemoData()
Useful for:
- Sharing demo scenarios with team
- Bug reporting
- Teaching materials
Dismiss Demo Banner
Click the "X" on the demo banner to hide it. The banner stays dismissed until you reset demo data or clear localStorage.
Understanding Demo Behavior
Time Acceleration
Demo mode runs faster than real-time:
- Proposal countdowns: 5 minutes (vs 48 hours real-time)
- Market updates: Every few seconds
- Auto-activation: When thresholds met
This lets you see complete proposal lifecycles quickly.
Simulated Trading
Demo mode simulates market activity:
- Other "traders" create volume
- Prices respond to supply/demand
- Liquidity pools adjust dynamically
- Gas-free instant execution
Data Persistence
Demo data persists in your browser:
- Survives page refreshes
- Stored in localStorage
- Device-specific (not synced)
- Cleared by
resetGovernanceDemo()
Learning Scenarios
Scenario 1: Proposal Creator
Goal: Learn how to create and promote a proposal
- Create a draft proposal (New Vault template)
- Pledge liquidity to support it
- Get others to pledge (simulated)
- Watch it activate when threshold reached
- Trade on the prediction market
- See the outcome resolution
Scenario 2: Prediction Market Trader
Goal: Learn how to trade on proposal outcomes
- Browse active proposals
- Analyze proposal details
- Buy PASS tokens if you think it'll pass
- Watch market prices change
- Sell tokens or wait for outcome
- Redeem winnings if correct
Scenario 3: Community Validator
Goal: Learn how to evaluate proposals
- Browse draft proposals
- Read proposal details and templates
- Pledge liquidity to proposals you support
- Give thumbs up/down votes
- See how community sentiment affects activation
- Watch successful proposals activate
Tips for Demo Mode
Best Practices
✅ Do:
- Experiment freely—no real risk
- Try all proposal templates
- Test different trading strategies
- Learn the interface thoroughly
- Reset and try different approaches
❌ Don't:
- Expect data to persist across devices
- Share demo data as if it's real
- Confuse demo balances with real funds
- Rely on demo data for actual decisions
Common Questions
Can I lose money in demo mode?
No! Demo mode uses simulated funds. You cannot lose (or gain) real money. Perfect for risk-free learning.
Will my demo proposals affect the real system?
No. Demo mode is completely isolated. Demo proposals, trades, and data never touch the blockchain or real contracts.
Can I switch to real mode?
Yes! Connect a wallet on the governance page to use real contracts. The interface is identical—you'll just be using real funds and blockchain transactions.
Why does the demo run so fast?
Demo mode accelerates time so you can see complete proposal lifecycles (draft → active → concluded) in minutes instead of days.
Can I share my demo session?
Yes! Use window.exportDemoData() to export your demo state as JSON. Others can import it to see your exact scenario.
Transitioning to Real Mode
When you're ready to participate with real funds:
Connect Wallet
Click "Connect Wallet" on the governance page. The demo banner will disappear once connected.
Understand the Differences
Real mode requires:
- Base network wallet (MetaMask, Coinbase Wallet, etc.)
- ETH for gas fees
- Real USDC for pledging/trading
- Blockchain confirmations (slower than demo)
Start Small
Begin with small amounts:
- Pledge small amounts to test the flow
- Make small trades to understand mechanics
- Learn from experience before committing large funds
Remember
- Transactions are irreversible on-chain
- Gas fees apply to all transactions
- Market prices are determined by real traders
- Proposal outcomes affect real funds
Real Mode Uses Real Funds: Once you connect a wallet and interact with real contracts, you're using actual USDC and ETH. Transactions cannot be reversed. Only proceed when comfortable with the mechanics.
Technical Details
Storage
Demo mode stores data in:
localStorage keys:
- governance-demo-storage: Zustand store (proposals, balances, positions)
- governance-demo-banner-dismissed: Banner visibility flag
Implementation
Demo mode is implemented using:
- Zustand Store: State management (
lib/store/governance-demo-store.ts)
- Mock Data: Sample proposals and initial state
- localStorage: Client-side persistence
- React Components: Same UI as real mode
Debugging
Enable debug mode in console:
// View current demo state
useGovernanceDemo.getState()
// Manually advance time
useGovernanceDemo.getState().advanceTime(5 * 60 * 1000)
// Trigger proposal activation
useGovernanceDemo.getState().activateDraft(draftId)
Related Documentation