Documentation
AURION is a post-launch protocol layer: six composable Solidity contracts plus the $AUR token, bundled as a Foundry + Next.js monorepo.
Architecture
Seven contracts, one token:
| Contract | Module | Responsibility |
|---|---|---|
AurionToken | $AUR | ERC20 with hard cap, owner mint, public burn. |
AurionRouter | Router | routeETH / routeTokenToEth with slippage guards. |
AurionPair | LP | Constant-product ETH/$AUR AMM with LP shares. |
AurionAirdrop | Airdrop | Merkle-proof token claims with a deadline. |
AurionRaffle | Raffle | Ticket raffle; winner takes the pot. |
AurionVault | Vault | Stake $AUR, earn donated ETH pro-rata. |
AurionBands | Bands | Floor/ceiling price corridor with reserve. |
Run locally
1. Contracts
cd contracts forge test # 31 tests forge build
2. Local chain
anvil # http://127.0.0.1:8545
3. Deploy
forge script script/Deploy.s.sol --rpc-url http://127.0.0.1:8545 --broadcast
4. Frontend
cp .env.example web/.env.local # then fill in the addresses pnpm install pnpm --filter web dev # http://localhost:3000
Demo mode
If the NEXT_PUBLIC_*_ADDRESS variables are empty, the console boots in DEMO MODE — every page renders simulated data and transactions instead of touching a chain. It never white-screens.
Key values
| Parameter | Default |
|---|---|
| Max supply | 1,000,000,000 $AUR |
| Initial supply | 100,000,000 $AUR |
| Pool fee | 0.30% (30 bps) |
| Initial price | 0.0001 ETH / $AUR |
| Band | 0.0001 – 0.001 ETH |
Back to the console.