safehands-pharos 1.2.6 → 1.4.0

package/dist/tools/assessRisk.js

@@ -1,94 +1,105 @@
-// ─── Tool: assess_risk ─────────────────────────────────────────────────
-// Core risk assessment tool. Optional on-chain publishing uses SignerProvider
-// and never accepts or returns raw private keys.
-// ────────────────────────────────────────────────────────────────────────
-import { z } from "zod";
-import { assessRisk } from "../lib/riskEngine.js";
-import { createPharosWalletClientFromAccount, publicClient, getExplorerUrl } from "../lib/pharosClient.js";
-import { RISK_REGISTRY_ADDRESS, RISK_REGISTRY_ABI } from "../lib/constants.js";
-import { getSigner, isSignerFailure } from "../lib/signer/index.js";
-import { requireWriteToolsEnabled } from "../lib/toolResponse.js";
-export const assessRiskSchema = z.object({
-    action: z.enum(["swap", "transfer"]),
-    tokenIn: z.string().optional(),
-    tokenOut: z.string().optional(),
-    amount: z.string(),
-    toAddress: z.string().optional(),
-    walletAddress: z.string(),
-    agentId: z.string().optional().describe("Managed testnet wallet agentId for optional registry publishing"),
-    autoPublish: z.boolean().optional().default(false).describe("If true, publish to RiskRegistry through SignerProvider when write tools are enabled"),
-    privateKey: z.string().optional().describe("Deprecated and ignored. Use SignerProvider via WALLET_MODE/agentId instead."),
-});
-export const assessRiskTool = {
-    name: "assess_risk",
-    description: "Evaluate risk of a planned on-chain action (swap or transfer). Returns 0-100 risk score with 5-dimension breakdown. " +
-        "Optional RiskRegistry publishing uses SignerProvider when autoPublish=true.",
-    inputSchema: assessRiskSchema,
-};
-export async function handleAssessRisk(raw) {
-    const input = assessRiskSchema.parse(raw);
-    if (input.action === "swap" && (!input.tokenIn || !input.tokenOut)) {
-        throw new Error("Swap action requires both tokenIn and tokenOut");
-    }
-    if (input.action === "transfer" && !input.toAddress) {
-        throw new Error("Transfer action requires toAddress");
-    }
-    const assessment = await assessRisk({
-        action: input.action,
-        tokenIn: input.tokenIn,
-        tokenOut: input.tokenOut,
-        amount: input.amount,
-        toAddress: input.toAddress,
-        walletAddress: input.walletAddress,
-    });
-    const result = { ...assessment };
-    const wantsPublish = input.autoPublish || Boolean(input.privateKey);
-    if (wantsPublish) {
-        if (input.privateKey) {
-            result.registryPublish = {
-                published: false,
-                error: "Direct privateKey input is deprecated and ignored. Use WALLET_MODE=managed-testnet with agentId or WALLET_MODE=env through SignerProvider.",
-            };
-            return result;
-        }
-        const writeGuard = requireWriteToolsEnabled("assess_risk_auto_publish");
-        if (writeGuard) {
-            result.registryPublish = { published: false, error: `${writeGuard.error.code}: ${writeGuard.error.message}` };
-            return result;
-        }
-        const signer = await getSigner(input.agentId);
-        if (isSignerFailure(signer)) {
-            result.registryPublish = { published: false, error: `${signer.error.code}: ${signer.error.message}` };
-            return result;
-        }
-        try {
-            const wallet = createPharosWalletClientFromAccount(signer.account);
-            const txHash = await wallet.writeContract({
-                address: RISK_REGISTRY_ADDRESS,
-                abi: RISK_REGISTRY_ABI,
-                functionName: "publish",
-                args: [
-                    input.walletAddress,
-                    BigInt(assessment.riskScore),
-                    assessment.riskLevel,
-                    assessment.recommendation,
-                ],
-            });
-            await publicClient.waitForTransactionReceipt({ hash: txHash });
-            result.registryPublish = {
-                published: true,
-                txHash,
-                explorerUrl: getExplorerUrl(txHash),
-                signerMode: signer.mode,
-            };
-        }
-        catch (err) {
-            result.registryPublish = {
-                published: false,
-                error: `Registry publish failed: ${err.message}`,
-            };
-        }
-    }
-    return result;
-}
+// ─── Tool: assess_risk ─────────────────────────────────────────────────
+// Core risk assessment tool. Optional on-chain publishing uses SignerProvider
+// and never accepts or returns raw private keys.
+// ────────────────────────────────────────────────────────────────────────
+import { z } from "zod";
+import { assessRisk } from "../lib/riskEngine.js";
+import { createPharosWalletClientFromAccount, publicClient, getExplorerUrl } from "../lib/pharosClient.js";
+import { RISK_REGISTRY_ADDRESS, RISK_REGISTRY_ABI } from "../lib/constants.js";
+import { getSigner, isSignerFailure } from "../lib/signer/index.js";
+import { requireWriteToolsEnabled } from "../lib/toolResponse.js";
+export const assessRiskSchema = z.object({
+    action: z.enum(["swap", "transfer"]),
+    tokenIn: z.string().optional(),
+    tokenOut: z.string().optional(),
+    amount: z.string(),
+    toAddress: z.string().optional(),
+    walletAddress: z.string(),
+    agentId: z.string().optional().describe("Managed testnet wallet agentId for optional registry publishing"),
+    autoPublish: z.boolean().optional().default(false).describe("If true, publish to RiskRegistry through SignerProvider when write tools are enabled"),
+    privateKey: z.string().optional().describe("Deprecated and ignored. Use SignerProvider via WALLET_MODE/agentId instead."),
+});
+export const assessRiskTool = {
+    name: "assess_risk",
+    description: "Evaluate risk of a planned on-chain action (swap or transfer). Returns 0-100 risk score with 5-dimension breakdown. " +
+        "Optional RiskRegistry publishing uses SignerProvider when autoPublish=true.",
+    inputSchema: assessRiskSchema,
+};
+export async function handleAssessRisk(raw) {
+    const input = assessRiskSchema.parse(raw);
+    if (input.action === "swap" && (!input.tokenIn || !input.tokenOut)) {
+        throw new Error("Swap action requires both tokenIn and tokenOut");
+    }
+    if (input.action === "transfer" && !input.toAddress) {
+        throw new Error("Transfer action requires toAddress");
+    }
+    const assessment = await assessRisk({
+        action: input.action,
+        tokenIn: input.tokenIn,
+        tokenOut: input.tokenOut,
+        amount: input.amount,
+        toAddress: input.toAddress,
+        walletAddress: input.walletAddress,
+    });
+    const result = { ...assessment };
+    const wantsPublish = input.autoPublish || Boolean(input.privateKey);
+    if (wantsPublish) {
+        if (input.privateKey) {
+            result.registryPublish = {
+                published: false,
+                error: "Direct privateKey input is deprecated and ignored. Use WALLET_MODE=managed-testnet with agentId or WALLET_MODE=env through SignerProvider.",
+            };
+            return result;
+        }
+        const writeGuard = requireWriteToolsEnabled("assess_risk_auto_publish");
+        if (writeGuard) {
+            result.registryPublish = { published: false, error: `${writeGuard.error.code}: ${writeGuard.error.message}` };
+            return result;
+        }
+        const signer = await getSigner(input.agentId);
+        if (isSignerFailure(signer)) {
+            result.registryPublish = { published: false, error: `${signer.error.code}: ${signer.error.message}` };
+            return result;
+        }
+        try {
+            const wallet = createPharosWalletClientFromAccount(signer.account);
+            const txHash = await wallet.writeContract({
+                address: RISK_REGISTRY_ADDRESS,
+                abi: RISK_REGISTRY_ABI,
+                functionName: "publish",
+                args: [
+                    input.walletAddress,
+                    BigInt(assessment.riskScore),
+                    assessment.riskLevel,
+                    assessment.recommendation,
+                ],
+            });
+            const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+            if (receipt.status !== "success") {
+                result.registryPublish = {
+                    published: false,
+                    txHash,
+                    explorerUrl: getExplorerUrl(txHash),
+                    error: "TX_REVERTED: transaction was mined but reverted. Ensure the calling wallet is authorized via RiskRegistry.setAuthorizedAgent() by the contract owner.",
+                    signerMode: signer.mode,
+                };
+            }
+            else {
+                result.registryPublish = {
+                    published: true,
+                    txHash,
+                    explorerUrl: getExplorerUrl(txHash),
+                    signerMode: signer.mode,
+                };
+            }
+        }
+        catch (err) {
+            result.registryPublish = {
+                published: false,
+                error: `Registry publish failed: ${err.message}`,
+            };
+        }
+    }
+    return result;
+}
 //# sourceMappingURL=assessRisk.js.map

package/dist/tools/assessRisk.js.map

@@ -1 +1 @@
-{"version":3,"file":"assessRisk.js","sourceRoot":"","sources":["../../src/tools/assessRisk.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,8EAA8E;AAC9E,iDAAiD;AACjD,2EAA2E;AAE3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAuB,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,mCAAmC,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC3G,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;IAC1G,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,sFAAsF,CAAC;IACnJ,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6EAA6E,CAAC;CAC1H,CAAC,CAAC;AAcH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,sHAAsH;QACtH,6EAA6E;IAC/E,WAAW,EAAE,gBAAgB;CAC9B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAoB;IACzD,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC;QAClC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,aAAa,EAAE,KAAK,CAAC,aAAa;KACnC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAqB,EAAE,GAAG,UAAU,EAAE,CAAC;IAEnD,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACpE,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,CAAC,eAAe,GAAG;gBACvB,SAAS,EAAE,KAAK;gBAChB,KAAK,EAAE,4IAA4I;aACpJ,CAAC;YACF,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,UAAU,GAAG,wBAAwB,CAAC,0BAA0B,CAAC,CAAC;QACxE,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,CAAC,eAAe,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9G,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,eAAe,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACtG,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,mCAAmC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACnE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC;gBACxC,OAAO,EAAE,qBAAqB;gBAC9B,GAAG,EAAE,iBAAiB;gBACtB,YAAY,EAAE,SAAS;gBACvB,IAAI,EAAE;oBACJ,KAAK,CAAC,aAA8B;oBACpC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC;oBAC5B,UAAU,CAAC,SAAS;oBACpB,UAAU,CAAC,cAAc;iBAC1B;aACF,CAAC,CAAC;YAEH,MAAM,YAAY,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAE/D,MAAM,CAAC,eAAe,GAAG;gBACvB,SAAS,EAAE,IAAI;gBACf,MAAM;gBACN,WAAW,EAAE,cAAc,CAAC,MAAM,CAAC;gBACnC,UAAU,EAAE,MAAM,CAAC,IAAI;aACxB,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,eAAe,GAAG;gBACvB,SAAS,EAAE,KAAK;gBAChB,KAAK,EAAE,4BAA6B,GAAa,CAAC,OAAO,EAAE;aAC5D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"assessRisk.js","sourceRoot":"","sources":["../../src/tools/assessRisk.ts"],"names":[],"mappings":"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"}

package/dist/tools/checkAllowance.d.ts

@@ -1,37 +1,44 @@
-import { z } from "zod";
-export declare const checkAllowanceSchema: z.ZodObject<{
-    walletAddress: z.ZodString;
-    token: z.ZodEnum<["USDC", "USDT"]>;
-}, "strip", z.ZodTypeAny, {
-    token: "USDC" | "USDT";
-    walletAddress: string;
-}, {
-    token: "USDC" | "USDT";
-    walletAddress: string;
-}>;
-export type CheckAllowanceInput = z.input<typeof checkAllowanceSchema>;
-export declare const checkAllowanceTool: {
-    name: string;
-    description: string;
-    inputSchema: z.ZodObject<{
-        walletAddress: z.ZodString;
-        token: z.ZodEnum<["USDC", "USDT"]>;
-    }, "strip", z.ZodTypeAny, {
-        token: "USDC" | "USDT";
-        walletAddress: string;
-    }, {
-        token: "USDC" | "USDT";
-        walletAddress: string;
-    }>;
-};
-export declare function handleCheckAllowance(raw: CheckAllowanceInput): Promise<{
-    token: "USDC" | "USDT";
-    tokenAddress: "0xE7E84B8B4f39C507499c40B4ac199B050e2882d5" | "0xE0BE08c77f415F577A1B3A9aD7a1Df1479564ec8";
-    walletAddress: string;
-    spender: "0x4Cf317b8918FbE8A890c01eDAb7d548555Ac2cE9";
-    allowance: string;
-    allowanceRaw: string;
-    isApproved: boolean;
-    needsApproval: boolean;
-}>;
+import { z } from "zod";
+export declare const checkAllowanceSchema: z.ZodObject<{
+    walletAddress: z.ZodString;
+    token: z.ZodEnum<["USDC", "USDT"]>;
+    amount: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    token: "USDC" | "USDT";
+    walletAddress: string;
+    amount?: string | undefined;
+}, {
+    token: "USDC" | "USDT";
+    walletAddress: string;
+    amount?: string | undefined;
+}>;
+export type CheckAllowanceInput = z.input<typeof checkAllowanceSchema>;
+export declare const checkAllowanceTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        walletAddress: z.ZodString;
+        token: z.ZodEnum<["USDC", "USDT"]>;
+        amount: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        token: "USDC" | "USDT";
+        walletAddress: string;
+        amount?: string | undefined;
+    }, {
+        token: "USDC" | "USDT";
+        walletAddress: string;
+        amount?: string | undefined;
+    }>;
+};
+export declare function handleCheckAllowance(raw: CheckAllowanceInput): Promise<import("../lib/toolResponse.js").ToolSuccess<{
+    token: "USDC" | "USDT";
+    tokenAddress: "0xE7E84B8B4f39C507499c40B4ac199B050e2882d5" | "0xE0BE08c77f415F577A1B3A9aD7a1Df1479564ec8";
+    walletAddress: string;
+    spender: "0x4Cf317b8918FbE8A890c01eDAb7d548555Ac2cE9";
+    allowance: string;
+    allowanceRaw: string;
+    isApproved: boolean;
+    needsApproval: boolean;
+    approvalNote: string;
+}>>;
 //# sourceMappingURL=checkAllowance.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"checkAllowance.d.ts","sourceRoot":"","sources":["../../src/tools/checkAllowance.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEvE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;CAK9B,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,mBAAmB;;;;;;;;;GA6BlE"}
+{"version":3,"file":"checkAllowance.d.ts","sourceRoot":"","sources":["../../src/tools/checkAllowance.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEvE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;CAK9B,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,mBAAmB;;;;;;;;;;IAyClE"}

package/dist/tools/checkAllowance.js

@@ -1,43 +1,57 @@
-// ─── Tool: check_allowance ─────────────────────────────────────────────
-// Checks ERC-20 token allowance for DODO_APPROVE_ADDRESS.
-// ────────────────────────────────────────────────────────────────────────
-import { z } from "zod";
-import { publicClient } from "../lib/pharosClient.js";
-import { DODO_APPROVE_ADDRESS, USDC_ADDRESS, USDT_ADDRESS, ERC20_ABI, } from "../lib/constants.js";
-import { formatUnits } from "viem";
-export const checkAllowanceSchema = z.object({
-    walletAddress: z.string().describe("Wallet address to check allowance for"),
-    token: z.enum(["USDC", "USDT"]).describe("ERC-20 token to check"),
-});
-export const checkAllowanceTool = {
-    name: "check_allowance",
-    description: "Check ERC-20 token allowance granted to DODO_APPROVE_ADDRESS for swaps. Returns current allowance and whether approval is needed.",
-    inputSchema: checkAllowanceSchema,
-};
-export async function handleCheckAllowance(raw) {
-    const input = checkAllowanceSchema.parse(raw);
-    const walletAddr = input.walletAddress;
-    const tokenAddress = input.token === "USDC" ? USDC_ADDRESS : USDT_ADDRESS;
-    const decimals = 6;
-    const allowanceRaw = (await publicClient.readContract({
-        address: tokenAddress,
-        abi: ERC20_ABI,
-        functionName: "allowance",
-        args: [walletAddr, DODO_APPROVE_ADDRESS],
-    }));
-    const allowanceFormatted = formatUnits(allowanceRaw, decimals);
-    // Consider "approved" if allowance is at least 1,000,000 tokens (typical max approval)
-    const isApproved = allowanceRaw > 0n;
-    const needsApproval = !isApproved;
-    return {
-        token: input.token,
-        tokenAddress,
-        walletAddress: input.walletAddress,
-        spender: DODO_APPROVE_ADDRESS,
-        allowance: allowanceFormatted,
-        allowanceRaw: allowanceRaw.toString(),
-        isApproved,
-        needsApproval,
-    };
-}
+// ─── Tool: check_allowance ─────────────────────────────────────────────
+// Checks ERC-20 token allowance for DODO_APPROVE_ADDRESS.
+// ────────────────────────────────────────────────────────────────────────
+import { z } from "zod";
+import { publicClient } from "../lib/pharosClient.js";
+import { DODO_APPROVE_ADDRESS, USDC_ADDRESS, USDT_ADDRESS, ERC20_ABI, } from "../lib/constants.js";
+import { formatUnits, parseUnits } from "viem";
+import { ok } from "../lib/toolResponse.js";
+export const checkAllowanceSchema = z.object({
+    walletAddress: z.string().describe("Wallet address to check allowance for"),
+    token: z.enum(["USDC", "USDT"]).describe("ERC-20 token to check"),
+    amount: z.string().optional().describe("Human-readable swap/transfer amount to check against. When provided, needsApproval is exact (allowance < amount). When omitted, only checks allowance > 0."),
+});
+export const checkAllowanceTool = {
+    name: "check_allowance",
+    description: "Check ERC-20 token allowance granted to DODO_APPROVE_ADDRESS for swaps. Returns current allowance and whether approval is needed.",
+    inputSchema: checkAllowanceSchema,
+};
+export async function handleCheckAllowance(raw) {
+    const input = checkAllowanceSchema.parse(raw);
+    const walletAddr = input.walletAddress;
+    const tokenAddress = input.token === "USDC" ? USDC_ADDRESS : USDT_ADDRESS;
+    const decimals = 6;
+    const allowanceRaw = (await publicClient.readContract({
+        address: tokenAddress,
+        abi: ERC20_ABI,
+        functionName: "allowance",
+        args: [walletAddr, DODO_APPROVE_ADDRESS],
+    }));
+    const allowanceFormatted = formatUnits(allowanceRaw, decimals);
+    let isApproved;
+    let needsApproval;
+    let approvalNote;
+    if (input.amount !== undefined) {
+        const requiredWei = parseUnits(input.amount, decimals);
+        isApproved = allowanceRaw >= requiredWei;
+        needsApproval = !isApproved;
+        approvalNote = `Amount-aware: allowance ${allowanceFormatted} vs required ${input.amount}`;
+    }
+    else {
+        isApproved = allowanceRaw > 0n;
+        needsApproval = !isApproved;
+        approvalNote = "Heuristic (no amount provided): any nonzero allowance counts as approved. Pass 'amount' for an exact check.";
+    }
+    return ok({
+        token: input.token,
+        tokenAddress,
+        walletAddress: input.walletAddress,
+        spender: DODO_APPROVE_ADDRESS,
+        allowance: allowanceFormatted,
+        allowanceRaw: allowanceRaw.toString(),
+        isApproved,
+        needsApproval,
+        approvalNote,
+    });
+}
 //# sourceMappingURL=checkAllowance.js.map

package/dist/tools/checkAllowance.js.map

@@ -1 +1 @@
-{"version":3,"file":"checkAllowance.js","sourceRoot":"","sources":["../../src/tools/checkAllowance.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,0DAA0D;AAC1D,2EAA2E;AAE3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,SAAS,GACV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAEnC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAC3E,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;CAClE,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,mIAAmI;IACrI,WAAW,EAAE,oBAAoB;CAClC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAwB;IACjE,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,KAAK,CAAC,aAA8B,CAAC;IACxD,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;IAC1E,MAAM,QAAQ,GAAG,CAAC,CAAC;IAEnB,MAAM,YAAY,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC;QACpD,OAAO,EAAE,YAAY;QACrB,GAAG,EAAE,SAAS;QACd,YAAY,EAAE,WAAW;QACzB,IAAI,EAAE,CAAC,UAAU,EAAE,oBAAoB,CAAC;KACzC,CAAC,CAAW,CAAC;IAEd,MAAM,kBAAkB,GAAG,WAAW,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAE/D,uFAAuF;IACvF,MAAM,UAAU,GAAG,YAAY,GAAG,EAAE,CAAC;IACrC,MAAM,aAAa,GAAG,CAAC,UAAU,CAAC;IAElC,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,YAAY;QACZ,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,OAAO,EAAE,oBAAoB;QAC7B,SAAS,EAAE,kBAAkB;QAC7B,YAAY,EAAE,YAAY,CAAC,QAAQ,EAAE;QACrC,UAAU;QACV,aAAa;KACd,CAAC;AACJ,CAAC"}
+{"version":3,"file":"checkAllowance.js","sourceRoot":"","sources":["../../src/tools/checkAllowance.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,0DAA0D;AAC1D,2EAA2E;AAE3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,SAAS,GACV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAC/C,OAAO,EAAE,EAAE,EAAQ,MAAM,wBAAwB,CAAC;AAElD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAC3E,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACjE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4JAA4J,CAAC;CACrM,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,mIAAmI;IACrI,WAAW,EAAE,oBAAoB;CAClC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAwB;IACjE,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,KAAK,CAAC,aAA8B,CAAC;IACxD,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;IAC1E,MAAM,QAAQ,GAAG,CAAC,CAAC;IAEnB,MAAM,YAAY,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC;QACpD,OAAO,EAAE,YAAY;QACrB,GAAG,EAAE,SAAS;QACd,YAAY,EAAE,WAAW;QACzB,IAAI,EAAE,CAAC,UAAU,EAAE,oBAAoB,CAAC;KACzC,CAAC,CAAW,CAAC;IAEd,MAAM,kBAAkB,GAAG,WAAW,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAE/D,IAAI,UAAmB,CAAC;IACxB,IAAI,aAAsB,CAAC;IAC3B,IAAI,YAAoB,CAAC;IAEzB,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvD,UAAU,GAAG,YAAY,IAAI,WAAW,CAAC;QACzC,aAAa,GAAG,CAAC,UAAU,CAAC;QAC5B,YAAY,GAAG,2BAA2B,kBAAkB,gBAAgB,KAAK,CAAC,MAAM,EAAE,CAAC;IAC7F,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,YAAY,GAAG,EAAE,CAAC;QAC/B,aAAa,GAAG,CAAC,UAAU,CAAC;QAC5B,YAAY,GAAG,6GAA6G,CAAC;IAC/H,CAAC;IAED,OAAO,EAAE,CAAC;QACR,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,YAAY;QACZ,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,OAAO,EAAE,oBAAoB;QAC7B,SAAS,EAAE,kBAAkB;QAC7B,YAAY,EAAE,YAAY,CAAC,QAAQ,EAAE;QACrC,UAAU;QACV,aAAa;QACb,YAAY;KACb,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/checkTokenSecurity.d.ts

@@ -1,47 +1,47 @@
-import { z } from "zod";
-export declare const checkTokenSecuritySchema: z.ZodObject<{
-    tokenAddress: z.ZodString;
-    chainId: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-}, "strip", z.ZodTypeAny, {
-    tokenAddress: string;
-    chainId: number;
-}, {
-    tokenAddress: string;
-    chainId?: number | undefined;
-}>;
-export type CheckTokenSecurityInput = z.input<typeof checkTokenSecuritySchema>;
-export declare const checkTokenSecurityTool: {
-    name: string;
-    description: string;
-    inputSchema: z.ZodObject<{
-        tokenAddress: z.ZodString;
-        chainId: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    }, "strip", z.ZodTypeAny, {
-        tokenAddress: string;
-        chainId: number;
-    }, {
-        tokenAddress: string;
-        chainId?: number | undefined;
-    }>;
-};
-export declare function handleCheckTokenSecurity(raw: CheckTokenSecurityInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
-    chainId: number;
-    environment: string;
-    isMainnet: boolean;
-    tokenAddress: `0x${string}`;
-    securityProfile: {
-        safetyScore: number;
-        isHoneypot: boolean;
-        buyTaxPercent: number;
-        sellTaxPercent: number;
-        isMintable: boolean;
-        transferPausable: boolean;
-        isProxy: boolean;
-        ownerAddress: any;
-        creatorAddress: any;
-    };
-    flags: string[];
-    source: string;
-    sourceStatus: string;
-}>>;
+import { z } from "zod";
+export declare const checkTokenSecuritySchema: z.ZodObject<{
+    tokenAddress: z.ZodString;
+    chainId: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    tokenAddress: string;
+    chainId: number;
+}, {
+    tokenAddress: string;
+    chainId?: number | undefined;
+}>;
+export type CheckTokenSecurityInput = z.input<typeof checkTokenSecuritySchema>;
+export declare const checkTokenSecurityTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        tokenAddress: z.ZodString;
+        chainId: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        tokenAddress: string;
+        chainId: number;
+    }, {
+        tokenAddress: string;
+        chainId?: number | undefined;
+    }>;
+};
+export declare function handleCheckTokenSecurity(raw: CheckTokenSecurityInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
+    chainId: number;
+    environment: string;
+    isMainnet: boolean;
+    tokenAddress: `0x${string}`;
+    securityProfile: {
+        safetyScore: number;
+        isHoneypot: boolean;
+        buyTaxPercent: number;
+        sellTaxPercent: number;
+        isMintable: boolean;
+        transferPausable: boolean;
+        isProxy: boolean;
+        ownerAddress: any;
+        creatorAddress: any;
+    };
+    flags: string[];
+    source: string;
+    sourceStatus: string;
+}>>;
 //# sourceMappingURL=checkTokenSecurity.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"checkTokenSecurity.d.ts","sourceRoot":"","sources":["../../src/tools/checkTokenSecurity.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,wBAAwB;;;;;;;;;EAGnC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE/E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;CAKlC,CAAC;AAEF,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,uBAAuB;;;;;;;;;;;;;;;;;;;IAqF1E"}
+{"version":3,"file":"checkTokenSecurity.d.ts","sourceRoot":"","sources":["../../src/tools/checkTokenSecurity.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,wBAAwB;;;;;;;;;EAGnC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE/E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;CAKlC,CAAC;AAEF,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,uBAAuB;;;;;;;;;;;;;;;;;;;IAkG1E"}