@aztec/aztec 0.0.1-commit.42ee6df9b → 0.0.1-commit.431c48d

package/dest/deploy/reporter.js

@@ -0,0 +1,76 @@
+/**
+ * Observability for the deploy framework. {@link runDeployment} emits structured lifecycle events
+ * to a {@link DeployReporter} instead of writing to the console directly, so callers control where
+ * the signal goes: the default ({@link consoleReporter}) renders human-readably to **stderr** —
+ * keeping stdout clear for the deploy scripts' `export KEY=VAL` lines, which an orchestrator evals —
+ * while e2e, a progress UI, or structured CI logging can inject their own reporter and consume the
+ * events as data. Every hook is optional; an empty `{}` is a valid (silent) reporter.
+ */ import { formatLayers, formatList } from './graph.js';
+const MS_PER_SECOND = 1000;
+const WEI_PER_FEE_JUICE = 10n ** 18n;
+const seconds = (ms)=>`${(ms / MS_PER_SECOND).toFixed(1)}s`;
+const feeJuice = (wei)=>`${wei / WEI_PER_FEE_JUICE} FJ`;
+function describeFunding(f) {
+    switch(f.kind){
+        case 'idle':
+            return 'idle (no work)';
+        case 'sponsored':
+            return 'sponsored';
+        case 'funded':
+            return `funded (${feeJuice(f.balance)})`;
+        case 'not-funded':
+            return `not funded (${feeJuice(f.balance)}) → will bridge ${feeJuice(f.fundAmount)}`;
+    }
+}
+/**
+ * The default reporter: renders events human-readably to **stderr**. Stderr (not stdout) so the
+ * traces survive an orchestrator that captures stdout for the scripts' `export` lines.
+ */ export function consoleReporter() {
+    const log = (line)=>void process.stderr.write(`${line}\n`);
+    return {
+        onPlan (plan) {
+            log(`\n── Plan (${plan.label}) ──`);
+            log(formatList('accounts', plan.accounts.map((a)=>({
+                    name: a.alias,
+                    tag: describeFunding(a.funding)
+                }))));
+            log(formatList('steps', plan.steps.map((s)=>({
+                    name: s.id,
+                    tag: `${s.kind} · ${s.status}`,
+                    dependencies: s.dependsOn
+                }))));
+            log(formatLayers('execution layers', plan.layers.map((layer)=>layer.map((name)=>({
+                        name
+                    })))));
+        },
+        onNothingToDo (label) {
+            log(`\nNothing to do on ${label} — everything is already on-chain.`);
+        },
+        onBridge ({ recipient, amount, reused }) {
+            log(reused ? `Reusing a pending bridge claim for ${recipient} (resuming a top-up).` : `Bridging ${amount} Fee Juice to ${recipient} (this can take a few minutes)...`);
+        },
+        onUnitStart (unit) {
+            log(`→ ${unit.label}...`);
+        },
+        onUnitSettled (unit, result) {
+            const bits = [
+                result.txHash ? `tx ${result.txHash.toString().slice(0, 10)}…` : undefined,
+                result.blockNumber != null ? `block ${result.blockNumber}` : undefined,
+                seconds(result.durationMs)
+            ].filter(Boolean);
+            log(`✓ ${unit.label}  ${bits.join('  ')}`);
+        },
+        onUnitError (unit, error) {
+            log(`✗ ${unit.label}  failed: ${error instanceof Error ? error.message : String(error)}`);
+        },
+        onComplete (summary) {
+            log(`\n── Deployed to ${summary.label} ──`);
+            for (const c of summary.contracts){
+                log(`  ${c.alias.padEnd(16)} ${c.address}  (${c.status})`);
+            }
+            for (const a of summary.accounts){
+                log(`  account ${a.alias}: ${a.address}`);
+            }
+        }
+    };
+}

package/dest/deploy/runner.d.ts

@@ -0,0 +1,8 @@
+import type { DeploymentSpec, Steps } from './types.js';
+/**
+ * Runs a {@link DeploymentSpec}: resolves accounts and deterministic addresses, inventories what's
+ * already on-chain, reports the plan, funds the working accounts, and executes the missing steps in
+ * dependency layers. Idempotent — a re-run sends nothing when everything is already in place.
+ */
+export declare function runDeployment<C extends Steps>(spec: DeploymentSpec<C>): Promise<void>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicnVubmVyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZGVwbG95L3J1bm5lci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUF3REEsT0FBTyxLQUFLLEVBSVYsY0FBYyxFQUtkLEtBQUssRUFDTixNQUFNLFlBQVksQ0FBQztBQWdEcEI7Ozs7R0FJRztBQUNILHdCQUFzQixhQUFhLENBQUMsQ0FBQyxTQUFTLEtBQUssRUFBRSxJQUFJLEVBQUUsY0FBYyxDQUFDLENBQUMsQ0FBQyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FjM0YifQ==

package/dest/deploy/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/deploy/runner.ts"],"names":[],"mappings":"AAwDA,OAAO,KAAK,EAIV,cAAc,EAKd,KAAK,EACN,MAAM,YAAY,CAAC;AAgDpB;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAc3F"}