safehands-pharos 1.4.0 → 1.5.0

package/dist/tools/createAgentWallet.js

@@ -1,59 +1,83 @@
-// ─── create_agent_wallet ────────────────────────────────────────────────
-// Creates a new managed testnet agent wallet.
-// Private key is AES-256-GCM encrypted before storage, never returned in response.
-// ────────────────────────────────────────────────────────────────────────
-import { z } from "zod";
-import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
-import { ok, fail } from "../lib/toolResponse.js";
-import { walletStore, encryptKey, usesPersistentWalletStore, getEffectiveEncryptionKey } from "../lib/wallet/index.js";
-import { CHAIN_ID, PHAROS_ENVIRONMENT, IS_MAINNET } from "../lib/constants.js";
-export const createAgentWalletSchema = z.object({
-    agentId: z
-        .string()
-        .min(1)
-        .max(64)
-        .describe("Unique identifier for this agent wallet (e.g. 'trading-agent-1')"),
-    overwrite: z
-        .boolean()
-        .optional()
-        .default(false)
-        .describe("If true, overwrite existing wallet for this agentId"),
-});
-export async function handleCreateAgentWallet(params) {
-    const { agentId, overwrite } = params;
-    // Check if wallet already exists
-    const existing = await walletStore.get(agentId);
-    if (existing && !overwrite) {
-        return fail("WALLET_ALREADY_EXISTS", `A wallet for agentId '${agentId}' already exists. Use overwrite:true to replace it, or use get_agent_wallet to retrieve it.`, false, "wallet_store");
-    }
-    if (usesPersistentWalletStore() && !process.env.WALLET_ENCRYPTION_KEY) {
-        return fail("WALLET_ENCRYPTION_KEY_REQUIRED", "WALLET_ENCRYPTION_KEY is required when WALLET_STORE_PATH is used. Use in-memory store for local tests or provide a testnet-only encryption key.", false, "wallet_store");
-    }
-    // Generate new wallet
-    const privateKey = generatePrivateKey();
-    const account = privateKeyToAccount(privateKey);
-    // Encrypt key before storage (AES-256-GCM)
-    const encryptedKey = encryptKey(privateKey, getEffectiveEncryptionKey());
-    // Store wallet
-    await walletStore.set(agentId, {
-        agentId,
-        address: account.address,
-        encryptedKey,
-        environment: "atlantic-testnet",
-        chainId: 688689,
-        isMainnet: false,
-        createdAt: new Date().toISOString(),
-    });
-    return ok({
-        agentId,
-        address: account.address,
-        environment: PHAROS_ENVIRONMENT,
-        chainId: CHAIN_ID,
-        isMainnet: IS_MAINNET,
-        isTestnet: true,
-        createdAt: new Date().toISOString(),
-        warning: "This is a TESTNET wallet only. Never use for mainnet funds. Private key is AES-256-GCM encrypted locally — testnet-grade, not KMS/Vault.",
-        instructions: `Fund this wallet with testnet PHRS from https://testnet.pharosnetwork.xyz/ before executing write operations. Set WRITE_TOOLS_ENABLED=true to enable transactions.`,
-    });
-}
+// ─── create_agent_wallet ────────────────────────────────────────────────
+// Creates a new managed testnet agent wallet.
+// Private key is AES-256-GCM encrypted before storage, never returned in response.
+// ────────────────────────────────────────────────────────────────────────
+import { z } from "zod";
+import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
+import { ok, fail } from "../lib/toolResponse.js";
+import { walletStore, encryptKey, usesPersistentWalletStore, getEffectiveEncryptionKey } from "../lib/wallet/index.js";
+import { CHAIN_ID, PHAROS_ENVIRONMENT, IS_MAINNET, RISK_REGISTRY_ADDRESS, RISK_REGISTRY_ABI } from "../lib/constants.js";
+import { createPharosWalletClientFromAccount } from "../lib/pharosClient.js";
+export const createAgentWalletSchema = z.object({
+    agentId: z
+        .string()
+        .min(1)
+        .max(64)
+        .describe("Unique identifier for this agent wallet (e.g. 'trading-agent-1')"),
+    overwrite: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("If true, overwrite existing wallet for this agentId"),
+});
+export async function handleCreateAgentWallet(params) {
+    const { agentId, overwrite } = params;
+    // Check if wallet already exists
+    const existing = await walletStore.get(agentId);
+    if (existing && !overwrite) {
+        return fail("WALLET_ALREADY_EXISTS", `A wallet for agentId '${agentId}' already exists. Use overwrite:true to replace it, or use get_agent_wallet to retrieve it.`, false, "wallet_store");
+    }
+    if (usesPersistentWalletStore() && !process.env.WALLET_ENCRYPTION_KEY) {
+        return fail("WALLET_ENCRYPTION_KEY_REQUIRED", "WALLET_ENCRYPTION_KEY is required when WALLET_STORE_PATH is used. Use in-memory store for local tests or provide a testnet-only encryption key.", false, "wallet_store");
+    }
+    // Generate new wallet
+    const privateKey = generatePrivateKey();
+    const account = privateKeyToAccount(privateKey);
+    // Encrypt key before storage (AES-256-GCM)
+    const encryptedKey = encryptKey(privateKey, getEffectiveEncryptionKey());
+    // Store wallet
+    await walletStore.set(agentId, {
+        agentId,
+        address: account.address,
+        encryptedKey,
+        environment: "atlantic-testnet",
+        chainId: 688689,
+        isMainnet: false,
+        createdAt: new Date().toISOString(),
+    });
+    // Auto-authorize new wallet in RiskRegistry if deployer key is available
+    let riskRegistryAuthorized = false;
+    let riskRegistryAuthTxHash = null;
+    const deployerKey = process.env.PRIVATE_KEY;
+    if (deployerKey && process.env.WRITE_TOOLS_ENABLED === "true") {
+        try {
+            const deployerAccount = privateKeyToAccount(deployerKey);
+            const deployerWallet = createPharosWalletClientFromAccount(deployerAccount);
+            const txHash = await deployerWallet.writeContract({
+                address: RISK_REGISTRY_ADDRESS,
+                abi: RISK_REGISTRY_ABI,
+                functionName: "setAuthorizedAgent",
+                args: [account.address, true],
+            });
+            riskRegistryAuthorized = true;
+            riskRegistryAuthTxHash = txHash;
+        }
+        catch {
+            // Authorization failed — wallet still created, just not authorized for publish
+        }
+    }
+    return ok({
+        agentId,
+        address: account.address,
+        environment: PHAROS_ENVIRONMENT,
+        chainId: CHAIN_ID,
+        isMainnet: IS_MAINNET,
+        isTestnet: true,
+        createdAt: new Date().toISOString(),
+        warning: "This is a TESTNET wallet only. Never use for mainnet funds. Private key is AES-256-GCM encrypted locally — testnet-grade, not KMS/Vault.",
+        instructions: `Fund this wallet with testnet PHRS from https://testnet.pharosnetwork.xyz/ before executing write operations. Set WRITE_TOOLS_ENABLED=true to enable transactions.`,
+        riskRegistryAuthorized,
+        riskRegistryAuthTxHash,
+    });
+}
 //# sourceMappingURL=createAgentWallet.js.map

package/dist/tools/createAgentWallet.js.map

@@ -1 +1 @@
-{"version":3,"file":"createAgentWallet.js","sourceRoot":"","sources":["../../src/tools/createAgentWallet.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,8CAA8C;AAC9C,mFAAmF;AACnF,2EAA2E;AAE3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAqB,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACvH,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE/E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,SAAS,EAAE,CAAC;SACT,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,qDAAqD,CAAC;CACnE,CAAC,CAAC;AAgBH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAA+B;IAE/B,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAEtC,iCAAiC;IACjC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;QAC3B,OAAO,IAAI,CACT,uBAAuB,EACvB,yBAAyB,OAAO,6FAA6F,EAC7H,KAAK,EACL,cAAc,CACf,CAAC;IACJ,CAAC;IAED,IAAI,yBAAyB,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC;QACtE,OAAO,IAAI,CACT,gCAAgC,EAChC,iJAAiJ,EACjJ,KAAK,EACL,cAAc,CACf,CAAC;IACJ,CAAC;IAED,sBAAsB;IACtB,MAAM,UAAU,GAAG,kBAAkB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAEhD,2CAA2C;IAC3C,MAAM,YAAY,GAAG,UAAU,CAAC,UAAU,EAAE,yBAAyB,EAAE,CAAC,CAAC;IAEzE,eAAe;IACf,MAAM,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE;QAC7B,OAAO;QACP,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,YAAY;QACZ,WAAW,EAAE,kBAAkB;QAC/B,OAAO,EAAE,MAAM;QACf,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC;IAEH,OAAO,EAAE,CAAC;QACR,OAAO;QACP,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,kBAAkB;QAC/B,OAAO,EAAE,QAAQ;QACjB,SAAS,EAAE,UAAU;QACrB,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EACL,0IAA0I;QAC5I,YAAY,EAAE,oKAAoK;KACnL,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"createAgentWallet.js","sourceRoot":"","sources":["../../src/tools/createAgentWallet.ts"],"names":[],"mappings":"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"}

package/dist/tools/estimateGas.d.ts

@@ -1,80 +1,80 @@
-import { z } from "zod";
-export declare const estimateGasSchema: z.ZodObject<{
-    action: z.ZodEnum<["swap", "transfer"]>;
-    tokenIn: z.ZodOptional<z.ZodString>;
-    tokenOut: z.ZodOptional<z.ZodString>;
-    amount: z.ZodString;
-    walletAddress: z.ZodString;
-    toAddress: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    amount: string;
-    walletAddress: string;
-    action: "transfer" | "swap";
-    tokenIn?: string | undefined;
-    tokenOut?: string | undefined;
-    toAddress?: string | undefined;
-}, {
-    amount: string;
-    walletAddress: string;
-    action: "transfer" | "swap";
-    tokenIn?: string | undefined;
-    tokenOut?: string | undefined;
-    toAddress?: string | undefined;
-}>;
-export type EstimateGasInput = z.input<typeof estimateGasSchema>;
-export declare const estimateGasTool: {
-    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;
-        walletAddress: z.ZodString;
-        toAddress: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        amount: string;
-        walletAddress: string;
-        action: "transfer" | "swap";
-        tokenIn?: string | undefined;
-        tokenOut?: string | undefined;
-        toAddress?: string | undefined;
-    }, {
-        amount: string;
-        walletAddress: string;
-        action: "transfer" | "swap";
-        tokenIn?: string | undefined;
-        tokenOut?: string | undefined;
-        toAddress?: string | undefined;
-    }>;
-};
-export declare function handleEstimateGas(raw: EstimateGasInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
-    action: "transfer" | "swap";
-    gasEstimate: {
-        value: string;
-        unit: string;
-    };
-    gasPrice: {
-        value: string;
-        unit: string;
-    };
-    gasCostPHRS: {
-        value: string;
-        unit: string;
-    };
-    gasCostUsd: {
-        value: string;
-        unit: string;
-    } | null;
-    walletBalance: {
-        value: string;
-        unit: string;
-    };
-    isSufficient: boolean;
-    priceSourceStatus: string;
-    chainId: number;
-    environment: string;
-    isMainnet: boolean;
-    source: string;
-}>>;
+import { z } from "zod";
+export declare const estimateGasSchema: z.ZodObject<{
+    action: z.ZodEnum<["swap", "transfer"]>;
+    tokenIn: z.ZodOptional<z.ZodString>;
+    tokenOut: z.ZodOptional<z.ZodString>;
+    amount: z.ZodString;
+    walletAddress: z.ZodString;
+    toAddress: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    walletAddress: string;
+    action: "transfer" | "swap";
+    tokenIn?: string | undefined;
+    tokenOut?: string | undefined;
+    toAddress?: string | undefined;
+}, {
+    amount: string;
+    walletAddress: string;
+    action: "transfer" | "swap";
+    tokenIn?: string | undefined;
+    tokenOut?: string | undefined;
+    toAddress?: string | undefined;
+}>;
+export type EstimateGasInput = z.input<typeof estimateGasSchema>;
+export declare const estimateGasTool: {
+    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;
+        walletAddress: z.ZodString;
+        toAddress: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        amount: string;
+        walletAddress: string;
+        action: "transfer" | "swap";
+        tokenIn?: string | undefined;
+        tokenOut?: string | undefined;
+        toAddress?: string | undefined;
+    }, {
+        amount: string;
+        walletAddress: string;
+        action: "transfer" | "swap";
+        tokenIn?: string | undefined;
+        tokenOut?: string | undefined;
+        toAddress?: string | undefined;
+    }>;
+};
+export declare function handleEstimateGas(raw: EstimateGasInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
+    action: "transfer" | "swap";
+    gasEstimate: {
+        value: string;
+        unit: string;
+    };
+    gasPrice: {
+        value: string;
+        unit: string;
+    };
+    gasCostPHRS: {
+        value: string;
+        unit: string;
+    };
+    gasCostUsd: {
+        value: string;
+        unit: string;
+    } | null;
+    walletBalance: {
+        value: string;
+        unit: string;
+    };
+    isSufficient: boolean;
+    priceSourceStatus: string;
+    chainId: number;
+    environment: string;
+    isMainnet: boolean;
+    source: string;
+}>>;
 //# sourceMappingURL=estimateGas.d.ts.map

package/dist/tools/estimateGas.js

@@ -1,125 +1,125 @@
-// ─── Tool: estimate_gas ────────────────────────────────────────────────
-// Estimates gas cost for a swap or transfer before executing.
-// ────────────────────────────────────────────────────────────────────────
-import { z } from "zod";
-import { publicClient } from "../lib/pharosClient.js";
-import { getDodoRoute, isNativeToken } from "../lib/dodoApi.js";
-import { formatEther, formatGwei, isAddress, parseEther } from "viem";
-import { CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
-import { classifyExternalError, fail, ok } from "../lib/toolResponse.js";
-export const estimateGasSchema = z.object({
-    action: z.enum(["swap", "transfer"]).describe("Type of action to estimate gas for"),
-    tokenIn: z.string().optional().describe("Token to swap from (for swaps)"),
-    tokenOut: z.string().optional().describe("Token to swap to (for swaps)"),
-    amount: z.string().describe("Human-readable amount"),
-    walletAddress: z.string().describe("Sender wallet address"),
-    toAddress: z.string().optional().describe("Recipient address (for transfers)"),
-});
-export const estimateGasTool = {
-    name: "estimate_gas",
-    description: "Estimate gas cost for a swap or transfer before executing. Returns gas units, cost in PHRS/USD, and whether the wallet has sufficient gas.",
-    inputSchema: estimateGasSchema,
-};
-const QUOTE_WALLET = "0x0000000000000000000000000000000000000001";
-export async function handleEstimateGas(raw) {
-    const input = estimateGasSchema.parse(raw);
-    if (!isAddress(input.walletAddress)) {
-        return fail("INVALID_WALLET_ADDRESS", `Invalid wallet address: ${input.walletAddress}`, false, "estimate_gas");
-    }
-    const walletAddr = input.walletAddress;
-    try {
-        const gasPrice = await publicClient.getGasPrice();
-        const balance = await publicClient.getBalance({ address: walletAddr });
-        let gasEstimate;
-        if (input.action === "transfer") {
-            if (!input.toAddress) {
-                return fail("MISSING_TO_ADDRESS", "toAddress is required for transfer gas estimation.", false, "estimate_gas");
-            }
-            if (!isAddress(input.toAddress)) {
-                return fail("INVALID_RECIPIENT_ADDRESS", `Invalid recipient address: ${input.toAddress}`, false, "estimate_gas");
-            }
-            try {
-                gasEstimate = await publicClient.estimateGas({
-                    to: input.toAddress,
-                    value: parseEther(input.amount),
-                    account: walletAddr,
-                });
-            }
-            catch {
-                gasEstimate = 21000n;
-            }
-        }
-        else {
-            if (!input.tokenIn || !input.tokenOut) {
-                return fail("MISSING_SWAP_TOKENS", "tokenIn and tokenOut are required for swap gas estimation.", false, "estimate_gas");
-            }
-            try {
-                const quote = await getDodoRoute({
-                    fromToken: input.tokenIn,
-                    toToken: input.tokenOut,
-                    amountHuman: input.amount,
-                    walletAddress: input.walletAddress,
-                });
-                if (!quote.routeAvailable) {
-                    return fail("NO_ROUTE_AVAILABLE", "No swap route available; cannot estimate gas.", true, "dodo_api");
-                }
-                gasEstimate = BigInt(quote.gasLimit);
-            }
-            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");
-                }
-                return classifyExternalError("dodo_api", err);
-            }
-        }
-        const gasCostWei = gasEstimate * gasPrice;
-        const gasCostPHRS = formatEther(gasCostWei);
-        let gasCostUsd = null;
-        let priceSourceStatus = "unavailable";
-        try {
-            const priceQuote = await getDodoRoute({
-                fromToken: "PHRS",
-                toToken: "USDC",
-                amountHuman: "1",
-                walletAddress: QUOTE_WALLET,
-            });
-            if (priceQuote.routeAvailable) {
-                gasCostUsd = (parseFloat(gasCostPHRS) * parseFloat(priceQuote.amountOut)).toFixed(6);
-                priceSourceStatus = "ok";
-            }
-            else {
-                priceSourceStatus = "no_route_available";
-            }
-        }
-        catch {
-            priceSourceStatus = "unavailable";
-        }
-        let totalNeeded = gasCostWei;
-        if (input.action === "transfer" || (input.action === "swap" && isNativeToken(input.tokenIn || ""))) {
-            totalNeeded += parseEther(input.amount);
-        }
-        const isSufficient = balance >= totalNeeded;
-        return ok({
-            action: input.action,
-            gasEstimate: { value: gasEstimate.toString(), unit: "gas" },
-            gasPrice: { value: formatGwei(gasPrice), unit: "gwei" },
-            gasCostPHRS: { value: gasCostPHRS, unit: "PHRS" },
-            gasCostUsd: gasCostUsd ? { value: gasCostUsd, unit: "USD" } : null,
-            walletBalance: { value: formatEther(balance), unit: "PHRS" },
-            isSufficient,
-            priceSourceStatus,
-            chainId: CHAIN_ID,
-            environment: PHAROS_ENVIRONMENT,
-            isMainnet: false,
-            source: "pharos_rpc",
-        });
-    }
-    catch (err) {
-        return classifyExternalError("pharos_rpc", err);
-    }
-}
+// ─── Tool: estimate_gas ────────────────────────────────────────────────
+// Estimates gas cost for a swap or transfer before executing.
+// ────────────────────────────────────────────────────────────────────────
+import { z } from "zod";
+import { publicClient } from "../lib/pharosClient.js";
+import { getDodoRoute, isNativeToken } from "../lib/dodoApi.js";
+import { formatEther, formatGwei, isAddress, parseEther } from "viem";
+import { CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
+import { classifyExternalError, fail, ok } from "../lib/toolResponse.js";
+export const estimateGasSchema = z.object({
+    action: z.enum(["swap", "transfer"]).describe("Type of action to estimate gas for"),
+    tokenIn: z.string().optional().describe("Token to swap from (for swaps)"),
+    tokenOut: z.string().optional().describe("Token to swap to (for swaps)"),
+    amount: z.string().describe("Human-readable amount"),
+    walletAddress: z.string().describe("Sender wallet address"),
+    toAddress: z.string().optional().describe("Recipient address (for transfers)"),
+});
+export const estimateGasTool = {
+    name: "estimate_gas",
+    description: "Estimate gas cost for a swap or transfer before executing. Returns gas units, cost in PHRS/USD, and whether the wallet has sufficient gas.",
+    inputSchema: estimateGasSchema,
+};
+const QUOTE_WALLET = "0x0000000000000000000000000000000000000001";
+export async function handleEstimateGas(raw) {
+    const input = estimateGasSchema.parse(raw);
+    if (!isAddress(input.walletAddress)) {
+        return fail("INVALID_WALLET_ADDRESS", `Invalid wallet address: ${input.walletAddress}`, false, "estimate_gas");
+    }
+    const walletAddr = input.walletAddress;
+    try {
+        const gasPrice = await publicClient.getGasPrice();
+        const balance = await publicClient.getBalance({ address: walletAddr });
+        let gasEstimate;
+        if (input.action === "transfer") {
+            if (!input.toAddress) {
+                return fail("MISSING_TO_ADDRESS", "toAddress is required for transfer gas estimation.", false, "estimate_gas");
+            }
+            if (!isAddress(input.toAddress)) {
+                return fail("INVALID_RECIPIENT_ADDRESS", `Invalid recipient address: ${input.toAddress}`, false, "estimate_gas");
+            }
+            try {
+                gasEstimate = await publicClient.estimateGas({
+                    to: input.toAddress,
+                    value: parseEther(input.amount),
+                    account: walletAddr,
+                });
+            }
+            catch {
+                gasEstimate = 21000n;
+            }
+        }
+        else {
+            if (!input.tokenIn || !input.tokenOut) {
+                return fail("MISSING_SWAP_TOKENS", "tokenIn and tokenOut are required for swap gas estimation.", false, "estimate_gas");
+            }
+            try {
+                const quote = await getDodoRoute({
+                    fromToken: input.tokenIn,
+                    toToken: input.tokenOut,
+                    amountHuman: input.amount,
+                    walletAddress: input.walletAddress,
+                });
+                if (!quote.routeAvailable) {
+                    return fail("NO_ROUTE_AVAILABLE", "No swap route available; cannot estimate gas.", true, "dodo_api");
+                }
+                gasEstimate = BigInt(quote.gasLimit);
+            }
+            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");
+                }
+                return classifyExternalError("dodo_api", err);
+            }
+        }
+        const gasCostWei = gasEstimate * gasPrice;
+        const gasCostPHRS = formatEther(gasCostWei);
+        let gasCostUsd = null;
+        let priceSourceStatus = "unavailable";
+        try {
+            const priceQuote = await getDodoRoute({
+                fromToken: "PHRS",
+                toToken: "USDC",
+                amountHuman: "1",
+                walletAddress: QUOTE_WALLET,
+            });
+            if (priceQuote.routeAvailable) {
+                gasCostUsd = (parseFloat(gasCostPHRS) * parseFloat(priceQuote.amountOut)).toFixed(6);
+                priceSourceStatus = "ok";
+            }
+            else {
+                priceSourceStatus = "no_route_available";
+            }
+        }
+        catch {
+            priceSourceStatus = "unavailable";
+        }
+        let totalNeeded = gasCostWei;
+        if (input.action === "transfer" || (input.action === "swap" && isNativeToken(input.tokenIn || ""))) {
+            totalNeeded += parseEther(input.amount);
+        }
+        const isSufficient = balance >= totalNeeded;
+        return ok({
+            action: input.action,
+            gasEstimate: { value: gasEstimate.toString(), unit: "gas" },
+            gasPrice: { value: formatGwei(gasPrice), unit: "gwei" },
+            gasCostPHRS: { value: gasCostPHRS, unit: "PHRS" },
+            gasCostUsd: gasCostUsd ? { value: gasCostUsd, unit: "USD" } : null,
+            walletBalance: { value: formatEther(balance), unit: "PHRS" },
+            isSufficient,
+            priceSourceStatus,
+            chainId: CHAIN_ID,
+            environment: PHAROS_ENVIRONMENT,
+            isMainnet: false,
+            source: "pharos_rpc",
+        });
+    }
+    catch (err) {
+        return classifyExternalError("pharos_rpc", err);
+    }
+}
 //# sourceMappingURL=estimateGas.js.map