safehands-pharos 1.5.0 → 2.6.0

package/dist/tools/getTokenPrice.js.map

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

package/dist/tools/getTransactionStatus.d.ts

@@ -18,7 +18,7 @@ export declare const getTransactionStatusTool: {
         txHash: string;
     }>;
 };
-export declare function handleGetTransactionStatus(raw: GetTransactionStatusInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
+export declare function handleGetTransactionStatus(raw: GetTransactionStatusInput): Promise<import("../sdk.js").ToolFailure | import("../sdk.js").ToolSuccess<{
     txStatus: string;
     txHash: string;
     blockNumber: string;
@@ -29,7 +29,7 @@ export declare function handleGetTransactionStatus(raw: GetTransactionStatusInpu
     effectiveGasPrice: string;
     value: string;
     explorerUrl: string;
-}> | import("../lib/toolResponse.js").ToolSuccess<{
+}> | import("../sdk.js").ToolSuccess<{
     txHash: string;
     txStatus: "pending";
     blockNumber: null;

package/dist/tools/getWalletBalance.d.ts

@@ -18,10 +18,11 @@ export declare const getWalletBalanceTool: {
         walletAddress: string;
     }>;
 };
-export declare function handleGetWalletBalance(raw: GetWalletBalanceInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
+type PriceLegStatus = "ok" | "rpc_degraded_cache" | "unavailable" | "not_needed";
+export declare function handleGetWalletBalance(raw: GetWalletBalanceInput): Promise<import("../sdk.js").ToolFailure | import("../sdk.js").ToolSuccess<{
     walletAddress: `0x${string}`;
     balances: {
-        PHRS: {
+        PROS: {
             balance: {
                 value: string;
                 unit: string;
@@ -30,6 +31,7 @@ export declare function handleGetWalletBalance(raw: GetWalletBalanceInput): Prom
                 value: string;
                 unit: string;
             };
+            priceStatus: PriceLegStatus;
         };
         USDC: {
             balance: {
@@ -40,6 +42,19 @@ export declare function handleGetWalletBalance(raw: GetWalletBalanceInput): Prom
                 value: string;
                 unit: string;
             };
+            priceStatus: PriceLegStatus;
+            tokenAddress: `0x${string}`;
+            decimals: number;
+            supported?: undefined;
+            reason?: undefined;
+        } | {
+            supported: boolean;
+            reason: string;
+            balance?: undefined;
+            valueUsd?: undefined;
+            priceStatus?: undefined;
+            tokenAddress?: undefined;
+            decimals?: undefined;
         };
         USDT: {
             balance: {
@@ -50,20 +65,40 @@ export declare function handleGetWalletBalance(raw: GetWalletBalanceInput): Prom
                 value: string;
                 unit: string;
             };
+            priceStatus: PriceLegStatus;
+            tokenAddress: `0x${string}`;
+            decimals: number;
+            supported?: undefined;
+            reason?: undefined;
+        } | {
+            supported: boolean;
+            reason: string;
+            balance?: undefined;
+            valueUsd?: undefined;
+            priceStatus?: undefined;
+            tokenAddress?: undefined;
+            decimals?: undefined;
         };
     };
     totalUsd: {
         value: string;
         unit: string;
     };
-    phrsPrice: {
+    prosPrice: {
         value: string;
         unit: string;
     } | null;
     priceSourceStatus: string;
+    priceDetail: {
+        PROS: PriceLegStatus;
+        USDC: PriceLegStatus;
+        USDT: PriceLegStatus;
+    };
+    priceSource: string;
     chainId: number;
     environment: string;
     isMainnet: boolean;
     source: string;
 }>>;
+export {};
 //# sourceMappingURL=getWalletBalance.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getWalletBalance.d.ts","sourceRoot":"","sources":["../../src/tools/getWalletBalance.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,sBAAsB;;;;;;EAEjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,eAAO,MAAM,oBAAoB;;;;;;;;;;CAKhC,CAAC;AAIF,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsEtE"}
+{"version":3,"file":"getWalletBalance.d.ts","sourceRoot":"","sources":["../../src/tools/getWalletBalance.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,sBAAsB;;;;;;EAEjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,eAAO,MAAM,oBAAoB;;;;;;;;;;CAKhC,CAAC;AAEF,KAAK,cAAc,GAAG,IAAI,GAAG,oBAAoB,GAAG,aAAa,GAAG,YAAY,CAAC;AA0BjF,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+FtE"}

package/dist/tools/getWalletBalance.js

@@ -1,10 +1,12 @@
 // ─── Tool: get_wallet_balance ──────────────────────────────────────────
-// Returns PHRS, USDC, USDT balances for a wallet using viem reads.
+// Returns native PROS and active-network ERC-20 balances for a wallet using
+// viem reads. USD valuation comes from the PriceResolver (Chainlink Push
+// Engine feeds); balances always succeed even when prices are unavailable.
 // ────────────────────────────────────────────────────────────────────────
 import { z } from "zod";
 import { publicClient } from "../lib/pharosClient.js";
-import { getDodoRoute } from "../lib/dodoApi.js";
-import { USDC_ADDRESS, USDT_ADDRESS, ERC20_ABI, CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
+import { ERC20_ABI, CHAIN_ID, PHAROS_ENVIRONMENT, IS_MAINNET, activeTokenMap, activeTokenDecimals } from "../lib/constants.js";
+import { resolvePriceUsd } from "../lib/price/priceResolver.js";
 import { formatEther, formatUnits, isAddress } from "viem";
 import { classifyExternalError, fail, ok } from "../lib/toolResponse.js";
 export const getWalletBalanceSchema = z.object({
@@ -12,72 +14,110 @@ export const getWalletBalanceSchema = z.object({
 });
 export const getWalletBalanceTool = {
     name: "get_wallet_balance",
-    description: "Return PHRS (native), USDC, and USDT balances for a wallet on Pharos Atlantic Testnet, with total USD estimate.",
+    description: "Return PROS and supported active-network token balances for a wallet on Pharos, with total USD estimate.",
     inputSchema: getWalletBalanceSchema,
 };
-const QUOTE_WALLET = "0x0000000000000000000000000000000000000001";
+async function priceLeg(symbol) {
+    const result = await resolvePriceUsd(symbol);
+    if (result.ok) {
+        return { status: result.resolution.sourceStatus, priceUsd: result.resolution.priceUsdNumber };
+    }
+    return { status: "unavailable", priceUsd: 0 };
+}
+async function readTokenBalance(address, tokenAddress, decimals, symbol) {
+    const raw = (await publicClient.readContract({
+        address: tokenAddress,
+        abi: ERC20_ABI,
+        functionName: "balanceOf",
+        args: [address],
+    }));
+    return {
+        symbol,
+        raw,
+        formatted: formatUnits(raw, decimals),
+        decimals,
+        tokenAddress,
+    };
+}
 export async function handleGetWalletBalance(raw) {
     const input = getWalletBalanceSchema.parse(raw);
     if (!isAddress(input.walletAddress)) {
         return fail("INVALID_WALLET_ADDRESS", `Invalid wallet address: ${input.walletAddress}`, false, "get_wallet_balance");
     }
     const addr = input.walletAddress;
+    const tokenMap = activeTokenMap();
+    const decimalsMap = activeTokenDecimals();
     try {
-        const [phrsBalanceWei, usdcBalanceRaw, usdtBalanceRaw] = await Promise.all([
-            publicClient.getBalance({ address: addr }),
-            publicClient.readContract({
-                address: USDC_ADDRESS,
-                abi: ERC20_ABI,
-                functionName: "balanceOf",
-                args: [addr],
-            }),
-            publicClient.readContract({
-                address: USDT_ADDRESS,
-                abi: ERC20_ABI,
-                functionName: "balanceOf",
-                args: [addr],
-            }),
-        ]);
-        const phrsBalance = formatEther(phrsBalanceWei);
-        const usdcBalance = formatUnits(usdcBalanceRaw, 6);
-        const usdtBalance = formatUnits(usdtBalanceRaw, 6);
-        let phrsUsd = 0;
-        let priceSourceStatus = "unavailable";
-        try {
-            const quote = await getDodoRoute({
-                fromToken: "PHRS",
-                toToken: "USDC",
-                amountHuman: "1",
-                walletAddress: QUOTE_WALLET,
-            });
-            if (quote.routeAvailable) {
-                phrsUsd = parseFloat(quote.amountOut);
-                priceSourceStatus = "ok";
-            }
-            else {
-                priceSourceStatus = "no_route_available";
-            }
-        }
-        catch {
-            priceSourceStatus = "unavailable";
-        }
-        const phrsValueUsd = parseFloat(phrsBalance) * phrsUsd;
-        const usdcValueUsd = parseFloat(usdcBalance);
-        const usdtValueUsd = parseFloat(usdtBalance);
-        const totalUsd = (phrsValueUsd + usdcValueUsd + usdtValueUsd).toFixed(4);
+        const prosBalanceWei = await publicClient.getBalance({ address: addr });
+        const prosBalance = formatEther(prosBalanceWei);
+        const supportedTokenReads = await Promise.all(["USDC", "USDT"].map(async (symbol) => {
+            const tokenAddress = tokenMap[symbol];
+            if (!tokenAddress)
+                return { symbol, unsupported: true };
+            return readTokenBalance(addr, tokenAddress, decimalsMap[symbol] ?? decimalsMap[tokenAddress.toLowerCase()] ?? 18, symbol);
+        }));
+        const usdcResult = supportedTokenReads.find((r) => r.symbol === "USDC");
+        const usdtResult = supportedTokenReads.find((r) => r.symbol === "USDT");
+        const usdcBalance = usdcResult && "formatted" in usdcResult ? usdcResult.formatted : "0";
+        const usdtBalance = usdtResult && "formatted" in usdtResult ? usdtResult.formatted : "0";
+        // Price legs run SEQUENTIALLY (never Promise.all — public RPC rate-limits
+        // parallel eth_call bursts) and only for assets that are actually held.
+        // PROS is always priced because prosPrice is a top-level response field.
+        const prosLeg = await priceLeg("PROS");
+        const usdcLeg = usdcResult && "formatted" in usdcResult && parseFloat(usdcBalance) > 0
+            ? await priceLeg("USDC")
+            : { status: "not_needed", priceUsd: 0 };
+        const usdtLeg = usdtResult && "formatted" in usdtResult && parseFloat(usdtBalance) > 0
+            ? await priceLeg("USDT")
+            : { status: "not_needed", priceUsd: 0 };
+        const prosValueUsd = parseFloat(prosBalance) * prosLeg.priceUsd;
+        const usdcValueUsd = parseFloat(usdcBalance) * usdcLeg.priceUsd;
+        const usdtValueUsd = parseFloat(usdtBalance) * usdtLeg.priceUsd;
+        const totalUsd = (prosValueUsd + usdcValueUsd + usdtValueUsd).toFixed(4);
+        const attempted = [prosLeg, usdcLeg, usdtLeg].filter((leg) => leg.status !== "not_needed");
+        const failedCount = attempted.filter((leg) => leg.status === "unavailable").length;
+        const priceSourceStatus = failedCount === attempted.length
+            ? "unavailable"
+            : failedCount > 0
+                ? "partial"
+                : attempted.some((leg) => leg.status === "rpc_degraded_cache")
+                    ? "rpc_degraded_cache"
+                    : "ok";
         return ok({
             walletAddress: input.walletAddress,
             balances: {
-                PHRS: { balance: { value: phrsBalance, unit: "PHRS" }, valueUsd: { value: phrsValueUsd.toFixed(4), unit: "USD" } },
-                USDC: { balance: { value: usdcBalance, unit: "USDC" }, valueUsd: { value: usdcValueUsd.toFixed(4), unit: "USD" } },
-                USDT: { balance: { value: usdtBalance, unit: "USDT" }, valueUsd: { value: usdtValueUsd.toFixed(4), unit: "USD" } },
+                PROS: {
+                    balance: { value: prosBalance, unit: "PROS" },
+                    valueUsd: { value: prosValueUsd.toFixed(4), unit: "USD" },
+                    priceStatus: prosLeg.status,
+                },
+                USDC: usdcResult && "formatted" in usdcResult
+                    ? {
+                        balance: { value: usdcBalance, unit: "USDC" },
+                        valueUsd: { value: usdcValueUsd.toFixed(4), unit: "USD" },
+                        priceStatus: usdcLeg.status,
+                        tokenAddress: usdcResult.tokenAddress,
+                        decimals: usdcResult.decimals,
+                    }
+                    : { supported: false, reason: `USDC is not configured for ${PHAROS_ENVIRONMENT} (${CHAIN_ID}).` },
+                USDT: usdtResult && "formatted" in usdtResult
+                    ? {
+                        balance: { value: usdtBalance, unit: "USDT" },
+                        valueUsd: { value: usdtValueUsd.toFixed(4), unit: "USD" },
+                        priceStatus: usdtLeg.status,
+                        tokenAddress: usdtResult.tokenAddress,
+                        decimals: usdtResult.decimals,
+                    }
+                    : { supported: false, reason: `USDT is not configured for ${PHAROS_ENVIRONMENT} (${CHAIN_ID}); no fallback/testnet address was queried.` },
             },
             totalUsd: { value: totalUsd, unit: "USD" },
-            phrsPrice: phrsUsd > 0 ? { value: phrsUsd.toFixed(4), unit: "USD" } : null,
+            prosPrice: prosLeg.priceUsd > 0 ? { value: prosLeg.priceUsd.toFixed(4), unit: "USD" } : null,
             priceSourceStatus,
+            priceDetail: { PROS: prosLeg.status, USDC: usdcLeg.status, USDT: usdtLeg.status },
+            priceSource: "chainlink_push_feed",
             chainId: CHAIN_ID,
             environment: PHAROS_ENVIRONMENT,
-            isMainnet: false,
+            isMainnet: IS_MAINNET,
             source: "pharos_rpc",
         });
     }

package/dist/tools/getWalletBalance.js.map

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

package/dist/tools/publishRiskScore.d.ts

@@ -6,20 +6,29 @@ export declare const publishRiskScoreSchema: z.ZodObject<{
     amount: z.ZodString;
     toAddress: z.ZodOptional<z.ZodString>;
     agentId: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
+    policyVersion: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    evidenceURI: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    expiresAt: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
     amount: string;
     action: "transfer" | "swap";
+    policyVersion: string;
+    evidenceURI: string;
+    agentId?: string | undefined;
     tokenIn?: string | undefined;
     tokenOut?: string | undefined;
-    agentId?: string | undefined;
+    expiresAt?: number | undefined;
     toAddress?: string | undefined;
 }, {
     amount: string;
     action: "transfer" | "swap";
+    agentId?: string | undefined;
     tokenIn?: string | undefined;
     tokenOut?: string | undefined;
-    agentId?: string | undefined;
+    expiresAt?: number | undefined;
     toAddress?: string | undefined;
+    policyVersion?: string | undefined;
+    evidenceURI?: string | undefined;
 }>;
 export type PublishRiskScoreInput = z.input<typeof publishRiskScoreSchema>;
 export declare const publishRiskScoreTool: {
@@ -32,32 +41,45 @@ export declare const publishRiskScoreTool: {
         amount: z.ZodString;
         toAddress: z.ZodOptional<z.ZodString>;
         agentId: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
+        policyVersion: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        evidenceURI: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        expiresAt: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
         amount: string;
         action: "transfer" | "swap";
+        policyVersion: string;
+        evidenceURI: string;
+        agentId?: string | undefined;
         tokenIn?: string | undefined;
         tokenOut?: string | undefined;
-        agentId?: string | undefined;
+        expiresAt?: number | undefined;
         toAddress?: string | undefined;
     }, {
         amount: string;
         action: "transfer" | "swap";
+        agentId?: string | undefined;
         tokenIn?: string | undefined;
         tokenOut?: string | undefined;
-        agentId?: string | undefined;
+        expiresAt?: number | undefined;
         toAddress?: string | undefined;
+        policyVersion?: string | undefined;
+        evidenceURI?: string | undefined;
     }>;
 };
-export declare function handlePublishRiskScore(raw: PublishRiskScoreInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
-    assessment: import("../lib/riskEngine.js").RiskAssessment;
-    policy: import("../lib/policy/actionPolicyEngine.js").ActionPolicyResult;
+export declare function handlePublishRiskScore(raw: PublishRiskScoreInput): Promise<import("../sdk.js").ToolFailure | import("../sdk.js").ToolSuccess<{
+    assessment: import("../sdk.js").RiskAssessment;
+    policy: import("../sdk.js").ActionPolicyResult;
     signerMode: import("../lib/signer/index.js").SignerMode;
+    riskRegistry: {
+        version: string;
+        address: `0x${string}`;
+        actionHash: `0x${string}`;
+        policyVersion: string;
+        expiresAt: string;
+    };
     onChain: {
-        txHash: `0x${string}`;
-        explorerUrl: string;
-        contractAddress: `0x${string}`;
-        gasUsed: string;
-        blockNumber: string;
+        status: string;
+        note: string;
     };
     source: string;
 }>>;

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

@@ -1 +1 @@
-{"version":3,"file":"publishRiskScore.d.ts","sourceRoot":"","sources":["../../src/tools/publishRiskScore.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;EAOjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;CAMhC,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,qBAAqB;;;;;;;;;;;;IAgFtE"}
+{"version":3,"file":"publishRiskScore.d.ts","sourceRoot":"","sources":["../../src/tools/publishRiskScore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqBxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUxB,CAAC;AAEZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMhC,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,qBAAqB;;;;;;;;;;;;;;;;IAiItE"}

package/dist/tools/publishRiskScore.js

@@ -1,41 +1,80 @@
-// ─── 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 { isAddress, keccak256, stringToHex } from "viem";
+import { SAFEHANDS_REGISTRY_ADDRESS, CHAIN_ID, PHAROS_ENVIRONMENT, REQUIRE_AUTHORIZED_AGENT_FOR_WRITE, } from "../lib/constants.js";
+import { IS_MAINNET } 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";
+import { validatePositiveAmount } from "../lib/validation.js";
+import { deriveActionHash, checkManagedWalletAuthorization, riskLevelToEnum, recommendationToEnum } from "../lib/safeHandsRegistry.js";
+import { queueRiskRecord } from "../lib/merkleBatcher.js";
+import { createRequire } from "module";
+// Default policyVersion follows the package version (same pattern as index.ts),
+// so on-chain risk records never carry a stale hardcoded version label.
+const PKG_VERSION = createRequire(import.meta.url)("../../package.json").version;
 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"),
-});
+    agentId: z.string().optional().describe("Managed wallet agentId when WALLET_MODE=managed-mainnet"),
+    policyVersion: z.string().optional().default(PKG_VERSION),
+    evidenceURI: z.string().optional().default(""),
+    expiresAt: z.number().int().nonnegative().optional(),
+}).strict();
 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.",
+    description: "Run a risk assessment and publish the result to the on-chain SafeHandsRegistry. " +
+        "Other agents can then query this target's risk record + 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");
+        return fail("WRITE_TOOLS_DISABLED", "publish_risk_score is disabled by default. Set WRITE_TOOLS_ENABLED=true only for trusted execution.", false, "publish_risk_score");
+    }
+    let input;
+    try {
+        input = publishRiskScoreSchema.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", `publish_risk_score input validation failed: ${msg}`, false, "publish_risk_score");
+    }
+    const amtErr = validatePositiveAmount(input.amount, "amount");
+    if (amtErr)
+        return fail("VALIDATION_ERROR", amtErr, false, "publish_risk_score");
+    if (input.action === "swap" && (!input.tokenIn || !input.tokenOut)) {
+        return fail("VALIDATION_ERROR", "Swap action requires both tokenIn and tokenOut.", false, "publish_risk_score");
+    }
+    if (input.action === "transfer" && !input.toAddress) {
+        return fail("VALIDATION_ERROR", "Transfer action requires toAddress.", false, "publish_risk_score");
+    }
+    if (!input.policyVersion) {
+        return fail("VALIDATION_ERROR", "policyVersion is required.", false, "publish_risk_score");
+    }
+    if (!SAFEHANDS_REGISTRY_ADDRESS || !isAddress(SAFEHANDS_REGISTRY_ADDRESS)) {
+        return fail("REGISTRY_NOT_CONFIGURED", "SafeHandsRegistry is not deployed/configured. Set SAFEHANDS_REGISTRY_ADDRESS after deploying the contract.", 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");
     }
+    if (signer.mode === "managed-mainnet" && REQUIRE_AUTHORIZED_AGENT_FOR_WRITE) {
+        const authCheck = await checkManagedWalletAuthorization(signer.address);
+        if (!authCheck.authorized) {
+            return fail(authCheck.errorCode || "AGENT_WALLET_NOT_AUTHORIZED", authCheck.errorMessage || "Managed wallet is not authorized in SafeHandsRegistry.", false, "publish_risk_score");
+        }
+    }
     const policy = evaluateActionPolicy({
         actionType: "publish_risk_score",
+        agentId: input.agentId,
         chainId: CHAIN_ID,
         environment: PHAROS_ENVIRONMENT,
-        isMainnet: false,
+        isMainnet: IS_MAINNET,
         signerAvailable: true,
         requiresSigner: true,
     });
@@ -51,33 +90,42 @@ export async function handlePublishRiskScore(raw) {
         toAddress: input.toAddress,
         walletAddress,
     });
+    if (assessment.riskScore < 0 || assessment.riskScore > 100) {
+        return fail("VALIDATION_ERROR", `Risk score ${assessment.riskScore} is out of valid range 0-100.`, false, "publish_risk_score");
+    }
+    const actionHash = deriveActionHash(CHAIN_ID, input.action, walletAddress, {
+        tokenIn: input.tokenIn,
+        tokenOut: input.tokenOut,
+        amount: input.amount,
+        toAddress: input.toAddress,
+    });
+    const registryAddress = SAFEHANDS_REGISTRY_ADDRESS;
+    const resolvedExpiresAt = input.expiresAt ?? Math.floor(Date.now() / 1000) + 30 * 24 * 60 * 60;
     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,
-            ],
+        queueRiskRecord({
+            target: walletAddress,
+            actionHash: actionHash,
+            score: assessment.riskScore,
+            level: riskLevelToEnum(assessment.riskLevel),
+            recommendation: recommendationToEnum(assessment.recommendation),
+            policyVersionHash: keccak256(stringToHex(input.policyVersion)),
+            evidenceHash: keccak256(stringToHex(input.evidenceURI || "none")),
+            expiresAt: BigInt(resolvedExpiresAt),
         });
-        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,
+            riskRegistry: {
+                version: "safehands-registry",
+                address: registryAddress,
+                actionHash,
+                policyVersion: input.policyVersion,
+                expiresAt: String(resolvedExpiresAt),
+            },
             onChain: {
-                txHash,
-                explorerUrl: getExplorerUrl(txHash),
-                contractAddress: RISK_REGISTRY_ADDRESS,
-                gasUsed: receipt.gasUsed.toString(),
-                blockNumber: receipt.blockNumber.toString(),
+                status: "L2_BATCH_QUEUED",
+                note: "Risk record queued for next L2 Merkle Batching cycle to save gas.",
             },
             source: "publish_risk_score",
         });