Skip to content

TODO.yield.md

Latest commit

 

History

History
36 lines (28 loc) · 2.46 KB

TODO.yield.md

File metadata and controls

36 lines (28 loc) · 2.46 KB
Raw

Roadmap: Automated Yield Settlement Layer (Riquid Integration)

This roadmap outlines the integration of the Riquid Self-Driving Yield Engine into the SettlerEngine hexagonal architecture.

Phase 1: Domain Modeling & Port Definitions (core/domain) 🏗️

  • Define YieldStrategy Entity
  • Define YieldProvider Port (Interface)
  • Update SettlementEngine Port: Add DepositToYield and WithdrawFromYield methods.

Phase 2: BSC Infrastructure & Adapters (pkg/chains) ⛓️

  • BSC RPC Provider: Implement a Geth-compatible provider for BNB Smart Chain (BSC).
  • Asset Support: Add configuration and tracking for BNB, USDT (BEP-20), and BUSD.
  • Contract Bindings: Generate Go ABIs/bindings for Riquid Vaults.

Phase 3: Riquid Driven Adapter (pkg/yield) 💸

  • riquid_adapter.go: Implementation of the YieldProvider interface for Riquid Yield Engine using generated bindings.
  • Withdrawal Logic: Implement WithdrawFromYield method.
  • State Machine Integration: Logic to encode/decode calls to Riquid strategy contracts via bindings.

Phase 4: Self-Driving Yield Automation (core/domain/service) 🤖

  • Auto-Route Service: Implementation of routing logic upon SETTLEMENT_CONFIRMED events.
  • Threshold Logic: Implement gas-efficiency triggers to prevent micro-transactions.
  • Cron Worker: Develop a "Self-Driving" background worker for periodic harvesting and reinvestment.
  • Event Bus Wiring: Settlement events are now published via LocalBus and consumed by YieldService.

Phase 5: Account Abstraction & Session Keys (pkg/crypto & pkg/yield) 🔐

  • ERC-4337 Integration: Logic to manage funds via non-custodial account abstraction (Provider + UserOps).
  • Session Key Manager: Sign "Harvest" and "Reinvest" transactions using restricted-scope keys.
  • Paymaster Integration: Support for gas sponsorship on BSC via Paymaster client.

Phase 6: Observability & Validation (pkg/metrics) 📊

  • Prometheus Metrics: Track APY performance, total value locked (TVL) in yield, and "Time-to-Settle".
  • Integration Tests & Wiring: End-to-end wiring in settlerd, unit tests for yield logic, and event-driven routing tests.

Core Requirement: All implementations must maintain the Non-Custodial nature of SettlerEngine. Automation must be achieved through cryptographic delegation (Session Keys), not centralized management.