safehands-pharos 1.3.0 → 1.4.0

package/dist/tools/publishRiskScore.js

@@ -1,86 +1,89 @@
-// ─── Tool: publish_risk_score ──────────────────────────────────────────
-// Publishes a risk assessment result to the on-chain RiskRegistry.
-// ────────────────────────────────────────────────────────────────────────
-import { z } from "zod";
-import { publicClient, createPharosWalletClientFromAccount, getExplorerUrl } from "../lib/pharosClient.js";
-import { RISK_REGISTRY_ADDRESS, RISK_REGISTRY_ABI, CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
-import { assessRisk } from "../lib/riskEngine.js";
-import { fail, ok, classifyExternalError } from "../lib/toolResponse.js";
-import { getSigner, isSignerFailure } from "../lib/signer/index.js";
-import { evaluateActionPolicy } from "../lib/policy/actionPolicyEngine.js";
-export const publishRiskScoreSchema = z.object({
-    action: z.enum(["swap", "transfer"]).describe("Type of on-chain action to assess"),
-    tokenIn: z.string().optional(),
-    tokenOut: z.string().optional(),
-    amount: z.string().describe("Human-readable amount"),
-    toAddress: z.string().optional().describe("Recipient address (for transfers)"),
-    agentId: z.string().optional().describe("Managed testnet wallet agentId when WALLET_MODE=managed-testnet"),
-});
-export const publishRiskScoreTool = {
-    name: "publish_risk_score",
-    description: "Run a risk assessment and publish the result to the on-chain RiskRegistry. " +
-        "Other agents can then query this wallet's risk score without re-running the assessment.",
-    inputSchema: publishRiskScoreSchema,
-};
-export async function handlePublishRiskScore(raw) {
-    if (process.env.WRITE_TOOLS_ENABLED !== "true") {
-        return fail("WRITE_TOOLS_DISABLED", "publish_risk_score is disabled by default. Set WRITE_TOOLS_ENABLED=true only for trusted testnet execution.", false, "publish_risk_score");
-    }
-    const input = publishRiskScoreSchema.parse(raw);
-    const signer = await getSigner(input.agentId);
-    if (isSignerFailure(signer)) {
-        return fail(signer.error.code, signer.error.message, false, "publish_risk_score");
-    }
-    const policy = evaluateActionPolicy({
-        actionType: "publish_risk_score",
-        chainId: CHAIN_ID,
-        environment: PHAROS_ENVIRONMENT,
-        isMainnet: false,
-        signerAvailable: true,
-        requiresSigner: true,
-    });
-    if (policy.decision === "BLOCK") {
-        return fail("POLICY_BLOCKED", policy.reasons.join(" ") || "Publishing blocked by SafeHands policy.", false, "publish_risk_score");
-    }
-    const walletAddress = signer.address;
-    const assessment = await assessRisk({
-        action: input.action,
-        tokenIn: input.tokenIn,
-        tokenOut: input.tokenOut,
-        amount: input.amount,
-        toAddress: input.toAddress,
-        walletAddress,
-    });
-    try {
-        const wallet = createPharosWalletClientFromAccount(signer.account);
-        const txHash = await wallet.writeContract({
-            address: RISK_REGISTRY_ADDRESS,
-            abi: RISK_REGISTRY_ABI,
-            functionName: "publish",
-            args: [
-                walletAddress,
-                BigInt(assessment.riskScore),
-                assessment.riskLevel,
-                assessment.recommendation,
-            ],
-        });
-        const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
-        return ok({
-            assessment,
-            policy,
-            signerMode: signer.mode,
-            onChain: {
-                txHash,
-                explorerUrl: getExplorerUrl(txHash),
-                contractAddress: RISK_REGISTRY_ADDRESS,
-                gasUsed: receipt.gasUsed.toString(),
-                blockNumber: receipt.blockNumber.toString(),
-            },
-            source: "publish_risk_score",
-        });
-    }
-    catch (err) {
-        return classifyExternalError("pharos_rpc", err);
-    }
-}
+// ─── Tool: publish_risk_score ──────────────────────────────────────────
+// Publishes a risk assessment result to the on-chain RiskRegistry.
+// ────────────────────────────────────────────────────────────────────────
+import { z } from "zod";
+import { publicClient, createPharosWalletClientFromAccount, getExplorerUrl } from "../lib/pharosClient.js";
+import { RISK_REGISTRY_ADDRESS, RISK_REGISTRY_ABI, CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
+import { assessRisk } from "../lib/riskEngine.js";
+import { fail, ok, classifyExternalError } from "../lib/toolResponse.js";
+import { getSigner, isSignerFailure } from "../lib/signer/index.js";
+import { evaluateActionPolicy } from "../lib/policy/actionPolicyEngine.js";
+export const publishRiskScoreSchema = z.object({
+    action: z.enum(["swap", "transfer"]).describe("Type of on-chain action to assess"),
+    tokenIn: z.string().optional(),
+    tokenOut: z.string().optional(),
+    amount: z.string().describe("Human-readable amount"),
+    toAddress: z.string().optional().describe("Recipient address (for transfers)"),
+    agentId: z.string().optional().describe("Managed testnet wallet agentId when WALLET_MODE=managed-testnet"),
+});
+export const publishRiskScoreTool = {
+    name: "publish_risk_score",
+    description: "Run a risk assessment and publish the result to the on-chain RiskRegistry. " +
+        "Other agents can then query this wallet's risk score without re-running the assessment.",
+    inputSchema: publishRiskScoreSchema,
+};
+export async function handlePublishRiskScore(raw) {
+    if (process.env.WRITE_TOOLS_ENABLED !== "true") {
+        return fail("WRITE_TOOLS_DISABLED", "publish_risk_score is disabled by default. Set WRITE_TOOLS_ENABLED=true only for trusted testnet execution.", false, "publish_risk_score");
+    }
+    const input = publishRiskScoreSchema.parse(raw);
+    const signer = await getSigner(input.agentId);
+    if (isSignerFailure(signer)) {
+        return fail(signer.error.code, signer.error.message, false, "publish_risk_score");
+    }
+    const policy = evaluateActionPolicy({
+        actionType: "publish_risk_score",
+        chainId: CHAIN_ID,
+        environment: PHAROS_ENVIRONMENT,
+        isMainnet: false,
+        signerAvailable: true,
+        requiresSigner: true,
+    });
+    if (policy.decision === "BLOCK") {
+        return fail("POLICY_BLOCKED", policy.reasons.join(" ") || "Publishing blocked by SafeHands policy.", false, "publish_risk_score");
+    }
+    const walletAddress = signer.address;
+    const assessment = await assessRisk({
+        action: input.action,
+        tokenIn: input.tokenIn,
+        tokenOut: input.tokenOut,
+        amount: input.amount,
+        toAddress: input.toAddress,
+        walletAddress,
+    });
+    try {
+        const wallet = createPharosWalletClientFromAccount(signer.account);
+        const txHash = await wallet.writeContract({
+            address: RISK_REGISTRY_ADDRESS,
+            abi: RISK_REGISTRY_ABI,
+            functionName: "publish",
+            args: [
+                walletAddress,
+                BigInt(assessment.riskScore),
+                assessment.riskLevel,
+                assessment.recommendation,
+            ],
+        });
+        const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+        if (receipt.status !== "success") {
+            return fail("TX_REVERTED", "publish_risk_score transaction was mined but reverted on-chain. Ensure the calling wallet is authorized via RiskRegistry.setAuthorizedAgent() by the contract owner.", false, "publish_risk_score");
+        }
+        return ok({
+            assessment,
+            policy,
+            signerMode: signer.mode,
+            onChain: {
+                txHash,
+                explorerUrl: getExplorerUrl(txHash),
+                contractAddress: RISK_REGISTRY_ADDRESS,
+                gasUsed: receipt.gasUsed.toString(),
+                blockNumber: receipt.blockNumber.toString(),
+            },
+            source: "publish_risk_score",
+        });
+    }
+    catch (err) {
+        return classifyExternalError("pharos_rpc", err);
+    }
+}
 //# sourceMappingURL=publishRiskScore.js.map

package/dist/tools/publishRiskScore.js.map

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

package/dist/tools/queryRiskRegistry.d.ts

@@ -1,49 +1,39 @@
-import { z } from "zod";
-export declare const queryRiskRegistrySchema: z.ZodObject<{
-    walletAddress: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    walletAddress: string;
-}, {
-    walletAddress: string;
-}>;
-export type QueryRiskRegistryInput = z.input<typeof queryRiskRegistrySchema>;
-export declare const queryRiskRegistryTool: {
-    name: string;
-    description: string;
-    inputSchema: z.ZodObject<{
-        walletAddress: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        walletAddress: string;
-    }, {
-        walletAddress: string;
-    }>;
-};
-export declare function handleQueryRiskRegistry(raw: QueryRiskRegistryInput): Promise<{
-    walletAddress: string;
-    found: boolean;
-    record: null;
-    registryContract: `0x${string}`;
-    message: string;
-    error?: undefined;
-} | {
-    walletAddress: string;
-    found: boolean;
-    record: {
-        score: number;
-        riskLevel: string;
-        recommendation: string;
-        timestamp: string;
-        assessedBy: `0x${string}`;
-    };
-    registryContract: `0x${string}`;
-    message?: undefined;
-    error?: undefined;
-} | {
-    walletAddress: string;
-    found: boolean;
-    record: null;
-    registryContract: `0x${string}`;
-    error: string;
-    message?: undefined;
-}>;
+import { z } from "zod";
+export declare const queryRiskRegistrySchema: z.ZodObject<{
+    walletAddress: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    walletAddress: string;
+}, {
+    walletAddress: string;
+}>;
+export type QueryRiskRegistryInput = z.input<typeof queryRiskRegistrySchema>;
+export declare const queryRiskRegistryTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        walletAddress: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        walletAddress: string;
+    }, {
+        walletAddress: string;
+    }>;
+};
+export declare function handleQueryRiskRegistry(raw: QueryRiskRegistryInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
+    walletAddress: string;
+    found: boolean;
+    record: null;
+    registryContract: `0x${string}`;
+    message: string;
+}> | import("../lib/toolResponse.js").ToolSuccess<{
+    walletAddress: string;
+    found: boolean;
+    record: {
+        score: number;
+        riskLevel: string;
+        recommendation: string;
+        timestamp: string;
+        assessedBy: `0x${string}`;
+    };
+    registryContract: `0x${string}`;
+}>>;
 //# sourceMappingURL=queryRiskRegistry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"queryRiskRegistry.d.ts","sourceRoot":"","sources":["../../src/tools/queryRiskRegistry.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,uBAAuB;;;;;;EAElC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE7E,eAAO,MAAM,qBAAqB;;;;;;;;;;CAMjC,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDxE"}
+{"version":3,"file":"queryRiskRegistry.d.ts","sourceRoot":"","sources":["../../src/tools/queryRiskRegistry.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,uBAAuB;;;;;;EAElC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE7E,eAAO,MAAM,qBAAqB;;;;;;;;;;CAMjC,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,sBAAsB;;;;;;;;;;;;;;;;;IA8CxE"}

package/dist/tools/queryRiskRegistry.js

@@ -1,61 +1,56 @@
-// ─── Tool: query_risk_registry ─────────────────────────────────────────
-// Queries the on-chain RiskRegistry for a wallet's published risk score.
-// Read-only — no private key needed.
-// ────────────────────────────────────────────────────────────────────────
-import { z } from "zod";
-import { publicClient } from "../lib/pharosClient.js";
-import { RISK_REGISTRY_ADDRESS, RISK_REGISTRY_ABI } from "../lib/constants.js";
-export const queryRiskRegistrySchema = z.object({
-    walletAddress: z.string().describe("Wallet address to query risk score for"),
-});
-export const queryRiskRegistryTool = {
-    name: "query_risk_registry",
-    description: "Query the on-chain RiskRegistry for a wallet's published risk score. " +
-        "Read-only, no private key needed. Returns score, level, recommendation, timestamp, and assessor.",
-    inputSchema: queryRiskRegistrySchema,
-};
-export async function handleQueryRiskRegistry(raw) {
-    const input = queryRiskRegistrySchema.parse(raw);
-    try {
-        const result = (await publicClient.readContract({
-            address: RISK_REGISTRY_ADDRESS,
-            abi: RISK_REGISTRY_ABI,
-            functionName: "query",
-            args: [input.walletAddress],
-        }));
-        const score = Number(result.score);
-        const timestamp = Number(result.timestamp);
-        // Check if record exists (timestamp will be 0 if never published)
-        if (timestamp === 0) {
-            return {
-                walletAddress: input.walletAddress,
-                found: false,
-                record: null,
-                registryContract: RISK_REGISTRY_ADDRESS,
-                message: "No risk score published for this wallet",
-            };
-        }
-        return {
-            walletAddress: input.walletAddress,
-            found: true,
-            record: {
-                score,
-                riskLevel: result.riskLevel,
-                recommendation: result.recommendation,
-                timestamp: new Date(timestamp * 1000).toISOString(),
-                assessedBy: result.assessedBy,
-            },
-            registryContract: RISK_REGISTRY_ADDRESS,
-        };
-    }
-    catch (err) {
-        return {
-            walletAddress: input.walletAddress,
-            found: false,
-            record: null,
-            registryContract: RISK_REGISTRY_ADDRESS,
-            error: `Failed to query registry: ${err.message}`,
-        };
-    }
-}
+// ─── Tool: query_risk_registry ─────────────────────────────────────────
+// Queries the on-chain RiskRegistry for a wallet's published risk score.
+// Read-only — no private key needed.
+// ────────────────────────────────────────────────────────────────────────
+import { z } from "zod";
+import { publicClient } from "../lib/pharosClient.js";
+import { RISK_REGISTRY_ADDRESS, RISK_REGISTRY_ABI } from "../lib/constants.js";
+import { ok, fail } from "../lib/toolResponse.js";
+export const queryRiskRegistrySchema = z.object({
+    walletAddress: z.string().describe("Wallet address to query risk score for"),
+});
+export const queryRiskRegistryTool = {
+    name: "query_risk_registry",
+    description: "Query the on-chain RiskRegistry for a wallet's published risk score. " +
+        "Read-only, no private key needed. Returns score, level, recommendation, timestamp, and assessor.",
+    inputSchema: queryRiskRegistrySchema,
+};
+export async function handleQueryRiskRegistry(raw) {
+    const input = queryRiskRegistrySchema.parse(raw);
+    try {
+        const result = (await publicClient.readContract({
+            address: RISK_REGISTRY_ADDRESS,
+            abi: RISK_REGISTRY_ABI,
+            functionName: "query",
+            args: [input.walletAddress],
+        }));
+        const score = Number(result.score);
+        const timestamp = Number(result.timestamp);
+        // Check if record exists (timestamp will be 0 if never published)
+        if (timestamp === 0) {
+            return ok({
+                walletAddress: input.walletAddress,
+                found: false,
+                record: null,
+                registryContract: RISK_REGISTRY_ADDRESS,
+                message: "No risk score published for this wallet",
+            });
+        }
+        return ok({
+            walletAddress: input.walletAddress,
+            found: true,
+            record: {
+                score,
+                riskLevel: result.riskLevel,
+                recommendation: result.recommendation,
+                timestamp: new Date(timestamp * 1000).toISOString(),
+                assessedBy: result.assessedBy,
+            },
+            registryContract: RISK_REGISTRY_ADDRESS,
+        });
+    }
+    catch (err) {
+        return fail("REGISTRY_QUERY_FAILED", `Failed to query registry: ${err.message}`, true, "query_risk_registry");
+    }
+}
 //# sourceMappingURL=queryRiskRegistry.js.map

package/dist/tools/queryRiskRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"queryRiskRegistry.js","sourceRoot":"","sources":["../../src/tools/queryRiskRegistry.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,yEAAyE;AACzE,qCAAqC;AACrC,2EAA2E;AAE3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAkB,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE/E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;CAC7E,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,uEAAuE;QACvE,kGAAkG;IACpG,WAAW,EAAE,uBAAuB;CACrC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,GAA2B;IACvE,MAAM,KAAK,GAAG,uBAAuB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC;YAC9C,OAAO,EAAE,qBAAqB;YAC9B,GAAG,EAAE,iBAAiB;YACtB,YAAY,EAAE,OAAO;YACrB,IAAI,EAAE,CAAC,KAAK,CAAC,aAA8B,CAAC;SAC7C,CAAC,CAMD,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAE3C,kEAAkE;QAClE,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YACpB,OAAO;gBACL,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,IAAI;gBACZ,gBAAgB,EAAE,qBAAqB;gBACvC,OAAO,EAAE,yCAAyC;aACnD,CAAC;QACJ,CAAC;QAED,OAAO;YACL,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,KAAK,EAAE,IAAI;YACX,MAAM,EAAE;gBACN,KAAK;gBACL,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,SAAS,EAAE,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;gBACnD,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B;YACD,gBAAgB,EAAE,qBAAqB;SACxC,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,IAAI;YACZ,gBAAgB,EAAE,qBAAqB;YACvC,KAAK,EAAE,6BAA8B,GAAa,CAAC,OAAO,EAAE;SAC7D,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"queryRiskRegistry.js","sourceRoot":"","sources":["../../src/tools/queryRiskRegistry.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,yEAAyE;AACzE,qCAAqC;AACrC,2EAA2E;AAE3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAkB,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAElD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;CAC7E,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,uEAAuE;QACvE,kGAAkG;IACpG,WAAW,EAAE,uBAAuB;CACrC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,GAA2B;IACvE,MAAM,KAAK,GAAG,uBAAuB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC;YAC9C,OAAO,EAAE,qBAAqB;YAC9B,GAAG,EAAE,iBAAiB;YACtB,YAAY,EAAE,OAAO;YACrB,IAAI,EAAE,CAAC,KAAK,CAAC,aAA8B,CAAC;SAC7C,CAAC,CAMD,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAE3C,kEAAkE;QAClE,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YACpB,OAAO,EAAE,CAAC;gBACR,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,IAAI;gBACZ,gBAAgB,EAAE,qBAAqB;gBACvC,OAAO,EAAE,yCAAyC;aACnD,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,CAAC;YACR,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,KAAK,EAAE,IAAI;YACX,MAAM,EAAE;gBACN,KAAK;gBACL,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,SAAS,EAAE,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;gBACnD,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B;YACD,gBAAgB,EAAE,qBAAqB;SACxC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,uBAAuB,EAAE,6BAA8B,GAAa,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAC3H,CAAC;AACH,CAAC"}

package/dist/tools/safehandsPreflightCheck.d.ts

@@ -1,78 +1,78 @@
-import { z } from "zod";
-import { type ToolResponse } from "../lib/toolResponse.js";
-export declare const safehandsPreflightCheckSchema: z.ZodObject<{
-    actionType: z.ZodEnum<["send_payment", "approve_token", "execute_swap", "x402_pay_and_fetch", "publish_risk_score", "custom_contract_call"]>;
-    chainId: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    environment: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    isMainnet: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    amount: z.ZodOptional<z.ZodString>;
-    amountUnit: z.ZodOptional<z.ZodEnum<["PHRS", "USDC", "USD", "TOKEN"]>>;
-    token: z.ZodOptional<z.ZodString>;
-    tokenAddress: z.ZodOptional<z.ZodString>;
-    tokenIn: z.ZodOptional<z.ZodString>;
-    tokenOut: z.ZodOptional<z.ZodString>;
-    recipient: z.ZodOptional<z.ZodString>;
-    spender: z.ZodOptional<z.ZodString>;
-    approvalAmount: z.ZodOptional<z.ZodString>;
-    approvalToken: z.ZodOptional<z.ZodString>;
-    approvalUnlimited: z.ZodOptional<z.ZodBoolean>;
-    url: z.ZodOptional<z.ZodString>;
-    paymentAmountUsdc: z.ZodOptional<z.ZodString>;
-    paymentTokenAddress: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    signerAvailable: z.ZodOptional<z.ZodBoolean>;
-    tokenSecurityStatus: z.ZodOptional<z.ZodEnum<["ok", "unavailable", "unknown"]>>;
-    recipientVerified: z.ZodOptional<z.ZodBoolean>;
-    spenderVerified: z.ZodOptional<z.ZodBoolean>;
-    requiresSigner: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    environment: string;
-    actionType: "send_payment" | "approve_token" | "execute_swap" | "x402_pay_and_fetch" | "publish_risk_score" | "custom_contract_call";
-    chainId: number;
-    isMainnet: boolean;
-    paymentTokenAddress: string;
-    spender?: string | undefined;
-    amount?: string | undefined;
-    token?: string | undefined;
-    tokenAddress?: string | undefined;
-    amountUnit?: "PHRS" | "USDC" | "USD" | "TOKEN" | undefined;
-    tokenIn?: string | undefined;
-    tokenOut?: string | undefined;
-    recipient?: string | undefined;
-    approvalAmount?: string | undefined;
-    approvalToken?: string | undefined;
-    approvalUnlimited?: boolean | undefined;
-    url?: string | undefined;
-    paymentAmountUsdc?: string | undefined;
-    signerAvailable?: boolean | undefined;
-    tokenSecurityStatus?: "unknown" | "ok" | "unavailable" | undefined;
-    recipientVerified?: boolean | undefined;
-    spenderVerified?: boolean | undefined;
-    requiresSigner?: boolean | undefined;
-}, {
-    actionType: "send_payment" | "approve_token" | "execute_swap" | "x402_pay_and_fetch" | "publish_risk_score" | "custom_contract_call";
-    spender?: string | undefined;
-    amount?: string | undefined;
-    environment?: string | undefined;
-    token?: string | undefined;
-    tokenAddress?: string | undefined;
-    chainId?: number | undefined;
-    isMainnet?: boolean | undefined;
-    amountUnit?: "PHRS" | "USDC" | "USD" | "TOKEN" | undefined;
-    tokenIn?: string | undefined;
-    tokenOut?: string | undefined;
-    recipient?: string | undefined;
-    approvalAmount?: string | undefined;
-    approvalToken?: string | undefined;
-    approvalUnlimited?: boolean | undefined;
-    url?: string | undefined;
-    paymentAmountUsdc?: string | undefined;
-    paymentTokenAddress?: string | undefined;
-    signerAvailable?: boolean | undefined;
-    tokenSecurityStatus?: "unknown" | "ok" | "unavailable" | undefined;
-    recipientVerified?: boolean | undefined;
-    spenderVerified?: boolean | undefined;
-    requiresSigner?: boolean | undefined;
-}>;
-export type SafeHandsPreflightCheckInput = z.input<typeof safehandsPreflightCheckSchema>;
-export declare function handleSafeHandsPreflightCheck(raw: SafeHandsPreflightCheckInput): Promise<ToolResponse<unknown>>;
+import { z } from "zod";
+import { type ToolResponse } from "../lib/toolResponse.js";
+export declare const safehandsPreflightCheckSchema: z.ZodObject<{
+    actionType: z.ZodEnum<["send_payment", "approve_token", "execute_swap", "x402_pay_and_fetch", "publish_risk_score", "custom_contract_call"]>;
+    chainId: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    environment: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    isMainnet: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    amount: z.ZodOptional<z.ZodString>;
+    amountUnit: z.ZodOptional<z.ZodEnum<["PHRS", "USDC", "USD", "TOKEN"]>>;
+    token: z.ZodOptional<z.ZodString>;
+    tokenAddress: z.ZodOptional<z.ZodString>;
+    tokenIn: z.ZodOptional<z.ZodString>;
+    tokenOut: z.ZodOptional<z.ZodString>;
+    recipient: z.ZodOptional<z.ZodString>;
+    spender: z.ZodOptional<z.ZodString>;
+    approvalAmount: z.ZodOptional<z.ZodString>;
+    approvalToken: z.ZodOptional<z.ZodString>;
+    approvalUnlimited: z.ZodOptional<z.ZodBoolean>;
+    url: z.ZodOptional<z.ZodString>;
+    paymentAmountUsdc: z.ZodOptional<z.ZodString>;
+    paymentTokenAddress: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    signerAvailable: z.ZodOptional<z.ZodBoolean>;
+    tokenSecurityStatus: z.ZodOptional<z.ZodEnum<["ok", "unavailable", "unknown"]>>;
+    recipientVerified: z.ZodOptional<z.ZodBoolean>;
+    spenderVerified: z.ZodOptional<z.ZodBoolean>;
+    requiresSigner: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    environment: string;
+    actionType: "send_payment" | "approve_token" | "execute_swap" | "x402_pay_and_fetch" | "publish_risk_score" | "custom_contract_call";
+    chainId: number;
+    isMainnet: boolean;
+    paymentTokenAddress: string;
+    spender?: string | undefined;
+    amount?: string | undefined;
+    token?: string | undefined;
+    tokenAddress?: string | undefined;
+    amountUnit?: "PHRS" | "USDC" | "USD" | "TOKEN" | undefined;
+    tokenIn?: string | undefined;
+    tokenOut?: string | undefined;
+    recipient?: string | undefined;
+    approvalAmount?: string | undefined;
+    approvalToken?: string | undefined;
+    approvalUnlimited?: boolean | undefined;
+    url?: string | undefined;
+    paymentAmountUsdc?: string | undefined;
+    signerAvailable?: boolean | undefined;
+    tokenSecurityStatus?: "unknown" | "ok" | "unavailable" | undefined;
+    recipientVerified?: boolean | undefined;
+    spenderVerified?: boolean | undefined;
+    requiresSigner?: boolean | undefined;
+}, {
+    actionType: "send_payment" | "approve_token" | "execute_swap" | "x402_pay_and_fetch" | "publish_risk_score" | "custom_contract_call";
+    spender?: string | undefined;
+    amount?: string | undefined;
+    environment?: string | undefined;
+    token?: string | undefined;
+    tokenAddress?: string | undefined;
+    chainId?: number | undefined;
+    isMainnet?: boolean | undefined;
+    amountUnit?: "PHRS" | "USDC" | "USD" | "TOKEN" | undefined;
+    tokenIn?: string | undefined;
+    tokenOut?: string | undefined;
+    recipient?: string | undefined;
+    approvalAmount?: string | undefined;
+    approvalToken?: string | undefined;
+    approvalUnlimited?: boolean | undefined;
+    url?: string | undefined;
+    paymentAmountUsdc?: string | undefined;
+    paymentTokenAddress?: string | undefined;
+    signerAvailable?: boolean | undefined;
+    tokenSecurityStatus?: "unknown" | "ok" | "unavailable" | undefined;
+    recipientVerified?: boolean | undefined;
+    spenderVerified?: boolean | undefined;
+    requiresSigner?: boolean | undefined;
+}>;
+export type SafeHandsPreflightCheckInput = z.input<typeof safehandsPreflightCheckSchema>;
+export declare function handleSafeHandsPreflightCheck(raw: SafeHandsPreflightCheckInput): Promise<ToolResponse<unknown>>;
 //# sourceMappingURL=safehandsPreflightCheck.d.ts.map