safehands-pharos 1.4.0 → 1.5.0

package/dist/tools/getTransactionStatus.js

@@ -1,60 +1,60 @@
-// ─── Tool: get_transaction_status ──────────────────────────────────────
-// Checks on-chain transaction status by hash via viem.
-// ────────────────────────────────────────────────────────────────────────
-import { z } from "zod";
-import { publicClient, getExplorerUrl } from "../lib/pharosClient.js";
-import { ok, fail } from "../lib/toolResponse.js";
-export const getTransactionStatusSchema = z.object({
-    txHash: z.string().describe("Transaction hash to look up"),
-});
-export const getTransactionStatusTool = {
-    name: "get_transaction_status",
-    description: "Check the on-chain status of a transaction by its hash. Returns status, block number, gas used, and explorer link.",
-    inputSchema: getTransactionStatusSchema,
-};
-export async function handleGetTransactionStatus(raw) {
-    const input = getTransactionStatusSchema.parse(raw);
-    const hash = input.txHash;
-    // Try to get the receipt first (only exists if tx is mined)
-    try {
-        const receipt = await publicClient.getTransactionReceipt({ hash });
-        const tx = await publicClient.getTransaction({ hash });
-        const details = {
-            txHash: input.txHash,
-            blockNumber: receipt.blockNumber.toString(),
-            blockHash: receipt.blockHash,
-            from: receipt.from,
-            to: receipt.to,
-            gasUsed: receipt.gasUsed.toString(),
-            effectiveGasPrice: receipt.effectiveGasPrice.toString(),
-            value: tx.value.toString(),
-            explorerUrl: getExplorerUrl(input.txHash),
-        };
-        if (receipt.status !== "success") {
-            return fail("TX_REVERTED", "Transaction was mined but reverted on-chain.", false, "get_transaction_status");
-        }
-        return ok({ ...details, txStatus: "success" });
-    }
-    catch {
-        // Receipt not found — check if the tx exists at all (pending)
-        try {
-            const tx = await publicClient.getTransaction({ hash });
-            return ok({
-                txHash: input.txHash,
-                txStatus: "pending",
-                blockNumber: null,
-                blockHash: null,
-                from: tx.from,
-                to: tx.to,
-                gasUsed: null,
-                effectiveGasPrice: null,
-                value: tx.value.toString(),
-                explorerUrl: getExplorerUrl(input.txHash),
-            });
-        }
-        catch {
-            return fail("TX_NOT_FOUND", "Transaction not found on chain.", false, "get_transaction_status");
-        }
-    }
-}
+// ─── Tool: get_transaction_status ──────────────────────────────────────
+// Checks on-chain transaction status by hash via viem.
+// ────────────────────────────────────────────────────────────────────────
+import { z } from "zod";
+import { publicClient, getExplorerUrl } from "../lib/pharosClient.js";
+import { ok, fail } from "../lib/toolResponse.js";
+export const getTransactionStatusSchema = z.object({
+    txHash: z.string().describe("Transaction hash to look up"),
+});
+export const getTransactionStatusTool = {
+    name: "get_transaction_status",
+    description: "Check the on-chain status of a transaction by its hash. Returns status, block number, gas used, and explorer link.",
+    inputSchema: getTransactionStatusSchema,
+};
+export async function handleGetTransactionStatus(raw) {
+    const input = getTransactionStatusSchema.parse(raw);
+    const hash = input.txHash;
+    // Try to get the receipt first (only exists if tx is mined)
+    try {
+        const receipt = await publicClient.getTransactionReceipt({ hash });
+        const tx = await publicClient.getTransaction({ hash });
+        const details = {
+            txHash: input.txHash,
+            blockNumber: receipt.blockNumber.toString(),
+            blockHash: receipt.blockHash,
+            from: receipt.from,
+            to: receipt.to,
+            gasUsed: receipt.gasUsed.toString(),
+            effectiveGasPrice: receipt.effectiveGasPrice.toString(),
+            value: tx.value.toString(),
+            explorerUrl: getExplorerUrl(input.txHash),
+        };
+        if (receipt.status !== "success") {
+            return fail("TX_REVERTED", "Transaction was mined but reverted on-chain.", false, "get_transaction_status");
+        }
+        return ok({ ...details, txStatus: "success" });
+    }
+    catch {
+        // Receipt not found — check if the tx exists at all (pending)
+        try {
+            const tx = await publicClient.getTransaction({ hash });
+            return ok({
+                txHash: input.txHash,
+                txStatus: "pending",
+                blockNumber: null,
+                blockHash: null,
+                from: tx.from,
+                to: tx.to,
+                gasUsed: null,
+                effectiveGasPrice: null,
+                value: tx.value.toString(),
+                explorerUrl: getExplorerUrl(input.txHash),
+            });
+        }
+        catch {
+            return fail("TX_NOT_FOUND", "Transaction not found on chain.", false, "get_transaction_status");
+        }
+    }
+}
 //# sourceMappingURL=getTransactionStatus.js.map

package/dist/tools/getWalletBalance.d.ts

@@ -1,69 +1,69 @@
-import { z } from "zod";
-export declare const getWalletBalanceSchema: z.ZodObject<{
-    walletAddress: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    walletAddress: string;
-}, {
-    walletAddress: string;
-}>;
-export type GetWalletBalanceInput = z.input<typeof getWalletBalanceSchema>;
-export declare const getWalletBalanceTool: {
-    name: string;
-    description: string;
-    inputSchema: z.ZodObject<{
-        walletAddress: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        walletAddress: string;
-    }, {
-        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: {
-                value: string;
-                unit: string;
-            };
-            valueUsd: {
-                value: string;
-                unit: string;
-            };
-        };
-        USDC: {
-            balance: {
-                value: string;
-                unit: string;
-            };
-            valueUsd: {
-                value: string;
-                unit: string;
-            };
-        };
-        USDT: {
-            balance: {
-                value: string;
-                unit: string;
-            };
-            valueUsd: {
-                value: string;
-                unit: string;
-            };
-        };
-    };
-    totalUsd: {
-        value: string;
-        unit: string;
-    };
-    phrsPrice: {
-        value: string;
-        unit: string;
-    } | null;
-    priceSourceStatus: string;
-    chainId: number;
-    environment: string;
-    isMainnet: boolean;
-    source: string;
-}>>;
+import { z } from "zod";
+export declare const getWalletBalanceSchema: z.ZodObject<{
+    walletAddress: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    walletAddress: string;
+}, {
+    walletAddress: string;
+}>;
+export type GetWalletBalanceInput = z.input<typeof getWalletBalanceSchema>;
+export declare const getWalletBalanceTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        walletAddress: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        walletAddress: string;
+    }, {
+        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: {
+                value: string;
+                unit: string;
+            };
+            valueUsd: {
+                value: string;
+                unit: string;
+            };
+        };
+        USDC: {
+            balance: {
+                value: string;
+                unit: string;
+            };
+            valueUsd: {
+                value: string;
+                unit: string;
+            };
+        };
+        USDT: {
+            balance: {
+                value: string;
+                unit: string;
+            };
+            valueUsd: {
+                value: string;
+                unit: 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.js

@@ -1,88 +1,88 @@
-// ─── Tool: get_wallet_balance ──────────────────────────────────────────
-// Returns PHRS, USDC, USDT balances for a wallet using viem reads.
-// ────────────────────────────────────────────────────────────────────────
-import { z } from "zod";
-import { publicClient } from "../lib/pharosClient.js";
-import { getDodoRoute } from "../lib/dodoApi.js";
-import { USDC_ADDRESS, USDT_ADDRESS, ERC20_ABI, CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
-import { formatEther, formatUnits, isAddress } from "viem";
-import { classifyExternalError, fail, ok } from "../lib/toolResponse.js";
-export const getWalletBalanceSchema = z.object({
-    walletAddress: z.string().describe("Wallet address to check balances for"),
-});
-export const getWalletBalanceTool = {
-    name: "get_wallet_balance",
-    description: "Return PHRS (native), USDC, and USDT balances for a wallet on Pharos Atlantic Testnet, with total USD estimate.",
-    inputSchema: getWalletBalanceSchema,
-};
-const QUOTE_WALLET = "0x0000000000000000000000000000000000000001";
-export async function handleGetWalletBalance(raw) {
-    const input = getWalletBalanceSchema.parse(raw);
-    if (!isAddress(input.walletAddress)) {
-        return fail("INVALID_WALLET_ADDRESS", `Invalid wallet address: ${input.walletAddress}`, false, "get_wallet_balance");
-    }
-    const addr = input.walletAddress;
-    try {
-        const [phrsBalanceWei, usdcBalanceRaw, usdtBalanceRaw] = await Promise.all([
-            publicClient.getBalance({ address: addr }),
-            publicClient.readContract({
-                address: USDC_ADDRESS,
-                abi: ERC20_ABI,
-                functionName: "balanceOf",
-                args: [addr],
-            }),
-            publicClient.readContract({
-                address: USDT_ADDRESS,
-                abi: ERC20_ABI,
-                functionName: "balanceOf",
-                args: [addr],
-            }),
-        ]);
-        const phrsBalance = formatEther(phrsBalanceWei);
-        const usdcBalance = formatUnits(usdcBalanceRaw, 6);
-        const usdtBalance = formatUnits(usdtBalanceRaw, 6);
-        let phrsUsd = 0;
-        let priceSourceStatus = "unavailable";
-        try {
-            const quote = await getDodoRoute({
-                fromToken: "PHRS",
-                toToken: "USDC",
-                amountHuman: "1",
-                walletAddress: QUOTE_WALLET,
-            });
-            if (quote.routeAvailable) {
-                phrsUsd = parseFloat(quote.amountOut);
-                priceSourceStatus = "ok";
-            }
-            else {
-                priceSourceStatus = "no_route_available";
-            }
-        }
-        catch {
-            priceSourceStatus = "unavailable";
-        }
-        const phrsValueUsd = parseFloat(phrsBalance) * phrsUsd;
-        const usdcValueUsd = parseFloat(usdcBalance);
-        const usdtValueUsd = parseFloat(usdtBalance);
-        const totalUsd = (phrsValueUsd + usdcValueUsd + usdtValueUsd).toFixed(4);
-        return ok({
-            walletAddress: input.walletAddress,
-            balances: {
-                PHRS: { balance: { value: phrsBalance, unit: "PHRS" }, valueUsd: { value: phrsValueUsd.toFixed(4), unit: "USD" } },
-                USDC: { balance: { value: usdcBalance, unit: "USDC" }, valueUsd: { value: usdcValueUsd.toFixed(4), unit: "USD" } },
-                USDT: { balance: { value: usdtBalance, unit: "USDT" }, valueUsd: { value: usdtValueUsd.toFixed(4), unit: "USD" } },
-            },
-            totalUsd: { value: totalUsd, unit: "USD" },
-            phrsPrice: phrsUsd > 0 ? { value: phrsUsd.toFixed(4), unit: "USD" } : null,
-            priceSourceStatus,
-            chainId: CHAIN_ID,
-            environment: PHAROS_ENVIRONMENT,
-            isMainnet: false,
-            source: "pharos_rpc",
-        });
-    }
-    catch (err) {
-        return classifyExternalError("pharos_rpc", err);
-    }
-}
+// ─── Tool: get_wallet_balance ──────────────────────────────────────────
+// Returns PHRS, USDC, USDT balances for a wallet using viem reads.
+// ────────────────────────────────────────────────────────────────────────
+import { z } from "zod";
+import { publicClient } from "../lib/pharosClient.js";
+import { getDodoRoute } from "../lib/dodoApi.js";
+import { USDC_ADDRESS, USDT_ADDRESS, ERC20_ABI, CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
+import { formatEther, formatUnits, isAddress } from "viem";
+import { classifyExternalError, fail, ok } from "../lib/toolResponse.js";
+export const getWalletBalanceSchema = z.object({
+    walletAddress: z.string().describe("Wallet address to check balances for"),
+});
+export const getWalletBalanceTool = {
+    name: "get_wallet_balance",
+    description: "Return PHRS (native), USDC, and USDT balances for a wallet on Pharos Atlantic Testnet, with total USD estimate.",
+    inputSchema: getWalletBalanceSchema,
+};
+const QUOTE_WALLET = "0x0000000000000000000000000000000000000001";
+export async function handleGetWalletBalance(raw) {
+    const input = getWalletBalanceSchema.parse(raw);
+    if (!isAddress(input.walletAddress)) {
+        return fail("INVALID_WALLET_ADDRESS", `Invalid wallet address: ${input.walletAddress}`, false, "get_wallet_balance");
+    }
+    const addr = input.walletAddress;
+    try {
+        const [phrsBalanceWei, usdcBalanceRaw, usdtBalanceRaw] = await Promise.all([
+            publicClient.getBalance({ address: addr }),
+            publicClient.readContract({
+                address: USDC_ADDRESS,
+                abi: ERC20_ABI,
+                functionName: "balanceOf",
+                args: [addr],
+            }),
+            publicClient.readContract({
+                address: USDT_ADDRESS,
+                abi: ERC20_ABI,
+                functionName: "balanceOf",
+                args: [addr],
+            }),
+        ]);
+        const phrsBalance = formatEther(phrsBalanceWei);
+        const usdcBalance = formatUnits(usdcBalanceRaw, 6);
+        const usdtBalance = formatUnits(usdtBalanceRaw, 6);
+        let phrsUsd = 0;
+        let priceSourceStatus = "unavailable";
+        try {
+            const quote = await getDodoRoute({
+                fromToken: "PHRS",
+                toToken: "USDC",
+                amountHuman: "1",
+                walletAddress: QUOTE_WALLET,
+            });
+            if (quote.routeAvailable) {
+                phrsUsd = parseFloat(quote.amountOut);
+                priceSourceStatus = "ok";
+            }
+            else {
+                priceSourceStatus = "no_route_available";
+            }
+        }
+        catch {
+            priceSourceStatus = "unavailable";
+        }
+        const phrsValueUsd = parseFloat(phrsBalance) * phrsUsd;
+        const usdcValueUsd = parseFloat(usdcBalance);
+        const usdtValueUsd = parseFloat(usdtBalance);
+        const totalUsd = (phrsValueUsd + usdcValueUsd + usdtValueUsd).toFixed(4);
+        return ok({
+            walletAddress: input.walletAddress,
+            balances: {
+                PHRS: { balance: { value: phrsBalance, unit: "PHRS" }, valueUsd: { value: phrsValueUsd.toFixed(4), unit: "USD" } },
+                USDC: { balance: { value: usdcBalance, unit: "USDC" }, valueUsd: { value: usdcValueUsd.toFixed(4), unit: "USD" } },
+                USDT: { balance: { value: usdtBalance, unit: "USDT" }, valueUsd: { value: usdtValueUsd.toFixed(4), unit: "USD" } },
+            },
+            totalUsd: { value: totalUsd, unit: "USD" },
+            phrsPrice: phrsUsd > 0 ? { value: phrsUsd.toFixed(4), unit: "USD" } : null,
+            priceSourceStatus,
+            chainId: CHAIN_ID,
+            environment: PHAROS_ENVIRONMENT,
+            isMainnet: false,
+            source: "pharos_rpc",
+        });
+    }
+    catch (err) {
+        return classifyExternalError("pharos_rpc", err);
+    }
+}
 //# sourceMappingURL=getWalletBalance.js.map

package/dist/tools/publishRiskScore.d.ts

@@ -1,64 +1,64 @@
-import { z } from "zod";
-export declare const publishRiskScoreSchema: z.ZodObject<{
-    action: z.ZodEnum<["swap", "transfer"]>;
-    tokenIn: z.ZodOptional<z.ZodString>;
-    tokenOut: z.ZodOptional<z.ZodString>;
-    amount: z.ZodString;
-    toAddress: z.ZodOptional<z.ZodString>;
-    agentId: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    amount: string;
-    action: "transfer" | "swap";
-    tokenIn?: string | undefined;
-    tokenOut?: string | undefined;
-    agentId?: string | undefined;
-    toAddress?: string | undefined;
-}, {
-    amount: string;
-    action: "transfer" | "swap";
-    tokenIn?: string | undefined;
-    tokenOut?: string | undefined;
-    agentId?: string | undefined;
-    toAddress?: string | undefined;
-}>;
-export type PublishRiskScoreInput = z.input<typeof publishRiskScoreSchema>;
-export declare const publishRiskScoreTool: {
-    name: string;
-    description: string;
-    inputSchema: z.ZodObject<{
-        action: z.ZodEnum<["swap", "transfer"]>;
-        tokenIn: z.ZodOptional<z.ZodString>;
-        tokenOut: z.ZodOptional<z.ZodString>;
-        amount: z.ZodString;
-        toAddress: z.ZodOptional<z.ZodString>;
-        agentId: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        amount: string;
-        action: "transfer" | "swap";
-        tokenIn?: string | undefined;
-        tokenOut?: string | undefined;
-        agentId?: string | undefined;
-        toAddress?: string | undefined;
-    }, {
-        amount: string;
-        action: "transfer" | "swap";
-        tokenIn?: string | undefined;
-        tokenOut?: string | undefined;
-        agentId?: string | undefined;
-        toAddress?: string | undefined;
-    }>;
-};
-export declare function handlePublishRiskScore(raw: PublishRiskScoreInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
-    assessment: import("../lib/riskEngine.js").RiskAssessment;
-    policy: import("../lib/policy/actionPolicyEngine.js").ActionPolicyResult;
-    signerMode: import("../lib/signer/index.js").SignerMode;
-    onChain: {
-        txHash: `0x${string}`;
-        explorerUrl: string;
-        contractAddress: `0x${string}`;
-        gasUsed: string;
-        blockNumber: string;
-    };
-    source: string;
-}>>;
+import { z } from "zod";
+export declare const publishRiskScoreSchema: z.ZodObject<{
+    action: z.ZodEnum<["swap", "transfer"]>;
+    tokenIn: z.ZodOptional<z.ZodString>;
+    tokenOut: z.ZodOptional<z.ZodString>;
+    amount: z.ZodString;
+    toAddress: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    action: "transfer" | "swap";
+    tokenIn?: string | undefined;
+    tokenOut?: string | undefined;
+    agentId?: string | undefined;
+    toAddress?: string | undefined;
+}, {
+    amount: string;
+    action: "transfer" | "swap";
+    tokenIn?: string | undefined;
+    tokenOut?: string | undefined;
+    agentId?: string | undefined;
+    toAddress?: string | undefined;
+}>;
+export type PublishRiskScoreInput = z.input<typeof publishRiskScoreSchema>;
+export declare const publishRiskScoreTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        action: z.ZodEnum<["swap", "transfer"]>;
+        tokenIn: z.ZodOptional<z.ZodString>;
+        tokenOut: z.ZodOptional<z.ZodString>;
+        amount: z.ZodString;
+        toAddress: z.ZodOptional<z.ZodString>;
+        agentId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        amount: string;
+        action: "transfer" | "swap";
+        tokenIn?: string | undefined;
+        tokenOut?: string | undefined;
+        agentId?: string | undefined;
+        toAddress?: string | undefined;
+    }, {
+        amount: string;
+        action: "transfer" | "swap";
+        tokenIn?: string | undefined;
+        tokenOut?: string | undefined;
+        agentId?: string | undefined;
+        toAddress?: string | undefined;
+    }>;
+};
+export declare function handlePublishRiskScore(raw: PublishRiskScoreInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
+    assessment: import("../lib/riskEngine.js").RiskAssessment;
+    policy: import("../lib/policy/actionPolicyEngine.js").ActionPolicyResult;
+    signerMode: import("../lib/signer/index.js").SignerMode;
+    onChain: {
+        txHash: `0x${string}`;
+        explorerUrl: string;
+        contractAddress: `0x${string}`;
+        gasUsed: string;
+        blockNumber: string;
+    };
+    source: string;
+}>>;
 //# sourceMappingURL=publishRiskScore.d.ts.map