crypto-aio 0.0.2 → 0.1.0

package/dist/core/container/container.js

@@ -0,0 +1,466 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CryptoAio = exports.NATIVE_CLOSE_TIMEOUT_MS = void 0;
+const service_1 = require("../assets/service");
+const handle_1 = require("../blockchain/handle");
+const internal_1 = require("../blockchain/internal");
+const env_1 = require("../config/env");
+const merge_1 = require("../config/merge");
+const resolve_1 = require("../config/resolve");
+const error_1 = require("../errors/error");
+const bus_1 = require("../events/bus");
+const logger_1 = require("../events/logger");
+const engine_1 = require("../lifecycle/engine");
+const monitor_1 = require("../lifecycle/monitor");
+const observations_1 = require("../lifecycle/observations");
+const views_1 = require("../lifecycle/views");
+const sequence_1 = require("../ordering/sequence");
+const plugin_1 = require("../registry/plugin");
+const orchestrator_1 = require("../signing/orchestrator");
+const wallet_1 = require("../signing/wallet");
+const memory_1 = require("../store/memory");
+const bytes_1 = require("../util/bytes");
+const clock_1 = require("../util/clock");
+const builtins_1 = require("./builtins");
+const internals_1 = require("./internals");
+const pool_1 = require("./pool");
+const NAMESPACE = /^[A-Za-z0-9._-]{1,64}$/;
+/**
+ * The signal a worker loop, pass or recovery runs under: the caller's, if any, and the
+ * root's `closing`, which `close()` aborts. A closed container starts no new work: it
+ * stops claiming Operations from a shared store (holding each for a lease) and no longer
+ * keeps the process alive.
+ */
+function workerSignal(runtime, signal) {
+    if (runtime.closed)
+        throw (0, internals_1.closedError)();
+    return signal
+        ? AbortSignal.any([signal, runtime.closing.signal])
+        : runtime.closing.signal;
+}
+/** How long `close()` waits for one native client's `close` before moving on. */
+exports.NATIVE_CLOSE_TIMEOUT_MS = 5_000;
+/** Runs `close`, but gives up waiting after `ms` of `clock` time (the close keeps running). */
+async function closeWithin(close, clock, ms) {
+    const timer = new AbortController();
+    try {
+        return await Promise.race([
+            Promise.resolve()
+                .then(close)
+                .then(() => 'closed'),
+            clock.sleep(ms, timer.signal).then(() => 'timeout'),
+        ]);
+    }
+    finally {
+        timer.abort();
+    }
+}
+/**
+ * Deep-clones plain objects/arrays into a frozen copy so a later mutation of the caller's
+ * own input can never reach a layer already captured by a container. Class instances
+ * (Signer, Secret, ...) are referenced, not cloned — they're already immutable.
+ */
+function cloneFrozen(value, ancestors = new Set()) {
+    if (!Array.isArray(value) && !(0, merge_1.isPlainObject)(value))
+        return value;
+    (0, merge_1.assertNoCycle)(value, ancestors);
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value)) {
+            return Object.freeze(value.map((item) => cloneFrozen(item, ancestors)));
+        }
+        const out = {};
+        for (const [key, v] of Object.entries(value))
+            out[key] = cloneFrozen(v, ancestors);
+        return Object.freeze(out);
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+/** `chains`/`providers`/`wallets`/`signers`/`hooks`/`lifecycle` are all cloned and
+ * deep-frozen at construction, so mutating the caller's options object afterwards never
+ * affects handles already built from this layer. For `signers`, only the map OBJECT is
+ * cloned (a fresh, frozen copy so adding/replacing a key on the caller's own map can't reach
+ * an existing layer) — the `Signer` values it holds are opaque and always taken by reference,
+ * never cloned or frozen, even a plain-object signer (`Signer` is an interface), so it keeps
+ * its identity and its own mutable state. */
+function scopePart(options) {
+    const { chains, providers, signers, wallets, hooks, lifecycle } = options;
+    return {
+        ...(chains ? { chains: cloneFrozen(chains) } : {}),
+        ...(providers ? { providers: cloneFrozen(providers) } : {}),
+        ...(signers ? { signers: Object.freeze({ ...signers }) } : {}),
+        ...(wallets ? { wallets: cloneFrozen(wallets) } : {}),
+        ...(hooks ? { hooks: cloneFrozen(hooks) } : {}),
+        ...(lifecycle ? { lifecycle: cloneFrozen(lifecycle) } : {}),
+    };
+}
+function createEngine(runtime, effective) {
+    const lifecycle = () => (0, engine_1.withLifecycleDefaults)(effective().lifecycle);
+    const { leaseMs } = lifecycle();
+    const log = runtime.log.child('lifecycle');
+    return new engine_1.OperationEngine({
+        namespace: runtime.namespace,
+        stores: runtime.stores,
+        events: runtime.events,
+        clock: runtime.clock,
+        log,
+        orchestrator: new orchestrator_1.SigningOrchestrator({
+            schemes: () => runtime.catalogs.schemes,
+            events: runtime.events,
+            clock: runtime.clock,
+            hooks: () => effective().hooks,
+        }),
+        sequences: new sequence_1.SequenceCoordinator({
+            locks: runtime.stores.locks,
+            sequences: runtime.stores.sequences,
+            clock: runtime.clock,
+            owner: runtime.owner,
+            leaseMs,
+            acquireTimeoutMs: leaseMs,
+            // The code only: a store's error message may carry detail that logs must not.
+            onReleaseError: (error) => log.warn('lease release failed', { code: (0, engine_1.errorCode)(error) }),
+        }),
+        lifecycle,
+    });
+}
+/**
+ * The signer-free read target of a stored Operation, for every check,
+ * worker pass and recovery read: its chain, network and library over its own named
+ * providers first, then the current defaults when those no longer resolve (inline configs
+ * are recorded by hash only and cannot be rebuilt). No wallet or signer is selected, not
+ * even a chain default one, so a rotated signer, a removed wallet or a hung custody
+ * backend never stops monitoring.
+ */
+async function readTarget(container, record) {
+    const internals = (0, internals_1.containerOf)(container);
+    const { runtime } = internals;
+    const { chain, network, library } = record.context;
+    const effective = internals.effective();
+    const { wallet: _wallet, signer: _signer, ...defaults } = effective.chains[chain] ?? {};
+    const signerFree = { ...effective, chains: { ...effective.chains, [chain]: defaults } };
+    const select = (provider) => (0, resolve_1.resolveSelection)({
+        handle: { chain, network, library, ...(provider ? { provider } : {}) },
+        effective: signerFree,
+        catalogs: runtime.catalogs,
+        log: runtime.log,
+    });
+    const named = record.context.providers.filter((name) => !name.startsWith('inline:'));
+    let selection;
+    try {
+        selection = select(named.length > 0 ? named : undefined);
+    }
+    catch (error) {
+        // Only a config that no longer resolves (e.g. a renamed provider) falls back.
+        if (!(error instanceof error_1.ConfigError))
+            throw error;
+        selection = select();
+    }
+    if (runtime.closed)
+        throw (0, internals_1.closedError)();
+    return { selection, pooled: await runtime.pool.get(selection) };
+}
+/**
+ * The wallets the monitor resolved for its writes, cached per container (one public-key
+ * read per wallet selection, not one per pass) and bounded by `lifecycle.signTimeoutMs`. A
+ * failed resolution is not kept. The cache is dropped when the config changes: a container's
+ * layers are frozen, so only a plugin (`use()`, new catalogs and env layer) changes it.
+ */
+function walletCache(runtime, internals) {
+    let catalogs = runtime.catalogs;
+    const wallets = new Map();
+    return (selection, driver) => {
+        if (runtime.catalogs !== catalogs) {
+            catalogs = runtime.catalogs;
+            wallets.clear();
+        }
+        const key = selection.configHash;
+        const cached = wallets.get(key);
+        if (cached)
+            return cached;
+        const { effective, signerDeadline } = internals();
+        const resolving = (0, wallet_1.resolveWallet)(selection, driver, effective().signers, catalogs.schemes, signerDeadline()).catch((error) => {
+            if (wallets.get(key) === resolving)
+                wallets.delete(key);
+            throw error;
+        });
+        wallets.set(key, resolving);
+        return resolving;
+    };
+}
+/**
+ * The wallet-bound target of a stored Operation, resolved lazily and only for the
+ * writes that need one: the all-rejected verdict, nonce reconciliation and recovery's
+ * resend. None of them signs, and their address lease is keyed on the Operation itself.
+ * Its frozen context (chain, network, library, wallet, signer) is rebuilt against the
+ * container's current config with its own named providers first; when that no longer
+ * resolves (a renamed provider, a rotated signer), the wallet alone over the current
+ * defaults, with neither the recorded signer nor the providers: the wallet's current
+ * signer, public key or address then stands for it (a watch-only wallet is enough). The
+ * engine checks the resolved wallet still owns the Operation before using it.
+ */
+async function operationTarget(container, runtime, record, wallets) {
+    const { chain, network, library, wallet, signer, providers } = record.context;
+    const base = { chain, network, library, wallet };
+    const named = providers.filter((name) => !name.startsWith('inline:'));
+    let handle;
+    try {
+        handle = container.blockchain({
+            ...base,
+            ...(signer !== undefined ? { signer } : {}),
+            ...(named.length > 0 ? { provider: named } : {}),
+        });
+    }
+    catch (error) {
+        if (!(error instanceof error_1.ConfigError))
+            throw error;
+        handle = container.blockchain(base);
+    }
+    const internals = (0, internal_1.internalsOf)(handle);
+    const pooled = await internals.pooled();
+    return {
+        selection: internals.selection,
+        pooled,
+        wallet: await wallets(internals.selection, pooled.driver),
+        assets: runtime.assets,
+    };
+}
+/**
+ * Dependency container: stores, signers, wallets, hooks, plugins and a shared driver pool.
+ * Separate `new CryptoAio()` instances are fully isolated (use one per tenant).
+ */
+class CryptoAio {
+    namespace;
+    constructor(options = {}, scope) {
+        if (scope) {
+            const parent = (0, internals_1.containerOf)(scope.parent);
+            this.namespace = parent.runtime.namespace;
+            this.#bind(parent.runtime, [...parent.layers, scopePart(scope.overrides)], false);
+            return;
+        }
+        const namespace = options.namespace ?? 'default';
+        if (!NAMESPACE.test(namespace))
+            throw new error_1.ConfigError('CONFIG_INVALID', 'invalid namespace: use 1 to 64 letters, digits, dots, underscores or hyphens');
+        const clock = options.clock ?? clock_1.systemClock;
+        const log = options.logger ?? (0, logger_1.createLogger)();
+        const catalogs = (0, plugin_1.createCatalogs)();
+        for (const plugin of [...(0, builtins_1.builtinPlugins)(), ...(options.plugins ?? [])])
+            (0, plugin_1.applyPlugin)(catalogs, plugin);
+        const env = options.env === false ? {} : (options.env ?? process.env);
+        const events = new bus_1.EventBus(clock, log);
+        // eslint-disable-next-line prefer-const -- closures below read it after assignment
+        let runtime;
+        const pool = new pool_1.DriverPool({
+            catalogs: () => runtime.catalogs,
+            clock,
+            events,
+            log,
+            transport: () => runtime.transport,
+        });
+        runtime = {
+            namespace,
+            catalogs,
+            envLayer: {
+                chains: (0, env_1.readEnvChains)(env, catalogs.chains.list().map((c) => c.id), options.profile),
+            },
+            env,
+            ...(options.profile !== undefined ? { profile: options.profile } : {}),
+            clock,
+            log,
+            events,
+            stores: {
+                ...(0, memory_1.createMemoryStores)(clock),
+                ...Object.fromEntries(Object.entries(options.stores ?? {}).filter(([, store]) => store !== undefined)),
+            },
+            pool,
+            assets: new service_1.AssetService(() => runtime.catalogs),
+            transport: options.transport ?? {},
+            owner: (0, bytes_1.randomId)('aio'),
+            closed: false,
+            closing: new AbortController(),
+            natives: new Set(),
+        };
+        this.namespace = namespace;
+        this.#bind(runtime, [scopePart(options)], true);
+    }
+    /**
+     * Child container: inherits config, pool, stores and namespace; overrides merge on top.
+     * Not a tenant boundary — a scope shares its root's pool and stores. Use a separate
+     * `new CryptoAio({ namespace })` when isolation between tenants is required.
+     */
+    scope(overrides) {
+        return new CryptoAio({}, { parent: this, overrides });
+    }
+    blockchain(config) {
+        const internals = (0, internals_1.containerOf)(this);
+        const { runtime } = internals;
+        const selection = (0, resolve_1.resolveSelection)({
+            handle: config,
+            effective: internals.effective(),
+            catalogs: runtime.catalogs,
+            log: runtime.log,
+        });
+        let pooled;
+        let wallet;
+        const handle = {
+            container: this,
+            selection,
+            nativeClients: new Map(),
+            assertOpen: () => {
+                if (runtime.closed)
+                    throw (0, internals_1.closedError)();
+            },
+            registerNative: (native) => {
+                if (runtime.closed)
+                    throw (0, internals_1.closedError)();
+                if (native.close)
+                    runtime.natives.add(() => native.close?.());
+            },
+            // A closed root refuses work even through a pooled driver this handle holds.
+            pooled: () => {
+                if (runtime.closed)
+                    return Promise.reject((0, internals_1.closedError)());
+                pooled ??= runtime.pool.get(selection).catch((error) => {
+                    pooled = undefined;
+                    throw error;
+                });
+                return pooled;
+            },
+            wallet: () => {
+                if (runtime.closed)
+                    return Promise.reject((0, internals_1.closedError)());
+                wallet ??= handle
+                    .pooled()
+                    .then(({ driver }) => (0, wallet_1.resolveWallet)(selection, driver, internals.effective().signers, runtime.catalogs.schemes, internals.signerDeadline()))
+                    .catch((error) => {
+                    wallet = undefined;
+                    throw error;
+                });
+                return wallet;
+            },
+        };
+        return new handle_1.Blockchain(handle);
+    }
+    /** Registers a plugin on this root container (copy-on-write catalogs). */
+    use(plugin) {
+        const internals = (0, internals_1.containerOf)(this);
+        if (!internals.isRoot)
+            throw new error_1.ConfigError('CONFIG_INVALID', 'plugins can only be added to a root container');
+        const { runtime } = internals;
+        const next = (0, plugin_1.cloneCatalogs)(runtime.catalogs);
+        (0, plugin_1.applyPlugin)(next, plugin);
+        runtime.catalogs = next;
+        runtime.envLayer = {
+            chains: (0, env_1.readEnvChains)(runtime.env, next.chains.list().map((c) => c.id), runtime.profile),
+        };
+        return this;
+    }
+    on(type, handler) {
+        return (0, internals_1.containerOf)(this).runtime.events.on(type, handler);
+    }
+    onAny(handler) {
+        return (0, internals_1.containerOf)(this).runtime.events.onAny(handler);
+    }
+    /** Stored Operations of this namespace, as views, and startup recovery. */
+    get operations() {
+        const internals = (0, internals_1.containerOf)(this);
+        const store = internals.runtime.stores.operations;
+        const namespace = internals.runtime.namespace;
+        const view = async (record) => (0, views_1.toView)(record, await (0, observations_1.loadObservations)(store, record));
+        return {
+            get: async (id) => {
+                const record = await store.get(namespace, id);
+                return record ? view(record) : null;
+            },
+            list: async (filter = {}) => Promise.all((await store.list({
+                namespace,
+                ...(filter.states ? { states: filter.states } : {}),
+                ...(filter.chain ? { chain: filter.chain } : {}),
+                ...(filter.network ? { network: filter.network } : {}),
+                ...(filter.limit !== undefined ? { limit: filter.limit } : {}),
+            })).map(view)),
+            recover: async (options = {}) => internals.monitor().recover({
+                ...options,
+                signal: workerSignal(internals.runtime, options.signal),
+            }),
+        };
+    }
+    /** Background workers that check due Operations without anyone waiting on them. */
+    get monitor() {
+        const internals = (0, internals_1.containerOf)(this);
+        return {
+            start: async (options = {}) => internals.monitor().start({
+                ...options,
+                signal: workerSignal(internals.runtime, options.signal),
+            }),
+            runOnce: async (options = {}) => internals.monitor().runOnce({
+                workerId: options.workerId ?? internals.runtime.owner,
+                ...(options.batch !== undefined ? { batch: options.batch } : {}),
+                signal: workerSignal(internals.runtime, options.signal),
+            }),
+        };
+    }
+    /**
+     * Closes the root container: runs the `close` of every native client that
+     * `crypto-aio/native` handed out (a failing one is logged by code and skipped), then
+     * closes the pooled drivers. Its handles and `native()` then fail with
+     * `INVALID_TRANSITION`. A scope's `close()` does nothing; scopes share their root's pool.
+     */
+    async close() {
+        const internals = (0, internals_1.containerOf)(this);
+        if (!internals.isRoot)
+            return;
+        const { runtime } = internals;
+        runtime.closed = true;
+        // Every worker loop, pass and recovery stops at its next check, and its sleeps end.
+        runtime.closing.abort();
+        const natives = [...runtime.natives];
+        runtime.natives.clear();
+        await Promise.all(natives.map(async (close) => {
+            try {
+                const outcome = await closeWithin(close, runtime.clock, exports.NATIVE_CLOSE_TIMEOUT_MS);
+                if (outcome === 'timeout') {
+                    runtime.log.warn('native client close timed out', {
+                        timeoutMs: exports.NATIVE_CLOSE_TIMEOUT_MS,
+                    });
+                }
+            }
+            catch (error) {
+                runtime.log.warn('native client close failed', { code: (0, engine_1.errorCode)(error) });
+            }
+        }));
+        await runtime.pool.close();
+    }
+    #bind(runtime, layers, isRoot) {
+        const effective = () => (0, merge_1.mergeScopes)([runtime.envLayer, ...layers]);
+        let engine;
+        let monitor;
+        const getEngine = () => (engine ??= createEngine(runtime, effective));
+        const wallets = walletCache(runtime, () => (0, internals_1.containerOf)(this));
+        (0, internals_1.bindContainer)(this, {
+            runtime,
+            layers,
+            isRoot,
+            effective,
+            signerDeadline: () => ({
+                clock: runtime.clock,
+                timeoutMs: (0, engine_1.withLifecycleDefaults)(effective().lifecycle).signTimeoutMs,
+            }),
+            engine: getEngine,
+            monitor: () => (monitor ??= new monitor_1.Monitor({
+                engine: getEngine(),
+                stores: runtime.stores,
+                events: runtime.events,
+                clock: runtime.clock,
+                log: runtime.log.child('monitor'),
+                namespace: runtime.namespace,
+                lifecycle: () => (0, engine_1.withLifecycleDefaults)(effective().lifecycle),
+                resolveRead: (record) => readTarget(this, record),
+                resolveTarget: (record) => operationTarget(this, runtime, record, wallets),
+            })),
+        });
+    }
+}
+exports.CryptoAio = CryptoAio;
+//# sourceMappingURL=container.js.map

package/dist/core/container/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../../src/core/container/container.ts"],"names":[],"mappings":"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","sourcesContent":["import { AssetService } from '../assets/service';\nimport { Blockchain } from '../blockchain/handle';\nimport { internalsOf, type HandleInternals } from '../blockchain/internal';\nimport { readEnvChains } from '../config/env';\nimport { assertNoCycle, isPlainObject, mergeScopes } from '../config/merge';\nimport { resolveSelection } from '../config/resolve';\nimport type {\n  AioOptions,\n  EffectiveOptions,\n  HandleConfig,\n  HandleOptions,\n  ResolvedSelection,\n  ScopeOptions,\n} from '../config/types';\nimport type { ChainDriver } from '../driver/types';\nimport { ConfigError } from '../errors/error';\nimport { EventBus } from '../events/bus';\nimport { createLogger } from '../events/logger';\nimport type { AioEvent, AioEventName } from '../events/types';\nimport {\n  OperationEngine,\n  errorCode,\n  withLifecycleDefaults,\n  type OperationTarget,\n  type ReadTarget,\n} from '../lifecycle/engine';\nimport { Monitor, type RecoveryReport, type WorkerOptions } from '../lifecycle/monitor';\nimport { loadObservations } from '../lifecycle/observations';\nimport { toView, type OperationView } from '../lifecycle/views';\nimport type { ChainId } from '../model/ids';\nimport { SequenceCoordinator } from '../ordering/sequence';\nimport {\n  applyPlugin,\n  cloneCatalogs,\n  createCatalogs,\n  type Catalogs,\n  type Plugin,\n} from '../registry/plugin';\nimport { SigningOrchestrator } from '../signing/orchestrator';\nimport { resolveWallet, type ResolvedWallet } from '../signing/wallet';\nimport { createMemoryStores } from '../store/memory';\nimport type { OperationRecord, OperationState, Stores } from '../store/types';\nimport { randomId } from '../util/bytes';\nimport { systemClock, type Clock } from '../util/clock';\nimport { builtinPlugins } from './builtins';\nimport {\n  bindContainer,\n  closedError,\n  containerOf,\n  type ContainerInternals,\n  type RootRuntime,\n} from './internals';\nimport { DriverPool, type PooledDriver } from './pool';\n\nconst NAMESPACE = /^[A-Za-z0-9._-]{1,64}$/;\n\n/**\n * The signal a worker loop, pass or recovery runs under: the caller's, if any, and the\n * root's `closing`, which `close()` aborts. A closed container starts no new work: it\n * stops claiming Operations from a shared store (holding each for a lease) and no longer\n * keeps the process alive.\n */\nfunction workerSignal(\n  runtime: RootRuntime,\n  signal: AbortSignal | undefined,\n): AbortSignal {\n  if (runtime.closed) throw closedError();\n  return signal\n    ? AbortSignal.any([signal, runtime.closing.signal])\n    : runtime.closing.signal;\n}\n\n/** How long `close()` waits for one native client's `close` before moving on. */\nexport const NATIVE_CLOSE_TIMEOUT_MS = 5_000;\n\n/** Runs `close`, but gives up waiting after `ms` of `clock` time (the close keeps running). */\nasync function closeWithin(\n  close: () => unknown,\n  clock: Clock,\n  ms: number,\n): Promise<'closed' | 'timeout'> {\n  const timer = new AbortController();\n  try {\n    return await Promise.race([\n      Promise.resolve()\n        .then(close)\n        .then(() => 'closed' as const),\n      clock.sleep(ms, timer.signal).then(() => 'timeout' as const),\n    ]);\n  } finally {\n    timer.abort();\n  }\n}\n\ninterface ScopeInit {\n  readonly parent: CryptoAio;\n  readonly overrides: ScopeOptions;\n}\n\n/**\n * Deep-clones plain objects/arrays into a frozen copy so a later mutation of the caller's\n * own input can never reach a layer already captured by a container. Class instances\n * (Signer, Secret, ...) are referenced, not cloned — they're already immutable.\n */\nfunction cloneFrozen<T>(value: T, ancestors: Set<object> = new Set()): T {\n  if (!Array.isArray(value) && !isPlainObject(value)) return value;\n  assertNoCycle(value, ancestors);\n  ancestors.add(value);\n  try {\n    if (Array.isArray(value)) {\n      return Object.freeze(\n        value.map((item: unknown) => cloneFrozen(item, ancestors)),\n      ) as T;\n    }\n    const out: Record<string, unknown> = {};\n    for (const [key, v] of Object.entries(value)) out[key] = cloneFrozen(v, ancestors);\n    return Object.freeze(out) as T;\n  } finally {\n    ancestors.delete(value);\n  }\n}\n\n/** `chains`/`providers`/`wallets`/`signers`/`hooks`/`lifecycle` are all cloned and\n * deep-frozen at construction, so mutating the caller's options object afterwards never\n * affects handles already built from this layer. For `signers`, only the map OBJECT is\n * cloned (a fresh, frozen copy so adding/replacing a key on the caller's own map can't reach\n * an existing layer) — the `Signer` values it holds are opaque and always taken by reference,\n * never cloned or frozen, even a plain-object signer (`Signer` is an interface), so it keeps\n * its identity and its own mutable state. */\nfunction scopePart(options: ScopeOptions): ScopeOptions {\n  const { chains, providers, signers, wallets, hooks, lifecycle } = options;\n  return {\n    ...(chains ? { chains: cloneFrozen(chains) } : {}),\n    ...(providers ? { providers: cloneFrozen(providers) } : {}),\n    ...(signers ? { signers: Object.freeze({ ...signers }) } : {}),\n    ...(wallets ? { wallets: cloneFrozen(wallets) } : {}),\n    ...(hooks ? { hooks: cloneFrozen(hooks) } : {}),\n    ...(lifecycle ? { lifecycle: cloneFrozen(lifecycle) } : {}),\n  };\n}\n\nfunction createEngine(\n  runtime: RootRuntime,\n  effective: () => EffectiveOptions,\n): OperationEngine {\n  const lifecycle = () => withLifecycleDefaults(effective().lifecycle);\n  const { leaseMs } = lifecycle();\n  const log = runtime.log.child('lifecycle');\n  return new OperationEngine({\n    namespace: runtime.namespace,\n    stores: runtime.stores,\n    events: runtime.events,\n    clock: runtime.clock,\n    log,\n    orchestrator: new SigningOrchestrator({\n      schemes: () => runtime.catalogs.schemes,\n      events: runtime.events,\n      clock: runtime.clock,\n      hooks: () => effective().hooks,\n    }),\n    sequences: new SequenceCoordinator({\n      locks: runtime.stores.locks,\n      sequences: runtime.stores.sequences,\n      clock: runtime.clock,\n      owner: runtime.owner,\n      leaseMs,\n      acquireTimeoutMs: leaseMs,\n      // The code only: a store's error message may carry detail that logs must not.\n      onReleaseError: (error) =>\n        log.warn('lease release failed', { code: errorCode(error) }),\n    }),\n    lifecycle,\n  });\n}\n\n/**\n * The signer-free read target of a stored Operation, for every check,\n * worker pass and recovery read: its chain, network and library over its own named\n * providers first, then the current defaults when those no longer resolve (inline configs\n * are recorded by hash only and cannot be rebuilt). No wallet or signer is selected, not\n * even a chain default one, so a rotated signer, a removed wallet or a hung custody\n * backend never stops monitoring.\n */\nasync function readTarget(\n  container: CryptoAio,\n  record: OperationRecord,\n): Promise<ReadTarget> {\n  const internals = containerOf(container);\n  const { runtime } = internals;\n  const { chain, network, library } = record.context;\n  const effective = internals.effective();\n  const { wallet: _wallet, signer: _signer, ...defaults } = effective.chains[chain] ?? {};\n  const signerFree = { ...effective, chains: { ...effective.chains, [chain]: defaults } };\n  const select = (provider?: readonly string[]) =>\n    resolveSelection({\n      handle: { chain, network, library, ...(provider ? { provider } : {}) },\n      effective: signerFree,\n      catalogs: runtime.catalogs,\n      log: runtime.log,\n    });\n  const named = record.context.providers.filter((name) => !name.startsWith('inline:'));\n  let selection: ResolvedSelection;\n  try {\n    selection = select(named.length > 0 ? named : undefined);\n  } catch (error) {\n    // Only a config that no longer resolves (e.g. a renamed provider) falls back.\n    if (!(error instanceof ConfigError)) throw error;\n    selection = select();\n  }\n  if (runtime.closed) throw closedError();\n  return { selection, pooled: await runtime.pool.get(selection) };\n}\n\n/**\n * The wallets the monitor resolved for its writes, cached per container (one public-key\n * read per wallet selection, not one per pass) and bounded by `lifecycle.signTimeoutMs`. A\n * failed resolution is not kept. The cache is dropped when the config changes: a container's\n * layers are frozen, so only a plugin (`use()`, new catalogs and env layer) changes it.\n */\nfunction walletCache(\n  runtime: RootRuntime,\n  internals: () => ContainerInternals,\n): (selection: ResolvedSelection, driver: ChainDriver) => Promise<ResolvedWallet> {\n  let catalogs: Catalogs = runtime.catalogs;\n  const wallets = new Map<string, Promise<ResolvedWallet>>();\n  return (selection, driver) => {\n    if (runtime.catalogs !== catalogs) {\n      catalogs = runtime.catalogs;\n      wallets.clear();\n    }\n    const key = selection.configHash;\n    const cached = wallets.get(key);\n    if (cached) return cached;\n    const { effective, signerDeadline } = internals();\n    const resolving = resolveWallet(\n      selection,\n      driver,\n      effective().signers,\n      catalogs.schemes,\n      signerDeadline(),\n    ).catch((error: unknown) => {\n      if (wallets.get(key) === resolving) wallets.delete(key);\n      throw error;\n    });\n    wallets.set(key, resolving);\n    return resolving;\n  };\n}\n\n/**\n * The wallet-bound target of a stored Operation, resolved lazily and only for the\n * writes that need one: the all-rejected verdict, nonce reconciliation and recovery's\n * resend. None of them signs, and their address lease is keyed on the Operation itself.\n * Its frozen context (chain, network, library, wallet, signer) is rebuilt against the\n * container's current config with its own named providers first; when that no longer\n * resolves (a renamed provider, a rotated signer), the wallet alone over the current\n * defaults, with neither the recorded signer nor the providers: the wallet's current\n * signer, public key or address then stands for it (a watch-only wallet is enough). The\n * engine checks the resolved wallet still owns the Operation before using it.\n */\nasync function operationTarget(\n  container: CryptoAio,\n  runtime: RootRuntime,\n  record: OperationRecord,\n  wallets: (selection: ResolvedSelection, driver: ChainDriver) => Promise<ResolvedWallet>,\n): Promise<OperationTarget> {\n  const { chain, network, library, wallet, signer, providers } = record.context;\n  const base = { chain, network, library, wallet } as HandleConfig<ChainId>;\n  const named = providers.filter((name) => !name.startsWith('inline:'));\n  let handle: Blockchain<ChainId>;\n  try {\n    handle = container.blockchain({\n      ...base,\n      ...(signer !== undefined ? { signer } : {}),\n      ...(named.length > 0 ? { provider: named } : {}),\n    });\n  } catch (error) {\n    if (!(error instanceof ConfigError)) throw error;\n    handle = container.blockchain(base);\n  }\n  const internals = internalsOf(handle);\n  const pooled = await internals.pooled();\n  return {\n    selection: internals.selection,\n    pooled,\n    wallet: await wallets(internals.selection, pooled.driver),\n    assets: runtime.assets,\n  };\n}\n\nexport interface OperationsFilter {\n  readonly states?: readonly OperationState[];\n  readonly chain?: string;\n  readonly network?: string;\n  readonly limit?: number;\n}\n\nexport interface OperationsApi {\n  get(id: string): Promise<OperationView | null>;\n  /** In creation order. */\n  list(filter?: OperationsFilter): Promise<OperationView[]>;\n  /** Startup recovery for this namespace (see RecoveryReport); it never signs. */\n  recover(options?: { readonly signal?: AbortSignal }): Promise<RecoveryReport>;\n}\n\nexport interface MonitorApi {\n  /** Runs worker passes until `signal` aborts; any number of workers may run. */\n  start(options?: WorkerOptions): Promise<void>;\n  /** One worker pass; resolves to the number of Operations it claimed. */\n  runOnce(options?: WorkerOptions): Promise<number>;\n}\n\n/**\n * Dependency container: stores, signers, wallets, hooks, plugins and a shared driver pool.\n * Separate `new CryptoAio()` instances are fully isolated (use one per tenant).\n */\nexport class CryptoAio {\n  readonly namespace: string;\n\n  constructor(options?: AioOptions);\n  /** @internal */\n  constructor(options: AioOptions, scope: ScopeInit);\n  constructor(options: AioOptions = {}, scope?: ScopeInit) {\n    if (scope) {\n      const parent = containerOf(scope.parent);\n      this.namespace = parent.runtime.namespace;\n      this.#bind(parent.runtime, [...parent.layers, scopePart(scope.overrides)], false);\n      return;\n    }\n    const namespace = options.namespace ?? 'default';\n    if (!NAMESPACE.test(namespace))\n      throw new ConfigError(\n        'CONFIG_INVALID',\n        'invalid namespace: use 1 to 64 letters, digits, dots, underscores or hyphens',\n      );\n    const clock = options.clock ?? systemClock;\n    const log = options.logger ?? createLogger();\n    const catalogs = createCatalogs();\n    for (const plugin of [...builtinPlugins(), ...(options.plugins ?? [])])\n      applyPlugin(catalogs, plugin);\n    const env = options.env === false ? {} : (options.env ?? process.env);\n    const events = new EventBus(clock, log);\n    // eslint-disable-next-line prefer-const -- closures below read it after assignment\n    let runtime: RootRuntime;\n    const pool = new DriverPool({\n      catalogs: () => runtime.catalogs,\n      clock,\n      events,\n      log,\n      transport: () => runtime.transport,\n    });\n    runtime = {\n      namespace,\n      catalogs,\n      envLayer: {\n        chains: readEnvChains(\n          env,\n          catalogs.chains.list().map((c) => c.id),\n          options.profile,\n        ),\n      },\n      env,\n      ...(options.profile !== undefined ? { profile: options.profile } : {}),\n      clock,\n      log,\n      events,\n      stores: {\n        ...createMemoryStores(clock),\n        ...(Object.fromEntries(\n          Object.entries(options.stores ?? {}).filter(([, store]) => store !== undefined),\n        ) as Partial<Stores>),\n      },\n      pool,\n      assets: new AssetService(() => runtime.catalogs),\n      transport: options.transport ?? {},\n      owner: randomId('aio'),\n      closed: false,\n      closing: new AbortController(),\n      natives: new Set(),\n    };\n    this.namespace = namespace;\n    this.#bind(runtime, [scopePart(options)], true);\n  }\n\n  /**\n   * Child container: inherits config, pool, stores and namespace; overrides merge on top.\n   * Not a tenant boundary — a scope shares its root's pool and stores. Use a separate\n   * `new CryptoAio({ namespace })` when isolation between tenants is required.\n   */\n  scope(overrides: ScopeOptions): CryptoAio {\n    return new CryptoAio({}, { parent: this, overrides });\n  }\n\n  blockchain<C extends ChainId>(config: HandleConfig<C>): Blockchain<C> {\n    const internals = containerOf(this);\n    const { runtime } = internals;\n    const selection = resolveSelection({\n      handle: config as HandleOptions,\n      effective: internals.effective(),\n      catalogs: runtime.catalogs,\n      log: runtime.log,\n    });\n    let pooled: Promise<PooledDriver> | undefined;\n    let wallet: Promise<ResolvedWallet> | undefined;\n    const handle: HandleInternals = {\n      container: this,\n      selection,\n      nativeClients: new Map(),\n      assertOpen: () => {\n        if (runtime.closed) throw closedError();\n      },\n      registerNative: (native) => {\n        if (runtime.closed) throw closedError();\n        if (native.close) runtime.natives.add(() => native.close?.());\n      },\n      // A closed root refuses work even through a pooled driver this handle holds.\n      pooled: () => {\n        if (runtime.closed) return Promise.reject(closedError());\n        pooled ??= runtime.pool.get(selection).catch((error: unknown) => {\n          pooled = undefined;\n          throw error;\n        });\n        return pooled;\n      },\n      wallet: () => {\n        if (runtime.closed) return Promise.reject(closedError());\n        wallet ??= handle\n          .pooled()\n          .then(({ driver }) =>\n            resolveWallet(\n              selection,\n              driver,\n              internals.effective().signers,\n              runtime.catalogs.schemes,\n              internals.signerDeadline(),\n            ),\n          )\n          .catch((error: unknown) => {\n            wallet = undefined;\n            throw error;\n          });\n        return wallet;\n      },\n    };\n    return new Blockchain<C>(handle);\n  }\n\n  /** Registers a plugin on this root container (copy-on-write catalogs). */\n  use(plugin: Plugin): this {\n    const internals = containerOf(this);\n    if (!internals.isRoot)\n      throw new ConfigError(\n        'CONFIG_INVALID',\n        'plugins can only be added to a root container',\n      );\n    const { runtime } = internals;\n    const next = cloneCatalogs(runtime.catalogs);\n    applyPlugin(next, plugin);\n    runtime.catalogs = next;\n    runtime.envLayer = {\n      chains: readEnvChains(\n        runtime.env,\n        next.chains.list().map((c) => c.id),\n        runtime.profile,\n      ),\n    };\n    return this;\n  }\n\n  on<E extends AioEventName>(type: E, handler: (event: AioEvent<E>) => void): () => void {\n    return containerOf(this).runtime.events.on(type, handler);\n  }\n\n  onAny(handler: (event: AioEvent) => void): () => void {\n    return containerOf(this).runtime.events.onAny(handler);\n  }\n\n  /** Stored Operations of this namespace, as views, and startup recovery. */\n  get operations(): OperationsApi {\n    const internals = containerOf(this);\n    const store = internals.runtime.stores.operations;\n    const namespace = internals.runtime.namespace;\n    const view = async (record: OperationRecord) =>\n      toView(record, await loadObservations(store, record));\n    return {\n      get: async (id) => {\n        const record = await store.get(namespace, id);\n        return record ? view(record) : null;\n      },\n      list: async (filter = {}) =>\n        Promise.all(\n          (\n            await store.list({\n              namespace,\n              ...(filter.states ? { states: filter.states } : {}),\n              ...(filter.chain ? { chain: filter.chain } : {}),\n              ...(filter.network ? { network: filter.network } : {}),\n              ...(filter.limit !== undefined ? { limit: filter.limit } : {}),\n            })\n          ).map(view),\n        ),\n      recover: async (options = {}) =>\n        internals.monitor().recover({\n          ...options,\n          signal: workerSignal(internals.runtime, options.signal),\n        }),\n    };\n  }\n\n  /** Background workers that check due Operations without anyone waiting on them. */\n  get monitor(): MonitorApi {\n    const internals = containerOf(this);\n    return {\n      start: async (options = {}) =>\n        internals.monitor().start({\n          ...options,\n          signal: workerSignal(internals.runtime, options.signal),\n        }),\n      runOnce: async (options = {}) =>\n        internals.monitor().runOnce({\n          workerId: options.workerId ?? internals.runtime.owner,\n          ...(options.batch !== undefined ? { batch: options.batch } : {}),\n          signal: workerSignal(internals.runtime, options.signal),\n        }),\n    };\n  }\n\n  /**\n   * Closes the root container: runs the `close` of every native client that\n   * `crypto-aio/native` handed out (a failing one is logged by code and skipped), then\n   * closes the pooled drivers. Its handles and `native()` then fail with\n   * `INVALID_TRANSITION`. A scope's `close()` does nothing; scopes share their root's pool.\n   */\n  async close(): Promise<void> {\n    const internals = containerOf(this);\n    if (!internals.isRoot) return;\n    const { runtime } = internals;\n    runtime.closed = true;\n    // Every worker loop, pass and recovery stops at its next check, and its sleeps end.\n    runtime.closing.abort();\n    const natives = [...runtime.natives];\n    runtime.natives.clear();\n    await Promise.all(\n      natives.map(async (close) => {\n        try {\n          const outcome = await closeWithin(\n            close,\n            runtime.clock,\n            NATIVE_CLOSE_TIMEOUT_MS,\n          );\n          if (outcome === 'timeout') {\n            runtime.log.warn('native client close timed out', {\n              timeoutMs: NATIVE_CLOSE_TIMEOUT_MS,\n            });\n          }\n        } catch (error) {\n          runtime.log.warn('native client close failed', { code: errorCode(error) });\n        }\n      }),\n    );\n    await runtime.pool.close();\n  }\n\n  #bind(runtime: RootRuntime, layers: readonly ScopeOptions[], isRoot: boolean): void {\n    const effective = () => mergeScopes([runtime.envLayer, ...layers]);\n    let engine: OperationEngine | undefined;\n    let monitor: Monitor | undefined;\n    const getEngine = () => (engine ??= createEngine(runtime, effective));\n    const wallets = walletCache(runtime, () => containerOf(this));\n    bindContainer(this, {\n      runtime,\n      layers,\n      isRoot,\n      effective,\n      signerDeadline: () => ({\n        clock: runtime.clock,\n        timeoutMs: withLifecycleDefaults(effective().lifecycle).signTimeoutMs,\n      }),\n      engine: getEngine,\n      monitor: () =>\n        (monitor ??= new Monitor({\n          engine: getEngine(),\n          stores: runtime.stores,\n          events: runtime.events,\n          clock: runtime.clock,\n          log: runtime.log.child('monitor'),\n          namespace: runtime.namespace,\n          lifecycle: () => withLifecycleDefaults(effective().lifecycle),\n          resolveRead: (record) => readTarget(this, record),\n          resolveTarget: (record) => operationTarget(this, runtime, record, wallets),\n        })),\n    });\n  }\n}\n"]}

package/dist/core/container/default.d.ts

@@ -0,0 +1,15 @@
+import type { AioOptions } from '../config/types';
+import { CryptoAio } from './container';
+/** The container behind `Blockchain.create`. Prefer explicit containers for multi-tenant use. */
+export declare function defaultContainer(): CryptoAio;
+/**
+ * Merges options into the default container. Existing handles keep their frozen config; the
+ * stores are carried over key by key (not wholesale) so Operations stay visible even across
+ * a `configure()` call that names only some of them. Intended for application startup.
+ *
+ * Each call starts a new generation of the default container (a new event bus, owner id and
+ * driver pool); it never closes the previous one.
+ */
+export declare function configure(options: AioOptions): CryptoAio;
+/** Forgets the default container (tests). */
+export declare function resetDefaultContainer(): void;

package/dist/core/container/default.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultContainer = defaultContainer;
+exports.configure = configure;
+exports.resetDefaultContainer = resetDefaultContainer;
+const default_ref_1 = require("../blockchain/default-ref");
+const merge_1 = require("../config/merge");
+const container_1 = require("./container");
+const internals_1 = require("./internals");
+let instance;
+let accumulated = {};
+/** Merges an options object field by field, by the same rules as a named map. */
+function perField(base, next) {
+    return (0, merge_1.byReference)(base, next);
+}
+/**
+ * The same rules as scopes: `undefined` never overrides, and no
+ * `__proto__`, `constructor` or `prototype` key is copied into a map.
+ */
+function mergeAioOptions(base, next) {
+    const chains = (0, merge_1.byReference)(base.chains, undefined);
+    for (const [id, defaults] of Object.entries(next.chains ?? {})) {
+        if (defaults === undefined || (0, merge_1.isUnsafeKey)(id))
+            continue;
+        chains[id] = (0, merge_1.mergeChainDefaults)(Object.hasOwn(chains, id) ? chains[id] : undefined, defaults);
+    }
+    const defined = Object.fromEntries(Object.entries(next).filter(([, value]) => value !== undefined));
+    return {
+        ...base,
+        ...defined,
+        chains,
+        providers: (0, merge_1.byReference)(base.providers, next.providers),
+        signers: (0, merge_1.byReference)(base.signers, next.signers),
+        wallets: (0, merge_1.byReference)(base.wallets, next.wallets),
+        hooks: perField(base.hooks, next.hooks),
+        lifecycle: perField(base.lifecycle, next.lifecycle),
+        transport: perField(base.transport, next.transport),
+        plugins: [...(base.plugins ?? []), ...(next.plugins ?? [])],
+    };
+}
+/** The container behind `Blockchain.create`. Prefer explicit containers for multi-tenant use. */
+function defaultContainer() {
+    instance ??= new container_1.CryptoAio(accumulated);
+    return instance;
+}
+function definedStores(stores) {
+    return Object.fromEntries(Object.entries(stores ?? {}).filter(([, store]) => store !== undefined));
+}
+/**
+ * Merges options into the default container. Existing handles keep their frozen config; the
+ * stores are carried over key by key (not wholesale) so Operations stay visible even across
+ * a `configure()` call that names only some of them. Intended for application startup.
+ *
+ * Each call starts a new generation of the default container (a new event bus, owner id and
+ * driver pool); it never closes the previous one.
+ */
+function configure(options) {
+    const previousStores = instance ? (0, internals_1.containerOf)(instance).runtime.stores : undefined;
+    const stores = { ...previousStores, ...definedStores(options.stores) };
+    accumulated = mergeAioOptions(accumulated, options);
+    instance = new container_1.CryptoAio({ ...accumulated, stores });
+    return instance;
+}
+/** Forgets the default container (tests). */
+function resetDefaultContainer() {
+    instance = undefined;
+    accumulated = {};
+}
+(0, default_ref_1.setDefaultBlockchainFactory)((config) => defaultContainer().blockchain(config));
+//# sourceMappingURL=default.js.map

package/dist/core/container/default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.js","sourceRoot":"","sources":["../../../src/core/container/default.ts"],"names":[],"mappings":"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","sourcesContent":["import { setDefaultBlockchainFactory } from '../blockchain/default-ref';\nimport { byReference, isUnsafeKey, mergeChainDefaults } from '../config/merge';\nimport type { AioOptions, ChainDefaults, HandleOptions } from '../config/types';\nimport type { Stores } from '../store/types';\nimport { CryptoAio } from './container';\nimport { containerOf } from './internals';\n\nlet instance: CryptoAio | undefined;\nlet accumulated: AioOptions = {};\n\n/** Merges an options object field by field, by the same rules as a named map. */\nfunction perField<T extends object>(base: T | undefined, next: T | undefined): T {\n  type Fields = Readonly<Record<string, unknown>>;\n  return byReference(base as Fields | undefined, next as Fields | undefined) as T;\n}\n\n/**\n * The same rules as scopes: `undefined` never overrides, and no\n * `__proto__`, `constructor` or `prototype` key is copied into a map.\n */\nfunction mergeAioOptions(base: AioOptions, next: AioOptions): AioOptions {\n  const chains: Record<string, ChainDefaults> = byReference(base.chains, undefined);\n  for (const [id, defaults] of Object.entries(next.chains ?? {})) {\n    if (defaults === undefined || isUnsafeKey(id)) continue;\n    chains[id] = mergeChainDefaults(\n      Object.hasOwn(chains, id) ? chains[id] : undefined,\n      defaults,\n    );\n  }\n  const defined = Object.fromEntries(\n    Object.entries(next).filter(([, value]) => value !== undefined),\n  ) as AioOptions;\n  return {\n    ...base,\n    ...defined,\n    chains,\n    providers: byReference(base.providers, next.providers),\n    signers: byReference(base.signers, next.signers),\n    wallets: byReference(base.wallets, next.wallets),\n    hooks: perField(base.hooks, next.hooks),\n    lifecycle: perField(base.lifecycle, next.lifecycle),\n    transport: perField(base.transport, next.transport),\n    plugins: [...(base.plugins ?? []), ...(next.plugins ?? [])],\n  };\n}\n\n/** The container behind `Blockchain.create`. Prefer explicit containers for multi-tenant use. */\nexport function defaultContainer(): CryptoAio {\n  instance ??= new CryptoAio(accumulated);\n  return instance;\n}\n\nfunction definedStores(stores: Partial<Stores> | undefined): Partial<Stores> {\n  return Object.fromEntries(\n    Object.entries(stores ?? {}).filter(([, store]) => store !== undefined),\n  ) as Partial<Stores>;\n}\n\n/**\n * Merges options into the default container. Existing handles keep their frozen config; the\n * stores are carried over key by key (not wholesale) so Operations stay visible even across\n * a `configure()` call that names only some of them. Intended for application startup.\n *\n * Each call starts a new generation of the default container (a new event bus, owner id and\n * driver pool); it never closes the previous one.\n */\nexport function configure(options: AioOptions): CryptoAio {\n  const previousStores = instance ? containerOf(instance).runtime.stores : undefined;\n  const stores: Partial<Stores> = { ...previousStores, ...definedStores(options.stores) };\n  accumulated = mergeAioOptions(accumulated, options);\n  instance = new CryptoAio({ ...accumulated, stores });\n  return instance;\n}\n\n/** Forgets the default container (tests). */\nexport function resetDefaultContainer(): void {\n  instance = undefined;\n  accumulated = {};\n}\n\nsetDefaultBlockchainFactory((config: HandleOptions) =>\n  defaultContainer().blockchain(config as never),\n);\n"]}