@andrewkimjoseph/celina-sdk 0.6.0 → 0.7.1

package/build/tools/swap-routing.js

@@ -1,3 +1,4 @@
+import { isGoodDollarUsdReservePair } from "../config/gooddollar.js";
 function parseExpectedOut(value) {
     const n = Number(value.replace(/,/g, ""));
     return Number.isFinite(n) ? n : 0;
@@ -8,12 +9,31 @@ function isMentoRouteError(message) {
 function isUniswapRouteError(message) {
     return /no uniswap v4 route|insufficient liquidity in uniswap v4/i.test(message);
 }
+function isGoodDollarReserveRouteError(message) {
+    return /no gooddollar reserve route/i.test(message);
+}
 function isInsufficientBalanceError(message) {
     return /insufficient .+ balance/i.test(message);
 }
 function rejectionMessage(reason) {
     return reason instanceof Error ? reason.message : String(reason);
 }
+function filterAlternatives(best, others) {
+    if (best.protocol !== "gooddollar_reserve") {
+        return others;
+    }
+    const bestOut = parseExpectedOut(best.expectedOut);
+    if (bestOut <= 0) {
+        return others;
+    }
+    return others.filter((alt) => {
+        if (alt.protocol !== "uniswap_v4" || alt.error) {
+            return true;
+        }
+        const altOut = parseExpectedOut(alt.expectedOut);
+        return altOut >= bestOut * 0.95;
+    });
+}
 async function tryMentoQuote(celina, tokenIn, tokenOut, amount, from) {
     const quote = await celina.mentoFx.getFxQuote(tokenIn, tokenOut, amount, from);
     return {
@@ -38,12 +58,32 @@ async function tryUniswapQuote(celina, tokenIn, tokenOut, amount, from) {
         network: quote.network,
     };
 }
-/** Quote a swap across Mento FX and Uniswap v4; returns the best available route. */
+async function tryGoodDollarReserveQuote(celina, tokenIn, tokenOut, amount, from) {
+    const quote = await celina.gooddollar.getReserveQuote(tokenIn, tokenOut, amount, from);
+    return {
+        protocol: "gooddollar_reserve",
+        tokenIn: quote.tokenIn,
+        tokenOut: quote.tokenOut,
+        amountIn: quote.amountIn,
+        expectedOut: quote.expectedOut,
+        routeHops: quote.routeHops,
+        network: quote.network,
+    };
+}
+/** Quote a swap across Mento FX, GoodDollar reserve, and Uniswap v4; returns the best route. */
 export async function getSwapQuoteWithFallback(celina, tokenIn, tokenOut, amount, from) {
-    const [mentoResult, uniswapResult] = await Promise.allSettled([
+    const reserveEligible = isGoodDollarUsdReservePair(tokenIn, tokenOut);
+    const quoteTasks = [
         tryMentoQuote(celina, tokenIn, tokenOut, amount, from),
         tryUniswapQuote(celina, tokenIn, tokenOut, amount, from),
-    ]);
+    ];
+    if (reserveEligible) {
+        quoteTasks.push(tryGoodDollarReserveQuote(celina, tokenIn, tokenOut, amount, from));
+    }
+    const results = await Promise.allSettled(quoteTasks);
+    const mentoResult = results[0];
+    const uniswapResult = results[1];
+    const reserveResult = reserveEligible ? results[2] : undefined;
     const successes = [];
     const alternatives = [];
     if (mentoResult.status === "fulfilled") {
@@ -64,22 +104,37 @@ export async function getSwapQuoteWithFallback(celina, tokenIn, tokenOut, amount
             alternatives.push({ protocol: "uniswap_v4", expectedOut: "0", error: message });
         }
     }
+    if (reserveResult) {
+        if (reserveResult.status === "fulfilled") {
+            successes.push(reserveResult.value);
+        }
+        else {
+            const message = rejectionMessage(reserveResult.reason);
+            if (!isGoodDollarReserveRouteError(message)) {
+                alternatives.push({
+                    protocol: "gooddollar_reserve",
+                    expectedOut: "0",
+                    error: message,
+                });
+            }
+        }
+    }
     if (successes.length === 0) {
-        const failures = [mentoResult, uniswapResult]
+        const failures = results
             .filter((result) => result.status === "rejected")
             .map((result) => rejectionMessage(result.reason));
         const balanceError = failures.find(isInsufficientBalanceError);
         if (balanceError) {
             throw new Error(balanceError);
         }
-        throw new Error(`No swap route for ${tokenIn} → ${tokenOut} via Mento FX or Uniswap v4.`);
+        throw new Error(`No swap route for ${tokenIn} → ${tokenOut} via Mento FX, GoodDollar reserve, or Uniswap v4.`);
     }
     successes.sort((a, b) => parseExpectedOut(b.expectedOut) - parseExpectedOut(a.expectedOut));
     const best = successes[0];
-    const otherProtocols = successes.slice(1).map((q) => ({
+    const otherProtocols = filterAlternatives(best, successes.slice(1).map((q) => ({
         protocol: q.protocol,
         expectedOut: q.expectedOut,
-    }));
+    })));
     return {
         ...best,
         alternatives: otherProtocols.length > 0 ? otherProtocols : alternatives,
@@ -96,6 +151,12 @@ export async function prepareSwapWithFallback(celina, from, tokenIn, tokenOut, a
             deadlineMinutes: params?.deadlineMinutes,
         });
     }
+    if (chosen === "gooddollar_reserve") {
+        return celina.gooddollar.prepareReserveSwap(from, tokenIn, tokenOut, amount, {
+            recipient: params?.recipient,
+            slippageTolerance: params?.slippageTolerance,
+        });
+    }
     return celina.uniswap.prepareSwap(from, tokenIn, tokenOut, amount, {
         recipient: params?.recipient,
         slippageTolerance: params?.slippageTolerance,

package/build/tools/swap-routing.js.map

@@ -1 +1 @@
-{"version":3,"file":"swap-routing.js","sourceRoot":"","sources":["../../src/tools/swap-routing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"swap-routing.js","sourceRoot":"","sources":["../../src/tools/swap-routing.ts"],"names":[],"mappings":"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"}

package/build/tools/types.d.ts

@@ -83,6 +83,14 @@ export type CarbonWriteExecutors = {
 };
 export type GoodDollarWriteExecutors = {
     claimDailyUbi: () => Promise<unknown>;
+    estimateReserveSwap: (tokenIn: string, tokenOut: string, amount: string, options?: {
+        recipient?: `0x${string}`;
+        slippageTolerance?: number;
+    }) => Promise<unknown>;
+    executeReserveSwap: (tokenIn: string, tokenOut: string, amount: string, options?: {
+        recipient?: `0x${string}`;
+        slippageTolerance?: number;
+    }) => Promise<unknown>;
 };
 export type SelfExecutors = {
     verifyAgent: (args: Record<string, unknown>) => Promise<unknown>;

package/build/types/prepared.d.ts

@@ -18,7 +18,7 @@ export interface PreparedFlow {
 }
 /**
  * JSON-safe prepared flow returned by prepare* tools and chat APIs.
- * Consumers (celina-agent TxConfirmCard, wagmi) iterate steps and call sendTransaction.
+ * Consumers (celina-agent TxConfirmCard, wagmi) iterate steps and call sendTransactionAsync (wagmi) or walletClient.sendTransaction (viem).
  */
 export interface SerializedPreparedFlow extends Omit<PreparedFlow, "steps"> {
     steps: PreparedTx[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrewkimjoseph/celina-sdk",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "Celina SDK — Celo mainnet reads and unsigned transaction preparation for frontend apps.",
   "type": "module",
   "sideEffects": false,

package/tests/catalog/domains/defi.ts

@@ -1,5 +1,7 @@
 import type { OperationSpec } from "../types.js";
 import { assertHasKeys } from "../../helpers/assert.js";
+import { getSwapQuoteWithFallback } from "../../../src/tools/swap-routing.js";
+import { GOODDOLLAR_MENTO_BROKER } from "../../../src/config/gooddollar.js";
 
 function fromAddress(fx: Parameters<OperationSpec["assert"]>[1]): `0x${string}` {
   return fx.signerAddress ?? fx.wallet;
@@ -310,4 +312,181 @@ export const gooddollarOperations: OperationSpec[] = [
       assertHasKeys(result, ["hash"]);
     },
   },
+  {
+    id: "gooddollar.getReserveQuote.sell",
+    domain: "gooddollar",
+    layer: "read",
+    sdk: {
+      invoke: (client) =>
+        client.gooddollar.getReserveQuote("GoodDollar", "USDm", "1000"),
+    },
+    mcp: {
+      tool: "get_gooddollar_reserve_quote",
+      arguments: () => ({
+        token_in: "GoodDollar",
+        token_out: "USDm",
+        amount: "1000",
+      }),
+    },
+    assert: (result) => {
+      const quote = result as { protocol?: string; expectedOut?: string };
+      if (quote.protocol !== "gooddollar_reserve") {
+        throw new Error(`Expected gooddollar_reserve, got ${quote.protocol}`);
+      }
+      if (parseExpectedOut(quote.expectedOut) <= 0) {
+        throw new Error("Expected positive reserve output for G$ → USDm");
+      }
+    },
+  },
+  {
+    id: "gooddollar.getReserveQuote.buy",
+    domain: "gooddollar",
+    layer: "read",
+    sdk: {
+      invoke: (client) =>
+        client.gooddollar.getReserveQuote("USDm", "GoodDollar", "100"),
+    },
+    mcp: {
+      tool: "get_gooddollar_reserve_quote",
+      arguments: () => ({
+        token_in: "USDm",
+        token_out: "GoodDollar",
+        amount: "100",
+      }),
+    },
+    assert: (result) => {
+      const quote = result as { protocol?: string; expectedOut?: string };
+      if (quote.protocol !== "gooddollar_reserve") {
+        throw new Error(`Expected gooddollar_reserve, got ${quote.protocol}`);
+      }
+      if (parseExpectedOut(quote.expectedOut) <= 1000) {
+        throw new Error("Expected reserve to return substantially more G$ than Uniswap");
+      }
+    },
+  },
+  {
+    id: "swap.getSwapQuoteWithFallback.gdUsd",
+    domain: "swap",
+    layer: "read",
+    sdk: {
+      invoke: (client) =>
+        getSwapQuoteWithFallback(client, "GoodDollar", "USDm", "1000"),
+    },
+    assert: (result) => {
+      const quote = result as { protocol?: string };
+      if (quote.protocol !== "gooddollar_reserve") {
+        throw new Error(`Expected gooddollar_reserve, got ${quote.protocol}`);
+      }
+    },
+  },
+  {
+    id: "swap.getSwapQuoteWithFallback.usdGd",
+    domain: "swap",
+    layer: "read",
+    sdk: {
+      invoke: (client) =>
+        getSwapQuoteWithFallback(client, "USDm", "GoodDollar", "100"),
+    },
+    assert: (result) => {
+      const quote = result as { protocol?: string };
+      if (quote.protocol !== "gooddollar_reserve") {
+        throw new Error(`Expected gooddollar_reserve, got ${quote.protocol}`);
+      }
+    },
+  },
+  {
+    id: "gooddollar.prepareReserveSwap.sell",
+    domain: "gooddollar",
+    layer: "prepare",
+    requiresEnv: ["CELO_PRIVATE_KEY"],
+    sdk: {
+      invoke: (client, fx) =>
+        client.gooddollar.prepareReserveSwap(
+          fromAddress(fx),
+          "GoodDollar",
+          "USDm",
+          "1000",
+        ),
+    },
+    assert: (result) => {
+      const flow = result as { steps?: Array<{ to?: string }> };
+      assertHasKeys(result, ["from", "steps"]);
+      const last = flow.steps?.at(-1);
+      if (last?.to?.toLowerCase() !== GOODDOLLAR_MENTO_BROKER.toLowerCase()) {
+        throw new Error("Expected final reserve swap step to target MentoBroker");
+      }
+    },
+  },
+  {
+    id: "gooddollar.prepareReserveSwap.buy",
+    domain: "gooddollar",
+    layer: "prepare",
+    requiresEnv: ["CELO_PRIVATE_KEY"],
+    sdk: {
+      invoke: (client, fx) =>
+        client.gooddollar.prepareReserveSwap(
+          fromAddress(fx),
+          "USDm",
+          "GoodDollar",
+          "10",
+        ),
+    },
+    assert: (result) => {
+      const flow = result as { steps?: Array<{ to?: string }> };
+      assertHasKeys(result, ["from", "steps"]);
+      const last = flow.steps?.at(-1);
+      if (last?.to?.toLowerCase() !== GOODDOLLAR_MENTO_BROKER.toLowerCase()) {
+        throw new Error("Expected final reserve swap step to target MentoBroker");
+      }
+    },
+  },
+  {
+    id: "gooddollar.estimateReserveSwap.sell",
+    domain: "gooddollar",
+    layer: "read",
+    requiresEnv: ["CELO_PRIVATE_KEY"],
+    sdk: {
+      invoke: (client, fx) =>
+        client.gooddollar.estimateReserveSwap(
+          fromAddress(fx),
+          "GoodDollar",
+          "USDm",
+          "1000",
+        ),
+    },
+    mcp: {
+      tool: "estimate_gooddollar_reserve_swap",
+      arguments: () => ({
+        token_in: "GoodDollar",
+        token_out: "USDm",
+        amount: "1000",
+      }),
+    },
+    assert: (result) => {
+      assertHasKeys(result, ["expectedOut", "approvalNeeded", "swapGas"]);
+    },
+  },
+  {
+    id: "gooddollar.executeReserveSwap.sell",
+    domain: "gooddollar",
+    layer: "write",
+    requiresEnv: ["CELO_PRIVATE_KEY"],
+    requiresWrites: true,
+    mcp: {
+      tool: "execute_gooddollar_reserve_swap",
+      arguments: () => ({
+        token_in: "GoodDollar",
+        token_out: "USDm",
+        amount: "1",
+      }),
+    },
+    assert: (result) => {
+      assertHasKeys(result, ["hash"]);
+    },
+  },
 ];
+
+function parseExpectedOut(value: string | undefined): number {
+  const n = Number(String(value ?? "").replace(/,/g, ""));
+  return Number.isFinite(n) ? n : 0;
+}