@andrewkimjoseph/celina-sdk 0.9.7 → 0.9.9

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

@@ -0,0 +1,174 @@
+import { isGoodDollarUsdReservePair } from "../config/gooddollar.js";
+function parseExpectedOut(value) {
+    const n = Number(value.replace(/,/g, ""));
+    return Number.isFinite(n) ? n : 0;
+}
+function isMentoMarketClosedError(message) {
+    return /mento fx market is currently closed/i.test(message);
+}
+function isMentoRouteError(message) {
+    return /no mento fx route/i.test(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 {
+        protocol: "mento_fx",
+        tokenIn: quote.tokenIn,
+        tokenOut: quote.tokenOut,
+        amountIn: quote.amountIn,
+        expectedOut: quote.expectedOut,
+        routeHops: quote.routeHops,
+        network: quote.network,
+    };
+}
+async function tryUniswapQuote(celina, tokenIn, tokenOut, amount, from) {
+    const quote = await celina.uniswap.getSwapQuote(tokenIn, tokenOut, amount, from);
+    return {
+        protocol: "uniswap_v4",
+        tokenIn: quote.tokenIn,
+        tokenOut: quote.tokenOut,
+        amountIn: quote.amountIn,
+        expectedOut: quote.expectedOut,
+        routeHops: quote.routeHops,
+        network: quote.network,
+    };
+}
+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 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") {
+        successes.push(mentoResult.value);
+    }
+    else {
+        const message = rejectionMessage(mentoResult.reason);
+        if (!isMentoRouteError(message)) {
+            alternatives.push({ protocol: "mento_fx", expectedOut: "0", error: message });
+        }
+    }
+    if (uniswapResult.status === "fulfilled") {
+        successes.push(uniswapResult.value);
+    }
+    else {
+        const message = rejectionMessage(uniswapResult.reason);
+        if (!isUniswapRouteError(message)) {
+            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 = results
+            .filter((result) => result.status === "rejected")
+            .map((result) => rejectionMessage(result.reason));
+        const balanceError = failures.find(isInsufficientBalanceError);
+        if (balanceError) {
+            throw new Error(balanceError);
+        }
+        const marketClosedError = failures.find(isMentoMarketClosedError);
+        if (marketClosedError) {
+            throw new Error(marketClosedError);
+        }
+        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 = filterAlternatives(best, successes.slice(1).map((q) => ({
+        protocol: q.protocol,
+        expectedOut: q.expectedOut,
+    })));
+    return {
+        ...best,
+        alternatives: otherProtocols.length > 0 ? otherProtocols : alternatives,
+    };
+}
+export async function prepareSwapWithFallback(celina, from, tokenIn, tokenOut, amount, params, protocol) {
+    const chosen = protocol ??
+        (await getSwapQuoteWithFallback(celina, tokenIn, tokenOut, amount, from))
+            .protocol;
+    if (chosen === "mento_fx") {
+        return celina.mentoFx.prepareFx(from, tokenIn, tokenOut, amount, {
+            recipient: params?.recipient,
+            slippageTolerance: params?.slippageTolerance,
+            deadlineMinutes: params?.deadlineMinutes,
+        });
+    }
+    if (chosen === "gooddollar_reserve") {
+        return celina.gooddollar.prepareReserveSwap(from, tokenIn, tokenOut, amount, {
+            recipient: params?.recipient,
+            slippageTolerance: params?.slippageTolerance,
+            amountSide: params?.amountSide,
+        });
+    }
+    return celina.uniswap.prepareSwap(from, tokenIn, tokenOut, amount, {
+        recipient: params?.recipient,
+        slippageTolerance: params?.slippageTolerance,
+        deadlineMinutes: params?.deadlineMinutes,
+    });
+}
+//# sourceMappingURL=swap-routing.js.map

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

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

package/build/src/tools/types.d.ts

@@ -0,0 +1,124 @@
+import type { z } from "zod";
+import type { CelinaClient } from "../index.js";
+export type ToolSurface = "mcp" | "browser";
+export type ToolFamily = "read" | "prepare" | "execute";
+export type ToolEnvRequirement = "CELO_PRIVATE_KEY" | "SELF_AGENT_PRIVATE_KEY" | "SELF_SESSION";
+export type WalletInput = {
+    address?: string;
+    wallet_address?: string;
+    from?: string;
+};
+export type McpToolAnnotations = {
+    readOnlyHint?: boolean;
+    idempotentHint?: boolean;
+    destructiveHint?: boolean;
+    openWorldHint?: boolean;
+};
+export type McpToolMeta = {
+    title?: string;
+    annotations?: McpToolAnnotations;
+    /** MCP adapter uses okSelfSession for QR registration flows. */
+    responseKind?: "default" | "self_session";
+};
+export type ToolRuntimeHooks = {
+    beforePrepareSend?: (params: {
+        sender: `0x${string}`;
+        token: string;
+        amount: string;
+    }) => Promise<void>;
+};
+export type TransactionExecutors = {
+    estimateSend: (to: `0x${string}`, token: string, amount: string) => Promise<unknown>;
+    sendToken: (to: `0x${string}`, token: string, amount: string) => Promise<unknown>;
+};
+export type MentoFxExecutors = {
+    estimate: (tokenIn: string, tokenOut: string, amount: string, options?: {
+        recipient?: `0x${string}`;
+        slippageTolerance?: number;
+        deadlineMinutes?: number;
+    }) => Promise<unknown>;
+    execute: (tokenIn: string, tokenOut: string, amount: string, options?: {
+        recipient?: `0x${string}`;
+        slippageTolerance?: number;
+        deadlineMinutes?: number;
+    }) => Promise<unknown>;
+};
+export type UniswapExecutors = {
+    estimate: (tokenIn: string, tokenOut: string, amount: string, options?: {
+        recipient?: `0x${string}`;
+        slippageTolerance?: number;
+        deadlineMinutes?: number;
+    }) => Promise<unknown>;
+    execute: (tokenIn: string, tokenOut: string, amount: string, options?: {
+        recipient?: `0x${string}`;
+        slippageTolerance?: number;
+        deadlineMinutes?: number;
+    }) => Promise<unknown>;
+};
+export type AaveExecutors = {
+    supply: (token: string, amount: string) => Promise<unknown>;
+    withdraw: (token: string, amount?: string, withdrawMax?: boolean) => Promise<unknown>;
+};
+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>;
+    lookupAgent: (agentId: number) => Promise<unknown>;
+    verifyRequest: (args: Record<string, unknown>) => Promise<unknown>;
+    registerAgent: (args: Record<string, unknown>) => Promise<unknown>;
+    checkRegistration: (sessionId: string) => Promise<unknown>;
+    getIdentity: () => Promise<unknown>;
+    refreshProof: (args: Record<string, unknown>) => Promise<unknown>;
+    deregisterAgent: () => Promise<unknown>;
+    signRequest: (args: Record<string, unknown>) => Promise<unknown>;
+    authenticatedFetch: (args: Record<string, unknown>) => Promise<unknown>;
+};
+export type ToolRuntimeExecutors = {
+    transaction?: TransactionExecutors;
+    mentoFx?: MentoFxExecutors;
+    uniswap?: UniswapExecutors;
+    aave?: AaveExecutors;
+    gooddollarWrite?: GoodDollarWriteExecutors;
+    self?: SelfExecutors;
+};
+export interface ToolRuntime {
+    celina: CelinaClient;
+    resolveWallet: (input?: WalletInput) => `0x${string}`;
+    hooks?: ToolRuntimeHooks;
+    executors?: ToolRuntimeExecutors;
+    /** MCP session wallet metadata for get_wallet_address. */
+    mcpWallet?: {
+        address: `0x${string}`;
+        hasWallet: boolean;
+    };
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: z.ZodTypeAny;
+    families: ToolFamily[];
+    surfaces?: ToolSurface[];
+    requiresEnv?: ToolEnvRequirement[];
+    mcp?: McpToolMeta;
+    handler: (runtime: ToolRuntime, input: Record<string, unknown>) => Promise<unknown>;
+}
+export type FilterToolsOptions = {
+    surface?: ToolSurface;
+    families?: ToolFamily[];
+    names?: string[];
+    /** When false, omit tools that require CELO_PRIVATE_KEY or SELF_AGENT_PRIVATE_KEY. Default true. */
+    serverKeyToolsEnabled?: boolean;
+    /** When false, omit Self registration session tools. Default true. */
+    selfSessionToolsEnabled?: boolean;
+    /** When false, omit estimate_* gas simulation tools. Default true. */
+    estimateToolsEnabled?: boolean;
+};

package/build/src/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/src/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/types.ts"],"names":[],"mappings":""}

package/build/src/tools/utils/normalize-token.d.ts

@@ -0,0 +1,2 @@
+/** Normalize common LLM token shorthands before registry lookup. */
+export declare function normalizeRegistryTokenInput(token: string): string;

package/build/src/tools/utils/normalize-token.js

@@ -0,0 +1,12 @@
+const REGISTRY_ALIASES = {
+    GD: "GoodDollar",
+    "G$": "GoodDollar",
+    GOODDOLLAR: "GoodDollar",
+};
+/** Normalize common LLM token shorthands before registry lookup. */
+export function normalizeRegistryTokenInput(token) {
+    const trimmed = token.trim();
+    const upper = trimmed.toUpperCase();
+    return REGISTRY_ALIASES[upper] ?? REGISTRY_ALIASES[trimmed] ?? trimmed;
+}
+//# sourceMappingURL=normalize-token.js.map

package/build/src/tools/utils/normalize-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-token.js","sourceRoot":"","sources":["../../../../src/tools/utils/normalize-token.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAA2B;IAC/C,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,YAAY;IAClB,UAAU,EAAE,YAAY;CACzB,CAAC;AAEF,oEAAoE;AACpE,MAAM,UAAU,2BAA2B,CAAC,KAAa;IACvD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC;AACzE,CAAC"}

package/build/src/tools/utils/wallet.d.ts

@@ -0,0 +1,4 @@
+import type { ToolRuntime, WalletInput } from "../types.js";
+export declare function resolveWalletFromRuntime(runtime: ToolRuntime, input?: WalletInput): `0x${string}`;
+/** Use MCP server signer for estimates only when a wallet is configured and no explicit from. */
+export declare function useMcpServerExecutor(runtime: ToolRuntime, explicitFrom?: string): boolean;

package/build/src/tools/utils/wallet.js

@@ -0,0 +1,8 @@
+export function resolveWalletFromRuntime(runtime, input) {
+    return runtime.resolveWallet(input);
+}
+/** Use MCP server signer for estimates only when a wallet is configured and no explicit from. */
+export function useMcpServerExecutor(runtime, explicitFrom) {
+    return Boolean(runtime.mcpWallet?.hasWallet && !explicitFrom);
+}
+//# sourceMappingURL=wallet.js.map

package/build/src/tools/utils/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../../../src/tools/utils/wallet.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,wBAAwB,CACtC,OAAoB,EACpB,KAAmB;IAEnB,OAAO,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,oBAAoB,CAClC,OAAoB,EACpB,YAAqB;IAErB,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,IAAI,CAAC,YAAY,CAAC,CAAC;AAChE,CAAC"}

package/build/src/tools/website-sync.d.ts

@@ -0,0 +1,28 @@
+import type { FilterToolsOptions, ToolDefinition } from "./types.js";
+export type WebsiteToolCategory = "Blockchain" | "Account" | "Token" | "Transaction" | "Mento FX" | "Uniswap" | "Wallet" | "GoodDollar" | "Aave" | "Self" | "Governance" | "Staking" | "NFT" | "Contract";
+export type WebsiteToolKind = "read" | "write";
+export type WebsiteToolAvailability = "hosted" | "stdio" | "both";
+export interface WebsiteToolBaseline {
+    name: string;
+    slug: string;
+    title: string;
+    summary: string;
+    description: string;
+    kind: WebsiteToolKind;
+    category: WebsiteToolCategory;
+    inputs: Array<{
+        name: string;
+        type: string;
+        required?: boolean;
+        description: string;
+    }>;
+}
+export declare const HOSTED_MCP_FILTER: FilterToolsOptions;
+export declare const TOOL_CATEGORY_BY_NAME: Record<string, WebsiteToolCategory>;
+export declare function toWebsiteToolBaseline(definition: ToolDefinition): WebsiteToolBaseline;
+export declare function deriveToolAvailability(definition: ToolDefinition): WebsiteToolAvailability;
+export declare function getHostedMcpToolDefinitions(): ToolDefinition[];
+export declare function getHostedMcpToolNames(): string[];
+export declare function getHostedMcpToolCount(): number;
+export declare function getWebsiteToolBaselines(): WebsiteToolBaseline[];
+export declare function getMcpToolNameSet(): Set<string>;

package/build/src/tools/website-sync.js

@@ -0,0 +1,165 @@
+import { ALL_TOOL_DEFINITIONS, getToolInputSchemaShape } from "./catalog.js";
+import { filterToolDefinitions } from "./filter.js";
+export const HOSTED_MCP_FILTER = {
+    surface: "mcp",
+    serverKeyToolsEnabled: false,
+    selfSessionToolsEnabled: false,
+    estimateToolsEnabled: false,
+};
+const STDIO_ONLY_TOOLS = new Set([
+    "send_token",
+    "execute_mento_fx",
+    "execute_uniswap_swap",
+    "supply_aave",
+    "withdraw_aave",
+    "claim_daily_gooddollar_ubi",
+    "execute_gooddollar_reserve_swap",
+    "get_wallet_address",
+    "get_self_identity",
+    "sign_self_request",
+    "authenticated_self_fetch",
+    "refresh_self_proof",
+    "deregister_self_agent",
+    "register_self_agent",
+    "check_self_registration",
+]);
+export const TOOL_CATEGORY_BY_NAME = {
+    get_network_status: "Blockchain",
+    get_block: "Blockchain",
+    get_latest_blocks: "Blockchain",
+    get_transaction: "Blockchain",
+    get_account: "Account",
+    get_wallet_address: "Wallet",
+    get_celo_balances: "Token",
+    get_stablecoin_balances: "Token",
+    get_token_info: "Token",
+    get_token_balance: "Token",
+    estimate_send: "Transaction",
+    send_token: "Transaction",
+    get_mento_fx_quote: "Mento FX",
+    estimate_mento_fx: "Mento FX",
+    execute_mento_fx: "Mento FX",
+    prepare_mento_fx: "Mento FX",
+    get_uniswap_quote: "Uniswap",
+    estimate_uniswap_swap: "Uniswap",
+    execute_uniswap_swap: "Uniswap",
+    prepare_uniswap_swap: "Uniswap",
+    get_swap_quote: "Uniswap",
+    prepare_swap: "Uniswap",
+    get_aave_balances: "Aave",
+    supply_aave: "Aave",
+    withdraw_aave: "Aave",
+    resolve_ens: "Wallet",
+    get_gooddollar_whitelisting_info: "GoodDollar",
+    get_gooddollar_identity_link: "GoodDollar",
+    get_gooddollar_ubi_entitlement: "GoodDollar",
+    claim_daily_gooddollar_ubi: "GoodDollar",
+    prepare_claim_daily_gooddollar_ubi: "GoodDollar",
+    get_gooddollar_reserve_quote: "GoodDollar",
+    estimate_gooddollar_reserve_swap: "GoodDollar",
+    execute_gooddollar_reserve_swap: "GoodDollar",
+    prepare_gooddollar_reserve_swap: "GoodDollar",
+    get_governance_proposals: "Governance",
+    get_proposal_details: "Governance",
+    get_staking_balances: "Staking",
+    get_validator_groups: "Staking",
+    get_validator_group_details: "Staking",
+    get_activatable_stakes: "Staking",
+    get_total_staking_info: "Staking",
+    get_nft_info: "NFT",
+    get_nft_balance: "NFT",
+    call_contract_function: "Contract",
+    estimate_contract_gas: "Contract",
+    verify_self_agent: "Self",
+    lookup_self_agent: "Self",
+    verify_self_request: "Self",
+    register_self_agent: "Self",
+    check_self_registration: "Self",
+    get_self_identity: "Self",
+    refresh_self_proof: "Self",
+    deregister_self_agent: "Self",
+    sign_self_request: "Self",
+    authenticated_self_fetch: "Self",
+};
+function toolNameToSlug(name) {
+    return name.replace(/_/g, "-");
+}
+function familyToKind(families) {
+    return families.includes("execute") ? "write" : "read";
+}
+function firstSentence(text) {
+    const match = text.match(/^[^.!?]+[.!?]?/);
+    return match ? match[0].trim() : text.slice(0, 120);
+}
+function zodFieldType(key, schema) {
+    if (!schema || typeof schema !== "object") {
+        return "string";
+    }
+    const zod = schema;
+    const typeName = zod._def?.typeName;
+    if (typeName === "ZodOptional" || typeName === "ZodDefault") {
+        return zodFieldType(key, zod._def?.innerType);
+    }
+    if (typeName === "ZodBoolean")
+        return "boolean";
+    if (typeName === "ZodNumber")
+        return "number";
+    if (typeName === "ZodArray")
+        return "array";
+    return "string";
+}
+function inputsFromSchema(definition) {
+    const shape = getToolInputSchemaShape(definition);
+    if (!shape)
+        return [];
+    return Object.entries(shape).map(([name, schema]) => ({
+        name,
+        type: zodFieldType(name, schema),
+        required: !String(schema).includes("optional"),
+        description: name.replace(/_/g, " "),
+    }));
+}
+function categoryForTool(definition) {
+    return TOOL_CATEGORY_BY_NAME[definition.name] ?? "Blockchain";
+}
+export function toWebsiteToolBaseline(definition) {
+    return {
+        name: definition.name,
+        slug: toolNameToSlug(definition.name),
+        title: definition.mcp?.title ?? definition.name.replace(/_/g, " "),
+        summary: firstSentence(definition.description),
+        description: definition.description,
+        kind: familyToKind(definition.families),
+        category: categoryForTool(definition),
+        inputs: inputsFromSchema(definition),
+    };
+}
+export function deriveToolAvailability(definition) {
+    if (definition.name.startsWith("estimate_")) {
+        return "stdio";
+    }
+    if (STDIO_ONLY_TOOLS.has(definition.name)) {
+        return "stdio";
+    }
+    const surfaces = definition.surfaces ?? ["mcp", "browser"];
+    if (surfaces.length === 1 && surfaces[0] === "browser") {
+        return "stdio";
+    }
+    return "both";
+}
+export function getHostedMcpToolDefinitions() {
+    return filterToolDefinitions(ALL_TOOL_DEFINITIONS, HOSTED_MCP_FILTER);
+}
+export function getHostedMcpToolNames() {
+    return getHostedMcpToolDefinitions().map((d) => d.name);
+}
+export function getHostedMcpToolCount() {
+    return getHostedMcpToolDefinitions().length;
+}
+export function getWebsiteToolBaselines() {
+    return filterToolDefinitions(ALL_TOOL_DEFINITIONS, { surface: "mcp" }).map(toWebsiteToolBaseline);
+}
+export function getMcpToolNameSet() {
+    return new Set(filterToolDefinitions(ALL_TOOL_DEFINITIONS, { surface: "mcp" }).map((d) => d.name));
+}
+//# sourceMappingURL=website-sync.js.map

package/build/src/tools/website-sync.js.map

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

package/build/src/types/prepared.d.ts

@@ -0,0 +1,28 @@
+export type PreparedTxKind = "native" | "erc20" | "contract";
+/** Single unsigned transaction step in a prepared flow. */
+export interface PreparedTx {
+    /** Step category for UI and wallet routing. */
+    kind: PreparedTxKind;
+    to: `0x${string}`;
+    data?: `0x${string}`;
+    /** Wei amount as decimal string for JSON serialization */
+    value?: string;
+    description: string;
+}
+/** In-memory prepared flow before JSON serialization. */
+export interface PreparedFlow {
+    steps: PreparedTx[];
+    summary: string;
+    network: "mainnet";
+    from: `0x${string}`;
+}
+/**
+ * JSON-safe prepared flow returned by prepare* tools and chat APIs.
+ * Consumers simulate each step (see @andrewkimjoseph/celina-sdk/simulation), then call sendTransactionAsync (wagmi) or walletClient.sendTransaction (viem).
+ */
+export interface SerializedPreparedFlow extends Omit<PreparedFlow, "steps"> {
+    steps: PreparedTx[];
+    preparedFlow: true;
+}
+/** Marks a prepared flow as JSON-safe for API and chat tool responses. */
+export declare function serializePreparedFlow(flow: PreparedFlow): SerializedPreparedFlow;

package/build/src/types/prepared.js

@@ -0,0 +1,12 @@
+/** Marks a prepared flow as JSON-safe for API and chat tool responses. */
+export function serializePreparedFlow(flow) {
+    return {
+        ...flow,
+        preparedFlow: true,
+        steps: flow.steps.map((step) => ({
+            ...step,
+            value: step.value?.toString(),
+        })),
+    };
+}
+//# sourceMappingURL=prepared.js.map

package/build/src/types/prepared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepared.js","sourceRoot":"","sources":["../../../src/types/prepared.ts"],"names":[],"mappings":"AA8BA,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CAAC,IAAkB;IACtD,OAAO;QACL,GAAG,IAAI;QACP,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/B,GAAG,IAAI;YACP,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE;SAC9B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/build/src/utils/celo-format.d.ts

@@ -0,0 +1,6 @@
+/** Human-readable CELO amount from wei (18 decimals). */
+export declare function formatCeloAmount(wei: bigint): string;
+/** Shorten a hex address for display (`0x1234…abcd`). */
+export declare function formatAddress(address: string): string;
+/** Format validator score basis points as a percentage string. */
+export declare function formatScorePercentage(score: bigint | number): string;

package/build/src/utils/celo-format.js

@@ -0,0 +1,17 @@
+import { formatUnits } from "viem";
+/** Human-readable CELO amount from wei (18 decimals). */
+export function formatCeloAmount(wei) {
+    return `${formatUnits(wei, 18)} CELO`;
+}
+/** Shorten a hex address for display (`0x1234…abcd`). */
+export function formatAddress(address) {
+    if (address.length < 10)
+        return address;
+    return `${address.slice(0, 6)}...${address.slice(-4)}`;
+}
+/** Format validator score basis points as a percentage string. */
+export function formatScorePercentage(score) {
+    const value = typeof score === "bigint" ? Number(score) : score;
+    return `${(value / 100).toFixed(2)}%`;
+}
+//# sourceMappingURL=celo-format.js.map

package/build/src/utils/celo-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"celo-format.js","sourceRoot":"","sources":["../../../src/utils/celo-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAEnC,yDAAyD;AACzD,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC;AACxC,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,OAAO,CAAC;IACxC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,qBAAqB,CAAC,KAAsB;IAC1D,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAChE,OAAO,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACxC,CAAC"}