@prb/effect-evm-safe 1.0.0-beta.0

package/dist/safe/service.d.ts

@@ -0,0 +1,26 @@
+import type { ClientNotFoundError, ReceiptTimeoutError, TxFailedError } from "@prb/effect-evm/core/errors";
+import type { Effect, Option } from "effect";
+import { Context } from "effect";
+import type { Hash, Hex } from "viem";
+import type { OffchainSignatureTimeoutError, SafeMultisigInfoUnavailableError, SafeMultisigSettingsError, SafeMultisigTxExecutionTimeoutError, SafeMultisigTxLookupError, SafeMultisigTxSubmissionError, SignTypedDataError } from "./errors.js";
+import type { EIP712TypedData, OffchainSignaturePolicy, OffchainSignatureResult, SafeMultisigInfo, SafeMultisigTx, SafeMultisigTxResult, SafeMultisigTxSubmission, SafeWaitPolicy, SignTypedDataResult } from "./types.js";
+export type SafeAppsServiceShape = {
+    readonly getInfo: () => Effect.Effect<SafeMultisigInfo, SafeMultisigInfoUnavailableError>;
+    readonly sendTxs: (txs: readonly SafeMultisigTx[], params?: {
+        safeTxGas?: number;
+    }) => Effect.Effect<SafeMultisigTxSubmission, SafeMultisigTxSubmissionError>;
+    readonly getTx: (safeTxHash: Hash) => Effect.Effect<{
+        txHash: Option.Option<Hash>;
+        status: string;
+    }, SafeMultisigTxLookupError>;
+    readonly waitForTxReceipt: (safeTxHash: Hash, policy?: SafeWaitPolicy) => Effect.Effect<SafeMultisigTxResult, SafeMultisigTxExecutionTimeoutError | SafeMultisigTxLookupError | TxFailedError | ReceiptTimeoutError | ClientNotFoundError>;
+    readonly signTypedData: (typedData: EIP712TypedData) => Effect.Effect<SignTypedDataResult, SignTypedDataError>;
+    readonly getOffchainSignature: (messageHash: Hex) => Effect.Effect<Option.Option<Hex>, SafeMultisigTxLookupError>;
+    readonly pollOffchainSignature: (messageHash: Hex, policy?: OffchainSignaturePolicy) => Effect.Effect<OffchainSignatureResult, OffchainSignatureTimeoutError | SafeMultisigTxLookupError>;
+    readonly enableOffchainSigning: () => Effect.Effect<void, SafeMultisigSettingsError>;
+};
+declare const SafeAppsService_base: Context.TagClass<SafeAppsService, "ew3/SafeApps", SafeAppsServiceShape>;
+export declare class SafeAppsService extends SafeAppsService_base {
+}
+export {};
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/safe/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACd,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,KAAK,EACV,6BAA6B,EAC7B,gCAAgC,EAChC,yBAAyB,EACzB,mCAAmC,EACnC,yBAAyB,EACzB,6BAA6B,EAC7B,kBAAkB,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,oBAAoB,GAAG;IAEjC,QAAQ,CAAC,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,gCAAgC,CAAC,CAAC;IAG1F,QAAQ,CAAC,OAAO,EAAE,CAChB,GAAG,EAAE,SAAS,cAAc,EAAE,EAC9B,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAC5B,MAAM,CAAC,MAAM,CAAC,wBAAwB,EAAE,6BAA6B,CAAC,CAAC;IAG5E,QAAQ,CAAC,KAAK,EAAE,CACd,UAAU,EAAE,IAAI,KACb,MAAM,CAAC,MAAM,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,yBAAyB,CAAC,CAAC;IAG/F,QAAQ,CAAC,gBAAgB,EAAE,CACzB,UAAU,EAAE,IAAI,EAChB,MAAM,CAAC,EAAE,cAAc,KACpB,MAAM,CAAC,MAAM,CAChB,oBAAoB,EAClB,mCAAmC,GACnC,yBAAyB,GACzB,aAAa,GACb,mBAAmB,GACnB,mBAAmB,CACtB,CAAC;IAGF,QAAQ,CAAC,aAAa,EAAE,CACtB,SAAS,EAAE,eAAe,KACvB,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAAC;IAG5D,QAAQ,CAAC,oBAAoB,EAAE,CAC7B,WAAW,EAAE,GAAG,KACb,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,yBAAyB,CAAC,CAAC;IAGlE,QAAQ,CAAC,qBAAqB,EAAE,CAC9B,WAAW,EAAE,GAAG,EAChB,MAAM,CAAC,EAAE,uBAAuB,KAC7B,MAAM,CAAC,MAAM,CAChB,uBAAuB,EACvB,6BAA6B,GAAG,yBAAyB,CAC1D,CAAC;IAGF,QAAQ,CAAC,qBAAqB,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC;CACtF,CAAC;;AAEF,qBAAa,eAAgB,SAAQ,oBAGlC;CAAG"}

package/dist/safe/service.js

@@ -0,0 +1,4 @@
+import { Context } from "effect";
+export class SafeAppsService extends Context.Tag("ew3/SafeApps")() {
+}
+//# sourceMappingURL=service.js.map

package/dist/safe/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/safe/service.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AA0EjC,MAAM,OAAO,eAAgB,SAAQ,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAG7D;CAAG","sourcesContent":["import type {\n  ClientNotFoundError,\n  ReceiptTimeoutError,\n  TxFailedError,\n} from \"@prb/effect-evm/core/errors\";\nimport type { Effect, Option } from \"effect\";\nimport { Context } from \"effect\";\nimport type { Hash, Hex } from \"viem\";\nimport type {\n  OffchainSignatureTimeoutError,\n  SafeMultisigInfoUnavailableError,\n  SafeMultisigSettingsError,\n  SafeMultisigTxExecutionTimeoutError,\n  SafeMultisigTxLookupError,\n  SafeMultisigTxSubmissionError,\n  SignTypedDataError,\n} from \"./errors.js\";\nimport type {\n  EIP712TypedData,\n  OffchainSignaturePolicy,\n  OffchainSignatureResult,\n  SafeMultisigInfo,\n  SafeMultisigTx,\n  SafeMultisigTxResult,\n  SafeMultisigTxSubmission,\n  SafeWaitPolicy,\n  SignTypedDataResult,\n} from \"./types.js\";\n\nexport type SafeAppsServiceShape = {\n  /** Get Safe info (cached after first call) */\n  readonly getInfo: () => Effect.Effect<SafeMultisigInfo, SafeMultisigInfoUnavailableError>;\n\n  /** Send txs to Safe for execution */\n  readonly sendTxs: (\n    txs: readonly SafeMultisigTx[],\n    params?: { safeTxGas?: number }\n  ) => Effect.Effect<SafeMultisigTxSubmission, SafeMultisigTxSubmissionError>;\n\n  /** Get Safe tx details by safeTxHash */\n  readonly getTx: (\n    safeTxHash: Hash\n  ) => Effect.Effect<{ txHash: Option.Option<Hash>; status: string }, SafeMultisigTxLookupError>;\n\n  /** Wait for Safe tx to execute and return receipt */\n  readonly waitForTxReceipt: (\n    safeTxHash: Hash,\n    policy?: SafeWaitPolicy\n  ) => Effect.Effect<\n    SafeMultisigTxResult,\n    | SafeMultisigTxExecutionTimeoutError\n    | SafeMultisigTxLookupError\n    | TxFailedError\n    | ReceiptTimeoutError\n    | ClientNotFoundError\n  >;\n\n  /** Sign typed data (returns discriminated union based on Safe settings) */\n  readonly signTypedData: (\n    typedData: EIP712TypedData\n  ) => Effect.Effect<SignTypedDataResult, SignTypedDataError>;\n\n  /** Get off-chain signature (returns Option.none if not yet available) */\n  readonly getOffchainSignature: (\n    messageHash: Hex\n  ) => Effect.Effect<Option.Option<Hex>, SafeMultisigTxLookupError>;\n\n  /** Poll for off-chain signature until available or timeout */\n  readonly pollOffchainSignature: (\n    messageHash: Hex,\n    policy?: OffchainSignaturePolicy\n  ) => Effect.Effect<\n    OffchainSignatureResult,\n    OffchainSignatureTimeoutError | SafeMultisigTxLookupError\n  >;\n\n  /** Enable off-chain signing mode */\n  readonly enableOffchainSigning: () => Effect.Effect<void, SafeMultisigSettingsError>;\n};\n\nexport class SafeAppsService extends Context.Tag(\"ew3/SafeApps\")<\n  SafeAppsService,\n  SafeAppsServiceShape\n>() {}\n"]}

package/dist/safe/service.test.integration.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=service.test.integration.d.ts.map

package/dist/safe/service.test.integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.test.integration.d.ts","sourceRoot":"","sources":["../../src/safe/service.test.integration.ts"],"names":[],"mappings":""}

package/dist/safe/service.test.integration.js

@@ -0,0 +1,171 @@
+import { describe, expect, it } from "@effect/vitest";
+import { MIN_TX_GAS } from "@prb/effect-evm/constants";
+import { TEST_ADDRESS, TEST_CHAIN_ID, TEST_TX_HASH } from "@prb/effect-evm/testing-kit";
+import { Effect, Layer, Option } from "effect";
+import { SafeAppsService } from "./service.js";
+const TEST_SAFE_ADDRESS = TEST_ADDRESS;
+const TEST_SAFE_TX_HASH = "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef";
+const TEST_MESSAGE_HASH = "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890";
+const TEST_SIGNATURE = "0xsignature";
+const TEST_RECEIPT = {
+    blockHash: "0xblock",
+    blockNumber: 123n,
+    contractAddress: null,
+    cumulativeGasUsed: MIN_TX_GAS,
+    effectiveGasPrice: 1n,
+    from: "0xfrom",
+    gasUsed: MIN_TX_GAS,
+    logs: [],
+    logsBloom: "0x",
+    status: "success",
+    to: "0xto",
+    transactionHash: TEST_TX_HASH,
+    transactionIndex: 0,
+    type: "0x2",
+};
+const makeMockSafeAppsService = (config) => {
+    const defaultInfo = {
+        chainId: TEST_CHAIN_ID,
+        safeAddress: TEST_SAFE_ADDRESS,
+    };
+    return Layer.succeed(SafeAppsService, SafeAppsService.of({
+        enableOffchainSigning: () => Effect.void,
+        getInfo: () => Effect.succeed(config.getInfoResult ?? defaultInfo),
+        getOffchainSignature: () => Effect.succeed(config.offchainSignature ?? Option.none()),
+        getTx: () => Effect.succeed(config.getTxResult ?? {
+            status: "AWAITING_EXECUTION",
+            txHash: Option.some(TEST_TX_HASH),
+        }),
+        pollOffchainSignature: (messageHash) => Effect.succeed({ messageHash, signature: TEST_SIGNATURE }),
+        sendTxs: () => Effect.succeed({
+            chainId: TEST_CHAIN_ID,
+            safeAddress: TEST_SAFE_ADDRESS,
+            safeTxHash: config.sendTxResult?.safeTxHash ?? TEST_SAFE_TX_HASH,
+        }),
+        signTypedData: () => Effect.succeed(config.signTypedDataResult ?? {
+            _tag: "Onchain",
+            safeTxHash: TEST_SAFE_TX_HASH,
+        }),
+        waitForTxReceipt: (safeTxHash) => Effect.succeed({
+            chainId: TEST_CHAIN_ID,
+            onchainHash: TEST_TX_HASH,
+            receipt: TEST_RECEIPT,
+            safeAddress: TEST_SAFE_ADDRESS,
+            safeTxHash,
+        }),
+    }));
+};
+describe("SafeAppsService", () => {
+    describe("getInfo", () => {
+        it.effect("returns Safe info with address and chainId", () => Effect.gen(function* () {
+            const service = yield* SafeAppsService;
+            const info = yield* service.getInfo();
+            expect(info.safeAddress).toBe(TEST_SAFE_ADDRESS);
+            expect(info.chainId).toBe(TEST_CHAIN_ID);
+        }).pipe(Effect.provide(makeMockSafeAppsService({}))));
+    });
+    describe("sendTxs", () => {
+        it.effect("returns safeTxHash with safeAddress and chainId", () => Effect.gen(function* () {
+            const service = yield* SafeAppsService;
+            const result = yield* service.sendTxs([{ data: "0x", to: TEST_ADDRESS, value: 0n }]);
+            expect(result.safeTxHash).toBe(TEST_SAFE_TX_HASH);
+            expect(result.safeAddress).toBe(TEST_SAFE_ADDRESS);
+            expect(result.chainId).toBe(TEST_CHAIN_ID);
+        }).pipe(Effect.provide(makeMockSafeAppsService({}))));
+    });
+    describe("getTx", () => {
+        it.effect("returns txHash as Option when executed", () => Effect.gen(function* () {
+            const service = yield* SafeAppsService;
+            const result = yield* service.getTx(TEST_SAFE_TX_HASH);
+            expect(Option.isSome(result.txHash)).toBe(true);
+            if (Option.isSome(result.txHash)) {
+                expect(result.txHash.value).toBe(TEST_TX_HASH);
+            }
+        }).pipe(Effect.provide(makeMockSafeAppsService({}))));
+        it.effect("returns Option.none when not yet executed", () => Effect.gen(function* () {
+            const service = yield* SafeAppsService;
+            const result = yield* service.getTx(TEST_SAFE_TX_HASH);
+            expect(Option.isNone(result.txHash)).toBe(true);
+            expect(result.status).toBe("AWAITING_CONFIRMATIONS");
+        }).pipe(Effect.provide(makeMockSafeAppsService({
+            getTxResult: {
+                status: "AWAITING_CONFIRMATIONS",
+                txHash: Option.none(),
+            },
+        }))));
+    });
+    describe("waitForTxReceipt", () => {
+        it.effect("returns SafeTxResult with receipt", () => Effect.gen(function* () {
+            const service = yield* SafeAppsService;
+            const result = yield* service.waitForTxReceipt(TEST_SAFE_TX_HASH);
+            expect(result.safeTxHash).toBe(TEST_SAFE_TX_HASH);
+            expect(result.onchainHash).toBe(TEST_TX_HASH);
+            expect(result.receipt.status).toBe("success");
+            expect(result.safeAddress).toBe(TEST_SAFE_ADDRESS);
+            expect(result.chainId).toBe(TEST_CHAIN_ID);
+        }).pipe(Effect.provide(makeMockSafeAppsService({}))));
+    });
+    describe("signTypedData", () => {
+        it.effect("returns Onchain variant for on-chain signing", () => Effect.gen(function* () {
+            const service = yield* SafeAppsService;
+            const result = yield* service.signTypedData({
+                domain: { chainId: 1, name: "Test" },
+                message: { value: "test" },
+                types: { Test: [{ name: "value", type: "string" }] },
+            });
+            expect(result._tag).toBe("Onchain");
+            if (result._tag === "Onchain") {
+                expect(result.safeTxHash).toBe(TEST_SAFE_TX_HASH);
+            }
+        }).pipe(Effect.provide(makeMockSafeAppsService({}))));
+        it.effect("returns Offchain variant for off-chain signing", () => Effect.gen(function* () {
+            const service = yield* SafeAppsService;
+            const result = yield* service.signTypedData({
+                domain: { chainId: 1, name: "Test" },
+                message: { value: "test" },
+                types: { Test: [{ name: "value", type: "string" }] },
+            });
+            expect(result._tag).toBe("Offchain");
+            if (result._tag === "Offchain") {
+                expect(result.messageHash).toBe(TEST_MESSAGE_HASH);
+            }
+        }).pipe(Effect.provide(makeMockSafeAppsService({
+            signTypedDataResult: {
+                _tag: "Offchain",
+                messageHash: TEST_MESSAGE_HASH,
+            },
+        }))));
+    });
+    describe("getOffchainSignature", () => {
+        it.effect("returns Option.none when signature not yet available", () => Effect.gen(function* () {
+            const service = yield* SafeAppsService;
+            const result = yield* service.getOffchainSignature(TEST_MESSAGE_HASH);
+            expect(Option.isNone(result)).toBe(true);
+        }).pipe(Effect.provide(makeMockSafeAppsService({}))));
+        it.effect("returns Option.some when signature available", () => Effect.gen(function* () {
+            const service = yield* SafeAppsService;
+            const result = yield* service.getOffchainSignature(TEST_MESSAGE_HASH);
+            expect(Option.isSome(result)).toBe(true);
+            if (Option.isSome(result)) {
+                expect(result.value).toBe(TEST_SIGNATURE);
+            }
+        }).pipe(Effect.provide(makeMockSafeAppsService({
+            offchainSignature: Option.some(TEST_SIGNATURE),
+        }))));
+    });
+    describe("pollOffchainSignature", () => {
+        it.effect("returns signature when available", () => Effect.gen(function* () {
+            const service = yield* SafeAppsService;
+            const result = yield* service.pollOffchainSignature(TEST_MESSAGE_HASH);
+            expect(result.messageHash).toBe(TEST_MESSAGE_HASH);
+            expect(result.signature).toBe(TEST_SIGNATURE);
+        }).pipe(Effect.provide(makeMockSafeAppsService({}))));
+    });
+    describe("enableOffchainSigning", () => {
+        it.effect("completes without error", () => Effect.gen(function* () {
+            const service = yield* SafeAppsService;
+            yield* service.enableOffchainSigning();
+        }).pipe(Effect.provide(makeMockSafeAppsService({}))));
+    });
+});
+//# sourceMappingURL=service.test.integration.js.map

package/dist/safe/service.test.integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.test.integration.js","sourceRoot":"","sources":["../../src/safe/service.test.integration.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from \"@effect/vitest\";\nimport { MIN_TX_GAS } from \"@prb/effect-evm/constants\";\nimport { TEST_ADDRESS, TEST_CHAIN_ID, TEST_TX_HASH } from \"@prb/effect-evm/testing-kit\";\nimport { Effect, Layer, Option } from \"effect\";\nimport type { Hash, Hex, TransactionReceipt } from \"viem\";\nimport { SafeAppsService } from \"./service.js\";\nimport type { SafeMultisigInfo } from \"./types.js\";\n\n// Test fixtures\nconst TEST_SAFE_ADDRESS = TEST_ADDRESS;\nconst TEST_SAFE_TX_HASH =\n  \"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef\" as Hash;\nconst TEST_MESSAGE_HASH =\n  \"0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890\" as Hex;\nconst TEST_SIGNATURE = \"0xsignature\" as Hex;\n\nconst TEST_RECEIPT: TransactionReceipt = {\n  blockHash: \"0xblock\",\n  blockNumber: 123n,\n  contractAddress: null,\n  cumulativeGasUsed: MIN_TX_GAS,\n  effectiveGasPrice: 1n,\n  from: \"0xfrom\",\n  gasUsed: MIN_TX_GAS,\n  logs: [],\n  logsBloom: \"0x\",\n  status: \"success\",\n  to: \"0xto\",\n  transactionHash: TEST_TX_HASH,\n  transactionIndex: 0,\n  type: \"0x2\",\n};\n\n// Mock SafeAppsService for testing without actual SDK\nconst makeMockSafeAppsService = (config: {\n  getInfoResult?: SafeMultisigInfo;\n  sendTxResult?: { safeTxHash: Hash };\n  getTxResult?: { txHash: Option.Option<Hash>; status: string };\n  signTypedDataResult?:\n    | { _tag: \"Offchain\"; messageHash: Hex }\n    | { _tag: \"Onchain\"; safeTxHash: Hash };\n  offchainSignature?: Option.Option<Hex>;\n}) => {\n  const defaultInfo: SafeMultisigInfo = {\n    chainId: TEST_CHAIN_ID,\n    safeAddress: TEST_SAFE_ADDRESS,\n  };\n\n  return Layer.succeed(\n    SafeAppsService,\n    SafeAppsService.of({\n      enableOffchainSigning: () => Effect.void,\n      getInfo: () => Effect.succeed(config.getInfoResult ?? defaultInfo),\n      getOffchainSignature: () => Effect.succeed(config.offchainSignature ?? Option.none()),\n      getTx: () =>\n        Effect.succeed(\n          config.getTxResult ?? {\n            status: \"AWAITING_EXECUTION\",\n            txHash: Option.some(TEST_TX_HASH),\n          }\n        ),\n      pollOffchainSignature: (messageHash) =>\n        Effect.succeed({ messageHash, signature: TEST_SIGNATURE }),\n      sendTxs: () =>\n        Effect.succeed({\n          chainId: TEST_CHAIN_ID,\n          safeAddress: TEST_SAFE_ADDRESS,\n          safeTxHash: config.sendTxResult?.safeTxHash ?? TEST_SAFE_TX_HASH,\n        }),\n      signTypedData: () =>\n        Effect.succeed(\n          config.signTypedDataResult ?? {\n            _tag: \"Onchain\" as const,\n            safeTxHash: TEST_SAFE_TX_HASH,\n          }\n        ),\n      waitForTxReceipt: (safeTxHash) =>\n        Effect.succeed({\n          chainId: TEST_CHAIN_ID,\n          onchainHash: TEST_TX_HASH,\n          receipt: TEST_RECEIPT,\n          safeAddress: TEST_SAFE_ADDRESS,\n          safeTxHash,\n        }),\n    })\n  );\n};\n\ndescribe(\"SafeAppsService\", () => {\n  describe(\"getInfo\", () => {\n    it.effect(\"returns Safe info with address and chainId\", () =>\n      Effect.gen(function* () {\n        const service = yield* SafeAppsService;\n        const info = yield* service.getInfo();\n\n        expect(info.safeAddress).toBe(TEST_SAFE_ADDRESS);\n        expect(info.chainId).toBe(TEST_CHAIN_ID);\n      }).pipe(Effect.provide(makeMockSafeAppsService({})))\n    );\n  });\n\n  describe(\"sendTxs\", () => {\n    it.effect(\"returns safeTxHash with safeAddress and chainId\", () =>\n      Effect.gen(function* () {\n        const service = yield* SafeAppsService;\n        const result = yield* service.sendTxs([{ data: \"0x\", to: TEST_ADDRESS, value: 0n }]);\n\n        expect(result.safeTxHash).toBe(TEST_SAFE_TX_HASH);\n        expect(result.safeAddress).toBe(TEST_SAFE_ADDRESS);\n        expect(result.chainId).toBe(TEST_CHAIN_ID);\n      }).pipe(Effect.provide(makeMockSafeAppsService({})))\n    );\n  });\n\n  describe(\"getTx\", () => {\n    it.effect(\"returns txHash as Option when executed\", () =>\n      Effect.gen(function* () {\n        const service = yield* SafeAppsService;\n        const result = yield* service.getTx(TEST_SAFE_TX_HASH);\n\n        expect(Option.isSome(result.txHash)).toBe(true);\n        if (Option.isSome(result.txHash)) {\n          expect(result.txHash.value).toBe(TEST_TX_HASH);\n        }\n      }).pipe(Effect.provide(makeMockSafeAppsService({})))\n    );\n\n    it.effect(\"returns Option.none when not yet executed\", () =>\n      Effect.gen(function* () {\n        const service = yield* SafeAppsService;\n        const result = yield* service.getTx(TEST_SAFE_TX_HASH);\n\n        expect(Option.isNone(result.txHash)).toBe(true);\n        expect(result.status).toBe(\"AWAITING_CONFIRMATIONS\");\n      }).pipe(\n        Effect.provide(\n          makeMockSafeAppsService({\n            getTxResult: {\n              status: \"AWAITING_CONFIRMATIONS\",\n              txHash: Option.none(),\n            },\n          })\n        )\n      )\n    );\n  });\n\n  describe(\"waitForTxReceipt\", () => {\n    it.effect(\"returns SafeTxResult with receipt\", () =>\n      Effect.gen(function* () {\n        const service = yield* SafeAppsService;\n        const result = yield* service.waitForTxReceipt(TEST_SAFE_TX_HASH);\n\n        expect(result.safeTxHash).toBe(TEST_SAFE_TX_HASH);\n        expect(result.onchainHash).toBe(TEST_TX_HASH);\n        expect(result.receipt.status).toBe(\"success\");\n        expect(result.safeAddress).toBe(TEST_SAFE_ADDRESS);\n        expect(result.chainId).toBe(TEST_CHAIN_ID);\n      }).pipe(Effect.provide(makeMockSafeAppsService({})))\n    );\n  });\n\n  describe(\"signTypedData\", () => {\n    it.effect(\"returns Onchain variant for on-chain signing\", () =>\n      Effect.gen(function* () {\n        const service = yield* SafeAppsService;\n        const result = yield* service.signTypedData({\n          domain: { chainId: 1, name: \"Test\" },\n          message: { value: \"test\" },\n          types: { Test: [{ name: \"value\", type: \"string\" }] },\n        });\n\n        expect(result._tag).toBe(\"Onchain\");\n        if (result._tag === \"Onchain\") {\n          expect(result.safeTxHash).toBe(TEST_SAFE_TX_HASH);\n        }\n      }).pipe(Effect.provide(makeMockSafeAppsService({})))\n    );\n\n    it.effect(\"returns Offchain variant for off-chain signing\", () =>\n      Effect.gen(function* () {\n        const service = yield* SafeAppsService;\n        const result = yield* service.signTypedData({\n          domain: { chainId: 1, name: \"Test\" },\n          message: { value: \"test\" },\n          types: { Test: [{ name: \"value\", type: \"string\" }] },\n        });\n\n        expect(result._tag).toBe(\"Offchain\");\n        if (result._tag === \"Offchain\") {\n          expect(result.messageHash).toBe(TEST_MESSAGE_HASH);\n        }\n      }).pipe(\n        Effect.provide(\n          makeMockSafeAppsService({\n            signTypedDataResult: {\n              _tag: \"Offchain\",\n              messageHash: TEST_MESSAGE_HASH,\n            },\n          })\n        )\n      )\n    );\n  });\n\n  describe(\"getOffchainSignature\", () => {\n    it.effect(\"returns Option.none when signature not yet available\", () =>\n      Effect.gen(function* () {\n        const service = yield* SafeAppsService;\n        const result = yield* service.getOffchainSignature(TEST_MESSAGE_HASH);\n\n        expect(Option.isNone(result)).toBe(true);\n      }).pipe(Effect.provide(makeMockSafeAppsService({})))\n    );\n\n    it.effect(\"returns Option.some when signature available\", () =>\n      Effect.gen(function* () {\n        const service = yield* SafeAppsService;\n        const result = yield* service.getOffchainSignature(TEST_MESSAGE_HASH);\n\n        expect(Option.isSome(result)).toBe(true);\n        if (Option.isSome(result)) {\n          expect(result.value).toBe(TEST_SIGNATURE);\n        }\n      }).pipe(\n        Effect.provide(\n          makeMockSafeAppsService({\n            offchainSignature: Option.some(TEST_SIGNATURE),\n          })\n        )\n      )\n    );\n  });\n\n  describe(\"pollOffchainSignature\", () => {\n    it.effect(\"returns signature when available\", () =>\n      Effect.gen(function* () {\n        const service = yield* SafeAppsService;\n        const result = yield* service.pollOffchainSignature(TEST_MESSAGE_HASH);\n\n        expect(result.messageHash).toBe(TEST_MESSAGE_HASH);\n        expect(result.signature).toBe(TEST_SIGNATURE);\n      }).pipe(Effect.provide(makeMockSafeAppsService({})))\n    );\n  });\n\n  describe(\"enableOffchainSigning\", () => {\n    it.effect(\"completes without error\", () =>\n      Effect.gen(function* () {\n        const service = yield* SafeAppsService;\n        yield* service.enableOffchainSigning();\n        // Success if no error thrown\n      }).pipe(Effect.provide(makeMockSafeAppsService({})))\n    );\n  });\n});\n"]}

package/dist/safe/simulation/abis.d.ts

@@ -0,0 +1,73 @@
+export declare const safeAbis: {
+    readonly multiSend: readonly [{
+        readonly inputs: readonly [{
+            readonly internalType: "bytes";
+            readonly name: "transactions";
+            readonly type: "bytes";
+        }];
+        readonly name: "multiSend";
+        readonly outputs: readonly [];
+        readonly stateMutability: "payable";
+        readonly type: "function";
+    }];
+    readonly multisig: readonly [{
+        readonly inputs: readonly [];
+        readonly name: "getOwners";
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly type: "address[]";
+        }];
+        readonly stateMutability: "view";
+        readonly type: "function";
+    }, {
+        readonly inputs: readonly [{
+            readonly internalType: "address";
+            readonly name: "targetContract";
+            readonly type: "address";
+        }, {
+            readonly internalType: "bytes";
+            readonly name: "calldataPayload";
+            readonly type: "bytes";
+        }];
+        readonly name: "simulateAndRevert";
+        readonly outputs: readonly [];
+        readonly stateMutability: "nonpayable";
+        readonly type: "function";
+    }];
+    readonly simulateAccessor: readonly [{
+        readonly inputs: readonly [{
+            readonly internalType: "address";
+            readonly name: "to";
+            readonly type: "address";
+        }, {
+            readonly internalType: "uint256";
+            readonly name: "value";
+            readonly type: "uint256";
+        }, {
+            readonly internalType: "bytes";
+            readonly name: "data";
+            readonly type: "bytes";
+        }, {
+            readonly internalType: "enum Enum.Operation";
+            readonly name: "operation";
+            readonly type: "uint8";
+        }];
+        readonly name: "simulate";
+        readonly outputs: readonly [{
+            readonly internalType: "uint256";
+            readonly name: "estimate";
+            readonly type: "uint256";
+        }, {
+            readonly internalType: "bool";
+            readonly name: "success";
+            readonly type: "bool";
+        }, {
+            readonly internalType: "bytes";
+            readonly name: "returnData";
+            readonly type: "bytes";
+        }];
+        readonly stateMutability: "nonpayable";
+        readonly type: "function";
+    }];
+};
+//# sourceMappingURL=abis.d.ts.map

package/dist/safe/simulation/abis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abis.d.ts","sourceRoot":"","sources":["../../../src/safe/simulation/abis.ts"],"names":[],"mappings":"AAkEA,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAIX,CAAC"}

package/dist/safe/simulation/abis.js

@@ -0,0 +1,61 @@
+const multisigAbi = [
+    {
+        inputs: [],
+        name: "getOwners",
+        outputs: [
+            {
+                name: "",
+                type: "address[]",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+    {
+        inputs: [
+            { internalType: "address", name: "targetContract", type: "address" },
+            { internalType: "bytes", name: "calldataPayload", type: "bytes" },
+        ],
+        name: "simulateAndRevert",
+        outputs: [],
+        stateMutability: "nonpayable",
+        type: "function",
+    },
+];
+const multiSendAbi = [
+    {
+        inputs: [{ internalType: "bytes", name: "transactions", type: "bytes" }],
+        name: "multiSend",
+        outputs: [],
+        stateMutability: "payable",
+        type: "function",
+    },
+];
+const simulateAccessorAbi = [
+    {
+        inputs: [
+            { internalType: "address", name: "to", type: "address" },
+            { internalType: "uint256", name: "value", type: "uint256" },
+            { internalType: "bytes", name: "data", type: "bytes" },
+            {
+                internalType: "enum Enum.Operation",
+                name: "operation",
+                type: "uint8",
+            },
+        ],
+        name: "simulate",
+        outputs: [
+            { internalType: "uint256", name: "estimate", type: "uint256" },
+            { internalType: "bool", name: "success", type: "bool" },
+            { internalType: "bytes", name: "returnData", type: "bytes" },
+        ],
+        stateMutability: "nonpayable",
+        type: "function",
+    },
+];
+export const safeAbis = {
+    multiSend: multiSendAbi,
+    multisig: multisigAbi,
+    simulateAccessor: simulateAccessorAbi,
+};
+//# sourceMappingURL=abis.js.map

package/dist/safe/simulation/abis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abis.js","sourceRoot":"","sources":["../../../src/safe/simulation/abis.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,GAAG;IAClB;QACE,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE,WAAW;aAClB;SACF;QACD,eAAe,EAAE,MAAM;QACvB,IAAI,EAAE,UAAU;KACjB;IACD;QACE,MAAM,EAAE;YACN,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE;YACpE,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,OAAO,EAAE;SAClE;QACD,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,EAAE;QACX,eAAe,EAAE,YAAY;QAC7B,IAAI,EAAE,UAAU;KACjB;CACO,CAAC;AAEX,MAAM,YAAY,GAAG;IACnB;QACE,MAAM,EAAE,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACxE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,EAAE;QACX,eAAe,EAAE,SAAS;QAC1B,IAAI,EAAE,UAAU;KACjB;CACO,CAAC;AAEX,MAAM,mBAAmB,GAAG;IAC1B;QACE,MAAM,EAAE;YACN,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;YACxD,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAC3D,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE;YACtD;gBACE,YAAY,EAAE,qBAAqB;gBACnC,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,OAAO;aACd;SACF;QACD,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE;YACP,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;YAC9D,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE;YACvD,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE;SAC7D;QACD,eAAe,EAAE,YAAY;QAC7B,IAAI,EAAE,UAAU;KACjB;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,SAAS,EAAE,YAAY;IACvB,QAAQ,EAAE,WAAW;IACrB,gBAAgB,EAAE,mBAAmB;CAC7B,CAAC","sourcesContent":["/**\n * Safe multisig ABIs for gas simulation and multi-send operations.\n *\n * @see https://github.com/safe-global/safe-deployments\n * @see https://github.com/safe-global/safe-core-sdk/issues/1182\n * @see https://ethereum.stackexchange.com/q/168410/24693\n */\n\nconst multisigAbi = [\n  {\n    inputs: [],\n    name: \"getOwners\",\n    outputs: [\n      {\n        name: \"\",\n        type: \"address[]\",\n      },\n    ],\n    stateMutability: \"view\",\n    type: \"function\",\n  },\n  {\n    inputs: [\n      { internalType: \"address\", name: \"targetContract\", type: \"address\" },\n      { internalType: \"bytes\", name: \"calldataPayload\", type: \"bytes\" },\n    ],\n    name: \"simulateAndRevert\",\n    outputs: [],\n    stateMutability: \"nonpayable\",\n    type: \"function\",\n  },\n] as const;\n\nconst multiSendAbi = [\n  {\n    inputs: [{ internalType: \"bytes\", name: \"transactions\", type: \"bytes\" }],\n    name: \"multiSend\",\n    outputs: [],\n    stateMutability: \"payable\",\n    type: \"function\",\n  },\n] as const;\n\nconst simulateAccessorAbi = [\n  {\n    inputs: [\n      { internalType: \"address\", name: \"to\", type: \"address\" },\n      { internalType: \"uint256\", name: \"value\", type: \"uint256\" },\n      { internalType: \"bytes\", name: \"data\", type: \"bytes\" },\n      {\n        internalType: \"enum Enum.Operation\",\n        name: \"operation\",\n        type: \"uint8\",\n      },\n    ],\n    name: \"simulate\",\n    outputs: [\n      { internalType: \"uint256\", name: \"estimate\", type: \"uint256\" },\n      { internalType: \"bool\", name: \"success\", type: \"bool\" },\n      { internalType: \"bytes\", name: \"returnData\", type: \"bytes\" },\n    ],\n    stateMutability: \"nonpayable\",\n    type: \"function\",\n  },\n] as const;\n\nexport const safeAbis = {\n  multiSend: multiSendAbi,\n  multisig: multisigAbi,\n  simulateAccessor: simulateAccessorAbi,\n} as const;\n"]}

package/dist/safe/simulation/addresses.d.ts

@@ -0,0 +1,4 @@
+import type { Address } from "viem";
+export declare function getMultiSendAddress(chainId: number): Address | undefined;
+export declare function getSimulateAccessorAddress(chainId: number): Address | undefined;
+//# sourceMappingURL=addresses.d.ts.map

package/dist/safe/simulation/addresses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.d.ts","sourceRoot":"","sources":["../../../src/safe/simulation/addresses.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAkFpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAmBxE;AAOD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAmB/E"}

package/dist/safe/simulation/addresses.js

@@ -0,0 +1,56 @@
+import { abstract, arbitrum, avalanche, base, baseSepolia, berachain, blast, bsc, gnosis, lightlinkPhoenix, linea, mainnet, mode, monad, morph, optimism, polygon, scroll, sei, sepolia, sonic, unichainSepolia, xdc, zksync, } from "viem/chains";
+const MULTI_SEND_CHAIN_IDS = [
+    abstract.id,
+    arbitrum.id,
+    avalanche.id,
+    base.id,
+    baseSepolia.id,
+    berachain.id,
+    blast.id,
+    bsc.id,
+    gnosis.id,
+    lightlinkPhoenix.id,
+    linea.id,
+    mainnet.id,
+    mode.id,
+    monad.id,
+    morph.id,
+    optimism.id,
+    polygon.id,
+    scroll.id,
+    sei.id,
+    sepolia.id,
+    sonic.id,
+    unichainSepolia.id,
+    xdc.id,
+    zksync.id,
+];
+const ZK_ROLLUP_CHAIN_IDS = [abstract.id, zksync.id];
+const CUSTOM_DEPLOYMENT_CHAIN_IDS = [lightlinkPhoenix.id, xdc.id];
+const CANONICAL_MULTI_SEND_ADDRESS = "0x9641d764fc13c8B624c04430C7356C1C7C8102e2";
+const CANONICAL_SIMULATE_ACCESSOR_ADDRESS = "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199";
+export function getMultiSendAddress(chainId) {
+    if (!MULTI_SEND_CHAIN_IDS.includes(chainId)) {
+        return undefined;
+    }
+    if (ZK_ROLLUP_CHAIN_IDS.includes(chainId)) {
+        return "0xf220D3b4DFb23C4ade8C88E526C1353AbAcbC38F";
+    }
+    if (CUSTOM_DEPLOYMENT_CHAIN_IDS.includes(chainId)) {
+        return "0x40A2aCCbd92BCA938b02010E17A5b8929b49130D";
+    }
+    return CANONICAL_MULTI_SEND_ADDRESS;
+}
+export function getSimulateAccessorAddress(chainId) {
+    if (!MULTI_SEND_CHAIN_IDS.includes(chainId)) {
+        return undefined;
+    }
+    if (ZK_ROLLUP_CHAIN_IDS.includes(chainId)) {
+        return "0x4191E2e12E8BC5002424CE0c51f9947b02675a44";
+    }
+    if (CUSTOM_DEPLOYMENT_CHAIN_IDS.includes(chainId)) {
+        return "0x59AD6735bCd8152B84860Cb256dD9e96b85F69Da";
+    }
+    return CANONICAL_SIMULATE_ACCESSOR_ADDRESS;
+}
+//# sourceMappingURL=addresses.js.map

package/dist/safe/simulation/addresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.js","sourceRoot":"","sources":["../../../src/safe/simulation/addresses.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,WAAW,EACX,SAAS,EACT,KAAK,EACL,GAAG,EACH,MAAM,EACN,gBAAgB,EAChB,KAAK,EACL,OAAO,EACP,IAAI,EACJ,KAAK,EACL,KAAK,EACL,QAAQ,EACR,OAAO,EACP,MAAM,EACN,GAAG,EACH,OAAO,EACP,KAAK,EACL,eAAe,EACf,GAAG,EACH,MAAM,GACP,MAAM,aAAa,CAAC;AAQrB,MAAM,oBAAoB,GAAG;IAC3B,QAAQ,CAAC,EAAE;IACX,QAAQ,CAAC,EAAE;IACX,SAAS,CAAC,EAAE;IACZ,IAAI,CAAC,EAAE;IACP,WAAW,CAAC,EAAE;IACd,SAAS,CAAC,EAAE;IACZ,KAAK,CAAC,EAAE;IACR,GAAG,CAAC,EAAE;IACN,MAAM,CAAC,EAAE;IACT,gBAAgB,CAAC,EAAE;IACnB,KAAK,CAAC,EAAE;IACR,OAAO,CAAC,EAAE;IACV,IAAI,CAAC,EAAE;IACP,KAAK,CAAC,EAAE;IACR,KAAK,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE;IACX,OAAO,CAAC,EAAE;IACV,MAAM,CAAC,EAAE;IACT,GAAG,CAAC,EAAE;IACN,OAAO,CAAC,EAAE;IACV,KAAK,CAAC,EAAE;IACR,eAAe,CAAC,EAAE;IAClB,GAAG,CAAC,EAAE;IACN,MAAM,CAAC,EAAE;CACD,CAAC;AAGX,MAAM,mBAAmB,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAU,CAAC;AAG9D,MAAM,2BAA2B,GAAG,CAAC,gBAAgB,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAU,CAAC;AAO3E,MAAM,4BAA4B,GAAY,4CAA4C,CAAC;AAG3F,MAAM,mCAAmC,GAAY,4CAA4C,CAAC;AAOlG,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,OAAgD,CAAC,EAAE,CAAC;QACrF,OAAO,SAAS,CAAC;IACnB,CAAC;IAGD,IAAI,mBAAmB,CAAC,QAAQ,CAAC,OAA+C,CAAC,EAAE,CAAC;QAClF,OAAO,4CAA4C,CAAC;IACtD,CAAC;IAGD,IACE,2BAA2B,CAAC,QAAQ,CAAC,OAAuD,CAAC,EAC7F,CAAC;QACD,OAAO,4CAA4C,CAAC;IACtD,CAAC;IAGD,OAAO,4BAA4B,CAAC;AACtC,CAAC;AAOD,MAAM,UAAU,0BAA0B,CAAC,OAAe;IACxD,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,OAAgD,CAAC,EAAE,CAAC;QACrF,OAAO,SAAS,CAAC;IACnB,CAAC;IAGD,IAAI,mBAAmB,CAAC,QAAQ,CAAC,OAA+C,CAAC,EAAE,CAAC;QAClF,OAAO,4CAA4C,CAAC;IACtD,CAAC;IAGD,IACE,2BAA2B,CAAC,QAAQ,CAAC,OAAuD,CAAC,EAC7F,CAAC;QACD,OAAO,4CAA4C,CAAC;IACtD,CAAC;IAGD,OAAO,mCAAmC,CAAC;AAC7C,CAAC","sourcesContent":["/**\n * Safe contract addresses for gas simulation and multi-send operations.\n *\n * @see https://ethereum.stackexchange.com/q/168410/24693\n * @see https://github.com/safe-global/safe-deployments/blob/main/src/assets/v1.4.1/multi_send_call_only.json\n * @see https://github.com/safe-global/safe-deployments/blob/main/src/assets/v1.4.1/simulate_tx_accessor.json\n */\nimport type { Address } from \"viem\";\nimport {\n  abstract,\n  arbitrum,\n  avalanche,\n  base,\n  baseSepolia,\n  berachain,\n  blast,\n  bsc,\n  gnosis,\n  lightlinkPhoenix,\n  linea,\n  mainnet,\n  mode,\n  monad,\n  morph,\n  optimism,\n  polygon,\n  scroll,\n  sei,\n  sepolia,\n  sonic,\n  unichainSepolia,\n  xdc,\n  zksync,\n} from \"viem/chains\";\n\n/**\n * Chain IDs for address resolution.\n * These are defined as constants for clarity and maintainability.\n */\n\n/** Chains where Safe MultiSend is available */\nconst MULTI_SEND_CHAIN_IDS = [\n  abstract.id,\n  arbitrum.id,\n  avalanche.id,\n  base.id,\n  baseSepolia.id,\n  berachain.id,\n  blast.id,\n  bsc.id,\n  gnosis.id,\n  lightlinkPhoenix.id,\n  linea.id,\n  mainnet.id,\n  mode.id,\n  monad.id,\n  morph.id,\n  optimism.id,\n  polygon.id,\n  scroll.id,\n  sei.id,\n  sepolia.id,\n  sonic.id,\n  unichainSepolia.id,\n  xdc.id,\n  zksync.id,\n] as const;\n\n/** ZK rollups with custom Safe deployments */\nconst ZK_ROLLUP_CHAIN_IDS = [abstract.id, zksync.id] as const;\n\n/** Chains with custom (non-canonical) Safe deployments */\nconst CUSTOM_DEPLOYMENT_CHAIN_IDS = [lightlinkPhoenix.id, xdc.id] as const;\n\n/**\n * Contract addresses for Safe v1.4.1 deployments.\n */\n\n/** Canonical MultiSendCallOnly address (most EVM chains) */\nconst CANONICAL_MULTI_SEND_ADDRESS: Address = \"0x9641d764fc13c8B624c04430C7356C1C7C8102e2\";\n\n/** Canonical SimulateTxAccessor address (most EVM chains) */\nconst CANONICAL_SIMULATE_ACCESSOR_ADDRESS: Address = \"0x3d4BA2E0884aa488718476ca2FB8Efc291A46199\";\n\n/**\n * Get the MultiSend contract address for a given chain.\n *\n * Returns undefined for chains where Safe is not deployed.\n */\nexport function getMultiSendAddress(chainId: number): Address | undefined {\n  if (!MULTI_SEND_CHAIN_IDS.includes(chainId as (typeof MULTI_SEND_CHAIN_IDS)[number])) {\n    return undefined;\n  }\n\n  // ZK rollups with custom deployments (Abstract, ZKsync)\n  if (ZK_ROLLUP_CHAIN_IDS.includes(chainId as (typeof ZK_ROLLUP_CHAIN_IDS)[number])) {\n    return \"0xf220D3b4DFb23C4ade8C88E526C1353AbAcbC38F\";\n  }\n\n  // Chains with custom deployments (Lightlink, XDC)\n  if (\n    CUSTOM_DEPLOYMENT_CHAIN_IDS.includes(chainId as (typeof CUSTOM_DEPLOYMENT_CHAIN_IDS)[number])\n  ) {\n    return \"0x40A2aCCbd92BCA938b02010E17A5b8929b49130D\";\n  }\n\n  // Canonical deployment for all other chains\n  return CANONICAL_MULTI_SEND_ADDRESS;\n}\n\n/**\n * Get the SimulateAccessor contract address for a given chain.\n *\n * Returns undefined for chains where Safe is not deployed.\n */\nexport function getSimulateAccessorAddress(chainId: number): Address | undefined {\n  if (!MULTI_SEND_CHAIN_IDS.includes(chainId as (typeof MULTI_SEND_CHAIN_IDS)[number])) {\n    return undefined;\n  }\n\n  // ZK rollups with custom deployments (Abstract, ZKsync)\n  if (ZK_ROLLUP_CHAIN_IDS.includes(chainId as (typeof ZK_ROLLUP_CHAIN_IDS)[number])) {\n    return \"0x4191E2e12E8BC5002424CE0c51f9947b02675a44\";\n  }\n\n  // Chains with custom deployments (Lightlink, XDC)\n  if (\n    CUSTOM_DEPLOYMENT_CHAIN_IDS.includes(chainId as (typeof CUSTOM_DEPLOYMENT_CHAIN_IDS)[number])\n  ) {\n    return \"0x59AD6735bCd8152B84860Cb256dD9e96b85F69Da\";\n  }\n\n  // Canonical deployment for all other chains\n  return CANONICAL_SIMULATE_ACCESSOR_ADDRESS;\n}\n"]}

package/dist/safe/simulation/encoding.d.ts

@@ -0,0 +1,16 @@
+import type { Address, Hex } from "viem";
+import type { SafeMultisigSimulationTx } from "./types.js";
+type InternalTx = {
+    data: Hex;
+    operation: 0 | 1;
+    to: Address;
+    value: bigint;
+};
+export declare function encodeInternalTx(tx: InternalTx): string;
+export declare function encodeMultiSend(transactions: SafeMultisigSimulationTx[]): Hex;
+export declare function decodeSimulationData(revertData: string): {
+    gas: bigint;
+    success: boolean;
+};
+export {};
+//# sourceMappingURL=encoding.d.ts.map

package/dist/safe/simulation/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../../src/safe/simulation/encoding.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAGzC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAG3D,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE,GAAG,CAAC;IACV,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;IACjB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAoBF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM,CAMvD;AAQD,wBAAgB,eAAe,CAAC,YAAY,EAAE,wBAAwB,EAAE,GAAG,GAAG,CAe7E;AAeD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;CAClB,CAyBA"}

package/dist/safe/simulation/encoding.js

@@ -0,0 +1,36 @@
+import { decodeAbiParameters, encodeFunctionData, encodePacked } from "viem";
+import { safeAbis } from "./abis.js";
+export function encodeInternalTx(tx) {
+    const encoded = encodePacked(["uint8", "address", "uint256", "uint256", "bytes"], [tx.operation, tx.to, tx.value, BigInt((tx.data.length - 2) / 2), tx.data]);
+    return encoded.slice(2);
+}
+export function encodeMultiSend(transactions) {
+    const internals = transactions.map((tx) => ({
+        data: tx.data,
+        operation: tx.operation ?? 0,
+        to: tx.to,
+        value: tx.value,
+    }));
+    const packedData = `0x${internals.map(encodeInternalTx).join("")}`;
+    return encodeFunctionData({
+        abi: safeAbis.multiSend,
+        args: [packedData],
+        functionName: "multiSend",
+    });
+}
+export function decodeSimulationData(revertData) {
+    const minLength = 258;
+    if (revertData.length < minLength) {
+        throw new Error(`Invalid simulation data: revert data too short. Expected at least ${minLength} characters (${(minLength - 2) / 2} bytes), got ${revertData.length} characters (${Math.max(0, (revertData.length - 2) / 2)} bytes)`);
+    }
+    const gasAndSuccessData = revertData.slice(2).slice(128, 256);
+    const decoded = decodeAbiParameters([
+        { name: "estimate", type: "uint256" },
+        { name: "success", type: "bool" },
+    ], `0x${gasAndSuccessData}`);
+    return {
+        gas: decoded[0],
+        success: decoded[1],
+    };
+}
+//# sourceMappingURL=encoding.js.map

package/dist/safe/simulation/encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.js","sourceRoot":"","sources":["../../../src/safe/simulation/encoding.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AA6BrC,MAAM,UAAU,gBAAgB,CAAC,EAAc;IAC7C,MAAM,OAAO,GAAG,YAAY,CAC1B,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,EACnD,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAC3E,CAAC;IACF,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC1B,CAAC;AAQD,MAAM,UAAU,eAAe,CAAC,YAAwC;IACtE,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,SAAS,EAAE,EAAE,CAAC,SAAS,IAAI,CAAC;QAC5B,EAAE,EAAE,EAAE,CAAC,EAAE;QACT,KAAK,EAAE,EAAE,CAAC,KAAK;KAChB,CAAC,CAAC,CAAC;IAEJ,MAAM,UAAU,GAAG,KAAK,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAS,CAAC;IAE1E,OAAO,kBAAkB,CAAC;QACxB,GAAG,EAAE,QAAQ,CAAC,SAAS;QACvB,IAAI,EAAE,CAAC,UAAU,CAAC;QAClB,YAAY,EAAE,WAAW;KAC1B,CAAC,CAAC;AACL,CAAC;AAeD,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IAOrD,MAAM,SAAS,GAAG,GAAG,CAAC;IACtB,IAAI,UAAU,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,qEAAqE,SAAS,gBAAgB,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,UAAU,CAAC,MAAM,gBAAgB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,CACpN,CAAC;IACJ,CAAC;IAED,MAAM,iBAAiB,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAE9D,MAAM,OAAO,GAAG,mBAAmB,CACjC;QACE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;QACrC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE;KAClC,EACD,KAAK,iBAAiB,EAAS,CAChC,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;QACf,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;KACpB,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Encoding utilities for Safe multisig batch transactions.\n *\n * Based on Safe's multiSend encoding scheme and simulation data decoding.\n * @see https://github.com/safe-global/safe-smart-account/blob/c4859f4/contracts/common/StorageAccessible.sol#L32-L43\n * @see https://github.com/safe-global/safe-core-sdk/blob/4f4a0f6/packages/protocol-kit/src/utils/transactions/gas.ts#L353-L358\n */\nimport type { Address, Hex } from \"viem\";\nimport { decodeAbiParameters, encodeFunctionData, encodePacked } from \"viem\";\nimport { safeAbis } from \"./abis.js\";\nimport type { SafeMultisigSimulationTx } from \"./types.js\";\n\n/** Internal transaction format for Safe multiSend encoding */\ntype InternalTx = {\n  data: Hex;\n  operation: 0 | 1;\n  to: Address;\n  value: bigint;\n};\n\n/**\n * Encode a single transaction for Safe's multiSend batch execution.\n *\n * Packs transaction data into Safe's internal transaction format using tight encoding:\n * - `operation` (uint8): 0 for CALL, 1 for DELEGATECALL\n * - `to` (address): Target contract address\n * - `value` (uint256): ETH value to send\n * - `dataLength` (uint256): Byte length of calldata\n * - `data` (bytes): ABI-encoded function call\n *\n * The encoding follows Safe's multiSend contract specification where multiple transactions\n * are concatenated into a single bytes payload.\n *\n * @param tx - Transaction to encode\n * @returns Hex-encoded transaction bytes without 0x prefix (for concatenation with other transactions)\n *\n * @see https://github.com/safe-global/safe-smart-account/blob/c4859f4/contracts/common/StorageAccessible.sol#L32-L43\n */\nexport function encodeInternalTx(tx: InternalTx): string {\n  const encoded = encodePacked(\n    [\"uint8\", \"address\", \"uint256\", \"uint256\", \"bytes\"],\n    [tx.operation, tx.to, tx.value, BigInt((tx.data.length - 2) / 2), tx.data]\n  );\n  return encoded.slice(2); // Remove 0x prefix for concatenation\n}\n\n/**\n * Encode multiple transactions for Safe multiSend.\n *\n * @param transactions - Array of transactions to encode\n * @returns Encoded calldata for multiSend function\n */\nexport function encodeMultiSend(transactions: SafeMultisigSimulationTx[]): Hex {\n  const internals = transactions.map((tx) => ({\n    data: tx.data,\n    operation: tx.operation ?? 0,\n    to: tx.to,\n    value: tx.value,\n  }));\n\n  const packedData = `0x${internals.map(encodeInternalTx).join(\"\")}` as Hex;\n\n  return encodeFunctionData({\n    abi: safeAbis.multiSend,\n    args: [packedData],\n    functionName: \"multiSend\",\n  });\n}\n\n/**\n * Decode simulation revert data to extract gas estimate and success flag.\n *\n * Safe uses a custom encoding scheme for the revert data. The gas limit is the 3rd EVM word,\n * and success is the 4th one. Each word is 64 hex chars (32 bytes).\n *\n * IMPORTANT: This function may throw an error when the revert data is not due to a legitimate\n * response from `simulateAndRevert`.\n *\n * @param revertData - The revert data from simulateAndRevert call\n * @returns Gas estimate and success flag\n * @throws Error if revert data is too short to contain valid gas and success data\n */\nexport function decodeSimulationData(revertData: string): {\n  gas: bigint;\n  success: boolean;\n} {\n  // Gas estimate is at EVM word 3, success at word 4\n  // Each word is 64 hex chars (32 bytes)\n  // Total required: 0x prefix (2) + 128 chars (4 words) + 128 chars (2 words for gas and success) = 258 chars\n  const minLength = 258;\n  if (revertData.length < minLength) {\n    throw new Error(\n      `Invalid simulation data: revert data too short. Expected at least ${minLength} characters (${(minLength - 2) / 2} bytes), got ${revertData.length} characters (${Math.max(0, (revertData.length - 2) / 2)} bytes)`\n    );\n  }\n\n  const gasAndSuccessData = revertData.slice(2).slice(128, 256);\n\n  const decoded = decodeAbiParameters(\n    [\n      { name: \"estimate\", type: \"uint256\" },\n      { name: \"success\", type: \"bool\" },\n    ],\n    `0x${gasAndSuccessData}` as Hex\n  );\n\n  return {\n    gas: decoded[0],\n    success: decoded[1],\n  };\n}\n"]}

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

@@ -0,0 +1,56 @@
+import { Schema } from "effect";
+declare const GasLimitOverflowError_base: Schema.TaggedErrorClass<GasLimitOverflowError, "GasLimitOverflowError", {
+    readonly _tag: Schema.tag<"GasLimitOverflowError">;
+} & {
+    blockGasLimit: typeof Schema.BigInt;
+    estimatedGas: typeof Schema.BigInt;
+    message: typeof Schema.String;
+    threshold: typeof Schema.BigInt;
+}>;
+export declare class GasLimitOverflowError extends GasLimitOverflowError_base {
+}
+declare const SafeMultisigSimulationFailedError_base: Schema.TaggedErrorClass<SafeMultisigSimulationFailedError, "SafeMultisigSimulationFailedError", {
+    readonly _tag: Schema.tag<"SafeMultisigSimulationFailedError">;
+} & {
+    cause: Schema.optional<typeof Schema.Unknown>;
+    message: typeof Schema.String;
+}>;
+export declare class SafeMultisigSimulationFailedError extends SafeMultisigSimulationFailedError_base {
+}
+declare const SafeMultisigContractsNotDeployedError_base: Schema.TaggedErrorClass<SafeMultisigContractsNotDeployedError, "SafeMultisigContractsNotDeployedError", {
+    readonly _tag: Schema.tag<"SafeMultisigContractsNotDeployedError">;
+} & {
+    chainId: typeof Schema.Number;
+    message: typeof Schema.String;
+    missingContract: Schema.Literal<["multiSend", "simulateAccessor"]>;
+}>;
+export declare class SafeMultisigContractsNotDeployedError extends SafeMultisigContractsNotDeployedError_base {
+}
+declare const TxSizeTooLargeError_base: Schema.TaggedErrorClass<TxSizeTooLargeError, "TxSizeTooLargeError", {
+    readonly _tag: Schema.tag<"TxSizeTooLargeError">;
+} & {
+    actualSize: typeof Schema.Number;
+    maxSize: typeof Schema.Number;
+    message: typeof Schema.String;
+}>;
+export declare class TxSizeTooLargeError extends TxSizeTooLargeError_base {
+}
+declare const SimulationDecodeError_base: Schema.TaggedErrorClass<SimulationDecodeError, "SimulationDecodeError", {
+    readonly _tag: Schema.tag<"SimulationDecodeError">;
+} & {
+    cause: typeof Schema.Unknown;
+    message: typeof Schema.String;
+    revertData: typeof Schema.String;
+}>;
+export declare class SimulationDecodeError extends SimulationDecodeError_base {
+}
+declare const InvalidGasThresholdError_base: Schema.TaggedErrorClass<InvalidGasThresholdError, "InvalidGasThresholdError", {
+    readonly _tag: Schema.tag<"InvalidGasThresholdError">;
+} & {
+    message: typeof Schema.String;
+    value: typeof Schema.Number;
+}>;
+export declare class InvalidGasThresholdError extends InvalidGasThresholdError_base {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/safe/simulation/errors.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;;;;;AAGhC,qBAAa,qBAAsB,SAAQ,0BAQ1C;CAAG;;;;;;;AAGJ,qBAAa,iCAAkC,SAAQ,sCAMtD;CAAG;;;;;;;;AAGJ,qBAAa,qCAAsC,SAAQ,0CAO1D;CAAG;;;;;;;;AAGJ,qBAAa,mBAAoB,SAAQ,wBAOxC;CAAG;;;;;;;;AAGJ,qBAAa,qBAAsB,SAAQ,0BAO1C;CAAG;;;;;;;AAGJ,qBAAa,wBAAyB,SAAQ,6BAM7C;CAAG"}