@turtleclub/opportunities 0.1.0-beta.6 → 0.1.0-beta.60

package/CHANGELOG.md

@@ -3,6 +3,230 @@
 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.60](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.59...@turtleclub/opportunities@0.1.0-beta.60) (2026-01-27)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.59](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.58...@turtleclub/opportunities@0.1.0-beta.59) (2026-01-23)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.58](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.57...@turtleclub/opportunities@0.1.0-beta.58) (2026-01-23)
+
+### Features
+
+- native deposit section ([#231](https://github.com/turtle-dao/turtle-tools/issues/231)) ([b05278e](https://github.com/turtle-dao/turtle-tools/commit/b05278ee2eb7b77429e50140e08ca00eb6d2745d))
+
+# [0.1.0-beta.57](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.56...@turtleclub/opportunities@0.1.0-beta.57) (2026-01-21)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.56](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.55...@turtleclub/opportunities@0.1.0-beta.56) (2026-01-20)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.55](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.54...@turtleclub/opportunities@0.1.0-beta.55) (2026-01-20)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.54](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.53...@turtleclub/opportunities@0.1.0-beta.54) (2026-01-19)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.53](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.52...@turtleclub/opportunities@0.1.0-beta.53) (2026-01-19)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.52](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.51...@turtleclub/opportunities@0.1.0-beta.52) (2026-01-19)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.51](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.50...@turtleclub/opportunities@0.1.0-beta.51) (2026-01-16)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.50](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.49...@turtleclub/opportunities@0.1.0-beta.50) (2026-01-16)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.49](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.48...@turtleclub/opportunities@0.1.0-beta.49) (2026-01-16)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.48](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.47...@turtleclub/opportunities@0.1.0-beta.48) (2026-01-14)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.47](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.46...@turtleclub/opportunities@0.1.0-beta.47) (2026-01-14)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.46](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.45...@turtleclub/opportunities@0.1.0-beta.46) (2026-01-14)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.45](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.44...@turtleclub/opportunities@0.1.0-beta.45) (2026-01-13)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.44](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.43...@turtleclub/opportunities@0.1.0-beta.44) (2026-01-13)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.43](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.42...@turtleclub/opportunities@0.1.0-beta.43) (2026-01-13)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.42](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.41...@turtleclub/opportunities@0.1.0-beta.42) (2026-01-13)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.41](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.40...@turtleclub/opportunities@0.1.0-beta.41) (2026-01-13)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.40](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.39...@turtleclub/opportunities@0.1.0-beta.40) (2026-01-13)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.39](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.38...@turtleclub/opportunities@0.1.0-beta.39) (2026-01-12)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.38](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.37...@turtleclub/opportunities@0.1.0-beta.38) (2026-01-12)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.37](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.36...@turtleclub/opportunities@0.1.0-beta.37) (2026-01-09)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.36](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.35...@turtleclub/opportunities@0.1.0-beta.36) (2026-01-09)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.35](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.34...@turtleclub/opportunities@0.1.0-beta.35) (2026-01-09)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.34](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.33...@turtleclub/opportunities@0.1.0-beta.34) (2026-01-08)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.33](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.32...@turtleclub/opportunities@0.1.0-beta.33) (2026-01-08)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.32](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.31...@turtleclub/opportunities@0.1.0-beta.32) (2026-01-07)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.31](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.30...@turtleclub/opportunities@0.1.0-beta.31) (2026-01-07)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.30](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.29...@turtleclub/opportunities@0.1.0-beta.30) (2026-01-07)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.29](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.28...@turtleclub/opportunities@0.1.0-beta.29) (2026-01-07)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.28](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.27...@turtleclub/opportunities@0.1.0-beta.28) (2026-01-07)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.27](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.26...@turtleclub/opportunities@0.1.0-beta.27) (2026-01-07)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.26](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.25...@turtleclub/opportunities@0.1.0-beta.26) (2026-01-07)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.25](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.24...@turtleclub/opportunities@0.1.0-beta.25) (2026-01-06)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.24](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.23...@turtleclub/opportunities@0.1.0-beta.24) (2026-01-05)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.23](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.22...@turtleclub/opportunities@0.1.0-beta.23) (2026-01-02)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [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
+
+# [0.1.0-beta.19](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.18...@turtleclub/opportunities@0.1.0-beta.19) (2025-12-23)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.18](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.17...@turtleclub/opportunities@0.1.0-beta.18) (2025-12-23)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.17](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.16...@turtleclub/opportunities@0.1.0-beta.17) (2025-12-23)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.16](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.15...@turtleclub/opportunities@0.1.0-beta.16) (2025-12-23)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.15](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.14...@turtleclub/opportunities@0.1.0-beta.15) (2025-12-19)
+
+### Features
+
+- fix Nexus Cover Purchase. Detect if LP is a nexus member ([#203](https://github.com/turtle-dao/turtle-tools/issues/203)) ([9e05425](https://github.com/turtle-dao/turtle-tools/commit/9e05425f0315f93f27e4d6b01b72faeb15783163))
+
+# [0.1.0-beta.14](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.13...@turtleclub/opportunities@0.1.0-beta.14) (2025-12-17)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.13](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.12...@turtleclub/opportunities@0.1.0-beta.13) (2025-12-17)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.12](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.11...@turtleclub/opportunities@0.1.0-beta.12) (2025-12-16)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.11](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.10...@turtleclub/opportunities@0.1.0-beta.11) (2025-12-16)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.10](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.9...@turtleclub/opportunities@0.1.0-beta.10) (2025-12-12)
+
+### Features
+
+- rony/tur 588 create a reusable cover component ([#196](https://github.com/turtle-dao/turtle-tools/issues/196)) ([34a77b3](https://github.com/turtle-dao/turtle-tools/commit/34a77b3e4befc4bc5a4923f8e75694f7c980c280))
+
+# [0.1.0-beta.9](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.8...@turtleclub/opportunities@0.1.0-beta.9) (2025-12-10)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.8](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.7...@turtleclub/opportunities@0.1.0-beta.8) (2025-12-10)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.7](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.6...@turtleclub/opportunities@0.1.0-beta.7) (2025-12-09)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
 # [0.1.0-beta.6](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.5...@turtleclub/opportunities@0.1.0-beta.6) (2025-12-04)
 
 **Note:** Version bump only for package @turtleclub/opportunities

package/README.md

@@ -0,0 +1,179 @@
+# @turtleclub/opportunities
+
+React components for interacting with Turtle Club opportunities, including deposits, withdrawals, and transaction status tracking.
+
+## Installation
+
+```bash
+pnpm add @turtleclub/opportunities
+```
+
+## Components
+
+### NativeDepositSection
+
+A complete deposit interface component for opportunities that handles token selection, balance fetching, and deposit execution.
+
+#### Props
+
+```typescript
+interface NativeDepositSectionProps {
+  // Required
+  opportunity: Opportunity;              // The opportunity to deposit into
+  address: string | undefined;           // User's wallet address
+  distributorId: string;                 // Distributor ID for attribution
+  executeTransaction: (tx: TransactionRequest) => Promise<string | undefined>;
+
+  // Optional
+  onDepositSuccess?: () => void;         // Callback after successful deposit
+  tokenDisplayMode?: 'deposit-tokens' | 'all-chain-tokens';  // Default: 'deposit-tokens'
+  showZeroBalances?: boolean;            // Show tokens with 0 balance. Default: false
+  showExcludedTokens?: boolean;          // Show excluded/blacklisted tokens. Default: false
+  renderAssetSelector?: (props: AssetSelectorProps) => ReactNode;  // Custom token selector
+}
+```
+
+#### Token Display Modes
+
+- **`deposit-tokens`** (default): Only shows tokens from `opportunity.depositTokens`
+- **`all-chain-tokens`**: Shows all tokens on the chain that the user has balance for
+
+#### Basic Usage
+
+```tsx
+import { NativeDepositSection } from '@turtleclub/opportunities';
+import { useMultichainSendTransaction } from '@turtleclub/multichain';
+
+function DepositPage({ opportunity, address }) {
+  const { sendTransaction, waitForReceipt } = useMultichainSendTransaction();
+
+  const executeTransaction = async (tx) => {
+    const hash = await sendTransaction({
+      to: tx.to,
+      data: tx.data,
+      value: tx.value ? BigInt(tx.value) : undefined,
+    });
+    if (hash) await waitForReceipt(hash);
+    return hash;
+  };
+
+  return (
+    <NativeDepositSection
+      opportunity={opportunity}
+      address={address}
+      distributorId="your-distributor-id"
+      executeTransaction={executeTransaction}
+      onDepositSuccess={() => console.log('Deposit completed!')}
+    />
+  );
+}
+```
+
+#### With Custom Asset Selector
+
+```tsx
+import { NativeDepositSection, type AssetSelectorProps } from '@turtleclub/opportunities';
+
+function CustomAssetSelector({ tokens, selectedToken, onTokenChange, isLoading }: AssetSelectorProps) {
+  return (
+    <div className="custom-selector">
+      {tokens.map((token) => (
+        <button
+          key={token.address}
+          onClick={() => onTokenChange(token.address)}
+          className={selectedToken === token.address ? 'selected' : ''}
+        >
+          {token.symbol} - {token.balance}
+        </button>
+      ))}
+    </div>
+  );
+}
+
+function DepositPage({ opportunity, address }) {
+  return (
+    <NativeDepositSection
+      opportunity={opportunity}
+      address={address}
+      distributorId="your-distributor-id"
+      executeTransaction={executeTransaction}
+      renderAssetSelector={(props) => <CustomAssetSelector {...props} />}
+    />
+  );
+}
+```
+
+#### Show All Chain Tokens
+
+```tsx
+<NativeDepositSection
+  opportunity={opportunity}
+  address={address}
+  distributorId="your-distributor-id"
+  executeTransaction={executeTransaction}
+  tokenDisplayMode="all-chain-tokens"
+  showZeroBalances={true}
+/>
+```
+
+### Features
+
+- **Auto-selection**: Automatically selects the token with the highest balance
+- **Native token support**: Handles both ERC20 and native tokens (ETH, MATIC, etc.)
+- **USD value display**: Shows real-time USD equivalent of the amount
+- **Insufficient balance detection**: Validates balance before allowing deposit
+- **Max button**: Quick-fill maximum available balance
+- **Geo-blocking**: Integrates with GeoCheckBlocker for geographic restrictions
+- **Loading states**: Shows loading indicators while fetching balances
+
+### Dependencies
+
+This component uses the following hooks from `@turtleclub/hooks`:
+
+- `useGetOnChainBalance` - Fetches on-chain token balances
+- `useBalance` - Fetches consolidated balances from multiple sources
+- `useTokenBalance` - Calculates USD value and validates amounts
+- `useEarnDeposit` - Handles the deposit transaction flow
+
+## Other Components
+
+### GeoCheckBlocker
+
+Wraps content that should be blocked in certain geographic regions.
+
+### ConfirmButton
+
+Button component with confirmation state for critical actions.
+
+## Types
+
+```typescript
+// Re-exported from @turtleclub/hooks
+export type { Opportunity, TransactionRequest } from '@turtleclub/hooks';
+
+// Component-specific types
+export interface AssetSelectorProps {
+  tokens: SwapInputToken[];
+  selectedToken: string | undefined;
+  onTokenChange: (address: string) => void;
+  isLoading: boolean;
+}
+```
+
+## Testing
+
+The showcase app includes a testing page at `/actions` where you can:
+
+1. Connect a wallet (EVM, Solana, or TON)
+2. Test NativeDepositSection with different configurations
+3. Toggle between token display modes
+4. Test with zero balance visibility
+
+Run the showcase:
+
+```bash
+cd apps/showcase
+pnpm dev
+```
+
+Navigate to `http://localhost:3000/actions` to test the component.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@turtleclub/opportunities",
-  "version": "0.1.0-beta.6",
+  "version": "0.1.0-beta.60",
   "type": "module",
   "exports": {
     ".": "./src/index.ts"
@@ -9,20 +9,27 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@turtleclub/hooks": "0.5.0-beta.2",
-    "@turtleclub/ui": "0.7.0-beta.5",
+    "@nexusmutual/sdk": "^1.26.0",
+    "@tanstack/react-form": "^1.27.6",
+    "@tanstack/react-query": "^5.62.3",
+    "@tanstack/react-table": "^8.21.3",
+    "@turtleclub/hooks": "0.5.0-beta.43",
+    "@turtleclub/multichain": "0.5.0-beta.0",
+    "@turtleclub/ui": "0.7.0-beta.23",
     "@turtleclub/utils": "0.4.0-beta.0",
     "jotai": "^2.10.3",
-    "viem": "^2.21.54"
+    "lucide-react": "^0.542.0",
+    "viem": "^2.21.54",
+    "wagmi": "^2.15.6"
   },
   "peerDependencies": {
     "react": "^18.3.1",
     "react-dom": "^18.3.1"
   },
   "devDependencies": {
-    "@types/react": "^18.3.18",
+    "@types/react": "^19.1.1",
     "@types/react-dom": "^18.3.5",
     "typescript": "^5.7.2"
   },
-  "gitHead": "09d5d186b6253d8315b6e69aae3921d6850cddb2"
+  "gitHead": "ae345f4c4390594e945a1d39c719324620f981bc"
 }

package/src/components/index.ts

@@ -1 +1 @@
-export * from "./balances-data-table";
+// No exports - BalancesDataTable is now exported from ./deposit/components

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`