@turtleclub/opportunities 0.1.0-beta.20 → 0.1.0-beta.22

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [0.1.0-beta.22](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.21...@turtleclub/opportunities@0.1.0-beta.22) (2025-12-31)
+
+### Features
+
+- support USDC and cbBTC cover tokens, persist cover requests, migrate to React Query ([#209](https://github.com/turtle-dao/turtle-tools/issues/209)) ([c225999](https://github.com/turtle-dao/turtle-tools/commit/c225999f1b913e15af6fd7956242097897d5d8ce))
+
+# [0.1.0-beta.21](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.20...@turtleclub/opportunities@0.1.0-beta.21) (2025-12-31)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
 # [0.1.0-beta.20](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.19...@turtleclub/opportunities@0.1.0-beta.20) (2025-12-30)
 
 **Note:** Version bump only for package @turtleclub/opportunities

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@turtleclub/opportunities",
-  "version": "0.1.0-beta.20",
+  "version": "0.1.0-beta.22",
   "type": "module",
   "exports": {
     ".": "./src/index.ts"
@@ -10,8 +10,11 @@
   },
   "dependencies": {
     "@nexusmutual/sdk": "^1.26.0",
-    "@turtleclub/hooks": "0.5.0-beta.12",
-    "@turtleclub/ui": "0.7.0-beta.9",
+    "@tanstack/react-form": "^1.27.6",
+    "@tanstack/react-query": "^5.62.3",
+    "@turtleclub/hooks": "0.5.0-beta.14",
+    "@turtleclub/multichain": "0.4.0",
+    "@turtleclub/ui": "0.7.0-beta.10",
     "@turtleclub/utils": "0.4.0-beta.0",
     "jotai": "^2.10.3",
     "lucide-react": "^0.542.0",
@@ -27,5 +30,5 @@
     "@types/react-dom": "^18.3.5",
     "typescript": "^5.7.2"
   },
-  "gitHead": "aa9845b493cc2633e82bb9f94d76a9bc117af7fb"
+  "gitHead": "1c079d74e9530d05b212ee03ee221e668ae3ce96"
 }

package/src/cover-offer/README.md

@@ -0,0 +1,46 @@
+# Cover Offer Module
+
+Provides Nexus Mutual protocol cover integration for DeFi opportunities.
+
+## Component Structure
+
+```
+NexusCoverSection (entry point)
+├── CoverOfferCard      → Protocol is coverable (handles membership inline)
+│   ├── CoveredEventsInfo     → Displays covered events and exclusions
+│   ├── ExistingCoverInfo     → Shows existing cover details
+│   └── PurchaseButtonSection → Handles network switch, membership, approval, and purchase
+└── CoverRequestForm    → Protocol not yet coverable (interest form)
+```
+
+### Display Logic
+
+| Condition                    | Component Shown    |
+| ---------------------------- | ------------------ |
+| Protocol coverable           | `CoverOfferCard`   |
+| Protocol NOT coverable       | `CoverRequestForm` |
+| Protocol unknown / no wallet | Nothing            |
+
+If the user is not a Nexus member, `CoverOfferCard` displays a "Become a Member" prompt via `PurchaseButtonSection`.
+
+## Hooks
+
+| Hook                      | Description                              | Data Source                                   |
+| ------------------------- | ---------------------------------------- | --------------------------------------------- |
+| `useNexusProduct`         | Maps opportunity to Nexus product ID     | `@nexusmutual/sdk` products list              |
+| `useCheckNexusMembership` | Checks if user is Nexus member           | `NXMaster.isMember()` contract call           |
+| `useCoverQuote`           | Fetches cover quote for given params     | Nexus SDK `quote.getQuoteAndBuyCoverInputs()` |
+| `useNexusPurchase`        | Handles cover purchase transaction       | `Cover.buyCover()` contract call              |
+| `useExistingCovers`       | Gets user's active covers                | `CoverViewer.getCovers()` contract call       |
+| `useUserCoverNfts`        | Fetches user's cover NFTs                | Turtle API `/nfts` endpoint                   |
+| `useCoverTokenSelection`  | Manages token selection for cover payment| User portfolio balance                        |
+| `useTokenApproval`        | Handles ERC20 token approval flow        | ERC20 `allowance()` / `approve()` calls       |
+| `useDebouncedValue`       | Debounces input values                   | Local state                                   |
+
+## Testing
+
+The `apps/turtle-cover` MVP is designed for testing this package.
+
+You can run it with
+
+`bun run dev --filter=@turtle/cover`