@bananapus/nana-sdk-core 2.24.4 → 2.25.0

package/dist/cjs/safeService.d.ts

@@ -1,5 +1,5 @@
 import { type Address, type Hex } from "viem";
-import { type SafeCreation } from "./safe.js";
+import { readBoundedSafeNonce, type SafeCreation } from "./safe.js";
 /**
  * Safe's per-chain app URL prefix. Wider than {@link SAFE_SERVICE_PREFIX}:
  * Safe app links work on chains without a hosted transaction service.
@@ -287,6 +287,157 @@ export declare function safeExecutionResult(receipt: {
 }, safe: Address, hash: Hex): SafeExecutionResult;
 /** Throws unless `receipt` proves the Safe transaction `hash` ran and succeeded ({@link safeExecutionResult}). */
 export declare function requireSafeExecutionSuccess(receipt: Parameters<typeof safeExecutionResult>[0], safe: Address, hash: Hex): void;
+/** What a Safe app flow says when it cannot confirm its proposal ran. */
+export declare const SAFE_PROPOSAL_UNCONFIRMED = "Safe proposal submitted, but confirmation is unavailable. Check Safe before taking another action.";
+/** What a Safe app flow says while its proposal waits for the Safe's other signers. */
+export declare const SAFE_PROPOSAL_AWAITING = "Proposed to your Safe. Its other signers can approve it there.";
+/** A call a Safe app proposal was reviewed to run. */
+export type SafeAppCall = {
+    to: Address;
+    data: Hex;
+    value?: bigint;
+};
+/** A reviewed call whose wei value may be persisted as a decimal string. */
+export type ReviewedSafeCall = Omit<SafeAppCall, "value"> & {
+    value?: bigint | string;
+};
+type SafeAppExecution = {
+    /** Reads the execution's transaction, which only an execution returned at once needs. */
+    client: {
+        getTransaction(args: {
+            hash: Hex;
+        }): Promise<{
+            to?: Address | null;
+            input?: Hex;
+        }>;
+    };
+    receipt: Parameters<typeof safeExecutionResult>[0];
+    safe: Address;
+    /** What the wallet returned: the safeTxHash, or the execution's own hash when Safe{Wallet} executed at once. */
+    proposalHash: Hex;
+    /** What the proposal was reviewed to run: one call, or a batch in order. */
+    calls: readonly ReviewedSafeCall[];
+    /** Whether a recognized MultiSendCallOnly batch may run the calls. */
+    batch?: boolean;
+};
+/**
+ * Whether the Safe transaction runs exactly the reviewed calls: one CALL,
+ * or, when `batch` permits it, a zero-value MultiSendCallOnly DELEGATECALL
+ * running every call in order. Persisted decimal values compare in wei.
+ */
+export declare function safeTransactionRunsCalls(tx: {
+    to: Address;
+    value: bigint;
+    data: Hex;
+    operation: number;
+}, calls: readonly ReviewedSafeCall[], batch?: boolean): boolean;
+/** Whether a transaction calls `safe`'s execTransaction of exactly the reviewed calls. */
+export declare function safeExecutionRunsCalls(transaction: {
+    to?: Address | null;
+    input?: Hex;
+}, safe: Address, calls: readonly ReviewedSafeCall[], batch?: boolean): boolean;
+/**
+ * What the execution's receipt proves about the proposal a Safe app returned
+ * ({@link safeExecutionResult}). When Safe{Wallet} executed it at once, the
+ * reply is the execution's own hash and the SDK takes the Safe's one
+ * execution event in that receipt whatever its safeTxHash, so the execution
+ * must also be the Safe's execTransaction of exactly the reviewed calls, or
+ * the result is unproven.
+ */
+export declare function readSafeAppExecution({ client, receipt, safe, proposalHash, calls, batch, }: SafeAppExecution): Promise<SafeExecutionResult>;
+/**
+ * Throws unless the execution proves the Safe ran the reviewed proposal and
+ * its call succeeded ({@link readSafeAppExecution}): `failure` when the Safe
+ * ran it and it failed, and SAFE_PROPOSAL_UNCONFIRMED when it does not show
+ * this proposal ran.
+ */
+export declare function requireSafeProposalSuccess(execution: SafeAppExecution, failure: string): Promise<void>;
+/**
+ * The call a Safe proposal of `call` holds: `call` with the field it is
+ * stamped with at send time zeroed, so the same action sent again with a later
+ * stamp is the action the proposal already holds. Any other call is held
+ * exactly as sent.
+ */
+export declare function heldCall(call: SafeAppCall): SafeAppCall;
+/** The deadline after which the contract refuses `call`, or null for a call without one. */
+export declare function stampedDeadline(call: SafeAppCall): bigint | null;
+/** A chain client that reads the Safe's nonce and the latest block. */
+type SafeQueueClient = Parameters<typeof readBoundedSafeNonce>[0] & {
+    getBlock(): Promise<{
+        number: bigint | null;
+        timestamp: bigint;
+    }>;
+};
+/**
+ * A pending proposal of the action `call` makes in `safe`'s queue (its
+ * service record, its safeTxHash and the call it runs), read from Safe's
+ * service from the Safe's nonce in the latest block, or null: a Safe app
+ * never proposes an action that is already queued, whoever queued it,
+ * whatever its stamp ({@link heldCall}). A queued call the contract refuses
+ * once its deadline passed is passed over when that block is past the
+ * deadline: it can no longer run. Throws when the block, the nonce or the
+ * queue can't be read.
+ */
+export declare function findPendingSafeAppProposal(client: SafeQueueClient, chainId: number, safe: Address, call: SafeAppCall, service?: SafeServiceOptions): Promise<{
+    tx: SafeQueuedTransaction;
+    proposalHash: Hex;
+    call: SafeAppCall;
+} | null>;
+/**
+ * What one look at a proposal awaiting its signers finds:
+ *
+ * - `expired`: the latest block is past its deadline and the Safe's nonce in
+ *   that block is not past the proposal's, so it never ran, and the contract
+ *   refuses it in any later block;
+ * - `passed`: the Safe's nonce is past the proposal's and Safe's service lists
+ *   no execution of it: another transaction took its nonce, or the service has
+ *   yet to list its own execution;
+ * - `live`: it can still run, it ran, or the look could not tell.
+ */
+export type SafeProposalLook = "expired" | "passed" | "live";
+/**
+ * One look at `safe`'s proposal `proposalHash`: the latest block, the Safe's
+ * nonce in that block, and Safe's authenticated record of the proposal. A read
+ * that fails makes the look live.
+ */
+export declare function lookAtSafeProposal(client: SafeQueueClient, chainId: number, safe: Address, proposalHash: Hex, service?: SafeServiceOptions): Promise<SafeProposalLook>;
+/**
+ * Watches a proposal awaiting its signers, one {@link lookAtSafeProposal} a
+ * minute, until `signal` aborts. It ends `expired` at the first look that
+ * finds it expired, and `replaced` once looks in a row have found it passed
+ * for ten minutes: one such look proves nothing, since Safe's service may list
+ * the proposal's own execution later. Any other look starts that count again.
+ */
+export declare function watchSafeProposal(client: SafeQueueClient, chainId: number, safe: Address, proposalHash: Hex, signal: AbortSignal, service?: SafeServiceOptions): Promise<"expired" | "replaced">;
+/**
+ * The transaction `hash` names on the chain, or null: Safe{Wallet} replies
+ * with the execution's own hash when the owner executes at once, and the node
+ * may learn it a moment later. It looks up to 5 times, 2 seconds apart (8
+ * seconds at most), before the reply counts as a proposal.
+ */
+export declare function atOnceExecution<T>(client: {
+    getTransaction(args: {
+        hash: Hex;
+    }): Promise<T>;
+}, hash: Hex): Promise<T | null>;
+/**
+ * The chain's last word before a proposal ends unproven: what `read` returns,
+ * or null when the chain says there is none (viem's transaction or receipt
+ * not-found). A node that can't answer says nothing, so it is asked again a
+ * minute later, for as long as it takes, with `onRetry` called first. With
+ * `exists`, the chain already proved the thing exists (its receipt is in
+ * hand), so a not-found only says the node is behind, and is asked again too.
+ */
+export declare function chainAnswer<T>(read: () => Promise<T>, { exists, onRetry }?: {
+    exists?: boolean;
+    onRetry?: () => void;
+}): Promise<T | null>;
+/**
+ * The execution Safe's authenticated record names for `safeTxHash` when
+ * `error` is its service's report that the proposal ran and failed, or null.
+ * Only that execution's receipt decides the proposal, never the report alone.
+ */
+export declare function reportedSafeExecution(error: unknown, chainId: number, safe: Address, safeTxHash: Hex, service?: SafeServiceOptions): Promise<Hex | null>;
 /**
  * The confirmations of `tx` that count: one per current owner in `owners`,
  * with a well-formed signature or none (an onchain approval), a signature

package/dist/cjs/safeService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"safeService.d.ts","sourceRoot":"","sources":["../../src/safeService.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,OAAO,EACZ,KAAK,GAAG,EACT,MAAM,MAAM,CAAC;AACd,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,WAAW,CAAC;AAInB;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASvD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO/D,CAAC;AAEF;6EAC6E;AAC7E,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW9D;AAED,eAAO,MAAM,mBAAmB,uJACiH,CAAC;AAUlJ,uEAAuE;AACvE,wBAAgB,YAAY,CAC1B,MAAM,EAAE,OAAO,EACf,KAAK,GAAE,MAAmB,GACzB,MAAM,CAKR;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAK1E;AAeD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAMjE;AAQD,uDAAuD;AACvD,KAAK,mBAAmB,GAAG;IACzB,cAAc,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,GAAG,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3D,CAAC;AA8DF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,GAAG,EACf,OAAO,GAAE;IACP,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,mBAAmB,CAAC;CACzB,GACL,OAAO,CAAC,GAAG,CAAC,CA+Ed;AAID,sEAAsE;AACtE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAahB,CAAC;AAEX,iFAAiF;AACjF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4ChB,CAAC;AAEX,oFAAoF;AACpF,MAAM,MAAM,gBAAgB,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,GAAG,GAAG,IAAI,CAAA;CAAE,CAAC;AAE1E;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAChC,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACnC,mFAAmF;IACnF,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,mFAAmF;IACnF,cAAc,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,uBAAuB,CAAC,EAAE,GAAG,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,kDAAkD;AAClD,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,GAAG,CAAC;IACV,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AA8BF;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,qBAAqB,GACxB,sBAAsB,CA0BxB;AAgBD,0EAA0E;AAC1E,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,EACb,EAAE,EAAE,qBAAqB,GACxB,GAAG,CAUL;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,EACb,EAAE,EAAE,qBAAqB,EACzB,QAAQ,CAAC,EAAE,GAAG,GACb,GAAG,CA0CL;AAYD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AA0C3C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE;IACP,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC3B,EACD,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,GAAG,GACR,mBAAmB,CAsDrB;AAED,kHAAkH;AAClH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAClD,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,GAAG,GACR,IAAI,CAcN;AAkED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,IAAI,CAAC,qBAAqB,EAAE,eAAe,CAAC,EAChD,MAAM,EAAE,SAAS,OAAO,EAAE,GACzB,gBAAgB,EAAE,CA4BpB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,IAAI,CAAC,qBAAqB,EAAE,eAAe,CAAC,EAChD,MAAM,EAAE,SAAS,OAAO,EAAE,GACzB,GAAG,CAmBL;AAED,gGAAgG;AAChG,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,qBAAqB,EACzB,MAAM,EAAE,SAAS,OAAO,EAAE,+HAe3B;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,qBAAqB,GAAG,OAAO,CAE3E;AAID,mFAAmF;AACnF,wBAAgB,eAAe,CAC7B,IAAI,EAAE;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAChD,KAAK,EAAE,MAAM,GACZ,qBAAqB,CAgBvB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EAC5D,KAAK,EAAE,MAAM,GACZ,qBAAqB,CAQvB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,qBAAqB,EACzB,IAAI,EAAE;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;CAAE,GAClE,OAAO,CAoBT;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,SAAS,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC,EAAE,GACvD,MAAM,CAKR;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,OAAO,EACP,QAAQ,EACR,SAAS,GACV,EAAE;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,mFAAmF;IACnF,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB,GACG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,EAAE,CAAA;CAAE,CAQ1C;AAID;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,sHAAsH;AACtH,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAMrD,mGAAmG;AACnG,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,sDAAsD;AACtD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,GAAG,GACd,MAAM,GAAG,IAAI,CAMf;AAgGD;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAsDlC;AAED,kHAAkH;AAClH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC,CAAC,CAAC,EACtD,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAQvC;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,GAAG,EACf,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CA4BhC;AA+BD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,EACb,EAAE,EAAE,qBAAqB,EACzB,EACE,MAAM,EACN,SAAS,EACT,MAAM,GACP,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACtD,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,GAAG,CAAC,CA8Bd;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,EACb,EAAE,EAAE,qBAAqB,EACzB,SAAS,EAAE,GAAG,EACd,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CASf;AAKD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,EAAE,CAAC,CA8B/C;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI5E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,GACf,YAAY,GAAG,IAAI,CAwBrB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,OAAO,EACb,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAa9B"}
+{"version":3,"file":"safeService.d.ts","sourceRoot":"","sources":["../../src/safeService.ts"],"names":[],"mappings":"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"}

package/dist/cjs/safeService.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SAFE_SERVICE_MAX_RETRY_WAIT_MS = exports.SAFE_EXEC_ABI = exports.SAFE_TX_TYPES = exports.SAFE_NONCE_GUIDANCE = exports.SAFE_SERVICE_PREFIX = exports.SAFE_PREFIX = void 0;
+exports.SAFE_SERVICE_MAX_RETRY_WAIT_MS = exports.SAFE_PROPOSAL_AWAITING = exports.SAFE_PROPOSAL_UNCONFIRMED = exports.SAFE_EXEC_ABI = exports.SAFE_TX_TYPES = exports.SAFE_NONCE_GUIDANCE = exports.SAFE_SERVICE_PREFIX = exports.SAFE_PREFIX = void 0;
 exports.safeServiceBase = safeServiceBase;
 exports.swapDeadline = swapDeadline;
 exports.safeQueueUrl = safeQueueUrl;
@@ -11,6 +11,18 @@ exports.safeTransactionHash = safeTransactionHash;
 exports.canonicalSafeTxHash = canonicalSafeTxHash;
 exports.safeExecutionResult = safeExecutionResult;
 exports.requireSafeExecutionSuccess = requireSafeExecutionSuccess;
+exports.safeTransactionRunsCalls = safeTransactionRunsCalls;
+exports.safeExecutionRunsCalls = safeExecutionRunsCalls;
+exports.readSafeAppExecution = readSafeAppExecution;
+exports.requireSafeProposalSuccess = requireSafeProposalSuccess;
+exports.heldCall = heldCall;
+exports.stampedDeadline = stampedDeadline;
+exports.findPendingSafeAppProposal = findPendingSafeAppProposal;
+exports.lookAtSafeProposal = lookAtSafeProposal;
+exports.watchSafeProposal = watchSafeProposal;
+exports.atOnceExecution = atOnceExecution;
+exports.chainAnswer = chainAnswer;
+exports.reportedSafeExecution = reportedSafeExecution;
 exports.usableSafeConfirmations = usableSafeConfirmations;
 exports.safeExecutionSignatures = safeExecutionSignatures;
 exports.safeExecutionArgs = safeExecutionArgs;
@@ -560,6 +572,318 @@ function requireSafeExecutionSuccess(receipt, safe, hash) {
     }
     throw new Error(result.reason);
 }
+/** What a Safe app flow says when it cannot confirm its proposal ran. */
+exports.SAFE_PROPOSAL_UNCONFIRMED = "Safe proposal submitted, but confirmation is unavailable. Check Safe before taking another action.";
+/** What a Safe app flow says while its proposal waits for the Safe's other signers. */
+exports.SAFE_PROPOSAL_AWAITING = "Proposed to your Safe. Its other signers can approve it there.";
+/**
+ * Whether the Safe transaction runs exactly the reviewed calls: one CALL,
+ * or, when `batch` permits it, a zero-value MultiSendCallOnly DELEGATECALL
+ * running every call in order. Persisted decimal values compare in wei.
+ */
+function safeTransactionRunsCalls(tx, calls, batch = true) {
+    if (calls.length === 1 && tx.operation === 0 && sameCall(calls[0], tx))
+        return true;
+    if (!batch || tx.value !== 0n)
+        return false;
+    const inner = (0, safe_js_1.multiSendCallsOf)(tx);
+    return (!!inner &&
+        inner.length === calls.length &&
+        inner.every((call, index) => sameCall(calls[index], call)));
+}
+/** Whether a transaction calls `safe`'s execTransaction of exactly the reviewed calls. */
+function safeExecutionRunsCalls(transaction, safe, calls, batch = true) {
+    if (!transaction.to ||
+        !transaction.input ||
+        !(0, viem_1.isAddressEqual)(transaction.to, safe))
+        return false;
+    let decoded;
+    try {
+        decoded = (0, viem_1.decodeFunctionData)({
+            abi: exports.SAFE_EXEC_ABI,
+            data: transaction.input,
+        });
+    }
+    catch {
+        return false;
+    }
+    if (decoded.functionName !== "execTransaction")
+        return false;
+    const [to, value, data, operation] = decoded.args;
+    return safeTransactionRunsCalls({ to, value, data, operation }, calls, batch);
+}
+/**
+ * What the execution's receipt proves about the proposal a Safe app returned
+ * ({@link safeExecutionResult}). When Safe{Wallet} executed it at once, the
+ * reply is the execution's own hash and the SDK takes the Safe's one
+ * execution event in that receipt whatever its safeTxHash, so the execution
+ * must also be the Safe's execTransaction of exactly the reviewed calls, or
+ * the result is unproven.
+ */
+async function readSafeAppExecution({ client, receipt, safe, proposalHash, calls, batch = true, }) {
+    const result = safeExecutionResult(receipt, safe, proposalHash);
+    const atOnce = typeof receipt.transactionHash === "string" &&
+        receipt.transactionHash.toLowerCase() === proposalHash.toLowerCase();
+    if (!atOnce || (result.status !== "success" && result.status !== "failed")) {
+        return result;
+    }
+    const transaction = await client
+        .getTransaction({ hash: proposalHash })
+        .catch(() => null);
+    return transaction && safeExecutionRunsCalls(transaction, safe, calls, batch)
+        ? result
+        : {
+            status: "unproven",
+            reason: `Transaction ${proposalHash} is not Safe ${safe}'s execution of the reviewed call.`,
+        };
+}
+/**
+ * Throws unless the execution proves the Safe ran the reviewed proposal and
+ * its call succeeded ({@link readSafeAppExecution}): `failure` when the Safe
+ * ran it and it failed, and SAFE_PROPOSAL_UNCONFIRMED when it does not show
+ * this proposal ran.
+ */
+async function requireSafeProposalSuccess(execution, failure) {
+    const { status } = await readSafeAppExecution(execution);
+    if (status === "unproven")
+        throw new Error(exports.SAFE_PROPOSAL_UNCONFIRMED);
+    if (status !== "success")
+        throw new Error(failure);
+}
+/**
+ * The calls this app stamps with a field at send time, by selector: the
+ * stamp's argument, and whether the contract refuses the call once the chain
+ * passes it. Universal Router's `execute` and PositionManager's
+ * `modifyLiquidities` check a deadline; the expiration Permit2's `approve`
+ * sets only bounds the allowance it grants.
+ */
+const STAMPED_CALLS = {
+    // execute(bytes commands, bytes[] inputs, uint256 deadline)
+    "0x3593564c": {
+        params: [{ type: "bytes" }, { type: "bytes[]" }, { type: "uint256" }],
+        stamp: 2,
+        reverts: true,
+    },
+    // modifyLiquidities(bytes unlockData, uint256 deadline)
+    "0xdd46508f": {
+        params: [{ type: "bytes" }, { type: "uint256" }],
+        stamp: 1,
+        reverts: true,
+    },
+    // approve(address token, address spender, uint160 amount, uint48 expiration)
+    "0x87517c45": {
+        params: [
+            { type: "address" },
+            { type: "address" },
+            { type: "uint160" },
+            { type: "uint48" },
+        ],
+        stamp: 3,
+        reverts: false,
+    },
+};
+/** A stamped call's shape and arguments, when its data is exactly their ABI encoding. */
+function stampedArgs(call) {
+    const shape = STAMPED_CALLS[call.data.slice(0, 10).toLowerCase()];
+    if (!shape)
+        return null;
+    const encoded = `0x${call.data.slice(10)}`;
+    try {
+        const args = (0, viem_1.decodeAbiParameters)(shape.params, encoded);
+        // Any other encoding of the same arguments is held exactly as sent.
+        return (0, viem_1.encodeAbiParameters)(shape.params, args).toLowerCase() ===
+            encoded.toLowerCase()
+            ? { shape, args }
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The call a Safe proposal of `call` holds: `call` with the field it is
+ * stamped with at send time zeroed, so the same action sent again with a later
+ * stamp is the action the proposal already holds. Any other call is held
+ * exactly as sent.
+ */
+function heldCall(call) {
+    const stamped = stampedArgs(call);
+    if (!stamped)
+        return call;
+    const args = [...stamped.args];
+    args[stamped.shape.stamp] = 0n;
+    return {
+        ...call,
+        data: `${call.data.slice(0, 10)}${(0, viem_1.encodeAbiParameters)(stamped.shape.params, args).slice(2)}`,
+    };
+}
+/** The deadline after which the contract refuses `call`, or null for a call without one. */
+function stampedDeadline(call) {
+    const stamped = stampedArgs(call);
+    return stamped?.shape.reverts
+        ? BigInt(stamped.args[stamped.shape.stamp])
+        : null;
+}
+function sameCall(a, b) {
+    return ((0, viem_1.isAddressEqual)(a.to, b.to) &&
+        BigInt(a.value ?? 0n) === BigInt(b.value ?? 0n) &&
+        a.data.toLowerCase() === b.data.toLowerCase());
+}
+/** A Safe app proposal's one call, or null for any other Safe transaction. */
+function proposedCall(tx) {
+    // Both callers have authenticated the record through the service reader.
+    const { to, data, value } = safeTransactionMessage(tx);
+    // A zero-refund CALL, as a Safe app proposes it.
+    return safeTransactionMatchesCall(tx, { to, data, value })
+        ? { to, data, value }
+        : null;
+}
+/**
+ * A pending proposal of the action `call` makes in `safe`'s queue (its
+ * service record, its safeTxHash and the call it runs), read from Safe's
+ * service from the Safe's nonce in the latest block, or null: a Safe app
+ * never proposes an action that is already queued, whoever queued it,
+ * whatever its stamp ({@link heldCall}). A queued call the contract refuses
+ * once its deadline passed is passed over when that block is past the
+ * deadline: it can no longer run. Throws when the block, the nonce or the
+ * queue can't be read.
+ */
+async function findPendingSafeAppProposal(client, chainId, safe, call, service) {
+    // One block's view: its time, and the Safe's nonce in it. A proposal listed
+    // from that nonce had not run by that block, so a deadline already past then
+    // proves it never will.
+    const block = await client.getBlock();
+    const nonce = await (0, safe_js_1.readBoundedSafeNonce)(client, safe, {
+        blockNumber: block.number ?? undefined,
+    }).catch(() => null);
+    if (nonce === null || nonce > BigInt(Number.MAX_SAFE_INTEGER)) {
+        throw new Error("Could not read the Safe nonce.");
+    }
+    const held = heldCall(call);
+    const queued = (await listPendingSafeTransactions(chainId, safe, Number(nonce), service)).flatMap((tx) => {
+        const proposed = proposedCall(tx);
+        return proposed && sameCall(heldCall(proposed), held)
+            ? [{ tx, call: proposed, deadline: stampedDeadline(proposed) }]
+            : [];
+    });
+    const live = queued.find(({ deadline }) => deadline === null || deadline >= block.timestamp);
+    return live
+        ? {
+            tx: live.tx,
+            proposalHash: canonicalSafeTxHash(chainId, safe, live.tx),
+            call: live.call,
+        }
+        : null;
+}
+/**
+ * One look at `safe`'s proposal `proposalHash`: the latest block, the Safe's
+ * nonce in that block, and Safe's authenticated record of the proposal. A read
+ * that fails makes the look live.
+ */
+async function lookAtSafeProposal(client, chainId, safe, proposalHash, service) {
+    try {
+        const block = await client.getBlock();
+        const nonce = await (0, safe_js_1.readBoundedSafeNonce)(client, safe, {
+            blockNumber: block.number ?? undefined,
+        });
+        const record = await readSafeTransaction(chainId, safe, proposalHash, service);
+        if (nonce === null || record.isExecuted)
+            return "live";
+        if (nonce > safeTransactionMessage(record).nonce)
+            return "passed";
+        const call = proposedCall(record);
+        const deadline = call && stampedDeadline(call);
+        return deadline !== null && block.timestamp > deadline ? "expired" : "live";
+    }
+    catch {
+        return "live";
+    }
+}
+/** A watch looks at its proposal once a minute, so it reads the Safe's nonce at most that often. */
+const SAFE_LOOK_MS = 60_000;
+/** How long looks in a row must find the Safe past a proposal before it counts as replaced. */
+const SAFE_REPLACED_AFTER_MS = 10 * 60_000;
+/**
+ * Watches a proposal awaiting its signers, one {@link lookAtSafeProposal} a
+ * minute, until `signal` aborts. It ends `expired` at the first look that
+ * finds it expired, and `replaced` once looks in a row have found it passed
+ * for ten minutes: one such look proves nothing, since Safe's service may list
+ * the proposal's own execution later. Any other look starts that count again.
+ */
+async function watchSafeProposal(client, chainId, safe, proposalHash, signal, service) {
+    let passedSince = null;
+    for (;;) {
+        await (0, pause_js_1.pause)(SAFE_LOOK_MS, signal, waitAborted);
+        const look = await lookAtSafeProposal(client, chainId, safe, proposalHash, service);
+        if (look === "expired")
+            return look;
+        passedSince = look === "passed" ? (passedSince ?? Date.now()) : null;
+        if (passedSince !== null &&
+            Date.now() - passedSince >= SAFE_REPLACED_AFTER_MS)
+            return "replaced";
+    }
+}
+/** Looks at the chain for an execution returned at once, and the pause between them. */
+const AT_ONCE_LOOKS = 5;
+const AT_ONCE_LOOK_MS = 2_000;
+/**
+ * The transaction `hash` names on the chain, or null: Safe{Wallet} replies
+ * with the execution's own hash when the owner executes at once, and the node
+ * may learn it a moment later. It looks up to 5 times, 2 seconds apart (8
+ * seconds at most), before the reply counts as a proposal.
+ */
+async function atOnceExecution(client, hash) {
+    for (let look = 1; look <= AT_ONCE_LOOKS; look += 1) {
+        try {
+            return await client.getTransaction({ hash });
+        }
+        catch {
+            if (look < AT_ONCE_LOOKS) {
+                await (0, pause_js_1.pause)(AT_ONCE_LOOK_MS, undefined, waitAborted);
+            }
+        }
+    }
+    return null;
+}
+/**
+ * The chain's last word before a proposal ends unproven: what `read` returns,
+ * or null when the chain says there is none (viem's transaction or receipt
+ * not-found). A node that can't answer says nothing, so it is asked again a
+ * minute later, for as long as it takes, with `onRetry` called first. With
+ * `exists`, the chain already proved the thing exists (its receipt is in
+ * hand), so a not-found only says the node is behind, and is asked again too.
+ */
+async function chainAnswer(read, { exists = false, onRetry } = {}) {
+    for (;;) {
+        try {
+            return await read();
+        }
+        catch (error) {
+            const notFound = error instanceof viem_1.TransactionNotFoundError ||
+                error instanceof viem_1.TransactionReceiptNotFoundError;
+            if (notFound && !exists)
+                return null;
+        }
+        onRetry?.();
+        await (0, pause_js_1.pause)(SAFE_LOOK_MS, undefined, waitAborted);
+    }
+}
+/**
+ * The execution Safe's authenticated record names for `safeTxHash` when
+ * `error` is its service's report that the proposal ran and failed, or null.
+ * Only that execution's receipt decides the proposal, never the report alone.
+ */
+async function reportedSafeExecution(error, chainId, safe, safeTxHash, service) {
+    if (!(error instanceof Error) ||
+        !/executed the proposal.*failed/i.test(error.message))
+        return null;
+    const record = await readSafeTransaction(chainId, safe, safeTxHash, service).catch(() => null);
+    const hash = record
+        ?.transactionHash;
+    return typeof hash === "string" && /^0x[0-9a-fA-F]{64}$/u.test(hash)
+        ? hash
+        : null;
+}
 // ── Signatures ───────────────────────────────────────────────────────────────
 /**
  * One confirmation's part of Safe's `signatures` bytes, without 0x: