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 @@
1
+ {"version":3,"file":"abi-dir.js","sourceRoot":"","sources":["../../../src/preview/abi-dir.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,26 @@
1
+ import type { AbiRegistry } from './abi-dir.js';
2
+ import { type DecodedCall, type TokenMetaLookup } from './types.js';
3
+ /**
4
+ * Turn calldata into a DecodedCall: built-in English description when the
5
+ * selector is one sigil knows, the user's ABI (argument names + values)
6
+ * when it isn't, or an explicit "unknown function" otherwise.
7
+ *
8
+ * Pure and offline — no RPC. Token metadata is supplied by the caller (the
9
+ * simulator fetches it); without it amounts render as raw integers.
10
+ *
11
+ * Decoding is presentation, so it fails open-but-loud: calldata that doesn't
12
+ * match its selector's signature yields a warning, never an exception that
13
+ * would block an otherwise-allowed sign. Only bugs (non-AbiDecodeError
14
+ * throws from the decoder) propagate.
15
+ */
16
+ export interface DecodeCtx {
17
+ /** Destination (any case). null = contract creation. Omitted = unknown. */
18
+ to?: string | null;
19
+ value?: bigint;
20
+ /** The portal's address, for "swap output goes elsewhere" warnings. */
21
+ from?: string;
22
+ /** Internal: nesting depth (multicall members decode at depth 1). */
23
+ depth?: number;
24
+ }
25
+ export declare function decodeCalldata(data: Uint8Array, registry: AbiRegistry, meta?: TokenMetaLookup, ctx?: DecodeCtx): DecodedCall;
26
+ //# sourceMappingURL=decode.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../../../src/preview/decode.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAmB,KAAK,WAAW,EAAW,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAG9F;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,SAAS;IACxB,2EAA2E;IAC3E,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,WAAW,EACrB,IAAI,GAAE,eAAyB,EAC/B,GAAG,GAAE,SAAc,GAClB,WAAW,CAkGb"}
@@ -0,0 +1,110 @@
1
+ import { AbiDecodeError, decodeAbiTypes } from '../eth/abi.js';
2
+ import { KNOWN_FUNCTIONS } from './known.js';
3
+ import { NO_META } from './types.js';
4
+ import { renderValue } from './units.js';
5
+ /** Cap on a generic (user-ABI) call line, so one huge argument can't flood the push. */
6
+ const MAX_TEXT = 400;
7
+ export function decodeCalldata(data, registry, meta = NO_META, ctx = {}) {
8
+ if (ctx.to === null) {
9
+ return {
10
+ selector: null,
11
+ text: `contract creation, ${data.length}-byte initcode`,
12
+ warnings: [],
13
+ source: 'deploy',
14
+ };
15
+ }
16
+ if (data.length === 0) {
17
+ return { selector: null, text: 'plain ETH transfer', warnings: [], source: 'empty' };
18
+ }
19
+ if (data.length < 4) {
20
+ return {
21
+ selector: null,
22
+ text: `malformed calldata (${data.length} bytes, too short for a selector)`,
23
+ warnings: [`calldata is ${data.length} bytes — too short to hold a function selector`],
24
+ source: 'unknown',
25
+ };
26
+ }
27
+ const selector = '0x' + Buffer.from(data.subarray(0, 4)).toString('hex');
28
+ const builtin = KNOWN_FUNCTIONS.get(selector);
29
+ const user = registry.lookup(selector);
30
+ const def = builtin ?? user;
31
+ if (!def) {
32
+ return {
33
+ selector,
34
+ text: `unknown function ${selector} (${data.length} bytes calldata)`,
35
+ warnings: [`unknown selector ${selector} — calldata not decoded`],
36
+ source: 'unknown',
37
+ };
38
+ }
39
+ const source = builtin ? 'builtin' : 'abi';
40
+ const base = { selector, signature: def.signature, name: def.name, source };
41
+ let values;
42
+ try {
43
+ values = decodeAbiTypes(def.inputs.map((i) => i.abiType), data.subarray(4));
44
+ }
45
+ catch (err) {
46
+ if (!(err instanceof AbiDecodeError))
47
+ throw err;
48
+ return {
49
+ ...base,
50
+ text: `${def.name}(…) — calldata does not match ${def.signature}`,
51
+ warnings: [`calldata does not decode as ${def.signature}: ${err.message}`],
52
+ };
53
+ }
54
+ // A user ABI naming the same selector supplies the argument names; the
55
+ // built-in still writes the sentence.
56
+ const names = builtin && user && user.inputs.length === builtin.inputs.length
57
+ ? user.inputs.map((i) => i.name)
58
+ : def.inputs.map((i) => i.name);
59
+ const args = def.inputs.map((inp, i) => ({
60
+ name: names[i],
61
+ type: inp.type,
62
+ value: renderValue(inp.type, values[i]),
63
+ }));
64
+ if (builtin) {
65
+ const depth = ctx.depth ?? 0;
66
+ const dctx = {
67
+ to: ctx.to?.toLowerCase() ?? null,
68
+ value: ctx.value ?? 0n,
69
+ meta,
70
+ ...(ctx.from !== undefined ? { from: ctx.from.toLowerCase() } : {}),
71
+ ...(depth === 0
72
+ ? {
73
+ decodeInner: (d) => decodeCalldata(d, registry, meta, { ...ctx, depth: 1 }),
74
+ }
75
+ : {}),
76
+ };
77
+ let desc;
78
+ try {
79
+ desc = builtin.describe(values, dctx);
80
+ }
81
+ catch (err) {
82
+ // A describe bug must not block signing; say so and fall back to the
83
+ // generic rendering.
84
+ desc = {
85
+ text: genericText(def.name, args, values, def.inputs),
86
+ warnings: [`could not describe ${def.signature}: ${err.message}`],
87
+ };
88
+ }
89
+ return {
90
+ ...base,
91
+ args,
92
+ text: desc.text,
93
+ ...(desc.short !== undefined ? { short: desc.short } : {}),
94
+ warnings: desc.warnings,
95
+ ...(desc.tokens && desc.tokens.length > 0 ? { tokens: dedupe(desc.tokens) } : {}),
96
+ ...(desc.swapOut ? { swapOut: desc.swapOut } : {}),
97
+ ...(desc.innerSwaps ? { innerSwaps: desc.innerSwaps } : {}),
98
+ };
99
+ }
100
+ return { ...base, args, text: genericText(def.name, args, values, def.inputs), warnings: [] };
101
+ }
102
+ function genericText(name, args, values, inputs) {
103
+ const parts = args.map((a, i) => `${a.name}=${renderValue(inputs[i].type, values[i], true)}`);
104
+ const text = `${name}(${parts.join(', ')})`;
105
+ return text.length > MAX_TEXT ? text.slice(0, MAX_TEXT - 1) + '…' : text;
106
+ }
107
+ function dedupe(xs) {
108
+ return [...new Set(xs.map((x) => x.toLowerCase()))];
109
+ }
110
+ //# sourceMappingURL=decode.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"decode.js","sourceRoot":"","sources":["../../../src/preview/decode.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,45 @@
1
+ import type { Simulation } from './simulate.js';
2
+ import type { DecodedCall, TokenMetaLookup } from './types.js';
3
+ /**
4
+ * Rendering for the transaction preview. Pure: given the same decode and
5
+ * simulation it produces byte-identical text, so tests can pin it and the
6
+ * audit log records exactly what the human and the agent were shown.
7
+ *
8
+ * Two shapes:
9
+ * - `renderText`: multi-line, for the agent and the audit log.
10
+ * - `renderHeadline`: one line, ` | `-separated, ≤ ~220 chars, for the
11
+ * phone push where the first glance has to carry the decision.
12
+ */
13
+ export type PreviewSimulation = Simulation | {
14
+ status: 'skipped';
15
+ reason: string;
16
+ };
17
+ export interface RenderInput {
18
+ decoded: DecodedCall;
19
+ simulation: PreviewSimulation;
20
+ warnings: readonly string[];
21
+ /** Lowercase portal address. */
22
+ from: string;
23
+ /** Lowercase destination, null for a deploy. */
24
+ to: string | null;
25
+ value: bigint;
26
+ chainId: bigint;
27
+ meta: TokenMetaLookup;
28
+ /** Extra trailing lines (e.g. `abi: skipped foo.json: invalid JSON`). */
29
+ footer?: readonly string[];
30
+ }
31
+ export declare const HEADLINE_MAX = 220;
32
+ export declare function renderText(r: RenderInput): string;
33
+ /**
34
+ * The phone headline. What leaves the portal is the decision, so the
35
+ * simulation part lists every debit — native and token outflows, NFTs out,
36
+ * approvals granted — BEFORE any credit, and debits are never cut to fit:
37
+ * a run of attacker-emitted "+1 USDC" credits must not push a real drain
38
+ * off the screen. Only the call description (clipped), the credits
39
+ * (`+N more in`) and the warnings (down to `⚠ N warnings`) give way to
40
+ * HEADLINE_MAX; a headline is longer than that only when the debits are.
41
+ */
42
+ export declare function renderHeadline(r: RenderInput): string;
43
+ /** One-line simulation status, also what the audit entry records. */
44
+ export declare function simulationSummary(sim: PreviewSimulation): string;
45
+ //# sourceMappingURL=format.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/preview/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA4B,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAW/D;;;;;;;;;GASG;AAEH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,eAAe,CAAC;IACtB,yEAAyE;IACzE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC,wBAAgB,UAAU,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAkCjD;AAOD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAqDrD;AAMD,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAehE"}
@@ -0,0 +1,222 @@
1
+ import { clean, formatEth, groupThousands, headAmount, isUnlimited, shortAddr, tokenLabel, } from './units.js';
2
+ export const HEADLINE_MAX = 220;
3
+ export function renderText(r) {
4
+ const lines = [];
5
+ lines.push(`call: ${callLine(r)}`);
6
+ lines.push(`value: ${formatEth(r.value)} chain: ${r.chainId}`);
7
+ lines.push(`simulation: ${simulationSummary(r.simulation)}`);
8
+ const sim = r.simulation;
9
+ if (sim.status === 'ok' || sim.status === 'reverted') {
10
+ for (const note of sim.notes)
11
+ lines.push(` note: ${note}`);
12
+ if (sim.status === 'ok') {
13
+ if (sim.approvals && sim.approvals.length > 0) {
14
+ lines.push(` approvals: ${sim.approvals.map((a) => approvalText(a, r.meta)).join('; ')}`);
15
+ }
16
+ if (sim.changes) {
17
+ const deltas = deltaTexts(sim, r.meta);
18
+ lines.push(` balance changes for ${shortAddr(r.from)}: ${deltas.length ? deltas.join(', ') : 'none'}`);
19
+ }
20
+ else {
21
+ lines.push(` balance changes: unknown (no event logs from this node)`);
22
+ }
23
+ if (sim.transfers && sim.transfers.length > 0) {
24
+ const more = sim.transfersOmitted > 0 ? `, ${sim.transfersOmitted} more not shown` : '';
25
+ lines.push(` transfers (${sim.transfers.length}${more}):`);
26
+ for (const t of sim.transfers)
27
+ lines.push(` ${transferText(t, r.meta)}`);
28
+ }
29
+ }
30
+ }
31
+ if (r.warnings.length > 0) {
32
+ lines.push('warnings:');
33
+ for (const w of r.warnings)
34
+ lines.push(` - ${w}`);
35
+ }
36
+ for (const f of r.footer ?? [])
37
+ lines.push(f);
38
+ // The one place lines are joined: nothing inside a line may start a new one.
39
+ return lines.map(clean).join('\n');
40
+ }
41
+ /** Debits beyond this many are summarized (loudly) rather than listed. */
42
+ const MAX_HEADLINE_DEBITS = 40;
43
+ /** The call description's share of the headline; the rest is for effects. */
44
+ const HEADLINE_CALL_MAX = 90;
45
+ /**
46
+ * The phone headline. What leaves the portal is the decision, so the
47
+ * simulation part lists every debit — native and token outflows, NFTs out,
48
+ * approvals granted — BEFORE any credit, and debits are never cut to fit:
49
+ * a run of attacker-emitted "+1 USDC" credits must not push a real drain
50
+ * off the screen. Only the call description (clipped), the credits
51
+ * (`+N more in`) and the warnings (down to `⚠ N warnings`) give way to
52
+ * HEADLINE_MAX; a headline is longer than that only when the debits are.
53
+ */
54
+ export function renderHeadline(r) {
55
+ const call = clip(headlineCall(r), HEADLINE_CALL_MAX);
56
+ const sim = r.simulation;
57
+ let simPart;
58
+ let credits = [];
59
+ switch (sim.status) {
60
+ case 'ok': {
61
+ const f = flows(sim, r.meta);
62
+ const debits = f.debits.length > MAX_HEADLINE_DEBITS
63
+ ? [
64
+ ...f.debits.slice(0, MAX_HEADLINE_DEBITS),
65
+ `!! ${f.debits.length - MAX_HEADLINE_DEBITS} MORE DEBITS — read the preview`,
66
+ ]
67
+ : f.debits;
68
+ simPart = ['sim ok', ...debits].join(' ');
69
+ credits = f.credits;
70
+ break;
71
+ }
72
+ case 'reverted':
73
+ simPart = `sim REVERTED: ${clip(sim.revertReason ?? 'unknown reason', 80)}`;
74
+ break;
75
+ case 'unavailable':
76
+ simPart = 'sim unavailable';
77
+ break;
78
+ case 'skipped':
79
+ simPart = 'no sim';
80
+ break;
81
+ }
82
+ let line = `${call} | ${simPart}`;
83
+ const n = r.warnings.length;
84
+ const minWarn = n > 0 ? ` | ⚠ ${n} warning${n === 1 ? '' : 's'}` : '';
85
+ // Credits: as many as fit while leaving room for at least the warning count.
86
+ for (let i = 0; i < credits.length; i++) {
87
+ const rest = credits.length - i - 1;
88
+ const tail = rest > 0 ? ` +${rest} more in` : '';
89
+ if (line.length + 1 + credits[i].length + tail.length + minWarn.length > HEADLINE_MAX) {
90
+ line += ` +${credits.length - i} more in`;
91
+ break;
92
+ }
93
+ line += ` ${credits[i]}`;
94
+ }
95
+ if (n > 0) {
96
+ const more = n > 1 ? ` (+${n - 1} more)` : '';
97
+ const full = ` | ⚠ ${r.warnings[0]}${more}`;
98
+ const room = HEADLINE_MAX - line.length;
99
+ if (full.length <= room)
100
+ line += full;
101
+ else if (room > minWarn.length + 12)
102
+ line += clip(` | ⚠ ${r.warnings[0]}`, room - more.length) + more;
103
+ else
104
+ line += minWarn;
105
+ }
106
+ return clean(line);
107
+ }
108
+ function clip(s, max) {
109
+ return s.length > max ? s.slice(0, max - 1) + '…' : s;
110
+ }
111
+ /** One-line simulation status, also what the audit entry records. */
112
+ export function simulationSummary(sim) {
113
+ switch (sim.status) {
114
+ case 'ok':
115
+ case 'reverted': {
116
+ const gas = sim.gasUsed !== null ? `, ${groupThousands(sim.gasUsed)} gas` : '';
117
+ const via = sim.method === 'eth_call' ? ' (eth_call)' : '';
118
+ return sim.status === 'ok'
119
+ ? `ok${gas}${via}`
120
+ : `REVERTED — ${sim.revertReason ?? 'unknown reason'}${via}`;
121
+ }
122
+ case 'unavailable':
123
+ return `unavailable — ${sim.reason}`;
124
+ case 'skipped':
125
+ return `skipped — ${sim.reason}`;
126
+ }
127
+ }
128
+ function callLine(r) {
129
+ const d = r.decoded;
130
+ if (d.source === 'deploy')
131
+ return d.text;
132
+ if (r.to === null)
133
+ return d.text;
134
+ if (d.source === 'empty')
135
+ return `plain ETH transfer to ${shortAddr(r.to)}`;
136
+ const sym = r.meta(r.to)?.symbol;
137
+ return `${d.text} on ${shortAddr(r.to)}${sym ? ` (${sym})` : ''}`;
138
+ }
139
+ function headlineCall(r) {
140
+ const d = r.decoded;
141
+ if (d.source === 'empty' && r.to !== null) {
142
+ return `send ${formatEth(r.value)} → ${shortAddr(r.to)}`;
143
+ }
144
+ let s = d.short ?? (r.to !== null && d.source !== 'deploy' ? `${d.text} → ${shortAddr(r.to)}` : d.text);
145
+ const eth = formatEth(r.value);
146
+ if (r.value > 0n && !s.includes(eth))
147
+ s += `, value ${eth}`;
148
+ return s;
149
+ }
150
+ function signed(delta, render) {
151
+ return `${delta < 0n ? '-' : '+'}${render(delta < 0n ? -delta : delta)}`;
152
+ }
153
+ /**
154
+ * Split the portal's balance changes into debits (incl. approvals it
155
+ * grants) and credits, debits first in a stable order.
156
+ */
157
+ function flows(sim, meta, withApprovals = true) {
158
+ const debits = [];
159
+ const credits = [];
160
+ const c = sim.changes;
161
+ if (c) {
162
+ if (c.native < 0n)
163
+ debits.push(signed(c.native, formatEth));
164
+ if (c.native > 0n)
165
+ credits.push(signed(c.native, formatEth));
166
+ for (const e of c.erc20) {
167
+ (e.delta < 0n ? debits : credits).push(signed(e.delta, (v) => headAmount(v, e.token, meta)));
168
+ }
169
+ for (const nft of c.nftOut)
170
+ debits.push(`-NFT ${shortAddr(nft.token)} #${nft.tokenId}`);
171
+ for (const nft of c.nftIn)
172
+ credits.push(`+NFT ${shortAddr(nft.token)} #${nft.tokenId}`);
173
+ for (const e of c.erc1155) {
174
+ (e.delta < 0n ? debits : credits).push(signed(e.delta, (v) => `${v} × id ${e.tokenId} of ${shortAddr(e.token)}`));
175
+ }
176
+ }
177
+ for (const a of withApprovals ? (sim.approvals ?? []) : []) {
178
+ const revoke = (a.standard === 'erc20' && (a.amount ?? 0n) === 0n) ||
179
+ (a.standard === 'operator' && !a.approved);
180
+ if (!revoke)
181
+ debits.push(`grants ${approvalText(a, meta)}`);
182
+ }
183
+ return { debits, credits };
184
+ }
185
+ /** Balance changes for the long-form text: debits first, then credits. */
186
+ function deltaTexts(sim, meta) {
187
+ const f = flows(sim, meta, false);
188
+ return [...f.debits, ...f.credits];
189
+ }
190
+ function approvalText(a, meta) {
191
+ switch (a.standard) {
192
+ case 'erc20': {
193
+ const amt = a.amount ?? 0n;
194
+ const label = tokenLabel(a.token, meta);
195
+ if (amt === 0n)
196
+ return `${label} → ${shortAddr(a.spender)} revoked`;
197
+ if (isUnlimited(amt))
198
+ return `${label} → ${shortAddr(a.spender)} UNLIMITED`;
199
+ return `${label} → ${shortAddr(a.spender)} ${headAmount(amt, a.token, meta)}`;
200
+ }
201
+ case 'erc721':
202
+ return `NFT ${shortAddr(a.token)} #${a.tokenId} → ${shortAddr(a.spender)}`;
203
+ case 'operator':
204
+ return a.approved
205
+ ? `ALL of ${shortAddr(a.token)} → ${shortAddr(a.spender)}`
206
+ : `ALL of ${shortAddr(a.token)} → ${shortAddr(a.spender)} revoked`;
207
+ }
208
+ }
209
+ function transferText(t, meta) {
210
+ const route = `${shortAddr(t.from)} → ${shortAddr(t.to)}`;
211
+ switch (t.standard) {
212
+ case 'native':
213
+ return `${formatEth(t.amount)} ${route}`;
214
+ case 'erc20':
215
+ return `${headAmount(t.amount, t.token, meta)} ${route}`;
216
+ case 'erc721':
217
+ return `NFT ${shortAddr(t.token)} #${t.tokenId} ${route}`;
218
+ case 'erc1155':
219
+ return `${t.amount} × id ${t.tokenId} of ${shortAddr(t.token)} ${route}`;
220
+ }
221
+ }
222
+ //# sourceMappingURL=format.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/preview/format.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,60 @@
1
+ import type { SignableTx } from '../eth/index.js';
2
+ import type { JsonRpcUpstream } from '../rpc/upstream.js';
3
+ import { AbiRegistry } from './abi-dir.js';
4
+ import { type PreviewSimulation } from './format.js';
5
+ import { type DecodedCall } from './types.js';
6
+ /**
7
+ * "Show me what I'm signing": decode an EVM transaction to English and, when
8
+ * an RPC node is configured for its chain, dry-run it. The result feeds
9
+ * three readers — the human (confirm push headline), the agent (returned
10
+ * text) and the audit log — and two opt-in policy gates (deny on revert,
11
+ * require simulation) that the sign path applies.
12
+ */
13
+ export interface TxPreview {
14
+ decoded: DecodedCall;
15
+ simulation: PreviewSimulation;
16
+ warnings: string[];
17
+ /** Multi-line, for the agent and the audit log. */
18
+ text: string;
19
+ /** One line, for the confirm push. */
20
+ headline: string;
21
+ }
22
+ export interface BuildTxPreviewInput {
23
+ tx: SignableTx;
24
+ /** The signing portal's address. */
25
+ from: string;
26
+ registry: AbiRegistry;
27
+ /** RPC node for this tx's chain; undefined = no simulation (skipped). */
28
+ simulator?: JsonRpcUpstream;
29
+ /** Why there is no simulator, when the caller knows better than the default. */
30
+ skippedReason?: string;
31
+ timeoutMs?: number;
32
+ }
33
+ export declare function buildTxPreview(input: BuildTxPreviewInput): Promise<TxPreview>;
34
+ /** The simulation ran without the signed fee fields (see simulate.ts). */
35
+ export declare const UNFAITHFUL_WARNING = "simulated without fee fields (node refused: insufficient funds) \u2014 the contract saw tx.gasprice = 0";
36
+ /**
37
+ * Stand-in when building the preview itself failed (a bug, not a node
38
+ * problem — those are already 'unavailable'). Presentation fails open but
39
+ * loud: the sign path proceeds with this warning unless the policy demands
40
+ * a simulation, in which case the 'unavailable' status denies (fail closed).
41
+ */
42
+ export declare function previewFailure(message: string): TxPreview;
43
+ /** The compact form written into the audit entry. */
44
+ export declare function auditPreview(p: TxPreview): {
45
+ text: string;
46
+ decoded: string;
47
+ simulation: string;
48
+ warnings: string[];
49
+ };
50
+ /** Deep-convert bigints to decimal strings so the value can be JSON-serialized. */
51
+ export declare function jsonSafe(v: unknown): unknown;
52
+ export { AbiRegistry, type AbiFunction, type AbiInput } from './abi-dir.js';
53
+ export { SimulatorResolver, type SimulatorResolverOpts } from './simulators.js';
54
+ export { decodeCalldata, type DecodeCtx } from './decode.js';
55
+ export { simulateTransaction, analyzeLogs, decodeRevert, fetchTokenMeta, parseSymbol, parseDecimals, DEFAULT_SIM_TIMEOUT_MS, type Simulation, type SimTransfer, type SimApproval, type BalanceChanges, type RawLog, type SimulateOpts, } from './simulate.js';
56
+ export { renderText, renderHeadline, simulationSummary, HEADLINE_MAX, type PreviewSimulation, } from './format.js';
57
+ export { KNOWN_FUNCTIONS, EVENT_TOPICS, decodeV3Path, type KnownFunction } from './known.js';
58
+ export type { DecodedCall, DecodedArg, TokenMeta, TokenMetaLookup } from './types.js';
59
+ export { formatUnits, shortAddr, sanitizeSymbol } from './units.js';
60
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/preview/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,KAAK,iBAAiB,EAAiD,MAAM,aAAa,CAAC;AAGpG,OAAO,EAAE,KAAK,WAAW,EAAiC,MAAM,YAAY,CAAC;AAI7E;;;;;;GAMG;AAEH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,UAAU,CAAC;IACf,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,CAAC;IACtB,yEAAyE;IACzE,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,CAqFnF;AAED,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,4GACuE,CAAC;AA8BvG;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAezD;AAED,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,GAAG;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAOA;AAED,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAS5C;AAED,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,MAAM,EACX,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC7F,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}