@bananapus/nana-sdk-core 3.5.1 → 4.0.0

package/dist/cjs/review/simulation.js

@@ -1,9 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TRANSACTION_SIMULATION_MAX_RETURN_BYTES = exports.TRANSACTION_SIMULATION_GAS = void 0;
+exports.SIMULATION_NO_ANSWER_LINE = exports.REVERT_UNKNOWN_LINE = exports.TRANSACTION_SIMULATION_MAX_RETURN_BYTES = exports.TRANSACTION_SIMULATION_GAS = void 0;
 exports.simulateStateChangingTransaction = simulateStateChangingTransaction;
+exports.revertReason = revertReason;
+exports.revertDetail = revertDetail;
+exports.isRevert = isRevert;
+exports.simulationFailure = simulationFailure;
 exports.simulateCallSequence = simulateCallSequence;
 const viem_1 = require("viem");
+const executionErrors_js_1 = require("../v6/executionErrors.js");
+const lineError_js_1 = require("./lineError.js");
 /** A generous explicit gas ceiling for a reviewed state-changing preflight. */
 exports.TRANSACTION_SIMULATION_GAS = 10000000n;
 /** The most return data a preflight hands back to a caller that decodes it. */
@@ -18,45 +24,99 @@ exports.TRANSACTION_SIMULATION_MAX_RETURN_BYTES = 4_096;
  * `blockNumber` to simulate on the block a prerequisite (an approval, say) was
  * mined in, instead of `latest` on a node that may lag behind it.
  */
-async function simulateStateChangingTransaction(client, { from, to, data, value = 0n, gas = exports.TRANSACTION_SIMULATION_GAS, blockNumber, maxReturnBytes = exports.TRANSACTION_SIMULATION_MAX_RETURN_BYTES, }) {
+async function simulateStateChangingTransaction(client, { from, to, data, value = 0n, gas = exports.TRANSACTION_SIMULATION_GAS, blockNumber, maxReturnBytes = exports.TRANSACTION_SIMULATION_MAX_RETURN_BYTES, balance, }) {
     if (gas <= 0n) {
-        throw new Error("Transaction simulation gas must be positive.");
+        throw new lineError_js_1.ReviewLineError("Transaction simulation gas must be positive.");
     }
     if (!Number.isSafeInteger(maxReturnBytes) || maxReturnBytes < 0) {
-        throw new Error("Transaction simulation needs a return data limit.");
+        throw new lineError_js_1.ReviewLineError("Transaction simulation needs a return data limit.");
     }
     // A raw request bypasses call()/simulateContract(), whose behavior can
     // inherit a client-level CCIP-read policy.
+    const call = {
+        from,
+        to,
+        data,
+        value: (0, viem_1.numberToHex)(value),
+        gas: (0, viem_1.numberToHex)(gas),
+    };
+    const block = blockNumber === undefined ? "latest" : (0, viem_1.numberToHex)(blockNumber);
     const result = await client.request({
         method: "eth_call",
-        params: [
-            {
-                from,
-                to,
-                data,
-                value: (0, viem_1.numberToHex)(value),
-                gas: (0, viem_1.numberToHex)(gas),
-            },
-            blockNumber === undefined ? "latest" : (0, viem_1.numberToHex)(blockNumber),
-        ],
+        params: balance === undefined
+            ? [call, block]
+            : [call, block, { [from]: { balance: (0, viem_1.numberToHex)(balance) } }],
     });
     if (typeof result !== "string" || !/^0x(?:[0-9a-f]{2})*$/iu.test(result)) {
-        throw new Error("Transaction simulation returned malformed data.");
+        throw new lineError_js_1.ReviewLineError("Transaction simulation returned malformed data.");
     }
     if ((result.length - 2) / 2 > maxReturnBytes) {
-        throw new Error("Transaction simulation returned too much data.");
+        throw new lineError_js_1.ReviewLineError("Transaction simulation returned too much data.");
     }
     return result;
 }
+/** The line for a revert whose reason the SDK does not know. */
+exports.REVERT_UNKNOWN_LINE = "This transaction would fail. Check the amounts and try again.";
+/** The line for a simulation the node did not answer. */
+exports.SIMULATION_NO_ANSWER_LINE = "The node did not answer the simulation.";
+/**
+ * Why a call reverted, when the SDK knows the revert: a payment revert's
+ * plain line ({@link decodePayFailure}). Null otherwise. Error text (viem's
+ * `shortMessage`, a node's message) is never read: it can quote a request or
+ * its URL.
+ */
+function revertReason(error) {
+    return (0, executionErrors_js_1.decodePayFailure)(error)?.message ?? null;
+}
+/**
+ * A failed simulation's one-line reason: {@link revertReason}, or a fixed
+ * line, {@link REVERT_UNKNOWN_LINE} for a revert and
+ * {@link SIMULATION_NO_ANSWER_LINE} otherwise. Never the error's own text.
+ */
 function revertDetail(error) {
-    if (error instanceof Error &&
-        "shortMessage" in error &&
-        typeof error.shortMessage === "string") {
-        return error.shortMessage;
+    return (revertReason(error) ??
+        (isRevert(error) ? exports.REVERT_UNKNOWN_LINE : exports.SIMULATION_NO_ANSWER_LINE));
+}
+/**
+ * Whether a failed simulation is the call reverting, not the node failing:
+ * EIP-1474 code 3, viem's contract-revert errors, or the node's own text
+ * saying it reverted, in the error's first eight causes. A viem error is read
+ * by its `details`, since its `message` quotes the request.
+ */
+function isRevert(error) {
+    let current = error;
+    for (let depth = 0; depth < 8 && current && typeof current === "object"; depth += 1) {
+        const item = current;
+        if (item.code === 3 ||
+            item.name === "ContractFunctionRevertedError" ||
+            item.name === "RawContractError" ||
+            item.name === "ExecutionRevertedError" ||
+            // A failed call that returned no revert data.
+            item.name === "ContractFunctionZeroDataError" ||
+            item.name === "AbiDecodingZeroDataError") {
+            return true;
+        }
+        // A wrapper that carries its cause (simulateCallSequence's, which names
+        // the call) is read through that cause, never by its own text.
+        const text = typeof item.details === "string"
+            ? item.details
+            : typeof item.shortMessage === "string" || "cause" in item
+                ? undefined
+                : item.message;
+        if (typeof text === "string" && /revert/i.test(text))
+            return true;
+        current = item.cause;
     }
-    return error instanceof Error
-        ? error.message.split("\n")[0]
-        : "The call would revert.";
+    return false;
+}
+/**
+ * The error a failed simulation throws, with the answer as its cause: the
+ * SDK's own line (a {@link ReviewLineError}) for a revert, decoded or not; a
+ * plain error, which `errorLine` shows as the network line, for a node that
+ * did not answer.
+ */
+function simulationFailure(text, cause) {
+    return Object.defineProperty(isRevert(cause) ? new lineError_js_1.ReviewLineError(text) : new Error(text), "cause", { value: cause, configurable: true, writable: true });
 }
 /** Node text saying the method itself is missing: "method not found", "Unsupported method: eth_simulateV1". */
 function namesMissingMethod(text) {
@@ -98,12 +158,20 @@ function simulationUnsupported(error) {
  * {@link simulateStateChangingTransaction}; the dependent ones are left to the
  * executing wallet's own simulation. `chainName` names the chain in errors.
  */
-async function simulateCallSequence(client, { from, calls, chainName, }) {
+async function simulateCallSequence(client, { from, calls, chainName, balance, }) {
     let sequence;
     try {
         const simulated = await client.simulateCalls({
             account: from,
-            calls: calls.map(({ to, data, value }) => ({ to, data, value })),
+            calls: calls.map(({ to, data, value, gas }) => ({
+                to,
+                data,
+                value,
+                ...(gas === undefined ? {} : { gas }),
+            })),
+            ...(balance === undefined
+                ? {}
+                : { stateOverrides: [{ address: from, balance }] }),
         });
         sequence = simulated.results.map((result) => result.status === "failure"
             ? { status: "failure", error: result.error }
@@ -111,7 +179,7 @@ async function simulateCallSequence(client, { from, calls, chainName, }) {
     }
     catch (error) {
         if (!simulationUnsupported(error)) {
-            throw new Error(`The batch could not be simulated on ${chainName}: ${revertDetail(error)}`);
+            throw simulationFailure(`The batch could not be simulated on ${chainName}: ${revertDetail(error)}`, error);
         }
         sequence = null;
     }
@@ -120,9 +188,9 @@ async function simulateCallSequence(client, { from, calls, chainName, }) {
             const result = sequence[index];
             if (result?.status === "success")
                 continue;
-            throw new Error(`${call.label} cannot run on ${chainName}: ${result?.status === "failure"
+            throw simulationFailure(`${call.label} cannot run on ${chainName}: ${result?.status === "failure"
                 ? revertDetail(result.error)
-                : "The call would revert."}`);
+                : exports.SIMULATION_NO_ANSWER_LINE}`, result?.error);
         }
         if (call.dependsOnPrior)
             continue;
@@ -132,10 +200,12 @@ async function simulateCallSequence(client, { from, calls, chainName, }) {
                 to: call.to,
                 data: call.data,
                 value: call.value,
+                gas: call.gas,
+                ...(balance === undefined || !call.funded ? {} : { balance }),
             });
         }
         catch (error) {
-            throw new Error(`${call.label} cannot run on ${chainName}: ${revertDetail(error)}`);
+            throw simulationFailure(`${call.label} cannot run on ${chainName}: ${revertDetail(error)}`, error);
         }
     }
 }

package/dist/cjs/review/simulation.js.map

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

package/dist/cjs/review/transaction-message.d.ts

@@ -1,3 +1,16 @@
+import { ReviewLineError } from "./lineError.js";
+export { ReviewLineError };
 /** Presentation only: saved recovery evidence and original SDK errors stay unchanged. */
 export declare function transactionMessage(message: string): string;
+/** The line for a raw node, RPC or wallet error: its own text can quote a request or its URL. */
+export declare const NETWORK_ERROR_LINE = "The network returned an error. Check your wallet's activity, then try again.";
+/**
+ * The line to show for a thrown value: the message of a
+ * {@link ReviewLineError} (the SDK's, or a site's own refusal), presented by
+ * {@link transactionMessage}; the fixed line an SDK error class carries (its
+ * Relayr and Safe refusals, whose text can quote a service); or
+ * {@link NETWORK_ERROR_LINE} for anything else (a node, RPC, wallet, service
+ * or runtime error, or an app's plain Error). The raw error stays the cause.
+ */
+export declare function errorLine(error: unknown): string;
 //# sourceMappingURL=transaction-message.d.ts.map

package/dist/cjs/review/transaction-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-message.d.ts","sourceRoot":"","sources":["../../../src/review/transaction-message.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsB1D"}
+{"version":3,"file":"transaction-message.d.ts","sourceRoot":"","sources":["../../../src/review/transaction-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsB1D;AAED,iGAAiG;AACjG,eAAO,MAAM,kBAAkB,iFACiD,CAAC;AAEjF;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWhD"}

package/dist/cjs/review/transaction-message.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.NETWORK_ERROR_LINE = exports.ReviewLineError = void 0;
 exports.transactionMessage = transactionMessage;
+exports.errorLine = errorLine;
+const lineError_js_1 = require("./lineError.js");
+Object.defineProperty(exports, "ReviewLineError", { enumerable: true, get: function () { return lineError_js_1.ReviewLineError; } });
 /** Presentation only: saved recovery evidence and original SDK errors stay unchanged. */
 function transactionMessage(message) {
     const formatted = message
@@ -16,4 +20,25 @@ function transactionMessage(message) {
         ? message
         : formatted.replace(/^([a-z])/, (letter) => letter.toUpperCase());
 }
+/** The line for a raw node, RPC or wallet error: its own text can quote a request or its URL. */
+exports.NETWORK_ERROR_LINE = "The network returned an error. Check your wallet's activity, then try again.";
+/**
+ * The line to show for a thrown value: the message of a
+ * {@link ReviewLineError} (the SDK's, or a site's own refusal), presented by
+ * {@link transactionMessage}; the fixed line an SDK error class carries (its
+ * Relayr and Safe refusals, whose text can quote a service); or
+ * {@link NETWORK_ERROR_LINE} for anything else (a node, RPC, wallet, service
+ * or runtime error, or an app's plain Error). The raw error stays the cause.
+ */
+function errorLine(error) {
+    if (error instanceof lineError_js_1.ReviewLineError)
+        return transactionMessage(error.message);
+    // Marked by its class, never by its own fields, so a plain error cannot pose as one.
+    const fixed = error instanceof lineError_js_1.ReviewFixedLineError ||
+        (error instanceof Error &&
+            !Object.prototype.hasOwnProperty.call(error, "reviewFixedLine") &&
+            error.reviewFixedLine === true);
+    const line = fixed ? error.line : undefined;
+    return typeof line === "string" ? line : exports.NETWORK_ERROR_LINE;
+}
 //# sourceMappingURL=transaction-message.js.map

package/dist/cjs/review/transaction-message.js.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-message.js","sourceRoot":"","sources":["../../../src/review/transaction-message.ts"],"names":[],"mappings":";;AACA,gDAsBC;AAvBD,yFAAyF;AACzF,SAAgB,kBAAkB,CAAC,OAAe;IAChD,MAAM,SAAS,GAAG,OAAO;SACtB,OAAO,CACN,6EAA6E,EAC7E,+BAA+B,CAChC;SACA,OAAO,CACN,2BAA2B,EAC3B,wCAAwC,CACzC;SACA,OAAO,CAAC,yBAAyB,EAAE,sCAAsC,CAAC;SAC1E,OAAO,CAAC,uBAAuB,EAAE,UAAU,CAAC;SAC5C,OAAO,CAAC,4BAA4B,EAAE,KAAK,CAAC;SAC5C,OAAO,CACN,0NAA0N,EAC1N,EAAE,CACH;SACA,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC;SACrC,OAAO,CAAC,mCAAmC,EAAE,aAAa,CAAC,CAAC;IAC/D,OAAO,SAAS,KAAK,OAAO;QAC1B,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;AACtE,CAAC"}
+{"version":3,"file":"transaction-message.js","sourceRoot":"","sources":["../../../src/review/transaction-message.ts"],"names":[],"mappings":";;;AAKA,gDAsBC;AAcD,8BAWC;AApDD,iDAAuE;AAE9D,gGAFsB,8BAAe,OAEtB;AAExB,yFAAyF;AACzF,SAAgB,kBAAkB,CAAC,OAAe;IAChD,MAAM,SAAS,GAAG,OAAO;SACtB,OAAO,CACN,6EAA6E,EAC7E,+BAA+B,CAChC;SACA,OAAO,CACN,2BAA2B,EAC3B,wCAAwC,CACzC;SACA,OAAO,CAAC,yBAAyB,EAAE,sCAAsC,CAAC;SAC1E,OAAO,CAAC,uBAAuB,EAAE,UAAU,CAAC;SAC5C,OAAO,CAAC,4BAA4B,EAAE,KAAK,CAAC;SAC5C,OAAO,CACN,0NAA0N,EAC1N,EAAE,CACH;SACA,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC;SACrC,OAAO,CAAC,mCAAmC,EAAE,aAAa,CAAC,CAAC;IAC/D,OAAO,SAAS,KAAK,OAAO;QAC1B,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,iGAAiG;AACpF,QAAA,kBAAkB,GAC7B,8EAA8E,CAAC;AAEjF;;;;;;;GAOG;AACH,SAAgB,SAAS,CAAC,KAAc;IACtC,IAAI,KAAK,YAAY,8BAAe;QAClC,OAAO,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3C,qFAAqF;IACrF,MAAM,KAAK,GACT,KAAK,YAAY,mCAAoB;QACrC,CAAC,KAAK,YAAY,KAAK;YACrB,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,iBAAiB,CAAC;YAC9D,KAAuC,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC;IACvE,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,KAA4B,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,0BAAkB,CAAC;AAC9D,CAAC"}

package/dist/cjs/review/transactionReview.d.ts

@@ -1,6 +1,8 @@
 import { type Abi, type Address, type Hex } from "viem";
+import type { PrettyStep } from "./decode.js";
+import type { ReviewContextRow, ReviewModel } from "./model.js";
 export type { FundingChainOption } from "./reviewQueue.js";
-export { registerFundingChainSelectionHandler, registerTransactionReviewHandler, requireFundingChainSelection, requireTransactionReview, TransactionReviewCancelledError, } from "./reviewQueue.js";
+export { registerFundingChainSelectionHandler, requireFundingChainSelection, TransactionReviewCancelledError, } from "./reviewQueue.js";
 /**
  * How review prompts name a chain and link its explorer. Apps pass their own
  * chain display, which also keeps a chain table out of the review bundle.
@@ -28,9 +30,29 @@ export type TransactionReviewCall = {
     contractName?: string;
     /** The calls a batching destination (MultiSend) makes in order, decoded by the caller. */
     calls?: readonly TransactionReviewCall[];
+    /** For a Safe proposal: the arg indexes a queued proposal it adopts may differ in. */
+    adoptIgnoringArgs?: readonly number[];
+};
+/**
+ * A signature the action asks for: the exact typed data or text the wallet
+ * signs, and what it lets run.
+ */
+export type TransactionReviewSignature = {
+    kind: "safe-tx" | "forward-request" | "permit2" | "message";
+    chainId: number;
+    /** The exact EIP-712 typed data, for every kind but a message. */
+    typedData?: unknown;
+    /** The exact text, for a message. */
+    message?: string;
+    /** The calls the signature lets someone run, decoded. */
+    calls?: readonly TransactionReviewCall[];
+    /** What it authorizes, in rows (Permit2's token, amount, spender and expiry). */
+    steps?: readonly PrettyStep[];
 };
 export type TransactionReviewRequest = {
     calls: readonly TransactionReviewCall[];
+    /** Signed after confirm, before the first call is sent. */
+    signatures?: readonly TransactionReviewSignature[];
     title?: string;
     description?: string;
     confirmLabel?: string;
@@ -38,26 +60,11 @@ export type TransactionReviewRequest = {
     kind?: "transaction" | "authorization";
     /** Exact typed data committed by a Safe/relayer signature, when applicable. */
     authorization?: unknown;
-};
-export type ContractTransactionReviewCall = {
-    chainId: number;
-    address: Address;
-    abi: Abi;
-    functionName: string;
-    args?: readonly unknown[];
-    value?: bigint;
-    gas?: bigint;
-    safeTxGas?: bigint;
-    account?: Address;
-};
-export type TransactionReviewOptions = Omit<TransactionReviewRequest, "calls"> & {
-    label?: string;
-    contractName?: string;
+    /** The site's summary rows, shown first. Display only: never part of a call. */
+    context?: readonly ReviewContextRow[];
 };
 /** "Base (~0.000123 ETH)": a chain and the relay fee quoted on it. */
 export declare function fundingChainLabel(chainName: string, amountWei: bigint): string;
-export declare function requestContractTransactionReview(call: ContractTransactionReviewCall, options?: TransactionReviewOptions): Promise<boolean>;
-export declare function requireContractTransactionReview(call: ContractTransactionReviewCall, options?: TransactionReviewOptions): Promise<void>;
 export declare function transactionReviewJson(request: TransactionReviewRequest): string;
 /**
  * The post-transaction counterpart of the review prompt: a mined tx the user
@@ -69,5 +76,6 @@ export declare function buildTransactionDebugPrompt(calls: {
     chainId: number;
     txHash: string;
 }[], { chainName: displayChainName, explorerOrigin }: TransactionReviewDisplay): string;
-export declare function buildTransactionReviewPrompt(request: TransactionReviewRequest, { explorerOrigin }: Pick<TransactionReviewDisplay, "explorerOrigin">): string;
+/** The audit prompt for a request, or for the model core built from one (its `rawJson` is the same payload). */
+export declare function buildTransactionReviewPrompt(request: TransactionReviewRequest | ReviewModel, { explorerOrigin }: Pick<TransactionReviewDisplay, "explorerOrigin">): string;
 //# sourceMappingURL=transactionReview.d.ts.map

package/dist/cjs/review/transactionReview.d.ts.map

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

package/dist/cjs/review/transactionReview.js

@@ -1,21 +1,16 @@
 "use strict";
 "use client";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TransactionReviewCancelledError = exports.requireTransactionReview = exports.requireFundingChainSelection = exports.registerTransactionReviewHandler = exports.registerFundingChainSelectionHandler = void 0;
+exports.TransactionReviewCancelledError = exports.requireFundingChainSelection = exports.registerFundingChainSelectionHandler = void 0;
 exports.fundingChainLabel = fundingChainLabel;
-exports.requestContractTransactionReview = requestContractTransactionReview;
-exports.requireContractTransactionReview = requireContractTransactionReview;
 exports.transactionReviewJson = transactionReviewJson;
 exports.buildTransactionDebugPrompt = buildTransactionDebugPrompt;
 exports.buildTransactionReviewPrompt = buildTransactionReviewPrompt;
 const viem_1 = require("viem");
-const reviewQueue_js_1 = require("./reviewQueue.js");
-var reviewQueue_js_2 = require("./reviewQueue.js");
-Object.defineProperty(exports, "registerFundingChainSelectionHandler", { enumerable: true, get: function () { return reviewQueue_js_2.registerFundingChainSelectionHandler; } });
-Object.defineProperty(exports, "registerTransactionReviewHandler", { enumerable: true, get: function () { return reviewQueue_js_2.registerTransactionReviewHandler; } });
-Object.defineProperty(exports, "requireFundingChainSelection", { enumerable: true, get: function () { return reviewQueue_js_2.requireFundingChainSelection; } });
-Object.defineProperty(exports, "requireTransactionReview", { enumerable: true, get: function () { return reviewQueue_js_2.requireTransactionReview; } });
-Object.defineProperty(exports, "TransactionReviewCancelledError", { enumerable: true, get: function () { return reviewQueue_js_2.TransactionReviewCancelledError; } });
+var reviewQueue_js_1 = require("./reviewQueue.js");
+Object.defineProperty(exports, "registerFundingChainSelectionHandler", { enumerable: true, get: function () { return reviewQueue_js_1.registerFundingChainSelectionHandler; } });
+Object.defineProperty(exports, "requireFundingChainSelection", { enumerable: true, get: function () { return reviewQueue_js_1.requireFundingChainSelection; } });
+Object.defineProperty(exports, "TransactionReviewCancelledError", { enumerable: true, get: function () { return reviewQueue_js_1.TransactionReviewCancelledError; } });
 /** "Base (~0.000123 ETH)": a chain and the relay fee quoted on it. */
 function fundingChainLabel(chainName, amountWei) {
     const exact = (0, viem_1.formatEther)(amountWei);
@@ -24,54 +19,6 @@ function fundingChainLabel(chainName, amountWei) {
     }).format(Number(exact));
     return `${chainName} (${shown === exact ? "" : "~"}${shown} ETH)`;
 }
-/** Encode once for review using the same ABI/function/args passed to wagmi. */
-function contractCallForReview(call, options = {}) {
-    const data = (0, viem_1.encodeFunctionData)({
-        abi: call.abi,
-        functionName: call.functionName,
-        args: call.args,
-    });
-    return {
-        chainId: call.chainId,
-        to: call.address,
-        data,
-        value: call.value,
-        gas: call.gas,
-        safeTxGas: call.safeTxGas,
-        from: call.account,
-        abi: call.abi,
-        functionName: call.functionName,
-        args: call.args,
-        label: options.label,
-        contractName: options.contractName,
-    };
-}
-function requestContractTransactionReview(call, options = {}) {
-    const { label, contractName, ...requestOptions } = options;
-    const reviewed = contractCallForReview(call, { label, contractName });
-    return (0, reviewQueue_js_1.requestTransactionReview)({
-        ...requestOptions,
-        calls: [reviewed],
-    }).then((approved) => {
-        if (!approved)
-            return false;
-        const current = contractCallForReview(call, { label, contractName });
-        if (current.chainId !== reviewed.chainId ||
-            current.to.toLowerCase() !== reviewed.to.toLowerCase() ||
-            (current.value ?? 0n) !== (reviewed.value ?? 0n) ||
-            current.gas !== reviewed.gas ||
-            current.safeTxGas !== reviewed.safeTxGas ||
-            current.data !== reviewed.data) {
-            throw new Error("Transaction data changed after review. Nothing was sent; review it again.");
-        }
-        return true;
-    });
-}
-async function requireContractTransactionReview(call, options = {}) {
-    if (!(await requestContractTransactionReview(call, options))) {
-        throw new reviewQueue_js_1.TransactionReviewCancelledError();
-    }
-}
 function transactionReviewJson(request) {
     const transactions = request.calls.map((call) => ({
         chainId: call.chainId,
@@ -85,10 +32,20 @@ function transactionReviewJson(request) {
         data: call.data,
     }));
     const calls = transactions.length === 1 ? transactions[0] : { transactions };
-    const payload = request.authorization
-        ? transactions.length > 0
-            ? { authorization: request.authorization, resultingCall: calls }
-            : { authorization: request.authorization }
+    const signatures = request.signatures?.map((signature) => signature.typedData === undefined
+        ? { message: signature.message }
+        : { typedData: signature.typedData });
+    const { authorization } = request;
+    const payload = signatures?.length || authorization
+        ? {
+            ...(signatures?.length ? { signatures } : {}),
+            ...(authorization ? { authorization } : {}),
+            ...(transactions.length === 0
+                ? {}
+                : signatures?.length
+                    ? { calls }
+                    : { resultingCall: calls }),
+        }
         : calls;
     return JSON.stringify(payload, (_, value) => (typeof value === "bigint" ? value.toString() : value), 2);
 }
@@ -112,13 +69,15 @@ function buildTransactionDebugPrompt(calls, { chainName: displayChainName, explo
     lines.push("", "If your agent has Etherscan's skills installed (`npx skills add etherscan/skills`), use `etherscan-transaction-debugger` in security mode on each hash. Otherwise work from the explorer page: receipt status, decoded input, event logs, and internal transactions.", "", "Verify contract source only against the Juicebox V6 repositories: https://github.com/Bananapus/version-6 (repositories ending in `-v6`; same-named repositories without that suffix are older versions).", "", "Report the decoded method and arguments, every native and token movement with its recipient, every permission, ownership, or ruleset change, and, if it reverted, the narrowest root cause the evidence supports. Mark each claim observed, derived, or inferred. Never invent a function name, amount, or revert reason. End with one line: what the transaction did in plain English, and anything that looks wrong.");
     return lines.join("\n");
 }
+/** The audit prompt for a request, or for the model core built from one (its `rawJson` is the same payload). */
 function buildTransactionReviewPrompt(request, { explorerOrigin }) {
+    const payload = "rawJson" in request ? request.rawJson : transactionReviewJson(request);
     const lines = [
         "I'm about to authorize a blockchain action in a Juicebox V6 app (the nana V6 / revnet V6 protocol release, not an older Juicebox version). Act as a careful security reviewer. Independently verify the payload against the deployed contracts and V6 source, confirm it matches my intent, and give a go/no-go. Assume the UI could be spoofed; trust the onchain call and verified V6 source over the page.",
         "",
         "Exact app-controlled transaction payload:",
         "```json",
-        transactionReviewJson(request),
+        payload,
         "```",
         "",
     ];

package/dist/cjs/review/transactionReview.js.map

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

package/dist/cjs/review/wallet.d.ts

@@ -0,0 +1,82 @@
+import type { Address, Hex, TypedDataDefinition, WalletClient } from "viem";
+/** The raw calls a self-reviewing wallet (Signa) decodes and confirms on its own page. */
+export type SelfReviewedRequest = {
+    account: Address;
+    calls: readonly {
+        chainId: number;
+        to: Address;
+        data: Hex;
+        value: bigint;
+        /** The exact gas limit the app fixed for the call, when it did. */
+        gas?: bigint;
+    }[];
+};
+/**
+ * The wallet as core sees it. This file is the only core code that calls a
+ * wallet; `sendReviewed` reaches it only through an adapter, after the review
+ * is confirmed. A `self-reviewing` adapter shows its own review and takes raw
+ * calls through `submitToReviewer` only.
+ */
+export type WalletAdapter = {
+    /**
+     * Settles once `kind` and `isSafe` can be trusted (Safe{Wallet} over
+     * WalletConnect is known only once its peer metadata settles). Core awaits
+     * it, bounded, before reading them; a rejection or timeout sends nothing.
+     * It may be called more than once.
+     */
+    ready?(): Promise<void>;
+    kind: "wallet" | "self-reviewing";
+    account(): Address | undefined;
+    chainId(): number | undefined;
+    isSafe(): boolean;
+    switchChain(chainId: number): Promise<void>;
+    sendTransaction(tx: {
+        chainId: number;
+        to: Address;
+        data: Hex;
+        value: bigint;
+        gas?: bigint;
+    }): Promise<Hex>;
+    signTypedData(typedData: TypedDataDefinition): Promise<Hex>;
+    signMessage(message: string): Promise<Hex>;
+    sendCalls?(chainId: number, calls: readonly {
+        to: Address;
+        data: Hex;
+        value: bigint;
+    }[]): Promise<string>;
+    /** Self-reviewing adapters only. */
+    submitToReviewer?(request: SelfReviewedRequest): Promise<Hex>;
+};
+export declare const WALLET_NOT_READY_LINE = "Your wallet's connection could not be confirmed. Nothing was sent; try again.";
+/**
+ * Awaits `adapter.ready`, at most {@link WALLET_READY_MS}. A rejection or
+ * timeout throws {@link WALLET_NOT_READY_LINE}: the wallet is never taken
+ * for a plain one it may not be.
+ */
+export declare function walletReady(adapter: WalletAdapter): Promise<void>;
+/**
+ * A {@link WalletAdapter} over a viem wallet client (wagmi's, say). Every
+ * write and signature names the connected account read when it is asked,
+ * and every send names its chain, so a wallet that moved refuses it.
+ */
+export declare function viemWalletAdapter(options: {
+    walletClient: () => Promise<WalletClient>;
+    account: () => Address | undefined;
+    chainId: () => number | undefined;
+    isSafe: () => boolean;
+    switchChain: (chainId: number) => Promise<unknown>;
+    /** Settles once `isSafe` is known (see {@link WalletAdapter.ready}). */
+    ready?: () => Promise<unknown>;
+}): WalletAdapter;
+/** EIP-1193 4200, as Signa's connector refuses a request it does not take. */
+export declare function unsupportedWalletRequest(): Error;
+/**
+ * A {@link WalletAdapter} for a wallet that reviews on its own page (Signa).
+ * It takes raw calls through `submit` only; every other method is refused
+ * with EIP-1193 4200.
+ */
+export declare function selfReviewingAdapter(options: {
+    account: () => Address | undefined;
+    submit: (request: SelfReviewedRequest) => Promise<Hex>;
+}): WalletAdapter;
+//# sourceMappingURL=wallet.d.ts.map

package/dist/cjs/review/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../../src/review/wallet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EAEP,GAAG,EACH,mBAAmB,EACnB,YAAY,EACb,MAAM,MAAM,CAAC;AAGd,0FAA0F;AAC1F,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,SAAS;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,EAAE,EAAE,OAAO,CAAC;QACZ,IAAI,EAAE,GAAG,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,mEAAmE;QACnE,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;CACL,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;;OAKG;IACH,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,IAAI,EAAE,QAAQ,GAAG,gBAAgB,CAAC;IAClC,OAAO,IAAI,OAAO,GAAG,SAAS,CAAC;IAC/B,OAAO,IAAI,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,IAAI,OAAO,CAAC;IAClB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,eAAe,CAAC,EAAE,EAAE;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,EAAE,EAAE,OAAO,CAAC;QACZ,IAAI,EAAE,GAAG,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACjB,aAAa,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5D,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3C,SAAS,CAAC,CACR,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,GAC1D,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,oCAAoC;IACpC,gBAAgB,CAAC,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAC/D,CAAC;AAKF,eAAO,MAAM,qBAAqB,kFAC+C,CAAC;AAElF;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAYvE;AAsDD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,YAAY,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1C,OAAO,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IACnC,OAAO,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAClC,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAChC,GAAG,aAAa,CAyDhB;AAED,8EAA8E;AAC9E,wBAAgB,wBAAwB,IAAI,KAAK,CAOhD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,OAAO,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IACnC,MAAM,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACxD,GAAG,aAAa,CAgBhB"}