safehands-pharos 1.2.0 → 1.2.3

package/dist/tools/getPoolInfo.js

@@ -1,49 +1,74 @@
 // ─── Tool: get_pool_info ───────────────────────────────────────────────
-// Fetches DODO liquidity pool data for a token pair on Pharos.
+// Fetches DODO/FaroSwap route-derived liquidity info for a token pair on
+// Pharos Atlantic Testnet. API key is optional: public mode is tried first
+// when DODO_API_KEY is not configured.
 // ────────────────────────────────────────────────────────────────────────
 import { z } from "zod";
 import { resolveTokenAddress } from "../lib/dodoApi.js";
-import { DODO_API_BASE, DODO_API_KEY, CHAIN_ID } from "../lib/constants.js";
+import { DODO_API_BASE, DODO_API_KEY, CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
+import { fetchWithTimeoutAndRetry } from "../lib/http.js";
+import { classifyExternalError, fail, ok } from "../lib/toolResponse.js";
 export const getPoolInfoSchema = z.object({
     tokenA: z.enum(["PHRS", "USDC", "USDT"]).describe("First token in the pair"),
     tokenB: z.enum(["PHRS", "USDC", "USDT"]).describe("Second token in the pair"),
 });
 export const getPoolInfoTool = {
     name: "get_pool_info",
-    description: "Fetch DODO liquidity pool info for a token pair on Pharos. Returns liquidity, volume, fees, and price ratio.",
+    description: "Fetch DODO/FaroSwap route-derived liquidity info for a token pair on Pharos testnet. API key is optional; public mode is attempted first.",
     inputSchema: getPoolInfoSchema,
 };
+function addOptionalApiKey(url) {
+    const key = DODO_API_KEY?.trim();
+    if (!key)
+        return false;
+    url.searchParams.set("apikey", key);
+    return true;
+}
+function isAuthErrorStatus(status) {
+    return status === 401 || status === 403;
+}
 export async function handleGetPoolInfo(raw) {
     const input = getPoolInfoSchema.parse(raw);
     if (input.tokenA === input.tokenB) {
-        return {
-            pair: `${input.tokenA}/${input.tokenB}`,
-            error: "Cannot query pool for identical tokens",
-        };
+        return fail("INVALID_PAIR", "Cannot query pool for identical tokens.", false, "get_pool_info");
     }
-    const addrA = resolveTokenAddress(input.tokenA);
-    const addrB = resolveTokenAddress(input.tokenB);
-    // Try DODO pair list endpoint
-    const pairUrl = `${DODO_API_BASE}/route-service/v2/widget/getdodoroute` +
-        `?chainId=${CHAIN_ID}` +
-        `&fromTokenAddress=${addrA}` +
-        `&toTokenAddress=${addrB}` +
-        `&fromAmount=1000000000000000000` + // 1 token in wei (18 decimals)
-        `&userAddr=0x0000000000000000000000000000000000000001` +
-        `&slippage=3` +
-        `&source=dodoV2AndMixWasm` +
-        `&estimateGas=true` +
-        `&apikey=${DODO_API_KEY}`;
     try {
-        const routeResponse = await fetch(pairUrl);
+        const addrA = resolveTokenAddress(input.tokenA);
+        const addrB = resolveTokenAddress(input.tokenB);
+        const routeUrl = new URL(`${DODO_API_BASE}/route-service/v2/widget/getdodoroute`);
+        routeUrl.searchParams.set("chainId", String(CHAIN_ID));
+        routeUrl.searchParams.set("fromTokenAddress", addrA);
+        routeUrl.searchParams.set("toTokenAddress", addrB);
+        routeUrl.searchParams.set("fromAmount", "1000000000000000000");
+        routeUrl.searchParams.set("userAddr", "0x0000000000000000000000000000000000000001");
+        routeUrl.searchParams.set("slippage", "3");
+        routeUrl.searchParams.set("source", "dodoV2AndMixWasm");
+        routeUrl.searchParams.set("estimateGas", "true");
+        const routeUsedApiKey = addOptionalApiKey(routeUrl);
+        const routeResponse = await fetchWithTimeoutAndRetry(routeUrl, { timeoutMs: 10_000, retries: 2, retryDelayMs: 300 });
+        if (isAuthErrorStatus(routeResponse.status)) {
+            return fail("DODO_API_AUTH_REQUIRED", "DODO/FaroSwap route API rejected public mode. Configure DODO_API_KEY only if this endpoint requires authenticated access.", false, "dodo_api");
+        }
+        if (!routeResponse.ok) {
+            return fail("DODO_API_UNAVAILABLE", `DODO route API returned ${routeResponse.status} ${routeResponse.statusText}.`, true, "dodo_api");
+        }
         const routeJson = (await routeResponse.json());
         if (!routeJson.data || routeJson.status !== 200) {
-            return {
+            const msg = (routeJson.message || "").toLowerCase();
+            if (msg.includes("api key") || msg.includes("apikey") || msg.includes("unauthorized") || msg.includes("forbidden")) {
+                return fail("DODO_API_AUTH_REQUIRED", "DODO/FaroSwap route API rejected public mode. Configure DODO_API_KEY only if this endpoint requires authenticated access.", false, "dodo_api");
+            }
+            return ok({
                 pair: `${input.tokenA}/${input.tokenB}`,
                 available: false,
-                message: "No active DODO liquidity pool found for this pair on Pharos",
-                timestamp: new Date().toISOString(),
-            };
+                message: "No active DODO/FaroSwap route found for this pair on Pharos testnet.",
+                source: "DODO/FaroSwap public route API",
+                sourceStatus: "no_route_available",
+                publicMode: !routeUsedApiKey,
+                chainId: CHAIN_ID,
+                environment: PHAROS_ENVIRONMENT,
+                isMainnet: false,
+            });
         }
         const d = routeJson.data;
         const resAmount = parseFloat(String(d.resAmount || "0"));
@@ -51,49 +76,63 @@ export async function handleGetPoolInfo(raw) {
         const fee = parseFloat(String(d.baseFeeAmount || "0"));
         const pricePerFrom = parseFloat(String(d.resPricePerFromToken || "0"));
         const pricePerTo = parseFloat(String(d.resPricePerToToken || "0"));
-        // Also try the pools endpoint for liquidity data
         let liquidityInfo = null;
+        let poolListStatus = "unavailable";
         try {
-            const poolsUrl = `${DODO_API_BASE}/dodo-pair/list` +
-                `?chainId=${CHAIN_ID}` +
-                `&baseToken=${addrA}` +
-                `&quoteToken=${addrB}` +
-                `&apikey=${DODO_API_KEY}`;
-            const poolsResp = await fetch(poolsUrl);
-            const poolsJson = (await poolsResp.json());
-            if (poolsJson.data?.list && poolsJson.data.list.length > 0) {
-                const pool = poolsJson.data.list[0];
-                liquidityInfo = {
-                    baseLiquidity: pool.baseLiquidity || "unknown",
-                    quoteLiquidity: pool.quoteLiquidity || "unknown",
-                    poolType: pool.type || "unknown",
-                };
+            const poolsUrl = new URL(`${DODO_API_BASE}/dodo-pair/list`);
+            poolsUrl.searchParams.set("chainId", String(CHAIN_ID));
+            poolsUrl.searchParams.set("baseToken", addrA);
+            poolsUrl.searchParams.set("quoteToken", addrB);
+            addOptionalApiKey(poolsUrl);
+            const poolsResp = await fetchWithTimeoutAndRetry(poolsUrl, { timeoutMs: 10_000, retries: 1, retryDelayMs: 300 });
+            if (poolsResp.ok) {
+                const poolsJson = (await poolsResp.json());
+                if (poolsJson.data?.list && poolsJson.data.list.length > 0) {
+                    const pool = poolsJson.data.list[0];
+                    liquidityInfo = {
+                        baseLiquidity: pool.baseLiquidity || "unknown",
+                        quoteLiquidity: pool.quoteLiquidity || "unknown",
+                        poolType: pool.type || "unknown",
+                    };
+                    poolListStatus = "ok";
+                }
+                else {
+                    poolListStatus = "empty";
+                }
+            }
+            else if (isAuthErrorStatus(poolsResp.status)) {
+                poolListStatus = "auth_required";
             }
         }
         catch {
-            // Pool list endpoint may not be available — non-critical
+            poolListStatus = "unavailable";
         }
-        return {
+        return ok({
             pair: `${input.tokenA}/${input.tokenB}`,
             available: true,
-            priceRatio: resAmount > 0 ? `1 ${input.tokenA} = ${resAmount} ${input.tokenB}` : "unavailable",
-            priceImpact: `${priceImpact.toFixed(4)}%`,
-            pricePerFromToken: pricePerFrom > 0 ? pricePerFrom.toFixed(6) : "unavailable",
-            pricePerToToken: pricePerTo > 0 ? pricePerTo.toFixed(6) : "unavailable",
-            fee: fee > 0 ? fee.toString() : "included in quote",
-            liquidity: liquidityInfo || "Query via route API (pool list unavailable)",
-            source: "DODO Aggregation API",
+            priceRatio: resAmount > 0 ? { value: resAmount.toString(), unit: input.tokenB, per: `1 ${input.tokenA}` } : null,
+            priceImpact: { value: priceImpact.toFixed(4), unit: "percent" },
+            pricePerFromToken: pricePerFrom > 0 ? { value: pricePerFrom.toFixed(6), unit: input.tokenB } : null,
+            pricePerToToken: pricePerTo > 0 ? { value: pricePerTo.toFixed(6), unit: input.tokenA } : null,
+            fee: fee > 0 ? { value: fee.toString(), unit: "raw" } : null,
+            liquidity: liquidityInfo,
+            poolListStatus,
+            source: "DODO/FaroSwap public route API",
+            sourceStatus: "ok",
+            publicMode: !routeUsedApiKey,
+            routeAvailable: true,
+            confidence: liquidityInfo ? "medium" : "low",
             chainId: CHAIN_ID,
-            timestamp: new Date().toISOString(),
-        };
+            environment: PHAROS_ENVIRONMENT,
+            isMainnet: false,
+        });
     }
     catch (err) {
-        return {
-            pair: `${input.tokenA}/${input.tokenB}`,
-            available: false,
-            error: `Failed to fetch pool info: ${err.message}`,
-            timestamp: new Date().toISOString(),
-        };
+        const message = err instanceof Error ? err.message : String(err);
+        if (message.includes("INVALID_TOKEN_ADDRESS")) {
+            return fail("INVALID_TOKEN_ADDRESS", message, false, "get_pool_info");
+        }
+        return classifyExternalError("dodo_api", err);
     }
 }
 //# sourceMappingURL=getPoolInfo.js.map

package/dist/tools/getPoolInfo.js.map

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

package/dist/tools/getTokenPrice.d.ts

@@ -2,9 +2,9 @@ import { z } from "zod";
 export declare const getTokenPriceSchema: z.ZodObject<{
     token: z.ZodEnum<["PHRS", "USDC", "USDT"]>;
 }, "strip", z.ZodTypeAny, {
-    token: "PHRS" | "USDT" | "USDC";
+    token: "PHRS" | "USDC" | "USDT";
 }, {
-    token: "PHRS" | "USDT" | "USDC";
+    token: "PHRS" | "USDC" | "USDT";
 }>;
 export type GetTokenPriceInput = z.input<typeof getTokenPriceSchema>;
 export declare const getTokenPriceTool: {
@@ -13,16 +13,102 @@ export declare const getTokenPriceTool: {
     inputSchema: z.ZodObject<{
         token: z.ZodEnum<["PHRS", "USDC", "USDT"]>;
     }, "strip", z.ZodTypeAny, {
-        token: "PHRS" | "USDT" | "USDC";
+        token: "PHRS" | "USDC" | "USDT";
     }, {
-        token: "PHRS" | "USDT" | "USDC";
+        token: "PHRS" | "USDC" | "USDT";
     }>;
 };
-export declare function handleGetTokenPrice(raw: GetTokenPriceInput): Promise<{
+export declare function handleGetTokenPrice(raw: GetTokenPriceInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
     token: string;
-    priceUsd: string;
-    priceInPHRS: string;
+    tokenRegistry: {
+        readonly symbol: "USDC";
+        readonly address: "0xE0BE08c77f415F577A1B3A9aD7a1Df1479564ec8";
+        readonly decimals: 6;
+        readonly chainId: number;
+        readonly environment: string;
+        readonly isMainnet: false;
+        readonly isCanonical: true;
+        readonly isTestToken: true;
+        readonly purpose: "Pharos Skill Engine USDC — the USDC listed in the official pharos-skill-engine-0.1.0 assets/tokens.json for atlantic-testnet";
+        readonly docsSource: "pharos-skill-engine-0.1.0/assets/tokens.json";
+        readonly verificationStatus: "DOCS_VERIFIED_FROM_PHAROS_SKILL_ENGINE";
+    };
+    priceUsd: {
+        value: string;
+        unit: string;
+    };
+    priceInPHRS: {
+        value: string | null;
+        unit: string;
+    };
     source: string;
-    timestamp: string;
-}>;
+    sourceStatus: "ok" | "unavailable" | "no_route_available" | "auth_required";
+    routeAvailable: boolean;
+    publicMode: boolean;
+    confidence: string;
+    chainId: number;
+    environment: string;
+    isMainnet: boolean;
+}> | import("../lib/toolResponse.js").ToolSuccess<{
+    token: string;
+    tokenRegistry: {
+        readonly symbol: "USDT";
+        readonly address: "0xE7E84B8B4f39C507499c40B4ac199B050e2882d5";
+        readonly decimals: 6;
+        readonly chainId: number;
+        readonly environment: string;
+        readonly isMainnet: false;
+        readonly isCanonical: true;
+        readonly isTestToken: true;
+        readonly purpose: "canonical Pharos Atlantic Testnet USDT (Tether USD)";
+        readonly docsSource: "https://docs.pharos.xyz/getting-started/token-registry";
+        readonly verificationStatus: "DOCS_VERIFIED";
+    };
+    priceUsd: {
+        value: string;
+        unit: string;
+    };
+    priceInPHRS: {
+        value: string | null;
+        unit: string;
+    };
+    source: string;
+    sourceStatus: string;
+    routeAvailable: boolean;
+    publicMode: boolean;
+    confidence: string;
+    chainId: number;
+    environment: string;
+    isMainnet: boolean;
+}> | import("../lib/toolResponse.js").ToolSuccess<{
+    token: string;
+    tokenRegistry: {
+        readonly symbol: "PHRS";
+        readonly address: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+        readonly decimals: 18;
+        readonly chainId: number;
+        readonly environment: string;
+        readonly isMainnet: false;
+        readonly isCanonical: true;
+        readonly isTestToken: true;
+        readonly purpose: "native PHRS sentinel address for DODO route API";
+        readonly docsSource: "https://docs.pharos.xyz/";
+    };
+    priceUsd: {
+        value: string;
+        unit: string;
+    };
+    priceInPHRS: {
+        value: string;
+        unit: string;
+    };
+    source: string;
+    sourceStatus: "ok" | "unavailable" | "no_route_available" | "auth_required";
+    routeAvailable: boolean;
+    publicMode: boolean;
+    confidence: string;
+    chainId: number;
+    environment: string;
+    isMainnet: boolean;
+}>>;
 //# sourceMappingURL=getTokenPrice.d.ts.map

package/dist/tools/getTokenPrice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getTokenPrice.d.ts","sourceRoot":"","sources":["../../src/tools/getTokenPrice.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,mBAAmB;;;;;;EAE9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,eAAO,MAAM,iBAAiB;;;;;;;;;;CAK7B,CAAC;AAKF,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,kBAAkB;;;;;;GAuEhE"}
+{"version":3,"file":"getTokenPrice.d.ts","sourceRoot":"","sources":["../../src/tools/getTokenPrice.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,mBAAmB;;;;;;EAE9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,eAAO,MAAM,iBAAiB;;;;;;;;;;CAK7B,CAAC;AAKF,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+GhE"}

package/dist/tools/getTokenPrice.js

@@ -1,79 +1,118 @@
 // ─── Tool: get_token_price ─────────────────────────────────────────────
-// Fetches real-time token price from DODO API by quoting a swap against
-// a known stablecoin pair.
+// Fetches testnet token price from DODO/FaroSwap route quotes.
 // ────────────────────────────────────────────────────────────────────────
 import { z } from "zod";
 import { getDodoRoute } from "../lib/dodoApi.js";
+import { CHAIN_ID, PHAROS_ENVIRONMENT, TOKEN_REGISTRY } from "../lib/constants.js";
+import { classifyExternalError, fail, ok } from "../lib/toolResponse.js";
 export const getTokenPriceSchema = z.object({
     token: z.enum(["PHRS", "USDC", "USDT"]).describe("Token to get price for"),
 });
 export const getTokenPriceTool = {
     name: "get_token_price",
-    description: "Fetch real-time price of PHRS, USDC, or USDT on Pharos Atlantic Testnet using DODO liquidity quotes.",
+    description: "Fetch real-time testnet price of PHRS, USDC, or USDT on Pharos using DODO/FaroSwap liquidity quotes.",
     inputSchema: getTokenPriceSchema,
 };
 // Read-only address for price quotes (never signs transactions)
 const QUOTE_WALLET = "0x0000000000000000000000000000000000000001";
 export async function handleGetTokenPrice(raw) {
     const input = getTokenPriceSchema.parse(raw);
-    const timestamp = new Date().toISOString();
-    if (input.token === "USDC") {
-        // USDC is the quote stablecoin — price ~$1, get price in PHRS by quoting 1 USDC → PHRS
-        const quote = await getDodoRoute({
-            fromToken: "USDC",
-            toToken: "PHRS",
-            amountHuman: "1",
-            walletAddress: QUOTE_WALLET,
-        });
-        const priceInPHRS = quote.routeAvailable ? parseFloat(quote.amountOut) : 0;
-        return {
-            token: "USDC",
-            priceUsd: "1.00",
-            priceInPHRS: priceInPHRS > 0 ? priceInPHRS.toFixed(6) : "unavailable",
-            source: "DODO Route API (Pharos Atlantic)",
-            timestamp,
-        };
-    }
-    if (input.token === "USDT") {
-        // USDT — quote 1 USDT → USDC to get USD price, then 1 USDT → PHRS
-        const usdQuote = await getDodoRoute({
-            fromToken: "USDT",
+    try {
+        if (input.token === "USDC") {
+            const quote = await getDodoRoute({
+                fromToken: "USDC",
+                toToken: "PHRS",
+                amountHuman: "1",
+                walletAddress: QUOTE_WALLET,
+            });
+            return ok({
+                token: "USDC",
+                tokenRegistry: TOKEN_REGISTRY.USDC,
+                priceUsd: { value: "1.00", unit: "USD" },
+                priceInPHRS: {
+                    value: quote.routeAvailable ? parseFloat(quote.amountOut).toFixed(6) : null,
+                    unit: "PHRS",
+                },
+                source: "DODO Route API / FaroSwap liquidity on Pharos testnet",
+                sourceStatus: quote.sourceStatus,
+                routeAvailable: quote.routeAvailable,
+                publicMode: !quote.usedApiKey,
+                confidence: quote.routeAvailable ? "medium" : "low",
+                chainId: CHAIN_ID,
+                environment: PHAROS_ENVIRONMENT,
+                isMainnet: false,
+            });
+        }
+        if (input.token === "USDT") {
+            const usdQuote = await getDodoRoute({
+                fromToken: "USDT",
+                toToken: "USDC",
+                amountHuman: "1",
+                walletAddress: QUOTE_WALLET,
+            });
+            const phrsQuote = await getDodoRoute({
+                fromToken: "USDT",
+                toToken: "PHRS",
+                amountHuman: "1",
+                walletAddress: QUOTE_WALLET,
+            });
+            return ok({
+                token: "USDT",
+                tokenRegistry: TOKEN_REGISTRY.USDT,
+                priceUsd: {
+                    value: usdQuote.routeAvailable ? parseFloat(usdQuote.amountOut).toFixed(4) : "~1.00",
+                    unit: "USD",
+                },
+                priceInPHRS: {
+                    value: phrsQuote.routeAvailable ? parseFloat(phrsQuote.amountOut).toFixed(6) : null,
+                    unit: "PHRS",
+                },
+                source: "DODO Route API / FaroSwap liquidity on Pharos testnet",
+                sourceStatus: usdQuote.routeAvailable && phrsQuote.routeAvailable ? "ok" : usdQuote.routeAvailable || phrsQuote.routeAvailable ? "partial" : "no_route_available",
+                routeAvailable: usdQuote.routeAvailable || phrsQuote.routeAvailable,
+                publicMode: !usdQuote.usedApiKey && !phrsQuote.usedApiKey,
+                confidence: usdQuote.routeAvailable && phrsQuote.routeAvailable ? "medium" : "low",
+                chainId: CHAIN_ID,
+                environment: PHAROS_ENVIRONMENT,
+                isMainnet: false,
+            });
+        }
+        const usdcQuote = await getDodoRoute({
+            fromToken: "PHRS",
             toToken: "USDC",
             amountHuman: "1",
             walletAddress: QUOTE_WALLET,
         });
-        const phrsQuote = await getDodoRoute({
-            fromToken: "USDT",
-            toToken: "PHRS",
-            amountHuman: "1",
-            walletAddress: QUOTE_WALLET,
+        if (!usdcQuote.routeAvailable) {
+            return fail("NO_ROUTE_AVAILABLE", "No PHRS -> USDC route is available for price discovery.", true, "dodo_api");
+        }
+        return ok({
+            token: "PHRS",
+            tokenRegistry: TOKEN_REGISTRY.PHRS,
+            priceUsd: { value: parseFloat(usdcQuote.amountOut).toFixed(4), unit: "USD" },
+            priceInPHRS: { value: "1.000000", unit: "PHRS" },
+            source: "DODO Route API / FaroSwap liquidity on Pharos testnet",
+            sourceStatus: usdcQuote.sourceStatus,
+            routeAvailable: true,
+            publicMode: !usdcQuote.usedApiKey,
+            confidence: "medium",
+            chainId: CHAIN_ID,
+            environment: PHAROS_ENVIRONMENT,
+            isMainnet: false,
         });
-        const priceUsd = usdQuote.routeAvailable ? parseFloat(usdQuote.amountOut).toFixed(4) : "~1.00";
-        const priceInPHRS = phrsQuote.routeAvailable ? parseFloat(phrsQuote.amountOut).toFixed(6) : "unavailable";
-        return {
-            token: "USDT",
-            priceUsd,
-            priceInPHRS,
-            source: "DODO Route API (Pharos Atlantic)",
-            timestamp,
-        };
     }
-    // PHRS — quote 1 PHRS → USDC for USD price
-    const usdcQuote = await getDodoRoute({
-        fromToken: "PHRS",
-        toToken: "USDC",
-        amountHuman: "1",
-        walletAddress: QUOTE_WALLET,
-    });
-    const priceUsd = usdcQuote.routeAvailable
-        ? parseFloat(usdcQuote.amountOut).toFixed(4)
-        : "unavailable";
-    return {
-        token: "PHRS",
-        priceUsd,
-        priceInPHRS: "1.000000",
-        source: "DODO Route API (Pharos Atlantic)",
-        timestamp,
-    };
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (message.includes("DODO_API_AUTH_REQUIRED")) {
+            return fail("DODO_API_AUTH_REQUIRED", "DODO/FaroSwap route API rejected public mode. Configure DODO_API_KEY only if this endpoint requires authenticated access.", false, "dodo_api");
+        }
+        if (message.includes("DODO_API_RATE_LIMITED")) {
+            return fail("DODO_API_RATE_LIMITED", message, true, "dodo_api");
+        }
+        if (message.includes("INVALID_TOKEN_ADDRESS")) {
+            return fail("INVALID_TOKEN_ADDRESS", message, false, "dodo_api");
+        }
+        return classifyExternalError("dodo_api", err);
+    }
 }
 //# sourceMappingURL=getTokenPrice.js.map

package/dist/tools/getTokenPrice.js.map

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

package/dist/tools/getWalletBalance.d.ts

@@ -18,23 +18,52 @@ export declare const getWalletBalanceTool: {
         walletAddress: string;
     }>;
 };
-export declare function handleGetWalletBalance(raw: GetWalletBalanceInput): Promise<{
-    walletAddress: string;
+export declare function handleGetWalletBalance(raw: GetWalletBalanceInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
+    walletAddress: `0x${string}`;
     balances: {
         PHRS: {
-            balance: string;
-            valueUsd: string;
+            balance: {
+                value: string;
+                unit: string;
+            };
+            valueUsd: {
+                value: string;
+                unit: string;
+            };
         };
         USDC: {
-            balance: string;
-            valueUsd: string;
+            balance: {
+                value: string;
+                unit: string;
+            };
+            valueUsd: {
+                value: string;
+                unit: string;
+            };
         };
         USDT: {
-            balance: string;
-            valueUsd: string;
+            balance: {
+                value: string;
+                unit: string;
+            };
+            valueUsd: {
+                value: string;
+                unit: string;
+            };
         };
     };
-    totalUsd: string;
-    phrsPrice: string;
-}>;
+    totalUsd: {
+        value: string;
+        unit: string;
+    };
+    phrsPrice: {
+        value: string;
+        unit: string;
+    } | null;
+    priceSourceStatus: string;
+    chainId: number;
+    environment: string;
+    isMainnet: boolean;
+    source: string;
+}>>;
 //# sourceMappingURL=getWalletBalance.d.ts.map

package/dist/tools/getWalletBalance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getWalletBalance.d.ts","sourceRoot":"","sources":["../../src/tools/getWalletBalance.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,sBAAsB;;;;;;EAEjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,eAAO,MAAM,oBAAoB;;;;;;;;;;CAKhC,CAAC;AAIF,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;GAwDtE"}
+{"version":3,"file":"getWalletBalance.d.ts","sourceRoot":"","sources":["../../src/tools/getWalletBalance.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,sBAAsB;;;;;;EAEjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,eAAO,MAAM,oBAAoB;;;;;;;;;;CAKhC,CAAC;AAIF,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsEtE"}