@prb/effect-evm 1.0.0-beta.3 → 1.0.0-beta.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (91) hide show
  1. package/dist/ens/ens.d.ts.map +1 -1
  2. package/dist/ens/ens.js +6 -6
  3. package/dist/ens/ens.js.map +1 -1
  4. package/dist/react-hooks/index.d.ts +3 -1
  5. package/dist/react-hooks/index.d.ts.map +1 -1
  6. package/dist/react-hooks/index.js +3 -1
  7. package/dist/react-hooks/index.js.map +1 -1
  8. package/dist/react-hooks/safe-origins.d.ts +8 -0
  9. package/dist/react-hooks/safe-origins.d.ts.map +1 -0
  10. package/dist/react-hooks/safe-origins.js +124 -0
  11. package/dist/react-hooks/safe-origins.js.map +1 -0
  12. package/dist/react-hooks/use-is-host-safe-multisig.d.ts +2 -0
  13. package/dist/react-hooks/use-is-host-safe-multisig.d.ts.map +1 -0
  14. package/dist/react-hooks/use-is-host-safe-multisig.js +16 -0
  15. package/dist/react-hooks/use-is-host-safe-multisig.js.map +1 -0
  16. package/dist/react-hooks/use-is-wallet-safe-multisig.d.ts +2 -0
  17. package/dist/react-hooks/use-is-wallet-safe-multisig.d.ts.map +1 -0
  18. package/dist/react-hooks/use-is-wallet-safe-multisig.js +24 -0
  19. package/dist/react-hooks/use-is-wallet-safe-multisig.js.map +1 -0
  20. package/dist/react-hooks/use-safe-context.d.ts.map +1 -1
  21. package/dist/react-hooks/use-safe-context.js.map +1 -1
  22. package/dist/safe/simulation/abis.d.ts.map +1 -1
  23. package/dist/safe/simulation/abis.js.map +1 -1
  24. package/dist/safe/simulation/addresses.d.ts.map +1 -1
  25. package/dist/safe/simulation/addresses.js +40 -26
  26. package/dist/safe/simulation/addresses.js.map +1 -1
  27. package/dist/safe/simulation/internal/calldata/calldata.d.ts +5 -0
  28. package/dist/safe/simulation/internal/calldata/calldata.d.ts.map +1 -0
  29. package/dist/safe/simulation/internal/calldata/calldata.js +17 -0
  30. package/dist/safe/simulation/internal/calldata/calldata.js.map +1 -0
  31. package/dist/safe/simulation/internal/calldata/index.d.ts +2 -0
  32. package/dist/safe/simulation/internal/calldata/index.d.ts.map +1 -0
  33. package/dist/safe/simulation/internal/calldata/index.js +2 -0
  34. package/dist/safe/simulation/internal/calldata/index.js.map +1 -0
  35. package/dist/safe/simulation/internal/contracts/contracts.d.ts +5 -0
  36. package/dist/safe/simulation/internal/contracts/contracts.d.ts.map +1 -0
  37. package/dist/safe/simulation/internal/contracts/contracts.js +25 -0
  38. package/dist/safe/simulation/internal/contracts/contracts.js.map +1 -0
  39. package/dist/safe/simulation/internal/contracts/index.d.ts +2 -0
  40. package/dist/safe/simulation/internal/contracts/index.d.ts.map +1 -0
  41. package/dist/safe/simulation/internal/contracts/index.js +2 -0
  42. package/dist/safe/simulation/internal/contracts/index.js.map +1 -0
  43. package/dist/safe/simulation/internal/evaluation/evaluation.d.ts +6 -0
  44. package/dist/safe/simulation/internal/evaluation/evaluation.d.ts.map +1 -0
  45. package/dist/safe/simulation/internal/evaluation/evaluation.js +20 -0
  46. package/dist/safe/simulation/internal/evaluation/evaluation.js.map +1 -0
  47. package/dist/safe/simulation/internal/evaluation/index.d.ts +2 -0
  48. package/dist/safe/simulation/internal/evaluation/index.d.ts.map +1 -0
  49. package/dist/safe/simulation/internal/evaluation/index.js +2 -0
  50. package/dist/safe/simulation/internal/evaluation/index.js.map +1 -0
  51. package/dist/safe/simulation/internal/execution/execution.d.ts +9 -0
  52. package/dist/safe/simulation/internal/execution/execution.d.ts.map +1 -0
  53. package/dist/safe/simulation/internal/execution/execution.js +65 -0
  54. package/dist/safe/simulation/internal/execution/execution.js.map +1 -0
  55. package/dist/safe/simulation/internal/execution/index.d.ts +2 -0
  56. package/dist/safe/simulation/internal/execution/index.d.ts.map +1 -0
  57. package/dist/safe/simulation/internal/execution/index.js +2 -0
  58. package/dist/safe/simulation/internal/execution/index.js.map +1 -0
  59. package/dist/safe/simulation/internal/limits/index.d.ts +2 -0
  60. package/dist/safe/simulation/internal/limits/index.d.ts.map +1 -0
  61. package/dist/safe/simulation/internal/limits/index.js +2 -0
  62. package/dist/safe/simulation/internal/limits/index.js.map +1 -0
  63. package/dist/safe/simulation/internal/limits/limits.d.ts +5 -0
  64. package/dist/safe/simulation/internal/limits/limits.d.ts.map +1 -0
  65. package/dist/safe/simulation/internal/limits/limits.js +18 -0
  66. package/dist/safe/simulation/internal/limits/limits.js.map +1 -0
  67. package/dist/safe/simulation/internal/types/index.d.ts +2 -0
  68. package/dist/safe/simulation/internal/types/index.d.ts.map +1 -0
  69. package/dist/safe/simulation/internal/types/index.js +2 -0
  70. package/dist/safe/simulation/internal/types/index.js.map +1 -0
  71. package/dist/safe/simulation/internal/types/types.d.ts +11 -0
  72. package/dist/safe/simulation/internal/types/types.d.ts.map +1 -0
  73. package/dist/safe/simulation/internal/types/types.js +2 -0
  74. package/dist/safe/simulation/internal/types/types.js.map +1 -0
  75. package/dist/safe/simulation/internal/validation/index.d.ts +2 -0
  76. package/dist/safe/simulation/internal/validation/index.d.ts.map +1 -0
  77. package/dist/safe/simulation/internal/validation/index.js +2 -0
  78. package/dist/safe/simulation/internal/validation/index.js.map +1 -0
  79. package/dist/safe/simulation/internal/validation/validation.d.ts +5 -0
  80. package/dist/safe/simulation/internal/validation/validation.d.ts.map +1 -0
  81. package/dist/safe/simulation/internal/validation/validation.js +27 -0
  82. package/dist/safe/simulation/internal/validation/validation.js.map +1 -0
  83. package/dist/safe/simulation/service.d.ts +1 -1
  84. package/dist/safe/simulation/service.d.ts.map +1 -1
  85. package/dist/safe/simulation/service.js +12 -127
  86. package/dist/safe/simulation/service.js.map +1 -1
  87. package/package.json +1 -1
  88. package/dist/react-hooks/use-is-safe-multisig.d.ts +0 -2
  89. package/dist/react-hooks/use-is-safe-multisig.d.ts.map +0 -1
  90. package/dist/react-hooks/use-is-safe-multisig.js +0 -44
  91. package/dist/react-hooks/use-is-safe-multisig.js.map +0 -1
@@ -0,0 +1,2 @@
1
+ export { buildSafeCalldata } from "./calldata.js";
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/calldata/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { buildSafeCalldata } from "./calldata.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/calldata/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC","sourcesContent":["export { buildSafeCalldata } from \"./calldata.js\";\n"]}
@@ -0,0 +1,5 @@
1
+ import { Effect } from "effect";
2
+ import { SafeContractsNotDeployedError } from "../../errors.js";
3
+ import type { SafeContracts } from "../types/index.js";
4
+ export declare function resolveSafeContracts(chainId: number): Effect.Effect<SafeContracts, SafeContractsNotDeployedError>;
5
+ //# sourceMappingURL=contracts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/contracts/contracts.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,6BAA6B,CAAC,CA2B7D"}
@@ -0,0 +1,25 @@
1
+ import { Effect } from "effect";
2
+ import { getMultiSendAddress, getSimulateAccessorAddress } from "../../addresses.js";
3
+ import { SafeContractsNotDeployedError } from "../../errors.js";
4
+ export function resolveSafeContracts(chainId) {
5
+ return Effect.gen(function* () {
6
+ const multiSendAddr = getMultiSendAddress(chainId);
7
+ const simulateAccessorAddr = getSimulateAccessorAddress(chainId);
8
+ if (!multiSendAddr) {
9
+ return yield* Effect.fail(new SafeContractsNotDeployedError({
10
+ chainId,
11
+ message: "MultiSend contract not deployed on this chain",
12
+ missingContract: "multiSend",
13
+ }));
14
+ }
15
+ if (!simulateAccessorAddr) {
16
+ return yield* Effect.fail(new SafeContractsNotDeployedError({
17
+ chainId,
18
+ message: "SimulateAccessor contract not deployed on this chain",
19
+ missingContract: "simulateAccessor",
20
+ }));
21
+ }
22
+ return { multiSendAddr, simulateAccessorAddr };
23
+ });
24
+ }
25
+ //# sourceMappingURL=contracts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/contracts/contracts.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAMhE,MAAM,UAAU,oBAAoB,CAClC,OAAe;IAEf,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,aAAa,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,oBAAoB,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;QAEjE,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,6BAA6B,CAAC;gBAChC,OAAO;gBACP,OAAO,EAAE,+CAA+C;gBACxD,eAAe,EAAE,WAAW;aAC7B,CAAC,CACH,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,6BAA6B,CAAC;gBAChC,OAAO;gBACP,OAAO,EAAE,sDAAsD;gBAC/D,eAAe,EAAE,kBAAkB;aACpC,CAAC,CACH,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * Resolve contract addresses needed to construct Safe simulation calldata.\n */\nimport { Effect } from \"effect\";\nimport { getMultiSendAddress, getSimulateAccessorAddress } from \"../../addresses.js\";\nimport { SafeContractsNotDeployedError } from \"../../errors.js\";\nimport type { SafeContracts } from \"../types/index.js\";\n\n/**\n * Resolve the Safe helper contract addresses for the chain.\n */\nexport function resolveSafeContracts(\n chainId: number\n): Effect.Effect<SafeContracts, SafeContractsNotDeployedError> {\n return Effect.gen(function* () {\n const multiSendAddr = getMultiSendAddress(chainId);\n const simulateAccessorAddr = getSimulateAccessorAddress(chainId);\n\n if (!multiSendAddr) {\n return yield* Effect.fail(\n new SafeContractsNotDeployedError({\n chainId,\n message: \"MultiSend contract not deployed on this chain\",\n missingContract: \"multiSend\",\n })\n );\n }\n\n if (!simulateAccessorAddr) {\n return yield* Effect.fail(\n new SafeContractsNotDeployedError({\n chainId,\n message: \"SimulateAccessor contract not deployed on this chain\",\n missingContract: \"simulateAccessor\",\n })\n );\n }\n\n return { multiSendAddr, simulateAccessorAddr };\n });\n}\n"]}
@@ -0,0 +1,2 @@
1
+ export { resolveSafeContracts } from "./contracts.js";
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/contracts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { resolveSafeContracts } from "./contracts.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/contracts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC","sourcesContent":["export { resolveSafeContracts } from \"./contracts.js\";\n"]}
@@ -0,0 +1,6 @@
1
+ import { Effect } from "effect";
2
+ import { GasLimitOverflowError, SafeSimulationFailedError } from "../../errors.js";
3
+ import type { SafeSimulationResult } from "../../types.js";
4
+ import type { LatestBlock, SimulationDecoded } from "../types/index.js";
5
+ export declare function evaluateSimulationResult(result: SimulationDecoded, block: LatestBlock, gasThresholdPercent?: number): Effect.Effect<SafeSimulationResult, GasLimitOverflowError | SafeSimulationFailedError>;
6
+ //# sourceMappingURL=evaluation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"evaluation.d.ts","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/evaluation/evaluation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAKxE,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,WAAW,EAClB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,qBAAqB,GAAG,yBAAyB,CAAC,CAwBxF"}
@@ -0,0 +1,20 @@
1
+ import { Effect } from "effect";
2
+ import { GasLimitOverflowError, SafeSimulationFailedError } from "../../errors.js";
3
+ export function evaluateSimulationResult(result, block, gasThresholdPercent) {
4
+ const threshold = (block.gasLimit * BigInt(gasThresholdPercent ?? 95)) / 100n;
5
+ if (result.success && result.gas > threshold) {
6
+ return Effect.fail(new GasLimitOverflowError({
7
+ blockGasLimit: block.gasLimit,
8
+ estimatedGas: result.gas,
9
+ message: "Gas consumption exceeds threshold of block gas limit. Try splitting into smaller batches.",
10
+ threshold,
11
+ }));
12
+ }
13
+ if (!result.success) {
14
+ return Effect.fail(new SafeSimulationFailedError({
15
+ message: "Transaction simulation failed - the transaction would revert",
16
+ }));
17
+ }
18
+ return Effect.succeed({ estimatedGas: result.gas, success: true });
19
+ }
20
+ //# sourceMappingURL=evaluation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"evaluation.js","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/evaluation/evaluation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAOnF,MAAM,UAAU,wBAAwB,CACtC,MAAyB,EACzB,KAAkB,EAClB,mBAA4B;IAE5B,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IAE9E,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,GAAG,SAAS,EAAE,CAAC;QAC7C,OAAO,MAAM,CAAC,IAAI,CAChB,IAAI,qBAAqB,CAAC;YACxB,aAAa,EAAE,KAAK,CAAC,QAAQ;YAC7B,YAAY,EAAE,MAAM,CAAC,GAAG;YACxB,OAAO,EACL,2FAA2F;YAC7F,SAAS;SACV,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC,IAAI,CAChB,IAAI,yBAAyB,CAAC;YAC5B,OAAO,EAAE,8DAA8D;SACxE,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AACrE,CAAC","sourcesContent":["/**\n * Final evaluation of simulation outcomes against policy thresholds.\n */\nimport { Effect } from \"effect\";\nimport { GasLimitOverflowError, SafeSimulationFailedError } from \"../../errors.js\";\nimport type { SafeSimulationResult } from \"../../types.js\";\nimport type { LatestBlock, SimulationDecoded } from \"../types/index.js\";\n\n/**\n * Apply success and gas threshold checks to the decoded result.\n */\nexport function evaluateSimulationResult(\n result: SimulationDecoded,\n block: LatestBlock,\n gasThresholdPercent?: number\n): Effect.Effect<SafeSimulationResult, GasLimitOverflowError | SafeSimulationFailedError> {\n const threshold = (block.gasLimit * BigInt(gasThresholdPercent ?? 95)) / 100n;\n\n if (result.success && result.gas > threshold) {\n return Effect.fail(\n new GasLimitOverflowError({\n blockGasLimit: block.gasLimit,\n estimatedGas: result.gas,\n message:\n \"Gas consumption exceeds threshold of block gas limit. Try splitting into smaller batches.\",\n threshold,\n })\n );\n }\n\n if (!result.success) {\n return Effect.fail(\n new SafeSimulationFailedError({\n message: \"Transaction simulation failed - the transaction would revert\",\n })\n );\n }\n\n return Effect.succeed({ estimatedGas: result.gas, success: true });\n}\n"]}
@@ -0,0 +1,2 @@
1
+ export { evaluateSimulationResult } from "./evaluation.js";
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/evaluation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { evaluateSimulationResult } from "./evaluation.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/evaluation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC","sourcesContent":["export { evaluateSimulationResult } from \"./evaluation.js\";\n"]}
@@ -0,0 +1,9 @@
1
+ import { Effect } from "effect";
2
+ import type { Address, Hex, PublicClient } from "viem";
3
+ import { SafeSimulationFailedError, SimulationDecodeError } from "../../errors.js";
4
+ import type { LatestBlock, SimulationDecoded } from "../types/index.js";
5
+ export declare function extractRevertData(error: unknown): string | undefined;
6
+ export declare function callSimulateAndExtractRevertData(client: PublicClient, safeAddress: Address, safeCalldata: Hex): Promise<string>;
7
+ export declare function simulateAndDecode(client: PublicClient, safeAddress: Address, safeCalldata: Hex): Effect.Effect<SimulationDecoded, SafeSimulationFailedError | SimulationDecodeError>;
8
+ export declare function fetchLatestBlock(client: PublicClient): Effect.Effect<LatestBlock, SafeSimulationFailedError>;
9
+ //# sourceMappingURL=execution.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/execution/execution.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAGvD,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAKxE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAiBpE;AAKD,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,OAAO,EACpB,YAAY,EAAE,GAAG,GAChB,OAAO,CAAC,MAAM,CAAC,CAejB;AAKD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,OAAO,EACpB,YAAY,EAAE,GAAG,GAChB,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,yBAAyB,GAAG,qBAAqB,CAAC,CAqBrF;AAKD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,GACnB,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,yBAAyB,CAAC,CASvD"}
@@ -0,0 +1,65 @@
1
+ import { Effect } from "effect";
2
+ import { BaseError as CoreError } from "viem";
3
+ import { decodeSimulationData } from "../../encoding.js";
4
+ import { SafeSimulationFailedError, SimulationDecodeError } from "../../errors.js";
5
+ export function extractRevertData(error) {
6
+ if (!(error instanceof CoreError)) {
7
+ return undefined;
8
+ }
9
+ const revertError = error.walk((err) => {
10
+ const typedErr = err;
11
+ return typeof typedErr.data === "string";
12
+ });
13
+ if (!revertError) {
14
+ return undefined;
15
+ }
16
+ const typedErr = revertError;
17
+ const extractedData = typedErr.data;
18
+ return typeof extractedData === "string" ? extractedData : undefined;
19
+ }
20
+ export async function callSimulateAndExtractRevertData(client, safeAddress, safeCalldata) {
21
+ try {
22
+ await client.call({
23
+ account: safeAddress,
24
+ data: safeCalldata,
25
+ to: safeAddress,
26
+ });
27
+ throw new Error("simulateAndRevert did not revert");
28
+ }
29
+ catch (error) {
30
+ const revertData = extractRevertData(error);
31
+ if (revertData) {
32
+ return revertData;
33
+ }
34
+ throw error;
35
+ }
36
+ }
37
+ export function simulateAndDecode(client, safeAddress, safeCalldata) {
38
+ return Effect.gen(function* () {
39
+ const revertData = yield* Effect.tryPromise({
40
+ catch: (error) => new SafeSimulationFailedError({
41
+ cause: error,
42
+ message: "Network error or unexpected behavior during simulation",
43
+ }),
44
+ try: () => callSimulateAndExtractRevertData(client, safeAddress, safeCalldata),
45
+ });
46
+ return yield* Effect.try({
47
+ catch: (error) => new SimulationDecodeError({
48
+ cause: error,
49
+ message: "Failed to decode simulation revert data - unexpected format",
50
+ revertData,
51
+ }),
52
+ try: () => decodeSimulationData(revertData),
53
+ });
54
+ });
55
+ }
56
+ export function fetchLatestBlock(client) {
57
+ return Effect.tryPromise({
58
+ catch: (e) => new SafeSimulationFailedError({
59
+ cause: e,
60
+ message: `Failed to fetch block: ${e}`,
61
+ }),
62
+ try: () => client.getBlock({ blockTag: "latest" }),
63
+ });
64
+ }
65
+ //# sourceMappingURL=execution.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution.js","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/execution/execution.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * On-chain execution and decoding helpers for Safe simulation.\n */\nimport { Effect } from \"effect\";\nimport type { Address, Hex, PublicClient } from \"viem\";\nimport { BaseError as CoreError } from \"viem\";\nimport { decodeSimulationData } from \"../../encoding.js\";\nimport { SafeSimulationFailedError, SimulationDecodeError } from \"../../errors.js\";\nimport type { LatestBlock, SimulationDecoded } from \"../types/index.js\";\n\n/**\n * Extract revert data from a viem CoreError tree, if present.\n */\nexport function extractRevertData(error: unknown): string | undefined {\n if (!(error instanceof CoreError)) {\n return undefined;\n }\n\n const revertError = error.walk((err) => {\n const typedErr = err as unknown as Record<string, unknown>;\n return typeof typedErr.data === \"string\";\n });\n\n if (!revertError) {\n return undefined;\n }\n\n const typedErr = revertError as unknown as Record<string, unknown>;\n const extractedData = typedErr.data;\n return typeof extractedData === \"string\" ? extractedData : undefined;\n}\n\n/**\n * Execute simulateAndRevert and return the revert data payload.\n */\nexport async function callSimulateAndExtractRevertData(\n client: PublicClient,\n safeAddress: Address,\n safeCalldata: Hex\n): Promise<string> {\n try {\n await client.call({\n account: safeAddress,\n data: safeCalldata,\n to: safeAddress,\n });\n throw new Error(\"simulateAndRevert did not revert\");\n } catch (error: unknown) {\n const revertData = extractRevertData(error);\n if (revertData) {\n return revertData;\n }\n throw error;\n }\n}\n\n/**\n * Run the on-chain call and decode the revert payload into a gas estimate.\n */\nexport function simulateAndDecode(\n client: PublicClient,\n safeAddress: Address,\n safeCalldata: Hex\n): Effect.Effect<SimulationDecoded, SafeSimulationFailedError | SimulationDecodeError> {\n return Effect.gen(function* () {\n const revertData = yield* Effect.tryPromise({\n catch: (error) =>\n new SafeSimulationFailedError({\n cause: error,\n message: \"Network error or unexpected behavior during simulation\",\n }),\n try: () => callSimulateAndExtractRevertData(client, safeAddress, safeCalldata),\n });\n\n return yield* Effect.try({\n catch: (error) =>\n new SimulationDecodeError({\n cause: error,\n message: \"Failed to decode simulation revert data - unexpected format\",\n revertData,\n }),\n try: () => decodeSimulationData(revertData),\n });\n });\n}\n\n/**\n * Fetch the latest block to derive the gas threshold.\n */\nexport function fetchLatestBlock(\n client: PublicClient\n): Effect.Effect<LatestBlock, SafeSimulationFailedError> {\n return Effect.tryPromise({\n catch: (e) =>\n new SafeSimulationFailedError({\n cause: e,\n message: `Failed to fetch block: ${e}`,\n }),\n try: () => client.getBlock({ blockTag: \"latest\" }),\n });\n}\n"]}
@@ -0,0 +1,2 @@
1
+ export { callSimulateAndExtractRevertData, extractRevertData, fetchLatestBlock, simulateAndDecode, } from "./execution.js";
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/execution/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { callSimulateAndExtractRevertData, extractRevertData, fetchLatestBlock, simulateAndDecode, } from "./execution.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/execution/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC","sourcesContent":["export {\n callSimulateAndExtractRevertData,\n extractRevertData,\n fetchLatestBlock,\n simulateAndDecode,\n} from \"./execution.js\";\n"]}
@@ -0,0 +1,2 @@
1
+ export { enforceTxSizeLimit } from "./limits.js";
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/limits/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { enforceTxSizeLimit } from "./limits.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/limits/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC","sourcesContent":["export { enforceTxSizeLimit } from \"./limits.js\";\n"]}
@@ -0,0 +1,5 @@
1
+ import { Effect } from "effect";
2
+ import type { Hex } from "viem";
3
+ import { TransactionSizeTooLargeError } from "../../errors.js";
4
+ export declare function enforceTxSizeLimit(safeCalldata: Hex, txSizeLimit?: number): Effect.Effect<void, TransactionSizeTooLargeError>;
5
+ //# sourceMappingURL=limits.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/limits/limits.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAK/D,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,GAAG,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,4BAA4B,CAAC,CAiBnD"}
@@ -0,0 +1,18 @@
1
+ import { Effect } from "effect";
2
+ import { TransactionSizeTooLargeError } from "../../errors.js";
3
+ export function enforceTxSizeLimit(safeCalldata, txSizeLimit) {
4
+ if (!txSizeLimit) {
5
+ return Effect.void;
6
+ }
7
+ return Effect.gen(function* () {
8
+ const sizeInBytes = (safeCalldata.length - 2) / 2;
9
+ if (sizeInBytes > txSizeLimit) {
10
+ return yield* Effect.fail(new TransactionSizeTooLargeError({
11
+ actualSize: sizeInBytes,
12
+ maxSize: txSizeLimit,
13
+ message: `Transaction size (${sizeInBytes} bytes) exceeds chain limit (${txSizeLimit} bytes). Try splitting into smaller batches.`,
14
+ }));
15
+ }
16
+ });
17
+ }
18
+ //# sourceMappingURL=limits.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"limits.js","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/limits/limits.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAK/D,MAAM,UAAU,kBAAkB,CAChC,YAAiB,EACjB,WAAoB;IAEpB,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,WAAW,GAAG,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,WAAW,GAAG,WAAW,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,4BAA4B,CAAC;gBAC/B,UAAU,EAAE,WAAW;gBACvB,OAAO,EAAE,WAAW;gBACpB,OAAO,EAAE,qBAAqB,WAAW,gCAAgC,WAAW,8CAA8C;aACnI,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * Size limit enforcement for Safe simulation calldata.\n */\nimport { Effect } from \"effect\";\nimport type { Hex } from \"viem\";\nimport { TransactionSizeTooLargeError } from \"../../errors.js\";\n\n/**\n * Enforce chain-specific transaction size constraints (if provided).\n */\nexport function enforceTxSizeLimit(\n safeCalldata: Hex,\n txSizeLimit?: number\n): Effect.Effect<void, TransactionSizeTooLargeError> {\n if (!txSizeLimit) {\n return Effect.void;\n }\n\n return Effect.gen(function* () {\n const sizeInBytes = (safeCalldata.length - 2) / 2;\n if (sizeInBytes > txSizeLimit) {\n return yield* Effect.fail(\n new TransactionSizeTooLargeError({\n actualSize: sizeInBytes,\n maxSize: txSizeLimit,\n message: `Transaction size (${sizeInBytes} bytes) exceeds chain limit (${txSizeLimit} bytes). Try splitting into smaller batches.`,\n })\n );\n }\n });\n}\n"]}
@@ -0,0 +1,2 @@
1
+ export type { LatestBlock, SafeContracts, SimulationDecoded } from "./types.js";
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/types/index.ts"],"names":[],"mappings":"","sourcesContent":["export type { LatestBlock, SafeContracts, SimulationDecoded } from \"./types.js\";\n"]}
@@ -0,0 +1,11 @@
1
+ import type { Address, PublicClient } from "viem";
2
+ export type SafeContracts = {
3
+ readonly multiSendAddr: Address;
4
+ readonly simulateAccessorAddr: Address;
5
+ };
6
+ export type SimulationDecoded = {
7
+ readonly gas: bigint;
8
+ readonly success: boolean;
9
+ };
10
+ export type LatestBlock = Awaited<ReturnType<PublicClient["getBlock"]>>;
11
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/types/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAKlD,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;CACxC,CAAC;AAKF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAKF,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/types/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Shared type definitions for Safe simulation internals.\n */\nimport type { Address, PublicClient } from \"viem\";\n\n/**\n * Resolved Safe contract addresses required for simulation.\n */\nexport type SafeContracts = {\n readonly multiSendAddr: Address;\n readonly simulateAccessorAddr: Address;\n};\n\n/**\n * Decoded revert payload for simulateAndRevert.\n */\nexport type SimulationDecoded = {\n readonly gas: bigint;\n readonly success: boolean;\n};\n\n/**\n * Block type alias used by helpers to avoid re-deriving it everywhere.\n */\nexport type LatestBlock = Awaited<ReturnType<PublicClient[\"getBlock\"]>>;\n"]}
@@ -0,0 +1,2 @@
1
+ export { validateSimulationParams } from "./validation.js";
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { validateSimulationParams } from "./validation.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC","sourcesContent":["export { validateSimulationParams } from \"./validation.js\";\n"]}
@@ -0,0 +1,5 @@
1
+ import { Effect } from "effect";
2
+ import { InvalidGasThresholdError, SafeSimulationFailedError } from "../../errors.js";
3
+ import type { SafeSimulateBatchParams } from "../../types.js";
4
+ export declare function validateSimulationParams(params: SafeSimulateBatchParams): Effect.Effect<SafeSimulateBatchParams, InvalidGasThresholdError | SafeSimulationFailedError>;
5
+ //# sourceMappingURL=validation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/validation/validation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAK9D,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,uBAAuB,GAC9B,MAAM,CAAC,MAAM,CAAC,uBAAuB,EAAE,wBAAwB,GAAG,yBAAyB,CAAC,CAkC9F"}
@@ -0,0 +1,27 @@
1
+ import { Effect } from "effect";
2
+ import { zeroAddress } from "viem";
3
+ import { InvalidGasThresholdError, SafeSimulationFailedError } from "../../errors.js";
4
+ export function validateSimulationParams(params) {
5
+ return Effect.gen(function* () {
6
+ const { gasThresholdPercent, safeAddress, transactions } = params;
7
+ if (transactions.length === 0) {
8
+ return yield* Effect.fail(new SafeSimulationFailedError({
9
+ message: "Cannot simulate empty transaction batch",
10
+ }));
11
+ }
12
+ if (safeAddress === zeroAddress) {
13
+ return yield* Effect.fail(new SafeSimulationFailedError({
14
+ message: "Invalid Safe address: cannot be zero address",
15
+ }));
16
+ }
17
+ if (gasThresholdPercent !== undefined &&
18
+ (gasThresholdPercent < 1 || gasThresholdPercent > 100)) {
19
+ return yield* Effect.fail(new InvalidGasThresholdError({
20
+ message: "gasThresholdPercent must be between 1 and 100 (inclusive)",
21
+ value: gasThresholdPercent,
22
+ }));
23
+ }
24
+ return params;
25
+ });
26
+ }
27
+ //# sourceMappingURL=validation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../../src/safe/simulation/internal/validation/validation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAMtF,MAAM,UAAU,wBAAwB,CACtC,MAA+B;IAE/B,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,EAAE,mBAAmB,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;QAElE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,yBAAyB,CAAC;gBAC5B,OAAO,EAAE,yCAAyC;aACnD,CAAC,CACH,CAAC;QACJ,CAAC;QAED,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,yBAAyB,CAAC;gBAC5B,OAAO,EAAE,8CAA8C;aACxD,CAAC,CACH,CAAC;QACJ,CAAC;QAED,IACE,mBAAmB,KAAK,SAAS;YACjC,CAAC,mBAAmB,GAAG,CAAC,IAAI,mBAAmB,GAAG,GAAG,CAAC,EACtD,CAAC;YACD,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,wBAAwB,CAAC;gBAC3B,OAAO,EAAE,2DAA2D;gBACpE,KAAK,EAAE,mBAAmB;aAC3B,CAAC,CACH,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * Input validation for Safe batch simulation parameters.\n */\nimport { Effect } from \"effect\";\nimport { zeroAddress } from \"viem\";\nimport { InvalidGasThresholdError, SafeSimulationFailedError } from \"../../errors.js\";\nimport type { SafeSimulateBatchParams } from \"../../types.js\";\n\n/**\n * Validate user-supplied simulation inputs before any chain calls.\n */\nexport function validateSimulationParams(\n params: SafeSimulateBatchParams\n): Effect.Effect<SafeSimulateBatchParams, InvalidGasThresholdError | SafeSimulationFailedError> {\n return Effect.gen(function* () {\n const { gasThresholdPercent, safeAddress, transactions } = params;\n\n if (transactions.length === 0) {\n return yield* Effect.fail(\n new SafeSimulationFailedError({\n message: \"Cannot simulate empty transaction batch\",\n })\n );\n }\n\n if (safeAddress === zeroAddress) {\n return yield* Effect.fail(\n new SafeSimulationFailedError({\n message: \"Invalid Safe address: cannot be zero address\",\n })\n );\n }\n\n if (\n gasThresholdPercent !== undefined &&\n (gasThresholdPercent < 1 || gasThresholdPercent > 100)\n ) {\n return yield* Effect.fail(\n new InvalidGasThresholdError({\n message: \"gasThresholdPercent must be between 1 and 100 (inclusive)\",\n value: gasThresholdPercent,\n })\n );\n }\n\n return params;\n });\n}\n"]}
@@ -1,7 +1,7 @@
1
1
  import { Context, Effect, Layer } from "effect";
2
2
  import type { ClientNotFoundError } from "../../core/index.js";
3
3
  import { PublicClientService } from "../../core/index.js";
4
- import { GasLimitOverflowError, InvalidGasThresholdError, SafeContractsNotDeployedError, SafeSimulationFailedError, SimulationDecodeError, TransactionSizeTooLargeError } from "./errors.js";
4
+ import type { GasLimitOverflowError, InvalidGasThresholdError, SafeContractsNotDeployedError, SafeSimulationFailedError, SimulationDecodeError, TransactionSizeTooLargeError } from "./errors.js";
5
5
  import type { SafeSimulateBatchParams, SafeSimulationResult } from "./types.js";
6
6
  export type SafeSimulationServiceShape = {
7
7
  readonly simulateBatch: (params: SafeSimulateBatchParams) => Effect.Effect<SafeSimulationResult, ClientNotFoundError | InvalidGasThresholdError | SafeContractsNotDeployedError | TransactionSizeTooLargeError | SafeSimulationFailedError | SimulationDecodeError | GasLimitOverflowError>;
@@ -1 +1 @@
1
- {"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/safe/simulation/service.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI1D,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,6BAA6B,EAC7B,yBAAyB,EACzB,qBAAqB,EACrB,4BAA4B,EAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEhF,MAAM,MAAM,0BAA0B,GAAG;IAUvC,QAAQ,CAAC,aAAa,EAAE,CACtB,MAAM,EAAE,uBAAuB,KAC5B,MAAM,CAAC,MAAM,CAChB,oBAAoB,EAClB,mBAAmB,GACnB,wBAAwB,GACxB,6BAA6B,GAC7B,4BAA4B,GAC5B,yBAAyB,GACzB,qBAAqB,GACrB,qBAAqB,CACxB,CAAC;CACH,CAAC;;AAEF,qBAAa,qBAAsB,SAAQ,0BAGxC;CAAG;AAEN,eAAO,MAAM,yBAAyB,gEAkMrC,CAAC"}
1
+ {"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/safe/simulation/service.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,6BAA6B,EAC7B,yBAAyB,EACzB,qBAAqB,EACrB,4BAA4B,EAC7B,MAAM,aAAa,CAAC;AAOrB,OAAO,KAAK,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEhF,MAAM,MAAM,0BAA0B,GAAG;IAUvC,QAAQ,CAAC,aAAa,EAAE,CACtB,MAAM,EAAE,uBAAuB,KAC5B,MAAM,CAAC,MAAM,CAChB,oBAAoB,EAClB,mBAAmB,GACnB,wBAAwB,GACxB,6BAA6B,GAC7B,4BAA4B,GAC5B,yBAAyB,GACzB,qBAAqB,GACrB,qBAAqB,CACxB,CAAC;CACH,CAAC;;AAEF,qBAAa,qBAAsB,SAAQ,0BAGxC;CAAG;AAEN,eAAO,MAAM,yBAAyB,gEAyBrC,CAAC"}
@@ -1,139 +1,24 @@
1
1
  import { Context, Effect, Layer } from "effect";
2
- import { BaseError as CoreError, encodeFunctionData, zeroAddress } from "viem";
3
2
  import { PublicClientService } from "../../core/index.js";
4
- import { safeAbis } from "./abis.js";
5
- import { getMultiSendAddress, getSimulateAccessorAddress } from "./addresses.js";
6
- import { decodeSimulationData, encodeMultiSend } from "./encoding.js";
7
- import { GasLimitOverflowError, InvalidGasThresholdError, SafeContractsNotDeployedError, SafeSimulationFailedError, SimulationDecodeError, TransactionSizeTooLargeError, } from "./errors.js";
3
+ import { buildSafeCalldata } from "./internal/calldata/index.js";
4
+ import { resolveSafeContracts } from "./internal/contracts/index.js";
5
+ import { evaluateSimulationResult } from "./internal/evaluation/index.js";
6
+ import { fetchLatestBlock, simulateAndDecode } from "./internal/execution/index.js";
7
+ import { enforceTxSizeLimit } from "./internal/limits/index.js";
8
+ import { validateSimulationParams } from "./internal/validation/index.js";
8
9
  export class SafeSimulationService extends Context.Tag("ew3/SafeSimulation")() {
9
10
  }
10
11
  export const SafeSimulationServiceLive = Layer.effect(SafeSimulationService, Effect.gen(function* () {
11
12
  const publicClientService = yield* PublicClientService;
12
13
  return SafeSimulationService.of({
13
14
  simulateBatch: (params) => Effect.gen(function* () {
14
- const { chainId, safeAddress, transactions, txSizeLimit, gasThresholdPercent } = params;
15
- if (transactions.length === 0) {
16
- return yield* Effect.fail(new SafeSimulationFailedError({
17
- message: "Cannot simulate empty transaction batch",
18
- }));
19
- }
20
- if (safeAddress === zeroAddress) {
21
- return yield* Effect.fail(new SafeSimulationFailedError({
22
- message: "Invalid Safe address: cannot be zero address",
23
- }));
24
- }
25
- if (gasThresholdPercent !== undefined &&
26
- (gasThresholdPercent < 1 || gasThresholdPercent > 100)) {
27
- return yield* Effect.fail(new InvalidGasThresholdError({
28
- message: "gasThresholdPercent must be between 1 and 100 (inclusive)",
29
- value: gasThresholdPercent,
30
- }));
31
- }
32
- const multiSendAddr = getMultiSendAddress(chainId);
33
- const simulateAccessorAddr = getSimulateAccessorAddress(chainId);
34
- if (!multiSendAddr) {
35
- return yield* Effect.fail(new SafeContractsNotDeployedError({
36
- chainId,
37
- message: "MultiSend contract not deployed on this chain",
38
- missingContract: "multiSend",
39
- }));
40
- }
41
- if (!simulateAccessorAddr) {
42
- return yield* Effect.fail(new SafeContractsNotDeployedError({
43
- chainId,
44
- message: "SimulateAccessor contract not deployed on this chain",
45
- missingContract: "simulateAccessor",
46
- }));
47
- }
48
- const multiSendCalldata = encodeMultiSend(transactions);
49
- const simulateAccessorCalldata = encodeFunctionData({
50
- abi: safeAbis.simulateAccessor,
51
- args: [multiSendAddr, 0n, multiSendCalldata, 1],
52
- functionName: "simulate",
53
- });
54
- const safeCalldata = encodeFunctionData({
55
- abi: safeAbis.multisig,
56
- args: [simulateAccessorAddr, simulateAccessorCalldata],
57
- functionName: "simulateAndRevert",
58
- });
59
- if (txSizeLimit) {
60
- const sizeInBytes = (safeCalldata.length - 2) / 2;
61
- if (sizeInBytes > txSizeLimit) {
62
- return yield* Effect.fail(new TransactionSizeTooLargeError({
63
- actualSize: sizeInBytes,
64
- maxSize: txSizeLimit,
65
- message: `Transaction size (${sizeInBytes} bytes) exceeds chain limit (${txSizeLimit} bytes). Try splitting into smaller batches.`,
66
- }));
67
- }
68
- }
15
+ const { chainId, safeAddress, transactions, txSizeLimit, gasThresholdPercent } = yield* validateSimulationParams(params);
16
+ const contracts = yield* resolveSafeContracts(chainId);
17
+ const safeCalldata = buildSafeCalldata(contracts, transactions);
18
+ yield* enforceTxSizeLimit(safeCalldata, txSizeLimit);
69
19
  const client = yield* publicClientService.get(chainId);
70
- const simulationEffect = Effect.gen(function* () {
71
- const revertData = yield* Effect.tryPromise({
72
- catch: (error) => new SafeSimulationFailedError({
73
- cause: error,
74
- message: "Network error or unexpected behavior during simulation",
75
- }),
76
- try: async () => {
77
- try {
78
- await client.call({
79
- account: safeAddress,
80
- data: safeCalldata,
81
- to: safeAddress,
82
- });
83
- throw new Error("simulateAndRevert did not revert");
84
- }
85
- catch (error) {
86
- if (error instanceof CoreError) {
87
- const revertError = error.walk((err) => {
88
- const typedErr = err;
89
- return typeof typedErr.data === "string";
90
- });
91
- if (revertError) {
92
- const typedErr = revertError;
93
- const extractedData = typedErr.data;
94
- if (typeof extractedData === "string") {
95
- return extractedData;
96
- }
97
- }
98
- }
99
- throw error;
100
- }
101
- },
102
- });
103
- return yield* Effect.try({
104
- catch: (error) => new SimulationDecodeError({
105
- cause: error,
106
- message: "Failed to decode simulation revert data - unexpected format",
107
- revertData,
108
- }),
109
- try: () => decodeSimulationData(revertData),
110
- });
111
- });
112
- const [result, block] = yield* Effect.all([
113
- simulationEffect,
114
- Effect.tryPromise({
115
- catch: (e) => new SafeSimulationFailedError({
116
- cause: e,
117
- message: `Failed to fetch block: ${e}`,
118
- }),
119
- try: () => client.getBlock({ blockTag: "latest" }),
120
- }),
121
- ], { concurrency: "unbounded" });
122
- const threshold = (block.gasLimit * BigInt(params.gasThresholdPercent ?? 95)) / 100n;
123
- if (result.success && result.gas > threshold) {
124
- return yield* Effect.fail(new GasLimitOverflowError({
125
- blockGasLimit: block.gasLimit,
126
- estimatedGas: result.gas,
127
- message: "Gas consumption exceeds threshold of block gas limit. Try splitting into smaller batches.",
128
- threshold,
129
- }));
130
- }
131
- if (!result.success) {
132
- return yield* Effect.fail(new SafeSimulationFailedError({
133
- message: "Transaction simulation failed - the transaction would revert",
134
- }));
135
- }
136
- return { estimatedGas: result.gas, success: true };
20
+ const [result, block] = yield* Effect.all([simulateAndDecode(client, safeAddress, safeCalldata), fetchLatestBlock(client)], { concurrency: "unbounded" });
21
+ return yield* evaluateSimulationResult(result, block, gasThresholdPercent);
137
22
  }),
138
23
  });
139
24
  }));