Secure, upgradeable asset-recovery and controlled withdrawal system for Base network.

SafeReturn provides a trustworthy, governance-aware mechanism for managing protected funds, delayed withdrawals, automated recovery logic, and USDC payouts through Base Pay integration.

• WithdrawalRequestModule: Request management with timelock mechanics
• ApprovalModule: Multi-role approval system with threshold-based logic
• TreasuryModule: USDC vault with Base Pay integration
• RecoveryModule: Emergency freeze/thaw state machine
• UpgradeModule: UUPS upgradeable pattern for long-term maintainability

• Owner: Contract owner with upgrade rights
• Admin: Can approve requests and manage thresholds
• Guardian: Emergency recovery and vault freeze capabilities
• Executor: Execute approved withdrawals

forge build
forge test

forge script script/DeploySafeReturn.s.sol --rpc-url base-sepolia --broadcast

• Timelock-protected withdrawals
• Multi-signature approval system
• Fast-track mode for small amounts
• Emergency vault freeze
• UUPS upgradeable proxies
• Base network optimized

• Proxy: 0x24766824e574A438C9c3BFf370755B627e600B3E
• Implementation: 0xA74062ae0B7A071627130b1A0C543B411982b5bD
• Status: ✅ Verified

See deployments directory for detailed configuration and testing commands.

forge test -vv

All contracts upgradeable using UUPS with strict access controls.

MIT