@bananapus/nana-sdk-core 3.5.2 → 5.0.0

package/dist/esm/review/lineError.d.ts

@@ -0,0 +1,72 @@
+import type { Hex, TransactionReceipt } from "viem";
+import type { ReviewedCall } from "./send.js";
+/**
+ * An error with its own one-line message, which `errorLine` shows: the
+ * SDK's, or a site's own refusal (thrown from `reverify`, `assertWriteState`
+ * or `beforeWallet`, say). Any other error's text never reaches the UI.
+ */
+export declare class ReviewLineError extends Error {
+}
+/**
+ * An SDK error shown by its fixed `line`, never its text (which can quote a
+ * service). The line lives on the error's class, so it loads with the code
+ * that throws it.
+ */
+export declare abstract class ReviewFixedLineError extends Error {
+    abstract readonly line: string;
+    /** Its class's mark, which `errorLine` reads: the SDK's ESM and CommonJS copies each have their own class. */
+    get reviewFixedLine(): true;
+}
+/**
+ * A step's transaction was mined and reverted: nothing of it to resume, and
+ * the action can be reviewed again. `receipt` is the mined receipt, so a
+ * site can close its own record of the attempt.
+ */
+export declare class ReviewedCallRevertedError extends ReviewLineError {
+    /** The step's index in the whole action. */
+    readonly step: number;
+    readonly hash: Hex;
+    readonly receipt: TransactionReceipt;
+    readonly name = "ReviewedCallRevertedError";
+    constructor(
+    /** The step's index in the whole action. */
+    step: number, hash: Hex, receipt: TransactionReceipt);
+}
+/** A wallet adapter's refusal before it called the wallet: proven unsent, so its step is released. */
+export declare class WalletNotInvokedError extends ReviewLineError {
+    readonly name = "WalletNotInvokedError";
+}
+/** A step mined whose receipt its hold has not verified yet: it stays held until the hold settles it. */
+export declare class ReviewedReceiptUnverifiedError extends ReviewLineError {
+    readonly step: number;
+    readonly hash: Hex;
+    /**
+     * The step's call and its hold reservation, which `completeReviewedStep`
+     * reads, the hashes of the steps completed before it, and the run's
+     * signatures when it signed any.
+     */
+    readonly held?: {
+        call: ReviewedCall;
+        reservation: string | undefined;
+        hashes?: Hex[];
+        signatures?: Hex[];
+    } | undefined;
+    readonly name = "ReviewedReceiptUnverifiedError";
+    constructor(step: number, hash: Hex, line?: string, 
+    /**
+     * The step's call and its hold reservation, which `completeReviewedStep`
+     * reads, the hashes of the steps completed before it, and the run's
+     * signatures when it signed any.
+     */
+    held?: {
+        call: ReviewedCall;
+        reservation: string | undefined;
+        hashes?: Hex[];
+        signatures?: Hex[];
+    } | undefined, 
+    /** What ended the run before the hold verified the step: a read that failed, say. */
+    options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=lineError.d.ts.map

package/dist/esm/review/lineError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineError.d.ts","sourceRoot":"","sources":["../../../src/review/lineError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;CAAG;AAE7C;;;;GAIG;AACH,8BAAsB,oBAAqB,SAAQ,KAAK;IACtD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B,8GAA8G;IAC9G,IAAI,eAAe,IAAI,IAAI,CAE1B;CACF;AAED;;;;GAIG;AACH,qBAAa,yBAA0B,SAAQ,eAAe;IAI1D,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,GAAG;IAClB,QAAQ,CAAC,OAAO,EAAE,kBAAkB;IANtC,QAAQ,CAAC,IAAI,+BAA+B;;IAG1C,4CAA4C;IACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,kBAAkB;CAIvC;AAED,sGAAsG;AACtG,qBAAa,qBAAsB,SAAQ,eAAe;IACxD,QAAQ,CAAC,IAAI,2BAA2B;CACzC;AAED,yGAAyG;AACzG,qBAAa,8BAA+B,SAAQ,eAAe;IAI/D,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,GAAG;IAElB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE;QACd,IAAI,EAAE,YAAY,CAAC;QACnB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;QACf,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC;KACpB;IAhBH,QAAQ,CAAC,IAAI,oCAAoC;gBAGtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EAClB,IAAI,GAAE,MAA6B;IACnC;;;;OAIG;IACM,IAAI,CAAC,EAAE;QACd,IAAI,EAAE,YAAY,CAAC;QACnB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;QACf,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC;KACpB,YAAA;IACD,qFAAqF;IACrF,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAWpC"}

package/dist/esm/review/lineError.js

@@ -0,0 +1,68 @@
+import { HELD_CONFIRMING_LINE, WRITE_HOLD_REVERTED_LINE } from "./messages.js";
+/**
+ * An error with its own one-line message, which `errorLine` shows: the
+ * SDK's, or a site's own refusal (thrown from `reverify`, `assertWriteState`
+ * or `beforeWallet`, say). Any other error's text never reaches the UI.
+ */
+export class ReviewLineError extends Error {
+}
+/**
+ * An SDK error shown by its fixed `line`, never its text (which can quote a
+ * service). The line lives on the error's class, so it loads with the code
+ * that throws it.
+ */
+export class ReviewFixedLineError extends Error {
+    /** Its class's mark, which `errorLine` reads: the SDK's ESM and CommonJS copies each have their own class. */
+    get reviewFixedLine() {
+        return true;
+    }
+}
+/**
+ * A step's transaction was mined and reverted: nothing of it to resume, and
+ * the action can be reviewed again. `receipt` is the mined receipt, so a
+ * site can close its own record of the attempt.
+ */
+export class ReviewedCallRevertedError extends ReviewLineError {
+    constructor(
+    /** The step's index in the whole action. */
+    step, hash, receipt) {
+        super(WRITE_HOLD_REVERTED_LINE);
+        this.step = step;
+        this.hash = hash;
+        this.receipt = receipt;
+        this.name = "ReviewedCallRevertedError";
+    }
+}
+/** A wallet adapter's refusal before it called the wallet: proven unsent, so its step is released. */
+export class WalletNotInvokedError extends ReviewLineError {
+    constructor() {
+        super(...arguments);
+        this.name = "WalletNotInvokedError";
+    }
+}
+/** A step mined whose receipt its hold has not verified yet: it stays held until the hold settles it. */
+export class ReviewedReceiptUnverifiedError extends ReviewLineError {
+    constructor(step, hash, line = HELD_CONFIRMING_LINE, 
+    /**
+     * The step's call and its hold reservation, which `completeReviewedStep`
+     * reads, the hashes of the steps completed before it, and the run's
+     * signatures when it signed any.
+     */
+    held, 
+    /** What ended the run before the hold verified the step: a read that failed, say. */
+    options = {}) {
+        super(line);
+        this.step = step;
+        this.hash = hash;
+        this.held = held;
+        this.name = "ReviewedReceiptUnverifiedError";
+        // Not enumerable, like a native cause: serializing leaves out an RPC error and its URL.
+        Object.defineProperty(this, "cause", {
+            value: options.cause,
+            writable: true,
+            enumerable: false,
+            configurable: true,
+        });
+    }
+}
+//# sourceMappingURL=lineError.js.map

package/dist/esm/review/lineError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineError.js","sourceRoot":"","sources":["../../../src/review/lineError.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAE/E;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;CAAG;AAE7C;;;;GAIG;AACH,MAAM,OAAgB,oBAAqB,SAAQ,KAAK;IAGtD,8GAA8G;IAC9G,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,eAAe;IAG5D;IACE,4CAA4C;IACnC,IAAY,EACZ,IAAS,EACT,OAA2B;QAEpC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAJvB,SAAI,GAAJ,IAAI,CAAQ;QACZ,SAAI,GAAJ,IAAI,CAAK;QACT,YAAO,GAAP,OAAO,CAAoB;QAN7B,SAAI,GAAG,2BAA2B,CAAC;IAS5C,CAAC;CACF;AAED,sGAAsG;AACtG,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IAA1D;;QACW,SAAI,GAAG,uBAAuB,CAAC;IAC1C,CAAC;CAAA;AAED,yGAAyG;AACzG,MAAM,OAAO,8BAA+B,SAAQ,eAAe;IAGjE,YACW,IAAY,EACZ,IAAS,EAClB,OAAe,oBAAoB;IACnC;;;;OAIG;IACM,IAKR;IACD,qFAAqF;IACrF,UAA+B,EAAE;QAEjC,KAAK,CAAC,IAAI,CAAC,CAAC;QAjBH,SAAI,GAAJ,IAAI,CAAQ;QACZ,SAAI,GAAJ,IAAI,CAAK;QAOT,SAAI,GAAJ,IAAI,CAKZ;QAhBM,SAAI,GAAG,gCAAgC,CAAC;QAqB/C,wFAAwF;QACxF,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE;YACnC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/esm/review/messages.d.ts

@@ -45,6 +45,10 @@ export declare const WRITE_HOLD_IN_TAB_LINE = "This browser can't remember pendi
 export declare const WRITE_HOLD_PENDING_LINE = "Still pending in your wallet. Speed it up or cancel it there.";
 /** A write that reverted onchain, held until its block is shown canonical (a Safe failure, until final) so a retry can't double it. */
 export declare const WRITE_HOLD_REVERTED_LINE = "This transaction failed onchain. You can try again in a few minutes.";
+/** A Safe execution whose transaction landed while the Safe's own result is not proven yet. */
+export declare const WRITE_HOLD_SAFE_UNCONFIRMED_LINE = "This transaction landed, but the Safe's own result is not confirmed yet. Check the Safe before trying again.";
+/** A Safe execution whose transaction landed while the Safe's own call failed (ExecutionFailure). */
+export declare const WRITE_HOLD_CALL_FAILED_LINE = "The Safe ran this transaction, but its call failed, so nothing changed. Review it and try again.";
 /** A held write the chain can't check (saved with no nonce to look at). The exit is offered. */
 export declare const WRITE_HOLD_UNCHECKED_LINE = "This transaction can't be checked onchain. Check your wallet before sending again.";
 /** A send stopped before the wallet because the account's nonce couldn't be read. */
@@ -58,7 +62,7 @@ export declare const WRITE_HOLD_LOOKS_DONE_LINE = "This looks done. Check your w
 /** A held Safe write whose follower ended without proof. The exit is offered. */
 export declare const WRITE_HOLD_SAFE_UNPROVEN_LINE = "This Safe transaction couldn't be confirmed here. Check your Safe, then send again.";
 /** A held write whose transaction is mined but whose result can't be read yet. No exit yet. */
-export declare const WRITE_HOLD_MINED_LINE = "Your transaction is onchain, but its result can't be read yet.";
+export declare const WRITE_HOLD_MINED_LINE = "Your transaction is onchain, but its result can't be read yet. Check your wallet before sending again.";
 /** A send whose review went stale because another window's attempt of the same write ended meanwhile. */
 export declare const WRITE_HOLD_STALE_REVIEW_LINE = "This was just sent from another window. Review it again to send another.";
 /** The one line while a sent write, direct or through a Safe, is being confirmed. */
@@ -76,13 +80,13 @@ export declare const HELD_FAILED_LINE = "This transaction failed onchain. Review
 /** A held write settled with success on authenticated evidence. */
 export declare const HELD_SUCCESS_LINE = "Your transaction went through.";
 /** A held Safe proposal proven expired before it ran. */
-export declare const HELD_EXPIRED_LINE = "Your Safe proposal expired before it ran.";
+export declare const HELD_EXPIRED_LINE = "Your Safe proposal expired before it ran. Propose it again.";
 /** A success the hold settled while the user was away: shown until they say to send again. */
 export declare const HELD_AWAY_SUCCESS_LINE = "This went through while you were away.";
 /** The one action on a success settled while away: acknowledge it, then send. */
 export declare const HELD_SEND_AGAIN_LABEL = "Send it again";
 /** A saved attempt that can't be shown here: absence of evidence is never permission to send. */
-export declare const SAVED_ATTEMPT_CHECK_LINE = "This transaction may already be in your wallet, and it cannot be confirmed from here.";
+export declare const SAVED_ATTEMPT_CHECK_LINE = "This transaction may already be in your wallet. Check your wallet before sending again.";
 /** The warning under it. */
 export declare const SAVED_ATTEMPT_CHECK_WARNING = "Check your wallet and the explorer first. Continuing can send it twice.";
 /** The one check action's label: "I checked it. Review it again." or the flow's next step ("Create again"). */
@@ -93,5 +97,13 @@ export declare const SAVED_ATTEMPT_TAB_ONLY_LINE = "This applies to this tab onl
 export declare const SAVED_ATTEMPT_UNREADABLE_LINE = "This browser can't read its saved transactions. Check your wallet before sending again.";
 /** The warned exit's label, offered only after a check action found storage unreadable. */
 export declare const SAVED_ATTEMPT_CONTINUE_ANYWAY_LABEL = "I checked my wallet. Continue anyway";
+/** The refusal when the connected account is not the one an action was built for. */
+export declare const REVIEWED_ACCOUNT_CHANGED_LINE = "The connected account changed. Review again.";
+/** The refusal when the app's send engine loader fails: a failed chunk load stays cached until a reload. */
+export declare const REVIEWED_ENGINE_LOAD_LINE = "This page could not load the review. Nothing was sent; reload the page and try again.";
+/** The refusal after a review whose simulation found the action would revert; the review showed why. */
+export declare const REVIEWED_SIMULATION_FAILED_LINE = "This transaction would fail onchain. Nothing was sent; the review shows why.";
+/** The same refusal when the revert's reason could not be read. */
+export declare const REVIEWED_SIMULATION_UNEXPLAINED_LINE = "This transaction would fail onchain. Nothing was sent; check the amounts and try again.";
 export {};
 //# sourceMappingURL=messages.d.ts.map

package/dist/esm/review/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/review/messages.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4FAA4F;AAC5F,KAAK,aAAa,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,EACE,MAAiB,EACjB,KAAkB,EAClB,UAA0D,GAC3D,GAAE;IACD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;CAChC,GACL,MAAM,CAIR;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,EACrB,EACE,MAAiB,EACjB,OAAmB,EACnB,gBAAwB,GACzB,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GACxE,MAAM,CAOR;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,MAAM,SAAgB,GAAG,MAAM,CAE/D;AAED,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,oCAAoC,CAAC;AAElE,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EACjC,MAAM,SAAgB,GACrB,MAAM,CAIR;AAED,iEAAiE;AACjE,eAAO,MAAM,2BAA2B,0EACiC,CAAC;AAE1E,gDAAgD;AAChD,eAAO,MAAM,2BAA2B,oCAAoC,CAAC;AAE7E,yEAAyE;AACzE,eAAO,MAAM,4BAA4B,2EACiC,CAAC;AAE3E,sFAAsF;AACtF,eAAO,MAAM,sBAAsB,8FAC0D,CAAC;AAE9F,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,kEAC6B,CAAC;AAElE,uIAAuI;AACvI,eAAO,MAAM,wBAAwB,yEACmC,CAAC;AAEzE,gGAAgG;AAChG,eAAO,MAAM,yBAAyB,uFACgD,CAAC;AAEvF,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,6FAC0D,CAAC;AAE7F,+DAA+D;AAC/D,eAAO,MAAM,2BAA2B,iFACwC,CAAC;AAEjF,wFAAwF;AACxF,eAAO,MAAM,6BAA6B,gFACqC,CAAC;AAEhF,6GAA6G;AAC7G,eAAO,MAAM,0BAA0B,uDACe,CAAC;AAEvD,iFAAiF;AACjF,eAAO,MAAM,6BAA6B,wFAC6C,CAAC;AAExF,+FAA+F;AAC/F,eAAO,MAAM,qBAAqB,mEACgC,CAAC;AAEnE,yGAAyG;AACzG,eAAO,MAAM,4BAA4B,6EACmC,CAAC;AAE7E,qFAAqF;AACrF,eAAO,MAAM,oBAAoB,iCAAiC,CAAC;AAEnE,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,qCAAqC,CAAC;AAErE,qEAAqE;AACrE,eAAO,MAAM,4BAA4B,yCACD,CAAC;AAEzC,2DAA2D;AAC3D,eAAO,MAAM,eAAe,wBAAwB,CAAC;AAErD,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,oCAAoC,CAAC;AAEpE,sGAAsG;AACtG,eAAO,MAAM,gBAAgB,8DACgC,CAAC;AAE9D,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,mCAAmC,CAAC;AAElE,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,8CAA8C,CAAC;AAE7E,8FAA8F;AAC9F,eAAO,MAAM,sBAAsB,2CAA2C,CAAC;AAE/E,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AAErD,iGAAiG;AACjG,eAAO,MAAM,wBAAwB,0FACoD,CAAC;AAE1F,4BAA4B;AAC5B,eAAO,MAAM,2BAA2B,4EACmC,CAAC;AAE5E,+GAA+G;AAC/G,wBAAgB,cAAc,CAAC,IAAI,SAAoB,GAAG,MAAM,CAE/D;AAED,0EAA0E;AAC1E,eAAO,MAAM,2BAA2B,mCAAmC,CAAC;AAE5E,8EAA8E;AAC9E,eAAO,MAAM,6BAA6B,4FACiD,CAAC;AAE5F,2FAA2F;AAC3F,eAAO,MAAM,mCAAmC,yCACR,CAAC"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/review/messages.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4FAA4F;AAC5F,KAAK,aAAa,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,EACE,MAAiB,EACjB,KAAkB,EAClB,UAA0D,GAC3D,GAAE;IACD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;CAChC,GACL,MAAM,CAIR;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,EACrB,EACE,MAAiB,EACjB,OAAmB,EACnB,gBAAwB,GACzB,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GACxE,MAAM,CAOR;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,MAAM,SAAgB,GAAG,MAAM,CAE/D;AAED,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,oCAAoC,CAAC;AAElE,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EACjC,MAAM,SAAgB,GACrB,MAAM,CAIR;AAED,iEAAiE;AACjE,eAAO,MAAM,2BAA2B,0EACiC,CAAC;AAE1E,gDAAgD;AAChD,eAAO,MAAM,2BAA2B,oCAAoC,CAAC;AAE7E,yEAAyE;AACzE,eAAO,MAAM,4BAA4B,2EACiC,CAAC;AAE3E,sFAAsF;AACtF,eAAO,MAAM,sBAAsB,8FAC0D,CAAC;AAE9F,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,kEAC6B,CAAC;AAElE,uIAAuI;AACvI,eAAO,MAAM,wBAAwB,yEACmC,CAAC;AAEzE,+FAA+F;AAC/F,eAAO,MAAM,gCAAgC,iHACmE,CAAC;AAEjH,qGAAqG;AACrG,eAAO,MAAM,2BAA2B,qGAC4D,CAAC;AAErG,gGAAgG;AAChG,eAAO,MAAM,yBAAyB,uFACgD,CAAC;AAEvF,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,6FAC0D,CAAC;AAE7F,+DAA+D;AAC/D,eAAO,MAAM,2BAA2B,iFACwC,CAAC;AAEjF,wFAAwF;AACxF,eAAO,MAAM,6BAA6B,gFACqC,CAAC;AAEhF,6GAA6G;AAC7G,eAAO,MAAM,0BAA0B,uDACe,CAAC;AAEvD,iFAAiF;AACjF,eAAO,MAAM,6BAA6B,wFAC6C,CAAC;AAExF,+FAA+F;AAC/F,eAAO,MAAM,qBAAqB,2GACwE,CAAC;AAE3G,yGAAyG;AACzG,eAAO,MAAM,4BAA4B,6EACmC,CAAC;AAE7E,qFAAqF;AACrF,eAAO,MAAM,oBAAoB,iCAAiC,CAAC;AAEnE,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,qCAAqC,CAAC;AAErE,qEAAqE;AACrE,eAAO,MAAM,4BAA4B,yCACD,CAAC;AAEzC,2DAA2D;AAC3D,eAAO,MAAM,eAAe,wBAAwB,CAAC;AAErD,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,oCAAoC,CAAC;AAEpE,sGAAsG;AACtG,eAAO,MAAM,gBAAgB,8DACgC,CAAC;AAE9D,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,mCAAmC,CAAC;AAElE,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,gEACiC,CAAC;AAEhE,8FAA8F;AAC9F,eAAO,MAAM,sBAAsB,2CAA2C,CAAC;AAE/E,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AAErD,iGAAiG;AACjG,eAAO,MAAM,wBAAwB,4FACsD,CAAC;AAE5F,4BAA4B;AAC5B,eAAO,MAAM,2BAA2B,4EACmC,CAAC;AAE5E,+GAA+G;AAC/G,wBAAgB,cAAc,CAAC,IAAI,SAAoB,GAAG,MAAM,CAE/D;AAED,0EAA0E;AAC1E,eAAO,MAAM,2BAA2B,mCAAmC,CAAC;AAE5E,8EAA8E;AAC9E,eAAO,MAAM,6BAA6B,4FACiD,CAAC;AAE5F,2FAA2F;AAC3F,eAAO,MAAM,mCAAmC,yCACR,CAAC;AAEzC,qFAAqF;AACrF,eAAO,MAAM,6BAA6B,iDACM,CAAC;AAEjD,4GAA4G;AAC5G,eAAO,MAAM,yBAAyB,0FACmD,CAAC;AAE1F,wGAAwG;AACxG,eAAO,MAAM,+BAA+B,iFACoC,CAAC;AAEjF,mEAAmE;AACnE,eAAO,MAAM,oCAAoC,4FAC0C,CAAC"}

package/dist/esm/review/messages.js

@@ -51,6 +51,10 @@ export const WRITE_HOLD_IN_TAB_LINE = "This browser can't remember pending trans
 export const WRITE_HOLD_PENDING_LINE = "Still pending in your wallet. Speed it up or cancel it there.";
 /** A write that reverted onchain, held until its block is shown canonical (a Safe failure, until final) so a retry can't double it. */
 export const WRITE_HOLD_REVERTED_LINE = "This transaction failed onchain. You can try again in a few minutes.";
+/** A Safe execution whose transaction landed while the Safe's own result is not proven yet. */
+export const WRITE_HOLD_SAFE_UNCONFIRMED_LINE = "This transaction landed, but the Safe's own result is not confirmed yet. Check the Safe before trying again.";
+/** A Safe execution whose transaction landed while the Safe's own call failed (ExecutionFailure). */
+export const WRITE_HOLD_CALL_FAILED_LINE = "The Safe ran this transaction, but its call failed, so nothing changed. Review it and try again.";
 /** A held write the chain can't check (saved with no nonce to look at). The exit is offered. */
 export const WRITE_HOLD_UNCHECKED_LINE = "This transaction can't be checked onchain. Check your wallet before sending again.";
 /** A send stopped before the wallet because the account's nonce couldn't be read. */
@@ -64,7 +68,7 @@ export const WRITE_HOLD_LOOKS_DONE_LINE = "This looks done. Check your wallet, t
 /** A held Safe write whose follower ended without proof. The exit is offered. */
 export const WRITE_HOLD_SAFE_UNPROVEN_LINE = "This Safe transaction couldn't be confirmed here. Check your Safe, then send again.";
 /** A held write whose transaction is mined but whose result can't be read yet. No exit yet. */
-export const WRITE_HOLD_MINED_LINE = "Your transaction is onchain, but its result can't be read yet.";
+export const WRITE_HOLD_MINED_LINE = "Your transaction is onchain, but its result can't be read yet. Check your wallet before sending again.";
 /** A send whose review went stale because another window's attempt of the same write ended meanwhile. */
 export const WRITE_HOLD_STALE_REVIEW_LINE = "This was just sent from another window. Review it again to send another.";
 /** The one line while a sent write, direct or through a Safe, is being confirmed. */
@@ -82,13 +86,13 @@ export const HELD_FAILED_LINE = "This transaction failed onchain. Review it and
 /** A held write settled with success on authenticated evidence. */
 export const HELD_SUCCESS_LINE = "Your transaction went through.";
 /** A held Safe proposal proven expired before it ran. */
-export const HELD_EXPIRED_LINE = "Your Safe proposal expired before it ran.";
+export const HELD_EXPIRED_LINE = "Your Safe proposal expired before it ran. Propose it again.";
 /** A success the hold settled while the user was away: shown until they say to send again. */
 export const HELD_AWAY_SUCCESS_LINE = "This went through while you were away.";
 /** The one action on a success settled while away: acknowledge it, then send. */
 export const HELD_SEND_AGAIN_LABEL = "Send it again";
 /** A saved attempt that can't be shown here: absence of evidence is never permission to send. */
-export const SAVED_ATTEMPT_CHECK_LINE = "This transaction may already be in your wallet, and it cannot be confirmed from here.";
+export const SAVED_ATTEMPT_CHECK_LINE = "This transaction may already be in your wallet. Check your wallet before sending again.";
 /** The warning under it. */
 export const SAVED_ATTEMPT_CHECK_WARNING = "Check your wallet and the explorer first. Continuing can send it twice.";
 /** The one check action's label: "I checked it. Review it again." or the flow's next step ("Create again"). */
@@ -101,4 +105,12 @@ export const SAVED_ATTEMPT_TAB_ONLY_LINE = "This applies to this tab only.";
 export const SAVED_ATTEMPT_UNREADABLE_LINE = "This browser can't read its saved transactions. Check your wallet before sending again.";
 /** The warned exit's label, offered only after a check action found storage unreadable. */
 export const SAVED_ATTEMPT_CONTINUE_ANYWAY_LABEL = "I checked my wallet. Continue anyway";
+/** The refusal when the connected account is not the one an action was built for. */
+export const REVIEWED_ACCOUNT_CHANGED_LINE = "The connected account changed. Review again.";
+/** The refusal when the app's send engine loader fails: a failed chunk load stays cached until a reload. */
+export const REVIEWED_ENGINE_LOAD_LINE = "This page could not load the review. Nothing was sent; reload the page and try again.";
+/** The refusal after a review whose simulation found the action would revert; the review showed why. */
+export const REVIEWED_SIMULATION_FAILED_LINE = "This transaction would fail onchain. Nothing was sent; the review shows why.";
+/** The same refusal when the revert's reason could not be read. */
+export const REVIEWED_SIMULATION_UNEXPLAINED_LINE = "This transaction would fail onchain. Nothing was sent; check the amounts and try again.";
 //# sourceMappingURL=messages.js.map

package/dist/esm/review/messages.js.map

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

package/dist/esm/review/model.d.ts

@@ -0,0 +1,149 @@
+import { type Address, type Hex, type PublicClient } from "viem";
+import { type PrettyStep, type V4PlanStep } from "./decode.js";
+import { type TransactionReviewRequest, type TransactionReviewSignature } from "./transactionReview.js";
+/** A row the site shows above the calls, marked as the site's own summary. */
+export type ReviewContextRow = {
+    label: string;
+    value: string;
+    /** Further lines of the value, shown under it in order (each signer, say). */
+    lines?: readonly string[];
+    /** A short note under the row, such as what the action leaves to do. */
+    note?: string;
+    strong?: boolean;
+    mono?: boolean;
+};
+export type ReviewWarningCode = "safe-gas-nonzero" | "delegatecall" | "abi-unavailable" | "unknown-contract" | "unlimited-approval" | "owner-action" | "permission-grant" | "decimals-unknown" | "possible-token-id" | "simulation-failed" | "simulation-unavailable" | "unreadable";
+export type ReviewWarning = {
+    code: ReviewWarningCode;
+    text: string;
+};
+/**
+ * One ABI value. `text` is {@link readableValue}'s output. A tuple's
+ * `children` are its components, by name; an array's are its elements, named
+ * `[0]`, `[1]`, …. Any other value has none.
+ */
+export type ReviewValue = {
+    name: string;
+    type: string;
+    text: string;
+    children: ReviewValue[] | null;
+};
+/**
+ * One ABI input of a decoded call. `text` is {@link readableValue}'s output,
+ * except where the review states it more precisely (a Safe `operation`, a
+ * Universal Router deadline). A decoder's readable view rides along in
+ * `steps`, `v4Plan` or `nested`; a Universal Router `execute` plan rides on
+ * its `commands` argument.
+ */
+export type ReviewArgument = ReviewValue & {
+    steps: PrettyStep[] | null;
+    v4Plan: V4PlanStep[] | null;
+    nested: ReviewCallModel[] | null;
+};
+/** An address the call gives a part, read from the argument's name. */
+export type ReviewRole = {
+    role: "spender" | "recipient" | "beneficiary" | "owner" | "operator";
+    address: Address;
+    name: string | null;
+};
+/**
+ * An amount of a token the call moves or approves, in base units. `decimals`
+ * and `symbol` are null until known: native ETH and USDC are known at once,
+ * any other token after {@link enrichReviewModel} reads it.
+ */
+export type ReviewTokenAmount = {
+    token: Address | "native";
+    amount: bigint;
+    decimals: number | null;
+    symbol: string | null;
+};
+export type ReviewCallModel = {
+    chainId: number;
+    from: Address | null;
+    to: Address;
+    contractName: string | null;
+    value: bigint;
+    valueText: string;
+    gas: bigint | null;
+    safeTxGas: bigint | null;
+    label: string | null;
+    functionName: string | null;
+    /** The exact calldata, bound by the model's id like every call field. */
+    data: Hex;
+    selector: Hex;
+    byteLength: number;
+    /** Null when the ABI is unavailable or the arguments don't encode to the calldata. */
+    args: ReviewArgument[] | null;
+    /** The calls a batching destination makes, in order. A MultiSend's show in its `transactions` argument instead. */
+    calls: ReviewCallModel[] | null;
+    roles: ReviewRole[];
+    tokenAmounts: ReviewTokenAmount[];
+    /** The NFT an ERC-721 `approve` or `transferFrom` names: its last argument is a token ID, not an amount. */
+    nft: {
+        token: Address;
+        tokenId: bigint;
+    } | null;
+    warnings: ReviewWarning[];
+};
+/** One signature the action asks for, as the review shows it. */
+export type ReviewSignatureModel = {
+    kind: TransactionReviewSignature["kind"];
+    chainId: number;
+    /** A copy of the exact EIP-712 typed data signed; null for a message. */
+    typedData: unknown | null;
+    /** The exact text signed; null for typed data. */
+    message: string | null;
+    /** The calls the signature lets someone run, decoded. */
+    calls: ReviewCallModel[];
+    /** What it authorizes, in rows (Permit2's token, amount, spender and expiry). */
+    steps: PrettyStep[];
+};
+export type ReviewModel = {
+    /**
+     * keccak256 of the canonical JSON of the binding fields only: kind, each
+     * call's chainId, from, to, value, gas, safeTxGas, data and any
+     * adoptIgnoringArgs (and the same for
+     * the decoded calls it shows inside), authorization, message, context, and
+     * each signature's kind, chain, typed data, text and calls. Enrichment,
+     * warnings and simulation are excluded and may change after mint.
+     */
+    id: Hex;
+    /** "message" is an authorization signed as a plain message rather than typed data. */
+    kind: "transaction" | "authorization" | "message";
+    title: string | null;
+    description: string;
+    confirmLabel: string | null;
+    /** The site's summary rows, in the order given, shown first. */
+    context: ReviewContextRow[];
+    calls: ReviewCallModel[];
+    /** A copy of the exact typed data (or message envelope) a signature commits to. */
+    authorization: unknown | null;
+    /** The exact personal_sign text, when the action signs one message. */
+    message: string | null;
+    /** The signatures the action asks for, signed after confirm and before any call is sent. */
+    signatures: ReviewSignatureModel[];
+    /** {@link transactionReviewJson} of the request. */
+    rawJson: string;
+    warnings: ReviewWarning[];
+};
+/**
+ * The plain-data review of a request: what every client's review dialog
+ * shows, decoded once. `context` is display only and never feeds `calls`.
+ * It never throws: a request it can't read or bind exactly gets a model with
+ * an `unreadable` warning, showing what it can read, and an id that matches
+ * no other model. Core's own prompts refuse such a model: it confirms nothing.
+ */
+export declare function buildReviewModel(request: TransactionReviewRequest): ReviewModel;
+type TokenReader = Pick<PublicClient, "readContract">;
+/**
+ * The model with each token's decimals and symbol read from the token, once
+ * per token per chain. A failed read leaves them null, never zero, and keeps
+ * the `decimals-unknown` warning. A call ERC-721 shares, to an unknown
+ * contract, also asks the contract whether it is ERC-721: a yes shows the
+ * number as the NFT's token ID; a no, or decimals it answers, clears
+ * `possible-token-id`; no answer keeps it. The id is unchanged: the reads
+ * only explain the calls already bound.
+ */
+export declare function enrichReviewModel(model: ReviewModel, clientFor: (chainId: number) => TokenReader | undefined): Promise<ReviewModel>;
+export {};
+//# sourceMappingURL=model.d.ts.map

package/dist/esm/review/model.d.ts.map

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