@prb/effect-evm 1.0.0-beta.3 → 1.0.0-beta.5
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.
- package/DOCS.md +13 -0
- package/README.md +1 -0
- package/dist/ens/ens.d.ts.map +1 -1
- package/dist/ens/ens.js +6 -6
- package/dist/ens/ens.js.map +1 -1
- package/dist/react-hooks/index.d.ts +4 -2
- package/dist/react-hooks/index.d.ts.map +1 -1
- package/dist/react-hooks/index.js +4 -2
- package/dist/react-hooks/index.js.map +1 -1
- package/dist/react-hooks/safe-app-origins.d.ts +8 -0
- package/dist/react-hooks/safe-app-origins.d.ts.map +1 -0
- package/dist/react-hooks/safe-app-origins.js +124 -0
- package/dist/react-hooks/safe-app-origins.js.map +1 -0
- package/dist/react-hooks/use-is-host-safe-app.d.ts +2 -0
- package/dist/react-hooks/use-is-host-safe-app.d.ts.map +1 -0
- package/dist/react-hooks/use-is-host-safe-app.js +16 -0
- package/dist/react-hooks/use-is-host-safe-app.js.map +1 -0
- package/dist/react-hooks/use-is-safe-app-context.d.ts +2 -0
- package/dist/react-hooks/use-is-safe-app-context.d.ts.map +1 -0
- package/dist/react-hooks/{use-safe-context.js → use-is-safe-app-context.js} +2 -2
- package/dist/react-hooks/use-is-safe-app-context.js.map +1 -0
- package/dist/react-hooks/use-is-safe-multisig-wallet.d.ts +2 -0
- package/dist/react-hooks/use-is-safe-multisig-wallet.d.ts.map +1 -0
- package/dist/react-hooks/use-is-safe-multisig-wallet.js +24 -0
- package/dist/react-hooks/use-is-safe-multisig-wallet.js.map +1 -0
- package/dist/safe/index.d.ts +1 -1
- package/dist/safe/index.d.ts.map +1 -1
- package/dist/safe/index.js.map +1 -1
- package/dist/safe/live.d.ts.map +1 -1
- package/dist/safe/live.js +14 -14
- package/dist/safe/live.js.map +1 -1
- package/dist/safe/service.d.ts +4 -4
- package/dist/safe/service.d.ts.map +1 -1
- package/dist/safe/service.js.map +1 -1
- package/dist/safe/service.test.integration.js +10 -12
- package/dist/safe/service.test.integration.js.map +1 -1
- package/dist/safe/simulation/abis.d.ts.map +1 -1
- package/dist/safe/simulation/abis.js.map +1 -1
- package/dist/safe/simulation/addresses.d.ts.map +1 -1
- package/dist/safe/simulation/addresses.js +40 -26
- package/dist/safe/simulation/addresses.js.map +1 -1
- package/dist/safe/simulation/internal/calldata/calldata.d.ts +5 -0
- package/dist/safe/simulation/internal/calldata/calldata.d.ts.map +1 -0
- package/dist/safe/simulation/internal/calldata/calldata.js +17 -0
- package/dist/safe/simulation/internal/calldata/calldata.js.map +1 -0
- package/dist/safe/simulation/internal/calldata/index.d.ts +2 -0
- package/dist/safe/simulation/internal/calldata/index.d.ts.map +1 -0
- package/dist/safe/simulation/internal/calldata/index.js +2 -0
- package/dist/safe/simulation/internal/calldata/index.js.map +1 -0
- package/dist/safe/simulation/internal/contracts/contracts.d.ts +5 -0
- package/dist/safe/simulation/internal/contracts/contracts.d.ts.map +1 -0
- package/dist/safe/simulation/internal/contracts/contracts.js +25 -0
- package/dist/safe/simulation/internal/contracts/contracts.js.map +1 -0
- package/dist/safe/simulation/internal/contracts/index.d.ts +2 -0
- package/dist/safe/simulation/internal/contracts/index.d.ts.map +1 -0
- package/dist/safe/simulation/internal/contracts/index.js +2 -0
- package/dist/safe/simulation/internal/contracts/index.js.map +1 -0
- package/dist/safe/simulation/internal/evaluation/evaluation.d.ts +6 -0
- package/dist/safe/simulation/internal/evaluation/evaluation.d.ts.map +1 -0
- package/dist/safe/simulation/internal/evaluation/evaluation.js +20 -0
- package/dist/safe/simulation/internal/evaluation/evaluation.js.map +1 -0
- package/dist/safe/simulation/internal/evaluation/index.d.ts +2 -0
- package/dist/safe/simulation/internal/evaluation/index.d.ts.map +1 -0
- package/dist/safe/simulation/internal/evaluation/index.js +2 -0
- package/dist/safe/simulation/internal/evaluation/index.js.map +1 -0
- package/dist/safe/simulation/internal/execution/execution.d.ts +9 -0
- package/dist/safe/simulation/internal/execution/execution.d.ts.map +1 -0
- package/dist/safe/simulation/internal/execution/execution.js +65 -0
- package/dist/safe/simulation/internal/execution/execution.js.map +1 -0
- package/dist/safe/simulation/internal/execution/index.d.ts +2 -0
- package/dist/safe/simulation/internal/execution/index.d.ts.map +1 -0
- package/dist/safe/simulation/internal/execution/index.js +2 -0
- package/dist/safe/simulation/internal/execution/index.js.map +1 -0
- package/dist/safe/simulation/internal/limits/index.d.ts +2 -0
- package/dist/safe/simulation/internal/limits/index.d.ts.map +1 -0
- package/dist/safe/simulation/internal/limits/index.js +2 -0
- package/dist/safe/simulation/internal/limits/index.js.map +1 -0
- package/dist/safe/simulation/internal/limits/limits.d.ts +5 -0
- package/dist/safe/simulation/internal/limits/limits.d.ts.map +1 -0
- package/dist/safe/simulation/internal/limits/limits.js +18 -0
- package/dist/safe/simulation/internal/limits/limits.js.map +1 -0
- package/dist/safe/simulation/internal/types/index.d.ts +2 -0
- package/dist/safe/simulation/internal/types/index.d.ts.map +1 -0
- package/dist/safe/simulation/internal/types/index.js +2 -0
- package/dist/safe/simulation/internal/types/index.js.map +1 -0
- package/dist/safe/simulation/internal/types/types.d.ts +11 -0
- package/dist/safe/simulation/internal/types/types.d.ts.map +1 -0
- package/dist/safe/simulation/internal/types/types.js +2 -0
- package/dist/safe/simulation/internal/types/types.js.map +1 -0
- package/dist/safe/simulation/internal/validation/index.d.ts +2 -0
- package/dist/safe/simulation/internal/validation/index.d.ts.map +1 -0
- package/dist/safe/simulation/internal/validation/index.js +2 -0
- package/dist/safe/simulation/internal/validation/index.js.map +1 -0
- package/dist/safe/simulation/internal/validation/validation.d.ts +5 -0
- package/dist/safe/simulation/internal/validation/validation.d.ts.map +1 -0
- package/dist/safe/simulation/internal/validation/validation.js +27 -0
- package/dist/safe/simulation/internal/validation/validation.js.map +1 -0
- package/dist/safe/simulation/service.d.ts +1 -1
- package/dist/safe/simulation/service.d.ts.map +1 -1
- package/dist/safe/simulation/service.js +12 -127
- package/dist/safe/simulation/service.js.map +1 -1
- package/dist/safe/types.d.ts +14 -14
- package/dist/safe/types.d.ts.map +1 -1
- package/dist/safe/types.js.map +1 -1
- package/dist/telemetry/tracer.d.ts +2 -2
- package/dist/telemetry/tracer.js +2 -2
- package/dist/telemetry/tracer.js.map +1 -1
- package/package.json +1 -1
- package/dist/react-hooks/use-is-safe-multisig.d.ts +0 -2
- package/dist/react-hooks/use-is-safe-multisig.d.ts.map +0 -1
- package/dist/react-hooks/use-is-safe-multisig.js +0 -44
- package/dist/react-hooks/use-is-safe-multisig.js.map +0 -1
- package/dist/react-hooks/use-safe-context.d.ts +0 -2
- package/dist/react-hooks/use-safe-context.d.ts.map +0 -1
- package/dist/react-hooks/use-safe-context.js.map +0 -1
|
@@ -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 @@
|
|
|
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 @@
|
|
|
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 @@
|
|
|
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 @@
|
|
|
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 @@
|
|
|
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 @@
|
|
|
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 @@
|
|
|
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 @@
|
|
|
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 @@
|
|
|
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 @@
|
|
|
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 @@
|
|
|
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;
|
|
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 {
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
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
|
-
|
|
16
|
-
|
|
17
|
-
|
|
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
|
|
71
|
-
|
|
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
|
}));
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/safe/simulation/service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Safe batch simulation service using Effect-TS.\n *\n * Simulates Safe multisig batch transactions to estimate gas consumption before execution.\n * Uses Safe's simulateAndRevert algorithm to get accurate gas estimates.\n *\n * @see https://github.com/safe-global/safe-smart-account/blob/c4859f4/contracts/common/StorageAccessible.sol#L32-L43\n */\n\nimport { Context, Effect, Layer } from \"effect\";\nimport { BaseError as CoreError, encodeFunctionData, zeroAddress } from \"viem\";\nimport type { ClientNotFoundError } from \"@/src/core/index.js\";\nimport { PublicClientService } from \"@/src/core/index.js\";\nimport { safeAbis } from \"./abis.js\";\nimport { getMultiSendAddress, getSimulateAccessorAddress } from \"./addresses.js\";\nimport { decodeSimulationData, encodeMultiSend } from \"./encoding.js\";\nimport {\n GasLimitOverflowError,\n InvalidGasThresholdError,\n SafeContractsNotDeployedError,\n SafeSimulationFailedError,\n SimulationDecodeError,\n TransactionSizeTooLargeError,\n} from \"./errors.js\";\nimport type { SafeSimulateBatchParams, SafeSimulationResult } from \"./types.js\";\n\nexport type SafeSimulationServiceShape = {\n /**\n * Simulate a batch of transactions in Safe context.\n *\n * Uses simulateAndRevert algorithm to estimate gas consumption. This always reverts,\n * and we decode the revert data to extract the gas estimate.\n *\n * @param params - Simulation parameters including chainId, safeAddress, and transactions\n * @returns Gas estimate and success flag\n */\n readonly simulateBatch: (\n params: SafeSimulateBatchParams\n ) => Effect.Effect<\n SafeSimulationResult,\n | ClientNotFoundError\n | InvalidGasThresholdError\n | SafeContractsNotDeployedError\n | TransactionSizeTooLargeError\n | SafeSimulationFailedError\n | SimulationDecodeError\n | GasLimitOverflowError\n >;\n};\n\nexport class SafeSimulationService extends Context.Tag(\"ew3/SafeSimulation\")<\n SafeSimulationService,\n SafeSimulationServiceShape\n>() {}\n\nexport const SafeSimulationServiceLive = Layer.effect(\n SafeSimulationService,\n Effect.gen(function* () {\n const publicClientService = yield* PublicClientService;\n\n return SafeSimulationService.of({\n simulateBatch: (params: SafeSimulateBatchParams) =>\n // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Safe simulation requires validation and multi-step orchestration\n Effect.gen(function* () {\n const { chainId, safeAddress, transactions, txSizeLimit, gasThresholdPercent } = params;\n\n // 0. Validate inputs\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 // 1. Check Safe contracts are deployed\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 // 2. Encode multiSend calldata\n const multiSendCalldata = encodeMultiSend(transactions);\n\n // 3. Encode simulateAccessor.simulate() calldata\n const simulateAccessorCalldata = encodeFunctionData({\n abi: safeAbis.simulateAccessor,\n args: [multiSendAddr, 0n, multiSendCalldata, 1], // 1 = DelegateCall\n functionName: \"simulate\",\n });\n\n // 4. Encode safe.simulateAndRevert() calldata\n const safeCalldata = encodeFunctionData({\n abi: safeAbis.multisig,\n args: [simulateAccessorAddr, simulateAccessorCalldata],\n functionName: \"simulateAndRevert\",\n });\n\n // 5. Check transaction size limit for ZK rollups\n if (txSizeLimit) {\n // Calculate size in bytes (remove \"0x\" prefix and divide by 2)\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 // 6. Get public client\n const client = yield* publicClientService.get(chainId);\n\n // 7. Execute simulation call and fetch block in parallel\n const simulationEffect = Effect.gen(function* () {\n // Execute the simulation call\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 // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Async error extraction requires try-catch\n try: async () => {\n try {\n await client.call({\n account: safeAddress,\n data: safeCalldata,\n to: safeAddress,\n });\n // Should never reach here\n throw new Error(\"simulateAndRevert did not revert\");\n } catch (error: unknown) {\n // Use viem's official BaseError API to extract revert data\n if (error instanceof CoreError) {\n // viem's BaseError.walk() traverses the error chain to find matching errors\n // We use it to find an error with revert data (the 'data' property)\n const revertError = error.walk((err) => {\n const typedErr = err as unknown as Record<string, unknown>;\n return typeof typedErr.data === \"string\";\n });\n if (revertError) {\n const typedErr = revertError as unknown as Record<string, unknown>;\n const extractedData = typedErr.data;\n if (typeof extractedData === \"string\") {\n return extractedData;\n }\n }\n }\n throw error;\n }\n },\n });\n\n // Decode the revert data\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 const [result, block] = yield* Effect.all(\n [\n simulationEffect,\n 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 { concurrency: \"unbounded\" }\n );\n\n // 8. Check if gas exceeds threshold\n const threshold = (block.gasLimit * BigInt(params.gasThresholdPercent ?? 95)) / 100n;\n\n if (result.success && result.gas > threshold) {\n return yield* 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 yield* Effect.fail(\n new SafeSimulationFailedError({\n message: \"Transaction simulation failed - the transaction would revert\",\n })\n );\n }\n\n return { estimatedGas: result.gas, success: true };\n }),\n });\n })\n);\n"]}
|
|
1
|
+
{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/safe/simulation/service.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAS1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AA2B1E,MAAM,OAAO,qBAAsB,SAAQ,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,EAGzE;CAAG;AAEN,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC,MAAM,CACnD,qBAAqB,EACrB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,mBAAmB,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC;IAEvD,OAAO,qBAAqB,CAAC,EAAE,CAAC;QAC9B,aAAa,EAAE,CAAC,MAA+B,EAAE,EAAE,CACjD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,GAC5E,KAAK,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;YACvD,MAAM,YAAY,GAAG,iBAAiB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;YAEhE,KAAK,CAAC,CAAC,kBAAkB,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;YAErD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvD,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CACvC,CAAC,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,EAChF,EAAE,WAAW,EAAE,WAAW,EAAE,CAC7B,CAAC;YAEF,OAAO,KAAK,CAAC,CAAC,wBAAwB,CAAC,MAAM,EAAE,KAAK,EAAE,mBAAmB,CAAC,CAAC;QAC7E,CAAC,CAAC;KACL,CAAC,CAAC;AACL,CAAC,CAAC,CACH,CAAC","sourcesContent":["/**\n * Safe batch simulation service using Effect-TS.\n *\n * Simulates Safe multisig batch transactions to estimate gas consumption before execution.\n * Uses Safe's simulateAndRevert algorithm to get accurate gas estimates.\n *\n * @see https://github.com/safe-global/safe-smart-account/blob/c4859f4/contracts/common/StorageAccessible.sol#L32-L43\n */\n\nimport { Context, Effect, Layer } from \"effect\";\nimport type { ClientNotFoundError } from \"@/src/core/index.js\";\nimport { PublicClientService } from \"@/src/core/index.js\";\nimport type {\n GasLimitOverflowError,\n InvalidGasThresholdError,\n SafeContractsNotDeployedError,\n SafeSimulationFailedError,\n SimulationDecodeError,\n TransactionSizeTooLargeError,\n} from \"./errors.js\";\nimport { buildSafeCalldata } from \"./internal/calldata/index.js\";\nimport { resolveSafeContracts } from \"./internal/contracts/index.js\";\nimport { evaluateSimulationResult } from \"./internal/evaluation/index.js\";\nimport { fetchLatestBlock, simulateAndDecode } from \"./internal/execution/index.js\";\nimport { enforceTxSizeLimit } from \"./internal/limits/index.js\";\nimport { validateSimulationParams } from \"./internal/validation/index.js\";\nimport type { SafeSimulateBatchParams, SafeSimulationResult } from \"./types.js\";\n\nexport type SafeSimulationServiceShape = {\n /**\n * Simulate a batch of transactions in Safe context.\n *\n * Uses simulateAndRevert algorithm to estimate gas consumption. This always reverts,\n * and we decode the revert data to extract the gas estimate.\n *\n * @param params - Simulation parameters including chainId, safeAddress, and transactions\n * @returns Gas estimate and success flag\n */\n readonly simulateBatch: (\n params: SafeSimulateBatchParams\n ) => Effect.Effect<\n SafeSimulationResult,\n | ClientNotFoundError\n | InvalidGasThresholdError\n | SafeContractsNotDeployedError\n | TransactionSizeTooLargeError\n | SafeSimulationFailedError\n | SimulationDecodeError\n | GasLimitOverflowError\n >;\n};\n\nexport class SafeSimulationService extends Context.Tag(\"ew3/SafeSimulation\")<\n SafeSimulationService,\n SafeSimulationServiceShape\n>() {}\n\nexport const SafeSimulationServiceLive = Layer.effect(\n SafeSimulationService,\n Effect.gen(function* () {\n const publicClientService = yield* PublicClientService;\n\n return SafeSimulationService.of({\n simulateBatch: (params: SafeSimulateBatchParams) =>\n Effect.gen(function* () {\n const { chainId, safeAddress, transactions, txSizeLimit, gasThresholdPercent } =\n yield* validateSimulationParams(params);\n const contracts = yield* resolveSafeContracts(chainId);\n const safeCalldata = buildSafeCalldata(contracts, transactions);\n\n yield* enforceTxSizeLimit(safeCalldata, txSizeLimit);\n\n const client = yield* publicClientService.get(chainId);\n const [result, block] = yield* Effect.all(\n [simulateAndDecode(client, safeAddress, safeCalldata), fetchLatestBlock(client)],\n { concurrency: \"unbounded\" }\n );\n\n return yield* evaluateSimulationResult(result, block, gasThresholdPercent);\n }),\n });\n })\n);\n"]}
|