crypto-aio 0.0.3 → 0.2.0

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"]}

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

@@ -0,0 +1,54 @@
+import type { AssetService } from '../assets/service';
+import type { EffectiveOptions, ScopeOptions } from '../config/types';
+import { StateError } from '../errors/error';
+import type { EventBus } from '../events/bus';
+import type { Logger } from '../events/logger';
+import type { OperationEngine } from '../lifecycle/engine';
+import type { Monitor } from '../lifecycle/monitor';
+import type { Catalogs } from '../registry/plugin';
+import type { SignerDeadline } from '../signing/guard';
+import type { Stores } from '../store/types';
+import type { TransportOptions } from '../transport/types';
+import type { Clock } from '../util/clock';
+import type { DriverPool } from './pool';
+/** State shared by a root container and all of its scopes. */
+export interface RootRuntime {
+    readonly namespace: string;
+    catalogs: Catalogs;
+    envLayer: ScopeOptions;
+    readonly env: Readonly<Record<string, string | undefined>>;
+    readonly profile?: string;
+    readonly clock: Clock;
+    readonly log: Logger;
+    readonly events: EventBus;
+    readonly stores: Stores;
+    readonly pool: DriverPool;
+    readonly assets: AssetService;
+    readonly transport: TransportOptions;
+    /** Owner id used for leases and claims taken by this process. */
+    readonly owner: string;
+    /**
+     * Set by the root's `close()`; a closed container refuses handle and `native()` work.
+     */
+    closed: boolean;
+    /** Aborted by the root's `close()`, which stops every worker loop and recovery. */
+    readonly closing: AbortController;
+    /** The `close` of every native SDK client handed out, run by the root's `close()`. */
+    readonly natives: Set<() => void | Promise<void>>;
+}
+/** What a closed container's handles and `native()` fail with. */
+export declare function closedError(): StateError;
+export interface ContainerInternals {
+    readonly runtime: RootRuntime;
+    readonly layers: readonly ScopeOptions[];
+    readonly isRoot: boolean;
+    effective(): EffectiveOptions;
+    /** Lazily created per container (scopes have their own hooks and lifecycle settings). */
+    engine(): OperationEngine;
+    /** Lazily created per container, on top of its engine. */
+    monitor(): Monitor;
+    /** The bound on a signer's public-key read (this container's `signTimeoutMs`). */
+    signerDeadline(): SignerDeadline;
+}
+export declare function bindContainer(container: object, internals: ContainerInternals): void;
+export declare function containerOf(container: object): ContainerInternals;

package/dist/core/container/internals.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.closedError = closedError;
+exports.bindContainer = bindContainer;
+exports.containerOf = containerOf;
+const error_1 = require("../errors/error");
+/** What a closed container's handles and `native()` fail with. */
+function closedError() {
+    return new error_1.StateError('INVALID_TRANSITION', 'this crypto-aio container is closed');
+}
+const registry = new WeakMap();
+function bindContainer(container, internals) {
+    registry.set(container, internals);
+}
+function containerOf(container) {
+    const internals = registry.get(container);
+    if (!internals)
+        throw new error_1.ConfigError('CONFIG_INVALID', 'not a CryptoAio container');
+    return internals;
+}
+//# sourceMappingURL=internals.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internals.js","sourceRoot":"","sources":["../../../src/core/container/internals.ts"],"names":[],"mappings":";;AAyCA,kCAEC;AAiBD,sCAEC;AAED,kCAIC;AAlED,2CAA0D;AAsC1D,kEAAkE;AAClE,SAAgB,WAAW;IACzB,OAAO,IAAI,kBAAU,CAAC,oBAAoB,EAAE,qCAAqC,CAAC,CAAC;AACrF,CAAC;AAeD,MAAM,QAAQ,GAAG,IAAI,OAAO,EAA8B,CAAC;AAE3D,SAAgB,aAAa,CAAC,SAAiB,EAAE,SAA6B;IAC5E,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AACrC,CAAC;AAED,SAAgB,WAAW,CAAC,SAAiB;IAC3C,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,mBAAW,CAAC,gBAAgB,EAAE,2BAA2B,CAAC,CAAC;IACrF,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import type { AssetService } from '../assets/service';\nimport type { EffectiveOptions, ScopeOptions } from '../config/types';\nimport { ConfigError, StateError } from '../errors/error';\nimport type { EventBus } from '../events/bus';\nimport type { Logger } from '../events/logger';\nimport type { OperationEngine } from '../lifecycle/engine';\nimport type { Monitor } from '../lifecycle/monitor';\nimport type { Catalogs } from '../registry/plugin';\nimport type { SignerDeadline } from '../signing/guard';\nimport type { Stores } from '../store/types';\nimport type { TransportOptions } from '../transport/types';\nimport type { Clock } from '../util/clock';\nimport type { DriverPool } from './pool';\n\n/** State shared by a root container and all of its scopes. */\nexport interface RootRuntime {\n  readonly namespace: string;\n  catalogs: Catalogs;\n  envLayer: ScopeOptions;\n  readonly env: Readonly<Record<string, string | undefined>>;\n  readonly profile?: string;\n  readonly clock: Clock;\n  readonly log: Logger;\n  readonly events: EventBus;\n  readonly stores: Stores;\n  readonly pool: DriverPool;\n  readonly assets: AssetService;\n  readonly transport: TransportOptions;\n  /** Owner id used for leases and claims taken by this process. */\n  readonly owner: string;\n  /**\n   * Set by the root's `close()`; a closed container refuses handle and `native()` work.\n   */\n  closed: boolean;\n  /** Aborted by the root's `close()`, which stops every worker loop and recovery. */\n  readonly closing: AbortController;\n  /** The `close` of every native SDK client handed out, run by the root's `close()`. */\n  readonly natives: Set<() => void | Promise<void>>;\n}\n\n/** What a closed container's handles and `native()` fail with. */\nexport function closedError(): StateError {\n  return new StateError('INVALID_TRANSITION', 'this crypto-aio container is closed');\n}\n\nexport interface ContainerInternals {\n  readonly runtime: RootRuntime;\n  readonly layers: readonly ScopeOptions[];\n  readonly isRoot: boolean;\n  effective(): EffectiveOptions;\n  /** Lazily created per container (scopes have their own hooks and lifecycle settings). */\n  engine(): OperationEngine;\n  /** Lazily created per container, on top of its engine. */\n  monitor(): Monitor;\n  /** The bound on a signer's public-key read (this container's `signTimeoutMs`). */\n  signerDeadline(): SignerDeadline;\n}\n\nconst registry = new WeakMap<object, ContainerInternals>();\n\nexport function bindContainer(container: object, internals: ContainerInternals): void {\n  registry.set(container, internals);\n}\n\nexport function containerOf(container: object): ContainerInternals {\n  const internals = registry.get(container);\n  if (!internals) throw new ConfigError('CONFIG_INVALID', 'not a CryptoAio container');\n  return internals;\n}\n"]}

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

@@ -0,0 +1,27 @@
+import type { ResolvedSelection } from '../config/types';
+import type { ChainDriver } from '../driver/types';
+import type { EventBus } from '../events/bus';
+import type { Logger } from '../events/logger';
+import type { Catalogs } from '../registry/plugin';
+import type { Transport, TransportOptions } from '../transport/types';
+import type { Clock } from '../util/clock';
+export interface PooledDriver {
+    readonly driver: ChainDriver;
+    readonly transport: Transport;
+    readonly indexer?: Transport;
+}
+export interface DriverPoolDeps {
+    readonly catalogs: () => Catalogs;
+    readonly clock: Clock;
+    readonly events: EventBus;
+    readonly log: Logger;
+    readonly transport: () => TransportOptions;
+}
+/** Shares one driver + transport per (chain, network, library, provider credentials, options). */
+export declare class DriverPool {
+    #private;
+    private readonly deps;
+    constructor(deps: DriverPoolDeps);
+    get(selection: ResolvedSelection): Promise<PooledDriver>;
+    close(): Promise<void>;
+}

package/dist/core/container/pool.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DriverPool = void 0;
+const error_1 = require("../errors/error");
+const http_transport_1 = require("../transport/http-transport");
+const bytes_1 = require("../util/bytes");
+/** Shares one driver + transport per (chain, network, library, provider credentials, options). */
+class DriverPool {
+    deps;
+    #entries = new Map();
+    #closed = false;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    get(selection) {
+        if (this.#closed) {
+            return Promise.reject(new error_1.StateError('INVALID_TRANSITION', 'driver pool is closed'));
+        }
+        let entry = this.#entries.get(selection.poolKey);
+        if (!entry) {
+            entry = this.#create(selection);
+            this.#entries.set(selection.poolKey, entry);
+            entry.catch(() => {
+                // Only evict THIS entry: a concurrent get() may already have replaced it (e.g. a
+                // retry after this one failed), and that newer entry must survive.
+                if (this.#entries.get(selection.poolKey) === entry) {
+                    this.#entries.delete(selection.poolKey);
+                }
+            });
+        }
+        return entry;
+    }
+    async close() {
+        this.#closed = true;
+        const entries = [...this.#entries.values()];
+        this.#entries.clear();
+        await Promise.allSettled(entries.map(async (entry) => (await entry).driver.close?.()));
+    }
+    async #create(selection) {
+        const factory = await this.deps.catalogs().adapters.load(selection.manifest);
+        const root = this.deps.transport();
+        // First match wins: the user's per-chain config, the user's root transport option,
+        // the plugin network's own, then (left unset) the transport's built-in default.
+        const maxLagBlocks = selection.maxLagBlocks ?? root.maxLagBlocks ?? selection.network.maxLagBlocks;
+        const options = {
+            ...root,
+            ...(maxLagBlocks !== undefined ? { maxLagBlocks } : {}),
+        };
+        // `poolKey` fingerprints revealed provider URLs and must stay an in-memory map key
+        // only (never persisted, emitted or logged); the transport's public id — which flows
+        // into every rpc.*/provider.* event — is generated independently of it.
+        const id = (0, bytes_1.randomId)('tr');
+        const shared = {
+            clock: this.deps.clock,
+            events: this.deps.events,
+            log: this.deps.log.child('transport'),
+            options,
+        };
+        const transport = new http_transport_1.HttpTransport(selection.providers.flatMap((p) => p.endpoints), { ...shared, id });
+        const indexer = selection.indexers.length > 0
+            ? new http_transport_1.HttpTransport(selection.indexers.flatMap((p) => p.endpoints), { ...shared, id: `${id}_idx` })
+            : undefined;
+        const driver = await factory.create({
+            chain: selection.chain,
+            network: selection.network,
+            library: selection.library,
+            transport,
+            ...(indexer ? { indexer } : {}),
+            clock: this.deps.clock,
+            log: this.deps.log.child(selection.chain.id),
+            options: selection.options,
+        });
+        return { driver, transport, ...(indexer ? { indexer } : {}) };
+    }
+}
+exports.DriverPool = DriverPool;
+//# sourceMappingURL=pool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../../src/core/container/pool.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ResolvedSelection } from '../config/types';\nimport type { ChainDriver } from '../driver/types';\nimport { StateError } from '../errors/error';\nimport type { EventBus } from '../events/bus';\nimport type { Logger } from '../events/logger';\nimport type { Catalogs } from '../registry/plugin';\nimport { HttpTransport } from '../transport/http-transport';\nimport type { Transport, TransportOptions } from '../transport/types';\nimport { randomId } from '../util/bytes';\nimport type { Clock } from '../util/clock';\n\nexport interface PooledDriver {\n  readonly driver: ChainDriver;\n  readonly transport: Transport;\n  readonly indexer?: Transport;\n}\n\nexport interface DriverPoolDeps {\n  readonly catalogs: () => Catalogs;\n  readonly clock: Clock;\n  readonly events: EventBus;\n  readonly log: Logger;\n  readonly transport: () => TransportOptions;\n}\n\n/** Shares one driver + transport per (chain, network, library, provider credentials, options). */\nexport class DriverPool {\n  readonly #entries = new Map<string, Promise<PooledDriver>>();\n  #closed = false;\n\n  constructor(private readonly deps: DriverPoolDeps) {}\n\n  get(selection: ResolvedSelection): Promise<PooledDriver> {\n    if (this.#closed) {\n      return Promise.reject(\n        new StateError('INVALID_TRANSITION', 'driver pool is closed'),\n      );\n    }\n    let entry = this.#entries.get(selection.poolKey);\n    if (!entry) {\n      entry = this.#create(selection);\n      this.#entries.set(selection.poolKey, entry);\n      entry.catch(() => {\n        // Only evict THIS entry: a concurrent get() may already have replaced it (e.g. a\n        // retry after this one failed), and that newer entry must survive.\n        if (this.#entries.get(selection.poolKey) === entry) {\n          this.#entries.delete(selection.poolKey);\n        }\n      });\n    }\n    return entry;\n  }\n\n  async close(): Promise<void> {\n    this.#closed = true;\n    const entries = [...this.#entries.values()];\n    this.#entries.clear();\n    await Promise.allSettled(\n      entries.map(async (entry) => (await entry).driver.close?.()),\n    );\n  }\n\n  async #create(selection: ResolvedSelection): Promise<PooledDriver> {\n    const factory = await this.deps.catalogs().adapters.load(selection.manifest);\n    const root = this.deps.transport();\n    // First match wins: the user's per-chain config, the user's root transport option,\n    // the plugin network's own, then (left unset) the transport's built-in default.\n    const maxLagBlocks =\n      selection.maxLagBlocks ?? root.maxLagBlocks ?? selection.network.maxLagBlocks;\n    const options: TransportOptions = {\n      ...root,\n      ...(maxLagBlocks !== undefined ? { maxLagBlocks } : {}),\n    };\n    // `poolKey` fingerprints revealed provider URLs and must stay an in-memory map key\n    // only (never persisted, emitted or logged); the transport's public id — which flows\n    // into every rpc.*/provider.* event — is generated independently of it.\n    const id = randomId('tr');\n    const shared = {\n      clock: this.deps.clock,\n      events: this.deps.events,\n      log: this.deps.log.child('transport'),\n      options,\n    };\n    const transport = new HttpTransport(\n      selection.providers.flatMap((p) => p.endpoints),\n      { ...shared, id },\n    );\n    const indexer =\n      selection.indexers.length > 0\n        ? new HttpTransport(\n            selection.indexers.flatMap((p) => p.endpoints),\n            { ...shared, id: `${id}_idx` },\n          )\n        : undefined;\n    const driver = await factory.create({\n      chain: selection.chain,\n      network: selection.network,\n      library: selection.library,\n      transport,\n      ...(indexer ? { indexer } : {}),\n      clock: this.deps.clock,\n      log: this.deps.log.child(selection.chain.id),\n      options: selection.options,\n    });\n    return { driver, transport, ...(indexer ? { indexer } : {}) };\n  }\n}\n"]}