How 1inch/spot-price-aggregator works
Project type and purpose
• This is an open‑source, off‑chain “Spot Price Aggregator” for blockchain tokens.
• It consists of Solidity smart contracts (oracles, wrappers, multi‑wrapper, offchain oracle) plus deployment scripts, client examples, tests, docs, and CI pipelines.
• Its job: off‑chain code queries a set of on‑chain contracts to fetch and aggregate DEX prices, applying wrappers (e.g., wETH, cDAI) and connectors (intermediate tokens) when no direct pair exists.
File structure
• contracts/
– oracles/ : per‑DEX pricing modules (Uniswap, Curve, Chainlink, etc.)
– wrappers/ : token‑wrap adapters (Aave, Compound, ERC‑4626, custom)
– MultiWrapper.sol : orchestrates wrappers
– OffchainOracle.sol : entry point aggregator contract
• deploy/ + deployments/ : Hardhat scripts and per‑network JSON addresses
• scripts/ + examples/ : off‑chain Node.js Ethers.js clients to call the aggregator
• test/ : JavaScript tests for oracles, wrappers, aggregator
• docs/ : Markdown descriptions and interface specs
• hardhat.config.js, migrations/, .github/workflows : build, test, CI/CD
README for additional insights
• Readme explains core modules: “Wrappers,” “Connectors,” “Supported DEXes,” “Examples,” and “Oracle Deployment Guide.”
• Highlights that usage is off‑chain: client code calls OffchainOracle.readPrice(…) which in turn invokes on‑chain oracles and wrappers.
• Deployment scripts register networks, deploy contracts, and populate deployments/ with addresses per chain.
Elements
• Blue: on‑chain contract modules
• Green: off‑chain client & scripts
• Orange: deployment pipeline
• Gray: external services (DEXes, RPC)