From 6562ad1a033de3d9f006ed14344787319ae678fd Mon Sep 17 00:00:00 2001
From: ezedike-evan <210902543@live.unilag.edu.ng>
Date: Sun, 5 Jul 2026 09:06:25 +0100
Subject: [PATCH] feat(offramp): surface anchor errors as unavailable rows

Closes #474
---
 app/offramp/page.tsx                |  7 ++--
 components/offramp/RateTable.tsx    | 42 +++++++++++++++++++++++-
 hooks/useAnchorRates.ts             |  4 ++-
 tests/components/RateTable.test.tsx | 50 +++++++++++++++++++++++++++++
 types/index.ts                      |  8 +++++
 5 files changed, 107 insertions(+), 4 deletions(-)

diff --git a/app/offramp/page.tsx b/app/offramp/page.tsx
index 03bc89a6..973c138c 100644
--- a/app/offramp/page.tsx
+++ b/app/offramp/page.tsx
@@ -36,8 +36,10 @@ function OfframpContent() {
   const [trackingAnchorHomeDomain, setTrackingAnchorHomeDomain] = useState<string | null>(null);
 
   const { isConnected, publicKey, network } = useWallet();
-  const { rates, isLoading, error, mutate, refreshInflight } = useAnchorRates(corridorId, amount);
-
+  const { rates, anchorErrors, isLoading, error, mutate, refreshInflight } = useAnchorRates(
+    corridorId,
+    amount
+  );
   const withdrawStatus = useWithdrawStatus(
     trackingTransferServer,
     trackingTransactionId,
@@ -135,6 +137,7 @@ function OfframpContent() {
         </div>
         <RateTable
           rates={rates}
+          anchorErrors={anchorErrors}
           isLoading={isLoading}
           refreshInflight={refreshInflight}
           error={error}
diff --git a/components/offramp/RateTable.tsx b/components/offramp/RateTable.tsx
index dc7ac10c..7e023fb5 100644
--- a/components/offramp/RateTable.tsx
+++ b/components/offramp/RateTable.tsx
@@ -1,7 +1,7 @@
 'use client';
 import { useState, useCallback } from 'react';
 import { formatCurrency, formatRate } from '@/lib/utils';
-import type { RateComparison, AnchorRate } from '@/types';
+import type { RateComparison, AnchorRate, AnchorRateError } from '@/types';
 import { Skeleton } from '@/components/ui/Skeleton';
 import { QuotePill } from '@/components/ui/QuotePill';
 import { AnchorLogo } from '@/components/ui/AnchorLogo';
@@ -14,10 +14,12 @@ interface RateTableProps {
   onSelectAnchor: (rate: AnchorRate) => void;
   /** Disables the off-ramp action (e.g. when the wallet is not on mainnet). */
   executeDisabled?: boolean;
+  anchorErrors?: AnchorRateError[];
 }
 
 export function RateTable({
   rates,
+  anchorErrors = [],
   isLoading,
   refreshInflight,
   error,
@@ -86,6 +88,7 @@ export function RateTable({
             !error &&
             rates &&
             rates.rates.length === 0 &&
+            anchorErrors.length === 0 &&
             (!rates.pending || rates.pending.length === 0) && (
               <tr>
                 <td colSpan={5} className="px-4 py-8 text-center text-sm text-gray-500">
@@ -155,6 +158,43 @@ export function RateTable({
               );
             })}
 
+          {!isLoading &&
+            !error &&
+            anchorErrors.map((anchorError) => (
+              <tr
+                key={`error-${anchorError.anchorId}`}
+                className="border-t border-gray-200 dark:border-gray-700 opacity-50"
+                title={anchorError.reason}
+                aria-label={`${anchorError.anchorName} unavailable: ${anchorError.reason}`}
+              >
+                <td className="px-4 py-3">
+                  <div className="flex items-center gap-2">
+                    <AnchorLogo
+                      anchorId={anchorError.anchorId}
+                      anchorName={anchorError.anchorName}
+                    />
+                    <span className="font-medium text-gray-400 dark:text-gray-500">
+                      {anchorError.anchorName}
+                    </span>
+                    <QuotePill source="unavailable" />
+                  </div>
+                </td>
+                <td className="px-4 py-3 text-right text-gray-400 dark:text-gray-500">—</td>
+                <td className="px-4 py-3 text-right text-gray-400 dark:text-gray-500">—</td>
+                <td className="px-4 py-3 text-right text-gray-400 dark:text-gray-500">—</td>
+                <td className="px-4 py-3 text-right">
+                  <button
+                    disabled
+                    aria-disabled="true"
+                    title={anchorError.reason}
+                    className="rounded-lg bg-gray-200 px-3 py-1.5 text-xs font-medium text-gray-400 cursor-not-allowed dark:bg-gray-700 dark:text-gray-500"
+                  >
+                    Unavailable
+                  </button>
+                </td>
+              </tr>
+            ))}
+
           {!isLoading &&
             !error &&
             rates?.pending?.map((pendingAnchor) => (
diff --git a/hooks/useAnchorRates.ts b/hooks/useAnchorRates.ts
index 39ba2b79..abfac4c7 100644
--- a/hooks/useAnchorRates.ts
+++ b/hooks/useAnchorRates.ts
@@ -1,7 +1,7 @@
 import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';
 import useSWR from 'swr';
 import { measureClient } from '@/lib/metrics';
-import type { AnchorRate, RateComparison } from '@/types';
+import type { AnchorRate, AnchorRateError, RateComparison } from '@/types';
 
 const RATES_REFRESH_INTERVAL_MS = 30_000;
 
@@ -49,6 +49,7 @@ export interface UseAnchorRatesResult {
   refreshInflight: boolean;
   pauseRefresh: () => void;
   resumeRefresh: () => void;
+  anchorErrors: AnchorRateError[];
 }
 
 export function useAnchorRates(
@@ -203,5 +204,6 @@ export function useAnchorRates(
     refreshInflight,
     pauseRefresh,
     resumeRefresh,
+    anchorErrors: data?.errors ?? [],
   };
 }
diff --git a/tests/components/RateTable.test.tsx b/tests/components/RateTable.test.tsx
index d376c538..1f2b5232 100644
--- a/tests/components/RateTable.test.tsx
+++ b/tests/components/RateTable.test.tsx
@@ -81,6 +81,56 @@ describe('RateTable', () => {
     expect(screen.getByText('No rates available for this corridor.')).toBeInTheDocument();
   });
 
+  it('renders an unavailable row for each anchorError', () => {
+    render(
+      <RateTable
+        rates={mockRates}
+        anchorErrors={[
+          { anchorId: 'bitso', anchorName: 'Bitso', reason: 'SEP-38 timed out after 8000ms' },
+        ]}
+        isLoading={false}
+        error={undefined}
+        onSelectAnchor={vi.fn()}
+      />
+    );
+    expect(screen.getByText('Bitso')).toBeInTheDocument();
+    const unavailableBtn = screen.getByRole('button', { name: /unavailable/i });
+    expect(unavailableBtn).toBeDisabled();
+  });
+
+  it('unavailable row button has the error reason as its title attribute', () => {
+    render(
+      <RateTable
+        rates={mockRates}
+        anchorErrors={[
+          { anchorId: 'bitso', anchorName: 'Bitso', reason: 'SEP-38 timed out after 8000ms' },
+        ]}
+        isLoading={false}
+        error={undefined}
+        onSelectAnchor={vi.fn()}
+      />
+    );
+    const unavailableBtn = screen.getByRole('button', { name: /unavailable/i });
+    expect(unavailableBtn).toHaveAttribute('title', 'SEP-38 timed out after 8000ms');
+  });
+
+  it('does not show empty state when there are no rates but there are anchorErrors', () => {
+    const emptyRates: RateComparison = { ...mockRates, rates: [], bestRateId: '' };
+    render(
+      <RateTable
+        rates={emptyRates}
+        anchorErrors={[
+          { anchorId: 'bitso', anchorName: 'Bitso', reason: 'SEP-38 timed out after 8000ms' },
+        ]}
+        isLoading={false}
+        error={undefined}
+        onSelectAnchor={vi.fn()}
+      />
+    );
+    expect(screen.queryByText('No rates available for this corridor.')).not.toBeInTheDocument();
+    expect(screen.getByText('Bitso')).toBeInTheDocument();
+  });
+
   it('renders "Indicative (SEP-6)" badge for sep6-info rows', () => {
     const sep6Rate: AnchorRate = {
       ...makeRate('yellowcard', 152000),
diff --git a/types/index.ts b/types/index.ts
index 68eece34..13c29d7b 100644
--- a/types/index.ts
+++ b/types/index.ts
@@ -57,12 +57,20 @@ export interface AnchorRate {
   quoteStatus?: 'firm' | 'expiring' | 'refreshing';
 }
 
+export interface AnchorRateError {
+  anchorId: string;
+  anchorName: string;
+  reason: string;
+}
+
 /** The result of comparing all anchor rates for a single corridor. */
 export interface RateComparison {
   corridorId: string;
   rates: AnchorRate[];
   pending: { anchorId: string; anchorName: string }[]; // Anchors still resolving
   bestRateId: string; // anchorId of the anchor with the highest totalReceived
+
+  errors?: AnchorRateError[];
 }
 
 // ─── Wallet ───────────────────────────────────────────────────────────────────