IntentSwap is an on-chain conditional swap protocol where users define swap intents (for example, “swap when price > X”), and any executor can fill them once conditions are met.

Instead of manually timing the market, users specify what they want. Execution is permissionless by design, with a production-ready bot as the default executor.

🚀 What it does

• Create intents with token pair, amount, price threshold, and expiration
• Execute intents through IntentExecutor with protocol fee + executor reward
• Use Chainlink price feeds for on-chain condition checks
• Route swaps through Uniswap V3 with slippage protection
• Index intent events into Postgres for fast query and dashboard UX

🔄 How it works (high-level)

1. User creates intent on-chain via IntentFactory.createIntent()
2. apps/pipes indexes on-chain events (create/update/execute/cancel) into Postgres
3. apps/api serves GraphQL queries and auth-backed endpoints for the web app
4. apps/bot monitors subscribed intents and calls executeIntent(intentId) when fillable
5. Contracts validate price/expiry and perform swap via Uniswap V3

🏗️ Architecture

🛠️ Tech Stack

✨ Highlights

• Permissionless execution model: protocol allows any executor; bot is just default infra
• End-to-end data flow: on-chain events -> indexer -> Postgres -> GraphQL -> web dashboard
• Production-oriented monorepo: shared auth/db/artifacts packages across all apps
• Safer execution path: oracle-backed checks, slippage control, and pausable executor contract