How resolv-im/resolv-contracts-public works
Project type and purpose
• This is a suite of Ethereum smart-contracts (Solidity) implementing a DeFi protocol (“Resolv”) that issues and manages ERC-20 tokens (USR, RLP, stUSR, wstUSR), interacts with external liquidity protocols (Aave, Dinero, Lido), collects price data via on-chain oracles, enforces a whitelist, handles redemption and requests, and distributes rewards.
File structure
• Top-level:
• README.md — project overview, deployed addresses, audit history
• contracts/ — all Solidity code
• contracts/interfaces/external/…
• aave, dinero, lido, oracles — interfaces to external protocols and on-chain price sources
• contracts/oracles/ — implementations of price storage contracts
• Other modules implied by README (not in tree): connectors, request managers, treasury, reward distributor
README for additional insights
• Lists all core contracts and their roles (ERC20 tokens, Whitelist, RequestsManager, RewardDistributor).
a. Main components:
1. ERC20 Tokens module (USR, RLP, stUSR, wstUSR)
2. Requests Managers (USRRequestsManager, RLPRequestsManager, externalRequestsManager)
3. Treasury & Connectors (Treasury, AaveV3TreasuryConnector, DineroTreasuryConnector, LidoTreasuryConnector)
4. Oracles & PriceStorage (UsrPriceStorage, RlpPriceStorage)
5. Whitelist module
6. RewardDistributor
7. External Services (Aave, Dinero, Lido, Chainlink oracles)
b. Relationships & interactions:
• Users → (whitelisted) → RequestsManager → mints/burns ERC20 tokens
• RequestsManager ↔ TreasuryConnectors → external DeFi protocols (lend/borrow, stake)
• Oracles pull price data from external on-chain sources → PriceStorage contracts
• RewardDistributor reads balances & price data → issues rewards to token holders
c. Architectural patterns:
• Modular “Connector” pattern: isolates each external protocol behind an interface
• Separation of concerns: token logic, treasury logic, oracle logic, reward logic, access control via Whitelist
• Upgradable vs. non-upgradable components (see “Upgradeable” suffix in contracts)
d. Key technologies & libraries:
• Solidity, ERC20 (OpenZeppelin)
• Hardhat/Truffle (implied), Etherscan verification
• On-chain oracles (Chainlink or custom oracle feeds)