safehands-pharos 1.4.0 → 1.5.0

package/dist/tools/getTokenPrice.d.ts

@@ -1,114 +1,114 @@
-import { z } from "zod";
-export declare const getTokenPriceSchema: z.ZodObject<{
-    token: z.ZodEnum<["PHRS", "USDC", "USDT"]>;
-}, "strip", z.ZodTypeAny, {
-    token: "PHRS" | "USDC" | "USDT";
-}, {
-    token: "PHRS" | "USDC" | "USDT";
-}>;
-export type GetTokenPriceInput = z.input<typeof getTokenPriceSchema>;
-export declare const getTokenPriceTool: {
-    name: string;
-    description: string;
-    inputSchema: z.ZodObject<{
-        token: z.ZodEnum<["PHRS", "USDC", "USDT"]>;
-    }, "strip", z.ZodTypeAny, {
-        token: "PHRS" | "USDC" | "USDT";
-    }, {
-        token: "PHRS" | "USDC" | "USDT";
-    }>;
-};
-export declare function handleGetTokenPrice(raw: GetTokenPriceInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
-    token: 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;
-    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;
-}>>;
+import { z } from "zod";
+export declare const getTokenPriceSchema: z.ZodObject<{
+    token: z.ZodEnum<["PHRS", "USDC", "USDT"]>;
+}, "strip", z.ZodTypeAny, {
+    token: "PHRS" | "USDC" | "USDT";
+}, {
+    token: "PHRS" | "USDC" | "USDT";
+}>;
+export type GetTokenPriceInput = z.input<typeof getTokenPriceSchema>;
+export declare const getTokenPriceTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        token: z.ZodEnum<["PHRS", "USDC", "USDT"]>;
+    }, "strip", z.ZodTypeAny, {
+        token: "PHRS" | "USDC" | "USDT";
+    }, {
+        token: "PHRS" | "USDC" | "USDT";
+    }>;
+};
+export declare function handleGetTokenPrice(raw: GetTokenPriceInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
+    token: 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;
+    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.js

@@ -1,118 +1,118 @@
-// ─── Tool: get_token_price ─────────────────────────────────────────────
-// 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 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);
-    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,
-        });
-        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,
-        });
-    }
-    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);
-    }
-}
+// ─── Tool: get_token_price ─────────────────────────────────────────────
+// 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 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);
+    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,
+        });
+        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,
+        });
+    }
+    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/getTransactionStatus.d.ts

@@ -1,44 +1,44 @@
-import { z } from "zod";
-export declare const getTransactionStatusSchema: z.ZodObject<{
-    txHash: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    txHash: string;
-}, {
-    txHash: string;
-}>;
-export type GetTransactionStatusInput = z.input<typeof getTransactionStatusSchema>;
-export declare const getTransactionStatusTool: {
-    name: string;
-    description: string;
-    inputSchema: z.ZodObject<{
-        txHash: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        txHash: string;
-    }, {
-        txHash: string;
-    }>;
-};
-export declare function handleGetTransactionStatus(raw: GetTransactionStatusInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
-    txStatus: string;
-    txHash: string;
-    blockNumber: string;
-    blockHash: `0x${string}`;
-    from: `0x${string}`;
-    to: `0x${string}` | null;
-    gasUsed: string;
-    effectiveGasPrice: string;
-    value: string;
-    explorerUrl: string;
-}> | import("../lib/toolResponse.js").ToolSuccess<{
-    txHash: string;
-    txStatus: "pending";
-    blockNumber: null;
-    blockHash: null;
-    from: `0x${string}`;
-    to: `0x${string}` | null;
-    gasUsed: null;
-    effectiveGasPrice: null;
-    value: string;
-    explorerUrl: string;
-}>>;
+import { z } from "zod";
+export declare const getTransactionStatusSchema: z.ZodObject<{
+    txHash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    txHash: string;
+}, {
+    txHash: string;
+}>;
+export type GetTransactionStatusInput = z.input<typeof getTransactionStatusSchema>;
+export declare const getTransactionStatusTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        txHash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        txHash: string;
+    }, {
+        txHash: string;
+    }>;
+};
+export declare function handleGetTransactionStatus(raw: GetTransactionStatusInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
+    txStatus: string;
+    txHash: string;
+    blockNumber: string;
+    blockHash: `0x${string}`;
+    from: `0x${string}`;
+    to: `0x${string}` | null;
+    gasUsed: string;
+    effectiveGasPrice: string;
+    value: string;
+    explorerUrl: string;
+}> | import("../lib/toolResponse.js").ToolSuccess<{
+    txHash: string;
+    txStatus: "pending";
+    blockNumber: null;
+    blockHash: null;
+    from: `0x${string}`;
+    to: `0x${string}` | null;
+    gasUsed: null;
+    effectiveGasPrice: null;
+    value: string;
+    explorerUrl: string;
+}>>;
 //# sourceMappingURL=getTransactionStatus.d.ts.map