@prb/effect-evm-safe 1.0.1 → 1.1.1

package/CHANGELOG.md

@@ -6,6 +6,27 @@ The format is based on [Common Changelog](https://common-changelog.org/).
 
 [1.0.0]: https://github.com/PaulRBerg/prb-effect/releases/tag/%40prb%2Feffect-evm-safe%401.0.0
 [1.0.1]: https://github.com/PaulRBerg/prb-effect/releases/tag/%40prb%2Feffect-evm-safe%401.0.1
+[1.1.0]: https://github.com/PaulRBerg/prb-effect/releases/tag/%40prb%2Feffect-evm-safe%401.1.0
+[1.1.1]: https://github.com/PaulRBerg/prb-effect/releases/tag/%40prb%2Feffect-evm-safe%401.1.1
+
+## [1.1.1] - 2026-02-10
+
+### Changed
+
+- Preserve Safe SDK submission cause details (including nested `cause` and user-rejection `4001`) so
+  `SafeMultisigTxSubmissionError` and batch write failures no longer collapse to generic messages
+
+## [1.1.0] - 2026-02-10
+
+### Added
+
+- Add `safeMultisigBatchWrite` for atomic multi-transaction Safe batches via MultiSend
+- Add `safeMultisigAllowAndWrite` for ERC-20 approve + action as a single Safe proposal
+- Add `buildSafeApproveTx` helper to encode ERC-20 approve calls as Safe transactions
+- Add `waitForSafeMultisigTx` to poll Safe transaction lifecycle until terminal state or timeout
+- Add `getSafeMultisigTxStatus` for one-shot Safe transaction status checks
+- Add `SafeMultiSendUnavailableError` for chains without MultiSend contract
+- Add `isMultiSendUnavailableError` detector with depth-limited cause chain traversal
 
 ## [1.0.1] - 2026-02-09
 

package/dist/safe/allowance.d.ts

@@ -0,0 +1,20 @@
+import { Effect } from "effect";
+import type { Address } from "viem";
+import type { SafeMultisigTx } from "./types.js";
+export type SafeMultisigAllowAndWriteParams = {
+    readonly mainTransaction: SafeMultisigTx;
+    readonly spender: Address;
+    readonly token: {
+        readonly address: Address;
+        readonly chainId: number;
+    };
+    readonly amount: bigint;
+};
+export type SafeMultisigApproveTxParams = {
+    readonly amount: bigint;
+    readonly spender: Address;
+    readonly tokenAddress: Address;
+};
+export declare function buildSafeApproveTx(params: SafeMultisigApproveTxParams): SafeMultisigTx;
+export declare const safeMultisigAllowAndWrite: (params: SafeMultisigAllowAndWriteParams) => Effect.Effect<`0x${string}`, import("./errors.js").SafeMultisigTxSubmissionError | import("./errors.js").SafeMultiSendUnavailableError, import("./service.js").SafeAppsService>;
+//# sourceMappingURL=allowance.d.ts.map

package/dist/safe/allowance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowance.d.ts","sourceRoot":"","sources":["../../src/safe/allowance.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAOjD,MAAM,MAAM,+BAA+B,GAAG;IAE5C,QAAQ,CAAC,eAAe,EAAE,cAAc,CAAC;IAEzC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;IAEF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAGF,MAAM,MAAM,2BAA2B,GAAG;IAExC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC,CAAC;AASF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,2BAA2B,GAAG,cAAc,CAUtF;AAgBD,eAAO,MAAM,yBAAyB,8NAapC,CAAC"}

package/dist/safe/allowance.js

@@ -0,0 +1,22 @@
+import { Effect } from "effect";
+import { encodeFunctionData, erc20Abi } from "viem";
+import { safeMultisigBatchWrite } from "./batch.js";
+export function buildSafeApproveTx(params) {
+    const { amount, spender, tokenAddress } = params;
+    const data = encodeFunctionData({
+        abi: erc20Abi,
+        args: [spender, amount],
+        functionName: "approve",
+    });
+    return { data, to: tokenAddress, value: 0n };
+}
+export const safeMultisigAllowAndWrite = Effect.fn("safeMultisigAllowAndWrite")(function* (params) {
+    const { amount, mainTransaction, spender, token } = params;
+    const approveTx = buildSafeApproveTx({
+        amount,
+        spender,
+        tokenAddress: token.address,
+    });
+    return yield* safeMultisigBatchWrite([approveTx, mainTransaction], token.chainId);
+});
+//# sourceMappingURL=allowance.js.map

package/dist/safe/allowance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowance.js","sourceRoot":"","sources":["../../src/safe/allowance.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAuCpD,MAAM,UAAU,kBAAkB,CAAC,MAAmC;IACpE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAEjD,MAAM,IAAI,GAAG,kBAAkB,CAAC;QAC9B,GAAG,EAAE,QAAQ;QACb,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,SAAS;KACxB,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAC/C,CAAC;AAgBD,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,EAAE,CAAC,2BAA2B,CAAC,CAAC,QAAQ,CAAC,EACvF,MAAuC;IAEvC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAE3D,MAAM,SAAS,GAAG,kBAAkB,CAAC;QACnC,MAAM;QACN,OAAO;QACP,YAAY,EAAE,KAAK,CAAC,OAAO;KAC5B,CAAC,CAAC;IAGH,OAAO,KAAK,CAAC,CAAC,sBAAsB,CAAC,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;AACpF,CAAC,CAAC,CAAC","sourcesContent":["/**\n * Safe multisig allowance batching.\n *\n * Prepends an ERC-20 approve() tx to a main tx and submits both as a\n * single atomic Safe batch. Every dApp doing token operations through\n * Safe needs this \"approve + action\" pattern.\n *\n * @module safe/allowance\n */\n\nimport { Effect } from \"effect\";\nimport type { Address } from \"viem\";\nimport { encodeFunctionData, erc20Abi } from \"viem\";\nimport { safeMultisigBatchWrite } from \"./batch.js\";\nimport type { SafeMultisigTx } from \"./types.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Parameters for Safe multisig allowance batching. */\nexport type SafeMultisigAllowAndWriteParams = {\n  /** Main transaction to execute after approval. */\n  readonly mainTransaction: SafeMultisigTx;\n  /** Spender contract that needs the allowance. */\n  readonly spender: Address;\n  /** Token to approve. */\n  readonly token: {\n    readonly address: Address;\n    readonly chainId: number;\n  };\n  /** Approval amount (e.g. MaxUint256 or a computed amount). */\n  readonly amount: bigint;\n};\n\n/** Parameters for building a standalone ERC-20 approve tx. */\nexport type SafeMultisigApproveTxParams = {\n  /** Approval amount. */\n  readonly amount: bigint;\n  /** Spender contract that needs the allowance. */\n  readonly spender: Address;\n  /** Token contract address. */\n  readonly tokenAddress: Address;\n};\n\n// ---------------------------------------------------------------------------\n// buildSafeApproveTx\n// ---------------------------------------------------------------------------\n\n/**\n * Encode an ERC-20 `approve(spender, amount)` call as a Safe transaction.\n */\nexport function buildSafeApproveTx(params: SafeMultisigApproveTxParams): SafeMultisigTx {\n  const { amount, spender, tokenAddress } = params;\n\n  const data = encodeFunctionData({\n    abi: erc20Abi,\n    args: [spender, amount],\n    functionName: \"approve\",\n  });\n\n  return { data, to: tokenAddress, value: 0n };\n}\n\n// ---------------------------------------------------------------------------\n// safeMultisigAllowAndWrite\n// ---------------------------------------------------------------------------\n\n/**\n * Batch an ERC-20 approve tx with a main tx as a single Safe proposal.\n *\n * Approve is placed first so the allowance is set before the main contract\n * interaction. Both execute atomically — Safe users sign once.\n *\n * On chains where MultiSend is not deployed, fails with\n * `SafeMultiSendUnavailableError`. Callers should catch that tag and fall\n * back to sequential approve → action flow.\n */\nexport const safeMultisigAllowAndWrite = Effect.fn(\"safeMultisigAllowAndWrite\")(function* (\n  params: SafeMultisigAllowAndWriteParams\n) {\n  const { amount, mainTransaction, spender, token } = params;\n\n  const approveTx = buildSafeApproveTx({\n    amount,\n    spender,\n    tokenAddress: token.address,\n  });\n\n  // Approve first, then main transaction\n  return yield* safeMultisigBatchWrite([approveTx, mainTransaction], token.chainId);\n});\n"]}

package/dist/safe/batch.d.ts

@@ -0,0 +1,6 @@
+import { Effect } from "effect";
+import { SafeMultiSendUnavailableError, SafeMultisigTxSubmissionError } from "./errors.js";
+import { SafeAppsService } from "./service.js";
+import type { SafeMultisigTx } from "./types.js";
+export declare const safeMultisigBatchWrite: (transactions: readonly [SafeMultisigTx, ...SafeMultisigTx[]], chainId?: number | undefined) => Effect.Effect<`0x${string}`, SafeMultisigTxSubmissionError | SafeMultiSendUnavailableError, SafeAppsService>;
+//# sourceMappingURL=batch.d.ts.map

package/dist/safe/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/safe/batch.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAGL,6BAA6B,EAC7B,6BAA6B,EAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAWjD,eAAO,MAAM,sBAAsB,8MA2BjC,CAAC"}

package/dist/safe/batch.js

@@ -0,0 +1,25 @@
+import { Effect } from "effect";
+import { getSafeErrorMessage, isMultiSendUnavailableError, SafeMultiSendUnavailableError, SafeMultisigTxSubmissionError, } from "./errors.js";
+import { SafeAppsService } from "./service.js";
+export const safeMultisigBatchWrite = Effect.fn("safeMultisigBatchWrite")(function* (transactions, chainId) {
+    const safeApps = yield* SafeAppsService;
+    const result = yield* safeApps.sendTxs(transactions).pipe(Effect.mapError((error) => {
+        if (isMultiSendUnavailableError(error)) {
+            return new SafeMultiSendUnavailableError({
+                cause: error,
+                chainId,
+                message: `MultiSend contract not available on chain ${chainId ?? "unknown"}`,
+            });
+        }
+        if (error instanceof SafeMultisigTxSubmissionError) {
+            return error;
+        }
+        const detail = getSafeErrorMessage(error);
+        return new SafeMultisigTxSubmissionError({
+            cause: error,
+            message: detail ? `Safe batch write failed: ${detail}` : "Safe batch write failed",
+        });
+    }));
+    return result.safeTxHash;
+});
+//# sourceMappingURL=batch.js.map

package/dist/safe/batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.js","sourceRoot":"","sources":["../../src/safe/batch.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAY/C,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC,QAAQ,CAAC,EACjF,YAA4D,EAC5D,OAAgB;IAEhB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC;IACxC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CACvD,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE;QACxB,IAAI,2BAA2B,CAAC,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO,IAAI,6BAA6B,CAAC;gBACvC,KAAK,EAAE,KAAK;gBACZ,OAAO;gBACP,OAAO,EAAE,6CAA6C,OAAO,IAAI,SAAS,EAAE;aAC7E,CAAC,CAAC;QACL,CAAC;QAED,IAAI,KAAK,YAAY,6BAA6B,EAAE,CAAC;YACnD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO,IAAI,6BAA6B,CAAC;YACvC,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,4BAA4B,MAAM,EAAE,CAAC,CAAC,CAAC,yBAAyB;SACnF,CAAC,CAAC;IACL,CAAC,CAAC,CACH,CAAC;IACF,OAAO,MAAM,CAAC,UAAU,CAAC;AAC3B,CAAC,CAAC,CAAC","sourcesContent":["/**\n * Safe multisig batch transaction operations.\n *\n * Send multiple transactions as an atomic Safe batch using SafeAppsSDK.\n * Detects MultiSend contract unavailability and surfaces it as a typed error.\n *\n * @module safe/batch\n */\n\nimport { Effect } from \"effect\";\nimport {\n  getSafeErrorMessage,\n  isMultiSendUnavailableError,\n  SafeMultiSendUnavailableError,\n  SafeMultisigTxSubmissionError,\n} from \"./errors.js\";\nimport { SafeAppsService } from \"./service.js\";\nimport type { SafeMultisigTx } from \"./types.js\";\n\n/**\n * Send multiple transactions as a single Safe multisig batch.\n *\n * Uses SafeAppsService to atomically execute all transactions via MultiSend.\n * On chains where MultiSend is not deployed, fails with `SafeMultiSendUnavailableError`.\n *\n * @param transactions - Array of transactions to batch\n * @param chainId - Optional chain ID for error context\n */\nexport const safeMultisigBatchWrite = Effect.fn(\"safeMultisigBatchWrite\")(function* (\n  transactions: readonly [SafeMultisigTx, ...SafeMultisigTx[]],\n  chainId?: number\n) {\n  const safeApps = yield* SafeAppsService;\n  const result = yield* safeApps.sendTxs(transactions).pipe(\n    Effect.mapError((error) => {\n      if (isMultiSendUnavailableError(error)) {\n        return new SafeMultiSendUnavailableError({\n          cause: error,\n          chainId,\n          message: `MultiSend contract not available on chain ${chainId ?? \"unknown\"}`,\n        });\n      }\n\n      if (error instanceof SafeMultisigTxSubmissionError) {\n        return error;\n      }\n\n      const detail = getSafeErrorMessage(error);\n      return new SafeMultisigTxSubmissionError({\n        cause: error,\n        message: detail ? `Safe batch write failed: ${detail}` : \"Safe batch write failed\",\n      });\n    })\n  );\n  return result.safeTxHash;\n});\n"]}

package/dist/safe/errors.d.ts

@@ -75,5 +75,16 @@ declare const OffchainSignatureTimeoutError_base: Schema.TaggedErrorClass<Offcha
 }>;
 export declare class OffchainSignatureTimeoutError extends OffchainSignatureTimeoutError_base {
 }
+declare const SafeMultiSendUnavailableError_base: Schema.TaggedErrorClass<SafeMultiSendUnavailableError, "SafeMultiSendUnavailableError", {
+    readonly _tag: Schema.tag<"SafeMultiSendUnavailableError">;
+} & {
+    cause: Schema.optional<typeof Schema.Unknown>;
+    chainId: Schema.optional<typeof Schema.Number>;
+    message: typeof Schema.String;
+}>;
+export declare class SafeMultiSendUnavailableError extends SafeMultiSendUnavailableError_base {
+}
+export declare function getSafeErrorMessage(error: unknown): string | undefined;
+export declare function isMultiSendUnavailableError(error: unknown): boolean;
 export {};
 //# sourceMappingURL=errors.d.ts.map

package/dist/safe/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/safe/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;;;AAGhC,qBAAa,2BAA4B,SAAQ,gCAGhD;CAAG;;;;;;AAEJ,qBAAa,wBAAyB,SAAQ,6BAG7C;CAAG;;;;;;;AAGJ,qBAAa,gCAAiC,SAAQ,qCAGrD;CAAG;;;;;;;AAEJ,qBAAa,yBAA0B,SAAQ,8BAG9C;CAAG;;;;;;;AAEJ,qBAAa,6BAA8B,SAAQ,kCAGlD;CAAG;;;;;;;;;AAEJ,qBAAa,yBAA0B,SAAQ,8BAQ9C;CAAG;;;;;;;;;AAEJ,qBAAa,mCAAoC,SAAQ,wCAQxD;CAAG;;;;;;;AAGJ,qBAAa,kBAAmB,SAAQ,uBAGvC;CAAG;;;;;;;;AAEJ,qBAAa,6BAA8B,SAAQ,kCAOlD;CAAG"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/safe/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;;;AAGhC,qBAAa,2BAA4B,SAAQ,gCAGhD;CAAG;;;;;;AAEJ,qBAAa,wBAAyB,SAAQ,6BAG7C;CAAG;;;;;;;AAGJ,qBAAa,gCAAiC,SAAQ,qCAGrD;CAAG;;;;;;;AAEJ,qBAAa,yBAA0B,SAAQ,8BAG9C;CAAG;;;;;;;AAEJ,qBAAa,6BAA8B,SAAQ,kCAGlD;CAAG;;;;;;;;;AAEJ,qBAAa,yBAA0B,SAAQ,8BAQ9C;CAAG;;;;;;;;;AAEJ,qBAAa,mCAAoC,SAAQ,wCAQxD;CAAG;;;;;;;AAGJ,qBAAa,kBAAmB,SAAQ,uBAGvC;CAAG;;;;;;;;AAEJ,qBAAa,6BAA8B,SAAQ,kCAOlD;CAAG;;;;;;;;AAIJ,qBAAa,6BAA8B,SAAQ,kCAOlD;CAAG;AA0GJ,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEtE;AAMD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEnE"}

package/dist/safe/errors.js

@@ -31,4 +31,103 @@ export class OffchainSignatureTimeoutError extends Schema.TaggedError()("Offchai
     timeout: Schema.Number,
 }) {
 }
+export class SafeMultiSendUnavailableError extends Schema.TaggedError()("SafeMultiSendUnavailableError", {
+    cause: Schema.optional(Schema.Unknown),
+    chainId: Schema.optional(Schema.Number),
+    message: Schema.String,
+}) {
+}
+const MULTISEND_ERROR_PATTERN = /MultiSend contract not deployed|MultiSend call failed/i;
+const MAX_ERROR_DEPTH = 10;
+const USER_REJECTION_CODE = 4001;
+const MAX_ERROR_MESSAGE_DEPTH = 10;
+function toNonEmptyString(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const normalized = value.trim();
+    return normalized.length > 0 ? normalized : undefined;
+}
+function isUserRejectionCode(code) {
+    return code === USER_REJECTION_CODE || code === `${USER_REJECTION_CODE}`;
+}
+function getSafeErrorMessageInternal(error, depth) {
+    if (!error || depth >= MAX_ERROR_MESSAGE_DEPTH) {
+        return undefined;
+    }
+    if (typeof error === "string") {
+        return toNonEmptyString(error);
+    }
+    if (error instanceof Error) {
+        if (isUserRejectionCode(error.code)) {
+            return "User rejected the request";
+        }
+        const shortMessage = toNonEmptyString(error.shortMessage);
+        if (shortMessage) {
+            return shortMessage;
+        }
+        const message = toNonEmptyString(error.message);
+        if (message) {
+            return message;
+        }
+        return getSafeErrorMessageInternal(error.cause, depth + 1);
+    }
+    if (typeof error !== "object") {
+        return undefined;
+    }
+    const typedError = error;
+    if (isUserRejectionCode(typedError.code)) {
+        return "User rejected the request";
+    }
+    const shortMessage = toNonEmptyString(typedError.shortMessage);
+    if (shortMessage) {
+        return shortMessage;
+    }
+    const message = toNonEmptyString(typedError.message);
+    if (message) {
+        return message;
+    }
+    const causeMessage = getSafeErrorMessageInternal(typedError.cause, depth + 1);
+    if (causeMessage) {
+        return causeMessage;
+    }
+    const nestedErrorMessage = getSafeErrorMessageInternal(typedError.error, depth + 1);
+    if (nestedErrorMessage) {
+        return nestedErrorMessage;
+    }
+    if (!Array.isArray(typedError.errors)) {
+        return undefined;
+    }
+    for (const nestedError of typedError.errors) {
+        const nestedMessage = getSafeErrorMessageInternal(nestedError, depth + 1);
+        if (nestedMessage) {
+            return nestedMessage;
+        }
+    }
+    return undefined;
+}
+export function getSafeErrorMessage(error) {
+    return getSafeErrorMessageInternal(error, 0);
+}
+export function isMultiSendUnavailableError(error) {
+    return checkMultiSendError(error, 0);
+}
+function checkMultiSendError(error, depth) {
+    if (depth >= MAX_ERROR_DEPTH) {
+        return false;
+    }
+    if (typeof error === "string") {
+        return MULTISEND_ERROR_PATTERN.test(error);
+    }
+    if (typeof error === "object" && error !== null) {
+        const { message, cause } = error;
+        if (typeof message === "string" && MULTISEND_ERROR_PATTERN.test(message)) {
+            return true;
+        }
+        if (cause) {
+            return checkMultiSendError(cause, depth + 1);
+        }
+    }
+    return false;
+}
 //# sourceMappingURL=errors.js.map

package/dist/safe/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/safe/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,MAAM,OAAO,2BAA4B,SAAQ,MAAM,CAAC,WAAW,EAA+B,CAChG,6BAA6B,EAC7B,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CACnE;CAAG;AAEJ,MAAM,OAAO,wBAAyB,SAAQ,MAAM,CAAC,WAAW,EAA4B,CAC1F,0BAA0B,EAC1B,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAC3B;CAAG;AAGJ,MAAM,OAAO,gCAAiC,SAAQ,MAAM,CAAC,WAAW,EAAoC,CAC1G,kCAAkC,EAClC,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CACnE;CAAG;AAEJ,MAAM,OAAO,yBAA0B,SAAQ,MAAM,CAAC,WAAW,EAA6B,CAC5F,2BAA2B,EAC3B,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CACnE;CAAG;AAEJ,MAAM,OAAO,6BAA8B,SAAQ,MAAM,CAAC,WAAW,EAAiC,CACpG,+BAA+B,EAC/B,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CACnE;CAAG;AAEJ,MAAM,OAAO,yBAA0B,SAAQ,MAAM,CAAC,WAAW,EAA6B,CAC5F,2BAA2B,EAC3B;IACE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,SAAS,EAAE,MAAM,CAAC,OAAO;IACzB,UAAU,EAAE,MAAM,CAAC,MAAM;CAC1B,CACF;CAAG;AAEJ,MAAM,OAAO,mCAAoC,SAAQ,MAAM,CAAC,WAAW,EAAuC,CAChH,qCAAqC,EACrC;IACE,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CACF;CAAG;AAGJ,MAAM,OAAO,kBAAmB,SAAQ,MAAM,CAAC,WAAW,EAAsB,CAC9E,oBAAoB,EACpB,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CACnE;CAAG;AAEJ,MAAM,OAAO,6BAA8B,SAAQ,MAAM,CAAC,WAAW,EAAiC,CACpG,+BAA+B,EAC/B;IACE,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,WAAW,EAAE,MAAM,CAAC,MAAM;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CACF;CAAG","sourcesContent":["import { Schema } from \"effect\";\n\n// SDK availability errors\nexport class SafeAppsSdkUnavailableError extends Schema.TaggedError<SafeAppsSdkUnavailableError>()(\n  \"SafeAppsSdkUnavailableError\",\n  { cause: Schema.optional(Schema.Unknown), message: Schema.String }\n) {}\n\nexport class NotInSafeAppContextError extends Schema.TaggedError<NotInSafeAppContextError>()(\n  \"NotInSafeAppContextError\",\n  { message: Schema.String }\n) {}\n\n// Safe operation errors\nexport class SafeMultisigInfoUnavailableError extends Schema.TaggedError<SafeMultisigInfoUnavailableError>()(\n  \"SafeMultisigInfoUnavailableError\",\n  { cause: Schema.optional(Schema.Unknown), message: Schema.String }\n) {}\n\nexport class SafeMultisigSettingsError extends Schema.TaggedError<SafeMultisigSettingsError>()(\n  \"SafeMultisigSettingsError\",\n  { cause: Schema.optional(Schema.Unknown), message: Schema.String }\n) {}\n\nexport class SafeMultisigTxSubmissionError extends Schema.TaggedError<SafeMultisigTxSubmissionError>()(\n  \"SafeMultisigTxSubmissionError\",\n  { cause: Schema.optional(Schema.Unknown), message: Schema.String }\n) {}\n\nexport class SafeMultisigTxLookupError extends Schema.TaggedError<SafeMultisigTxLookupError>()(\n  \"SafeMultisigTxLookupError\",\n  {\n    cause: Schema.optional(Schema.Unknown),\n    message: Schema.String,\n    retryable: Schema.Boolean,\n    safeTxHash: Schema.String,\n  }\n) {}\n\nexport class SafeMultisigTxExecutionTimeoutError extends Schema.TaggedError<SafeMultisigTxExecutionTimeoutError>()(\n  \"SafeMultisigTxExecutionTimeoutError\",\n  {\n    lastStatus: Schema.optional(Schema.String),\n    message: Schema.String,\n    safeTxHash: Schema.String,\n    timeout: Schema.Number,\n  }\n) {}\n\n// Signing errors\nexport class SignTypedDataError extends Schema.TaggedError<SignTypedDataError>()(\n  \"SignTypedDataError\",\n  { cause: Schema.optional(Schema.Unknown), message: Schema.String }\n) {}\n\nexport class OffchainSignatureTimeoutError extends Schema.TaggedError<OffchainSignatureTimeoutError>()(\n  \"OffchainSignatureTimeoutError\",\n  {\n    message: Schema.String,\n    messageHash: Schema.String,\n    timeout: Schema.Number,\n  }\n) {}\n"]}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/safe/errors.ts"],"names":[],"mappings":"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","sourcesContent":["import { Schema } from \"effect\";\n\n// SDK availability errors\nexport class SafeAppsSdkUnavailableError extends Schema.TaggedError<SafeAppsSdkUnavailableError>()(\n  \"SafeAppsSdkUnavailableError\",\n  { cause: Schema.optional(Schema.Unknown), message: Schema.String }\n) {}\n\nexport class NotInSafeAppContextError extends Schema.TaggedError<NotInSafeAppContextError>()(\n  \"NotInSafeAppContextError\",\n  { message: Schema.String }\n) {}\n\n// Safe operation errors\nexport class SafeMultisigInfoUnavailableError extends Schema.TaggedError<SafeMultisigInfoUnavailableError>()(\n  \"SafeMultisigInfoUnavailableError\",\n  { cause: Schema.optional(Schema.Unknown), message: Schema.String }\n) {}\n\nexport class SafeMultisigSettingsError extends Schema.TaggedError<SafeMultisigSettingsError>()(\n  \"SafeMultisigSettingsError\",\n  { cause: Schema.optional(Schema.Unknown), message: Schema.String }\n) {}\n\nexport class SafeMultisigTxSubmissionError extends Schema.TaggedError<SafeMultisigTxSubmissionError>()(\n  \"SafeMultisigTxSubmissionError\",\n  { cause: Schema.optional(Schema.Unknown), message: Schema.String }\n) {}\n\nexport class SafeMultisigTxLookupError extends Schema.TaggedError<SafeMultisigTxLookupError>()(\n  \"SafeMultisigTxLookupError\",\n  {\n    cause: Schema.optional(Schema.Unknown),\n    message: Schema.String,\n    retryable: Schema.Boolean,\n    safeTxHash: Schema.String,\n  }\n) {}\n\nexport class SafeMultisigTxExecutionTimeoutError extends Schema.TaggedError<SafeMultisigTxExecutionTimeoutError>()(\n  \"SafeMultisigTxExecutionTimeoutError\",\n  {\n    lastStatus: Schema.optional(Schema.String),\n    message: Schema.String,\n    safeTxHash: Schema.String,\n    timeout: Schema.Number,\n  }\n) {}\n\n// Signing errors\nexport class SignTypedDataError extends Schema.TaggedError<SignTypedDataError>()(\n  \"SignTypedDataError\",\n  { cause: Schema.optional(Schema.Unknown), message: Schema.String }\n) {}\n\nexport class OffchainSignatureTimeoutError extends Schema.TaggedError<OffchainSignatureTimeoutError>()(\n  \"OffchainSignatureTimeoutError\",\n  {\n    message: Schema.String,\n    messageHash: Schema.String,\n    timeout: Schema.Number,\n  }\n) {}\n\n// MultiSend errors\n\nexport class SafeMultiSendUnavailableError extends Schema.TaggedError<SafeMultiSendUnavailableError>()(\n  \"SafeMultiSendUnavailableError\",\n  {\n    cause: Schema.optional(Schema.Unknown),\n    chainId: Schema.optional(Schema.Number),\n    message: Schema.String,\n  }\n) {}\n\n// MultiSend error detection\n\nconst MULTISEND_ERROR_PATTERN = /MultiSend contract not deployed|MultiSend call failed/i;\nconst MAX_ERROR_DEPTH = 10;\nconst USER_REJECTION_CODE = 4001;\nconst MAX_ERROR_MESSAGE_DEPTH = 10;\n\ntype ErrorMessageShape = {\n  readonly cause?: unknown;\n  readonly code?: unknown;\n  readonly error?: unknown;\n  readonly errors?: unknown;\n  readonly message?: unknown;\n  readonly shortMessage?: unknown;\n};\n\nfunction toNonEmptyString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n\n  const normalized = value.trim();\n  return normalized.length > 0 ? normalized : undefined;\n}\n\nfunction isUserRejectionCode(code: unknown): boolean {\n  return code === USER_REJECTION_CODE || code === `${USER_REJECTION_CODE}`;\n}\n\nfunction getSafeErrorMessageInternal(error: unknown, depth: number): string | undefined {\n  if (!error || depth >= MAX_ERROR_MESSAGE_DEPTH) {\n    return undefined;\n  }\n\n  if (typeof error === \"string\") {\n    return toNonEmptyString(error);\n  }\n\n  if (error instanceof Error) {\n    if (isUserRejectionCode((error as { code?: unknown }).code)) {\n      return \"User rejected the request\";\n    }\n\n    const shortMessage = toNonEmptyString((error as { shortMessage?: unknown }).shortMessage);\n    if (shortMessage) {\n      return shortMessage;\n    }\n\n    const message = toNonEmptyString(error.message);\n    if (message) {\n      return message;\n    }\n\n    return getSafeErrorMessageInternal((error as { cause?: unknown }).cause, depth + 1);\n  }\n\n  if (typeof error !== \"object\") {\n    return undefined;\n  }\n\n  const typedError = error as ErrorMessageShape;\n\n  if (isUserRejectionCode(typedError.code)) {\n    return \"User rejected the request\";\n  }\n\n  const shortMessage = toNonEmptyString(typedError.shortMessage);\n  if (shortMessage) {\n    return shortMessage;\n  }\n\n  const message = toNonEmptyString(typedError.message);\n  if (message) {\n    return message;\n  }\n\n  const causeMessage = getSafeErrorMessageInternal(typedError.cause, depth + 1);\n  if (causeMessage) {\n    return causeMessage;\n  }\n\n  const nestedErrorMessage = getSafeErrorMessageInternal(typedError.error, depth + 1);\n  if (nestedErrorMessage) {\n    return nestedErrorMessage;\n  }\n\n  if (!Array.isArray(typedError.errors)) {\n    return undefined;\n  }\n\n  for (const nestedError of typedError.errors) {\n    const nestedMessage = getSafeErrorMessageInternal(nestedError, depth + 1);\n    if (nestedMessage) {\n      return nestedMessage;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Best-effort extraction of a human-readable Safe SDK error message.\n * Preserves nested `cause` / `error` chains and handles EIP-1193 user rejection codes.\n */\nexport function getSafeErrorMessage(error: unknown): string | undefined {\n  return getSafeErrorMessageInternal(error, 0);\n}\n\n/**\n * Check if an error is caused by MultiSend contract unavailability.\n * Recursively checks error messages and causes for MultiSend-related strings.\n */\nexport function isMultiSendUnavailableError(error: unknown): boolean {\n  return checkMultiSendError(error, 0);\n}\n\nfunction checkMultiSendError(error: unknown, depth: number): boolean {\n  if (depth >= MAX_ERROR_DEPTH) {\n    return false;\n  }\n\n  if (typeof error === \"string\") {\n    return MULTISEND_ERROR_PATTERN.test(error);\n  }\n\n  if (typeof error === \"object\" && error !== null) {\n    const { message, cause } = error as { message?: unknown; cause?: unknown };\n\n    if (typeof message === \"string\" && MULTISEND_ERROR_PATTERN.test(message)) {\n      return true;\n    }\n\n    if (cause) {\n      return checkMultiSendError(cause, depth + 1);\n    }\n  }\n\n  return false;\n}\n"]}

package/dist/safe/index.d.ts

@@ -1,8 +1,11 @@
+export { buildSafeApproveTx, type SafeMultisigAllowAndWriteParams, type SafeMultisigApproveTxParams, safeMultisigAllowAndWrite, } from "./allowance.js";
+export { safeMultisigBatchWrite } from "./batch.js";
 export type { SafeDetectionParams, SafeDetectionResult } from "./detection.js";
 export { isSafeMultisig, SafeMultisigDetectionError } from "./detection.js";
-export { NotInSafeAppContextError, OffchainSignatureTimeoutError, SafeAppsSdkUnavailableError, SafeMultisigInfoUnavailableError, SafeMultisigSettingsError, SafeMultisigTxExecutionTimeoutError, SafeMultisigTxLookupError, SafeMultisigTxSubmissionError, SignTypedDataError, } from "./errors.js";
+export { isMultiSendUnavailableError, NotInSafeAppContextError, OffchainSignatureTimeoutError, SafeAppsSdkUnavailableError, SafeMultiSendUnavailableError, SafeMultisigInfoUnavailableError, SafeMultisigSettingsError, SafeMultisigTxExecutionTimeoutError, SafeMultisigTxLookupError, SafeMultisigTxSubmissionError, SignTypedDataError, } from "./errors.js";
 export { type SafeAppsServiceConfig, SafeAppsServiceLive } from "./live.js";
 export { SafeAppsService, type SafeAppsServiceShape } from "./service.js";
 export * from "./simulation/index.js";
+export { getSafeMultisigTxStatus, type SafeMultisigTxStatus, type SafeMultisigWaitOptions, type SafeMultisigWaitResult, waitForSafeMultisigTx, } from "./tx-lifecycle.js";
 export type { EIP712TypedData, OffchainSignaturePolicy, OffchainSignatureResult, SafeMultisigInfo, SafeMultisigTx, SafeMultisigTxResult, SafeMultisigTxSubmission, SafeWaitPolicy, SignTypedDataResult, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/safe/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/safe/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE/E,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAG5E,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,EAC3B,gCAAgC,EAChC,yBAAyB,EACzB,mCAAmC,EACnC,yBAAyB,EACzB,6BAA6B,EAC7B,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAE1E,cAAc,uBAAuB,CAAC;AAEtC,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/safe/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,KAAK,+BAA+B,EACpC,KAAK,2BAA2B,EAChC,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5E,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,EAC3B,6BAA6B,EAC7B,gCAAgC,EAChC,yBAAyB,EACzB,mCAAmC,EACnC,yBAAyB,EACzB,6BAA6B,EAC7B,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,KAAK,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAE1E,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EACL,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/safe/index.js

@@ -1,6 +1,9 @@
+export { buildSafeApproveTx, safeMultisigAllowAndWrite, } from "./allowance.js";
+export { safeMultisigBatchWrite } from "./batch.js";
 export { isSafeMultisig, SafeMultisigDetectionError } from "./detection.js";
-export { NotInSafeAppContextError, OffchainSignatureTimeoutError, SafeAppsSdkUnavailableError, SafeMultisigInfoUnavailableError, SafeMultisigSettingsError, SafeMultisigTxExecutionTimeoutError, SafeMultisigTxLookupError, SafeMultisigTxSubmissionError, SignTypedDataError, } from "./errors.js";
+export { isMultiSendUnavailableError, NotInSafeAppContextError, OffchainSignatureTimeoutError, SafeAppsSdkUnavailableError, SafeMultiSendUnavailableError, SafeMultisigInfoUnavailableError, SafeMultisigSettingsError, SafeMultisigTxExecutionTimeoutError, SafeMultisigTxLookupError, SafeMultisigTxSubmissionError, SignTypedDataError, } from "./errors.js";
 export { SafeAppsServiceLive } from "./live.js";
 export { SafeAppsService } from "./service.js";
 export * from "./simulation/index.js";
+export { getSafeMultisigTxStatus, waitForSafeMultisigTx, } from "./tx-lifecycle.js";
 //# sourceMappingURL=index.js.map

package/dist/safe/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/safe/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAG5E,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,EAC3B,gCAAgC,EAChC,yBAAyB,EACzB,mCAAmC,EACnC,yBAAyB,EACzB,6BAA6B,EAC7B,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAA8B,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,eAAe,EAA6B,MAAM,cAAc,CAAC;AAE1E,cAAc,uBAAuB,CAAC","sourcesContent":["// Service and layer\n\nexport type { SafeDetectionParams, SafeDetectionResult } from \"./detection.js\";\n// Detection\nexport { isSafeMultisig, SafeMultisigDetectionError } from \"./detection.js\";\n\n// Errors\nexport {\n  NotInSafeAppContextError,\n  OffchainSignatureTimeoutError,\n  SafeAppsSdkUnavailableError,\n  SafeMultisigInfoUnavailableError,\n  SafeMultisigSettingsError,\n  SafeMultisigTxExecutionTimeoutError,\n  SafeMultisigTxLookupError,\n  SafeMultisigTxSubmissionError,\n  SignTypedDataError,\n} from \"./errors.js\";\nexport { type SafeAppsServiceConfig, SafeAppsServiceLive } from \"./live.js\";\nexport { SafeAppsService, type SafeAppsServiceShape } from \"./service.js\";\n// Simulation\nexport * from \"./simulation/index.js\";\n// Types\nexport type {\n  EIP712TypedData,\n  OffchainSignaturePolicy,\n  OffchainSignatureResult,\n  SafeMultisigInfo,\n  SafeMultisigTx,\n  SafeMultisigTxResult,\n  SafeMultisigTxSubmission,\n  SafeWaitPolicy,\n  SignTypedDataResult,\n} from \"./types.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/safe/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAGlB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGpD,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5E,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,EAC3B,6BAA6B,EAC7B,gCAAgC,EAChC,yBAAyB,EACzB,mCAAmC,EACnC,yBAAyB,EACzB,6BAA6B,EAC7B,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAA8B,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,eAAe,EAA6B,MAAM,cAAc,CAAC;AAE1E,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EACL,uBAAuB,EAIvB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC","sourcesContent":["// Allowance batching (approve + action as one Safe proposal)\nexport {\n  buildSafeApproveTx,\n  type SafeMultisigAllowAndWriteParams,\n  type SafeMultisigApproveTxParams,\n  safeMultisigAllowAndWrite,\n} from \"./allowance.js\";\n// Batch write (atomic multi-call via MultiSend)\nexport { safeMultisigBatchWrite } from \"./batch.js\";\n// Detection\nexport type { SafeDetectionParams, SafeDetectionResult } from \"./detection.js\";\nexport { isSafeMultisig, SafeMultisigDetectionError } from \"./detection.js\";\n// Errors\nexport {\n  isMultiSendUnavailableError,\n  NotInSafeAppContextError,\n  OffchainSignatureTimeoutError,\n  SafeAppsSdkUnavailableError,\n  SafeMultiSendUnavailableError,\n  SafeMultisigInfoUnavailableError,\n  SafeMultisigSettingsError,\n  SafeMultisigTxExecutionTimeoutError,\n  SafeMultisigTxLookupError,\n  SafeMultisigTxSubmissionError,\n  SignTypedDataError,\n} from \"./errors.js\";\n// Service and layer\nexport { type SafeAppsServiceConfig, SafeAppsServiceLive } from \"./live.js\";\nexport { SafeAppsService, type SafeAppsServiceShape } from \"./service.js\";\n// Simulation\nexport * from \"./simulation/index.js\";\n// Transaction lifecycle (polling, status checks)\nexport {\n  getSafeMultisigTxStatus,\n  type SafeMultisigTxStatus,\n  type SafeMultisigWaitOptions,\n  type SafeMultisigWaitResult,\n  waitForSafeMultisigTx,\n} from \"./tx-lifecycle.js\";\n// Types\nexport type {\n  EIP712TypedData,\n  OffchainSignaturePolicy,\n  OffchainSignatureResult,\n  SafeMultisigInfo,\n  SafeMultisigTx,\n  SafeMultisigTxResult,\n  SafeMultisigTxSubmission,\n  SafeWaitPolicy,\n  SignTypedDataResult,\n} from \"./types.js\";\n"]}

package/dist/safe/live.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../src/safe/live.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAU,KAAK,EAAe,MAAM,QAAQ,CAAC;AASpD,OAAO,KAAK,EAAuB,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAc3E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AA4CtD,eAAO,MAAM,mBAAmB,GAAI,SAAS,qBAAqB,mDAwV/D,CAAC"}
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../src/safe/live.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAU,KAAK,EAAe,MAAM,QAAQ,CAAC;AASpD,OAAO,KAAK,EAAuB,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAe3E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AA4CtD,eAAO,MAAM,mBAAmB,GAAI,SAAS,qBAAqB,mDA4V/D,CAAC"}

package/dist/safe/live.js

@@ -3,7 +3,7 @@ import { Effect, Layer, Option, Ref } from "effect";
 import { isAddress, isHash, isHex } from "viem";
 import { SAFE_EXECUTION_TIMEOUT, SAFE_POLL_INTERVAL, SAFE_SIGNATURE_POLL_INTERVAL, SAFE_SIGNATURE_TIMEOUT, } from "#src/constants/index.js";
 import { loadSafeSdk } from "./adapter.js";
-import { NotInSafeAppContextError, OffchainSignatureTimeoutError, SafeMultisigInfoUnavailableError, SafeMultisigSettingsError, SafeMultisigTxExecutionTimeoutError, SafeMultisigTxLookupError, SafeMultisigTxSubmissionError, SignTypedDataError, } from "./errors.js";
+import { getSafeErrorMessage, NotInSafeAppContextError, OffchainSignatureTimeoutError, SafeMultisigInfoUnavailableError, SafeMultisigSettingsError, SafeMultisigTxExecutionTimeoutError, SafeMultisigTxLookupError, SafeMultisigTxSubmissionError, SignTypedDataError, } from "./errors.js";
 import { pollUntil } from "./internal/poll.js";
 import { SafeAppsService } from "./service.js";
 const makeValidator = (predicate, label) => (value, context) => predicate(value)
@@ -67,10 +67,15 @@ export const SafeAppsServiceLive = (config) => Layer.scoped(SafeAppsService, Eff
             value: tx.value?.toString() ?? "0",
         }));
         const result = yield* withSdk(getSdk, (s) => Effect.tryPromise({
-            catch: (cause) => new SafeMultisigTxSubmissionError({
-                cause,
-                message: "Failed to submit txs to Safe",
-            }),
+            catch: (cause) => {
+                const detail = getSafeErrorMessage(cause);
+                return new SafeMultisigTxSubmissionError({
+                    cause,
+                    message: detail
+                        ? `Failed to submit txs to Safe: ${detail}`
+                        : "Failed to submit txs to Safe",
+                });
+            },
             try: () => s.txs.send({ params, txs: sdkTxs }),
         }), (e) => new SafeMultisigTxSubmissionError({ cause: e, message: e.message }));
         const safeTxHash = yield* validateHash(result.safeTxHash, "sendTxs").pipe(Effect.catchTag("SafeMultisigTxLookupError", (e) => Effect.fail(new SafeMultisigTxSubmissionError({ cause: e, message: e.message }))));

package/dist/safe/live.js.map

@@ -1 +1 @@
-{"version":3,"file":"live.js","sourceRoot":"","sources":["../../src/safe/live.ts"],"names":[],"mappings":"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","sourcesContent":["import { TxManager } from \"@prb/effect-evm/tx\";\nimport { Effect, Layer, Option, Ref } from \"effect\";\nimport type { Hash, Hex } from \"viem\";\nimport { isAddress, isHash, isHex } from \"viem\";\nimport {\n  SAFE_EXECUTION_TIMEOUT,\n  SAFE_POLL_INTERVAL,\n  SAFE_SIGNATURE_POLL_INTERVAL,\n  SAFE_SIGNATURE_TIMEOUT,\n} from \"#src/constants/index.js\";\nimport type { SafeAppsSDKInstance, SafeAppsSdkConfig } from \"./adapter.js\";\nimport { loadSafeSdk } from \"./adapter.js\";\nimport type { SafeAppsSdkUnavailableError } from \"./errors.js\";\nimport {\n  NotInSafeAppContextError,\n  OffchainSignatureTimeoutError,\n  SafeMultisigInfoUnavailableError,\n  SafeMultisigSettingsError,\n  SafeMultisigTxExecutionTimeoutError,\n  SafeMultisigTxLookupError,\n  SafeMultisigTxSubmissionError,\n  SignTypedDataError,\n} from \"./errors.js\";\nimport { pollUntil } from \"./internal/poll.js\";\nimport { SafeAppsService } from \"./service.js\";\nimport type { EIP712TypedData, SafeMultisigInfo, SafeMultisigTx } from \"./types.js\";\n\nexport type SafeAppsServiceConfig = SafeAppsSdkConfig;\n\n// --- Validation Factory ---\n\ntype Predicate<T extends string> = (value: string) => value is T;\n\nconst makeValidator =\n  <T extends string>(predicate: Predicate<T>, label: string) =>\n  (value: string, context: string): Effect.Effect<T, SafeMultisigTxLookupError> =>\n    predicate(value)\n      ? Effect.succeed(value)\n      : Effect.fail(\n          new SafeMultisigTxLookupError({\n            message: `Invalid ${label} from SDK in ${context}: ${value}`,\n            retryable: false,\n            safeTxHash: \"\",\n          })\n        );\n\nconst validateAddress = makeValidator(isAddress, \"address\");\nconst validateHash = makeValidator(isHash, \"hash\");\nconst validateHex = makeValidator(isHex, \"hex\");\n\n// --- SDK State ---\n\n/** SDK availability error - either SSR environment or SDK load failure */\ntype SdkUnavailableError = NotInSafeAppContextError | SafeAppsSdkUnavailableError;\n\n/** Internal SDK state for lazy loading */\ntype SdkState<T> =\n  | { readonly _tag: \"pending\" }\n  | { readonly _tag: \"loaded\"; readonly sdk: T }\n  | { readonly _tag: \"unavailable\"; readonly error: SdkUnavailableError };\n\n// --- SDK Wrapper Helper ---\n\nconst withSdk = <A, E>(\n  getSdk: Effect.Effect<SafeAppsSDKInstance, SdkUnavailableError>,\n  fn: (sdk: SafeAppsSDKInstance) => Effect.Effect<A, E>,\n  mapError: (e: SdkUnavailableError) => E\n): Effect.Effect<A, E> => Effect.flatMap(Effect.mapError(getSdk, mapError), fn);\n\n// --- Service Implementation ---\n\nexport const SafeAppsServiceLive = (config?: SafeAppsServiceConfig) =>\n  Layer.scoped(\n    SafeAppsService,\n    Effect.gen(function* () {\n      // Cache Safe info after first fetch\n      const infoRef = yield* Ref.make<SafeMultisigInfo | null>(null);\n\n      // Get TxManager for receipt waiting\n      const txManager = yield* TxManager;\n\n      const sdkRef = yield* Ref.make<SdkState<SafeAppsSDKInstance>>({ _tag: \"pending\" });\n\n      /** Get SDK, loading lazily on first call. Fails if not in Safe App context. */\n      const getSdk: Effect.Effect<SafeAppsSDKInstance, SdkUnavailableError> = Effect.gen(\n        function* () {\n          const state = yield* Ref.get(sdkRef);\n\n          if (state._tag === \"loaded\") {\n            return state.sdk;\n          }\n          if (state._tag === \"unavailable\") {\n            return yield* Effect.fail(state.error);\n          }\n\n          // First call - check environment and load SDK\n          if (typeof window === \"undefined\") {\n            const error = new NotInSafeAppContextError({\n              message: \"Safe Apps SDK requires a browser environment (window is undefined)\",\n            });\n            yield* Ref.set(sdkRef, { _tag: \"unavailable\", error });\n            return yield* Effect.fail(error);\n          }\n\n          // Try to load SDK - catch SDK unavailable error and store it\n          const loadResult = yield* loadSafeSdk(config).pipe(\n            Effect.map((sdk) => ({ _tag: \"loaded\" as const, sdk })),\n            Effect.catchTag(\"SafeAppsSdkUnavailableError\", (error) =>\n              Effect.succeed({ _tag: \"unavailable\" as const, error } as const)\n            )\n          );\n\n          yield* Ref.set(sdkRef, loadResult);\n\n          if (loadResult._tag === \"unavailable\") {\n            return yield* Effect.fail(loadResult.error);\n          }\n\n          return loadResult.sdk;\n        }\n      );\n\n      // --- Service Methods ---\n\n      const getInfo = Effect.fn(\"SafeAppsService.getInfo\")(function* () {\n        const cached = yield* Ref.get(infoRef);\n        if (cached) {\n          return cached;\n        }\n\n        const sdk = yield* withSdk(\n          getSdk,\n          (s) =>\n            Effect.tryPromise({\n              catch: (cause) =>\n                new SafeMultisigInfoUnavailableError({\n                  cause,\n                  message: \"Failed to get Safe info from SDK\",\n                }),\n              try: () => s.safe.getInfo(),\n            }),\n          (e) => new SafeMultisigInfoUnavailableError({ cause: e, message: e.message })\n        );\n\n        const safeAddress = yield* validateAddress(sdk.safeAddress, \"getInfo\").pipe(\n          Effect.catchTag(\"SafeMultisigTxLookupError\", (e) =>\n            Effect.fail(new SafeMultisigInfoUnavailableError({ cause: e, message: e.message }))\n          )\n        );\n\n        const safeInfo: SafeMultisigInfo = { chainId: sdk.chainId, safeAddress };\n        yield* Ref.set(infoRef, safeInfo);\n        return safeInfo;\n      });\n\n      const sendTxs = Effect.fn(\"SafeAppsService.sendTxs\")(function* (\n        txs: readonly SafeMultisigTx[],\n        params?: { safeTxGas?: number }\n      ) {\n        // Convert bigint values to strings (Safe SDK expects decimal strings)\n        const sdkTxs = txs.map((tx) => ({\n          data: tx.data,\n          to: tx.to,\n          value: tx.value?.toString() ?? \"0\",\n        }));\n\n        const result = yield* withSdk(\n          getSdk,\n          (s) =>\n            Effect.tryPromise({\n              catch: (cause) =>\n                new SafeMultisigTxSubmissionError({\n                  cause,\n                  message: \"Failed to submit txs to Safe\",\n                }),\n              try: () => s.txs.send({ params, txs: sdkTxs }),\n            }),\n          (e) => new SafeMultisigTxSubmissionError({ cause: e, message: e.message })\n        );\n\n        const safeTxHash = yield* validateHash(result.safeTxHash, \"sendTxs\").pipe(\n          Effect.catchTag(\"SafeMultisigTxLookupError\", (e) =>\n            Effect.fail(new SafeMultisigTxSubmissionError({ cause: e, message: e.message }))\n          )\n        );\n\n        const info = yield* getInfo().pipe(\n          Effect.catchTag(\"SafeMultisigInfoUnavailableError\", (error) =>\n            Effect.fail(\n              new SafeMultisigTxSubmissionError({\n                cause: error,\n                message: \"Failed to get Safe info after tx submission\",\n              })\n            )\n          )\n        );\n\n        return { chainId: info.chainId, safeAddress: info.safeAddress, safeTxHash };\n      });\n\n      const getTx = Effect.fn(\"SafeAppsService.getTx\")(function* (safeTxHash: Hash) {\n        const tx = yield* withSdk(\n          getSdk,\n          (s) =>\n            Effect.tryPromise({\n              catch: (cause) =>\n                new SafeMultisigTxLookupError({\n                  cause,\n                  message: `Failed to lookup Safe tx ${safeTxHash}`,\n                  retryable: true,\n                  safeTxHash,\n                }),\n              try: () => s.txs.getBySafeTxHash(safeTxHash),\n            }),\n          (e) =>\n            new SafeMultisigTxLookupError({\n              cause: e,\n              message: e.message,\n              retryable: false,\n              safeTxHash,\n            })\n        );\n\n        const txHash = tx.txHash ? yield* validateHash(tx.txHash, \"getTx\") : null;\n\n        return {\n          status: tx.txStatus ?? \"AWAITING_CONFIRMATIONS\",\n          txHash: txHash ? Option.some(txHash) : Option.none<Hash>(),\n        };\n      });\n\n      const waitForTxReceipt = Effect.fn(\"SafeAppsService.waitForTxReceipt\")(function* (\n        safeTxHash: Hash,\n        policy: {\n          pollInterval?: number;\n          executionTimeout?: number;\n          receiptPolicy?: { receiptTimeout?: number; pollingInterval?: number };\n        } = {}\n      ) {\n        const info = yield* getInfo().pipe(\n          Effect.catchTag(\"SafeMultisigInfoUnavailableError\", (error) =>\n            Effect.fail(\n              new SafeMultisigTxLookupError({\n                cause: error,\n                message: \"Failed to get Safe info for receipt waiting\",\n                retryable: true,\n                safeTxHash,\n              })\n            )\n          )\n        );\n\n        const pollInterval = policy.pollInterval ?? SAFE_POLL_INTERVAL;\n        const executionTimeout = policy.executionTimeout ?? SAFE_EXECUTION_TIMEOUT;\n\n        // Track last status for timeout error message\n        let lastStatus = \"AWAITING_CONFIRMATIONS\";\n\n        const onchainHash = yield* pollUntil(\n          Effect.gen(function* () {\n            const tx = yield* getTx(safeTxHash);\n            lastStatus = tx.status;\n            return tx.txHash;\n          }),\n          { interval: pollInterval, timeout: executionTimeout },\n          (timeout) =>\n            new SafeMultisigTxExecutionTimeoutError({\n              lastStatus,\n              message: `Safe tx ${safeTxHash} not executed within ${timeout}ms (last status: ${lastStatus})`,\n              safeTxHash,\n              timeout,\n            })\n        );\n\n        // Delegate to TxManager for on-chain receipt\n        const receipt = yield* txManager\n          .waitForReceipt(info.chainId, onchainHash, policy.receiptPolicy)\n          .pipe(\n            Effect.catchTag(\"TxReplacedError\", (error) =>\n              Effect.fail(\n                new SafeMultisigTxLookupError({\n                  cause: error,\n                  message: `Transaction was replaced: ${error.message}`,\n                  retryable: false,\n                  safeTxHash,\n                })\n              )\n            )\n          );\n\n        return {\n          chainId: info.chainId,\n          onchainHash,\n          receipt,\n          safeAddress: info.safeAddress,\n          safeTxHash,\n        };\n      });\n\n      const signTypedData = Effect.fn(\"SafeAppsService.signTypedData\")(function* (\n        typedData: EIP712TypedData\n      ) {\n        const result = yield* withSdk(\n          getSdk,\n          (s) =>\n            Effect.tryPromise({\n              catch: (cause) =>\n                new SignTypedDataError({ cause, message: \"Failed to sign typed data via Safe\" }),\n              try: () => s.txs.signTypedMessage(typedData),\n            }),\n          (e) => new SignTypedDataError({ cause: e, message: e.message })\n        );\n\n        // SDK returns { safeTxHash } for on-chain or { messageHash } for off-chain\n        if (\"messageHash\" in result) {\n          const messageHash = yield* validateHex(result.messageHash ?? \"\", \"signTypedData\").pipe(\n            Effect.catchTag(\"SafeMultisigTxLookupError\", (e) =>\n              Effect.fail(new SignTypedDataError({ cause: e, message: e.message }))\n            )\n          );\n          return { _tag: \"Offchain\" as const, messageHash };\n        }\n\n        const safeTxHash = yield* validateHash(result.safeTxHash, \"signTypedData\").pipe(\n          Effect.catchTag(\"SafeMultisigTxLookupError\", (e) =>\n            Effect.fail(new SignTypedDataError({ cause: e, message: e.message }))\n          )\n        );\n        return { _tag: \"Onchain\" as const, safeTxHash };\n      });\n\n      const getOffchainSignature = Effect.fn(\"SafeAppsService.getOffchainSignature\")(function* (\n        messageHash: Hex\n      ) {\n        const sig = yield* withSdk(\n          getSdk,\n          (s) =>\n            Effect.tryPromise({\n              catch: (cause) =>\n                new SafeMultisigTxLookupError({\n                  cause,\n                  message: `Failed to get off-chain signature for ${messageHash}`,\n                  retryable: true,\n                  safeTxHash: messageHash,\n                }),\n              try: () => s.safe.getOffChainSignature(messageHash),\n            }),\n          (e) =>\n            new SafeMultisigTxLookupError({\n              cause: e,\n              message: e.message,\n              retryable: false,\n              safeTxHash: messageHash,\n            })\n        );\n\n        // Empty string or \"0x\" means signature not yet available\n        if (!sig || sig === \"\" || sig === \"0x\") {\n          return Option.none<Hex>();\n        }\n\n        const validatedSig = yield* validateHex(sig, \"getOffchainSignature\");\n        return Option.some(validatedSig);\n      });\n\n      const pollOffchainSignature = Effect.fn(\"SafeAppsService.pollOffchainSignature\")(function* (\n        messageHash: Hex,\n        policy: { pollInterval?: number; timeout?: number } = {}\n      ) {\n        const pollInterval = policy.pollInterval ?? SAFE_SIGNATURE_POLL_INTERVAL;\n        const timeout = policy.timeout ?? SAFE_SIGNATURE_TIMEOUT;\n\n        const signature = yield* pollUntil(\n          getOffchainSignature(messageHash),\n          { interval: pollInterval, timeout },\n          (elapsed) =>\n            new OffchainSignatureTimeoutError({\n              message: `Off-chain signature for ${messageHash} not available within ${elapsed}ms`,\n              messageHash,\n              timeout: elapsed,\n            })\n        );\n\n        return { messageHash, signature };\n      });\n\n      const enableOffchainSigning = Effect.fn(\"SafeAppsService.enableOffchainSigning\")(\n        function* () {\n          yield* withSdk(\n            getSdk,\n            (s) =>\n              Effect.tryPromise({\n                catch: (cause) =>\n                  new SafeMultisigSettingsError({\n                    cause,\n                    message: \"Failed to enable off-chain signing mode\",\n                  }),\n                try: () => s.eth.setSafeSettings([{ offChainSigning: true }]),\n              }),\n            (e) => new SafeMultisigSettingsError({ cause: e, message: e.message })\n          );\n        }\n      );\n\n      return SafeAppsService.of({\n        enableOffchainSigning,\n        getInfo,\n        getOffchainSignature,\n        getTx,\n        pollOffchainSignature,\n        sendTxs,\n        signTypedData,\n        waitForTxReceipt,\n      });\n    })\n  );\n"]}
+{"version":3,"file":"live.js","sourceRoot":"","sources":["../../src/safe/live.ts"],"names":[],"mappings":"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","sourcesContent":["import { TxManager } from \"@prb/effect-evm/tx\";\nimport { Effect, Layer, Option, Ref } from \"effect\";\nimport type { Hash, Hex } from \"viem\";\nimport { isAddress, isHash, isHex } from \"viem\";\nimport {\n  SAFE_EXECUTION_TIMEOUT,\n  SAFE_POLL_INTERVAL,\n  SAFE_SIGNATURE_POLL_INTERVAL,\n  SAFE_SIGNATURE_TIMEOUT,\n} from \"#src/constants/index.js\";\nimport type { SafeAppsSDKInstance, SafeAppsSdkConfig } from \"./adapter.js\";\nimport { loadSafeSdk } from \"./adapter.js\";\nimport type { SafeAppsSdkUnavailableError } from \"./errors.js\";\nimport {\n  getSafeErrorMessage,\n  NotInSafeAppContextError,\n  OffchainSignatureTimeoutError,\n  SafeMultisigInfoUnavailableError,\n  SafeMultisigSettingsError,\n  SafeMultisigTxExecutionTimeoutError,\n  SafeMultisigTxLookupError,\n  SafeMultisigTxSubmissionError,\n  SignTypedDataError,\n} from \"./errors.js\";\nimport { pollUntil } from \"./internal/poll.js\";\nimport { SafeAppsService } from \"./service.js\";\nimport type { EIP712TypedData, SafeMultisigInfo, SafeMultisigTx } from \"./types.js\";\n\nexport type SafeAppsServiceConfig = SafeAppsSdkConfig;\n\n// --- Validation Factory ---\n\ntype Predicate<T extends string> = (value: string) => value is T;\n\nconst makeValidator =\n  <T extends string>(predicate: Predicate<T>, label: string) =>\n  (value: string, context: string): Effect.Effect<T, SafeMultisigTxLookupError> =>\n    predicate(value)\n      ? Effect.succeed(value)\n      : Effect.fail(\n          new SafeMultisigTxLookupError({\n            message: `Invalid ${label} from SDK in ${context}: ${value}`,\n            retryable: false,\n            safeTxHash: \"\",\n          })\n        );\n\nconst validateAddress = makeValidator(isAddress, \"address\");\nconst validateHash = makeValidator(isHash, \"hash\");\nconst validateHex = makeValidator(isHex, \"hex\");\n\n// --- SDK State ---\n\n/** SDK availability error - either SSR environment or SDK load failure */\ntype SdkUnavailableError = NotInSafeAppContextError | SafeAppsSdkUnavailableError;\n\n/** Internal SDK state for lazy loading */\ntype SdkState<T> =\n  | { readonly _tag: \"pending\" }\n  | { readonly _tag: \"loaded\"; readonly sdk: T }\n  | { readonly _tag: \"unavailable\"; readonly error: SdkUnavailableError };\n\n// --- SDK Wrapper Helper ---\n\nconst withSdk = <A, E>(\n  getSdk: Effect.Effect<SafeAppsSDKInstance, SdkUnavailableError>,\n  fn: (sdk: SafeAppsSDKInstance) => Effect.Effect<A, E>,\n  mapError: (e: SdkUnavailableError) => E\n): Effect.Effect<A, E> => Effect.flatMap(Effect.mapError(getSdk, mapError), fn);\n\n// --- Service Implementation ---\n\nexport const SafeAppsServiceLive = (config?: SafeAppsServiceConfig) =>\n  Layer.scoped(\n    SafeAppsService,\n    Effect.gen(function* () {\n      // Cache Safe info after first fetch\n      const infoRef = yield* Ref.make<SafeMultisigInfo | null>(null);\n\n      // Get TxManager for receipt waiting\n      const txManager = yield* TxManager;\n\n      const sdkRef = yield* Ref.make<SdkState<SafeAppsSDKInstance>>({ _tag: \"pending\" });\n\n      /** Get SDK, loading lazily on first call. Fails if not in Safe App context. */\n      const getSdk: Effect.Effect<SafeAppsSDKInstance, SdkUnavailableError> = Effect.gen(\n        function* () {\n          const state = yield* Ref.get(sdkRef);\n\n          if (state._tag === \"loaded\") {\n            return state.sdk;\n          }\n          if (state._tag === \"unavailable\") {\n            return yield* Effect.fail(state.error);\n          }\n\n          // First call - check environment and load SDK\n          if (typeof window === \"undefined\") {\n            const error = new NotInSafeAppContextError({\n              message: \"Safe Apps SDK requires a browser environment (window is undefined)\",\n            });\n            yield* Ref.set(sdkRef, { _tag: \"unavailable\", error });\n            return yield* Effect.fail(error);\n          }\n\n          // Try to load SDK - catch SDK unavailable error and store it\n          const loadResult = yield* loadSafeSdk(config).pipe(\n            Effect.map((sdk) => ({ _tag: \"loaded\" as const, sdk })),\n            Effect.catchTag(\"SafeAppsSdkUnavailableError\", (error) =>\n              Effect.succeed({ _tag: \"unavailable\" as const, error } as const)\n            )\n          );\n\n          yield* Ref.set(sdkRef, loadResult);\n\n          if (loadResult._tag === \"unavailable\") {\n            return yield* Effect.fail(loadResult.error);\n          }\n\n          return loadResult.sdk;\n        }\n      );\n\n      // --- Service Methods ---\n\n      const getInfo = Effect.fn(\"SafeAppsService.getInfo\")(function* () {\n        const cached = yield* Ref.get(infoRef);\n        if (cached) {\n          return cached;\n        }\n\n        const sdk = yield* withSdk(\n          getSdk,\n          (s) =>\n            Effect.tryPromise({\n              catch: (cause) =>\n                new SafeMultisigInfoUnavailableError({\n                  cause,\n                  message: \"Failed to get Safe info from SDK\",\n                }),\n              try: () => s.safe.getInfo(),\n            }),\n          (e) => new SafeMultisigInfoUnavailableError({ cause: e, message: e.message })\n        );\n\n        const safeAddress = yield* validateAddress(sdk.safeAddress, \"getInfo\").pipe(\n          Effect.catchTag(\"SafeMultisigTxLookupError\", (e) =>\n            Effect.fail(new SafeMultisigInfoUnavailableError({ cause: e, message: e.message }))\n          )\n        );\n\n        const safeInfo: SafeMultisigInfo = { chainId: sdk.chainId, safeAddress };\n        yield* Ref.set(infoRef, safeInfo);\n        return safeInfo;\n      });\n\n      const sendTxs = Effect.fn(\"SafeAppsService.sendTxs\")(function* (\n        txs: readonly SafeMultisigTx[],\n        params?: { safeTxGas?: number }\n      ) {\n        // Convert bigint values to strings (Safe SDK expects decimal strings)\n        const sdkTxs = txs.map((tx) => ({\n          data: tx.data,\n          to: tx.to,\n          value: tx.value?.toString() ?? \"0\",\n        }));\n\n        const result = yield* withSdk(\n          getSdk,\n          (s) =>\n            Effect.tryPromise({\n              catch: (cause) => {\n                const detail = getSafeErrorMessage(cause);\n                return new SafeMultisigTxSubmissionError({\n                  cause,\n                  message: detail\n                    ? `Failed to submit txs to Safe: ${detail}`\n                    : \"Failed to submit txs to Safe\",\n                });\n              },\n              try: () => s.txs.send({ params, txs: sdkTxs }),\n            }),\n          (e) => new SafeMultisigTxSubmissionError({ cause: e, message: e.message })\n        );\n\n        const safeTxHash = yield* validateHash(result.safeTxHash, \"sendTxs\").pipe(\n          Effect.catchTag(\"SafeMultisigTxLookupError\", (e) =>\n            Effect.fail(new SafeMultisigTxSubmissionError({ cause: e, message: e.message }))\n          )\n        );\n\n        const info = yield* getInfo().pipe(\n          Effect.catchTag(\"SafeMultisigInfoUnavailableError\", (error) =>\n            Effect.fail(\n              new SafeMultisigTxSubmissionError({\n                cause: error,\n                message: \"Failed to get Safe info after tx submission\",\n              })\n            )\n          )\n        );\n\n        return { chainId: info.chainId, safeAddress: info.safeAddress, safeTxHash };\n      });\n\n      const getTx = Effect.fn(\"SafeAppsService.getTx\")(function* (safeTxHash: Hash) {\n        const tx = yield* withSdk(\n          getSdk,\n          (s) =>\n            Effect.tryPromise({\n              catch: (cause) =>\n                new SafeMultisigTxLookupError({\n                  cause,\n                  message: `Failed to lookup Safe tx ${safeTxHash}`,\n                  retryable: true,\n                  safeTxHash,\n                }),\n              try: () => s.txs.getBySafeTxHash(safeTxHash),\n            }),\n          (e) =>\n            new SafeMultisigTxLookupError({\n              cause: e,\n              message: e.message,\n              retryable: false,\n              safeTxHash,\n            })\n        );\n\n        const txHash = tx.txHash ? yield* validateHash(tx.txHash, \"getTx\") : null;\n\n        return {\n          status: tx.txStatus ?? \"AWAITING_CONFIRMATIONS\",\n          txHash: txHash ? Option.some(txHash) : Option.none<Hash>(),\n        };\n      });\n\n      const waitForTxReceipt = Effect.fn(\"SafeAppsService.waitForTxReceipt\")(function* (\n        safeTxHash: Hash,\n        policy: {\n          pollInterval?: number;\n          executionTimeout?: number;\n          receiptPolicy?: { receiptTimeout?: number; pollingInterval?: number };\n        } = {}\n      ) {\n        const info = yield* getInfo().pipe(\n          Effect.catchTag(\"SafeMultisigInfoUnavailableError\", (error) =>\n            Effect.fail(\n              new SafeMultisigTxLookupError({\n                cause: error,\n                message: \"Failed to get Safe info for receipt waiting\",\n                retryable: true,\n                safeTxHash,\n              })\n            )\n          )\n        );\n\n        const pollInterval = policy.pollInterval ?? SAFE_POLL_INTERVAL;\n        const executionTimeout = policy.executionTimeout ?? SAFE_EXECUTION_TIMEOUT;\n\n        // Track last status for timeout error message\n        let lastStatus = \"AWAITING_CONFIRMATIONS\";\n\n        const onchainHash = yield* pollUntil(\n          Effect.gen(function* () {\n            const tx = yield* getTx(safeTxHash);\n            lastStatus = tx.status;\n            return tx.txHash;\n          }),\n          { interval: pollInterval, timeout: executionTimeout },\n          (timeout) =>\n            new SafeMultisigTxExecutionTimeoutError({\n              lastStatus,\n              message: `Safe tx ${safeTxHash} not executed within ${timeout}ms (last status: ${lastStatus})`,\n              safeTxHash,\n              timeout,\n            })\n        );\n\n        // Delegate to TxManager for on-chain receipt\n        const receipt = yield* txManager\n          .waitForReceipt(info.chainId, onchainHash, policy.receiptPolicy)\n          .pipe(\n            Effect.catchTag(\"TxReplacedError\", (error) =>\n              Effect.fail(\n                new SafeMultisigTxLookupError({\n                  cause: error,\n                  message: `Transaction was replaced: ${error.message}`,\n                  retryable: false,\n                  safeTxHash,\n                })\n              )\n            )\n          );\n\n        return {\n          chainId: info.chainId,\n          onchainHash,\n          receipt,\n          safeAddress: info.safeAddress,\n          safeTxHash,\n        };\n      });\n\n      const signTypedData = Effect.fn(\"SafeAppsService.signTypedData\")(function* (\n        typedData: EIP712TypedData\n      ) {\n        const result = yield* withSdk(\n          getSdk,\n          (s) =>\n            Effect.tryPromise({\n              catch: (cause) =>\n                new SignTypedDataError({ cause, message: \"Failed to sign typed data via Safe\" }),\n              try: () => s.txs.signTypedMessage(typedData),\n            }),\n          (e) => new SignTypedDataError({ cause: e, message: e.message })\n        );\n\n        // SDK returns { safeTxHash } for on-chain or { messageHash } for off-chain\n        if (\"messageHash\" in result) {\n          const messageHash = yield* validateHex(result.messageHash ?? \"\", \"signTypedData\").pipe(\n            Effect.catchTag(\"SafeMultisigTxLookupError\", (e) =>\n              Effect.fail(new SignTypedDataError({ cause: e, message: e.message }))\n            )\n          );\n          return { _tag: \"Offchain\" as const, messageHash };\n        }\n\n        const safeTxHash = yield* validateHash(result.safeTxHash, \"signTypedData\").pipe(\n          Effect.catchTag(\"SafeMultisigTxLookupError\", (e) =>\n            Effect.fail(new SignTypedDataError({ cause: e, message: e.message }))\n          )\n        );\n        return { _tag: \"Onchain\" as const, safeTxHash };\n      });\n\n      const getOffchainSignature = Effect.fn(\"SafeAppsService.getOffchainSignature\")(function* (\n        messageHash: Hex\n      ) {\n        const sig = yield* withSdk(\n          getSdk,\n          (s) =>\n            Effect.tryPromise({\n              catch: (cause) =>\n                new SafeMultisigTxLookupError({\n                  cause,\n                  message: `Failed to get off-chain signature for ${messageHash}`,\n                  retryable: true,\n                  safeTxHash: messageHash,\n                }),\n              try: () => s.safe.getOffChainSignature(messageHash),\n            }),\n          (e) =>\n            new SafeMultisigTxLookupError({\n              cause: e,\n              message: e.message,\n              retryable: false,\n              safeTxHash: messageHash,\n            })\n        );\n\n        // Empty string or \"0x\" means signature not yet available\n        if (!sig || sig === \"\" || sig === \"0x\") {\n          return Option.none<Hex>();\n        }\n\n        const validatedSig = yield* validateHex(sig, \"getOffchainSignature\");\n        return Option.some(validatedSig);\n      });\n\n      const pollOffchainSignature = Effect.fn(\"SafeAppsService.pollOffchainSignature\")(function* (\n        messageHash: Hex,\n        policy: { pollInterval?: number; timeout?: number } = {}\n      ) {\n        const pollInterval = policy.pollInterval ?? SAFE_SIGNATURE_POLL_INTERVAL;\n        const timeout = policy.timeout ?? SAFE_SIGNATURE_TIMEOUT;\n\n        const signature = yield* pollUntil(\n          getOffchainSignature(messageHash),\n          { interval: pollInterval, timeout },\n          (elapsed) =>\n            new OffchainSignatureTimeoutError({\n              message: `Off-chain signature for ${messageHash} not available within ${elapsed}ms`,\n              messageHash,\n              timeout: elapsed,\n            })\n        );\n\n        return { messageHash, signature };\n      });\n\n      const enableOffchainSigning = Effect.fn(\"SafeAppsService.enableOffchainSigning\")(\n        function* () {\n          yield* withSdk(\n            getSdk,\n            (s) =>\n              Effect.tryPromise({\n                catch: (cause) =>\n                  new SafeMultisigSettingsError({\n                    cause,\n                    message: \"Failed to enable off-chain signing mode\",\n                  }),\n                try: () => s.eth.setSafeSettings([{ offChainSigning: true }]),\n              }),\n            (e) => new SafeMultisigSettingsError({ cause: e, message: e.message })\n          );\n        }\n      );\n\n      return SafeAppsService.of({\n        enableOffchainSigning,\n        getInfo,\n        getOffchainSignature,\n        getTx,\n        pollOffchainSignature,\n        sendTxs,\n        signTypedData,\n        waitForTxReceipt,\n      });\n    })\n  );\n"]}

package/dist/safe/tx-lifecycle.d.ts

@@ -0,0 +1,49 @@
+import { Duration, Effect } from "effect";
+import type { Hash, TransactionReceipt } from "viem";
+import type { SafeMultisigTxLookupError } from "./errors.js";
+import { SafeAppsService } from "./service.js";
+export type SafeMultisigWaitOptions = {
+    readonly interval?: Duration.DurationInput;
+    readonly maxWait?: Duration.DurationInput;
+};
+export type SafeMultisigWaitResult = {
+    readonly _tag: "success";
+    readonly hash: Hash;
+    readonly receipt: TransactionReceipt;
+} | {
+    readonly _tag: "queued";
+    readonly safeTxHash: Hash;
+} | {
+    readonly _tag: "cancelled";
+} | {
+    readonly _tag: "failed";
+    readonly error: string;
+};
+export type SafeMultisigTxStatus = "awaiting_confirmations" | "awaiting_execution" | "pending" | "success" | "failed";
+export declare const waitForSafeMultisigTx: (safeTxHash: `0x${string}`, getReceipt: (hash: Hash) => Effect.Effect<TransactionReceipt, SafeMultisigTxLookupError>, options?: SafeMultisigWaitOptions | undefined) => Effect.Effect<{
+    _tag: "cancelled";
+    error?: undefined;
+    hash?: undefined;
+    receipt?: undefined;
+    safeTxHash?: undefined;
+} | {
+    _tag: "failed";
+    error: string;
+    hash?: undefined;
+    receipt?: undefined;
+    safeTxHash?: undefined;
+} | {
+    _tag: "success";
+    hash: `0x${string}`;
+    receipt: TransactionReceipt;
+    error?: undefined;
+    safeTxHash?: undefined;
+} | {
+    _tag: "queued";
+    safeTxHash: `0x${string}`;
+    error?: undefined;
+    hash?: undefined;
+    receipt?: undefined;
+}, SafeMultisigTxLookupError, SafeAppsService>;
+export declare const getSafeMultisigTxStatus: (safeTxHash: `0x${string}`) => Effect.Effect<"pending" | "success" | "failed" | "awaiting_confirmations" | "awaiting_execution", SafeMultisigTxLookupError, SafeAppsService>;
+//# sourceMappingURL=tx-lifecycle.d.ts.map

package/dist/safe/tx-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx-lifecycle.d.ts","sourceRoot":"","sources":["../../src/safe/tx-lifecycle.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAC;AACrD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAc/C,MAAM,MAAM,uBAAuB,GAAG;IAEpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC;IAE3C,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAC9B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,GACvF;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,MAAM,MAAM,oBAAoB,GAC5B,wBAAwB,GACxB,oBAAoB,GACpB,SAAS,GACT,SAAS,GACT,QAAQ,CAAC;AAqBb,eAAO,MAAM,qBAAqB,iDAEb,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,yBAAyB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;8CAsFxF,CAAC;AAaH,eAAO,MAAM,uBAAuB,8KAoBlC,CAAC"}

package/dist/safe/tx-lifecycle.js

@@ -0,0 +1,79 @@
+import { Duration, Effect, Option } from "effect";
+import { SafeAppsService } from "./service.js";
+const DEFAULT_POLL_INTERVAL = Duration.seconds(5);
+const DEFAULT_MAX_WAIT = Duration.minutes(90);
+const MIN_POLL_INTERVAL = Duration.seconds(1);
+export const waitForSafeMultisigTx = Effect.fn("waitForSafeMultisigTx")(function* (safeTxHash, getReceipt, options = {}) {
+    const interval = Duration.max(Duration.decode(options.interval ?? DEFAULT_POLL_INTERVAL), MIN_POLL_INTERVAL);
+    const maxWait = Duration.decode(options.maxWait ?? DEFAULT_MAX_WAIT);
+    const maxAttempts = Math.floor(Duration.toMillis(maxWait) / Duration.toMillis(interval));
+    const safeApps = yield* SafeAppsService;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        const queuedResult = yield* safeApps.getTx(safeTxHash).pipe(Effect.map(Option.some), Effect.catchTag("SafeMultisigTxLookupError", (error) => {
+            if (error.retryable) {
+                return Effect.logWarning("Retryable error polling Safe tx").pipe(Effect.annotateLogs({ attempt, error: error.message, safeTxHash }), Effect.as(Option.none()));
+            }
+            return Effect.fail(error);
+        }));
+        if (Option.isNone(queuedResult)) {
+            yield* Effect.sleep(interval);
+            continue;
+        }
+        const queued = queuedResult.value;
+        yield* Effect.logDebug("Safe tx poll status").pipe(Effect.annotateLogs({
+            attempt,
+            hash: Option.isSome(queued.txHash) ? queued.txHash.value : "pending",
+            safeTxHash,
+            status: queued.status,
+        }));
+        if (queued.status === "CANCELLED") {
+            return { _tag: "cancelled" };
+        }
+        if (queued.status === "FAILED") {
+            return {
+                _tag: "failed",
+                error: "Safe transaction failed",
+            };
+        }
+        if (queued.status === "SUCCESS") {
+            if (Option.isNone(queued.txHash)) {
+                return {
+                    _tag: "failed",
+                    error: "Safe transaction succeeded but no on-chain hash available",
+                };
+            }
+            const txHash = queued.txHash.value;
+            const receipt = yield* getReceipt(txHash);
+            return {
+                _tag: "success",
+                hash: txHash,
+                receipt,
+            };
+        }
+        yield* Effect.sleep(interval);
+    }
+    yield* Effect.logWarning("Safe multisig transaction polling timeout").pipe(Effect.annotateLogs({
+        maxAttempts,
+        maxWaitMs: Duration.toMillis(maxWait),
+        safeTxHash,
+    }));
+    return { _tag: "queued", safeTxHash };
+});
+export const getSafeMultisigTxStatus = Effect.fn("getSafeMultisigTxStatus")(function* (safeTxHash) {
+    const safeApps = yield* SafeAppsService;
+    const queued = yield* safeApps.getTx(safeTxHash);
+    switch (queued.status) {
+        case "AWAITING_CONFIRMATIONS":
+            return "awaiting_confirmations";
+        case "AWAITING_EXECUTION":
+            return "awaiting_execution";
+        case "SUCCESS":
+            return "success";
+        case "CANCELLED":
+        case "FAILED":
+            return "failed";
+        default:
+            return "pending";
+    }
+});
+//# sourceMappingURL=tx-lifecycle.js.map

package/dist/safe/tx-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx-lifecycle.js","sourceRoot":"","sources":["../../src/safe/tx-lifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Safe multisig transaction lifecycle tracking.\n *\n * Polls the Safe API to track transactions from proposal through execution.\n * Fills the gap between sendTxs() (which returns a safeTxHash) and knowing\n * when the transaction lands on-chain.\n *\n * @module safe/tx-lifecycle\n */\n\nimport { Duration, Effect, Option } from \"effect\";\nimport type { Hash, TransactionReceipt } from \"viem\";\nimport type { SafeMultisigTxLookupError } from \"./errors.js\";\nimport { SafeAppsService } from \"./service.js\";\n\n// ---------------------------------------------------------------------------\n// Configuration defaults\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_POLL_INTERVAL = Duration.seconds(5);\nconst DEFAULT_MAX_WAIT = Duration.minutes(90);\nconst MIN_POLL_INTERVAL = Duration.seconds(1);\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type SafeMultisigWaitOptions = {\n  /** Polling interval (default: 5 seconds). Clamped to a minimum of 1 second. */\n  readonly interval?: Duration.DurationInput;\n  /** Maximum wait time (default: 90 minutes) */\n  readonly maxWait?: Duration.DurationInput;\n};\n\nexport type SafeMultisigWaitResult =\n  | { readonly _tag: \"success\"; readonly hash: Hash; readonly receipt: TransactionReceipt }\n  | { readonly _tag: \"queued\"; readonly safeTxHash: Hash }\n  | { readonly _tag: \"cancelled\" }\n  | { readonly _tag: \"failed\"; readonly error: string };\n\nexport type SafeMultisigTxStatus =\n  | \"awaiting_confirmations\"\n  | \"awaiting_execution\"\n  | \"pending\"\n  | \"success\"\n  | \"failed\";\n\n// ---------------------------------------------------------------------------\n// waitForSafeMultisigTx\n// ---------------------------------------------------------------------------\n\n/**\n * Poll a Safe multisig transaction until it reaches a terminal state or times out.\n *\n * Unlike `SafeAppsService.waitForTxReceipt` (which assumes execution will happen\n * in the current session), this utility handles the full lifecycle including\n * transactions that stay queued because other signers haven't signed yet.\n *\n * Terminal states: success (on-chain), cancelled, failed.\n * On timeout the safeTxHash is returned as \"queued\" so callers can persist it\n * for later resolution.\n *\n * @param safeTxHash  - The Safe transaction hash returned by `sendTxs`\n * @param getReceipt  - Caller-provided effect to fetch an on-chain receipt\n * @param options     - Optional polling configuration\n */\nexport const waitForSafeMultisigTx = Effect.fn(\"waitForSafeMultisigTx\")(function* (\n  safeTxHash: Hash,\n  getReceipt: (hash: Hash) => Effect.Effect<TransactionReceipt, SafeMultisigTxLookupError>,\n  options: SafeMultisigWaitOptions = {}\n) {\n  const interval = Duration.max(\n    Duration.decode(options.interval ?? DEFAULT_POLL_INTERVAL),\n    MIN_POLL_INTERVAL\n  );\n  const maxWait = Duration.decode(options.maxWait ?? DEFAULT_MAX_WAIT);\n  const maxAttempts = Math.floor(Duration.toMillis(maxWait) / Duration.toMillis(interval));\n\n  const safeApps = yield* SafeAppsService;\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    // --- Fetch tx status, classifying errors ---\n    const queuedResult = yield* safeApps.getTx(safeTxHash).pipe(\n      Effect.map(Option.some),\n      Effect.catchTag(\"SafeMultisigTxLookupError\", (error) => {\n        if (error.retryable) {\n          return Effect.logWarning(\"Retryable error polling Safe tx\").pipe(\n            Effect.annotateLogs({ attempt, error: error.message, safeTxHash }),\n            Effect.as(Option.none<{ txHash: Option.Option<Hash>; status: string }>())\n          );\n        }\n        // Terminal lookup error — stop polling immediately\n        return Effect.fail(error);\n      })\n    );\n\n    if (Option.isNone(queuedResult)) {\n      yield* Effect.sleep(interval);\n      continue;\n    }\n\n    const queued = queuedResult.value;\n    yield* Effect.logDebug(\"Safe tx poll status\").pipe(\n      Effect.annotateLogs({\n        attempt,\n        hash: Option.isSome(queued.txHash) ? queued.txHash.value : \"pending\",\n        safeTxHash,\n        status: queued.status,\n      })\n    );\n\n    // --- Terminal states ---\n\n    if (queued.status === \"CANCELLED\") {\n      return { _tag: \"cancelled\" as const } satisfies SafeMultisigWaitResult;\n    }\n\n    if (queued.status === \"FAILED\") {\n      return {\n        _tag: \"failed\" as const,\n        error: \"Safe transaction failed\",\n      } satisfies SafeMultisigWaitResult;\n    }\n\n    if (queued.status === \"SUCCESS\") {\n      if (Option.isNone(queued.txHash)) {\n        return {\n          _tag: \"failed\" as const,\n          error: \"Safe transaction succeeded but no on-chain hash available\",\n        } satisfies SafeMultisigWaitResult;\n      }\n      const txHash = queued.txHash.value as Hash;\n      const receipt = yield* getReceipt(txHash);\n      return {\n        _tag: \"success\" as const,\n        hash: txHash,\n        receipt,\n      } satisfies SafeMultisigWaitResult;\n    }\n\n    // Still pending — keep polling\n    yield* Effect.sleep(interval);\n  }\n\n  // Timed out without reaching a terminal state\n  yield* Effect.logWarning(\"Safe multisig transaction polling timeout\").pipe(\n    Effect.annotateLogs({\n      maxAttempts,\n      maxWaitMs: Duration.toMillis(maxWait),\n      safeTxHash,\n    })\n  );\n\n  return { _tag: \"queued\" as const, safeTxHash } satisfies SafeMultisigWaitResult;\n});\n\n// ---------------------------------------------------------------------------\n// getSafeMultisigTxStatus\n// ---------------------------------------------------------------------------\n\n/**\n * Fetch the current lifecycle status of a Safe multisig transaction.\n *\n * Maps the raw Safe API status string to a normalized union. Useful for\n * one-shot status checks (e.g. resuming after page reload) without starting\n * a polling loop.\n */\nexport const getSafeMultisigTxStatus = Effect.fn(\"getSafeMultisigTxStatus\")(function* (\n  safeTxHash: Hash\n) {\n  const safeApps = yield* SafeAppsService;\n  const queued = yield* safeApps.getTx(safeTxHash);\n\n  switch (queued.status) {\n    case \"AWAITING_CONFIRMATIONS\":\n      return \"awaiting_confirmations\";\n    case \"AWAITING_EXECUTION\":\n      return \"awaiting_execution\";\n    case \"SUCCESS\":\n      return \"success\";\n    // Both map to \"failed\" — use waitForSafeMultisigTx to distinguish cancelled vs failed\n    case \"CANCELLED\":\n    case \"FAILED\":\n      return \"failed\";\n    default:\n      return \"pending\";\n  }\n});\n"]}

package/package.json

@@ -6,7 +6,7 @@
   "sideEffects": false,
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "scripts": {
     "build": "just build",
     "prepack": "bun install --frozen-lockfile && just build"