safehands-pharos 1.5.0 → 2.6.0

package/dist/tools/estimateGas.js

@@ -5,8 +5,9 @@ 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 { CHAIN_ID, PHAROS_ENVIRONMENT, IS_MAINNET } from "../lib/constants.js";
 import { classifyExternalError, fail, ok } from "../lib/toolResponse.js";
+import { recommendGasWithBuffer, DEFAULT_GAS_BUFFER_PCT } from "../lib/analysis/gas.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)"),
@@ -17,7 +18,7 @@ export const estimateGasSchema = z.object({
 });
 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.",
+    description: "Estimate gas cost for a swap or transfer before executing. Returns gas units, cost in PROS/USD, and whether the wallet has sufficient gas.",
     inputSchema: estimateGasSchema,
 };
 const QUOTE_WALLET = "0x0000000000000000000000000000000000000001";
@@ -67,6 +68,9 @@ export async function handleEstimateGas(raw) {
             }
             catch (err) {
                 const message = err instanceof Error ? err.message : String(err);
+                if (message.includes("SWAP_LIQUIDITY_NOT_CONFIGURED")) {
+                    return fail("SWAP_LIQUIDITY_NOT_CONFIGURED", message, false, "dodo_api");
+                }
                 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");
                 }
@@ -77,26 +81,27 @@ export async function handleEstimateGas(raw) {
             }
         }
         const gasCostWei = gasEstimate * gasPrice;
-        const gasCostPHRS = formatEther(gasCostWei);
+        const gasCostPROS = formatEther(gasCostWei);
         let gasCostUsd = null;
         let priceSourceStatus = "unavailable";
         try {
             const priceQuote = await getDodoRoute({
-                fromToken: "PHRS",
+                fromToken: "PROS",
                 toToken: "USDC",
                 amountHuman: "1",
                 walletAddress: QUOTE_WALLET,
             });
             if (priceQuote.routeAvailable) {
-                gasCostUsd = (parseFloat(gasCostPHRS) * parseFloat(priceQuote.amountOut)).toFixed(6);
+                gasCostUsd = (parseFloat(gasCostPROS) * parseFloat(priceQuote.amountOut)).toFixed(6);
                 priceSourceStatus = "ok";
             }
             else {
                 priceSourceStatus = "no_route_available";
             }
         }
-        catch {
-            priceSourceStatus = "unavailable";
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            priceSourceStatus = message.includes("SWAP_LIQUIDITY_NOT_CONFIGURED") ? "not_configured" : "unavailable";
         }
         let totalNeeded = gasCostWei;
         if (input.action === "transfer" || (input.action === "swap" && isNativeToken(input.tokenIn || ""))) {
@@ -106,15 +111,16 @@ export async function handleEstimateGas(raw) {
         return ok({
             action: input.action,
             gasEstimate: { value: gasEstimate.toString(), unit: "gas" },
+            recommendedGas: { value: recommendGasWithBuffer(gasEstimate).toString(), unit: "gas", bufferPct: DEFAULT_GAS_BUFFER_PCT },
             gasPrice: { value: formatGwei(gasPrice), unit: "gwei" },
-            gasCostPHRS: { value: gasCostPHRS, unit: "PHRS" },
+            gasCostPROS: { value: gasCostPROS, unit: "PROS" },
             gasCostUsd: gasCostUsd ? { value: gasCostUsd, unit: "USD" } : null,
-            walletBalance: { value: formatEther(balance), unit: "PHRS" },
+            walletBalance: { value: formatEther(balance), unit: "PROS" },
             isSufficient,
             priceSourceStatus,
             chainId: CHAIN_ID,
             environment: PHAROS_ENVIRONMENT,
-            isMainnet: false,
+            isMainnet: IS_MAINNET,
             source: "pharos_rpc",
         });
     }

package/dist/tools/estimateGas.js.map

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

package/dist/tools/executeSwap.d.ts

@@ -1,24 +1,65 @@
 import { z } from "zod";
+import { type Account } from "viem";
 export declare const executeSwapSchema: z.ZodObject<{
     tokenIn: z.ZodString;
     tokenOut: z.ZodString;
     amountIn: z.ZodString;
-    slippageTolerance: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    slippageTolerance: z.ZodOptional<z.ZodNumber>;
+    venue: z.ZodDefault<z.ZodOptional<z.ZodEnum<["dodo", "okx"]>>>;
     agentId: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
+    confirm: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strict", z.ZodTypeAny, {
     tokenIn: string;
     tokenOut: string;
+    confirm: boolean;
     amountIn: string;
-    slippageTolerance: number;
+    venue: "okx" | "dodo";
     agentId?: string | undefined;
+    slippageTolerance?: number | undefined;
 }, {
     tokenIn: string;
     tokenOut: string;
     amountIn: string;
     agentId?: string | undefined;
+    confirm?: boolean | undefined;
     slippageTolerance?: number | undefined;
+    venue?: "okx" | "dodo" | undefined;
 }>;
 export type ExecuteSwapInput = z.input<typeof executeSwapSchema>;
+/**
+ * Hard, non-confirmable quote guards. An unfavorable price is embedded in
+ * the quote ITSELF — minReturn/slippage only protect against movement AFTER
+ * quoting — so a quote whose priceImpact exceeds the ceiling must hard-stop
+ * here, before any signing. The ceiling is the caller's slippageTolerance or
+ * MAX_SLIPPAGE_PCT, whichever is larger. Pure + exported for offline tests.
+ */
+export declare function evaluateSwapQuoteGuards(quote: {
+    priceImpact: number;
+    amountOut: string;
+}, slippageTolerance?: number): {
+    code: string;
+    message: string;
+} | null;
+/**
+ * Simulate the exact swap call via eth_call and return the revert reason,
+ * or null when the call succeeds. The final broadcast passes an explicit
+ * `gas: quote.gasLimit`, which bypasses viem's implicit estimateGas revert
+ * check — without this a reverting route would burn gas on-chain. Takes the
+ * client structurally so it is unit-testable offline.
+ */
+export declare function simulateSwapCalldata(client: {
+    call(args: {
+        account: Account | `0x${string}`;
+        to: `0x${string}`;
+        value: bigint;
+        data: `0x${string}`;
+    }): Promise<unknown>;
+}, args: {
+    account: Account | `0x${string}`;
+    to: `0x${string}`;
+    value: bigint;
+    data: `0x${string}`;
+}): Promise<string | null>;
 export declare const executeSwapTool: {
     name: string;
     description: string;
@@ -26,25 +67,32 @@ export declare const executeSwapTool: {
         tokenIn: z.ZodString;
         tokenOut: z.ZodString;
         amountIn: z.ZodString;
-        slippageTolerance: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        slippageTolerance: z.ZodOptional<z.ZodNumber>;
+        venue: z.ZodDefault<z.ZodOptional<z.ZodEnum<["dodo", "okx"]>>>;
         agentId: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
+        confirm: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strict", z.ZodTypeAny, {
         tokenIn: string;
         tokenOut: string;
+        confirm: boolean;
         amountIn: string;
-        slippageTolerance: number;
+        venue: "okx" | "dodo";
         agentId?: string | undefined;
+        slippageTolerance?: number | undefined;
     }, {
         tokenIn: string;
         tokenOut: string;
         amountIn: string;
         agentId?: string | undefined;
+        confirm?: boolean | undefined;
         slippageTolerance?: number | undefined;
+        venue?: "okx" | "dodo" | undefined;
     }>;
 };
-export declare function handleExecuteSwap(raw: ExecuteSwapInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
+export declare function handleExecuteSwap(raw: ExecuteSwapInput): Promise<import("../sdk.js").ToolFailure | import("../sdk.js").ToolSuccess<{
     txHash: `0x${string}`;
     explorerUrl: string;
+    venue: "okx" | "dodo";
     amountOut: string;
     usedFromToken: string;
     usedToToken: string;
@@ -52,7 +100,7 @@ export declare function handleExecuteSwap(raw: ExecuteSwapInput): Promise<import
     signerMode: import("../lib/signer/index.js").SignerMode;
     walletAddress: `0x${string}`;
     gasUsed: string;
-    policy: import("../lib/policy/actionPolicyEngine.js").ActionPolicyResult;
+    policy: import("../sdk.js").ActionPolicyResult;
     riskAssessment: {
         riskScore: number;
         wasBlocked: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"executeSwap.d.ts","sourceRoot":"","sources":["../../src/tools/executeSwap.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CAI3B,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB;;;;;;;;;;;;;;;;IAgJ5D"}
+{"version":3,"file":"executeSwap.d.ts","sourceRoot":"","sources":["../../src/tools/executeSwap.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAe/C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;EAQnB,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EACjD,iBAAiB,CAAC,EAAE,MAAM,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiB1C;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE;IAAE,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,GAAG,KAAK,MAAM,EAAE,CAAC;QAAC,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,EACrI,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,GAAG,KAAK,MAAM,EAAE,CAAC;IAAC,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAA;CAAE,GAChG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAI3B,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB;;;;;;;;;;;;;;;;;IA6Q5D"}

package/dist/tools/executeSwap.js

@@ -1,52 +1,114 @@
 // ─── Tool: execute_swap ────────────────────────────────────────────────
 import { z } from "zod";
+import { isAddress } from "viem";
 import { publicClient, createPharosWalletClientFromAccount, getExplorerUrl } from "../lib/pharosClient.js";
-import { getDodoRoute, isNativeToken, resolveTokenAddress, resolveTokenDecimals, toWei } from "../lib/dodoApi.js";
+import { getDodoRoute, isNativeToken, resolveTokenAddress, resolveTokenDecimals, toWei, DodoNotConfiguredError } from "../lib/dodoApi.js";
+import { getOkxSwapQuote, OkxNotConfiguredError, OkxCredentialsMissingError } from "../lib/okxDexApi.js";
+import { addressTrustEvidence } from "../lib/ecosystemRegistry.js";
 import { assessRisk } from "../lib/riskEngine.js";
 import { fail, ok, classifyExternalError } from "../lib/toolResponse.js";
-import { DODO_APPROVE_ADDRESS, ERC20_ABI, RISK_BLOCK_THRESHOLD, MAX_TX_AMOUNT_PHRS, CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
-import { getSigner, isSignerFailure } from "../lib/signer/index.js";
-import { evaluateActionPolicy } from "../lib/policy/actionPolicyEngine.js";
-import { checkDailyLimit, recordSpend, estimateUsd } from "../lib/spendAccumulator.js";
+import { ERC20_ABI, MAX_SLIPPAGE_PCT, MAX_TX_AMOUNT_PROS, CHAIN_ID, PHAROS_ENVIRONMENT, IS_MAINNET, isAllowedDodoRouter, isAllowedDodoSpender, activeDodoRouterAllowlist, activeDodoSpenderAllowlist, isAllowedOkxRouter, isAllowedOkxSpender, activeOkxRouterAllowlist, activeOkxSpenderAllowlist } from "../lib/constants.js";
+import { requireManagedExecutionReady, isManagedExecutionFailure } from "../lib/managedExecution.js";
+import { evaluateActionPolicy, riskEvidenceFromAssessment } from "../lib/policy/actionPolicyEngine.js";
+import { enforceWriteDecision } from "../lib/policy/writeExecutionGate.js";
+import { evaluateTokenSecurityGate } from "./checkTokenSecurity.js";
+import { checkDailyLimit, reserveDailyLimit, releaseReservation, estimateUsd } from "../lib/spendAccumulator.js";
+import { validatePositiveAmount } from "../lib/validation.js";
 export const executeSwapSchema = z.object({
     tokenIn: z.string(),
     tokenOut: z.string(),
     amountIn: z.string(),
-    slippageTolerance: z.number().optional().default(3.225),
-    agentId: z.string().optional().describe("Managed testnet wallet agentId when WALLET_MODE=managed-testnet"),
-});
+    slippageTolerance: z.number().optional().describe("Override auto slippage. Default: 3 (Auto mode adjusts to 0.5 for major, 0.1 for stablecoins)"),
+    venue: z.enum(["dodo", "okx"]).optional().default("dodo").describe("Swap route venue. dodo (default): FaroSwap/DODO route API. okx: OKX DEX aggregator (registry-verified router/spender; requires OKX_API_KEY, OKX_API_SECRET, and OKX_API_PASSPHRASE, otherwise fails closed)."),
+    agentId: z.string().optional().describe("Managed wallet agentId when WALLET_MODE=managed-mainnet"),
+    confirm: z.boolean().optional().default(false).describe("Explicit acknowledgement to proceed when SafeHands returns REQUIRE_CONFIRMATION / REQUIRE_TOKEN_REVIEW. Hard BLOCK / honeypot / over-limit / unpriceable input token / missing token-security intel are never overridable."),
+}).strict();
+/**
+ * Hard, non-confirmable quote guards. An unfavorable price is embedded in
+ * the quote ITSELF — minReturn/slippage only protect against movement AFTER
+ * quoting — so a quote whose priceImpact exceeds the ceiling must hard-stop
+ * here, before any signing. The ceiling is the caller's slippageTolerance or
+ * MAX_SLIPPAGE_PCT, whichever is larger. Pure + exported for offline tests.
+ */
+export function evaluateSwapQuoteGuards(quote, slippageTolerance) {
+    const ceilingPct = Math.max(slippageTolerance ?? 0, MAX_SLIPPAGE_PCT);
+    const impact = Math.abs(quote.priceImpact);
+    if (!Number.isFinite(impact) || impact > ceilingPct) {
+        return {
+            code: "PRICE_IMPACT_TOO_HIGH",
+            message: `Swap blocked: quoted price impact ${Number.isFinite(impact) ? impact.toFixed(2) : "unknown"}% exceeds the ${ceilingPct}% ceiling (max of slippageTolerance and MAX_SLIPPAGE_PCT ${MAX_SLIPPAGE_PCT}%). The unfavorable price is in the quote itself, so slippage protection cannot mitigate it; this is a hard stop and is never confirmable. Reduce the trade size or use a deeper route.`,
+        };
+    }
+    const amountOut = Number.parseFloat(quote.amountOut);
+    if (!Number.isFinite(amountOut) || amountOut <= 0) {
+        return {
+            code: "INVALID_QUOTE_AMOUNT_OUT",
+            message: `Swap blocked: the venue quote returned a non-positive amountOut (${quote.amountOut}). Broadcasting would spend tokenIn for nothing; this is a hard stop and is never confirmable.`,
+        };
+    }
+    return null;
+}
+/**
+ * Simulate the exact swap call via eth_call and return the revert reason,
+ * or null when the call succeeds. The final broadcast passes an explicit
+ * `gas: quote.gasLimit`, which bypasses viem's implicit estimateGas revert
+ * check — without this a reverting route would burn gas on-chain. Takes the
+ * client structurally so it is unit-testable offline.
+ */
+export async function simulateSwapCalldata(client, args) {
+    try {
+        await client.call(args);
+        return null;
+    }
+    catch (err) {
+        return err instanceof Error ? err.message : String(err);
+    }
+}
 export const executeSwapTool = {
     name: "execute_swap",
-    description: "Swap tokens via FaroSwap with built-in risk gate. Runs risk assessment first, blocks if score > 80.",
+    description: "Swap tokens via FaroSwap/DODO (default) or the OKX DEX aggregator (venue: okx). Runs a risk assessment first and feeds it as evidence to the SafeHands policy engine, the sole ALLOW/BLOCK/REQUIRE_CONFIRMATION decider (a risk score above the block threshold fails its risk_score check and blocks, never confirmable). Gated by WRITE_TOOLS_ENABLED.",
     inputSchema: executeSwapSchema,
 };
 export async function handleExecuteSwap(raw) {
-    if (process.env.WRITE_TOOLS_ENABLED !== "true") {
-        return fail("WRITE_TOOLS_DISABLED", "execute_swap is disabled by default. Set WRITE_TOOLS_ENABLED=true only for trusted testnet execution.", false, "execute_swap");
+    let input;
+    try {
+        input = executeSwapSchema.parse(raw);
     }
-    const input = executeSwapSchema.parse(raw);
-    const signer = await getSigner(input.agentId);
-    if (isSignerFailure(signer)) {
-        return fail(signer.error.code, signer.error.message, false, "execute_swap");
+    catch (err) {
+        const msg = err instanceof z.ZodError
+            ? err.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")
+            : String(err);
+        return fail("VALIDATION_ERROR", `execute_swap input validation failed: ${msg}`, false, "execute_swap");
     }
+    const amtErr = validatePositiveAmount(input.amountIn, "amountIn");
+    if (amtErr)
+        return fail("VALIDATION_ERROR", amtErr, false, "execute_swap");
+    const gate = await requireManagedExecutionReady("execute_swap", input.agentId);
+    if (isManagedExecutionFailure(gate))
+        return gate;
+    const { signer } = gate;
     const walletAddress = signer.address;
-    const policy = evaluateActionPolicy({
-        actionType: "execute_swap",
-        amount: input.amountIn,
-        amountUnit: "TOKEN",
-        tokenIn: input.tokenIn,
-        tokenOut: input.tokenOut,
-        chainId: CHAIN_ID,
-        environment: PHAROS_ENVIRONMENT,
-        isMainnet: false,
-        signerAvailable: true,
-        requiresSigner: true,
-    });
-    if (policy.decision === "BLOCK") {
-        return fail("POLICY_BLOCKED", policy.reasons.join(" ") || "Swap blocked by SafeHands policy.", false, "execute_swap");
+    // Consult token-security (GoPlus honeypot/tax) on the token being acquired.
+    // Honeypot / extreme-tax → hard block; reviewed-and-flagged → "unknown" →
+    // REQUIRE_TOKEN_REVIEW (confirmable after review); intel MISSING (outage /
+    // unindexed, non-registry) → "unavailable" → the write gate fails closed.
+    let tokenSecurityStatus;
+    if (!isNativeToken(input.tokenOut)) {
+        let outAddr;
+        try {
+            outAddr = isAddress(input.tokenOut) ? input.tokenOut : resolveTokenAddress(input.tokenOut);
+        }
+        catch {
+            outAddr = input.tokenOut;
+        }
+        const sec = await evaluateTokenSecurityGate(outAddr);
+        if (sec.verdict === "block") {
+            return fail("TOKEN_SECURITY_BLOCKED", `Swap blocked: ${sec.detail ?? "token failed security review"} ${sec.flags.join("; ")}`.trim(), false, "execute_swap");
+        }
+        tokenSecurityStatus = sec.policyStatus;
     }
-    if (Number(input.amountIn) > Number(MAX_TX_AMOUNT_PHRS) && input.tokenIn.toUpperCase() === "PHRS") {
-        return fail("TX_LIMIT_EXCEEDED", `Swap amount exceeds configured testnet limit (${MAX_TX_AMOUNT_PHRS}).`, false, "execute_swap");
+    if (Number(input.amountIn) > Number(MAX_TX_AMOUNT_PROS) && input.tokenIn.toUpperCase() === "PROS") {
+        return fail("TX_LIMIT_EXCEEDED", `Swap amount exceeds the operator ceiling MAX_TX_AMOUNT_PROS (${MAX_TX_AMOUNT_PROS} PROS), which bounds all agent policies. Raise MAX_TX_AMOUNT_PROS to allow larger mainnet swaps.`, false, "execute_swap");
     }
     const amountUsd = estimateUsd(input.amountIn, input.tokenIn);
     const dailyCheck = checkDailyLimit(walletAddress, amountUsd);
@@ -60,55 +122,126 @@ export async function handleExecuteSwap(raw) {
         amount: input.amountIn,
         walletAddress,
     });
-    if (risk.riskScore > RISK_BLOCK_THRESHOLD) {
-        return fail("POLICY_BLOCKED", `Swap blocked — risk score ${risk.riskScore}/100: ${risk.suggestion}`, false, "execute_swap");
-    }
+    // Sole decision point: ONE policy evaluation over all collected evidence,
+    // including the advisory risk assessment. Never gate on riskEngine output
+    // directly — the policy engine's risk_* checks do that (never-weaken parity
+    // with the former direct gates; requireRiskEvidence makes a wiring miss fail
+    // closed instead of silently losing the risk gates).
+    // The unpriceable-input guard lives here too: an unpriceable input token escaped the USD caps read
+    // by checkDailyLimit above, and swap_notional_unpriceable → BLOCK (never
+    // confirmable) stops it before any quote is fetched or budget is reserved.
+    const policy = evaluateActionPolicy({
+        actionType: "execute_swap",
+        agentId: input.agentId,
+        amount: input.amountIn,
+        amountUnit: "TOKEN",
+        tokenIn: input.tokenIn,
+        tokenOut: input.tokenOut,
+        tokenSecurityStatus,
+        chainId: CHAIN_ID,
+        environment: PHAROS_ENVIRONMENT,
+        isMainnet: IS_MAINNET,
+        signerAvailable: true,
+        requiresSigner: true,
+        risk: riskEvidenceFromAssessment(risk),
+    });
+    const swapGate = enforceWriteDecision(policy, { confirmed: input.confirm === true, toolName: "execute_swap", requireRiskEvidence: true });
+    if (swapGate)
+        return swapGate;
+    const venue = input.venue;
+    const venueSource = venue === "okx" ? "okx_dex_api" : "dodo_api";
+    let reserved = false;
     try {
-        const quote = await getDodoRoute({
+        const quoteParams = {
             fromToken: input.tokenIn,
             toToken: input.tokenOut,
             amountHuman: input.amountIn,
             walletAddress,
             slippage: input.slippageTolerance,
-        });
+        };
+        const quote = venue === "okx" ? await getOkxSwapQuote(quoteParams) : await getDodoRoute(quoteParams);
         if (!quote.routeAvailable) {
-            return fail("NO_ROUTE_AVAILABLE", "No swap route available — insufficient liquidity", true, "dodo_api");
+            return fail("NO_ROUTE_AVAILABLE", "No swap route available: insufficient liquidity", true, venueSource);
+        }
+        const quoteGuard = evaluateSwapQuoteGuards(quote, input.slippageTolerance);
+        if (quoteGuard) {
+            return fail(quoteGuard.code, quoteGuard.message, false, "execute_swap");
+        }
+        // Containment, not trust: the quote's router/spender must be inside the
+        // venue's allowlist. Trust evidence still comes only from the registry
+        // (addressTrustEvidence below).
+        const routerAllowed = venue === "okx" ? isAllowedOkxRouter(quote.to) : isAllowedDodoRouter(quote.to);
+        if (!isAddress(quote.to) || !routerAllowed) {
+            return venue === "okx"
+                ? fail("UNTRUSTED_OKX_ROUTER", `OKX quote returned untrusted router/tx target ${quote.to}. Configure OKX_ROUTER_ALLOWLIST/SAFEHANDS_OKX_ROUTER_ALLOWLIST with a verified router before enabling mainnet swap execution. Current allowlist: ${activeOkxRouterAllowlist().join(",") || "empty"}`, false, "execute_swap")
+                : fail("UNTRUSTED_DODO_ROUTER", `DODO quote returned untrusted router/tx target ${quote.to}. Configure DODO_ROUTER_ALLOWLIST/SAFEHANDS_DODO_ROUTER_ALLOWLIST with a verified router before enabling mainnet swap execution. Current allowlist: ${activeDodoRouterAllowlist().join(",") || "empty"}`, false, "execute_swap");
+        }
+        const spenderAllowed = venue === "okx" ? isAllowedOkxSpender(quote.approveAddress) : isAllowedDodoSpender(quote.approveAddress);
+        if (!isNativeToken(input.tokenIn) && (!isAddress(quote.approveAddress) || !spenderAllowed)) {
+            return venue === "okx"
+                ? fail("UNTRUSTED_OKX_SPENDER", `OKX quote returned untrusted approval target ${quote.approveAddress}. Configure OKX_SPENDER_ALLOWLIST/SAFEHANDS_OKX_SPENDER_ALLOWLIST with a verified approve contract before enabling mainnet token swaps. Current allowlist: ${activeOkxSpenderAllowlist().join(",") || "empty"}`, false, "execute_swap")
+                : fail("UNTRUSTED_DODO_SPENDER", `DODO quote returned untrusted approval target ${quote.approveAddress}. Configure DODO_SPENDER_ALLOWLIST/SAFEHANDS_DODO_SPENDER_ALLOWLIST with a verified approve proxy before enabling mainnet token swaps. Current allowlist: ${activeDodoSpenderAllowlist().join(",") || "empty"}`, false, "execute_swap");
         }
         const wallet = createPharosWalletClientFromAccount(signer.account);
         if (!isNativeToken(input.tokenIn)) {
             const tokenAddr = resolveTokenAddress(input.tokenIn);
             const decimals = resolveTokenDecimals(input.tokenIn);
             const amountWei = BigInt(toWei(input.amountIn, decimals));
+            const approveAddress = quote.approveAddress;
             const allowance = (await publicClient.readContract({
                 address: tokenAddr,
                 abi: ERC20_ABI,
                 functionName: "allowance",
-                args: [walletAddress, DODO_APPROVE_ADDRESS],
+                args: [walletAddress, approveAddress],
             }));
             if (allowance < amountWei) {
+                // spenderVerified comes ONLY from registry evidence. Allowlist membership
+                // (checked above) is containment, not verification — asserting it as
+                // "verified" fabricated a trust claim for a testnet-provenance address.
+                const spenderEvidence = addressTrustEvidence(approveAddress, CHAIN_ID);
                 const approvalPolicy = evaluateActionPolicy({
                     actionType: "approve_token",
+                    agentId: input.agentId,
                     approvalAmount: input.amountIn,
-                    spender: DODO_APPROVE_ADDRESS,
-                    spenderVerified: true,
+                    spender: approveAddress,
+                    spenderVerified: spenderEvidence.verifiedCanonical ? true : undefined,
                     chainId: CHAIN_ID,
                     environment: PHAROS_ENVIRONMENT,
-                    isMainnet: false,
+                    isMainnet: IS_MAINNET,
                     signerAvailable: true,
                     requiresSigner: true,
                 });
-                if (approvalPolicy.decision === "BLOCK") {
-                    return fail("POLICY_BLOCKED", `Swap approval blocked: ${approvalPolicy.reasons.join(" ")}`, false, "execute_swap");
-                }
+                const approvalGate = enforceWriteDecision(approvalPolicy, { confirmed: input.confirm === true, toolName: "execute_swap" });
+                if (approvalGate)
+                    return approvalGate;
                 const approveHash = await wallet.writeContract({
                     address: tokenAddr,
                     abi: ERC20_ABI,
                     functionName: "approve",
-                    args: [DODO_APPROVE_ADDRESS, amountWei],
+                    args: [approveAddress, amountWei],
                 });
                 await publicClient.waitForTransactionReceipt({ hash: approveHash });
             }
         }
+        // Pre-broadcast simulation of the exact calldata (after the approval
+        // above so the allowance is visible to eth_call). A reverting route fails
+        // here for free instead of burning gas on-chain.
+        const simulationError = await simulateSwapCalldata(publicClient, {
+            account: signer.account,
+            to: quote.to,
+            value: BigInt(quote.value),
+            data: quote.calldata,
+        });
+        if (simulationError !== null) {
+            return fail("SWAP_SIMULATION_REVERTED", `Pre-broadcast simulation of the swap calldata reverted; broadcasting would only burn gas. ${simulationError}`, true, "execute_swap");
+        }
+        // Atomically reserve the daily-spend budget immediately before the swap
+        // broadcast (no await between reserve and send). Released below on revert/error.
+        const reservation = reserveDailyLimit(walletAddress, amountUsd);
+        if (!reservation.allowed) {
+            return fail("DAILY_SPEND_LIMIT_EXCEEDED", `Daily spend limit reached. Spent $${reservation.currentUsd.toFixed(2)} of $${reservation.limitUsd.toFixed(2)} USD today. Remaining: $${reservation.remainingUsd.toFixed(2)}. Resets at UTC midnight.`, false, "execute_swap");
+        }
+        reserved = amountUsd > 0;
         const txHash = await wallet.sendTransaction({
             to: quote.to,
             value: BigInt(quote.value),
@@ -117,12 +250,13 @@ export async function handleExecuteSwap(raw) {
         });
         const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
         if (receipt.status !== "success") {
+            releaseReservation(walletAddress, amountUsd);
             return fail("TX_REVERTED", "execute_swap transaction was mined but reverted on-chain.", false, "execute_swap");
         }
-        recordSpend(walletAddress, amountUsd);
         return ok({
             txHash,
             explorerUrl: getExplorerUrl(txHash),
+            venue,
             amountOut: quote.amountOut,
             usedFromToken: quote.usedFromToken,
             usedToToken: quote.usedToToken,
@@ -136,6 +270,20 @@ export async function handleExecuteSwap(raw) {
         });
     }
     catch (err) {
+        // Release the daily-spend reservation on a thrown broadcast/receipt error so a
+        // swap that never landed does not permanently consume the cap (parity with
+        // send_payment; the revert path above already releases).
+        if (reserved)
+            releaseReservation(walletAddress, amountUsd);
+        if (err instanceof DodoNotConfiguredError) {
+            return fail("SWAP_LIQUIDITY_NOT_CONFIGURED", err.message, false, "dodo_api");
+        }
+        if (err instanceof OkxNotConfiguredError) {
+            return fail("SWAP_LIQUIDITY_NOT_CONFIGURED", err.message, false, "okx_dex_api");
+        }
+        if (err instanceof OkxCredentialsMissingError) {
+            return fail("OKX_API_CREDENTIALS_MISSING", err.message, false, "okx_dex_api");
+        }
         return classifyExternalError("pharos_rpc", err);
     }
 }

package/dist/tools/executeSwap.js.map

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

package/dist/tools/explainRisk.d.ts

@@ -1,7 +1,7 @@
 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"]>;
+    decision: z.ZodEnum<["ALLOW", "WARN", "BLOCK", "REQUIRE_CONFIRMATION", "PREPARE_ONLY", "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">>>;
@@ -9,20 +9,20 @@ export declare const explainRiskSchema: z.ZodObject<{
     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[];
+    riskLevel: "UNKNOWN" | "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+    environment: string;
+    isMainnet: boolean;
+    decision: "ALLOW" | "WARN" | "BLOCK" | "REQUIRE_CONFIRMATION" | "REQUIRE_FUNDING" | "REQUIRE_TOKEN_REVIEW" | "PREPARE_ONLY";
     requiredActions: string[];
 }, {
-    riskLevel: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL" | "UNKNOWN";
-    decision: "ALLOW" | "WARN" | "BLOCK" | "REQUIRE_CONFIRMATION" | "REQUIRE_FUNDING" | "REQUIRE_TOKEN_REVIEW";
-    environment?: string | undefined;
+    riskLevel: "UNKNOWN" | "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+    decision: "ALLOW" | "WARN" | "BLOCK" | "REQUIRE_CONFIRMATION" | "REQUIRE_FUNDING" | "REQUIRE_TOKEN_REVIEW" | "PREPARE_ONLY";
     chainId?: number | undefined;
-    isMainnet?: boolean | undefined;
     reasons?: string[] | undefined;
+    environment?: string | undefined;
+    isMainnet?: boolean | undefined;
     requiredActions?: string[] | undefined;
 }>;
 export type ExplainRiskInput = z.input<typeof explainRiskSchema>;