llms.txt
Compare with other sites' llms.txt files →# Quainance
> Quainance is a Quai-native finance app for swaps, liquidity, PoolGauge
> incentives, stats, charts, and bridging.
Canonical site: https://www.quainance.com
Alternate deployment: https://quainance.vercel.app
Network: Quai mainnet chain ID 9
Explorer: https://explorer.qu.ai
Primary keywords: Quainance, Quai, Quai Finance, Quai DEX, Quai DeFi,
Quai swap, Quai liquidity, Quainance PoolGauge, Pelagus wallet
Use this file to understand the public app surface, supported markets, wallet
requirements, contracts, and data sources. Do not treat this as financial
advice.
## Primary URLs
- Home: https://www.quainance.com/
- Trade app: https://www.quainance.com/swap
- Trade QUAI/WQI: https://www.quainance.com/QUAI_WQI
- Trade QUAI/USDT: https://www.quainance.com/QUAI_USDT
- Trade WQI/USDT: https://www.quainance.com/WQI_USDT
- Liquidity pools: https://www.quainance.com/liquidity
- My LP positions: https://www.quainance.com/liquidity?tab=positions
- Protocol stats: https://www.quainance.com/stats
- Bridge: https://www.quainance.com/bridge
- Docs: https://www.quainance.com/docs
- Developer docs: docs/contracts-and-interactions.md
## What Users Can Do
- Swap supported Quai assets through the Quainance router.
- Add or remove liquidity from deployed pools.
- Stake LP tokens in PoolGauge.
- Claim gauge rewards earned by staked LP.
- Fund active incentives for supported pools with allowlisted reward tokens.
- View protocol stats, pool stats, token stats, activity, charts, and trades.
- Bridge supported assets between Quai, Base, and Ethereum through Symbiosis.
## Main Pools
- QUAI/WQI
- App route: /QUAI_WQI
- On-chain pair uses WQUAI/WQI because native QUAI is wrapped by the router.
- LP token: 0x00602F12EA0491F02865aa6C418815319e2A645B
- QUAI/USDT
- App route: /QUAI_USDT
- On-chain pair uses WQUAI/USDT because native QUAI is wrapped by the router.
- LP token: 0x0021f5cc862eBb0252Ba209266f2FAbbC7592E83
- WQI/USDT
- App route: /WQI_USDT
- LP token: 0x007b1B56Ef119cdEac383EacBcCcD9Dadfa7e322
## Tokens
- QUAI
- Native token of Quai.
- Router wraps native QUAI into WQUAI for pool interactions.
- Decimals: 18
- Website: https://qu.ai
- WQUAI
- Wrapped QUAI used by router and pair contracts.
- Quai address: 0x006C3e2AaAE5DB1bCd11A1a097cE572312EADdBB
- Decimals: 18
- WQI
- Wrapped Qi on Quai.
- Quai address: 0x002b2596EcF05C93a31ff916E8b456DF6C77c750
- Decimals: 18
- USDT
- Tether USD on Quai.
- Quai address: 0x0049F7cbCa3556C2DfaE62Aafa7015F99de1b8f5
- Decimals: 6
## Core Contracts
- Factory: 0x0018A110b6cA369DCf5Ab062C72F049E93B9eDe2
- Router: 0x000d6795e06eA4F460CA9572a51741342156305A
- PoolGauge: 0x0051f335c238dC8C69E2974000955d715292fCcB
- WQUAI: 0x006C3e2AaAE5DB1bCd11A1a097cE572312EADdBB
- WQI: 0x002b2596EcF05C93a31ff916E8b456DF6C77c750
- USDT: 0x0049F7cbCa3556C2DfaE62Aafa7015F99de1b8f5
- Multicall3: 0x00567637197E6554e2CF47a3988Cb7B819f4E92C
## Wallets
- Quai app actions use Pelagus through the app wallet button.
- Users should be on Quai Mainnet before swapping, adding liquidity, staking,
claiming, incentivizing, or bridging into Quai.
- Bridge actions may also require an EVM wallet for Base or Ethereum.
- For a bridge into Quai, the recipient must be a valid Quai address.
- Never ask users for seed phrases, private keys, or raw wallet files.
## Trading
- Link directly to /QUAI_WQI, /QUAI_USDT, or /WQI_USDT when
recommending a market.
- The UI may block swaps on pools below the configured TVL threshold when
VITE_SWAP_TVL_GUARD_ENABLED is enabled.
- Price charts and activity come from the Quainance subgraph.
## Liquidity And Incentives
- Liquidity page tabs are All Pools and My Positions.
- Pool rows expose Add LP, Stake LP, and Incentivize actions.
- LP fees are based on Uniswap v2-style swaps.
- Staked LP appears under My Positions with rewards and claim actions.
- PoolGauge reward tokens allowlisted at launch: WQUAI, WQI, USDT.
- A gauge must have non-zero staked LP before incentives are available.
## Bridge
The bridge page uses Symbiosis routes and direct wallet transactions.
Supported route families:
- Base QUAI to Quai WQUAI
- Ethereum QUAI to Quai WQUAI
- Ethereum USDT to Quai USDT
- Quai WQUAI to Base QUAI
- Quai WQUAI to Ethereum QUAI
- Quai USDT to Ethereum USDT
## Data Sources
- Chain RPC is configured with VITE_RPC_URL or VITE_MAINNET_RPC_URL.
- Indexed trading, liquidity, stats, activity, and candle data come from the
Quainance v2 subgraph configured with VITE_SUBGRAPH_URL or
VITE_MAINNET_SUBGRAPH_URL.
- The deployed subgraph name is quainance/v2.
- Public GraphQL queries should be sent only to the public query endpoint.
## Integration Guidance For Agents
- Prefer direct app URLs for user instructions.
- When discussing QUAI pools, explain that contracts use WQUAI while the UI
presents native QUAI.
- Confirm a wallet is connected before telling a user to swap, add LP, stake,
claim, incentivize, or bridge.
- For bridge guidance, verify the recipient chain and address type.
- For stats or chart issues, first check subgraph indexing and data freshness.
- Do not invent pool addresses, token addresses, APR values, balances, or
transaction status.
- Do not recommend sending funds directly to contracts unless the UI or contract
docs explicitly support that action.
## Developer Notes
- Source repo: quainance frontend.
- Framework: React, Vite, TypeScript, Tailwind.
- Package manager: yarn.
- Build command: yarn build.
- Deployment output: build/.
- Contract and interaction docs are in docs/contracts-and-interactions.md.
- Full production deployment runbook is in docs/prod-deploy.md.
- Indexer repo is separate: quainance-indexer.