@turtleclub/opportunities 0.1.0-beta.0 → 0.1.0-beta.10

package/CHANGELOG.md

@@ -3,6 +3,48 @@
 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.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
+
+# [0.1.0-beta.5](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.4...@turtleclub/opportunities@0.1.0-beta.5) (2025-12-03)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.4](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.3...@turtleclub/opportunities@0.1.0-beta.4) (2025-12-03)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.3](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.2...@turtleclub/opportunities@0.1.0-beta.3) (2025-12-02)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.2](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.1...@turtleclub/opportunities@0.1.0-beta.2) (2025-11-28)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
+# [0.1.0-beta.1](https://github.com/turtle-dao/turtle-tools/compare/@turtleclub/opportunities@0.1.0-beta.0...@turtleclub/opportunities@0.1.0-beta.1) (2025-11-26)
+
+**Note:** Version bump only for package @turtleclub/opportunities
+
 # 0.1.0-beta.0 (2025-11-25)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@turtleclub/opportunities",
-  "version": "0.1.0-beta.0",
+  "version": "0.1.0-beta.10",
   "type": "module",
   "exports": {
     ".": "./src/index.ts"
@@ -9,10 +9,13 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@turtleclub/hooks": "0.5.0-beta.0",
-    "@turtleclub/ui": "0.7.0-beta.1",
+    "@nexusmutual/sdk": "^1.26.0",
+    "@turtleclub/hooks": "0.5.0-beta.5",
+    "@turtleclub/ui": "0.7.0-beta.6",
     "@turtleclub/utils": "0.4.0-beta.0",
+    "ethers": "^6.15.0",
     "jotai": "^2.10.3",
+    "lucide-react": "^0.542.0",
     "viem": "^2.21.54"
   },
   "peerDependencies": {
@@ -24,5 +27,5 @@
     "@types/react-dom": "^18.3.5",
     "typescript": "^5.7.2"
   },
-  "gitHead": "d896f0404e2bcb958a52def686e57893b4c68f6b"
+  "gitHead": "7afd1f23d40ef0617af745b33364e7c252c46b04"
 }

package/src/cover-offer/components/CoverOfferCard.tsx

@@ -0,0 +1,291 @@
+"use client";
+
+import { useState } from "react";
+import { Shield, ChevronDown, ChevronUp, type LucideProps } from "lucide-react";
+import type { ComponentType } from "react";
+import {
+  Button,
+  Slider,
+  Skeleton,
+  Checkbox,
+  Tooltip,
+  TooltipTrigger,
+  TooltipContent,
+} from "@turtleclub/ui";
+import { useCoverQuote } from "../hooks/useCoverQuote";
+import { getOpportunityAPY, calculateAdjustedAPY, formatAPY, formatEthAmount } from "../utils";
+import { NEXUS_KYC_REQUIREMENTS_URL, NEXUS_PROTOCOL_COVER_TERMS_URL } from "../constants";
+import type { CoverOfferCardProps } from "../types";
+const ShieldIcon = Shield as ComponentType<LucideProps>;
+const ChevronDownIcon = ChevronDown as ComponentType<LucideProps>;
+const ChevronUpIcon = ChevronUp as ComponentType<LucideProps>;
+
+export function CoverOfferCard({
+  productId,
+  opportunity,
+  amountToCover,
+  buyerAddress,
+  onPurchase,
+  onDismiss,
+  isPurchasing = false,
+  purchaseError,
+}: CoverOfferCardProps) {
+  const [isExpanded, setIsExpanded] = useState(true);
+  const [hasAgreedToTerms, setHasAgreedToTerms] = useState(false);
+
+  const { coverPeriod, setCoverPeriod, isLoading, error, quoteResult, premiumEth, yearlyCostPerc } =
+    useCoverQuote({
+      productId,
+      buyerAddress,
+      amountToCover,
+    });
+
+  const originalAPY = getOpportunityAPY(opportunity);
+  const adjustedAPY =
+    yearlyCostPerc !== null ? calculateAdjustedAPY(originalAPY, yearlyCostPerc) : null;
+  const coverCostPerc = yearlyCostPerc !== null ? yearlyCostPerc * 100 : null;
+
+  const handlePurchase = () => {
+    if (isPurchasing) return;
+    if (quoteResult) {
+      onPurchase(quoteResult, coverPeriod);
+    }
+  };
+
+  const disabledReason = (() => {
+    if (!hasAgreedToTerms) return "Checkbox not marked";
+    if (!quoteResult) return "Quote not ready yet";
+    if (isLoading) return "Fetching quote...";
+    if (error) return error;
+    if (isPurchasing) return "Purchasing cover...";
+    return null;
+  })();
+  const isPurchaseDisabled =
+    !quoteResult || isLoading || !!error || !hasAgreedToTerms || isPurchasing;
+
+  const purchaseButton = (
+    <Button
+      onClick={handlePurchase}
+      disabled={isPurchaseDisabled}
+      className="w-full"
+      variant="green"
+    >
+      {isLoading ? "Getting Quote..." : isPurchasing ? "Purchasing Cover..." : "Purchase Cover"}
+    </Button>
+  );
+
+  return (
+    <div className="rounded-xl  bg-gradient-to-br from-primary/10 to-card border border-primary/20 overflow-hidden">
+      <button
+        onClick={() => setIsExpanded(!isExpanded)}
+        className="w-full p-4 flex items-center justify-between hover:bg-primary/5 transition-colors"
+      >
+        <div className="flex items-center gap-3">
+          <div className="p-2 rounded-lg bg-primary/10 border border-primary/20">
+            <ShieldIcon className="w-5 h-5 text-primary" />
+          </div>
+          <div className="text-left">
+            <div className="flex items-center gap-2">
+              <span className="text-sm font-semibold text-foreground">Protect Your Deposit</span>
+              <span className="px-2 py-0.5 text-[10px] font-medium text-primary bg-primary/10 rounded-full border border-primary/20">
+                NEW
+              </span>
+            </div>
+            <p className="text-xs text-muted-foreground">Nexus Mutual Single Protocol Cover</p>
+          </div>
+        </div>
+        <div className="flex items-center gap-2">
+          {onDismiss && (
+            <Button
+              variant="ghost"
+              size="icon"
+              onClick={(e) => {
+                e.stopPropagation();
+                onDismiss();
+              }}
+              className="h-6 w-6 text-muted-foreground hover:text-foreground"
+            >
+              <svg className="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                <path
+                  strokeLinecap="round"
+                  strokeLinejoin="round"
+                  strokeWidth={2}
+                  d="M6 18L18 6M6 6l12 12"
+                />
+              </svg>
+            </Button>
+          )}
+          {isExpanded ? (
+            <ChevronUpIcon className="w-5 h-5 text-muted-foreground" />
+          ) : (
+            <ChevronDownIcon className="w-5 h-5 text-muted-foreground" />
+          )}
+        </div>
+      </button>
+
+      {/* Expandable Content */}
+      {isExpanded && (
+        <div className="px-4 pb-4 space-y-4">
+          {/* Value Proposition */}
+          <div className="p-3 rounded-lg bg-background/50 border border-border">
+            <p className="text-xs text-muted-foreground leading-relaxed">
+              <span className="text-primary font-medium">Safeguard your yield</span> against smart
+              contract exploits, oracle failures, and protocol-specific risks. Deposit with
+              confidence.
+            </p>
+          </div>
+
+          {/* APY Comparison */}
+          <div className="grid grid-cols-3 gap-3">
+            <div className="p-3 rounded-lg bg-background border border-border text-center">
+              <p className="text-[10px] uppercase tracking-wide text-muted-foreground mb-1">
+                Base APR
+              </p>
+              <p className="text-lg font-bold text-foreground">{formatAPY(originalAPY)}</p>
+            </div>
+            <div className="p-3 rounded-lg bg-background border border-border text-center">
+              <p className="text-[10px] uppercase tracking-wide text-muted-foreground mb-1">
+                Cover Cost
+              </p>
+              {isLoading ? (
+                <Skeleton className="h-7 w-12 mx-auto" />
+              ) : coverCostPerc !== null ? (
+                <>
+                  <p className="text-lg font-bold text-orange-400">-{coverCostPerc.toFixed(2)}%</p>
+                  <p className="text-[10px] text-muted-foreground">per year</p>
+                </>
+              ) : (
+                <p className="text-lg font-bold text-muted-foreground">—</p>
+              )}
+            </div>
+            <div className="p-3 rounded-lg bg-primary/5 border border-primary/20 text-center">
+              <p className="text-[10px] uppercase tracking-wide text-primary/70 mb-1">Net APY</p>
+              {isLoading ? (
+                <Skeleton className="h-7 w-12 mx-auto" />
+              ) : adjustedAPY !== null ? (
+                <>
+                  <p className="text-lg font-bold text-primary">{formatAPY(adjustedAPY)}</p>
+                  <p className="text-[10px] text-primary/60">protected</p>
+                </>
+              ) : (
+                <p className="text-lg font-bold text-muted-foreground">—</p>
+              )}
+            </div>
+          </div>
+
+          {/* Coverage Period Slider */}
+          <div className="space-y-3">
+            <div className="flex items-center justify-between">
+              <span className="text-xs text-muted-foreground">Coverage Period</span>
+              <span className="text-sm font-medium text-foreground">
+                {coverPeriod} days
+                {premiumEth && (
+                  <span className="text-muted-foreground ml-1">
+                    ({formatEthAmount(premiumEth)} ETH)
+                  </span>
+                )}
+              </span>
+            </div>
+            <Slider
+              value={[coverPeriod]}
+              onValueChange={(value) => setCoverPeriod(value[0])}
+              min={28}
+              max={365}
+              step={1}
+              className="w-full"
+            />
+            <div className="flex justify-between text-[10px] text-muted-foreground">
+              <span>28 days</span>
+              <span>365 days</span>
+            </div>
+          </div>
+
+          {/* Premium Details */}
+          <div className="flex items-center justify-between p-3 rounded-lg bg-background border border-border">
+            <div className="flex items-center gap-2">
+              <ShieldIcon className="w-4 h-4 text-primary" />
+              <span className="text-sm text-foreground">Premium</span>
+            </div>
+            {isLoading ? (
+              <Skeleton className="h-5 w-20" />
+            ) : premiumEth ? (
+              <span className="text-sm font-semibold text-foreground">
+                {formatEthAmount(premiumEth)} ETH
+              </span>
+            ) : error ? (
+              <span className="text-sm text-destructive">No cover available</span>
+            ) : (
+              <span className="text-sm text-muted-foreground">—</span>
+            )}
+          </div>
+
+          {/* Terms Agreement */}
+          <div className="space-y-3 p-3 rounded-lg bg-muted/20 border border-border ">
+            <p className="text-[10px] text-muted-foreground leading-relaxed">
+              By buying Nexus Mutual Bundled Protocol Cover, you agree to the{" "}
+              <a
+                href={NEXUS_PROTOCOL_COVER_TERMS_URL}
+                target="_blank"
+                rel="noopener noreferrer"
+                className="text-primary hover:text-primary/80 underline underline-offset-2"
+              >
+                terms
+              </a>{" "}
+              and{" "}
+              <a
+                href={NEXUS_PROTOCOL_COVER_TERMS_URL}
+                target="_blank"
+                rel="noopener noreferrer"
+                className="text-primary hover:text-primary/80 underline underline-offset-2"
+              >
+                conditions
+              </a>
+            </p>
+
+            <label className="flex items-start gap-2 cursor-pointer group">
+              <div className="relative flex-shrink-0 mt-0.5">
+                <Checkbox
+                  checked={hasAgreedToTerms}
+                  onCheckedChange={(hasAgreedToTerms) =>
+                    setHasAgreedToTerms(hasAgreedToTerms === true)
+                  }
+                />
+              </div>
+              <span className="text-[10px] text-muted-foreground leading-relaxed group-hover:text-foreground/70 transition-colors">
+                I confirm that I do not reside in the{" "}
+                <a
+                  href={NEXUS_KYC_REQUIREMENTS_URL}
+                  target="_blank"
+                  rel="noopener noreferrer"
+                  className="text-primary hover:text-primary/80 underline underline-offset-2"
+                  onClick={(e) => e.stopPropagation()}
+                >
+                  countries listed here
+                </a>
+                , and acknowledge that in the event of a loss, I will be required to join as a
+                member of Nexus Mutual to file my claim.
+              </span>
+            </label>
+          </div>
+
+          {/* Purchase Button */}
+          {disabledReason ? (
+            <Tooltip>
+              <TooltipTrigger asChild>
+                <div>{purchaseButton}</div>
+              </TooltipTrigger>
+              <TooltipContent side="top">{disabledReason}</TooltipContent>
+            </Tooltip>
+          ) : (
+            purchaseButton
+          )}
+          {Boolean(purchaseError) && (
+            <p className="text-[10px] text-destructive mt-1">
+              Failed to purchase cover. Please try again.
+            </p>
+          )}
+        </div>
+      )}
+    </div>
+  );
+}

package/src/cover-offer/components/CoverRequestForm.tsx

@@ -0,0 +1,152 @@
+"use client";
+
+import { useMemo, useState } from "react";
+import { Button } from "@turtleclub/ui";
+import { ShieldAlert, Send, ChevronDown, ChevronUp, type LucideProps } from "lucide-react";
+import type { ComponentType } from "react";
+
+const ShieldAlertIcon = ShieldAlert as ComponentType<LucideProps>;
+const SendIcon = Send as ComponentType<LucideProps>;
+const ChevronUpIcon = ChevronUp as ComponentType<LucideProps>;
+const ChevronDownIcon = ChevronDown as ComponentType<LucideProps>;
+
+export interface CoverRequestFormProps {
+  protocolName: string;
+  baseApyLabel?: string;
+  onDismiss?: () => void;
+  onSubmit?: (desiredApySacrifice: number | null) => void;
+}
+
+export function CoverRequestForm({
+  protocolName,
+  baseApyLabel,
+  onDismiss,
+  onSubmit,
+}: CoverRequestFormProps) {
+  const [desiredApySacrifice, setDesiredApySacrifice] = useState("");
+  const [inputError, setInputError] = useState<string | null>(null);
+  const [isExpanded, setIsExpanded] = useState(true);
+
+  const parsedSacrifice = useMemo(() => {
+    if (!desiredApySacrifice.trim()) return null;
+    const value = Number(desiredApySacrifice);
+    return Number.isFinite(value) ? value : null;
+  }, [desiredApySacrifice]);
+
+  const handleSubmit = () => {
+    if (desiredApySacrifice.trim() && parsedSacrifice === null) {
+      setInputError("Enter a valid non-negative number");
+      return;
+    }
+    if (parsedSacrifice !== null && parsedSacrifice < 0) {
+      setInputError("APY sacrifice cannot be negative");
+      return;
+    }
+    setInputError(null);
+
+    onSubmit?.(parsedSacrifice);
+
+    if (!onSubmit) {
+      // Basic placeholder to surface the interaction during integration.
+      console.info("Cover request submitted", {
+        desiredApySacrifice: parsedSacrifice,
+        protocolName,
+      });
+    }
+  };
+
+  return (
+    <div className="rounded-xl bg-gradient-to-br from-primary/5 to-card border border-primary/20">
+      <button
+        onClick={() => setIsExpanded(!isExpanded)}
+        className="w-full p-4 flex items-center justify-between hover:bg-primary/5 transition-colors"
+      >
+        <div className="flex items-center gap-3 text-left">
+          <div className="p-2 rounded-lg bg-primary/10 border border-primary/20">
+            <ShieldAlertIcon className="w-5 h-5 text-primary" />
+          </div>
+          <div className="space-y-1">
+            <p className="text-sm font-semibold text-foreground">
+              Request coverage for this opportunity
+            </p>
+            <p className="text-xs text-muted-foreground leading-relaxed">
+              We don&apos;t yet have Nexus Mutual cover available for{" "}
+              <span className="font-medium">{protocolName}</span>.
+            </p>
+          </div>
+        </div>
+        <div className="flex items-center gap-2">
+          {onDismiss && (
+            <Button
+              variant="ghost"
+              size="icon"
+              onClick={(e) => {
+                e.stopPropagation();
+                onDismiss();
+              }}
+              className="h-6 w-6 text-muted-foreground hover:text-foreground"
+            >
+              <svg className="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                <path
+                  strokeLinecap="round"
+                  strokeLinejoin="round"
+                  strokeWidth={2}
+                  d="M6 18L18 6M6 6l12 12"
+                />
+              </svg>
+            </Button>
+          )}
+          {isExpanded ? (
+            <ChevronUpIcon className="w-5 h-5 text-muted-foreground" />
+          ) : (
+            <ChevronDownIcon className="w-5 h-5 text-muted-foreground" />
+          )}
+        </div>
+      </button>
+
+      {isExpanded && (
+        <div className="p-4 space-y-4">
+          <div className="space-y-2">
+            <div className="flex items-center justify-between text-sm text-muted-foreground">
+              <span className="font-medium text-foreground">{protocolName}</span>
+              {baseApyLabel && <span>Current APR: {baseApyLabel}</span>}
+            </div>
+            <label className="text-xs text-muted-foreground">
+              APY you&apos;re willing to sacrifice for cover (percentage points)
+            </label>
+            <input
+              type="text"
+              value={desiredApySacrifice}
+              onChange={(e) => {
+                const sanitized = e.target.value.replace(/[^0-9.]/g, "");
+                setDesiredApySacrifice(sanitized);
+              }}
+              placeholder="e.g. 1.5"
+              className="w-full rounded-lg border border-border bg-background px-3 py-2 text-sm text-foreground focus:outline-none focus:ring-2 focus:ring-primary/30"
+            />
+            {inputError && <p className="text-[11px] text-destructive">{inputError}</p>}
+            <p className="text-[11px] text-muted-foreground">
+              We&apos;ll use this to gauge interest and bring cover to the protocols you care about.
+            </p>
+          </div>
+
+          <div className="flex justify-end gap-2">
+            {onDismiss && (
+              <Button
+                variant="ghost"
+                onClick={onDismiss}
+                className="text-muted-foreground hover:text-foreground"
+              >
+                Dismiss
+              </Button>
+            )}
+            <Button onClick={handleSubmit} className="flex items-center gap-2" variant="green">
+              <SendIcon className="w-4 h-4" />
+              Request Cover
+            </Button>
+          </div>
+        </div>
+      )}
+    </div>
+  );
+}

package/src/cover-offer/components/NexusCoverSection.tsx

@@ -0,0 +1,65 @@
+"use client";
+
+import type { NexusCoverSectionProps, NexusQuoteResult } from "../types";
+import { getOpportunityAPY, formatAPY } from "../utils";
+import { useNexusProduct } from "../hooks/useNexusProduct";
+import { useNexusPurchase } from "../hooks/useNexusPurchase";
+import { CoverOfferCard } from "./CoverOfferCard";
+import { CoverRequestForm } from "./CoverRequestForm";
+
+export function NexusCoverSection({
+  opportunity,
+  amountToCover,
+  buyerAddress,
+  onSuccess,
+  onError,
+  onDismiss,
+  className,
+}: NexusCoverSectionProps) {
+  const { isCoverable, productId, protocolName } = useNexusProduct(opportunity);
+  const baseApy = getOpportunityAPY(opportunity);
+
+  const {
+    purchase,
+    isPurchasing,
+    error: purchaseError,
+  } = useNexusPurchase({
+    buyerAddress,
+    productId: productId ?? 0,
+    amountToCover,
+    onSuccess: onSuccess,
+    onError: onError,
+  });
+
+  const handlePurchase = (quoteResult: NexusQuoteResult, coverPeriod: number) => {
+    return purchase(quoteResult, coverPeriod);
+  };
+
+  if (isCoverable && productId !== null) {
+    return (
+      <div className={className}>
+        <CoverOfferCard
+          productId={productId}
+          opportunity={opportunity}
+          amountToCover={amountToCover}
+          buyerAddress={buyerAddress}
+          onPurchase={handlePurchase}
+          isPurchasing={isPurchasing}
+          purchaseError={purchaseError}
+          onDismiss={onDismiss}
+        />
+      </div>
+    );
+  }
+
+  return (
+    <div className={className}>
+      <CoverRequestForm
+        protocolName={protocolName}
+        baseApyLabel={formatAPY(baseApy)}
+        onDismiss={onDismiss}
+        onSubmit={() => {}}
+      />
+    </div>
+  );
+}

package/src/cover-offer/constants.ts

@@ -0,0 +1,6 @@
+export const NEXUS_PROTOCOL_COVER_TERMS_URL =
+   "https://nexusmutual.io/pages/ProtocolCoverv1.0.pdf";
+
+export const NEXUS_KYC_REQUIREMENTS_URL =
+   "https://docs.nexusmutual.io/overview/membership/#kyc-requirements";
+

package/src/cover-offer/hooks/useCoverQuote.ts

@@ -0,0 +1,124 @@
+import { useState, useEffect, useCallback } from "react";
+import * as ethers from "ethers";
+import type { NexusQuoteResult, CoverQuoteState } from "../types";
+import { CoverAsset, NexusSDK } from "@nexusmutual/sdk";
+
+interface UseCoverQuoteOptions {
+   productId: number;
+   buyerAddress: string;
+   amountToCover: string;
+   /** Debounce delay in ms */
+   debounceMs?: number;
+}
+
+interface UseCoverQuoteReturn extends CoverQuoteState {
+   setCoverPeriod: (period: number) => void;
+   refetch: () => void;
+}
+
+let nexusSdkInstance: import("@nexusmutual/sdk").NexusSDK | null = null;
+let coverAssetEnum: typeof import("@nexusmutual/sdk").CoverAsset | null = null;
+
+const TERMS_IPFS_CID = "QmXUzXDMbeKSCewUie34vPD7mCAGnshi4ULRy4h7DLmoRS";
+
+async function getNexusSdk() {
+   if (!nexusSdkInstance || !coverAssetEnum) {
+      const { NexusSDK, CoverAsset } = await import("@nexusmutual/sdk");
+      nexusSdkInstance = new NexusSDK();
+      coverAssetEnum = CoverAsset;
+   }
+
+   return { nexusSdk: nexusSdkInstance, CoverAsset: coverAssetEnum };
+}
+
+
+async function fetchNexusQuote(
+   productId: number,
+   buyerAddress: string,
+   amount: string,
+   period: number
+): Promise<NexusQuoteResult> {
+
+   //const { nexusSdk, CoverAsset } = await getNexusSdk();
+   const nexusSdk = new NexusSDK();
+   const amountWei = ethers.parseEther(amount).toString();
+
+   const { result, error } = await nexusSdk.quote.getQuoteAndBuyCoverInputs({
+      productId,
+      amount: amountWei,
+      period,
+      coverAsset: CoverAsset.ETH,
+      paymentAsset: CoverAsset.ETH,
+      buyerAddress,
+      ipfsCidOrContent: TERMS_IPFS_CID,
+   });
+
+   if (error) {
+      throw new Error(error.message || "Failed to fetch Nexus quote");
+   }
+
+   return result as NexusQuoteResult;
+}
+
+export function useCoverQuote({
+   productId,
+   buyerAddress,
+   amountToCover,
+   debounceMs = 500,
+}: UseCoverQuoteOptions): UseCoverQuoteReturn {
+   const [coverPeriod, setCoverPeriod] = useState(30);
+   const [isLoading, setIsLoading] = useState(false);
+   const [error, setError] = useState<string | null>(null);
+   const [quoteResult, setQuoteResult] = useState<NexusQuoteResult | null>(null);
+   const [premiumEth, setPremiumEth] = useState<string | null>(null);
+   const [yearlyCostPerc, setYearlyCostPerc] = useState<number | null>(null);
+
+   const fetchQuote = useCallback(async () => {
+      console.log("fetchQuote", productId, buyerAddress, amountToCover, coverPeriod);
+      if (!productId || !buyerAddress || !amountToCover || parseFloat(amountToCover) <= 0) {
+         console.error("Validation failed", productId, buyerAddress, amountToCover, coverPeriod);
+         return;
+      }
+
+      setIsLoading(true);
+      setError(null);
+
+      try {
+         const result = await fetchNexusQuote(productId, buyerAddress, amountToCover, coverPeriod);
+
+         setQuoteResult(result);
+         setPremiumEth(ethers.formatEther(result.displayInfo.premiumInAsset));
+         setYearlyCostPerc(result.displayInfo.yearlyCostPerc);
+      } catch (err: unknown) {
+         const errorMessage = err instanceof Error ? err.message : "Failed to fetch quote";
+         console.error("Cover quote error:", err);
+         setError(errorMessage);
+         setQuoteResult(null);
+         setPremiumEth(null);
+         setYearlyCostPerc(null);
+      } finally {
+         setIsLoading(false);
+      }
+   }, [productId, buyerAddress, amountToCover, coverPeriod]);
+
+   // Debounced fetch on input changes
+   useEffect(() => {
+      const timeoutId = setTimeout(() => {
+         fetchQuote();
+      }, debounceMs);
+
+      return () => clearTimeout(timeoutId);
+   }, [fetchQuote, debounceMs]);
+
+   return {
+      coverPeriod,
+      setCoverPeriod,
+      isLoading,
+      error,
+      quoteResult,
+      premiumEth,
+      yearlyCostPerc,
+      refetch: fetchQuote,
+   };
+}
+

package/src/cover-offer/hooks/useNexusProduct.ts

@@ -0,0 +1,74 @@
+import { useMemo } from "react";
+import { products, ProductTypes } from "@nexusmutual/sdk";
+import type { Opportunity } from "@turtleclub/hooks";
+import { NexusProduct } from "../types";
+
+const getHighestPriorityProduct = (
+   currentBest: NexusProduct | null,
+   newProduct: NexusProduct,
+): boolean => {
+   // Prefer v3 products, and for v3 prefer the highest id
+   if (newProduct.name.includes("v3") && currentBest && !currentBest.name.includes("v3")) {
+      return true;
+   }
+
+   if (newProduct.name.includes("v3") && currentBest?.name.includes("v3") && newProduct.id > currentBest.id) {
+      return true;
+   }
+
+   if (!currentBest) {
+      return true;
+   }
+
+   return false;
+};
+
+const NEXUS_PRODUCT_MAP: Record<string, NexusProduct> = products
+   .filter((x) => !x.isDeprecated && !x.isPrivate && x.productType === ProductTypes.singleProtocol)
+   .reduce((acc: Record<string, NexusProduct>, product: any) => {
+      const protocolNameMatch = product.name.match(/^(\w+)/);
+      const protocolName = protocolNameMatch ? protocolNameMatch[1].toLowerCase() : null;
+
+      if (!protocolName) {
+         return acc;
+      }
+
+      const currentBest = acc[protocolName] || null;
+
+      if (getHighestPriorityProduct(currentBest, product)) {
+         acc[protocolName] = {
+            id: product.id,
+            name: product.name,
+            coverAssets: product.coverAssets,
+         };
+      }
+      return acc;
+   }, {});
+
+export const getProtocolForInsurance = (opportunity: Opportunity | null | undefined) => {
+   return opportunity?.vaultConfig?.infraProvider?.name ?? null;
+};
+
+export const getNexusProductLookup = (opportunity: Opportunity | null | undefined) => {
+   const protocolName = getProtocolForInsurance(opportunity);
+   const nexusProduct = protocolName ? NEXUS_PRODUCT_MAP[protocolName.toLowerCase()] : null;
+
+   return {
+      protocolName: protocolName ?? "Unknown",
+      productId: nexusProduct?.id ?? null,
+      coverProductName: nexusProduct?.name ?? null,
+      isCoverable: !!nexusProduct,
+   };
+};
+
+export interface NexusProductLookup {
+   protocolName: string;
+   productId: number | null;
+   coverProductName: string | null;
+   isCoverable: boolean;
+}
+
+export function useNexusProduct(opportunity: Opportunity | null | undefined): NexusProductLookup {
+   return useMemo(() => getNexusProductLookup(opportunity), [opportunity]);
+}
+

package/src/cover-offer/hooks/useNexusPurchase.ts

@@ -0,0 +1,94 @@
+import { useCallback, useState } from "react";
+import nexusSdk from "@nexusmutual/sdk";
+import * as ethers from "ethers";
+import type { NexusQuoteResult } from "../types";
+
+type UseNexusPurchaseArgs = {
+   buyerAddress: string;
+   productId: number;
+   amountToCover: string;
+   onSuccess?: (result: NexusPurchaseResult) => void;
+   onError?: (error: unknown) => void;
+};
+
+type NexusPurchaseTxRequest = {
+   to: `0x${string}`;
+   data: `0x${string}`;
+   value: bigint;
+   account?: `0x${string}`;
+};
+
+type NexusPurchaseResult = {
+   txRequest: NexusPurchaseTxRequest;
+   quoteResult: NexusQuoteResult;
+   meta: {
+      buyerAddress: string;
+      productId: number;
+      amountToCover: string;
+      coverPeriod: number;
+   };
+};
+
+type UseNexusPurchaseReturn = {
+   purchase: (quoteResult: NexusQuoteResult, coverPeriod: number) => Promise<NexusPurchaseResult>;
+   isPurchasing: boolean;
+   error: unknown | null;
+   result: NexusPurchaseResult | null;
+};
+
+/** Encapsulate Nexus buyCover prep to mirror executeNexusTransaction flow */
+export function useNexusPurchase(args: UseNexusPurchaseArgs): UseNexusPurchaseReturn {
+   const { buyerAddress, productId, amountToCover, onSuccess, onError } = args;
+   const [isPurchasing, setIsPurchasing] = useState(false);
+   const [error, setError] = useState<unknown | null>(null);
+   const [result, setResult] = useState<NexusPurchaseResult | null>(null);
+
+   const purchase = useCallback(
+      async (quoteResult: NexusQuoteResult, coverPeriod: number) => {
+         try {
+            setIsPurchasing(true);
+            setError(null);
+
+            const { buyCoverParams, poolAllocationRequests } = quoteResult.buyCoverInput;
+            const coverBrokerInterface = new ethers.Interface(nexusSdk.abis?.CoverBroker);
+            const data = coverBrokerInterface.encodeFunctionData("buyCover", [
+               buyCoverParams,
+               poolAllocationRequests,
+            ]);
+
+            const txRequest: NexusPurchaseTxRequest = {
+               to: nexusSdk.addresses?.CoverBroker as `0x${string}`,
+               data: data as `0x${string}`,
+               value: BigInt(quoteResult.displayInfo.premiumInAsset),
+               account: buyerAddress as `0x${string}`,
+            };
+
+            const purchaseResult: NexusPurchaseResult = {
+               txRequest,
+               quoteResult,
+               meta: {
+                  buyerAddress,
+                  productId,
+                  amountToCover,
+                  coverPeriod,
+               },
+            };
+
+            setResult(purchaseResult);
+            onSuccess?.(purchaseResult);
+            return purchaseResult;
+         } catch (err) {
+            setError(err);
+
+            onError?.(err);
+            throw err;
+         } finally {
+            setIsPurchasing(false);
+         }
+      },
+      [amountToCover, buyerAddress, onError, onSuccess, productId]
+   );
+
+   return { purchase, isPurchasing, error, result };
+}
+

package/src/cover-offer/index.ts

@@ -0,0 +1,6 @@
+export { NexusCoverSection } from "./components/NexusCoverSection";
+export type { NexusCoverSectionProps, NexusQuoteResult } from "./types";
+
+export { useCoverQuote } from "./hooks/useCoverQuote";
+export { useNexusPurchase } from "./hooks/useNexusPurchase";
+export { useNexusProduct, getNexusProductLookup, getProtocolForInsurance } from "./hooks/useNexusProduct";

package/src/cover-offer/types/index.ts

@@ -0,0 +1,49 @@
+import type { Opportunity } from "@turtleclub/hooks";
+
+/** Result from Nexus SDK quote API */
+export interface NexusQuoteResult {
+   buyCoverInput: {
+      buyCoverParams: unknown;
+      poolAllocationRequests: unknown;
+   };
+   displayInfo: {
+      premiumInAsset: string;
+      yearlyCostPerc: number;
+   };
+}
+export type NexusProduct = {
+   id: number;
+   name: string;
+   coverAssets: number[];
+};
+
+export interface CoverOfferCardProps {
+   productId: number;
+   opportunity: Opportunity;
+   amountToCover: string;
+   buyerAddress: string;
+
+   onPurchase: (quoteResult: NexusQuoteResult, coverPeriod: number) => void;
+   isPurchasing?: boolean;
+   purchaseError?: unknown;
+
+   onDismiss?: () => void;
+}
+
+export interface CoverQuoteState {
+   isLoading: boolean;
+   error: string | null;
+   quoteResult: NexusQuoteResult | null;
+   coverPeriod: number;
+   premiumEth: string | null;
+   yearlyCostPerc: number | null;
+}
+export interface NexusCoverSectionProps {
+   opportunity: Opportunity;
+   amountToCover: string;
+   buyerAddress: string;
+   onSuccess: (res: any) => void;
+   onError: (err: any) => void;
+   onDismiss?: () => void;
+   className?: string;
+}

package/src/cover-offer/utils/index.ts

@@ -0,0 +1,45 @@
+import type { Opportunity } from "@turtleclub/hooks";
+
+/**
+ * Calculate the total APY from an opportunity's incentives
+ */
+export function getOpportunityAPY(opportunity: Opportunity): number {
+   if (!opportunity.incentives || opportunity.incentives.length === 0) {
+      return 0;
+   }
+
+   return opportunity.incentives.reduce((total, incentive) => {
+      return total + (incentive.yield ?? 0);
+   }, 0);
+}
+
+/**
+ * Calculate the adjusted APY after subtracting the cover cost
+ * @param opportunityAPY - The original APY as a percentage (e.g., 5 for 5%)
+ * @param yearlyCostPerc - The yearly cost as a decimal (e.g., 0.025 for 2.5%)
+ * @returns The adjusted APY as a percentage
+ */
+export function calculateAdjustedAPY(
+   opportunityAPY: number,
+   yearlyCostPerc: number
+): number {
+   const coverCostPercentage = yearlyCostPerc * 100;
+   return Math.max(0, opportunityAPY - coverCostPercentage);
+}
+
+/**
+ * Format APY for display
+ */
+export function formatAPY(apy: number): string {
+   return `${apy.toFixed(2)}%`;
+}
+
+/**
+ * Format ETH amount for display
+ */
+export function formatEthAmount(amount: string, decimals: number = 6): string {
+   const num = parseFloat(amount);
+   if (isNaN(num)) return "0";
+   return num.toFixed(decimals);
+}
+

package/src/index.ts

@@ -7,6 +7,9 @@ export * from "./deposit";
 // Transaction Status
 export * from "./transaction-status";
 
+// Cover Offer
+export * from "./cover-offer";
+
 // Opportunity Table
 export * from "./opportunity-table/components";