network

Monad Mainnet Configuration

Parameter	Value
Chain Name	Monad Mainnet
Chain ID	143
Chain ID (hex)	0x8f
RPC (primary)	https://rpc.monad.xyz
RPC (Alchemy)	https://monad-mainnet.g.alchemy.com/v2/<KEY>
Block Explorer	https://monadexplorer.com
Currency	MON
Decimals	18

The UI automatically adds Monad to your wallet if it is not already configured.

---

Adding Monad Manually

If auto-add fails, add the network manually in MetaMask:

1. Open MetaMask → Settings → Networks → Add Network

2. Fill in the details above

3. Save and switch to Monad

---

Local Development

No build step required — single HTML file, no dependencies to install.

# Clone the repo
git clone https://github.com/your-org/vecube-rewards.git
cd vecube-rewards

# Serve locally
npx serve .
# or
python3 -m http.server 8080

Open http://localhost:8080 in a browser with MetaMask or Rabby installed.

---

Dependencies

Library	Version	Usage
ethers.js	6.7.0	RPC provider, ABI encoding, tx signing
IBM Plex Mono	—	UI monospace font (Google Fonts)
Bebas Neue	—	Display / number font (Google Fonts)

All loaded via CDN — no npm install required.

---

Architecture

User Browser
    │
    ├── window.ethereum (MetaMask / Rabby)
    │       └── BrowserProvider → Signer → write txs
    │
    ├── JsonRpcProvider (Alchemy — read only)
    │       ├── CubeNFT.totalMinted()
    │       ├── CubeNFT.balanceOf(wallet)
    │       ├── CubeNFT.ownerOf(id) × N  [batches of 20]
    │       ├── CubeNFT.getCubeData(id)  × owned
    │       ├── Rewards.currentEpoch()
    │       └── Rewards.pendingRewards(veCube, tokenId)
    │
    └── Transaction (write)
            └── Rewards.claimAll(veCube, tokenId, epoch - 1)

---

Error Reference

Error Code	Meaning	How It's Handled
4001	User rejected request	Toast + warning log
4902	Chain not in wallet	Auto-add Monad via wallet_addEthereumChain
-32603	Internal RPC / chain mismatch	Attempt chain add
ERC721NonexistentToken	Token ID doesn't exist	Skipped silently during scan
currentEpoch === 0	Epoch not yet ended	Claim blocked with message

---

SUMMARY.md (GitBook Sidebar Order)

* [Introduction](README.md)
* [Contracts](contracts.md)
* [How to Claim](how-to-claim.md)
* [Epoch System](epoch-system.md)
* [Functions Reference](functions.md)
* [Network & Setup](network.md)