Documentation Index
Fetch the complete documentation index at: https://docs.alloca.xyz/llms.txt
Use this file to discover all available pages before exploring further.
Integration Guide
Technical guide for aggregators, trading bots, Telegram bots, and analytics platforms.
Quick Reference
Deployed Contracts (Monad Mainnet)
const CONTRACTS = {
AllocaFactoryMemes: "0x6bf9598B0838FB2d59c51D33fF839EEF6d79E923",
AllocaTokenImpl: "0x33E0E10D089544D232ba7C0c27B4A3A5e139255e",
AllocaDexFactory: "0xB88A4dD389c31b225e0ce6017c5AAa66eA894b79",
AllocaDexRouter02: "0x2a32C0457a84F1e50A035ffE1ecC4F104ed25eC3",
WMON: "0x3bd359C1119dA7Da1D913D1C4D2B7c461115433A",
};
const CHAIN_ID = 143; // Monad Mainnet
Contract ABIs
ABIs are available via IPFS:
ABIS = {
AllocaFactoryMemes: "https://bafybeigd7v65ctexuz4kojry66mgehcltj7hh6rcml3idpidafuhz44owu.ipfs.w3s.link/AllocaFactoryMemes.json",
AllocaToken: "https://bafybeidh6uoeotkkvxoaewjzdug3jbu3lk4m2xn7x7dvtwrfmria3qlyau.ipfs.w3s.link/AllocaToken.json",
AllocaDexFactory: "https://bafybeiectiihv3npvnk5lkplghs3qk577532ibim4ruuayrfxjedx7jcb4.ipfs.w3s.link/AllocaDexFactory.json",
AllocaDexRouter02: "https://bafybeicgh25dubwqfaqqxijnmrxyxmigg7swvrfwoyyiifwh4z3y7jv3c4.ipfs.w3s.link/AllocaDexRouter02.json",
}
Core Concepts
Token Lifecycle
Each token goes through three phases:
1. [BONDING CURVE] → 2. [GRADUATION] → 3. [DEX TRADING]
Each token is a pool - AllocaToken inherits AllocaPool functionality.
Phase 1: Bonding Curve (Pre-Graduation)
- Tokens trade on internal bonding curve
- Price increases as more tokens are bought
- Target: Raise ~492,566 MON to graduate
Phase 2: Graduation
- Automatic when bonding curve completes
- Liquidity moves to AllocaDex (Uniswap V2 fork)
- DEX pair created automatically
Phase 3: DEX Trading
- Trade via AllocaDexRouter02
- Standard Uniswap V2 interface
Events to Track
1. New Token Deployments
Listen to AllocaFactoryMemes for new token launches:
event AllocaDeployed(
address indexed allocaPool,
address indexed implementation
);
2. Token Graduation Events
Listen to individual token contracts for graduation:
event PoolGraduated(
address indexed token,
address indexed dexPair,
uint256 liquidityTokens,
uint256 liquidityBase,
uint256 lpTokensMinted
);
3. Trade Events (Bonding Curve)
event TokensBought(
address indexed buyer,
uint256 amountIn, // MON spent
uint256 amountOut, // Tokens received
uint256 fee // Fee paid
);
event TokensSold(
address indexed seller,
uint256 amountIn, // Tokens sold
uint256 amountOut, // MON received
uint256 fee // Fee paid
);
4. DEX Trade Events (Post-Graduation)
Listen to the DEX pair contract:
event Swap(
address indexed sender,
uint256 amount0In,
uint256 amount1In,
uint256 amount0Out,
uint256 amount1Out,
address indexed to
);
Determining Token Phase
To check if a token has graduated:
// Option 1: Check if DEX pair exists
const dexPair = await allocaDexFactory.getPair(tokenAddress, WMON);
const isGraduated = dexPair !== "0x0000000000000000000000000000000000000000";
// Option 2: Check graduated state on token contract
const isGraduated = await allocaToken.graduated();
Last Updated: 2025-12-05
Monad Mainnet Chain ID: 143
