@aztec-labs/aztec 6.0.0-rc.3 → 6.0.0

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 (81) hide show
  1. package/dest/cli/admin_api_key_store.d.ts +2 -1
  2. package/dest/cli/admin_api_key_store.d.ts.map +1 -1
  3. package/dest/cli/admin_api_key_store.js +1 -0
  4. package/dest/cli/aztec_start_options.d.ts +2 -1
  5. package/dest/cli/aztec_start_options.d.ts.map +1 -1
  6. package/dest/cli/aztec_start_options.js +3 -2
  7. package/dest/cli/cli.d.ts +1 -1
  8. package/dest/cli/cli.d.ts.map +1 -1
  9. package/dest/cli/cli.js +2 -1
  10. package/dest/cli/cmds/compile.d.ts +1 -1
  11. package/dest/cli/cmds/compile.d.ts.map +1 -1
  12. package/dest/cli/cmds/compile.js +4 -3
  13. package/dest/cli/cmds/migrate_ha_db.d.ts +1 -1
  14. package/dest/cli/cmds/migrate_ha_db.d.ts.map +1 -1
  15. package/dest/cli/cmds/migrate_ha_db.js +3 -2
  16. package/dest/cli/cmds/profile_flamegraph.d.ts +1 -1
  17. package/dest/cli/cmds/profile_flamegraph.d.ts.map +1 -1
  18. package/dest/cli/cmds/profile_flamegraph.js +3 -2
  19. package/dest/cli/cmds/profile_gates.d.ts +1 -1
  20. package/dest/cli/cmds/profile_gates.d.ts.map +1 -1
  21. package/dest/cli/cmds/profile_gates.js +2 -1
  22. package/dest/cli/cmds/prover.d.ts +1 -1
  23. package/dest/cli/cmds/prover.d.ts.map +1 -1
  24. package/dest/cli/cmds/prover.js +3 -2
  25. package/dest/cli/cmds/start_node.d.ts +1 -1
  26. package/dest/cli/cmds/start_node.d.ts.map +1 -1
  27. package/dest/cli/cmds/start_node.js +1 -0
  28. package/dest/cli/cmds/utils/collect_crate_dirs.d.ts +1 -1
  29. package/dest/cli/cmds/utils/collect_crate_dirs.d.ts.map +1 -1
  30. package/dest/cli/cmds/utils/collect_crate_dirs.js +2 -1
  31. package/dest/cli/util.d.ts +2 -2
  32. package/dest/cli/util.d.ts.map +1 -1
  33. package/dest/cli/util.js +2 -26
  34. package/dest/deploy/bridging.d.ts +84 -0
  35. package/dest/deploy/bridging.d.ts.map +1 -0
  36. package/dest/deploy/bridging.js +121 -0
  37. package/dest/deploy/fees.d.ts +127 -0
  38. package/dest/deploy/fees.d.ts.map +1 -0
  39. package/dest/deploy/fees.js +309 -0
  40. package/dest/deploy/graph.d.ts +40 -0
  41. package/dest/deploy/graph.d.ts.map +1 -0
  42. package/dest/deploy/graph.js +120 -0
  43. package/dest/deploy/index.d.ts +19 -0
  44. package/dest/deploy/index.d.ts.map +1 -0
  45. package/dest/deploy/index.js +15 -0
  46. package/dest/deploy/reporter.d.ts +108 -0
  47. package/dest/deploy/reporter.d.ts.map +1 -0
  48. package/dest/deploy/reporter.js +78 -0
  49. package/dest/deploy/runner.d.ts +8 -0
  50. package/dest/deploy/runner.d.ts.map +1 -0
  51. package/dest/deploy/runner.js +993 -0
  52. package/dest/deploy/state.d.ts +19 -0
  53. package/dest/deploy/state.d.ts.map +1 -0
  54. package/dest/deploy/state.js +59 -0
  55. package/dest/deploy/types.d.ts +268 -0
  56. package/dest/deploy/types.d.ts.map +1 -0
  57. package/dest/deploy/types.js +9 -0
  58. package/dest/local-network/local-network.d.ts +1 -1
  59. package/dest/local-network/local-network.d.ts.map +1 -1
  60. package/dest/local-network/local-network.js +1 -0
  61. package/package.json +35 -32
  62. package/src/cli/admin_api_key_store.ts +1 -0
  63. package/src/cli/aztec_start_options.ts +7 -4
  64. package/src/cli/cli.ts +2 -1
  65. package/src/cli/cmds/compile.ts +4 -3
  66. package/src/cli/cmds/migrate_ha_db.ts +3 -2
  67. package/src/cli/cmds/profile_flamegraph.ts +3 -2
  68. package/src/cli/cmds/profile_gates.ts +2 -1
  69. package/src/cli/cmds/prover.ts +3 -2
  70. package/src/cli/cmds/start_node.ts +1 -0
  71. package/src/cli/cmds/utils/collect_crate_dirs.ts +2 -1
  72. package/src/cli/util.ts +3 -30
  73. package/src/deploy/bridging.ts +190 -0
  74. package/src/deploy/fees.ts +361 -0
  75. package/src/deploy/graph.ts +137 -0
  76. package/src/deploy/index.ts +41 -0
  77. package/src/deploy/reporter.ts +187 -0
  78. package/src/deploy/runner.ts +1057 -0
  79. package/src/deploy/state.ts +66 -0
  80. package/src/deploy/types.ts +290 -0
  81. package/src/local-network/local-network.ts +1 -0
@@ -0,0 +1,19 @@
1
+ export interface DeployState {
2
+ /** alias → resolved address (informational). */
3
+ addresses: Record<string, string>;
4
+ /** deployer address → a bridge claim that's been funded on L1 but not yet consumed. */
5
+ pendingClaims: Record<string, {
6
+ claimAmount: string;
7
+ claimSecret: string;
8
+ messageLeafIndex: string;
9
+ }>;
10
+ }
11
+ /**
12
+ * Loads the persisted state, or an empty one when no file exists yet. A file that exists but can't
13
+ * be read or doesn't match the schema throws instead of being treated as empty: silently starting
14
+ * fresh would discard `pendingClaims`, and a lost claim secret strands the bridged funds forever.
15
+ */
16
+ export declare function loadState(dir: string): DeployState;
17
+ /** Persists atomically (write + rename), so a crash mid-write can't truncate the previous state. */
18
+ export declare function saveState(dir: string, state: DeployState): void;
19
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RhdGUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9kZXBsb3kvc3RhdGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBc0JBLE1BQU0sV0FBVyxXQUFXO0lBQzFCLGtEQUFnRDtJQUNoRCxTQUFTLEVBQUUsTUFBTSxDQUFDLE1BQU0sRUFBRSxNQUFNLENBQUMsQ0FBQztJQUNsQyx5RkFBdUY7SUFDdkYsYUFBYSxFQUFFLE1BQU0sQ0FBQyxNQUFNLEVBQUU7UUFBRSxXQUFXLEVBQUUsTUFBTSxDQUFDO1FBQUMsV0FBVyxFQUFFLE1BQU0sQ0FBQztRQUFDLGdCQUFnQixFQUFFLE1BQU0sQ0FBQTtLQUFFLENBQUMsQ0FBQztDQUN2RztBQU1EOzs7O0dBSUc7QUFDSCx3QkFBZ0IsU0FBUyxDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsV0FBVyxDQW1CbEQ7QUFFRCxvR0FBb0c7QUFDcEcsd0JBQWdCLFNBQVMsQ0FBQyxHQUFHLEVBQUUsTUFBTSxFQUFFLEtBQUssRUFBRSxXQUFXLEdBQUcsSUFBSSxDQUsvRCJ9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/deploy/state.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,WAAW;IAC1B,kDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,yFAAuF;IACvF,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvG;AAMD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAmBlD;AAED,oGAAoG;AACpG,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAK/D"}
@@ -0,0 +1,59 @@
1
+ /**
2
+ * Resume state for {@link runDeployment}, persisted to `<stateDir>/state.json`.
3
+ *
4
+ * On-chain inventory makes contract deploys and actions idempotent on their own, but a
5
+ * bridge claim lives off-chain between "bridged on L1" and "claimed on L2". We persist
6
+ * pending claims here so a run that dies in that window resumes the claim instead of
7
+ * bridging again. Resolved addresses are stored too, as a human-readable record.
8
+ *
9
+ * The state file is keyed only by `stateDir`; point separate targets (local vs. a remote
10
+ * network) at separate `stateDir`s to keep their state apart.
11
+ */ import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
12
+ import { join } from 'node:path';
13
+ import { z } from 'zod';
14
+ const deployStateSchema = z.object({
15
+ addresses: z.record(z.string(), z.string()).default({}),
16
+ pendingClaims: z.record(z.string(), z.object({
17
+ claimAmount: z.string(),
18
+ claimSecret: z.string(),
19
+ messageLeafIndex: z.string()
20
+ })).default({})
21
+ });
22
+ function statePath(dir) {
23
+ return join(dir, 'state.json');
24
+ }
25
+ /**
26
+ * Loads the persisted state, or an empty one when no file exists yet. A file that exists but can't
27
+ * be read or doesn't match the schema throws instead of being treated as empty: silently starting
28
+ * fresh would discard `pendingClaims`, and a lost claim secret strands the bridged funds forever.
29
+ */ export function loadState(dir) {
30
+ let raw;
31
+ try {
32
+ raw = readFileSync(statePath(dir), 'utf8');
33
+ } catch (error) {
34
+ if (error.code === 'ENOENT') {
35
+ return {
36
+ addresses: {},
37
+ pendingClaims: {}
38
+ };
39
+ }
40
+ throw new Error(`Failed to read deploy state at ${statePath(dir)}.`, {
41
+ cause: error
42
+ });
43
+ }
44
+ try {
45
+ return deployStateSchema.parse(JSON.parse(raw));
46
+ } catch (error) {
47
+ throw new Error(`Corrupt deploy state at ${statePath(dir)}. Fix or remove it manually — removing abandons any pending ` + `bridge claims recorded in it (their funds become unclaimable).`, {
48
+ cause: error
49
+ });
50
+ }
51
+ }
52
+ /** Persists atomically (write + rename), so a crash mid-write can't truncate the previous state. */ export function saveState(dir, state) {
53
+ mkdirSync(dir, {
54
+ recursive: true
55
+ });
56
+ const path = statePath(dir);
57
+ writeFileSync(`${path}.tmp`, JSON.stringify(state, null, 2));
58
+ renameSync(`${path}.tmp`, path);
59
+ }
@@ -0,0 +1,268 @@
1
+ /**
2
+ * Declarative deployment spec — the "what", not the "how".
3
+ *
4
+ * A {@link DeploymentSpec} is one graph of {@link StepSpec | steps} — each either a `contract`
5
+ * (published on-chain, or registered privately in the PXE) or an `action` (a tx) — sent from named
6
+ * {@link AccountSpec | accounts}. {@link runDeployment} resolves deterministic addresses upfront,
7
+ * inventories what's on-chain, funds the accounts, and executes only what's missing in dependency
8
+ * order — idempotently and resumably.
9
+ */
10
+ import type { ContractArtifact } from '@aztec-labs/aztec.js/abi';
11
+ import type { AztecAddress } from '@aztec-labs/aztec.js/addresses';
12
+ import type { ContractBase, ContractFunctionInteraction, ContractInstanceWithAddress } from '@aztec-labs/aztec.js/contracts';
13
+ import type { FeePaymentMethod } from '@aztec-labs/aztec.js/fee';
14
+ import type { Fr } from '@aztec-labs/aztec.js/fields';
15
+ import type { AztecNode } from '@aztec-labs/aztec.js/node';
16
+ import type { Wallet } from '@aztec-labs/aztec.js/wallet';
17
+ import type { DeployReporter } from './reporter.js';
18
+ /**
19
+ * How txs are paid.
20
+ * - `sponsored`: a SponsoredFPC pays (the local-network default).
21
+ * - `fee-juice`: the account pays from its own Fee Juice; if below `threshold` with work to do,
22
+ * bridge `fundAmount` from L1 and claim it on the first paying tx. `l1FunderKey`/`l1RpcUrl`/
23
+ * `l1ChainId` are caller-supplied; omit `l1FunderKey` for the faucet + ephemeral key. On a
24
+ * non-local network `l1RpcUrl` and `l1ChainId` are required (there are no hardcoded defaults);
25
+ * on local they default to anvil (`127.0.0.1:8545`, chain `31337`).
26
+ * - `payment-method`: a caller-supplied {@link FeePaymentMethod} (e.g. a deployed FPC) pays every tx
27
+ * with its own gas settings; nothing is read or bridged. `instance` + `artifact` register the paying
28
+ * contract in the run's PXE.
29
+ */
30
+ export type FeePolicy = {
31
+ kind: 'sponsored';
32
+ } | {
33
+ kind: 'fee-juice';
34
+ threshold: bigint;
35
+ fundAmount: bigint;
36
+ l1FunderKey?: `0x${string}`;
37
+ l1RpcUrl?: string;
38
+ l1ChainId?: number;
39
+ } | {
40
+ kind: 'payment-method';
41
+ paymentMethod: FeePaymentMethod;
42
+ instance: ContractInstanceWithAddress;
43
+ artifact: ContractArtifact;
44
+ };
45
+ /** An account the deployment sends from: a v0 initializerless Schnorr account (no deploy tx). */
46
+ export interface AccountSpec {
47
+ /**
48
+ * The account's privacy master secret — the seed its nullifier, viewing and tagging keys derive
49
+ * from. The signing key is derived from it too, separately (domain-separated as the master
50
+ * message-signing key), so this one value pins the account.
51
+ */
52
+ secret: Fr;
53
+ /** Fee policy for this account's txs, overriding {@link DeploymentSpec.fees}. */
54
+ fees?: FeePolicy;
55
+ /** Salt for this account's derivation, overriding {@link DeploymentSpec.salt}. */
56
+ salt?: Fr;
57
+ }
58
+ /** Resolve addresses of accounts / contracts (for initializer args, action targets, the deployer). */
59
+ export interface Resolver {
60
+ /** The resolved address of the account declared under `alias`. Throws on an unknown alias. */
61
+ account(alias: string): AztecAddress;
62
+ /** The resolved address of the contract step declared under `alias`. Throws on an unknown alias. */
63
+ contract(alias: string): AztecAddress;
64
+ }
65
+ /**
66
+ * The static side of a codegen'd contract class (e.g. `TokenContract`): the single source of both
67
+ * the artifact and a typed `.at`. Carries the instance type `T`, surfaced by {@link Ctx.instance}.
68
+ */
69
+ export interface GeneratedContractClass<T extends ContractBase = ContractBase> {
70
+ artifact: ContractArtifact;
71
+ at(address: AztecAddress, wallet: Wallet): T;
72
+ }
73
+ /**
74
+ * Who sends a contract step's deploy, and whether the address commits to them:
75
+ * - `deployer` — a bound deploy: the account salts + sends, and the address commits to it.
76
+ * - `universal: true` + `from` — a universal deploy: the address is the same whoever sends it, so
77
+ * it can be shared before anyone commits to deploying it; `from` sends and pays.
78
+ */
79
+ type ContractSender = {
80
+ /** Account that salts + sends the deploy, e.g. `(r) => r.account("admin")`. */
81
+ deployer: (resolve: Resolver) => AztecAddress;
82
+ universal?: never;
83
+ from?: never;
84
+ } | {
85
+ /** Publish without binding the sender into the address. */
86
+ universal: true;
87
+ /** Account that sends (and pays for) the deploy, e.g. `(r) => r.account("admin")`. */
88
+ from: (resolve: Resolver) => AztecAddress;
89
+ deployer?: never;
90
+ };
91
+ /** What a contract step declares however its sender and initializer args are given. */
92
+ interface ContractStepBase<T extends ContractBase = ContractBase> {
93
+ kind: 'contract';
94
+ /** The generated contract class — provides the artifact and the typed `.at`. */
95
+ contract: GeneratedContractClass<T>;
96
+ /** Per-contract salt, overriding {@link DeploymentSpec.salt}. */
97
+ salt?: Fr;
98
+ /**
99
+ * For contracts that own private notes (e.g. an FPC): the contract's privacy master secret. The
100
+ * framework derives its `PublicKeys` from it. Omit for ordinary contracts (default keys).
101
+ */
102
+ secret?: Fr;
103
+ /** Name of a non-default `#[initializer]` to call. Defaults to the contract's constructor. */
104
+ initializer?: string;
105
+ }
106
+ /**
107
+ * How a contract step's initializer args are produced — the two ways are exclusive, so a step can
108
+ * only pick one.
109
+ */
110
+ type ContractInitializerArgs<C> = {
111
+ mode: 'publish' | 'register';
112
+ /**
113
+ * Deterministic initializer args — a pure function of resolved addresses + static config. Its
114
+ * contract→contract dependencies are auto-derived and the address is resolved UPFRONT.
115
+ */
116
+ initializerArgs?: (resolve: Resolver) => unknown[];
117
+ deferredInitializerArgs?: never;
118
+ /** Steps that must complete first, on top of those auto-derived from {@link initializerArgs}. */
119
+ dependsOn?: string[];
120
+ } | {
121
+ /** Deferred args resolve once the run is underway, so there has to be a tx to defer. */
122
+ mode: 'publish';
123
+ /**
124
+ * Runtime initializer args — may read live state (e.g. `ctx.instance(x).methods.f().simulate()`).
125
+ * Resolved at inventory time when the state it reads already exists (the re-run case, which is
126
+ * what makes re-runs no-ops), and otherwise AT EXECUTION TIME, once {@link dependsOn} has run.
127
+ */
128
+ deferredInitializerArgs: (ctx: Ctx<C>) => unknown[] | Promise<unknown[]>;
129
+ initializerArgs?: never;
130
+ /**
131
+ * The steps whose effects the args read — an explicit empty array if they only read
132
+ * pre-existing state. The args resolve only once these are in place, and a contract they read
133
+ * without declaring it here is rejected.
134
+ */
135
+ dependsOn: string[];
136
+ };
137
+ /**
138
+ * A step that puts a contract on-chain (or in the PXE):
139
+ * - `publish` → register the class + deploy the instance + run its initializer (a tx).
140
+ * - `register` → private; only derive the deterministic address and register it in the PXE (no tx).
141
+ *
142
+ * The address is deterministic in (class id, deployer, salt, initializer + its args) — with the
143
+ * deployer omitted for {@link ContractSender | universal} steps. Args come from
144
+ * {@link ContractInitializerArgs | either} `initializerArgs` (deterministic — addresses/static,
145
+ * resolved UPFRONT) or `deferredInitializerArgs` (may read runtime state — resolved AT EXECUTION
146
+ * TIME).
147
+ */
148
+ export type ContractStep<C = Steps, T extends ContractBase = ContractBase> = ContractStepBase<T> & ContractSender & ContractInitializerArgs<C>;
149
+ /** A step that sends a tx once its dependencies exist. */
150
+ export interface ActionStep<C = Steps> {
151
+ kind: 'action';
152
+ /** Account that sends (and pays for) this tx, e.g. `(r) => r.account("admin")`. */
153
+ from: (resolve: Resolver) => AztecAddress;
154
+ /**
155
+ * Builds the interaction to send. May be async (e.g. to read state first). The EmbeddedWallet
156
+ * creates required authwits at send time, so the interaction usually needs no `.with(...)`.
157
+ */
158
+ call: (ctx: Ctx<C>) => ContractFunctionInteraction | Promise<ContractFunctionInteraction>;
159
+ /**
160
+ * Idempotency gate: if it resolves true, the action is skipped this run. Not consulted until the
161
+ * contracts in {@link dependsOn} are in place. Anything it throws aborts the run.
162
+ */
163
+ done: (ctx: Ctx<C>) => Promise<boolean>;
164
+ /**
165
+ * Steps that must complete first: every contract this action calls or its {@link done} gate
166
+ * reads, plus the actions it follows. A contract {@link call} or {@link done} reads without
167
+ * declaring it here is rejected.
168
+ */
169
+ dependsOn?: string[];
170
+ }
171
+ /**
172
+ * A step that provisions an address — any address, not just a sending account — with bridged Fee
173
+ * Juice: bridge `amount` from L1, then send a `FeeJuice.claim` tx from {@link from} crediting
174
+ * {@link recipient}. Used to fund contracts that pay for others (e.g. an FPC). Idempotent on the
175
+ * recipient's public balance, and resumable: the bridge claim persists (see ./state.ts) as soon as
176
+ * it exists on L1, so a crash between bridge and claim resumes instead of stranding the funds.
177
+ */
178
+ export interface FundStep {
179
+ kind: 'fund';
180
+ /** Recipient of the bridged Fee Juice, e.g. `(r) => r.contract("fpc")`. */
181
+ recipient: (resolve: Resolver) => AztecAddress;
182
+ /** Bridge + claim only when the recipient's public Fee Juice balance is below this (wei). */
183
+ threshold: bigint;
184
+ /**
185
+ * Amount to bridge (wei). On a network with a fee-asset faucet whose mint amount exceeds the L1
186
+ * funder's balance, the faucet's own mint amount is what arrives.
187
+ */
188
+ amount: bigint;
189
+ /** Account that sends (and pays for) the L2 claim tx, e.g. `(r) => r.account("admin")`. */
190
+ from: (resolve: Resolver) => AztecAddress;
191
+ /** L1 funder key signing the bridge tx; omit for the faucet + an ephemeral key (or anvil's dev key on local). */
192
+ l1FunderKey?: `0x${string}`;
193
+ /** L1 connection for the bridge; required on non-local networks, defaults to anvil on local. */
194
+ l1RpcUrl?: string;
195
+ l1ChainId?: number;
196
+ /** Steps that must complete first (e.g. the contract being funded). */
197
+ dependsOn?: string[];
198
+ }
199
+ export type StepSpec<C = Steps> = ContractStep<C> | ActionStep<C> | FundStep;
200
+ /**
201
+ * A steps map: alias → step. The element generic is `any` so the alias isn't self-referential
202
+ * (`Steps → StepSpec<Steps> → …`); a concrete spec's `C` is inferred at the {@link runDeployment}
203
+ * call site, which is what types `ctx.instance`.
204
+ */
205
+ export type Steps = Record<string, StepSpec<any>>;
206
+ /** The concrete contract type a contract step produces (else the base type). */
207
+ export type InstanceOf<S> = S extends {
208
+ contract: GeneratedContractClass<infer T>;
209
+ } ? T : ContractBase;
210
+ /** The aliases of the contract steps in C — so `ctx.instance` only accepts those. */
211
+ export type ContractAlias<C> = {
212
+ [K in keyof C]: C[K] extends {
213
+ kind: 'contract';
214
+ } ? K : never;
215
+ }[keyof C] & string;
216
+ /** Everything a step needs at build/idempotency time: typed resolution + bound instances + handles. */
217
+ export interface Ctx<C = Steps> extends Resolver {
218
+ /** The contract bound to the wallet, typed from the step's class. */
219
+ instance<K extends ContractAlias<C>>(alias: K): InstanceOf<C[K]>;
220
+ /**
221
+ * Whether step `id` is already satisfied this run — it will NOT do work. Mode-aware: an action
222
+ * whose `done` gate passed, a published contract that's on-chain, or a registered (private)
223
+ * contract that's in the wallet. Can be true without {@link ran} (e.g. a published contract a
224
+ * prior run left on-chain). Lets a step defer to another's gate: `done: (ctx) => ctx.done("amm")`.
225
+ */
226
+ done(id: string): Promise<boolean>;
227
+ /**
228
+ * Whether step `id` did work *this run*: an action that sent its tx, a contract published this
229
+ * run (absent before), or a contract (re)registered this run. Use for "do B because A happened
230
+ * this run", e.g. a mint gated on a fresh token: `done: (ctx) => !ctx.ran("goCoin")`.
231
+ */
232
+ ran(id: string): Promise<boolean>;
233
+ wallet: Wallet;
234
+ node: AztecNode;
235
+ }
236
+ /** The full declarative input to {@link runDeployment}: target, accounts, steps, fees, and hooks. */
237
+ export interface DeploymentSpec<C extends Steps = Steps> {
238
+ /**
239
+ * The node to deploy against: a JSON-RPC URL, or an already-connected node (e.g. an in-process
240
+ * `AztecNodeService` from a test fixture, or a client built with custom headers). Local
241
+ * time-warping while a bridge settles reaches the debug API through whichever is given — a URL
242
+ * builds a debug client, an in-process node serves it directly.
243
+ */
244
+ node: string | AztecNode;
245
+ /**
246
+ * Whether the target is a local (anvil) network. Local uses the deterministic sandbox defaults:
247
+ * sponsored fees, no real proofs, warp-based L1→L2 message advancement, and anvil's dev funder.
248
+ * Everything else (default) uses fee-juice, real proofs, and polling; L1 details for bridging must
249
+ * be supplied on the fee-juice {@link FeePolicy}.
250
+ */
251
+ local?: boolean;
252
+ /** Human label for logs + reporter; defaults to `local`/`network` based on {@link local}. */
253
+ label?: string;
254
+ /** Default salt for account + contract derivation; each can override. Defaults to Fr(0). */
255
+ salt?: Fr;
256
+ /** Directory for the resume-state file. Defaults to `<cwd>/.deploy-state`. */
257
+ stateDir?: string;
258
+ accounts: Record<string, AccountSpec>;
259
+ steps: C;
260
+ /** Default fee policy; per-account {@link AccountSpec.fees} overrides it. Defaults per {@link local}. */
261
+ fees?: FeePolicy;
262
+ /** Where lifecycle events go. Defaults to {@link consoleReporter} (stderr). `{}` silences them. */
263
+ reporter?: DeployReporter;
264
+ /** Hook to write app artifacts (e.g. a frontend manifest) from resolved state; runs after execution. */
265
+ output?: (ctx: Ctx<C>) => void | Promise<void>;
266
+ }
267
+ export {};
268
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9kZXBsb3kvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7O0dBUUc7QUFDSCxPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQ2pFLE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQ25FLE9BQU8sS0FBSyxFQUNWLFlBQVksRUFDWiwyQkFBMkIsRUFDM0IsMkJBQTJCLEVBQzVCLE1BQU0sZ0NBQWdDLENBQUM7QUFDeEMsT0FBTyxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUNqRSxPQUFPLEtBQUssRUFBRSxFQUFFLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUN0RCxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUMzRCxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUUxRCxPQUFPLEtBQUssRUFBRSxjQUFjLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFFcEQ7Ozs7Ozs7Ozs7O0dBV0c7QUFDSCxNQUFNLE1BQU0sU0FBUyxHQUNqQjtJQUFFLElBQUksRUFBRSxXQUFXLENBQUE7Q0FBRSxHQUNyQjtJQUNFLElBQUksRUFBRSxXQUFXLENBQUM7SUFDbEIsU0FBUyxFQUFFLE1BQU0sQ0FBQztJQUNsQixVQUFVLEVBQUUsTUFBTSxDQUFDO0lBQ25CLFdBQVcsQ0FBQyxFQUFFLEtBQUssTUFBTSxFQUFFLENBQUM7SUFDNUIsUUFBUSxDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ2xCLFNBQVMsQ0FBQyxFQUFFLE1BQU0sQ0FBQztDQUNwQixHQUNEO0lBQ0UsSUFBSSxFQUFFLGdCQUFnQixDQUFDO0lBQ3ZCLGFBQWEsRUFBRSxnQkFBZ0IsQ0FBQztJQUNoQyxRQUFRLEVBQUUsMkJBQTJCLENBQUM7SUFD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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/deploy/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EACV,YAAY,EACZ,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,aAAa,EAAE,gBAAgB,CAAC;IAChC,QAAQ,EAAE,2BAA2B,CAAC;IACtC,QAAQ,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAEN,iGAAiG;AACjG,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,MAAM,EAAE,EAAE,CAAC;IACX,iFAAiF;IACjF,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,kFAAkF;IAClF,IAAI,CAAC,EAAE,EAAE,CAAC;CACX;AAED,sGAAsG;AACtG,MAAM,WAAW,QAAQ;IACvB,8FAA8F;IAC9F,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;IACrC,oGAAoG;IACpG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IAC3E,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC;CAC9C;AAED;;;;;GAKG;AACH,KAAK,cAAc,GACf;IACE,+EAA+E;IAC/E,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,YAAY,CAAC;IAC9C,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,IAAI,CAAC,EAAE,KAAK,CAAC;CACd,GACD;IACE,2DAA2D;IAC3D,SAAS,EAAE,IAAI,CAAC;IAChB,sFAAsF;IACtF,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,YAAY,CAAC;IAC1C,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB,CAAC;AAEN,uFAAuF;AACvF,UAAU,gBAAgB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IAC9D,IAAI,EAAE,UAAU,CAAC;IACjB,kFAAgF;IAChF,QAAQ,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACpC,iEAAiE;IACjE,IAAI,CAAC,EAAE,EAAE,CAAC;IACV;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,CAAC;IACZ,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,KAAK,uBAAuB,CAAC,CAAC,IAC1B;IACE,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC;IAC7B;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,EAAE,CAAC;IACnD,uBAAuB,CAAC,EAAE,KAAK,CAAC;IAChC,iGAAiG;IACjG,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,GACD;IACE,wFAAwF;IACxF,IAAI,EAAE,SAAS,CAAC;IAChB;;;;OAIG;IACH,uBAAuB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,eAAe,CAAC,EAAE,KAAK,CAAC;IACxB;;;;OAIG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEN;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,SAAS,YAAY,GAAG,YAAY,IAAI,gBAAgB,CAAC,CAAC,CAAC,GAC9F,cAAc,GACd,uBAAuB,CAAC,CAAC,CAAC,CAAC;AAE7B,0DAA0D;AAC1D,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,KAAK;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,mFAAmF;IACnF,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,YAAY,CAAC;IAC1C;;;OAGG;IACH,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,2BAA2B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC1F;;;OAGG;IACH,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,SAAS,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,YAAY,CAAC;IAC/C,6FAA6F;IAC7F,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,2FAA2F;IAC3F,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,YAAY,CAAC;IAC1C,iHAAiH;IACjH,WAAW,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,gGAAgG;IAChG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,KAAK,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;AAC7E;;;;GAIG;AAEH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AAElD,gFAAgF;AAChF,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,QAAQ,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,YAAY,CAAC;AACvG,uFAAqF;AACrF,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;KAC5B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,GAAG,CAAC,GAAG,KAAK;CAC9D,CAAC,MAAM,CAAC,CAAC,GACR,MAAM,CAAC;AAET,uGAAuG;AACvG,MAAM,WAAW,GAAG,CAAC,CAAC,GAAG,KAAK,CAAE,SAAQ,QAAQ;IAC9C,qEAAqE;IACrE,QAAQ,CAAC,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE;;;;;OAKG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC;;;;OAIG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,qGAAqG;AACrG,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK;IACrD;;;;;OAKG;IACH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,IAAI,CAAC,EAAE,EAAE,CAAC;IACV,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC;IACT,yGAAyG;IACzG,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,mGAAmG;IACnG,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,wGAAwG;IACxG,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Declarative deployment spec — the "what", not the "how".
3
+ *
4
+ * A {@link DeploymentSpec} is one graph of {@link StepSpec | steps} — each either a `contract`
5
+ * (published on-chain, or registered privately in the PXE) or an `action` (a tx) — sent from named
6
+ * {@link AccountSpec | accounts}. {@link runDeployment} resolves deterministic addresses upfront,
7
+ * inventories what's on-chain, funds the accounts, and executes only what's missing in dependency
8
+ * order — idempotently and resumably.
9
+ */ /** The full declarative input to {@link runDeployment}: target, accounts, steps, fees, and hooks. */ export { };
@@ -48,4 +48,4 @@ export declare function createAztecNode(config?: Partial<AztecNodeConfig>, deps?
48
48
  }, options?: {
49
49
  genesis?: GenesisData;
50
50
  }): Promise<import("@aztec-labs/aztec-node").AztecNodeService>;
51
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9jYWwtbmV0d29yay5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2xvY2FsLW5ldHdvcmsvbG9jYWwtbmV0d29yay50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBR0EsT0FBTyxFQUFFLEtBQUssZUFBZSxFQUFvQixNQUFNLCtCQUErQixDQUFDO0FBQ3ZGLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUVqRCxPQUFPLEVBQUUsS0FBSyxtQkFBbUIsRUFBb0IsTUFBTSxnQ0FBZ0MsQ0FBQztBQU01RixPQUFPLEtBQUssRUFBRSxtQkFBbUIsRUFBRSxNQUFNLDRDQUE0QyxDQUFDO0FBR3RGLE9BQU8sS0FBSyxFQUFFLEtBQUssRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBQ3hELE9BQU8sRUFBRSxZQUFZLEVBQW9CLE1BQU0sOEJBQThCLENBQUM7QUFJOUUsT0FBTyxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxzQ0FBc0MsQ0FBQztBQUU3RSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUNsRSxPQUFPLEVBQ0wsS0FBSyxlQUFlLEVBR3JCLE1BQU0sOEJBQThCLENBQUM7QUFJdEMsT0FBTyxLQUFLLEVBQUUsR0FBRyxFQUFFLE1BQU0sTUFBTSxDQUFDO0FBbUJoQzs7OztHQUlHO0FBQ0gsd0JBQXNCLG1CQUFtQixDQUN2QyxlQUFlLEVBQUUsZUFBZSxFQUNoQyxVQUFVLEVBQUUsR0FBRyxFQUNmLElBQUksR0FBRTtJQUNKLGtCQUFrQixDQUFDLEVBQUUsRUFBRSxDQUFDO0lBQ3hCLDRCQUE0QixDQUFDLEVBQUUsTUFBTSxDQUFDO0NBQ2xDLEdBQ0wsT0FBTyxDQUFDLG1CQUFtQixDQUFDLENBbUI5QjtBQUVELDhCQUE4QjtBQUM5QixNQUFNLE1BQU0sa0JBQWtCLEdBQUcsZUFBZSxHQUFHO0lBQ2pELDBEQUEwRDtJQUMxRCxVQUFVLEVBQUUsTUFBTSxDQUFDO0lBQ25CLDZEQUE2RDtJQUM3RCxZQUFZLEVBQUUsT0FBTyxDQUFDO0lBQ3RCLHlGQUF5RjtJQUN6RixzQkFBc0IsQ0FBQyxFQUFFLEVBQUUsQ0FBQztDQUM3QixDQUFDO0FBRUY7Ozs7R0FJRztBQUNILHdCQUFzQixrQkFBa0IsQ0FBQyxNQUFNLHlDQUFrQyxFQUFFLE9BQU8sRUFBRSxLQUFLOzs7R0FrSWhHO0FBRUQ7OztHQUdHO0FBQ0gsd0JBQXNCLGVBQWUsQ0FDbkMsTUFBTSxHQUFFLE9BQU8sQ0FBQyxlQUFlLENBQU0sRUFDckMsSUFBSSxHQUFFO0lBQ0osU0FBUyxDQUFDLEVBQUUsZUFBZSxDQUFDO0lBQzVCLFVBQVUsQ0FBQyxFQUFFLG1CQUFtQixDQUFDO0lBQ2pDLFlBQVksQ0FBQyxFQUFFLFlBQVksQ0FBQztJQUM1QixZQUFZLENBQUMsRUFBRSxnQkFBZ0IsQ0FBQztDQUM1QixFQUNOLE9BQU8sR0FBRTtJQUFFLE9BQU8sQ0FBQyxFQUFFLFdBQVcsQ0FBQTtDQUFPLDhEQWN4QyJ9
51
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9jYWwtbmV0d29yay5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2xvY2FsLW5ldHdvcmsvbG9jYWwtbmV0d29yay50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBR0EsT0FBTyxFQUFFLEtBQUssZUFBZSxFQUFvQixNQUFNLCtCQUErQixDQUFDO0FBQ3ZGLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUVqRCxPQUFPLEVBQUUsS0FBSyxtQkFBbUIsRUFBb0IsTUFBTSxnQ0FBZ0MsQ0FBQztBQU01RixPQUFPLEtBQUssRUFBRSxtQkFBbUIsRUFBRSxNQUFNLDRDQUE0QyxDQUFDO0FBR3RGLE9BQU8sS0FBSyxFQUFFLEtBQUssRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBQ3hELE9BQU8sRUFBRSxZQUFZLEVBQW9CLE1BQU0sOEJBQThCLENBQUM7QUFJOUUsT0FBTyxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxzQ0FBc0MsQ0FBQztBQUU3RSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUNsRSxPQUFPLEVBQ0wsS0FBSyxlQUFlLEVBR3JCLE1BQU0sOEJBQThCLENBQUM7QUFLdEMsT0FBTyxLQUFLLEVBQUUsR0FBRyxFQUFFLE1BQU0sTUFBTSxDQUFDO0FBbUJoQzs7OztHQUlHO0FBQ0gsd0JBQXNCLG1CQUFtQixDQUN2QyxlQUFlLEVBQUUsZUFBZSxFQUNoQyxVQUFVLEVBQUUsR0FBRyxFQUNmLElBQUksR0FBRTtJQUNKLGtCQUFrQixDQUFDLEVBQUUsRUFBRSxDQUFDO0lBQ3hCLDRCQUE0QixDQUFDLEVBQUUsTUFBTSxDQUFDO0NBQ2xDLEdBQ0wsT0FBTyxDQUFDLG1CQUFtQixDQUFDLENBbUI5QjtBQUVELDhCQUE4QjtBQUM5QixNQUFNLE1BQU0sa0JBQWtCLEdBQUcsZUFBZSxHQUFHO0lBQ2pELDBEQUEwRDtJQUMxRCxVQUFVLEVBQUUsTUFBTSxDQUFDO0lBQ25CLDZEQUE2RDtJQUM3RCxZQUFZLEVBQUUsT0FBTyxDQUFDO0lBQ3RCLHlGQUF5RjtJQUN6RixzQkFBc0IsQ0FBQyxFQUFFLEVBQUUsQ0FBQztDQUM3QixDQUFDO0FBRUY7Ozs7R0FJRztBQUNILHdCQUFzQixrQkFBa0IsQ0FBQyxNQUFNLHlDQUFrQyxFQUFFLE9BQU8sRUFBRSxLQUFLOzs7R0FrSWhHO0FBRUQ7OztHQUdHO0FBQ0gsd0JBQXNCLGVBQWUsQ0FDbkMsTUFBTSxHQUFFLE9BQU8sQ0FBQyxlQUFlLENBQU0sRUFDckMsSUFBSSxHQUFFO0lBQ0osU0FBUyxDQUFDLEVBQUUsZUFBZSxDQUFDO0lBQzVCLFVBQVUsQ0FBQyxFQUFFLG1CQUFtQixDQUFDO0lBQ2pDLFlBQVksQ0FBQyxFQUFFLFlBQVksQ0FBQztJQUM1QixZQUFZLENBQUMsRUFBRSxnQkFBZ0IsQ0FBQztDQUM1QixFQUNOLE9BQU8sR0FBRTtJQUFFLE9BQU8sQ0FBQyxFQUFFLFdBQVcsQ0FBQTtDQUFPLDhEQWN4QyJ9
@@ -1 +1 @@
1
- {"version":3,"file":"local-network.d.ts","sourceRoot":"","sources":["../../src/local-network/local-network.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,KAAK,eAAe,EAAoB,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,EAAE,EAAE,MAAM,6BAA6B,CAAC;AAEjD,OAAO,EAAE,KAAK,mBAAmB,EAAoB,MAAM,gCAAgC,CAAC;AAM5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAGtF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAoB,MAAM,8BAA8B,CAAC;AAI9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EACL,KAAK,eAAe,EAGrB,MAAM,8BAA8B,CAAC;AAItC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAmBhC;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,eAAe,EAAE,eAAe,EAChC,UAAU,EAAE,GAAG,EACf,IAAI,GAAE;IACJ,kBAAkB,CAAC,EAAE,EAAE,CAAC;IACxB,4BAA4B,CAAC,EAAE,MAAM,CAAC;CAClC,GACL,OAAO,CAAC,mBAAmB,CAAC,CAmB9B;AAED,8BAA8B;AAC9B,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG;IACjD,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,YAAY,EAAE,OAAO,CAAC;IACtB,yFAAyF;IACzF,sBAAsB,CAAC,EAAE,EAAE,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,yCAAkC,EAAE,OAAO,EAAE,KAAK;;;GAkIhG;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,EACrC,IAAI,GAAE;IACJ,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,gBAAgB,CAAC;CAC5B,EACN,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,WAAW,CAAA;CAAO,8DAcxC"}
1
+ {"version":3,"file":"local-network.d.ts","sourceRoot":"","sources":["../../src/local-network/local-network.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,KAAK,eAAe,EAAoB,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,EAAE,EAAE,MAAM,6BAA6B,CAAC;AAEjD,OAAO,EAAE,KAAK,mBAAmB,EAAoB,MAAM,gCAAgC,CAAC;AAM5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAGtF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAoB,MAAM,8BAA8B,CAAC;AAI9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EACL,KAAK,eAAe,EAGrB,MAAM,8BAA8B,CAAC;AAKtC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAmBhC;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,eAAe,EAAE,eAAe,EAChC,UAAU,EAAE,GAAG,EACf,IAAI,GAAE;IACJ,kBAAkB,CAAC,EAAE,EAAE,CAAC;IACxB,4BAA4B,CAAC,EAAE,MAAM,CAAC;CAClC,GACL,OAAO,CAAC,mBAAmB,CAAC,CAmB9B;AAED,8BAA8B;AAC9B,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG;IACjD,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,YAAY,EAAE,OAAO,CAAC;IACtB,yFAAyF;IACzF,sBAAsB,CAAC,EAAE,EAAE,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,yCAAkC,EAAE,OAAO,EAAE,KAAK;;;GAkIhG;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,EACrC,IAAI,GAAE;IACJ,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,gBAAgB,CAAC;CAC5B,EACN,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,WAAW,CAAA;CAAO,8DAcxC"}
@@ -21,6 +21,7 @@ import { getConfigEnvVars as getTelemetryClientConfig, initTelemetryClient } fro
21
21
  import { EmbeddedWallet } from '@aztec-labs/wallets/embedded';
22
22
  import { createFundedInitializerlessAccounts } from '@aztec-labs/wallets/testing';
23
23
  import { getGenesisValues } from '@aztec-labs/world-state/testing';
24
+ import { Buffer } from 'buffer';
24
25
  import { mnemonicToAccount, privateKeyToAddress } from 'viem/accounts';
25
26
  import { foundry } from 'viem/chains';
26
27
  import { createAccountLogs } from '../cli/util.js';
package/package.json CHANGED
@@ -1,9 +1,10 @@
1
1
  {
2
2
  "name": "@aztec-labs/aztec",
3
- "version": "6.0.0-rc.3",
3
+ "version": "6.0.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": "./dest/index.js",
7
+ "./deploy": "./dest/deploy/index.js",
7
8
  "./testing": "./dest/testing/index.js"
8
9
  },
9
10
  "bin": "./scripts/aztec.sh",
@@ -28,35 +29,36 @@
28
29
  "../package.common.json"
29
30
  ],
30
31
  "dependencies": {
31
- "@aztec-foundation/bb.js": "6.0.0-rc.6",
32
- "@aztec-labs/accounts": "6.0.0-rc.3",
33
- "@aztec-labs/archiver": "6.0.0-rc.3",
34
- "@aztec-labs/aztec-node": "6.0.0-rc.3",
35
- "@aztec-labs/aztec.js": "6.0.0-rc.3",
36
- "@aztec-labs/blob-client": "6.0.0-rc.3",
37
- "@aztec-labs/bot": "6.0.0-rc.3",
38
- "@aztec-labs/builder": "6.0.0-rc.3",
39
- "@aztec-labs/cli": "6.0.0-rc.3",
40
- "@aztec-labs/constants": "6.0.0-rc.3",
41
- "@aztec-labs/ethereum": "6.0.0-rc.3",
42
- "@aztec-labs/foundation": "6.0.0-rc.3",
43
- "@aztec-labs/kv-store": "6.0.0-rc.3",
44
- "@aztec-labs/node-lib": "6.0.0-rc.3",
45
- "@aztec-labs/noir-contracts.js": "6.0.0-rc.3",
46
- "@aztec-labs/noir-protocol-circuits-types": "6.0.0-rc.3",
47
- "@aztec-labs/p2p": "6.0.0-rc.3",
48
- "@aztec-labs/protocol-contracts": "6.0.0-rc.3",
49
- "@aztec-labs/prover-client": "6.0.0-rc.3",
50
- "@aztec-labs/prover-node": "6.0.0-rc.3",
51
- "@aztec-labs/pxe": "6.0.0-rc.3",
52
- "@aztec-labs/sequencer-client": "6.0.0-rc.3",
53
- "@aztec-labs/standard-contracts": "6.0.0-rc.3",
54
- "@aztec-labs/stdlib": "6.0.0-rc.3",
55
- "@aztec-labs/telemetry-client": "6.0.0-rc.3",
56
- "@aztec-labs/txe": "6.0.0-rc.3",
57
- "@aztec-labs/validator-ha-signer": "6.0.0-rc.3",
58
- "@aztec-labs/wallets": "6.0.0-rc.3",
59
- "@aztec-labs/world-state": "6.0.0-rc.3",
32
+ "@aztec-foundation/bb.js": "6.0.0",
33
+ "@aztec-labs/accounts": "6.0.0",
34
+ "@aztec-labs/archiver": "6.0.0",
35
+ "@aztec-labs/aztec-node": "6.0.0",
36
+ "@aztec-labs/aztec.js": "6.0.0",
37
+ "@aztec-labs/blob-client": "6.0.0",
38
+ "@aztec-labs/bot": "6.0.0",
39
+ "@aztec-labs/builder": "6.0.0",
40
+ "@aztec-labs/cli": "6.0.0",
41
+ "@aztec-labs/constants": "6.0.0",
42
+ "@aztec-labs/entrypoints": "6.0.0",
43
+ "@aztec-labs/ethereum": "6.0.0",
44
+ "@aztec-labs/foundation": "6.0.0",
45
+ "@aztec-labs/kv-store": "6.0.0",
46
+ "@aztec-labs/node-lib": "6.0.0",
47
+ "@aztec-labs/noir-contracts.js": "6.0.0",
48
+ "@aztec-labs/noir-protocol-circuits-types": "6.0.0",
49
+ "@aztec-labs/p2p": "6.0.0",
50
+ "@aztec-labs/protocol-contracts": "6.0.0",
51
+ "@aztec-labs/prover-client": "6.0.0",
52
+ "@aztec-labs/prover-node": "6.0.0",
53
+ "@aztec-labs/pxe": "6.0.0",
54
+ "@aztec-labs/sequencer-client": "6.0.0",
55
+ "@aztec-labs/standard-contracts": "6.0.0",
56
+ "@aztec-labs/stdlib": "6.0.0",
57
+ "@aztec-labs/telemetry-client": "6.0.0",
58
+ "@aztec-labs/txe": "6.0.0",
59
+ "@aztec-labs/validator-ha-signer": "6.0.0",
60
+ "@aztec-labs/wallets": "6.0.0",
61
+ "@aztec-labs/world-state": "6.0.0",
60
62
  "@iarna/toml": "^2.2.5",
61
63
  "@types/chalk": "^2.2.0",
62
64
  "abitype": "^0.8.11",
@@ -64,7 +66,8 @@
64
66
  "commander": "^12.1.0",
65
67
  "koa": "^2.16.1",
66
68
  "koa-router": "^13.1.1",
67
- "viem": "npm:@aztec/viem@2.38.3"
69
+ "viem": "2.57.1",
70
+ "zod": "~4.4.3"
68
71
  },
69
72
  "files": [
70
73
  "dest",
@@ -120,6 +123,6 @@
120
123
  ]
121
124
  },
122
125
  "engines": {
123
- "node": ">=20.10"
126
+ "node": ">=20.16"
124
127
  }
125
128
  }
@@ -1,6 +1,7 @@
1
1
  import { randomBytes } from '@aztec-labs/foundation/crypto/random';
2
2
  import { sha256Hash } from '@aztec-labs/foundation/json-rpc/server';
3
3
  import type { Logger } from '@aztec-labs/foundation/log';
4
+ import { Buffer } from 'buffer';
4
5
  import { promises as fs } from 'fs';
5
6
  import { join } from 'path';
6
7
 
@@ -33,14 +33,16 @@ export interface AztecStartOption {
33
33
  printDefault?: (val: any) => string;
34
34
  env: EnvVar | undefined;
35
35
  fallback?: EnvVar[];
36
+ deprecatedFallback?: ConfigMapping<unknown>['deprecatedFallback'];
36
37
  parseVal?: (val: string) => any;
37
38
  }
38
39
 
39
40
  export const getOptions = (namespace: string, configMappings: Record<string, ConfigMapping<unknown>>) => {
40
41
  const options: AztecStartOption[] = [];
41
- for (const [key, { env, defaultValue: def, parseEnv, description, printDefault, fallback }] of Object.entries(
42
- configMappings,
43
- )) {
42
+ for (const [
43
+ key,
44
+ { env, defaultValue: def, parseEnv, description, printDefault, fallback, deprecatedFallback },
45
+ ] of Object.entries(configMappings)) {
44
46
  if (universalOptions.includes(key)) {
45
47
  continue;
46
48
  }
@@ -52,6 +54,7 @@ export const getOptions = (namespace: string, configMappings: Record<string, Con
52
54
  printDefault,
53
55
  env: env,
54
56
  fallback,
57
+ deprecatedFallback,
55
58
  parseVal: parseEnv,
56
59
  });
57
60
  }
@@ -215,7 +218,7 @@ export const aztecStartOptions: { [key: string]: AztecStartOption[] } = {
215
218
  'WORLD STATE': [
216
219
  configToFlag('--world-state-data-directory', worldStateConfigMappings.worldStateDataDirectory),
217
220
  configToFlag('--world-state-db-map-size-kb', worldStateConfigMappings.worldStateDbMapSizeKb),
218
- configToFlag('--world-state-checkpoint-history', worldStateConfigMappings.worldStateCheckpointHistory),
221
+ configToFlag('--world-state-history-retention', worldStateConfigMappings.worldStateHistoryRetention),
219
222
  ],
220
223
  // We can't easily auto-generate node options as they're parts of modules defined below
221
224
  'AZTEC NODE': [
package/src/cli/cli.ts CHANGED
@@ -1,3 +1,4 @@
1
+ import { getEnv } from '@aztec-labs/foundation/config/env';
1
2
  import type { LogFn, Logger } from '@aztec-labs/foundation/log';
2
3
  import { Command } from 'commander';
3
4
 
@@ -30,7 +31,7 @@ export function injectAztecCommands(program: Command, userLog: LogFn, debugLogge
30
31
 
31
32
  program.configureHelp({ sortSubcommands: true });
32
33
 
33
- if (process.env.AZTEC_SHELL_WRAPPER) {
34
+ if (getEnv().AZTEC_SHELL_WRAPPER) {
34
35
  program.addHelpText(
35
36
  'after',
36
37
  `
@@ -1,5 +1,6 @@
1
1
  import { findBbBinary } from '@aztec-foundation/bb.js';
2
2
 
3
+ import { getEnv } from '@aztec-labs/foundation/config/env';
3
4
  import type { LogFn } from '@aztec-labs/foundation/log';
4
5
  import { getPackageVersion } from '@aztec-labs/stdlib/update-checker';
5
6
  import { execFileSync } from 'child_process';
@@ -143,8 +144,8 @@ async function checkNoTestsInContracts(nargo: string, log: LogFn): Promise<void>
143
144
  async function compileAztecContract(nargoArgs: string[], log: LogFn): Promise<void> {
144
145
  await warnIfAztecVersionMismatch(log);
145
146
 
146
- const nargo = process.env.NARGO ?? 'nargo';
147
- const bb = process.env.BB ?? findBbBinary() ?? 'bb';
147
+ const nargo = getEnv().NARGO ?? 'nargo';
148
+ const bb = getEnv().BB ?? findBbBinary() ?? 'bb';
148
149
 
149
150
  const shouldRecompile = await needsRecompile();
150
151
  if (shouldRecompile) {
@@ -184,7 +185,7 @@ export function injectCompileCommand(program: Command, log: LogFn): Command {
184
185
  )
185
186
  .addHelpText('after', () => {
186
187
  // Show nargo's own compile options so users see all available flags in one place.
187
- const nargo = process.env.NARGO ?? 'nargo';
188
+ const nargo = getEnv().NARGO ?? 'nargo';
188
189
  try {
189
190
  const output = execFileSync(nargo, ['compile', '--help'], { encoding: 'utf-8' });
190
191
  return `\nUnderlying nargo compile options:\n\n${output}`;
@@ -1,3 +1,4 @@
1
+ import { getEnv } from '@aztec-labs/foundation/config/env';
1
2
  import { runMigrations } from '@aztec-labs/validator-ha-signer/migrations';
2
3
  import type { Command } from 'commander';
3
4
 
@@ -7,7 +8,7 @@ export function injectMigrateCommand(program: Command, log: (msg: string) => voi
7
8
  migrateCommand
8
9
  .command('up')
9
10
  .description('Apply pending migrations')
10
- .requiredOption('--database-url <string>', 'PostgreSQL connection string', process.env.DATABASE_URL)
11
+ .requiredOption('--database-url <string>', 'PostgreSQL connection string', getEnv().DATABASE_URL)
11
12
  .option('--verbose', 'Enable verbose output', false)
12
13
  .action(async options => {
13
14
  const migrations = await runMigrations(options.databaseUrl, {
@@ -24,7 +25,7 @@ export function injectMigrateCommand(program: Command, log: (msg: string) => voi
24
25
  migrateCommand
25
26
  .command('down')
26
27
  .description('Rollback the last migration')
27
- .requiredOption('--database-url <string>', 'PostgreSQL connection string', process.env.DATABASE_URL)
28
+ .requiredOption('--database-url <string>', 'PostgreSQL connection string', getEnv().DATABASE_URL)
28
29
  .option('--verbose', 'Enable verbose output', false)
29
30
  .action(async options => {
30
31
  const migrations = await runMigrations(options.databaseUrl, {