How 1inch/limit-order-protocol works
Project type and purpose
• This is an on-chain smart-contract protocol project (1inch Limit Order Protocol) designed to let users create, sign (off-chain) and fill (on-chain) limit orders on EVM-compatible chains.
• It is not a full-stack web app: it is a Solidity codebase with deployment scripts, multiple‐chain artifacts, docs and TypeScript utilities for signing orders.
File structure
• Top-level:
• /contracts – Solidity code organized into
– extensions (plug-in extension modules)
– helpers (reusable on-chain utilities)
– interfaces (EIP-712, token standards)
– libraries (pure on-chain libraries for math, state management)
– mocks (for local testing)
• /deploy & /deployments – Hardhat deployment scripts & per-chain JSON artifacts
• hardhat.config.js & package.json – build/test toolchain
• /test – JavaScript tests exercising the protocol, examples and utilities
• /docs & description.md – markdown documentation of core concepts, extensions, helpers
• README.md – project overview, feature list, supported chains
• CI/CD: GitHub Actions workflows in .github/workflows/test.yml
• Utilities: An external TypeScript “limit-order-protocol-utils” library referenced
README for additional insights
• Purpose: off-chain limit-order creation (EIP-712) + on-chain filling
• Key components: LimitOrderProtocol core contract, feeTaker, order registrator, WETH unwrapper, extension mechanism, epoch & nonce managers
• Supports many chains via per-chain deployment configs
Essential elements
• Clear labels for each component (e.g., “LimitOrderProtocol”, “Extension: DutchAuctionCalculator”)
• Green for off-chain tools
• Orange for CI/CD
• Gray for networks