sigild 0.0.13 → 0.0.14

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 (107) hide show
  1. package/README.md +50 -3
  2. package/THREAT_MODEL.md +2 -0
  3. package/dist/src/audit/index.d.ts +1 -1
  4. package/dist/src/audit/index.d.ts.map +1 -1
  5. package/dist/src/audit/index.js.map +1 -1
  6. package/dist/src/audit/log.d.ts +15 -0
  7. package/dist/src/audit/log.d.ts.map +1 -1
  8. package/dist/src/audit/log.js +2 -0
  9. package/dist/src/audit/log.js.map +1 -1
  10. package/dist/src/bin/sigil-mcp.js +68 -7
  11. package/dist/src/bin/sigil-mcp.js.map +1 -1
  12. package/dist/src/cli/paths.d.ts +2 -0
  13. package/dist/src/cli/paths.d.ts.map +1 -1
  14. package/dist/src/cli/paths.js +1 -0
  15. package/dist/src/cli/paths.js.map +1 -1
  16. package/dist/src/confirm/config.d.ts +19 -0
  17. package/dist/src/confirm/config.d.ts.map +1 -1
  18. package/dist/src/confirm/config.js +48 -0
  19. package/dist/src/confirm/config.js.map +1 -1
  20. package/dist/src/confirm/index.d.ts +1 -1
  21. package/dist/src/confirm/index.d.ts.map +1 -1
  22. package/dist/src/confirm/index.js.map +1 -1
  23. package/dist/src/daemon/handles.d.ts +6 -0
  24. package/dist/src/daemon/handles.d.ts.map +1 -1
  25. package/dist/src/daemon/handles.js +11 -0
  26. package/dist/src/daemon/handles.js.map +1 -1
  27. package/dist/src/daemon/index.d.ts +1 -1
  28. package/dist/src/daemon/index.d.ts.map +1 -1
  29. package/dist/src/daemon/index.js.map +1 -1
  30. package/dist/src/daemon/methods.d.ts +21 -0
  31. package/dist/src/daemon/methods.d.ts.map +1 -1
  32. package/dist/src/daemon/methods.js +179 -27
  33. package/dist/src/daemon/methods.js.map +1 -1
  34. package/dist/src/eth/abi.d.ts +82 -0
  35. package/dist/src/eth/abi.d.ts.map +1 -0
  36. package/dist/src/eth/abi.js +328 -0
  37. package/dist/src/eth/abi.js.map +1 -0
  38. package/dist/src/eth/index.d.ts +1 -0
  39. package/dist/src/eth/index.d.ts.map +1 -1
  40. package/dist/src/eth/index.js +1 -0
  41. package/dist/src/eth/index.js.map +1 -1
  42. package/dist/src/mcp/parent-watchdog.d.ts +31 -0
  43. package/dist/src/mcp/parent-watchdog.d.ts.map +1 -0
  44. package/dist/src/mcp/parent-watchdog.js +35 -0
  45. package/dist/src/mcp/parent-watchdog.js.map +1 -0
  46. package/dist/src/mcp/server.d.ts +7 -0
  47. package/dist/src/mcp/server.d.ts.map +1 -1
  48. package/dist/src/mcp/server.js +13 -2
  49. package/dist/src/mcp/server.js.map +1 -1
  50. package/dist/src/mcp/tools.d.ts.map +1 -1
  51. package/dist/src/mcp/tools.js +21 -1
  52. package/dist/src/mcp/tools.js.map +1 -1
  53. package/dist/src/policy/ledger.d.ts +1 -0
  54. package/dist/src/policy/ledger.d.ts.map +1 -1
  55. package/dist/src/policy/ledger.js +70 -44
  56. package/dist/src/policy/ledger.js.map +1 -1
  57. package/dist/src/policy/loader.d.ts.map +1 -1
  58. package/dist/src/policy/loader.js +9 -0
  59. package/dist/src/policy/loader.js.map +1 -1
  60. package/dist/src/policy/template.d.ts +2 -2
  61. package/dist/src/policy/template.d.ts.map +1 -1
  62. package/dist/src/policy/template.js +20 -0
  63. package/dist/src/policy/template.js.map +1 -1
  64. package/dist/src/policy/types.d.ts +16 -0
  65. package/dist/src/policy/types.d.ts.map +1 -1
  66. package/dist/src/policy/types.js.map +1 -1
  67. package/dist/src/preview/abi-dir.d.ts +50 -0
  68. package/dist/src/preview/abi-dir.d.ts.map +1 -0
  69. package/dist/src/preview/abi-dir.js +175 -0
  70. package/dist/src/preview/abi-dir.js.map +1 -0
  71. package/dist/src/preview/decode.d.ts +26 -0
  72. package/dist/src/preview/decode.d.ts.map +1 -0
  73. package/dist/src/preview/decode.js +110 -0
  74. package/dist/src/preview/decode.js.map +1 -0
  75. package/dist/src/preview/format.d.ts +45 -0
  76. package/dist/src/preview/format.d.ts.map +1 -0
  77. package/dist/src/preview/format.js +222 -0
  78. package/dist/src/preview/format.js.map +1 -0
  79. package/dist/src/preview/index.d.ts +60 -0
  80. package/dist/src/preview/index.d.ts.map +1 -0
  81. package/dist/src/preview/index.js +163 -0
  82. package/dist/src/preview/index.js.map +1 -0
  83. package/dist/src/preview/known.d.ts +74 -0
  84. package/dist/src/preview/known.d.ts.map +1 -0
  85. package/dist/src/preview/known.js +425 -0
  86. package/dist/src/preview/known.js.map +1 -0
  87. package/dist/src/preview/simulate.d.ts +156 -0
  88. package/dist/src/preview/simulate.d.ts.map +1 -0
  89. package/dist/src/preview/simulate.js +768 -0
  90. package/dist/src/preview/simulate.js.map +1 -0
  91. package/dist/src/preview/simulators.d.ts +39 -0
  92. package/dist/src/preview/simulators.d.ts.map +1 -0
  93. package/dist/src/preview/simulators.js +71 -0
  94. package/dist/src/preview/simulators.js.map +1 -0
  95. package/dist/src/preview/trust.d.ts +49 -0
  96. package/dist/src/preview/trust.d.ts.map +1 -0
  97. package/dist/src/preview/trust.js +279 -0
  98. package/dist/src/preview/trust.js.map +1 -0
  99. package/dist/src/preview/types.d.ts +69 -0
  100. package/dist/src/preview/types.d.ts.map +1 -0
  101. package/dist/src/preview/types.js +11 -0
  102. package/dist/src/preview/types.js.map +1 -0
  103. package/dist/src/preview/units.d.ts +75 -0
  104. package/dist/src/preview/units.d.ts.map +1 -0
  105. package/dist/src/preview/units.js +228 -0
  106. package/dist/src/preview/units.js.map +1 -0
  107. package/package.json +1 -1
@@ -0,0 +1,425 @@
1
+ import { canonicalType, eventTopic, functionSelector, parseAbiType, } from '../eth/abi.js';
2
+ import { rawCallText } from './trust.js';
3
+ import { argAmount, formatEth, formatTimestamp, headAmount, isUnlimited, shortAddr, tokenLabel, truncHex, ZERO_ADDRESS, } from './units.js';
4
+ function fn(name, params, describe) {
5
+ const inputs = params.map(([type, n]) => {
6
+ const abiType = parseAbiType(type);
7
+ return { name: n, type: canonicalType(abiType), abiType };
8
+ });
9
+ const signature = `${name}(${inputs.map((i) => i.type).join(',')})`;
10
+ return { selector: functionSelector(signature), signature, name, inputs, describe };
11
+ }
12
+ const a = (v) => v; // address (already lowercase from the decoder)
13
+ const n = (v) => v;
14
+ function zeroWarn(addr, what) {
15
+ return addr === ZERO_ADDRESS ? [`${what} to the zero address`] : [];
16
+ }
17
+ function recipientWarn(recipient, ctx) {
18
+ if (ctx.from === undefined || recipient === ctx.from)
19
+ return [];
20
+ // Uniswap routers use address(1)/address(2) as "msg.sender"/"this" sentinels.
21
+ if (/^0x0{39}[12]$/.test(recipient))
22
+ return [];
23
+ return [`swap output goes to ${shortAddr(recipient)}, not the portal`];
24
+ }
25
+ function slippageWarn(minOut) {
26
+ return minOut === 0n ? ['swap has no slippage protection (minimum output 0)'] : [];
27
+ }
28
+ // --- ERC-20 / ERC-721 ------------------------------------------------------
29
+ const transfer = fn('transfer', [
30
+ ['address', 'to'],
31
+ ['uint256', 'amount'],
32
+ ], ([to, amt], ctx) => {
33
+ const token = ctx.to ?? ZERO_ADDRESS;
34
+ return {
35
+ text: `transfer(to=${shortAddr(a(to))}, amount=${argAmount(n(amt), token, ctx.meta)})`,
36
+ short: `transfer ${headAmount(n(amt), token, ctx.meta)} → ${shortAddr(a(to))}`,
37
+ warnings: zeroWarn(a(to), 'transfer'),
38
+ tokens: [token],
39
+ };
40
+ });
41
+ const approve = fn('approve', [
42
+ ['address', 'spender'],
43
+ ['uint256', 'amount'],
44
+ ], ([spender, amt], ctx) => {
45
+ const token = ctx.to ?? ZERO_ADDRESS;
46
+ const unlimited = isUnlimited(n(amt));
47
+ return {
48
+ text: `approve(spender=${shortAddr(a(spender))}, amount=${argAmount(n(amt), token, ctx.meta, { allowanceBits: 256 })})`,
49
+ short: `approve ${headAmount(n(amt), token, ctx.meta, { allowanceBits: 256 })} → ${shortAddr(a(spender))}`,
50
+ warnings: [...(unlimited ? ['UNLIMITED approval'] : []), ...zeroWarn(a(spender), 'approve')],
51
+ tokens: [token],
52
+ };
53
+ });
54
+ const transferFrom = fn('transferFrom', [
55
+ ['address', 'from'],
56
+ ['address', 'to'],
57
+ ['uint256', 'amount'],
58
+ ], ([from, to, amt], ctx) => {
59
+ const token = ctx.to ?? ZERO_ADDRESS;
60
+ return {
61
+ text: `transferFrom(from=${shortAddr(a(from))}, to=${shortAddr(a(to))}, amount=${argAmount(n(amt), token, ctx.meta)})`,
62
+ short: `transferFrom ${headAmount(n(amt), token, ctx.meta)} ${shortAddr(a(from))} → ${shortAddr(a(to))}`,
63
+ warnings: zeroWarn(a(to), 'transfer'),
64
+ tokens: [token],
65
+ };
66
+ });
67
+ function allowanceDelta(name) {
68
+ return fn(name, [
69
+ ['address', 'spender'],
70
+ ['uint256', name === 'increaseAllowance' ? 'addedValue' : 'subtractedValue'],
71
+ ], ([spender, amt], ctx) => {
72
+ const token = ctx.to ?? ZERO_ADDRESS;
73
+ const unlimited = name === 'increaseAllowance' && isUnlimited(n(amt));
74
+ const verb = name === 'increaseAllowance' ? 'raise' : 'lower';
75
+ return {
76
+ text: `${name}(spender=${shortAddr(a(spender))}, amount=${argAmount(n(amt), token, ctx.meta, { allowanceBits: 256 })})`,
77
+ short: `${verb} allowance of ${shortAddr(a(spender))} by ${headAmount(n(amt), token, ctx.meta, { allowanceBits: 256 })}`,
78
+ warnings: unlimited ? ['UNLIMITED approval'] : [],
79
+ tokens: [token],
80
+ };
81
+ });
82
+ }
83
+ // --- ERC-721 / ERC-1155 ----------------------------------------------------
84
+ /** Shared with the simulator so a decoded grant and a simulated one dedupe. */
85
+ export function operatorWarning(operator, collection) {
86
+ return `setApprovalForAll: ${shortAddr(operator)} gets control of EVERY token in ${shortAddr(collection)}`;
87
+ }
88
+ const setApprovalForAll = fn('setApprovalForAll', [
89
+ ['address', 'operator'],
90
+ ['bool', 'approved'],
91
+ ], ([op, approved], ctx) => {
92
+ const coll = shortAddr(ctx.to ?? ZERO_ADDRESS);
93
+ const on = approved;
94
+ return {
95
+ text: `setApprovalForAll(operator=${shortAddr(a(op))}, approved=${on})`,
96
+ short: on
97
+ ? `approve ALL of ${coll} → ${shortAddr(a(op))}`
98
+ : `revoke ${shortAddr(a(op))} on ${coll}`,
99
+ warnings: on ? [operatorWarning(a(op), ctx.to ?? ZERO_ADDRESS)] : [],
100
+ };
101
+ });
102
+ function nftTransfer(withData) {
103
+ const params = [
104
+ ['address', 'from'],
105
+ ['address', 'to'],
106
+ ['uint256', 'tokenId'],
107
+ ];
108
+ if (withData)
109
+ params.push(['bytes', 'data']);
110
+ return fn('safeTransferFrom', params, ([from, to, id], ctx) => ({
111
+ text: `safeTransferFrom(from=${shortAddr(a(from))}, to=${shortAddr(a(to))}, tokenId=${n(id)})`,
112
+ short: `send NFT ${shortAddr(ctx.to ?? ZERO_ADDRESS)} #${n(id)} → ${shortAddr(a(to))}`,
113
+ warnings: zeroWarn(a(to), 'transfer'),
114
+ }));
115
+ }
116
+ const erc1155Transfer = fn('safeTransferFrom', [
117
+ ['address', 'from'],
118
+ ['address', 'to'],
119
+ ['uint256', 'id'],
120
+ ['uint256', 'amount'],
121
+ ['bytes', 'data'],
122
+ ], ([from, to, id, amt], ctx) => ({
123
+ text: `safeTransferFrom(from=${shortAddr(a(from))}, to=${shortAddr(a(to))}, id=${n(id)}, amount=${n(amt)})`,
124
+ short: `send ${n(amt)} × id ${n(id)} of ${shortAddr(ctx.to ?? ZERO_ADDRESS)} → ${shortAddr(a(to))}`,
125
+ warnings: zeroWarn(a(to), 'transfer'),
126
+ }));
127
+ const erc1155Batch = fn('safeBatchTransferFrom', [
128
+ ['address', 'from'],
129
+ ['address', 'to'],
130
+ ['uint256[]', 'ids'],
131
+ ['uint256[]', 'amounts'],
132
+ ['bytes', 'data'],
133
+ ], ([from, to, ids], ctx) => {
134
+ const count = ids.length;
135
+ return {
136
+ text: `safeBatchTransferFrom(from=${shortAddr(a(from))}, to=${shortAddr(a(to))}, ${count} token ids)`,
137
+ short: `send ${count} token ids of ${shortAddr(ctx.to ?? ZERO_ADDRESS)} → ${shortAddr(a(to))}`,
138
+ warnings: zeroWarn(a(to), 'transfer'),
139
+ };
140
+ });
141
+ // --- WETH ------------------------------------------------------------------
142
+ const wethDeposit = fn('deposit', [], (_args, ctx) => ({
143
+ text: `deposit() — wrap ${formatEth(ctx.value)}`,
144
+ short: `wrap ${formatEth(ctx.value)}`,
145
+ warnings: [],
146
+ }));
147
+ const wethWithdraw = fn('withdraw', [['uint256', 'amount']], ([amt], ctx) => {
148
+ const token = ctx.to ?? ZERO_ADDRESS;
149
+ return {
150
+ text: `withdraw(amount=${argAmount(n(amt), token, ctx.meta)})`,
151
+ short: `withdraw ${headAmount(n(amt), token, ctx.meta)}`,
152
+ warnings: [],
153
+ tokens: [token],
154
+ };
155
+ });
156
+ // --- Permit2 ---------------------------------------------------------------
157
+ const permit2Approve = fn('approve', [
158
+ ['address', 'token'],
159
+ ['address', 'spender'],
160
+ ['uint160', 'amount'],
161
+ ['uint48', 'expiration'],
162
+ ], ([token, spender, amt, exp], ctx) => {
163
+ const unlimited = isUnlimited(n(amt), 160);
164
+ return {
165
+ text: `Permit2 approve(token=${tokenLabel(a(token), ctx.meta)}, spender=${shortAddr(a(spender))}, ` +
166
+ `amount=${argAmount(n(amt), a(token), ctx.meta, { allowanceBits: 160 })}, expiration=${formatTimestamp(n(exp))})`,
167
+ short: `Permit2: approve ${headAmount(n(amt), a(token), ctx.meta, { allowanceBits: 160 })} → ${shortAddr(a(spender))}`,
168
+ warnings: [...(unlimited ? ['UNLIMITED approval'] : []), ...zeroWarn(a(spender), 'approve')],
169
+ tokens: [a(token)],
170
+ };
171
+ });
172
+ // --- Uniswap V2 router -----------------------------------------------------
173
+ function pathText(path, meta) {
174
+ return path.map((t) => tokenLabel(t, meta)).join('→');
175
+ }
176
+ function v2Swap(name, params, render) {
177
+ return fn(name, params, (args, ctx) => {
178
+ const path = args[params.findIndex(([, nm]) => nm === 'path')];
179
+ const recipient = a(args[params.findIndex(([, nm]) => nm === 'to')]);
180
+ const deadline = n(args[params.length - 1]);
181
+ const { short, minOut, outToken } = render(args, ctx);
182
+ const head = params
183
+ .filter(([, nm]) => nm.startsWith('amount'))
184
+ .map(([, nm]) => `${nm}=${n(args[params.findIndex(([, x]) => x === nm)])}`);
185
+ return {
186
+ text: `${name}(${[...head, `path=${pathText(path, ctx.meta)}`, `to=${shortAddr(recipient)}`, `deadline=${formatTimestamp(deadline)}`].join(', ')})`,
187
+ short,
188
+ warnings: [...recipientWarn(recipient, ctx), ...slippageWarn(minOut)],
189
+ tokens: path,
190
+ swapOut: { token: outToken, min: minOut.toString(), recipient },
191
+ };
192
+ });
193
+ }
194
+ const first = (p) => p[0] ?? ZERO_ADDRESS;
195
+ const last = (p) => p[p.length - 1] ?? ZERO_ADDRESS;
196
+ const swapExactTokensForTokens = v2Swap('swapExactTokensForTokens', [
197
+ ['uint256', 'amountIn'],
198
+ ['uint256', 'amountOutMin'],
199
+ ['address[]', 'path'],
200
+ ['address', 'to'],
201
+ ['uint256', 'deadline'],
202
+ ], ([inAmt, minOut, path], ctx) => ({
203
+ short: `swap ${headAmount(n(inAmt), first(path), ctx.meta)} → ≥${headAmount(n(minOut), last(path), ctx.meta)}`,
204
+ minOut: n(minOut),
205
+ outToken: last(path),
206
+ }));
207
+ const swapExactETHForTokens = v2Swap('swapExactETHForTokens', [
208
+ ['uint256', 'amountOutMin'],
209
+ ['address[]', 'path'],
210
+ ['address', 'to'],
211
+ ['uint256', 'deadline'],
212
+ ], ([minOut, path], ctx) => ({
213
+ short: `swap ${formatEth(ctx.value)} → ≥${headAmount(n(minOut), last(path), ctx.meta)}`,
214
+ minOut: n(minOut),
215
+ outToken: last(path),
216
+ }));
217
+ const swapExactTokensForETH = v2Swap('swapExactTokensForETH', [
218
+ ['uint256', 'amountIn'],
219
+ ['uint256', 'amountOutMin'],
220
+ ['address[]', 'path'],
221
+ ['address', 'to'],
222
+ ['uint256', 'deadline'],
223
+ ], ([inAmt, minOut, path], ctx) => ({
224
+ short: `swap ${headAmount(n(inAmt), first(path), ctx.meta)} → ≥${formatEth(n(minOut))}`,
225
+ minOut: n(minOut),
226
+ outToken: null,
227
+ }));
228
+ const swapTokensForExactTokens = v2Swap('swapTokensForExactTokens', [
229
+ ['uint256', 'amountOut'],
230
+ ['uint256', 'amountInMax'],
231
+ ['address[]', 'path'],
232
+ ['address', 'to'],
233
+ ['uint256', 'deadline'],
234
+ ], ([out, inMax, path], ctx) => ({
235
+ short: `swap ≤${headAmount(n(inMax), first(path), ctx.meta)} → ${headAmount(n(out), last(path), ctx.meta)}`,
236
+ minOut: n(out),
237
+ outToken: last(path),
238
+ }));
239
+ // --- Uniswap V3 router -----------------------------------------------------
240
+ /** exactInputSingle / exactOutputSingle, with or without the deadline field. */
241
+ function v3Single(kind, deadline) {
242
+ const amountA = kind === 'exactInputSingle' ? 'amountIn' : 'amountOut';
243
+ const amountB = kind === 'exactInputSingle' ? 'amountOutMinimum' : 'amountInMaximum';
244
+ const fields = [
245
+ ['address', 'tokenIn'],
246
+ ['address', 'tokenOut'],
247
+ ['uint24', 'fee'],
248
+ ['address', 'recipient'],
249
+ ...(deadline ? [['uint256', 'deadline']] : []),
250
+ ['uint256', amountA],
251
+ ['uint256', amountB],
252
+ ['uint160', 'sqrtPriceLimitX96'],
253
+ ];
254
+ const tupleType = `(${fields.map(([t]) => t).join(',')})`;
255
+ return fn(kind, [[tupleType, 'params']], ([p], ctx) => {
256
+ const v = p;
257
+ const get = (nm) => v[fields.findIndex(([, x]) => x === nm)];
258
+ const tokenIn = a(get('tokenIn'));
259
+ const tokenOut = a(get('tokenOut'));
260
+ const recipient = a(get('recipient'));
261
+ const amtA = n(get(amountA));
262
+ const amtB = n(get(amountB));
263
+ const short = kind === 'exactInputSingle'
264
+ ? `swap ${headAmount(amtA, tokenIn, ctx.meta)} → ≥${headAmount(amtB, tokenOut, ctx.meta)}`
265
+ : `swap ≤${headAmount(amtB, tokenIn, ctx.meta)} → ${headAmount(amtA, tokenOut, ctx.meta)}`;
266
+ const parts = [
267
+ `tokenIn=${tokenLabel(tokenIn, ctx.meta)}`,
268
+ `tokenOut=${tokenLabel(tokenOut, ctx.meta)}`,
269
+ `fee=${n(get('fee'))}`,
270
+ `recipient=${shortAddr(recipient)}`,
271
+ ...(deadline ? [`deadline=${formatTimestamp(n(get('deadline')))}`] : []),
272
+ `${amountA}=${amtA}`,
273
+ `${amountB}=${amtB}`,
274
+ ];
275
+ return {
276
+ text: `${kind}(${parts.join(', ')})`,
277
+ short,
278
+ warnings: [
279
+ ...recipientWarn(recipient, ctx),
280
+ ...(kind === 'exactInputSingle' ? slippageWarn(amtB) : []),
281
+ ],
282
+ tokens: [tokenIn, tokenOut],
283
+ swapOut: {
284
+ token: tokenOut,
285
+ // exactInput*: at least amountOutMinimum; exactOutput*: exactly amountOut.
286
+ min: (kind === 'exactInputSingle' ? amtB : amtA).toString(),
287
+ recipient,
288
+ },
289
+ };
290
+ });
291
+ }
292
+ /** Decode a V3 packed path: token(20) [fee(3) token(20)]*. Null if malformed. */
293
+ export function decodeV3Path(hex) {
294
+ const body = hex.startsWith('0x') ? hex.slice(2) : hex;
295
+ if (body.length < 40 || (body.length - 40) % 46 !== 0)
296
+ return null;
297
+ const tokens = ['0x' + body.slice(0, 40)];
298
+ for (let i = 40; i < body.length; i += 46)
299
+ tokens.push('0x' + body.slice(i + 6, i + 46));
300
+ return tokens.map((t) => t.toLowerCase());
301
+ }
302
+ const exactInput = fn('exactInput', [['(bytes,address,uint256,uint256,uint256)', 'params']], ([p], ctx) => {
303
+ const [path, recipient, deadline, amountIn, minOut] = p;
304
+ const tokens = decodeV3Path(path);
305
+ const tokenIn = tokens?.[0];
306
+ const tokenOut = tokens?.[tokens.length - 1];
307
+ const short = tokenIn && tokenOut
308
+ ? `swap ${headAmount(amountIn, tokenIn, ctx.meta)} → ≥${headAmount(minOut, tokenOut, ctx.meta)}`
309
+ : `swap ${amountIn} via undecodable path`;
310
+ return {
311
+ text: `exactInput(path=${tokens ? pathText(tokens, ctx.meta) : 'malformed'}, recipient=${shortAddr(recipient)}, ` +
312
+ `deadline=${formatTimestamp(deadline)}, amountIn=${amountIn}, amountOutMinimum=${minOut})`,
313
+ short,
314
+ warnings: [
315
+ ...(tokens ? [] : ['exactInput path is malformed']),
316
+ ...recipientWarn(recipient, ctx),
317
+ ...slippageWarn(minOut),
318
+ ],
319
+ ...(tokens ? { tokens } : {}),
320
+ ...(tokenOut ? { swapOut: { token: tokenOut, min: minOut.toString(), recipient } } : {}),
321
+ };
322
+ });
323
+ // --- Universal Router / multicall ------------------------------------------
324
+ const universalExecute = fn('execute', [
325
+ ['bytes', 'commands'],
326
+ ['bytes[]', 'inputs'],
327
+ ['uint256', 'deadline'],
328
+ ], ([commands, , deadline]) => {
329
+ const count = (a(commands).length - 2) / 2;
330
+ return {
331
+ text: `Universal Router execute(${count} command${count === 1 ? '' : 's'} ${truncHex(a(commands))}, deadline=${formatTimestamp(n(deadline))})`,
332
+ short: `Universal Router: ${count} command${count === 1 ? '' : 's'}`,
333
+ warnings: [],
334
+ };
335
+ });
336
+ function multicall(withDeadline) {
337
+ const params = withDeadline
338
+ ? [
339
+ ['uint256', 'deadline'],
340
+ ['bytes[]', 'data'],
341
+ ]
342
+ : [['bytes[]', 'data']];
343
+ return fn('multicall', params, (args, ctx) => {
344
+ const calls = args[args.length - 1];
345
+ const inner = calls.map((hex) => ctx.decodeInner ? ctx.decodeInner(Buffer.from(hex.slice(2), 'hex')) : undefined);
346
+ // Inner calls are only behaviour-checked through their swap claims
347
+ // (innerSwaps), so they never earn a friendly verb: each is shown by
348
+ // its raw signature and decoded args.
349
+ const on = ` on ${shortAddr(ctx.to ?? ZERO_ADDRESS)}`;
350
+ const MAX = 8;
351
+ const texts = inner
352
+ .slice(0, MAX)
353
+ .map((d, i) => d === undefined
354
+ ? `call ${i}`
355
+ : d.source === 'builtin' || d.source === 'abi'
356
+ ? rawCallText(d) + on
357
+ : d.text);
358
+ if (inner.length > MAX)
359
+ texts.push(`…+${inner.length - MAX} more`);
360
+ const warnings = [];
361
+ const tokens = [];
362
+ const innerSwaps = [];
363
+ inner.forEach((d, i) => {
364
+ for (const w of d?.warnings ?? [])
365
+ warnings.push(`multicall[${i}]: ${w}`);
366
+ tokens.push(...(d?.tokens ?? []));
367
+ if (d?.swapOut)
368
+ innerSwaps.push({ index: i, out: d.swapOut });
369
+ });
370
+ const dl = withDeadline ? `, deadline=${formatTimestamp(n(args[0]))}` : '';
371
+ const count = `${calls.length} call${calls.length === 1 ? '' : 's'}`;
372
+ return {
373
+ text: `multicall(${count}: ${texts.join('; ')}${dl})`,
374
+ short: `multicall (${count})`,
375
+ warnings,
376
+ tokens,
377
+ ...(innerSwaps.length > 0 ? { innerSwaps } : {}),
378
+ };
379
+ });
380
+ }
381
+ const ALL = [
382
+ transfer,
383
+ approve,
384
+ transferFrom,
385
+ allowanceDelta('increaseAllowance'),
386
+ allowanceDelta('decreaseAllowance'),
387
+ setApprovalForAll,
388
+ nftTransfer(false),
389
+ nftTransfer(true),
390
+ erc1155Transfer,
391
+ erc1155Batch,
392
+ wethDeposit,
393
+ wethWithdraw,
394
+ permit2Approve,
395
+ swapExactTokensForTokens,
396
+ swapExactETHForTokens,
397
+ swapExactTokensForETH,
398
+ swapTokensForExactTokens,
399
+ v3Single('exactInputSingle', true),
400
+ v3Single('exactInputSingle', false),
401
+ exactInput,
402
+ v3Single('exactOutputSingle', true),
403
+ universalExecute,
404
+ multicall(false),
405
+ multicall(true),
406
+ ];
407
+ /** selector → built-in entry. */
408
+ export const KNOWN_FUNCTIONS = new Map(ALL.map((f) => [f.selector, f]));
409
+ /** Selectors whose `to` is an ERC-20 (metadata for `to` improves the text). */
410
+ export const ERC20_SELECTORS = new Set([transfer, approve, transferFrom, wethWithdraw].map((f) => f.selector));
411
+ // --- Events (simulation logs) ----------------------------------------------
412
+ /** topic0 of the events the simulator understands. */
413
+ export const EVENT_TOPICS = Object.freeze({
414
+ /** ERC-20 (3 topics + amount) and ERC-721 (4 topics, tokenId indexed). */
415
+ Transfer: eventTopic('Transfer(address,address,uint256)'),
416
+ /** ERC-20 (3 topics + amount) and ERC-721 (4 topics). */
417
+ Approval: eventTopic('Approval(address,address,uint256)'),
418
+ ApprovalForAll: eventTopic('ApprovalForAll(address,address,bool)'),
419
+ TransferSingle: eventTopic('TransferSingle(address,address,address,uint256,uint256)'),
420
+ TransferBatch: eventTopic('TransferBatch(address,address,address,uint256[],uint256[])'),
421
+ /** WETH9 wrap/unwrap: no Transfer is emitted, so these move the balance. */
422
+ Deposit: eventTopic('Deposit(address,uint256)'),
423
+ Withdrawal: eventTopic('Withdrawal(address,uint256)'),
424
+ });
425
+ //# sourceMappingURL=known.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"known.js","sourceRoot":"","sources":["../../../src/preview/known.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,156 @@
1
+ import type { SignableTx } from '../eth/index.js';
2
+ import { type JsonRpcUpstream } from '../rpc/upstream.js';
3
+ import type { TokenMeta } from './types.js';
4
+ /**
5
+ * Dry-run a transaction on the user's configured RPC node and summarize
6
+ * what it would do to the portal: status, gas, revert reason, native and
7
+ * token balance deltas, approvals granted.
8
+ *
9
+ * Primary primitive: eth_simulateV1 (one call; geth, reth, anvil and the
10
+ * big hosted providers serve it) with `traceTransfers`, which also reports
11
+ * native ETH movements as synthetic ERC-20-style Transfer logs. Nodes that
12
+ * don't serve it get an eth_call + eth_estimateGas fallback: status and gas
13
+ * only, balance changes unknown.
14
+ *
15
+ * Never throws. Any transport failure, timeout or malformed node response
16
+ * becomes `{ status: 'unavailable', reason }` — the caller decides whether
17
+ * that matters (policy `require_simulation`) or is just a warning.
18
+ *
19
+ * Trust: the node is the user's own choice and the tx would be broadcast
20
+ * there anyway, but its answer is not authenticated. Logs are whatever the
21
+ * simulated contracts chose to emit — a scam token can emit a Transfer it
22
+ * never performed, and call itself "USDC". The result is a strong hint for
23
+ * a human, not a proof.
24
+ */
25
+ export declare const DEFAULT_SIM_TIMEOUT_MS = 15000;
26
+ export declare function outOfGasReason(gasUsed: bigint | null, gasLimit: bigint): string | null;
27
+ export interface SimTransfer {
28
+ standard: 'native' | 'erc20' | 'erc721' | 'erc1155';
29
+ /** Token contract (lowercase); null for native ETH. */
30
+ token: string | null;
31
+ from: string;
32
+ to: string;
33
+ /** Wei / token units / 1 for an ERC-721. */
34
+ amount: bigint;
35
+ tokenId?: bigint;
36
+ }
37
+ export interface WrapEvent {
38
+ token: string;
39
+ who: string;
40
+ kind: 'deposit' | 'withdrawal';
41
+ amount: bigint;
42
+ }
43
+ export interface SimApproval {
44
+ standard: 'erc20' | 'erc721' | 'operator';
45
+ token: string;
46
+ spender: string;
47
+ /** ERC-20 allowance. 0 = revoke. */
48
+ amount?: bigint;
49
+ /** ERC-721 single-token approval. */
50
+ tokenId?: bigint;
51
+ /** ApprovalForAll: true grants, false revokes. */
52
+ approved?: boolean;
53
+ }
54
+ export interface BalanceChanges {
55
+ /** Net native wei for the portal, excluding gas. */
56
+ native: bigint;
57
+ erc20: {
58
+ token: string;
59
+ delta: bigint;
60
+ }[];
61
+ nftIn: {
62
+ token: string;
63
+ tokenId: bigint;
64
+ }[];
65
+ nftOut: {
66
+ token: string;
67
+ tokenId: bigint;
68
+ }[];
69
+ erc1155: {
70
+ token: string;
71
+ tokenId: bigint;
72
+ delta: bigint;
73
+ }[];
74
+ }
75
+ export type Simulation = {
76
+ status: 'ok' | 'reverted';
77
+ method: 'eth_simulateV1' | 'eth_call';
78
+ gasUsed: bigint | null;
79
+ revertReason?: string;
80
+ /** null = unknown (eth_call fallback has no logs). */
81
+ transfers: SimTransfer[] | null;
82
+ /** Transfers beyond MAX_TRANSFERS that were not listed. */
83
+ transfersOmitted: number;
84
+ /**
85
+ * Every transfer, uncapped — for checks that need exact net changes
86
+ * of an address other than the portal (swap recipients). Internal:
87
+ * not rendered, and stripped from the preview tool's output.
88
+ */
89
+ allTransfers: SimTransfer[] | null;
90
+ changes: BalanceChanges | null;
91
+ approvals: SimApproval[] | null;
92
+ /**
93
+ * WETH9-style Deposit/Withdrawal events (all of them, never truncated):
94
+ * the evidence that a `deposit()`/`withdraw()` really wrapped/unwrapped.
95
+ */
96
+ wraps: WrapEvent[] | null;
97
+ /**
98
+ * False when the node only accepted the call without the signed fee
99
+ * fields (the contract saw tx.gasprice = 0): it simulated a different
100
+ * transaction, so require_simulation does not accept it.
101
+ */
102
+ faithful: boolean;
103
+ notes: string[];
104
+ /** symbol/decimals per lowercase token address, where readable. */
105
+ tokenMeta: Readonly<Record<string, TokenMeta>>;
106
+ } | {
107
+ status: 'unavailable';
108
+ reason: string;
109
+ };
110
+ export interface SimulateOpts {
111
+ /** Per-RPC-call timeout. Execution is bounded at 2× this; token metadata gets 1× on top. */
112
+ timeoutMs?: number;
113
+ /** Extra token addresses to fetch metadata for (e.g. the `to` of an approve). */
114
+ extraTokens?: readonly string[];
115
+ }
116
+ export declare function simulateTransaction(tx: SignableTx, from: string, upstream: JsonRpcUpstream, opts?: SimulateOpts): Promise<Simulation>;
117
+ export interface RawLog {
118
+ address: string;
119
+ topics: string[];
120
+ data: string;
121
+ }
122
+ /**
123
+ * Human text for revert data. Error(string) and Panic(uint256) are decoded;
124
+ * anything else is named by its selector. The reason string is chosen by
125
+ * the reverting contract — JSON-quoted and truncated so it can't break the
126
+ * layout of a push notification or impersonate sigil's own lines.
127
+ */
128
+ export declare function decodeRevert(hex: string): string;
129
+ /**
130
+ * Pure: classify logs into transfers and approvals, and net them for the
131
+ * portal. `value` and `to` let the caller's own native send be accounted
132
+ * for when the node didn't trace the top-level transfer (see below).
133
+ */
134
+ export declare function analyzeLogs(logs: readonly RawLog[], portal: string, tx: {
135
+ to: string | null;
136
+ value: bigint;
137
+ }): {
138
+ transfers: SimTransfer[];
139
+ approvals: SimApproval[];
140
+ wraps: WrapEvent[];
141
+ changes: BalanceChanges;
142
+ malformed: number;
143
+ };
144
+ /**
145
+ * symbol() + decimals() via eth_call. Tolerates bytes32 symbols (MKR-era
146
+ * tokens), reverts, EOAs and garbage: whatever fails is simply absent.
147
+ */
148
+ export declare function fetchTokenMeta(token: string, call: (method: string, params: unknown[]) => Promise<unknown>,
149
+ /** Called when a lookup failed for a reason other than the token's own
150
+ * answer (timeout, transport) — i.e. the metadata is unknown, not absent. */
151
+ onUnreachable?: () => void): Promise<TokenMeta>;
152
+ export declare function parseSymbol(ret: unknown): string | undefined;
153
+ export declare function parseDecimals(ret: unknown): number | undefined;
154
+ /** Race a promise against a timer; the timer never keeps the process alive. */
155
+ export declare function withTimeout<T>(p: Promise<T>, ms: number, message: string): Promise<T>;
156
+ //# sourceMappingURL=simulate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../../../src/preview/simulate.ts"],"names":[],"mappings":"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"}