89: Add EvelynLiquidityService to withdraw CLMM proceeds, swap to USDC and send payouts

2026-10-04 11:20:29 +02:00
parent e8d4dbe7ae
commit 7dfd43dfd7
27 changed files with 1854 additions and 24 deletions
@@ -0,0 +1,25 @@
+# Tasks
+
+## 1. Protected Raydium withdrawal
+
+- [x] 1.1 Add exact CLMM tick, eligibility and raw principal math; verify official boundary fixtures, equality and inversion.
+- [x] 1.2 Add full decrease operation with owner/account validation, slippage and retained NFT; verify captured transaction bytes with offline fixtures and document API/source references.
+
+## 2. Liquidity service and deployment configuration
+
+- [x] 2.1 Add versioned strict configuration and zero-reserve public template; verify invalid ranges, addresses, precision, duplicate/unknown keys and missing-file behavior.
+- [x] 2.2 Implement independent withdrawal/swap/payout steps and sequential interruptible lifecycle; verify reserves, failure/restart recovery, empty/foreign positions, price decline, no overlap and shutdown using controlled dependencies.
+- [x] 2.3 Document configuration, dedicated signer/SOL requirements and pipeline/recovery behavior; inspect documentation against issue #89.
+
+## 3. Hub integration and overall validation
+
+- [x] 3.1 Lazily register the optional process and dedicated wallet/Jupiter/direct Raydium dependencies; verify optional selection preserves existing startup plan and checked-in example inactivity.
+- [x] 3.2 Compile main/verification sources, run affected offline tests, validate OpenSpec strictly and run git diff --check; record results without live financial operations, commits or pushes.
+
+## Verification result (2026-10-04)
+
+- Main and verification compilation passed with JavaFX JDK 25 and Gradle 9.6.1.
+- All 34 repository JUnit tests passed (25 liquidity/math/withdrawal/Hub tests and 9 existing tests); no failures, errors or skips.
+- Strict OpenSpec change validation passed; git diff --check and new-file whitespace checks passed.
+- Public mainnet inspection was read-only. All financial operation verification used controlled offline dependencies; no live withdrawal, swap, transfer, signer invocation, commit or push.
+- Runtime configuration contains deployment placeholders and is ignored by Git. Both example reserves are zero; the Hub runtime selection and checked-in Hub example are unchanged.