crypto-aio 0.0.3 → 0.1.0

package/dist/core/config/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../../src/core/config/merge.ts"],"names":[],"mappings":"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","sourcesContent":["import { ConfigError } from '../errors/error';\nimport type { Signer } from '../signing/types';\nimport type {\n  ChainDefaults,\n  EffectiveOptions,\n  Hooks,\n  LifecycleOptions,\n  ProviderConfig,\n  ScopeOptions,\n  WalletConfig,\n} from './types';\n\n/** Keys that can repoint an object's prototype chain; a merge never copies these. */\nconst UNSAFE_KEYS = new Set(['__proto__', 'constructor', 'prototype']);\n\n/** Whether a merge must skip `key` (`__proto__`, `constructor` or `prototype`). */\nexport function isUnsafeKey(key: string): boolean {\n  return UNSAFE_KEYS.has(key);\n}\n\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (value === null || typeof value !== 'object') return false;\n  const proto: unknown = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n}\n\n/**\n * Config is plain data, so a plain object or array that contains itself is a mistake;\n * it is refused at startup instead of overflowing the stack. `ancestors` holds the path\n * being copied, so one object shared by two branches is still copied, once per branch.\n */\nexport function assertNoCycle(value: object, ancestors: ReadonlySet<object>): void {\n  if (ancestors.has(value)) {\n    throw new ConfigError('CONFIG_INVALID', 'the configuration holds a reference cycle');\n  }\n}\n\n/**\n * Deep-clones plain objects and arrays so a merge result never aliases the caller's input.\n * Class instances (Signer, Secret, ...) and other non-plain values keep their identity.\n */\nfunction cloneValue(value: unknown, ancestors: Set<object> = new Set()): unknown {\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 value.map((item: unknown) => cloneValue(item, ancestors));\n    const out: Record<string, unknown> = {};\n    for (const [key, v] of Object.entries(value)) {\n      if (UNSAFE_KEYS.has(key)) continue;\n      out[key] = cloneValue(v, ancestors);\n    }\n    return out;\n  } finally {\n    ancestors.delete(value);\n  }\n}\n\n/**\n * Recursive merge of plain objects; arrays, class instances and Secrets are atomic (cloned\n * whole, never merged element by element). Skips `__proto__`/`constructor`/`prototype` keys.\n */\nexport function deepMerge(\n  base: Readonly<Record<string, unknown>> | undefined,\n  over: Readonly<Record<string, unknown>> | undefined,\n): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(base ?? {})) {\n    if (UNSAFE_KEYS.has(key)) continue;\n    out[key] = cloneValue(value);\n  }\n  for (const [key, value] of Object.entries(over ?? {})) {\n    if (value === undefined || UNSAFE_KEYS.has(key)) continue;\n    const current = out[key];\n    out[key] =\n      isPlainObject(current) && isPlainObject(value)\n        ? deepMerge(current, value)\n        : cloneValue(value);\n  }\n  return out;\n}\n\n/**\n * Shallow merge where `undefined` never overrides. Values are cloned (see `cloneValue`) so a\n * named-map entry replaced whole never aliases the caller's input; class instances keep their\n * identity (`signers` never goes through here — see `byReference`). Skips `__proto__`/`constructor`/`prototype` keys.\n */\nfunction shallow<T extends object>(base: T | undefined, over: T | undefined): T {\n  const out: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(base ?? {})) {\n    if (UNSAFE_KEYS.has(key)) continue;\n    out[key] = cloneValue(value);\n  }\n  for (const [key, value] of Object.entries(over ?? {})) {\n    if (value === undefined || UNSAFE_KEYS.has(key)) continue;\n    out[key] = cloneValue(value);\n  }\n  return out as T;\n}\n\n/**\n * Merges a map of opaque values by name, taking every value by reference (never cloned). Used\n * for `signers`: `Signer` is an interface, so a plain-object signer is legitimate and must keep\n * its identity and its own-property state. `undefined` never overrides. Skips\n * `__proto__`/`constructor`/`prototype` keys.\n */\nexport function byReference<T>(\n  base: Readonly<Record<string, T>> | undefined,\n  over: Readonly<Record<string, T>> | undefined,\n): Record<string, T> {\n  const out: Record<string, T> = {};\n  for (const layer of [base ?? {}, over ?? {}]) {\n    for (const [key, value] of Object.entries(layer)) {\n      if (value !== undefined && !UNSAFE_KEYS.has(key)) out[key] = value;\n    }\n  }\n  return out;\n}\n\n/** Chain defaults: fields are atomic (provider lists are replaced), `options` deep-merges. */\nexport function mergeChainDefaults(\n  base: ChainDefaults | undefined,\n  over: ChainDefaults | undefined,\n): ChainDefaults {\n  const merged = shallow(base, over);\n  const options = deepMerge(base?.options, over?.options);\n  return Object.keys(options).length > 0 ? { ...merged, options } : merged;\n}\n\n/** Merges configuration layers from least to most specific. */\nexport function mergeScopes(\n  layers: readonly (ScopeOptions | undefined)[],\n): EffectiveOptions {\n  const chains: Record<string, ChainDefaults> = {};\n  let providers: Readonly<Record<string, ProviderConfig>> = {};\n  let signers: Readonly<Record<string, Signer>> = {};\n  let wallets: Readonly<Record<string, WalletConfig>> = {};\n  let hooks: Hooks = {};\n  let lifecycle: LifecycleOptions = {};\n  for (const layer of layers) {\n    if (!layer) continue;\n    for (const [id, defaults] of Object.entries(layer.chains ?? {})) {\n      if (UNSAFE_KEYS.has(id)) continue;\n      chains[id] = mergeChainDefaults(chains[id], defaults);\n    }\n    providers = shallow(providers, layer.providers);\n    signers = byReference(signers, layer.signers);\n    wallets = shallow(wallets, layer.wallets);\n    hooks = shallow(hooks, layer.hooks);\n    lifecycle = shallow(lifecycle, layer.lifecycle);\n  }\n  return { chains, providers, signers, wallets, hooks, lifecycle };\n}\n"]}

package/dist/core/config/resolve.d.ts

@@ -0,0 +1,12 @@
+import type { Logger } from '../events/logger';
+import type { Catalogs } from '../registry/plugin';
+import type { EffectiveOptions, HandleOptions, ResolvedSelection } from './types';
+export interface ResolveInput {
+    readonly handle: HandleOptions;
+    readonly effective: EffectiveOptions;
+    readonly catalogs: Catalogs;
+    readonly log?: Logger;
+}
+export declare function resolveSelection(input: ResolveInput): ResolvedSelection;
+/** Redacted, JSON-friendly snapshot for `Blockchain.config`. */
+export declare function describeSelection(selection: ResolvedSelection): Readonly<Record<string, unknown>>;

package/dist/core/config/resolve.js

@@ -0,0 +1,251 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSelection = resolveSelection;
+exports.describeSelection = describeSelection;
+const error_1 = require("../errors/error");
+const redact_1 = require("../secret/redact");
+const secret_1 = require("../secret/secret");
+const guard_1 = require("../signing/guard");
+const freeze_1 = require("../util/freeze");
+const json_1 = require("../util/json");
+const names_1 = require("../util/names");
+const merge_1 = require("./merge");
+function toList(value) {
+    if (value === undefined)
+        return [];
+    return Array.isArray(value)
+        ? value
+        : [value];
+}
+/** Own-key lookup in a named map, so an inherited name (`constructor`, `toString`,
+ * `__proto__`, ...) is unknown rather than resolving to an `Object.prototype` member. */
+function own(map, name) {
+    return Object.hasOwn(map, name) ? map[name] : undefined;
+}
+function inlineName(config) {
+    return `inline:${(0, json_1.sha256Hex)((0, json_1.canonicalJson)(config)).slice(0, 8)}`;
+}
+/** Hash input for credentials: revealed values never leave this function. */
+function fingerprint(providers) {
+    return (0, json_1.sha256Hex)((0, json_1.canonicalJson)(providers.map((p) => p.endpoints.map((e) => ({
+        name: e.name ?? null,
+        kind: e.kind ?? 'rpc',
+        url: (0, secret_1.reveal)(e.url),
+        headers: Object.fromEntries(Object.entries(e.headers ?? {}).map(([k, v]) => [k, (0, secret_1.reveal)(v)])),
+        priority: e.priority ?? 0,
+        rateLimit: e.rateLimit ?? null,
+        timeoutMs: e.timeoutMs ?? null,
+    })))));
+}
+function resolveProviders(refs, kind, chain, network, effective, catalogs) {
+    return refs.map((ref) => {
+        let name;
+        let config;
+        if (typeof ref === 'string') {
+            name = ref;
+            const configured = own(effective.providers, ref);
+            if (configured)
+                config = configured;
+            else if (catalogs.presets.has(ref, kind))
+                config = { preset: ref };
+            else {
+                throw new error_1.ConfigError('CONFIG_INVALID', (0, names_1.unknownName)(`${kind} provider`, [
+                    ...Object.keys(effective.providers),
+                    ...catalogs.presets.names(kind),
+                ]));
+            }
+        }
+        else {
+            name = inlineName(ref);
+            config = ref;
+        }
+        let endpoints;
+        let production = true;
+        if ('endpoints' in config) {
+            endpoints = config.endpoints;
+        }
+        else {
+            const resolved = catalogs.presets.resolve(config.preset, {
+                chain: chain.id,
+                network: network.id,
+                ...(config.apiKey !== undefined ? { apiKey: config.apiKey } : {}),
+                ...(config.options !== undefined ? { options: config.options } : {}),
+            }, kind);
+            endpoints = resolved.endpoints;
+            production = resolved.preset.production !== false;
+        }
+        if (endpoints.length === 0)
+            throw new error_1.ConfigError('CONFIG_INVALID', `provider '${name}' has no endpoints`);
+        return {
+            name,
+            production,
+            endpoints: endpoints.map((endpoint, index) => {
+                if ((endpoint.kind ?? kind) !== kind) {
+                    throw new error_1.ConfigError('CONFIG_INVALID', `provider '${name}' has a ${endpoint.kind} endpoint where ${kind} is required`);
+                }
+                return { ...endpoint, kind, name: `${name}/${endpoint.name ?? index}` };
+            }),
+        };
+    });
+}
+function fallbackToPublic(kind, chain, network, effective, catalogs, log) {
+    if (!catalogs.presets.has('public', kind))
+        return [];
+    try {
+        const resolved = resolveProviders(['public'], kind, chain, network, effective, catalogs);
+        log?.warn(`no ${kind} provider configured; using the public provider (not for production)`, {
+            chain: chain.id,
+            network: network.id,
+        });
+        return resolved;
+    }
+    catch {
+        return [];
+    }
+}
+function resolveSelection(input) {
+    const { catalogs, effective, log } = input;
+    const chain = catalogs.chains.get(input.handle.chain);
+    const { chain: _chainId, ...handleRest } = input.handle;
+    const merged = (0, merge_1.mergeChainDefaults)(effective.chains[chain.id], handleRest);
+    const network = catalogs.chains.network(chain.id, merged.network ?? chain.defaultNetwork);
+    const manifests = catalogs.adapters.forChain(chain.id);
+    const defaultManifest = manifests[0];
+    if (!defaultManifest) {
+        throw new error_1.ConfigError('CONFIG_INVALID', `no adapter is registered for chain '${chain.id}'; register its plugin`);
+    }
+    const library = merged.library ?? defaultManifest.library;
+    const manifest = catalogs.adapters.get(chain.id, library);
+    if (!manifest) {
+        throw new error_1.ConfigError('INCOMPATIBLE_SELECTION', (0, names_1.unknownName)(`library for chain '${chain.id}'`, manifests.map((m) => m.library)));
+    }
+    let providers = resolveProviders(toList(merged.provider), 'rpc', chain, network, effective, catalogs);
+    if (providers.length === 0)
+        providers = fallbackToPublic('rpc', chain, network, effective, catalogs, log);
+    if (providers.length === 0) {
+        throw new error_1.ConfigError('CONFIG_INVALID', `no provider configured for ${chain.id}:${network.id}`);
+    }
+    let indexers = resolveProviders(toList(merged.indexer), 'indexer', chain, network, effective, catalogs);
+    if (indexers.length === 0 && manifest.requiresIndexer) {
+        indexers = fallbackToPublic('indexer', chain, network, effective, catalogs, log);
+    }
+    if (indexers.length === 0 && manifest.requiresIndexer) {
+        throw new error_1.ConfigError('CONFIG_INVALID', `library '${library}' requires an indexer provider for ${chain.id}:${network.id}`);
+    }
+    let wallet;
+    if (merged.wallet !== undefined) {
+        const config = own(effective.wallets, merged.wallet);
+        if (!config) {
+            throw new error_1.ConfigError('CONFIG_INVALID', (0, names_1.unknownName)('wallet', Object.keys(effective.wallets)));
+        }
+        if (config.chains && !config.chains.includes(chain.id)) {
+            throw new error_1.ConfigError('CONFIG_INVALID', `wallet '${merged.wallet}' is not enabled for chain '${chain.id}'`);
+        }
+        for (const signerId of Object.values(config.signers ?? {})) {
+            if (!own(effective.signers, signerId)) {
+                throw new error_1.ConfigError('CONFIG_INVALID', (0, names_1.unknownName)('signer', Object.keys(effective.signers)));
+            }
+        }
+        wallet = { name: merged.wallet, config };
+    }
+    let signer;
+    const signerId = merged.signer ?? wallet?.config.signer;
+    if (signerId !== undefined) {
+        const instance = own(effective.signers, signerId);
+        if (!instance) {
+            throw new error_1.ConfigError('CONFIG_INVALID', (0, names_1.unknownName)('signer', Object.keys(effective.signers)));
+        }
+        // `Signer` is an interface, so its scheme list is read once and checked.
+        const schemes = (0, guard_1.signerSchemes)(signerId, instance);
+        if (!chain.schemes.some((scheme) => schemes.includes(scheme))) {
+            throw new error_1.ConfigError('CONFIG_INVALID', `signer '${signerId}' supports ${schemes.join(', ')} but chain '${chain.id}' needs one of ${chain.schemes.join(', ')}`);
+        }
+        signer = { id: signerId, instance };
+    }
+    const capabilities = new Set(manifest.capabilities);
+    if (indexers.length > 0)
+        for (const c of manifest.indexerCapabilities ?? [])
+            capabilities.add(c);
+    for (const c of network.capabilities?.add ?? [])
+        capabilities.add(c);
+    for (const c of network.capabilities?.remove ?? [])
+        capabilities.delete(c);
+    const confirmations = merged.confirmations ?? network.defaultConfirmations;
+    if (!Number.isInteger(confirmations) || confirmations < 1) {
+        throw new error_1.ConfigError('CONFIG_INVALID', 'confirmations must be a positive integer');
+    }
+    const { maxLagBlocks } = merged;
+    if (maxLagBlocks !== undefined &&
+        (!Number.isSafeInteger(maxLagBlocks) || maxLagBlocks < 0)) {
+        throw new error_1.ConfigError('CONFIG_INVALID', 'maxLagBlocks must be a non-negative integer');
+    }
+    const options = (0, freeze_1.deepFreeze)(merged.options ?? {});
+    const providerNames = providers.map((p) => p.name);
+    const indexerNames = indexers.map((p) => p.name);
+    const poolKey = (0, json_1.sha256Hex)((0, json_1.canonicalJson)({
+        chain: chain.id,
+        network: network.id,
+        library,
+        rpc: fingerprint(providers),
+        idx: fingerprint(indexers),
+        options,
+        // The transport's lag tolerance depends on it; omitted when unset.
+        maxLagBlocks,
+    }));
+    const configHash = (0, json_1.sha256Hex)((0, json_1.canonicalJson)({
+        chain: chain.id,
+        network: network.id,
+        library,
+        providers: providerNames,
+        indexers: indexerNames,
+        wallet: wallet?.name ?? null,
+        signer: signer?.id ?? null,
+        options,
+        confirmations,
+    }));
+    return Object.freeze({
+        chain,
+        network,
+        library,
+        manifest,
+        providers: (0, freeze_1.deepFreeze)(providers),
+        indexers: (0, freeze_1.deepFreeze)(indexers),
+        ...(wallet ? { wallet } : {}),
+        ...(signer ? { signer } : {}),
+        options,
+        confirmations,
+        ...(maxLagBlocks !== undefined ? { maxLagBlocks } : {}),
+        capabilities,
+        providerNames,
+        indexerNames,
+        poolKey,
+        configHash,
+        handle: { ...handleRest, chain: chain.id, network: network.id, library },
+    });
+}
+/** Redacted, JSON-friendly snapshot for `Blockchain.config`. */
+function describeSelection(selection) {
+    const describeProvider = (p) => ({
+        name: p.name,
+        production: p.production,
+        endpoints: p.endpoints.map((e) => ({
+            name: e.name,
+            kind: e.kind,
+            url: (0, redact_1.redactUrl)(e.url),
+            headers: (0, redact_1.redactHeaders)(e.headers),
+        })),
+    });
+    return Object.freeze({
+        chain: selection.chain.id,
+        network: selection.network.id,
+        library: selection.library,
+        providers: selection.providers.map(describeProvider),
+        indexers: selection.indexers.map(describeProvider),
+        wallet: selection.wallet?.name ?? null,
+        signer: selection.signer?.id ?? null,
+        capabilities: [...selection.capabilities].sort(),
+        confirmations: selection.confirmations,
+        options: (0, redact_1.redactDeep)(selection.options),
+    });
+}
+//# sourceMappingURL=resolve.js.map

package/dist/core/config/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/core/config/resolve.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AdapterManifest } from '../driver/types';\nimport { ConfigError } from '../errors/error';\nimport type { Logger } from '../events/logger';\nimport type { Capability } from '../model/capability';\nimport type { ChainInfo, NetworkInfo } from '../model/chain';\nimport type { Catalogs } from '../registry/plugin';\nimport { redactDeep, redactHeaders, redactUrl } from '../secret/redact';\nimport { reveal } from '../secret/secret';\nimport { signerSchemes } from '../signing/guard';\nimport type { EndpointConfig } from '../transport/types';\nimport { deepFreeze } from '../util/freeze';\nimport { canonicalJson, sha256Hex } from '../util/json';\nimport { unknownName } from '../util/names';\nimport { mergeChainDefaults } from './merge';\nimport type {\n  EffectiveOptions,\n  HandleOptions,\n  ProviderConfig,\n  ProviderRef,\n  ResolvedProvider,\n  ResolvedSelection,\n} from './types';\n\nexport interface ResolveInput {\n  readonly handle: HandleOptions;\n  readonly effective: EffectiveOptions;\n  readonly catalogs: Catalogs;\n  readonly log?: Logger;\n}\n\nfunction toList(\n  value: ProviderRef | readonly ProviderRef[] | undefined,\n): readonly ProviderRef[] {\n  if (value === undefined) return [];\n  return Array.isArray(value)\n    ? (value as readonly ProviderRef[])\n    : [value as ProviderRef];\n}\n\n/** Own-key lookup in a named map, so an inherited name (`constructor`, `toString`,\n * `__proto__`, ...) is unknown rather than resolving to an `Object.prototype` member. */\nfunction own<T>(map: Readonly<Record<string, T>>, name: string): T | undefined {\n  return Object.hasOwn(map, name) ? map[name] : undefined;\n}\n\nfunction inlineName(config: ProviderConfig): string {\n  return `inline:${sha256Hex(canonicalJson(config)).slice(0, 8)}`;\n}\n\n/** Hash input for credentials: revealed values never leave this function. */\nfunction fingerprint(providers: readonly ResolvedProvider[]): string {\n  return sha256Hex(\n    canonicalJson(\n      providers.map((p) =>\n        p.endpoints.map((e) => ({\n          name: e.name ?? null,\n          kind: e.kind ?? 'rpc',\n          url: reveal(e.url),\n          headers: Object.fromEntries(\n            Object.entries(e.headers ?? {}).map(([k, v]) => [k, reveal(v)]),\n          ),\n          priority: e.priority ?? 0,\n          rateLimit: e.rateLimit ?? null,\n          timeoutMs: e.timeoutMs ?? null,\n        })),\n      ),\n    ),\n  );\n}\n\nfunction resolveProviders(\n  refs: readonly ProviderRef[],\n  kind: 'rpc' | 'indexer',\n  chain: ChainInfo,\n  network: NetworkInfo,\n  effective: EffectiveOptions,\n  catalogs: Catalogs,\n): ResolvedProvider[] {\n  return refs.map((ref) => {\n    let name: string;\n    let config: ProviderConfig;\n    if (typeof ref === 'string') {\n      name = ref;\n      const configured = own(effective.providers, ref);\n      if (configured) config = configured;\n      else if (catalogs.presets.has(ref, kind)) config = { preset: ref };\n      else {\n        throw new ConfigError(\n          'CONFIG_INVALID',\n          unknownName(`${kind} provider`, [\n            ...Object.keys(effective.providers),\n            ...catalogs.presets.names(kind),\n          ]),\n        );\n      }\n    } else {\n      name = inlineName(ref);\n      config = ref;\n    }\n    let endpoints: readonly EndpointConfig[];\n    let production = true;\n    if ('endpoints' in config) {\n      endpoints = config.endpoints;\n    } else {\n      const resolved = catalogs.presets.resolve(\n        config.preset,\n        {\n          chain: chain.id,\n          network: network.id,\n          ...(config.apiKey !== undefined ? { apiKey: config.apiKey } : {}),\n          ...(config.options !== undefined ? { options: config.options } : {}),\n        },\n        kind,\n      );\n      endpoints = resolved.endpoints;\n      production = resolved.preset.production !== false;\n    }\n    if (endpoints.length === 0)\n      throw new ConfigError('CONFIG_INVALID', `provider '${name}' has no endpoints`);\n    return {\n      name,\n      production,\n      endpoints: endpoints.map((endpoint, index) => {\n        if ((endpoint.kind ?? kind) !== kind) {\n          throw new ConfigError(\n            'CONFIG_INVALID',\n            `provider '${name}' has a ${endpoint.kind} endpoint where ${kind} is required`,\n          );\n        }\n        return { ...endpoint, kind, name: `${name}/${endpoint.name ?? index}` };\n      }),\n    };\n  });\n}\n\nfunction fallbackToPublic(\n  kind: 'rpc' | 'indexer',\n  chain: ChainInfo,\n  network: NetworkInfo,\n  effective: EffectiveOptions,\n  catalogs: Catalogs,\n  log: Logger | undefined,\n): ResolvedProvider[] {\n  if (!catalogs.presets.has('public', kind)) return [];\n  try {\n    const resolved = resolveProviders(\n      ['public'],\n      kind,\n      chain,\n      network,\n      effective,\n      catalogs,\n    );\n    log?.warn(\n      `no ${kind} provider configured; using the public provider (not for production)`,\n      {\n        chain: chain.id,\n        network: network.id,\n      },\n    );\n    return resolved;\n  } catch {\n    return [];\n  }\n}\n\nexport function resolveSelection(input: ResolveInput): ResolvedSelection {\n  const { catalogs, effective, log } = input;\n  const chain = catalogs.chains.get(input.handle.chain);\n  const { chain: _chainId, ...handleRest } = input.handle;\n  const merged = mergeChainDefaults(effective.chains[chain.id], handleRest);\n  const network = catalogs.chains.network(\n    chain.id,\n    merged.network ?? chain.defaultNetwork,\n  );\n\n  const manifests = catalogs.adapters.forChain(chain.id);\n  const defaultManifest = manifests[0];\n  if (!defaultManifest) {\n    throw new ConfigError(\n      'CONFIG_INVALID',\n      `no adapter is registered for chain '${chain.id}'; register its plugin`,\n    );\n  }\n  const library = merged.library ?? defaultManifest.library;\n  const manifest: AdapterManifest | undefined = catalogs.adapters.get(chain.id, library);\n  if (!manifest) {\n    throw new ConfigError(\n      'INCOMPATIBLE_SELECTION',\n      unknownName(\n        `library for chain '${chain.id}'`,\n        manifests.map((m) => m.library),\n      ),\n    );\n  }\n\n  let providers = resolveProviders(\n    toList(merged.provider),\n    'rpc',\n    chain,\n    network,\n    effective,\n    catalogs,\n  );\n  if (providers.length === 0)\n    providers = fallbackToPublic('rpc', chain, network, effective, catalogs, log);\n  if (providers.length === 0) {\n    throw new ConfigError(\n      'CONFIG_INVALID',\n      `no provider configured for ${chain.id}:${network.id}`,\n    );\n  }\n  let indexers = resolveProviders(\n    toList(merged.indexer),\n    'indexer',\n    chain,\n    network,\n    effective,\n    catalogs,\n  );\n  if (indexers.length === 0 && manifest.requiresIndexer) {\n    indexers = fallbackToPublic('indexer', chain, network, effective, catalogs, log);\n  }\n  if (indexers.length === 0 && manifest.requiresIndexer) {\n    throw new ConfigError(\n      'CONFIG_INVALID',\n      `library '${library}' requires an indexer provider for ${chain.id}:${network.id}`,\n    );\n  }\n\n  let wallet: ResolvedSelection['wallet'];\n  if (merged.wallet !== undefined) {\n    const config = own(effective.wallets, merged.wallet);\n    if (!config) {\n      throw new ConfigError(\n        'CONFIG_INVALID',\n        unknownName('wallet', Object.keys(effective.wallets)),\n      );\n    }\n    if (config.chains && !config.chains.includes(chain.id)) {\n      throw new ConfigError(\n        'CONFIG_INVALID',\n        `wallet '${merged.wallet}' is not enabled for chain '${chain.id}'`,\n      );\n    }\n    for (const signerId of Object.values(config.signers ?? {})) {\n      if (!own(effective.signers, signerId)) {\n        throw new ConfigError(\n          'CONFIG_INVALID',\n          unknownName('signer', Object.keys(effective.signers)),\n        );\n      }\n    }\n    wallet = { name: merged.wallet, config };\n  }\n\n  let signer: ResolvedSelection['signer'];\n  const signerId = merged.signer ?? wallet?.config.signer;\n  if (signerId !== undefined) {\n    const instance = own(effective.signers, signerId);\n    if (!instance) {\n      throw new ConfigError(\n        'CONFIG_INVALID',\n        unknownName('signer', Object.keys(effective.signers)),\n      );\n    }\n    // `Signer` is an interface, so its scheme list is read once and checked.\n    const schemes = signerSchemes(signerId, instance);\n    if (!chain.schemes.some((scheme) => schemes.includes(scheme))) {\n      throw new ConfigError(\n        'CONFIG_INVALID',\n        `signer '${signerId}' supports ${schemes.join(', ')} but chain '${chain.id}' needs one of ${chain.schemes.join(', ')}`,\n      );\n    }\n    signer = { id: signerId, instance };\n  }\n\n  const capabilities = new Set<Capability>(manifest.capabilities);\n  if (indexers.length > 0)\n    for (const c of manifest.indexerCapabilities ?? []) capabilities.add(c);\n  for (const c of network.capabilities?.add ?? []) capabilities.add(c);\n  for (const c of network.capabilities?.remove ?? []) capabilities.delete(c);\n\n  const confirmations = merged.confirmations ?? network.defaultConfirmations;\n  if (!Number.isInteger(confirmations) || confirmations < 1) {\n    throw new ConfigError('CONFIG_INVALID', 'confirmations must be a positive integer');\n  }\n  const { maxLagBlocks } = merged;\n  if (\n    maxLagBlocks !== undefined &&\n    (!Number.isSafeInteger(maxLagBlocks) || maxLagBlocks < 0)\n  ) {\n    throw new ConfigError(\n      'CONFIG_INVALID',\n      'maxLagBlocks must be a non-negative integer',\n    );\n  }\n  const options = deepFreeze(merged.options ?? {});\n  const providerNames = providers.map((p) => p.name);\n  const indexerNames = indexers.map((p) => p.name);\n  const poolKey = sha256Hex(\n    canonicalJson({\n      chain: chain.id,\n      network: network.id,\n      library,\n      rpc: fingerprint(providers),\n      idx: fingerprint(indexers),\n      options,\n      // The transport's lag tolerance depends on it; omitted when unset.\n      maxLagBlocks,\n    }),\n  );\n  const configHash = sha256Hex(\n    canonicalJson({\n      chain: chain.id,\n      network: network.id,\n      library,\n      providers: providerNames,\n      indexers: indexerNames,\n      wallet: wallet?.name ?? null,\n      signer: signer?.id ?? null,\n      options,\n      confirmations,\n    }),\n  );\n  return Object.freeze({\n    chain,\n    network,\n    library,\n    manifest,\n    providers: deepFreeze(providers),\n    indexers: deepFreeze(indexers),\n    ...(wallet ? { wallet } : {}),\n    ...(signer ? { signer } : {}),\n    options,\n    confirmations,\n    ...(maxLagBlocks !== undefined ? { maxLagBlocks } : {}),\n    capabilities,\n    providerNames,\n    indexerNames,\n    poolKey,\n    configHash,\n    handle: { ...handleRest, chain: chain.id, network: network.id, library },\n  });\n}\n\n/** Redacted, JSON-friendly snapshot for `Blockchain.config`. */\nexport function describeSelection(\n  selection: ResolvedSelection,\n): Readonly<Record<string, unknown>> {\n  const describeProvider = (p: ResolvedProvider) => ({\n    name: p.name,\n    production: p.production,\n    endpoints: p.endpoints.map((e) => ({\n      name: e.name,\n      kind: e.kind,\n      url: redactUrl(e.url),\n      headers: redactHeaders(e.headers),\n    })),\n  });\n  return Object.freeze({\n    chain: selection.chain.id,\n    network: selection.network.id,\n    library: selection.library,\n    providers: selection.providers.map(describeProvider),\n    indexers: selection.indexers.map(describeProvider),\n    wallet: selection.wallet?.name ?? null,\n    signer: selection.signer?.id ?? null,\n    capabilities: [...selection.capabilities].sort(),\n    confirmations: selection.confirmations,\n    options: redactDeep(selection.options),\n  });\n}\n"]}

package/dist/core/config/types.d.ts

@@ -0,0 +1,165 @@
+import type { AdapterManifest } from '../driver/types';
+import type { Logger } from '../events/logger';
+import type { Capability } from '../model/capability';
+import type { ChainInfo, NetworkInfo } from '../model/chain';
+import type { ChainId, LibraryOf, NetworkOf } from '../model/ids';
+import type { Plugin } from '../registry/plugin';
+import type { Secret } from '../secret/secret';
+import type { ExtendedKeyVersions } from '../signing/hd';
+import type { KeyRef, Signer, SigningContext } from '../signing/types';
+import type { Stores } from '../store/types';
+import type { EndpointConfig, TransportOptions } from '../transport/types';
+import type { Clock } from '../util/clock';
+export type ProviderConfig = {
+    readonly preset: string;
+    readonly apiKey?: string | Secret<string>;
+    readonly options?: Readonly<Record<string, unknown>>;
+} | {
+    readonly endpoints: readonly EndpointConfig[];
+};
+export type ProviderRef = string | ProviderConfig;
+export interface WalletConfig {
+    readonly signer?: string;
+    /** Routes requests to signers by `keyRef.id` (multi-party wallets). */
+    readonly signers?: Readonly<Record<string, string>>;
+    readonly address?: string;
+    /** Hex public key for watch-only wallets that still prepare transactions. */
+    readonly publicKey?: string;
+    readonly xpub?: string;
+    readonly xpubVersions?: ExtendedKeyVersions;
+    /** Child path template relative to the xpub; `{index}` is replaced. Default `0/{index}`. */
+    readonly xpubPath?: string;
+    readonly keyRef?: KeyRef;
+    /** Metadata only (passed to signing context); no built-in behaviour. */
+    readonly tier?: string;
+    readonly chains?: readonly string[];
+    readonly utxo?: Readonly<Record<string, unknown>>;
+    readonly ton?: Readonly<Record<string, unknown>>;
+    readonly options?: Readonly<Record<string, unknown>>;
+}
+export interface ChainDefaults {
+    readonly network?: string;
+    readonly library?: string;
+    readonly provider?: ProviderRef | readonly ProviderRef[];
+    readonly indexer?: ProviderRef | readonly ProviderRef[];
+    readonly wallet?: string;
+    readonly signer?: string;
+    readonly options?: Readonly<Record<string, unknown>>;
+    readonly confirmations?: number;
+    /**
+     * This chain's lag tolerance, in blocks. It wins over the root
+     * `transport.maxLagBlocks`, which wins over the plugin network's own, which wins over
+     * the transport's built-in default. An endpoint further behind the best known height is
+     * lagging, and a monitor or scanner view further behind is stale.
+     */
+    readonly maxLagBlocks?: number;
+}
+export interface LifecycleOptions {
+    readonly pollIntervalMs?: number;
+    readonly droppedGracePeriodMs?: number;
+    readonly rebroadcastIntervalMs?: number;
+    readonly leaseMs?: number;
+    readonly claimLeaseMs?: number;
+    readonly waitTimeoutMs?: number;
+    readonly requireIdempotencyKey?: boolean;
+    readonly broadcastFanout?: number;
+    /**
+     * How long `transfer` and `submitSignatures` wait for the `beforeSign` hook and the
+     * signer(s) (default 120 000 ms). The wallet's address lease is kept alive meanwhile. On
+     * timeout nothing is written: the Operation stays `prepared` with its reservation, and a
+     * repeat asks again. Signers that need longer should answer `pending` with a ticket.
+     */
+    readonly signTimeoutMs?: number;
+}
+export interface Hooks {
+    /**
+     * Throw to veto signing (policy engines, approvals). Runs before every signing request.
+     * It may run more than once per Operation: once per concurrent caller, and again when a
+     * `prepared` Operation is repeated. Make it idempotent; `ctx.operationId` identifies the
+     * Operation. It runs while the wallet's address lease is held, so keep it short. In
+     * `transfer` and `submitSignatures` the lease is kept alive for up to
+     * `lifecycle.signTimeoutMs`; in `prepareTransfer` a hook running longer than
+     * `lifecycle.leaseMs` can lose the lease to another transfer. A veto after that writes
+     * nothing; the Operation stays `prepared` and is vetoed again on its next repeat.
+     */
+    readonly beforeSign?: (ctx: SigningContext) => void | Promise<void>;
+}
+export interface ScopeOptions {
+    readonly chains?: Readonly<Record<string, ChainDefaults>>;
+    readonly providers?: Readonly<Record<string, ProviderConfig>>;
+    readonly signers?: Readonly<Record<string, Signer>>;
+    readonly wallets?: Readonly<Record<string, WalletConfig>>;
+    readonly hooks?: Hooks;
+    readonly lifecycle?: LifecycleOptions;
+}
+export interface AioOptions extends ScopeOptions {
+    /** Root-only: drivers and transports are shared by all scopes of a root container. */
+    readonly transport?: TransportOptions;
+    /** Prefixes every store key; tenants sharing a database must use distinct namespaces. */
+    readonly namespace?: string;
+    /** Environment source for routing config; `false` disables it. Default: `process.env`. */
+    readonly env?: Readonly<Record<string, string | undefined>> | false;
+    readonly profile?: string;
+    readonly stores?: Partial<Stores>;
+    readonly logger?: Logger;
+    readonly clock?: Clock;
+    readonly plugins?: readonly Plugin[];
+}
+export interface HandleOptions {
+    readonly chain: string;
+    readonly network?: string;
+    readonly library?: string;
+    readonly provider?: ProviderRef | readonly ProviderRef[];
+    readonly indexer?: ProviderRef | readonly ProviderRef[];
+    readonly wallet?: string;
+    readonly signer?: string;
+    readonly options?: Readonly<Record<string, unknown>>;
+    readonly confirmations?: number;
+}
+export type HandleConfig<C extends ChainId> = Omit<HandleOptions, 'chain' | 'network' | 'library'> & {
+    readonly chain: C;
+    readonly network?: NetworkOf<C>;
+    readonly library?: LibraryOf<C>;
+};
+export interface EffectiveOptions {
+    readonly chains: Readonly<Record<string, ChainDefaults>>;
+    readonly providers: Readonly<Record<string, ProviderConfig>>;
+    readonly signers: Readonly<Record<string, Signer>>;
+    readonly wallets: Readonly<Record<string, WalletConfig>>;
+    readonly hooks: Hooks;
+    readonly lifecycle: LifecycleOptions;
+}
+export interface ResolvedProvider {
+    readonly name: string;
+    readonly endpoints: readonly EndpointConfig[];
+    readonly production: boolean;
+}
+export interface ResolvedSelection {
+    readonly chain: ChainInfo;
+    readonly network: NetworkInfo;
+    readonly library: string;
+    readonly manifest: AdapterManifest;
+    readonly providers: readonly ResolvedProvider[];
+    readonly indexers: readonly ResolvedProvider[];
+    readonly wallet?: {
+        readonly name: string;
+        readonly config: WalletConfig;
+    };
+    readonly signer?: {
+        readonly id: string;
+        readonly instance: Signer;
+    };
+    readonly options: Readonly<Record<string, unknown>>;
+    readonly confirmations: number;
+    /** The per-chain `maxLagBlocks` from the `chains` config, when set. */
+    readonly maxLagBlocks?: number;
+    readonly capabilities: ReadonlySet<Capability>;
+    readonly providerNames: readonly string[];
+    readonly indexerNames: readonly string[];
+    /** Identity of the shared driver/transport (includes credential fingerprints). */
+    readonly poolKey: string;
+    /** Hash recorded in each Operation's ExecutionContext. */
+    readonly configHash: string;
+    /** The merged handle options, used by `with()`. */
+    readonly handle: HandleOptions;
+}

package/dist/core/config/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/config/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AdapterManifest } from '../driver/types';\nimport type { Logger } from '../events/logger';\nimport type { Capability } from '../model/capability';\nimport type { ChainInfo, NetworkInfo } from '../model/chain';\nimport type { ChainId, LibraryOf, NetworkOf } from '../model/ids';\nimport type { Plugin } from '../registry/plugin';\nimport type { Secret } from '../secret/secret';\nimport type { ExtendedKeyVersions } from '../signing/hd';\nimport type { KeyRef, Signer, SigningContext } from '../signing/types';\nimport type { Stores } from '../store/types';\nimport type { EndpointConfig, TransportOptions } from '../transport/types';\nimport type { Clock } from '../util/clock';\n\nexport type ProviderConfig =\n  | {\n      readonly preset: string;\n      readonly apiKey?: string | Secret<string>;\n      readonly options?: Readonly<Record<string, unknown>>;\n    }\n  | { readonly endpoints: readonly EndpointConfig[] };\n\nexport type ProviderRef = string | ProviderConfig;\n\nexport interface WalletConfig {\n  readonly signer?: string;\n  /** Routes requests to signers by `keyRef.id` (multi-party wallets). */\n  readonly signers?: Readonly<Record<string, string>>;\n  readonly address?: string;\n  /** Hex public key for watch-only wallets that still prepare transactions. */\n  readonly publicKey?: string;\n  readonly xpub?: string;\n  readonly xpubVersions?: ExtendedKeyVersions;\n  /** Child path template relative to the xpub; `{index}` is replaced. Default `0/{index}`. */\n  readonly xpubPath?: string;\n  readonly keyRef?: KeyRef;\n  /** Metadata only (passed to signing context); no built-in behaviour. */\n  readonly tier?: string;\n  readonly chains?: readonly string[];\n  readonly utxo?: Readonly<Record<string, unknown>>;\n  readonly ton?: Readonly<Record<string, unknown>>;\n  readonly options?: Readonly<Record<string, unknown>>;\n}\n\nexport interface ChainDefaults {\n  readonly network?: string;\n  readonly library?: string;\n  readonly provider?: ProviderRef | readonly ProviderRef[];\n  readonly indexer?: ProviderRef | readonly ProviderRef[];\n  readonly wallet?: string;\n  readonly signer?: string;\n  readonly options?: Readonly<Record<string, unknown>>;\n  readonly confirmations?: number;\n  /**\n   * This chain's lag tolerance, in blocks. It wins over the root\n   * `transport.maxLagBlocks`, which wins over the plugin network's own, which wins over\n   * the transport's built-in default. An endpoint further behind the best known height is\n   * lagging, and a monitor or scanner view further behind is stale.\n   */\n  readonly maxLagBlocks?: number;\n}\n\nexport interface LifecycleOptions {\n  readonly pollIntervalMs?: number;\n  readonly droppedGracePeriodMs?: number;\n  readonly rebroadcastIntervalMs?: number;\n  readonly leaseMs?: number;\n  readonly claimLeaseMs?: number;\n  readonly waitTimeoutMs?: number;\n  readonly requireIdempotencyKey?: boolean;\n  readonly broadcastFanout?: number;\n  /**\n   * How long `transfer` and `submitSignatures` wait for the `beforeSign` hook and the\n   * signer(s) (default 120 000 ms). The wallet's address lease is kept alive meanwhile. On\n   * timeout nothing is written: the Operation stays `prepared` with its reservation, and a\n   * repeat asks again. Signers that need longer should answer `pending` with a ticket.\n   */\n  readonly signTimeoutMs?: number;\n}\n\nexport interface Hooks {\n  /**\n   * Throw to veto signing (policy engines, approvals). Runs before every signing request.\n   * It may run more than once per Operation: once per concurrent caller, and again when a\n   * `prepared` Operation is repeated. Make it idempotent; `ctx.operationId` identifies the\n   * Operation. It runs while the wallet's address lease is held, so keep it short. In\n   * `transfer` and `submitSignatures` the lease is kept alive for up to\n   * `lifecycle.signTimeoutMs`; in `prepareTransfer` a hook running longer than\n   * `lifecycle.leaseMs` can lose the lease to another transfer. A veto after that writes\n   * nothing; the Operation stays `prepared` and is vetoed again on its next repeat.\n   */\n  readonly beforeSign?: (ctx: SigningContext) => void | Promise<void>;\n}\n\nexport interface ScopeOptions {\n  readonly chains?: Readonly<Record<string, ChainDefaults>>;\n  readonly providers?: Readonly<Record<string, ProviderConfig>>;\n  readonly signers?: Readonly<Record<string, Signer>>;\n  readonly wallets?: Readonly<Record<string, WalletConfig>>;\n  readonly hooks?: Hooks;\n  readonly lifecycle?: LifecycleOptions;\n}\n\nexport interface AioOptions extends ScopeOptions {\n  /** Root-only: drivers and transports are shared by all scopes of a root container. */\n  readonly transport?: TransportOptions;\n  /** Prefixes every store key; tenants sharing a database must use distinct namespaces. */\n  readonly namespace?: string;\n  /** Environment source for routing config; `false` disables it. Default: `process.env`. */\n  readonly env?: Readonly<Record<string, string | undefined>> | false;\n  readonly profile?: string;\n  readonly stores?: Partial<Stores>;\n  readonly logger?: Logger;\n  readonly clock?: Clock;\n  readonly plugins?: readonly Plugin[];\n}\n\nexport interface HandleOptions {\n  readonly chain: string;\n  readonly network?: string;\n  readonly library?: string;\n  readonly provider?: ProviderRef | readonly ProviderRef[];\n  readonly indexer?: ProviderRef | readonly ProviderRef[];\n  readonly wallet?: string;\n  readonly signer?: string;\n  readonly options?: Readonly<Record<string, unknown>>;\n  readonly confirmations?: number;\n}\n\nexport type HandleConfig<C extends ChainId> = Omit<\n  HandleOptions,\n  'chain' | 'network' | 'library'\n> & {\n  readonly chain: C;\n  readonly network?: NetworkOf<C>;\n  readonly library?: LibraryOf<C>;\n};\n\nexport interface EffectiveOptions {\n  readonly chains: Readonly<Record<string, ChainDefaults>>;\n  readonly providers: Readonly<Record<string, ProviderConfig>>;\n  readonly signers: Readonly<Record<string, Signer>>;\n  readonly wallets: Readonly<Record<string, WalletConfig>>;\n  readonly hooks: Hooks;\n  readonly lifecycle: LifecycleOptions;\n}\n\nexport interface ResolvedProvider {\n  readonly name: string;\n  readonly endpoints: readonly EndpointConfig[];\n  readonly production: boolean;\n}\n\nexport interface ResolvedSelection {\n  readonly chain: ChainInfo;\n  readonly network: NetworkInfo;\n  readonly library: string;\n  readonly manifest: AdapterManifest;\n  readonly providers: readonly ResolvedProvider[];\n  readonly indexers: readonly ResolvedProvider[];\n  readonly wallet?: { readonly name: string; readonly config: WalletConfig };\n  readonly signer?: { readonly id: string; readonly instance: Signer };\n  readonly options: Readonly<Record<string, unknown>>;\n  readonly confirmations: number;\n  /** The per-chain `maxLagBlocks` from the `chains` config, when set. */\n  readonly maxLagBlocks?: number;\n  readonly capabilities: ReadonlySet<Capability>;\n  readonly providerNames: readonly string[];\n  readonly indexerNames: readonly string[];\n  /** Identity of the shared driver/transport (includes credential fingerprints). */\n  readonly poolKey: string;\n  /** Hash recorded in each Operation's ExecutionContext. */\n  readonly configHash: string;\n  /** The merged handle options, used by `with()`. */\n  readonly handle: HandleOptions;\n}\n"]}

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

@@ -0,0 +1,4 @@
+import type { Plugin } from '../registry/plugin';
+/** Called by the composition root (`src/index.ts`) to register built-in family plugins. */
+export declare function setBuiltinPlugins(plugins: readonly Plugin[]): void;
+export declare function builtinPlugins(): readonly Plugin[];

package/dist/core/container/builtins.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setBuiltinPlugins = setBuiltinPlugins;
+exports.builtinPlugins = builtinPlugins;
+let builtins = [];
+/** Called by the composition root (`src/index.ts`) to register built-in family plugins. */
+function setBuiltinPlugins(plugins) {
+    builtins = [...plugins];
+}
+function builtinPlugins() {
+    return builtins;
+}
+//# sourceMappingURL=builtins.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.js","sourceRoot":"","sources":["../../../src/core/container/builtins.ts"],"names":[],"mappings":";;AAKA,8CAEC;AAED,wCAEC;AATD,IAAI,QAAQ,GAAsB,EAAE,CAAC;AAErC,2FAA2F;AAC3F,SAAgB,iBAAiB,CAAC,OAA0B;IAC1D,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;AAC1B,CAAC;AAED,SAAgB,cAAc;IAC5B,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import type { Plugin } from '../registry/plugin';\n\nlet builtins: readonly Plugin[] = [];\n\n/** Called by the composition root (`src/index.ts`) to register built-in family plugins. */\nexport function setBuiltinPlugins(plugins: readonly Plugin[]): void {\n  builtins = [...plugins];\n}\n\nexport function builtinPlugins(): readonly Plugin[] {\n  return builtins;\n}\n"]}

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

@@ -0,0 +1,69 @@
+import { Blockchain } from '../blockchain/handle';
+import type { AioOptions, HandleConfig, ScopeOptions } from '../config/types';
+import type { AioEvent, AioEventName } from '../events/types';
+import { type RecoveryReport, type WorkerOptions } from '../lifecycle/monitor';
+import { type OperationView } from '../lifecycle/views';
+import type { ChainId } from '../model/ids';
+import { type Plugin } from '../registry/plugin';
+import type { OperationState } from '../store/types';
+/** How long `close()` waits for one native client's `close` before moving on. */
+export declare const NATIVE_CLOSE_TIMEOUT_MS = 5000;
+interface ScopeInit {
+    readonly parent: CryptoAio;
+    readonly overrides: ScopeOptions;
+}
+export interface OperationsFilter {
+    readonly states?: readonly OperationState[];
+    readonly chain?: string;
+    readonly network?: string;
+    readonly limit?: number;
+}
+export interface OperationsApi {
+    get(id: string): Promise<OperationView | null>;
+    /** In creation order. */
+    list(filter?: OperationsFilter): Promise<OperationView[]>;
+    /** Startup recovery for this namespace (see RecoveryReport); it never signs. */
+    recover(options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<RecoveryReport>;
+}
+export interface MonitorApi {
+    /** Runs worker passes until `signal` aborts; any number of workers may run. */
+    start(options?: WorkerOptions): Promise<void>;
+    /** One worker pass; resolves to the number of Operations it claimed. */
+    runOnce(options?: WorkerOptions): Promise<number>;
+}
+/**
+ * Dependency container: stores, signers, wallets, hooks, plugins and a shared driver pool.
+ * Separate `new CryptoAio()` instances are fully isolated (use one per tenant).
+ */
+export declare class CryptoAio {
+    #private;
+    readonly namespace: string;
+    constructor(options?: AioOptions);
+    /** @internal */
+    constructor(options: AioOptions, scope: ScopeInit);
+    /**
+     * 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: ScopeOptions): CryptoAio;
+    blockchain<C extends ChainId>(config: HandleConfig<C>): Blockchain<C>;
+    /** Registers a plugin on this root container (copy-on-write catalogs). */
+    use(plugin: Plugin): this;
+    on<E extends AioEventName>(type: E, handler: (event: AioEvent<E>) => void): () => void;
+    onAny(handler: (event: AioEvent) => void): () => void;
+    /** Stored Operations of this namespace, as views, and startup recovery. */
+    get operations(): OperationsApi;
+    /** Background workers that check due Operations without anyone waiting on them. */
+    get monitor(): MonitorApi;
+    /**
+     * 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.
+     */
+    close(): Promise<void>;
+}
+export {};