safehands-pharos 1.4.0 → 2.6.0

package/dist/tools/assessRisk.js

@@ -1,105 +1,64 @@
-// ─── 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;
-}
+// ─── Tool: assess_risk ─────────────────────────────────────────────────
+// Core risk assessment tool. Risk scoring / analysis ONLY — it never writes
+// to any registry. To publish an attestation on-chain, use publish_risk_score
+// (SafeHandsRegistry, gated by WRITE_TOOLS_ENABLED + signer + authorization).
+// ────────────────────────────────────────────────────────────────────────
+import { z } from "zod";
+import { assessRisk } from "../lib/riskEngine.js";
+import { fail, ok } from "../lib/toolResponse.js";
+import { validatePositiveAmount, validateAddress } from "../lib/validation.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("Optional agent identifier (informational only; assess_risk does not execute or publish)"),
+    privateKey: z.string().optional().describe("Deprecated and ignored. assess_risk never signs or publishes. Use publish_risk_score for on-chain attestation."),
+}).strict();
+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. " +
+        "Scoring and analysis only; does not publish on-chain. Use publish_risk_score to attest a result to SafeHandsRegistry.",
+    inputSchema: assessRiskSchema,
+};
+export async function handleAssessRisk(raw) {
+    let input;
+    try {
+        input = assessRiskSchema.parse(raw);
+    }
+    catch (err) {
+        const msg = err instanceof z.ZodError
+            ? err.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")
+            : String(err);
+        return fail("VALIDATION_ERROR", `assess_risk input validation failed: ${msg}`, false, "assess_risk");
+    }
+    const amtErr = validatePositiveAmount(input.amount, "amount");
+    if (amtErr)
+        return fail("VALIDATION_ERROR", amtErr, false, "assess_risk");
+    const addrErr = validateAddress(input.walletAddress, "walletAddress");
+    if (addrErr)
+        return fail("VALIDATION_ERROR", addrErr, false, "assess_risk");
+    if (input.action === "swap" && (!input.tokenIn || !input.tokenOut)) {
+        return fail("VALIDATION_ERROR", "Swap action requires both tokenIn and tokenOut.", false, "assess_risk");
+    }
+    if (input.action === "transfer") {
+        if (!input.toAddress) {
+            return fail("VALIDATION_ERROR", "Transfer action requires toAddress.", false, "assess_risk");
+        }
+        const toErr = validateAddress(input.toAddress, "toAddress");
+        if (toErr)
+            return fail("VALIDATION_ERROR", toErr, false, "assess_risk");
+    }
+    const assessment = await assessRisk({
+        action: input.action,
+        tokenIn: input.tokenIn,
+        tokenOut: input.tokenOut,
+        amount: input.amount,
+        toAddress: input.toAddress,
+        walletAddress: input.walletAddress,
+    });
+    return ok(assessment);
+}
 //# 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":"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"}
+{"version":3,"file":"assessRisk.js","sourceRoot":"","sources":["../../src/tools/assessRisk.ts"],"names":[],"mappings":"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"}

package/dist/tools/checkAllowance.d.ts

@@ -1,44 +1,50 @@
-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;
-}>>;
+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("../sdk.js").ToolFailure | import("../sdk.js").ToolSuccess<{
+    token: "USDC" | "USDT";
+    tokenAddress: `0x${string}`;
+    walletAddress: `0x${string}`;
+    spender: "0x4Cf317b8918FbE8A890c01eDAb7d548555Ac2cE9";
+    spenderRecognition: {
+        recognized: boolean;
+        label: string;
+    };
+    allowance: string;
+    allowanceRaw: string;
+    isApproved: boolean;
+    needsApproval: boolean;
+    approvalNote: string;
+    chainId: number;
+    environment: 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;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"}
+{"version":3,"file":"checkAllowance.d.ts","sourceRoot":"","sources":["../../src/tools/checkAllowance.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,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;AAaF,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,mBAAmB;;;;;;;;;;;;;;;;IA2DlE"}

package/dist/tools/checkAllowance.js

@@ -1,57 +1,79 @@
-// ─── 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,
-    });
-}
+// ─── 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, ERC20_ABI, CHAIN_ID, PHAROS_ENVIRONMENT, activeTokenMap, activeTokenDecimals, } from "../lib/constants.js";
+import { formatUnits, isAddress, parseUnits } from "viem";
+import { ok, fail } from "../lib/toolResponse.js";
+import { lookupCanonical } from "../lib/analysis/contractIntel.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,
+};
+function resolveAllowanceToken(symbol) {
+    const map = activeTokenMap();
+    const decimalsMap = activeTokenDecimals();
+    const tokenAddress = map[symbol];
+    if (!tokenAddress)
+        return null;
+    return {
+        tokenAddress,
+        decimals: decimalsMap[symbol] ?? decimalsMap[tokenAddress.toLowerCase()] ?? 18,
+    };
+}
+export async function handleCheckAllowance(raw) {
+    const input = checkAllowanceSchema.parse(raw);
+    if (!isAddress(input.walletAddress)) {
+        return fail("INVALID_WALLET_ADDRESS", `Invalid wallet address: ${input.walletAddress}`, false, "check_allowance");
+    }
+    const resolved = resolveAllowanceToken(input.token);
+    if (!resolved) {
+        return fail("UNSUPPORTED_TOKEN", `${input.token} is not configured for ${PHAROS_ENVIRONMENT} (${CHAIN_ID}). No allowance query was made against a fallback/testnet address.`, false, "check_allowance");
+    }
+    const walletAddr = input.walletAddress;
+    const { tokenAddress, decimals } = resolved;
+    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.";
+    }
+    const spenderCanonical = lookupCanonical(DODO_APPROVE_ADDRESS);
+    return ok({
+        token: input.token,
+        tokenAddress,
+        walletAddress: input.walletAddress,
+        spender: DODO_APPROVE_ADDRESS,
+        spenderRecognition: { recognized: Boolean(spenderCanonical), label: spenderCanonical?.label ?? "DODO/FaroSwap approve proxy (project-configured allowlist target; not registry-verified)" },
+        allowance: allowanceFormatted,
+        allowanceRaw: allowanceRaw.toString(),
+        isApproved,
+        needsApproval,
+        approvalNote,
+        chainId: CHAIN_ID,
+        environment: PHAROS_ENVIRONMENT,
+    });
+}
 //# 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,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"}
+{"version":3,"file":"checkAllowance.js","sourceRoot":"","sources":["../../src/tools/checkAllowance.ts"],"names":[],"mappings":"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"}

package/dist/tools/checkTokenSecurity.d.ts

@@ -1,47 +1,104 @@
-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, {
+    chainId: number;
+    tokenAddress: string;
+}, {
+    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, {
+        chainId: number;
+        tokenAddress: string;
+    }, {
+        tokenAddress: string;
+        chainId?: number | undefined;
+    }>;
+};
+export interface GoplusTokenProfile {
+    /** Display-only identity metadata — never used in scoring or policy decisions. */
+    tokenName?: string;
+    tokenSymbol?: string;
+    isHoneypot: boolean;
+    buyTaxPercent: number;
+    sellTaxPercent: number;
+    isMintable: boolean;
+    transferPausable: boolean;
+    isProxy: boolean;
+    ownerAddress: string;
+    creatorAddress: string;
+}
+/**
+ * Parse a GoPlus token_security result entry into a normalized profile, or return
+ * `null` when the schema is unrecognized (the honeypot decision field is missing or
+ * not a boolean-ish value). Pure + synchronous so the fail-open guard is unit-testable
+ * with no network. Callers MUST treat null as "data unavailable" and fail closed.
+ */
+export declare function interpretGoplusTokenResult(details: unknown): GoplusTokenProfile | null;
+/**
+ * Best-effort, DISPLAY-ONLY token identity from GoPlus. Reads ONLY token_name /
+ * token_symbol and deliberately ignores the security schema: a payload that
+ * check_token_security fails closed on (e.g. is_honeypot missing) can still carry
+ * identity metadata. Never throws — returns {} on any timeout/network/parse failure.
+ * Unlike the security check (which keeps the stronger fetchGoplus retry path),
+ * this is optional enrichment: a single attempt with a short 3s timeout so it
+ * cannot make token_registry_status slow.
+ * MUST NOT be used for risk scoring, policy decisions, write gates, or
+ * allow/block logic; it does not verify anything about the token.
+ */
+export declare function fetchGoplusTokenIdentity(tokenAddress: string, chainId?: number): Promise<{
+    tokenName?: string;
+    tokenSymbol?: string;
+}>;
+/**
+ * Network metadata for the tool response, derived from the ACTIVE network
+ * instead of a hardcoded `isMainnet: true` (which misreported on
+ * atlantic-testnet). Unknown chains report false. Pure + exported for tests.
+ */
+export declare function tokenSecurityNetworkMetadata(chainId: number): {
+    chainId: number;
+    environment: string;
+    isMainnet: boolean;
+};
+export declare function handleCheckTokenSecurity(raw: CheckTokenSecurityInput): Promise<import("../sdk.js").ToolFailure | import("../sdk.js").ToolSuccess<{
+    tokenAddress: `0x${string}`;
+    tokenName: string | undefined;
+    tokenSymbol: string | undefined;
+    securityProfile: {
+        safetyScore: number;
+        isHoneypot: boolean;
+        buyTaxPercent: number;
+        sellTaxPercent: number;
+        isMintable: boolean;
+        transferPausable: boolean;
+        isProxy: boolean;
+        ownerAddress: string;
+        creatorAddress: string;
+    };
+    flags: string[];
+    source: string;
+    sourceStatus: string;
+    chainId: number;
+    environment: string;
+    isMainnet: boolean;
+}>>;
+export type TokenSecurityVerdict = "ok" | "review" | "block";
+export interface TokenSecurityGateResult {
+    verdict: TokenSecurityVerdict;
+    /** Value to pass as evaluateActionPolicy input.tokenSecurityStatus. */
+    policyStatus: "ok" | "unknown" | "unavailable";
+    flags: string[];
+    safetyScore?: number;
+    detail?: string;
+}
+export declare function evaluateTokenSecurityGate(tokenAddress: string, chainId?: number): Promise<TokenSecurityGateResult>;
 //# 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;;;;;;;;;;;;;;;;;;;IAkG1E"}
+{"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;AA+CF,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAiBtF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,EACpB,OAAO,SAAW,GACjB,OAAO,CAAC;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BvD;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB,CAMA;AAED,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,uBAAuB;;;;;;;;;;;;;;;;;;aAXhE,MAAM;iBACF,MAAM;eACR,OAAO;IAuGnB;AAgBD,MAAM,MAAM,oBAAoB,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7D,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,uEAAuE;IACvE,YAAY,EAAE,IAAI,GAAG,SAAS,GAAG,aAAa,CAAC;IAC/C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAUD,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,MAAM,EACpB,OAAO,SAAW,GACjB,OAAO,CAAC,uBAAuB,CAAC,CA8BlC"}