safehands-pharos 1.2.0 → 1.2.3

package/dist/tools/explainRisk.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { type ToolResponse } from "../lib/toolResponse.js";
+export declare const explainRiskSchema: z.ZodObject<{
+    decision: z.ZodEnum<["ALLOW", "WARN", "BLOCK", "REQUIRE_CONFIRMATION", "REQUIRE_FUNDING", "REQUIRE_TOKEN_REVIEW"]>;
+    riskLevel: z.ZodEnum<["LOW", "MEDIUM", "HIGH", "CRITICAL", "UNKNOWN"]>;
+    reasons: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    requiredActions: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    environment: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    chainId: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    isMainnet: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    riskLevel: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL" | "UNKNOWN";
+    environment: string;
+    chainId: number;
+    isMainnet: boolean;
+    decision: "ALLOW" | "WARN" | "BLOCK" | "REQUIRE_CONFIRMATION" | "REQUIRE_FUNDING" | "REQUIRE_TOKEN_REVIEW";
+    reasons: string[];
+    requiredActions: string[];
+}, {
+    riskLevel: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL" | "UNKNOWN";
+    decision: "ALLOW" | "WARN" | "BLOCK" | "REQUIRE_CONFIRMATION" | "REQUIRE_FUNDING" | "REQUIRE_TOKEN_REVIEW";
+    environment?: string | undefined;
+    chainId?: number | undefined;
+    isMainnet?: boolean | undefined;
+    reasons?: string[] | undefined;
+    requiredActions?: string[] | undefined;
+}>;
+export type ExplainRiskInput = z.input<typeof explainRiskSchema>;
+export declare function handleExplainRisk(raw: ExplainRiskInput): Promise<ToolResponse<unknown>>;
+//# sourceMappingURL=explainRisk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explainRisk.d.ts","sourceRoot":"","sources":["../../src/tools/explainRisk.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG/D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;EAQ5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAkB7F"}

package/dist/tools/explainRisk.js

@@ -0,0 +1,33 @@
+// ─── Tool: explain_risk ────────────────────────────────────────────────
+import { z } from "zod";
+import { ok } from "../lib/toolResponse.js";
+import { explainPolicyResult } from "../lib/policy/actionPolicyEngine.js";
+export const explainRiskSchema = z.object({
+    decision: z.enum(["ALLOW", "WARN", "BLOCK", "REQUIRE_CONFIRMATION", "REQUIRE_FUNDING", "REQUIRE_TOKEN_REVIEW"]),
+    riskLevel: z.enum(["LOW", "MEDIUM", "HIGH", "CRITICAL", "UNKNOWN"]),
+    reasons: z.array(z.string()).optional().default([]),
+    requiredActions: z.array(z.string()).optional().default([]),
+    environment: z.string().optional().default("atlantic-testnet"),
+    chainId: z.number().optional().default(688689),
+    isMainnet: z.boolean().optional().default(false),
+});
+export async function handleExplainRisk(raw) {
+    const input = explainRiskSchema.parse(raw);
+    const result = {
+        decision: input.decision,
+        riskLevel: input.riskLevel,
+        safeToExecute: input.decision === "ALLOW",
+        reasons: input.reasons,
+        requiredActions: input.requiredActions,
+        checks: [],
+        environment: input.environment,
+        chainId: input.chainId,
+        isMainnet: input.isMainnet,
+    };
+    return ok({
+        explanation: explainPolicyResult(result),
+        ...result,
+        source: "explain_risk",
+    });
+}
+//# sourceMappingURL=explainRisk.js.map

package/dist/tools/explainRisk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainRisk.js","sourceRoot":"","sources":["../../src/tools/explainRisk.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,EAAE,EAAqB,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAA6C,MAAM,qCAAqC,CAAC;AAErH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,sBAAsB,CAAC,CAAC;IAC/G,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACnE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC;IAC9D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IAC9C,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACjD,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAqB;IAC3D,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG;QACb,QAAQ,EAAE,KAAK,CAAC,QAA0B;QAC1C,SAAS,EAAE,KAAK,CAAC,SAA4B;QAC7C,aAAa,EAAE,KAAK,CAAC,QAAQ,KAAK,OAAO;QACzC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,MAAM,EAAE,EAAE;QACV,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;IACF,OAAO,EAAE,CAAC;QACR,WAAW,EAAE,mBAAmB,CAAC,MAAM,CAAC;QACxC,GAAG,MAAM;QACT,MAAM,EAAE,cAAc;KACvB,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/getAgentWallet.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import { type ToolResponse } from "../lib/toolResponse.js";
+export declare const getAgentWalletSchema: z.ZodObject<{
+    agentId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    agentId: string;
+}, {
+    agentId: string;
+}>;
+export type GetAgentWalletParams = z.infer<typeof getAgentWalletSchema>;
+interface GetAgentWalletData {
+    agentId: string;
+    address: string;
+    environment: string;
+    chainId: number;
+    isMainnet: boolean;
+    createdAt: string;
+    explorerUrl: string;
+}
+export declare function handleGetAgentWallet(params: GetAgentWalletParams): Promise<ToolResponse<GetAgentWalletData>>;
+export {};
+//# sourceMappingURL=getAgentWallet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getAgentWallet.d.ts","sourceRoot":"","sources":["../../src/tools/getAgentWallet.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGrE,eAAO,MAAM,oBAAoB;;;;;;EAE/B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,UAAU,kBAAkB;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAwB3C"}

package/dist/tools/getAgentWallet.js

@@ -0,0 +1,28 @@
+// ─── get_agent_wallet ───────────────────────────────────────────────────
+// Returns public info for a managed agent wallet.
+// Never returns private key.
+// ────────────────────────────────────────────────────────────────────────
+import { z } from "zod";
+import { ok, fail } from "../lib/toolResponse.js";
+import { walletStore } from "../lib/wallet/index.js";
+export const getAgentWalletSchema = z.object({
+    agentId: z.string().min(1).max(64).describe("Agent wallet identifier"),
+});
+export async function handleGetAgentWallet(params) {
+    const { agentId } = params;
+    const wallet = await walletStore.get(agentId);
+    if (!wallet) {
+        return fail("WALLET_NOT_FOUND", `No wallet found for agentId '${agentId}'. Use create_agent_wallet to create one.`, false, "wallet_store");
+    }
+    const explorerBase = process.env.PHAROS_EXPLORER_BASE || "https://atlantic.pharosscan.xyz/address/";
+    return ok({
+        agentId: wallet.agentId,
+        address: wallet.address,
+        environment: wallet.environment,
+        chainId: wallet.chainId,
+        isMainnet: wallet.isMainnet,
+        createdAt: wallet.createdAt,
+        explorerUrl: `${explorerBase}${wallet.address}`,
+    });
+}
+//# sourceMappingURL=getAgentWallet.js.map

package/dist/tools/getAgentWallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAgentWallet.js","sourceRoot":"","sources":["../../src/tools/getAgentWallet.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,kDAAkD;AAClD,6BAA6B;AAC7B,2EAA2E;AAE3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAqB,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CACvE,CAAC,CAAC;AAcH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAA4B;IAE5B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAE3B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CACT,kBAAkB,EAClB,gCAAgC,OAAO,2CAA2C,EAClF,KAAK,EACL,cAAc,CACf,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,0CAA0C,CAAC;IAEpG,OAAO,EAAE,CAAC;QACR,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,GAAG,YAAY,GAAG,MAAM,CAAC,OAAO,EAAE;KAChD,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/getAgentWalletBalance.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+import { type ToolResponse } from "../lib/toolResponse.js";
+export declare const getAgentWalletBalanceSchema: z.ZodObject<{
+    agentId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    agentId: string;
+}, {
+    agentId: string;
+}>;
+export type GetAgentWalletBalanceParams = z.infer<typeof getAgentWalletBalanceSchema>;
+export declare function handleGetAgentWalletBalance(params: GetAgentWalletBalanceParams): Promise<ToolResponse<unknown>>;
+//# sourceMappingURL=getAgentWalletBalance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getAgentWalletBalance.d.ts","sourceRoot":"","sources":["../../src/tools/getAgentWalletBalance.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAmC,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAM5F,eAAO,MAAM,2BAA2B;;;;;;EAEtC,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAYtF,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAyDhC"}

package/dist/tools/getAgentWalletBalance.js

@@ -0,0 +1,71 @@
+// ─── get_agent_wallet_balance ───────────────────────────────────────────
+// Returns PHRS + token balances for a managed agent wallet.
+// ────────────────────────────────────────────────────────────────────────
+import { z } from "zod";
+import { ok, fail, classifyExternalError } from "../lib/toolResponse.js";
+import { walletStore } from "../lib/wallet/index.js";
+import { publicClient } from "../lib/pharosClient.js";
+import { TOKEN_REGISTRY } from "../lib/constants.js";
+import { formatUnits } from "viem";
+export const getAgentWalletBalanceSchema = z.object({
+    agentId: z.string().min(1).max(64).describe("Agent wallet identifier"),
+});
+const ERC20_ABI = [
+    {
+        name: "balanceOf",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "account", type: "address" }],
+        outputs: [{ name: "", type: "uint256" }],
+    },
+];
+export async function handleGetAgentWalletBalance(params) {
+    const { agentId } = params;
+    const wallet = await walletStore.get(agentId);
+    if (!wallet) {
+        return fail("WALLET_NOT_FOUND", `No wallet found for agentId '${agentId}'. Use create_agent_wallet to create one.`, false, "wallet_store");
+    }
+    const address = wallet.address;
+    try {
+        const [phrsRaw, usdcRaw, usdtRaw] = await Promise.all([
+            publicClient.getBalance({ address }),
+            publicClient.readContract({
+                address: TOKEN_REGISTRY.USDC.address,
+                abi: ERC20_ABI,
+                functionName: "balanceOf",
+                args: [address],
+            }),
+            publicClient.readContract({
+                address: TOKEN_REGISTRY.USDT.address,
+                abi: ERC20_ABI,
+                functionName: "balanceOf",
+                args: [address],
+            }),
+        ]);
+        const phrs = formatUnits(phrsRaw, 18);
+        const usdc = formatUnits(usdcRaw, 6);
+        const usdt = formatUnits(usdtRaw, 6);
+        const isFunded = parseFloat(phrs) > 0;
+        return ok({
+            agentId,
+            address,
+            environment: wallet.environment,
+            chainId: wallet.chainId,
+            isMainnet: false,
+            explorerUrl: `https://atlantic.pharosscan.xyz/address/${address}`,
+            balances: {
+                PHRS: { value: phrs, unit: "PHRS", decimals: 18 },
+                USDC: { value: usdc, unit: "USDC", decimals: 6 },
+                USDT: { value: usdt, unit: "USDT", decimals: 6 },
+            },
+            isFunded,
+            fundingInstructions: isFunded
+                ? null
+                : `Wallet is unfunded. Get testnet PHRS from https://testnet.pharosnetwork.xyz/ — wallet address: ${address}`,
+        });
+    }
+    catch (err) {
+        return classifyExternalError("pharos_rpc", err);
+    }
+}
+//# sourceMappingURL=getAgentWalletBalance.js.map

package/dist/tools/getAgentWalletBalance.js.map

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

package/dist/tools/getExecutionHistory.d.ts

@@ -4,12 +4,12 @@ export declare const getExecutionHistorySchema: z.ZodObject<{
     limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     filter: z.ZodDefault<z.ZodOptional<z.ZodEnum<["swap", "transfer", "all"]>>>;
 }, "strip", z.ZodTypeAny, {
-    filter: "transfer" | "swap" | "all";
+    filter: "transfer" | "all" | "swap";
     walletAddress: string;
     limit: number;
 }, {
     walletAddress: string;
-    filter?: "transfer" | "swap" | "all" | undefined;
+    filter?: "transfer" | "all" | "swap" | undefined;
     limit?: number | undefined;
 }>;
 export type GetExecutionHistoryInput = z.infer<typeof getExecutionHistorySchema>;
@@ -21,12 +21,12 @@ export declare const getExecutionHistoryTool: {
         limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         filter: z.ZodDefault<z.ZodOptional<z.ZodEnum<["swap", "transfer", "all"]>>>;
     }, "strip", z.ZodTypeAny, {
-        filter: "transfer" | "swap" | "all";
+        filter: "transfer" | "all" | "swap";
         walletAddress: string;
         limit: number;
     }, {
         walletAddress: string;
-        filter?: "transfer" | "swap" | "all" | undefined;
+        filter?: "transfer" | "all" | "swap" | undefined;
         limit?: number | undefined;
     }>;
 };

package/dist/tools/getGasPrice.d.ts

@@ -6,21 +6,39 @@ export declare const getGasPriceTool: {
     description: string;
     inputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
 };
-export declare function handleGetGasPrice(_raw: GetGasPriceInput): Promise<{
-    gasPriceGwei: string;
+export declare function handleGetGasPrice(_raw: GetGasPriceInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
+    gasPrice: {
+        value: string;
+        unit: string;
+    };
     gasPriceWei: string;
     trend: "low" | "high" | "normal";
     recommendation: string;
     estimates: {
         nativeTransfer: {
-            gas: string;
-            costPHRS: string;
+            gas: {
+                value: string;
+                unit: string;
+            };
+            costPHRS: {
+                value: string;
+                unit: string;
+            };
         };
         tokenSwap: {
-            gas: string;
-            costPHRS: string;
+            gas: {
+                value: string;
+                unit: string;
+            };
+            costPHRS: {
+                value: string;
+                unit: string;
+            };
         };
     };
-    timestamp: string;
-}>;
+    chainId: number;
+    environment: string;
+    isMainnet: boolean;
+    source: string;
+}>>;
 //# sourceMappingURL=getGasPrice.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getGasPrice.d.ts","sourceRoot":"","sources":["../../src/tools/getGasPrice.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,iBAAiB,gDAAe,CAAC;AAE9C,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,eAAe;;;;CAK3B,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB;;;;;;;;;;;;;;;;GAwC7D"}
+{"version":3,"file":"getGasPrice.d.ts","sourceRoot":"","sources":["../../src/tools/getGasPrice.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,iBAAiB,gDAAe,CAAC;AAE9C,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,eAAe;;;;CAK3B,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6C7D"}

package/dist/tools/getGasPrice.js

@@ -4,6 +4,8 @@
 import { z } from "zod";
 import { publicClient } from "../lib/pharosClient.js";
 import { formatGwei } from "viem";
+import { CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
+import { classifyExternalError, ok } from "../lib/toolResponse.js";
 export const getGasPriceSchema = z.object({});
 export const getGasPriceTool = {
     name: "get_gas_price",
@@ -11,42 +13,48 @@ export const getGasPriceTool = {
     inputSchema: getGasPriceSchema,
 };
 export async function handleGetGasPrice(_raw) {
-    const gasPrice = await publicClient.getGasPrice();
-    const gasPriceGwei = parseFloat(formatGwei(gasPrice));
-    // Classify trend based on Pharos testnet typical gas ranges
-    let trend;
-    let recommendation;
-    if (gasPriceGwei <= 5) {
-        trend = "low";
-        recommendation = "Gas is cheap. Good time to execute transactions.";
-    }
-    else if (gasPriceGwei <= 50) {
-        trend = "normal";
-        recommendation = "Gas is at normal levels. Proceed with standard transactions.";
+    try {
+        const gasPrice = await publicClient.getGasPrice();
+        const gasPriceGwei = parseFloat(formatGwei(gasPrice));
+        let trend;
+        let recommendation;
+        if (gasPriceGwei <= 5) {
+            trend = "low";
+            recommendation = "Gas is cheap. Good time to execute testnet transactions.";
+        }
+        else if (gasPriceGwei <= 50) {
+            trend = "normal";
+            recommendation = "Gas is at normal testnet levels. Proceed with standard transactions.";
+        }
+        else {
+            trend = "high";
+            recommendation = "Gas is elevated. Consider waiting or reducing transaction complexity.";
+        }
+        const transferCostWei = gasPrice * 21000n;
+        const swapCostWei = gasPrice * 250000n;
+        return ok({
+            gasPrice: { value: gasPriceGwei.toFixed(4), unit: "gwei" },
+            gasPriceWei: gasPrice.toString(),
+            trend,
+            recommendation,
+            estimates: {
+                nativeTransfer: {
+                    gas: { value: "21000", unit: "gas" },
+                    costPHRS: { value: (Number(transferCostWei) / 1e18).toFixed(8), unit: "PHRS" },
+                },
+                tokenSwap: {
+                    gas: { value: "250000", unit: "gas" },
+                    costPHRS: { value: (Number(swapCostWei) / 1e18).toFixed(8), unit: "PHRS" },
+                },
+            },
+            chainId: CHAIN_ID,
+            environment: PHAROS_ENVIRONMENT,
+            isMainnet: false,
+            source: "pharos_rpc",
+        });
     }
-    else {
-        trend = "high";
-        recommendation = "Gas is elevated. Consider waiting or reducing transaction complexity.";
+    catch (err) {
+        return classifyExternalError("pharos_rpc", err);
     }
-    // Estimate costs for common operations
-    const transferCostWei = gasPrice * 21000n;
-    const swapCostWei = gasPrice * 250000n; // typical swap gas
-    return {
-        gasPriceGwei: gasPriceGwei.toFixed(4),
-        gasPriceWei: gasPrice.toString(),
-        trend,
-        recommendation,
-        estimates: {
-            nativeTransfer: {
-                gas: "21,000",
-                costPHRS: (Number(transferCostWei) / 1e18).toFixed(8),
-            },
-            tokenSwap: {
-                gas: "~250,000",
-                costPHRS: (Number(swapCostWei) / 1e18).toFixed(8),
-            },
-        },
-        timestamp: new Date().toISOString(),
-    };
 }
 //# sourceMappingURL=getGasPrice.js.map

package/dist/tools/getGasPrice.js.map

@@ -1 +1 @@
-{"version":3,"file":"getGasPrice.js","sourceRoot":"","sources":["../../src/tools/getGasPrice.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,iEAAiE;AACjE,2EAA2E;AAE3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAElC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAI9C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,sHAAsH;IACxH,WAAW,EAAE,iBAAiB;CAC/B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAsB;IAC5D,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,YAAY,GAAG,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEtD,4DAA4D;IAC5D,IAAI,KAAgC,CAAC;IACrC,IAAI,cAAsB,CAAC;IAE3B,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QACtB,KAAK,GAAG,KAAK,CAAC;QACd,cAAc,GAAG,kDAAkD,CAAC;IACtE,CAAC;SAAM,IAAI,YAAY,IAAI,EAAE,EAAE,CAAC;QAC9B,KAAK,GAAG,QAAQ,CAAC;QACjB,cAAc,GAAG,8DAA8D,CAAC;IAClF,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,MAAM,CAAC;QACf,cAAc,GAAG,uEAAuE,CAAC;IAC3F,CAAC;IAED,uCAAuC;IACvC,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC1C,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC,CAAC,mBAAmB;IAE3D,OAAO;QACL,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QACrC,WAAW,EAAE,QAAQ,CAAC,QAAQ,EAAE;QAChC,KAAK;QACL,cAAc;QACd,SAAS,EAAE;YACT,cAAc,EAAE;gBACd,GAAG,EAAE,QAAQ;gBACb,QAAQ,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;aACtD;YACD,SAAS,EAAE;gBACT,GAAG,EAAE,UAAU;gBACf,QAAQ,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;aAClD;SACF;QACD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"getGasPrice.js","sourceRoot":"","sources":["../../src/tools/getGasPrice.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,iEAAiE;AACjE,2EAA2E;AAE3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAC;AAEnE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAI9C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,sHAAsH;IACxH,WAAW,EAAE,iBAAiB;CAC/B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAsB;IAC5D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,CAAC;QAClD,MAAM,YAAY,GAAG,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEtD,IAAI,KAAgC,CAAC;QACrC,IAAI,cAAsB,CAAC;QAE3B,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;YACtB,KAAK,GAAG,KAAK,CAAC;YACd,cAAc,GAAG,0DAA0D,CAAC;QAC9E,CAAC;aAAM,IAAI,YAAY,IAAI,EAAE,EAAE,CAAC;YAC9B,KAAK,GAAG,QAAQ,CAAC;YACjB,cAAc,GAAG,sEAAsE,CAAC;QAC1F,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,MAAM,CAAC;YACf,cAAc,GAAG,uEAAuE,CAAC;QAC3F,CAAC;QAED,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,CAAC;QAC1C,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;QAEvC,OAAO,EAAE,CAAC;YACR,QAAQ,EAAE,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;YAC1D,WAAW,EAAE,QAAQ,CAAC,QAAQ,EAAE;YAChC,KAAK;YACL,cAAc;YACd,SAAS,EAAE;gBACT,cAAc,EAAE;oBACd,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE;oBACpC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;iBAC/E;gBACD,SAAS,EAAE;oBACT,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE;oBACrC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;iBAC3E;aACF;YACD,OAAO,EAAE,QAAQ;YACjB,WAAW,EAAE,kBAAkB;YAC/B,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,YAAY;SACrB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,qBAAqB,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}

package/dist/tools/getPoolInfo.d.ts

@@ -3,11 +3,11 @@ export declare const getPoolInfoSchema: z.ZodObject<{
     tokenA: z.ZodEnum<["PHRS", "USDC", "USDT"]>;
     tokenB: z.ZodEnum<["PHRS", "USDC", "USDT"]>;
 }, "strip", z.ZodTypeAny, {
-    tokenA: "PHRS" | "USDT" | "USDC";
-    tokenB: "PHRS" | "USDT" | "USDC";
+    tokenA: "PHRS" | "USDC" | "USDT";
+    tokenB: "PHRS" | "USDC" | "USDT";
 }, {
-    tokenA: "PHRS" | "USDT" | "USDC";
-    tokenB: "PHRS" | "USDT" | "USDC";
+    tokenA: "PHRS" | "USDC" | "USDT";
+    tokenB: "PHRS" | "USDC" | "USDT";
 }>;
 export type GetPoolInfoInput = z.input<typeof getPoolInfoSchema>;
 export declare const getPoolInfoTool: {
@@ -17,72 +17,60 @@ export declare const getPoolInfoTool: {
         tokenA: z.ZodEnum<["PHRS", "USDC", "USDT"]>;
         tokenB: z.ZodEnum<["PHRS", "USDC", "USDT"]>;
     }, "strip", z.ZodTypeAny, {
-        tokenA: "PHRS" | "USDT" | "USDC";
-        tokenB: "PHRS" | "USDT" | "USDC";
+        tokenA: "PHRS" | "USDC" | "USDT";
+        tokenB: "PHRS" | "USDC" | "USDT";
     }, {
-        tokenA: "PHRS" | "USDT" | "USDC";
-        tokenB: "PHRS" | "USDT" | "USDC";
+        tokenA: "PHRS" | "USDC" | "USDT";
+        tokenB: "PHRS" | "USDC" | "USDT";
     }>;
 };
-export declare function handleGetPoolInfo(raw: GetPoolInfoInput): Promise<{
-    pair: string;
-    error: string;
-    available?: undefined;
-    message?: undefined;
-    timestamp?: undefined;
-    priceRatio?: undefined;
-    priceImpact?: undefined;
-    pricePerFromToken?: undefined;
-    pricePerToToken?: undefined;
-    fee?: undefined;
-    liquidity?: undefined;
-    source?: undefined;
-    chainId?: undefined;
-} | {
+export declare function handleGetPoolInfo(raw: GetPoolInfoInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
     pair: string;
     available: boolean;
     message: string;
-    timestamp: string;
-    error?: undefined;
-    priceRatio?: undefined;
-    priceImpact?: undefined;
-    pricePerFromToken?: undefined;
-    pricePerToToken?: undefined;
-    fee?: undefined;
-    liquidity?: undefined;
-    source?: undefined;
-    chainId?: undefined;
-} | {
+    source: string;
+    sourceStatus: string;
+    publicMode: boolean;
+    chainId: number;
+    environment: string;
+    isMainnet: boolean;
+}> | import("../lib/toolResponse.js").ToolSuccess<{
     pair: string;
     available: boolean;
-    priceRatio: string;
-    priceImpact: string;
-    pricePerFromToken: string;
-    pricePerToToken: string;
-    fee: string;
-    liquidity: string | {
+    priceRatio: {
+        value: string;
+        unit: "PHRS" | "USDC" | "USDT";
+        per: string;
+    } | null;
+    priceImpact: {
+        value: string;
+        unit: string;
+    };
+    pricePerFromToken: {
+        value: string;
+        unit: "PHRS" | "USDC" | "USDT";
+    } | null;
+    pricePerToToken: {
+        value: string;
+        unit: "PHRS" | "USDC" | "USDT";
+    } | null;
+    fee: {
+        value: string;
+        unit: string;
+    } | null;
+    liquidity: {
         baseLiquidity: string;
         quoteLiquidity: string;
         poolType: string;
-    };
+    } | null;
+    poolListStatus: string;
     source: string;
+    sourceStatus: string;
+    publicMode: boolean;
+    routeAvailable: boolean;
+    confidence: string;
     chainId: number;
-    timestamp: string;
-    error?: undefined;
-    message?: undefined;
-} | {
-    pair: string;
-    available: boolean;
-    error: string;
-    timestamp: string;
-    message?: undefined;
-    priceRatio?: undefined;
-    priceImpact?: undefined;
-    pricePerFromToken?: undefined;
-    pricePerToToken?: undefined;
-    fee?: undefined;
-    liquidity?: undefined;
-    source?: undefined;
-    chainId?: undefined;
-}>;
+    environment: string;
+    isMainnet: boolean;
+}>>;
 //# sourceMappingURL=getPoolInfo.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getPoolInfo.d.ts","sourceRoot":"","sources":["../../src/tools/getPoolInfo.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAK3B,CAAC;AAiBF,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAyDrB,MAAM;wBAAkB,MAAM;kBAAY,MAAM;;;;;;;;;;;;;;;;;;;;;GA6CvF"}
+{"version":3,"file":"getPoolInfo.d.ts","sourceRoot":"","sources":["../../src/tools/getPoolInfo.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAK3B,CAAC;AA4BF,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA8ErB,MAAM;wBAAkB,MAAM;kBAAY,MAAM;;;;;;;;;;;IAwDvF"}