@bananapus/nana-sdk-core 3.5.2 → 4.0.0

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

@@ -1,6 +1,8 @@
+import { ReviewLineError } from "./lineError.js";
 import { type Address, type Hex, type PublicClient, type TransactionReceipt } from "viem";
 import { type SafeQueuedTransaction, type SafeServiceOptions } from "../safeService.js";
 import { type HeldWriteStorage, type ReviewedWriteRecoveryInput, type ReviewedWriteRecoveryRecord } from "./writeRecovery.js";
+import type { ReviewedCall } from "./send.js";
 /** A saved success the user hasn't acknowledged: it blocks sending the action again. */
 export type UnacknowledgedSuccess = {
     result: "success";
@@ -129,13 +131,13 @@ export type WriteHeldState = Exclude<WriteHoldStateOf, {
     reservation?: string;
 };
 /** A send was refused because the exact call is held; `state` says how. */
-export declare class WriteHeldError extends Error {
+export declare class WriteHeldError extends ReviewLineError {
     readonly state: WriteHeldState;
     readonly name = "WriteHeldError";
     constructor(state: WriteHeldState);
 }
 /** The account's nonce couldn't be read, so the wallet never opened. */
-export declare class WriteHoldNonceError extends Error {
+export declare class WriteHoldNonceError extends ReviewLineError {
     readonly cause: unknown;
     readonly name = "WriteHoldNonceError";
     constructor(cause: unknown);
@@ -145,13 +147,13 @@ export declare class WriteHoldNonceError extends Error {
  * reserved, and maybe settled (`settled`), while it was open. Review again;
  * the next review sends normally.
  */
-export declare class WriteHoldStaleReviewError extends Error {
+export declare class WriteHoldStaleReviewError extends ReviewLineError {
     readonly settled?: WriteHoldSettled | undefined;
     readonly name = "WriteHoldStaleReviewError";
     constructor(settled?: WriteHoldSettled | undefined);
 }
 /** The exact call is already being sent from another flow or tab. */
-export declare class WriteHoldBusyError extends Error {
+export declare class WriteHoldBusyError extends ReviewLineError {
     readonly name = "WriteHoldBusyError";
     constructor();
 }
@@ -201,14 +203,7 @@ export declare function createWriteHold(options?: {
     };
 }): {
     open: (call: ReviewedWriteRecoveryInput, { legacy, }?: {
-        legacy?: (string | {
-            call: ReviewedWriteRecoveryInput["call"];
-        } | {
-            match: {
-                to: Address;
-                selector: Hex;
-            };
-        })[];
+        legacy?: WriteHoldLegacySource[];
     }) => {
         peek: () => WriteHoldState;
         state(client: WriteHoldClient, checks?: {
@@ -254,6 +249,8 @@ export declare function createWriteHold(options?: {
          * record is held and the user hasn't acknowledged it. Pure, from storage.
          */
         unacknowledgedSuccess(skip?: (hash: Hex) => boolean): UnacknowledgedSuccess | undefined;
+        /** Whether `reservation` was released (the user's exit, or nothing sent), never settled. */
+        released(reservation: string): boolean;
         /** How `reservation` settled, if it is this key's latest and settled. */
         settlementOf(reservation: string): WriteHoldSettled | undefined;
         /**
@@ -318,6 +315,8 @@ export declare function createWriteHold(options?: {
              * record is held and the user hasn't acknowledged it. Pure, from storage.
              */
             unacknowledgedSuccess(skip?: (hash: Hex) => boolean): UnacknowledgedSuccess | undefined;
+            /** Whether `reservation` was released (the user's exit, or nothing sent), never settled. */
+            released(reservation: string): boolean;
             /** How `reservation` settled, if it is this key's latest and settled. */
             settlementOf(reservation: string): WriteHoldSettled | undefined;
             /**
@@ -338,8 +337,97 @@ export declare function createWriteHold(options?: {
     reviewLine: () => "This browser can't remember pending transactions. Check your wallet before repeating one." | null;
     /** Stop every settle poll and the tab listener (tests, teardown). */
     dispose: () => void;
+    /** Safe's service as the hold reads it, every read bounded. */
+    safeService: SafeServiceOptions;
+};
+/**
+ * A key an earlier version held an intent's write under: an old namespace,
+ * `{ call }` for an exact call, or `{ match }` for every exact-call write to
+ * `to` with that selector (see the hold's `open`).
+ */
+export type WriteHoldLegacySource = string | {
+    call: ReviewedWriteRecoveryInput["call"];
+} | {
+    match: {
+        to: Address;
+        selector: Hex;
+    };
 };
 export type WriteHold = ReturnType<typeof createWriteHold>;
 export type WriteHoldHandle = ReturnType<WriteHold["open"]>;
+/** The write hold one step is sent under: its intent's, or its exact call's. */
+export declare function openStepHold(hold: WriteHold, account: Address, safe: boolean, call: Pick<ReviewedCall, "chainId" | "to" | "data" | "value" | "intent" | "legacy">): {
+    peek: () => WriteHoldState;
+    state(client: WriteHoldClient, checks?: {
+        effect?: (chainId: number) => Promise<boolean>;
+    }): Promise<WriteHoldState>;
+    send<T>(client: WriteHoldClient, run: (gate: WriteHoldGate) => Promise<T>): Promise<T>;
+    exit(snapshot: WriteHoldState, acknowledgement: {
+        checkedWallet: true;
+    }, client: WriteHoldClient): Promise<{
+        released: boolean;
+        state: WriteHoldState;
+    }>;
+    onReceipt: (receipt: TransactionReceipt, client: WriteHoldClient, proof?: {
+        calls: readonly ReviewedWriteRecoveryInput["call"][];
+        batch?: boolean;
+    } | undefined) => Promise<WriteHoldState>;
+    onUnproven: (client: WriteHoldClient, proposalHash?: `0x${string}` | undefined) => Promise<WriteHoldState>;
+    onExecuted: (client: WriteHoldClient, executionHash?: `0x${string}` | undefined) => Promise<WriteHoldState>;
+    attachHash: (client: WriteHoldClient, hash: `0x${string}`) => Promise<WriteHoldState>;
+    attachSafeNonce: (client: WriteHoldClient, args_1: {
+        safeTxHash: Hex;
+        nonce: number;
+    }) => Promise<WriteHoldState>;
+    adopt: (snapshot: WriteHoldState, evidence?: {
+        nonce?: number | bigint;
+        sentNonce?: number | bigint;
+        fromBlock?: bigint;
+        submittedAt?: number;
+        hash?: Hex;
+        safe?: {
+            safeTxHash: Hex;
+        };
+    } | undefined, client?: WriteHoldClient | undefined) => Promise<WriteHoldState | (WriteHoldState & {
+        declined?: "refused" | "unreadable";
+    })>;
+    /**
+     * Every state this controller reads or makes for the call, and other
+     * tabs' changes. The latest one, if any, is replayed at once.
+     */
+    subscribe(listener: (state: WriteHoldState) => void): () => void;
+    /**
+     * The send gate's evidence for this key: its saved success, while no
+     * record is held and the user hasn't acknowledged it. Pure, from storage.
+     */
+    unacknowledgedSuccess(skip?: (hash: Hex) => boolean): UnacknowledgedSuccess | undefined;
+    /** Whether `reservation` was released (the user's exit, or nothing sent), never settled. */
+    released(reservation: string): boolean;
+    /** How `reservation` settled, if it is this key's latest and settled. */
+    settlementOf(reservation: string): WriteHoldSettled | undefined;
+    /**
+     * The user acknowledged a success the hold settled while they were
+     * away (or a view saw it settle): its saved settlement is marked
+     * acknowledged, keeping its result for every reader, so it blocks no
+     * send. Under the call's lock; nothing is sent.
+     */
+    acknowledge(settled: {
+        result: "success" | "failed";
+        hash: Hex;
+    }): Promise<WriteHoldState>;
+};
+/**
+ * The one call a Safe app proposes a batch of `calls` as (`ReviewedAction`'s
+ * `batch`), as its hold holds it: their MultiSend, under the first call's
+ * intent, or else `safeBatchIntent` of the calls.
+ */
+export declare function safeBatchCall(account: Address, calls: readonly Pick<ReviewedCall, "chainId" | "to" | "data" | "value" | "intent" | "legacy">[]): {
+    chainId: number;
+    to: `0x${string}`;
+    data: `0x${string}`;
+    value: bigint;
+    intent: string;
+    legacy: readonly WriteHoldLegacySource[] | undefined;
+};
 export {};
 //# sourceMappingURL=writeHold.d.ts.map

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

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

package/dist/esm/review/writeHold.js

@@ -1,8 +1,11 @@
+import { ReviewLineError } from "./lineError.js";
 import { isAddress, toEventSelector, } from "viem";
 import { canonicalSafeTxHash, lookAtSafeProposalEnd, provenSafeProposalEnd, readSafeTransaction, SAFE_PROPOSAL_AWAITING, safeTransactionMessage, } from "../safeService.js";
 import { SAFE_PROPOSAL_EXECUTED_LINE, WRITE_HOLD_HASHED_EXIT_LINE, WRITE_HOLD_IN_TAB_LINE, WRITE_HOLD_LOOKS_DONE_LINE, WRITE_HOLD_MINED_LINE, WRITE_HOLD_NONCE_LINE, WRITE_HOLD_PENDING_LINE, WRITE_HOLD_UNCHECKED_LINE, WRITE_HOLD_REVERTED_LINE, WRITE_HOLD_SAFE_REPLACED_LINE, WRITE_HOLD_SAFE_UNPROVEN_LINE, WRITE_HOLD_STALE_REVIEW_LINE, writeHeldMessage, } from "./messages.js";
 import { createBrowserWriteRecovery, createHeldWriteStorage, findReviewedWrites, heldSafeProposal, findTransactionAtNonce, listReviewedWrites, readReviewedWriteNonce, safeProposalIsHeldCall, SubmittedWritePersistenceError, verifyReviewedWriteExpiry, verifyReviewedWriteReceipt, } from "./writeRecovery.js";
 import { isBytes32 } from "../untrusted.js";
+import { encodeMultiSend, MULTI_SEND_CALL_ONLY } from "../safe.js";
+import { safeBatchIntent } from "./intents.js";
 import { atCanonicalFinalizedBlock } from "./relayr.js";
 import { TAB, tabShared } from "./tabState.js";
 /** `sent` is the transaction at `hash`, exactly `record`'s call, from its account, on its chain. */
@@ -29,7 +32,7 @@ function ungated(state) {
         : { ...state, exit: false };
 }
 /** A send was refused because the exact call is held; `state` says how. */
-export class WriteHeldError extends Error {
+export class WriteHeldError extends ReviewLineError {
     constructor(state) {
         super(state.line);
         this.state = state;
@@ -37,7 +40,7 @@ export class WriteHeldError extends Error {
     }
 }
 /** The account's nonce couldn't be read, so the wallet never opened. */
-export class WriteHoldNonceError extends Error {
+export class WriteHoldNonceError extends ReviewLineError {
     constructor(cause) {
         super(WRITE_HOLD_NONCE_LINE);
         this.cause = cause;
@@ -49,7 +52,7 @@ export class WriteHoldNonceError extends Error {
  * reserved, and maybe settled (`settled`), while it was open. Review again;
  * the next review sends normally.
  */
-export class WriteHoldStaleReviewError extends Error {
+export class WriteHoldStaleReviewError extends ReviewLineError {
     constructor(settled) {
         super(WRITE_HOLD_STALE_REVIEW_LINE);
         this.settled = settled;
@@ -57,7 +60,7 @@ export class WriteHoldStaleReviewError extends Error {
     }
 }
 /** The exact call is already being sent from another flow or tab. */
-export class WriteHoldBusyError extends Error {
+export class WriteHoldBusyError extends ReviewLineError {
     constructor() {
         super("This transaction is already open in another window.");
         this.name = "WriteHoldBusyError";
@@ -215,7 +218,7 @@ export function createWriteHold(options = {}) {
                     headers: response.headers,
                 })),
                 new Promise((_, reject) => {
-                    timer = setTimeout(() => reject(new Error("Safe's service did not answer in time.")), SAFE_SERVICE_READ_MS);
+                    timer = setTimeout(() => reject(new ReviewLineError("Safe's service did not answer in time.")), SAFE_SERVICE_READ_MS);
                 }),
             ]).finally(() => clearTimeout(timer));
         },
@@ -360,14 +363,16 @@ export function createWriteHold(options = {}) {
             // failure waits for finality. A block the node no longer shows as
             // canonical proves nothing and keeps the hold.
             const verdict = await verifyReviewedWriteReceipt(client, record, receipt, proof, { finality: record.safe }).catch(() => null);
-            if (verdict && release(record)) {
+            if (verdict) {
                 const settled = {
                     result: verdict,
                     hash: receipt.transactionHash.toLowerCase(),
                 };
-                // Kept for any later reader: another tab, a reload, a follow timer.
+                // Saved before the hold ends, so no reader sees it clear without its
+                // result: another tab, a reload, a follow timer.
                 recovery.markSettled(record, settled);
-                return clear(settled, record.id);
+                if (release(record))
+                    return clear(settled, record.id);
             }
             if (!record.safe &&
                 receipt.status === "reverted" &&
@@ -678,13 +683,14 @@ export function createWriteHold(options = {}) {
                 }
                 // It ran: with its receipt unreadable, the canonical log at a
                 // finalized block carries its result. Never a resend exit.
-                if (end.execution && release(record)) {
+                if (end.execution) {
                     const settled = {
                         result: end.execution.status,
                         hash: end.execution.executionHash,
                     };
                     recovery.markSettled(record, settled);
-                    return clear(settled, record.id);
+                    if (release(record))
+                        return clear(settled, record.id);
                 }
             }
             // Its wait is bounded like any unchecked write, the clock restarted by
@@ -905,7 +911,7 @@ export function createWriteHold(options = {}) {
                     },
                     afterSubmit(hash, proposal) {
                         if (!attempt)
-                            throw new Error("Hold the write before the wallet opens.");
+                            throw new ReviewLineError("Hold the write before the wallet opens.");
                         try {
                             attempt = recovery.submitted(hash, attempt);
                         }
@@ -971,7 +977,7 @@ export function createWriteHold(options = {}) {
              */
             async exit(snapshot, acknowledgement, client) {
                 if (acknowledgement?.checkedWallet !== true)
-                    throw new Error("Release a held write only after the user confirms they checked their wallet.");
+                    throw new ReviewLineError("Release a held write only after the user confirms they checked their wallet.");
                 const result = await locked(async () => {
                     const now = await inspect(client, lastEffect);
                     if (snapshot.status === "clear" ||
@@ -1089,7 +1095,7 @@ export function createWriteHold(options = {}) {
                     try {
                         const { released } = await hooks.across((work) => recovery.withLock(work), () => {
                             if (!free())
-                                throw new Error("Held since the app's read.");
+                                throw new ReviewLineError("Held since the app's read.");
                             reserve();
                             adopted = true;
                         }, recovery.rejected, Promise.resolve(), hooks.generations());
@@ -1169,6 +1175,10 @@ export function createWriteHold(options = {}) {
                     }
                     : undefined;
             },
+            /** Whether `reservation` was released (the user's exit, or nothing sent), never settled. */
+            released(reservation) {
+                return recovery.released(reservation);
+            },
             /** How `reservation` settled, if it is this key's latest and settled. */
             settlementOf(reservation) {
                 const now = peek();
@@ -1616,6 +1626,9 @@ export function createWriteHold(options = {}) {
              * How a reservation this intent stood for settled, on its own key or a
              * legacy one, whichever hold is shown now.
              */
+            released(reservation) {
+                return [own, ...delegates].some((handle) => handle.released(reservation));
+            },
             settlementOf(reservation) {
                 for (const handle of [own, ...delegates]) {
                     const settled = handle.settlementOf(reservation);
@@ -1777,6 +1790,39 @@ export function createWriteHold(options = {}) {
         reviewLine: () => (storage.durable() ? null : WRITE_HOLD_IN_TAB_LINE),
         /** Stop every settle poll and the tab listener (tests, teardown). */
         dispose,
+        /** Safe's service as the hold reads it, every read bounded. */
+        safeService: service,
+    };
+}
+/** The write hold one step is sent under: its intent's, or its exact call's. */
+export function openStepHold(hold, account, safe, call) {
+    return hold.open({
+        chainId: call.chainId,
+        account,
+        safe,
+        call: { to: call.to, data: call.data, value: call.value ?? 0n },
+        ...(call.intent ? { namespace: call.intent } : {}),
+    }, call.legacy ? { legacy: [...call.legacy] } : undefined);
+}
+/**
+ * The one call a Safe app proposes a batch of `calls` as (`ReviewedAction`'s
+ * `batch`), as its hold holds it: their MultiSend, under the first call's
+ * intent, or else `safeBatchIntent` of the calls.
+ */
+export function safeBatchCall(account, calls) {
+    const [{ chainId, intent, legacy }] = calls;
+    const inner = calls.map(({ to, data, value }) => ({
+        to,
+        data,
+        value: value ?? 0n,
+    }));
+    return {
+        chainId,
+        to: MULTI_SEND_CALL_ONLY,
+        data: encodeMultiSend(inner),
+        value: 0n,
+        intent: intent ?? safeBatchIntent({ chainId, safe: account, calls: inner }),
+        legacy,
     };
 }
 //# sourceMappingURL=writeHold.js.map