@xyo-network/chain-orchestration 1.18.0 → 1.18.1

package/dist/neutral/actor/Actor.d.ts

@@ -1,248 +0,0 @@
-import type { CreatableInstance, CreatableParams, EmptyObject } from '@xylabs/sdk-js';
-import { AbstractCreatable } from '@xylabs/sdk-js';
-import { AccountInstance } from '@xyo-network/account-model';
-import { type BaseContext, type Config, ProviderFactoryLocator, type ProviderFactoryLocatorInstance } from '@xyo-network/xl1-protocol-sdk';
-import { Semaphore } from 'async-mutex';
-export type ActorContext = BaseContext & {
-    config: Config;
-    locator: ProviderFactoryLocatorInstance;
-};
-export type ActorParams<T extends EmptyObject | void = void> = CreatableParams & {
-    account: AccountInstance;
-    context: ActorContext;
-    displayName?: string;
-    id: string;
-} & (T extends void ? EmptyObject : T);
-export type ActorInstance<T extends ActorParams = ActorParams> = CreatableInstance<T> & {
-    start(): Promise<boolean>;
-    stop(): Promise<boolean>;
-};
-export declare class Actor<TParams extends ActorParams = ActorParams> extends AbstractCreatable<TParams> {
-    protected readonly _intervals: Map<string, ReturnType<typeof setInterval>>;
-    protected readonly _semaphores: Map<string, Semaphore>;
-    protected readonly _timeouts: Map<string, ReturnType<typeof setTimeout>>;
-    private _active;
-    get displayName(): string;
-    get id(): string;
-    protected get account(): AccountInstance;
-    protected get config(): {
-        api: {
-            host: string;
-            initRewardsCache: boolean;
-            port: number;
-            mnemonic?: string | undefined;
-        };
-        bridge: {
-            chainRpcApiUrl: string;
-            feeFixed: import("@xylabs/sdk-js").Hex;
-            feeRateBasisPoints: number;
-            host: string;
-            maxBridgeAmount: import("@xylabs/sdk-js").Hex;
-            minBridgeAmount: import("@xylabs/sdk-js").Hex;
-            port: number;
-            redisHost: string;
-            redisPort: number;
-            remoteBridgeContractAddress: import("@xylabs/sdk-js").Address;
-            remoteChainId: import("@xylabs/sdk-js").Hex;
-            remoteTokenAddress: import("@xylabs/sdk-js").Hex;
-            remoteChainWalletPrivateKey: import("@xylabs/sdk-js").Hex;
-            escrowAddress?: import("@xylabs/sdk-js").Address | undefined;
-            feesAddress?: import("@xylabs/sdk-js").Address | undefined;
-            mnemonic?: string | undefined;
-            xl1ChainId?: import("@xylabs/sdk-js").Hex | undefined;
-            xl1TokenAddress?: import("@xylabs/sdk-js").Hex | undefined;
-        };
-        chain: {
-            id?: import("@xylabs/sdk-js").Hex | undefined;
-            genesisRewardAddress?: import("@xylabs/sdk-js").Address | undefined;
-        };
-        evm: {
-            chainId?: string | undefined;
-            infura?: {
-                projectId?: string | undefined;
-                projectSecret?: string | undefined;
-            } | undefined;
-            jsonRpc?: {
-                url?: string | undefined;
-            } | undefined;
-        };
-        mempool: {
-            enabled: boolean;
-            host: string;
-            port: number;
-            mnemonic?: string | undefined;
-        };
-        producer: {
-            heartbeatInterval: number;
-            minStake: number;
-            port: number;
-            allowlist?: import("@xylabs/sdk-js").Address[] | undefined;
-            disableIntentRedeclaration?: boolean | undefined;
-            healthCheckPort?: number | undefined;
-            mnemonic?: string | undefined;
-            rewardAddress?: string | undefined;
-        };
-        rewardRedemptionApi: {
-            chainRpcApiUrl: string;
-            host: string;
-            port: number;
-            mnemonic?: string | undefined;
-        };
-        services: {
-            accountBalanceViewerEndpoint: string;
-            apiEndpoint: string;
-        };
-        storage: {
-            mongo?: {
-                connectionString?: string | undefined;
-                database?: string | undefined;
-                domain?: string | undefined;
-                password?: string | undefined;
-                username?: string | undefined;
-            } | undefined;
-            root?: string | undefined;
-        };
-        telemetry: {
-            metrics?: {
-                scrape: {
-                    path: string;
-                    port: number;
-                };
-            } | undefined;
-            otel?: {
-                otlpEndpoint?: string | undefined;
-            } | undefined;
-        };
-        validation: {
-            allowedRewardRedeemers?: import("@xylabs/sdk-js").Address[] | undefined;
-            allowedRewardEscrowAccountSigners?: import("@xylabs/sdk-js").Address[] | undefined;
-        };
-        logLevel: "info" | "error" | "warn" | "log" | "debug" | "trace";
-        silent: boolean;
-    };
-    protected get context(): ActorContext;
-    protected get locator(): ProviderFactoryLocatorInstance;
-    protected get logPrefix(): string;
-    static paramsHandler<T extends ActorParams>(params?: Partial<T>): Promise<{
-        account: T["account"];
-        context: T["context"] | {
-            config: {
-                api: {
-                    host: string;
-                    initRewardsCache: boolean;
-                    port: number;
-                    mnemonic?: string | undefined;
-                };
-                bridge: {
-                    chainRpcApiUrl: string;
-                    feeFixed: import("@xylabs/sdk-js").Hex;
-                    feeRateBasisPoints: number;
-                    host: string;
-                    maxBridgeAmount: import("@xylabs/sdk-js").Hex;
-                    minBridgeAmount: import("@xylabs/sdk-js").Hex;
-                    port: number;
-                    redisHost: string;
-                    redisPort: number;
-                    remoteBridgeContractAddress: import("@xylabs/sdk-js").Address;
-                    remoteChainId: import("@xylabs/sdk-js").Hex;
-                    remoteTokenAddress: import("@xylabs/sdk-js").Hex;
-                    remoteChainWalletPrivateKey: import("@xylabs/sdk-js").Hex;
-                    escrowAddress?: import("@xylabs/sdk-js").Address | undefined;
-                    feesAddress?: import("@xylabs/sdk-js").Address | undefined;
-                    mnemonic?: string | undefined;
-                    xl1ChainId?: import("@xylabs/sdk-js").Hex | undefined;
-                    xl1TokenAddress?: import("@xylabs/sdk-js").Hex | undefined;
-                };
-                chain: {
-                    id?: import("@xylabs/sdk-js").Hex | undefined;
-                    genesisRewardAddress?: import("@xylabs/sdk-js").Address | undefined;
-                };
-                evm: {
-                    chainId?: string | undefined;
-                    infura?: {
-                        projectId?: string | undefined;
-                        projectSecret?: string | undefined;
-                    } | undefined;
-                    jsonRpc?: {
-                        url?: string | undefined;
-                    } | undefined;
-                };
-                mempool: {
-                    enabled: boolean;
-                    host: string;
-                    port: number;
-                    mnemonic?: string | undefined;
-                };
-                producer: {
-                    heartbeatInterval: number;
-                    minStake: number;
-                    port: number;
-                    allowlist?: import("@xylabs/sdk-js").Address[] | undefined;
-                    disableIntentRedeclaration?: boolean | undefined;
-                    healthCheckPort?: number | undefined;
-                    mnemonic?: string | undefined;
-                    rewardAddress?: string | undefined;
-                };
-                rewardRedemptionApi: {
-                    chainRpcApiUrl: string;
-                    host: string;
-                    port: number;
-                    mnemonic?: string | undefined;
-                };
-                services: {
-                    accountBalanceViewerEndpoint: string;
-                    apiEndpoint: string;
-                };
-                storage: {
-                    mongo?: {
-                        connectionString?: string | undefined;
-                        database?: string | undefined;
-                        domain?: string | undefined;
-                        password?: string | undefined;
-                        username?: string | undefined;
-                    } | undefined;
-                    root?: string | undefined;
-                };
-                telemetry: {
-                    metrics?: {
-                        scrape: {
-                            path: string;
-                            port: number;
-                        };
-                    } | undefined;
-                    otel?: {
-                        otlpEndpoint?: string | undefined;
-                    } | undefined;
-                };
-                validation: {
-                    allowedRewardRedeemers?: import("@xylabs/sdk-js").Address[] | undefined;
-                    allowedRewardEscrowAccountSigners?: import("@xylabs/sdk-js").Address[] | undefined;
-                };
-                logLevel: "info" | "error" | "warn" | "log" | "debug" | "trace";
-                silent: boolean;
-            };
-            locator: ProviderFactoryLocator;
-        };
-        displayName: import("@xylabs/sdk-js").CreatableName | NonNullable<T["displayName"]> | undefined;
-        id: import("@xylabs/sdk-js").CreatableName | T["id"] | undefined;
-        logger: import("@xylabs/sdk-js").Logger;
-        name?: import("@xylabs/sdk-js").CreatableName;
-        statusReporter?: import("@xylabs/sdk-js").CreatableStatusReporter<void> | undefined;
-        meterProvider?: import("@opentelemetry/api").MeterProvider;
-        traceProvider?: import("@opentelemetry/api").TracerProvider;
-    }>;
-    /**
-     * The timer runs until the actor is deactivated (or you manually stop it).
-     */
-    registerTimer(timerName: string, callback: () => Promise<void>, dueTimeMs: number, periodMs: number): void;
-    /**
-     * Called by the Orchestrator when the actor is activated.
-     */
-    startHandler(): Promise<void>;
-    /**
-     * Called by the Orchestrator when the actor is deactivated.
-     * Stop all running timers.
-     */
-    stopHandler(): Promise<void>;
-}
-//# sourceMappingURL=Actor.d.ts.map

package/dist/neutral/actor/Actor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Actor.d.ts","sourceRoot":"","sources":["../../../src/actor/Actor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAChD,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,iBAAiB,EAGlB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAC5D,OAAO,EACL,KAAK,WAAW,EAAE,KAAK,MAAM,EAE7B,sBAAsB,EACtB,KAAK,8BAA8B,EACpC,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG;IACvC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,8BAA8B,CAAA;CACxC,CAAA;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,IAAI,eAAe,GAAG;IAC/E,OAAO,EAAE,eAAe,CAAA;IACxB,OAAO,EAAE,YAAY,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,EAAE,EAAE,MAAM,CAAA;CACX,GAAG,CAAC,CAAC,SAAS,IAAI,GAAG,WAAW,GAAG,CAAC,CAAC,CAAA;AAEtC,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI,iBAAiB,CAAC,CAAC,CAAC,GAAG;IACtF,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IACzB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CACzB,CAAA;AAED,qBACa,KAAK,CAAC,OAAO,SAAS,WAAW,GAAG,WAAW,CAAE,SAAQ,iBAAiB,CAAC,OAAO,CAAC;IAC9F,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAY;IACtF,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAY;IAClE,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAY;IACpF,OAAO,CAAC,OAAO,CAAQ;IAEvB,IAAI,WAAW,WAEd;IAED,IAAI,EAAE,WAEL;IAED,SAAS,KAAK,OAAO,oBAEpB;IAED,SAAS,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAEnB;IAED,SAAS,KAAK,OAAO,iBAEpB;IAED,SAAS,KAAK,OAAO,mCAEpB;IAED,SAAS,KAAK,SAAS,WAEtB;WAEqB,aAAa,CAAC,CAAC,SAAS,WAAW,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmB9E;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IA+DnG;;OAEG;IACY,YAAY;IAM3B;;;OAGG;IACY,WAAW;CA+B3B"}

package/dist/neutral/init/initServerWallet.d.ts

@@ -1,3 +0,0 @@
-import type { ConfigContext } from '../ConfigContext.ts';
-export declare function initServerWallet({ config, logger }: ConfigContext): Promise<import("@xyo-network/wallet-model").WalletInstance>;
-//# sourceMappingURL=initServerWallet.d.ts.map

package/dist/neutral/init/initServerWallet.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"initServerWallet.d.ts","sourceRoot":"","sources":["../../../src/init/initServerWallet.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGxD,wBAAsB,gBAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,aAAa,+DASvE"}

package/src/actor/Actor.ts

@@ -1,199 +0,0 @@
-import type {
-  CreatableInstance, CreatableParams, EmptyObject,
-} from '@xylabs/sdk-js'
-import {
-  AbstractCreatable,
-  assertEx,
-  Base, creatable, delay, IdLogger,
-} from '@xylabs/sdk-js'
-import { AccountInstance } from '@xyo-network/account-model'
-import {
-  type BaseContext, type Config,
-  getDefaultConfig,
-  ProviderFactoryLocator,
-  type ProviderFactoryLocatorInstance,
-} from '@xyo-network/xl1-protocol-sdk'
-import { Semaphore } from 'async-mutex'
-
-export type ActorContext = BaseContext & {
-  config: Config
-  locator: ProviderFactoryLocatorInstance
-}
-
-export type ActorParams<T extends EmptyObject | void = void> = CreatableParams & {
-  account: AccountInstance
-  context: ActorContext
-  displayName?: string
-  id: string
-} & (T extends void ? EmptyObject : T)
-
-export type ActorInstance<T extends ActorParams = ActorParams> = CreatableInstance<T> & {
-  start(): Promise<boolean>
-  stop(): Promise<boolean>
-}
-
-@creatable()
-export class Actor<TParams extends ActorParams = ActorParams> extends AbstractCreatable<TParams> {
-  protected readonly _intervals: Map<string, ReturnType<typeof setInterval>> = new Map()
-  protected readonly _semaphores: Map<string, Semaphore> = new Map()
-  protected readonly _timeouts: Map<string, ReturnType<typeof setTimeout>> = new Map()
-  private _active = false
-
-  get displayName() {
-    return this.params.displayName!
-  }
-
-  get id() {
-    return this.params.id
-  }
-
-  protected get account() {
-    return this.params.account!
-  }
-
-  protected get config() {
-    return this.context.config
-  }
-
-  protected get context() {
-    return this.params.context
-  }
-
-  protected get locator() {
-    return this.context.locator
-  }
-
-  protected get logPrefix() {
-    return `[${this.displayName} (${this.id})] `
-  }
-
-  static override async paramsHandler<T extends ActorParams>(params?: Partial<T>) {
-    const baseParams = await super.paramsHandler(params)
-    const id = params?.id ?? baseParams.name
-    const displayName = params?.displayName ?? baseParams.name
-    const account = assertEx(params?.account, () => `Account is required for actor ${id}.`)
-    const logger = baseParams.logger ?? new IdLogger(Base.defaultLogger ?? console, () => `[${displayName} (${id})] `)
-    const singletons = params?.context?.singletons ?? {}
-    const config = params?.context?.config ?? getDefaultConfig()
-    const context = params?.context ?? {
-      config,
-      locator: new ProviderFactoryLocator({
-        config, logger, singletons,
-      }),
-    }
-    return {
-      ...baseParams, account, context, displayName, id, logger,
-    }
-  }
-
-  /**
-   * The timer runs until the actor is deactivated (or you manually stop it).
-   */
-  registerTimer(timerName: string, callback: () => Promise<void>, dueTimeMs: number, periodMs: number) {
-    if (!this._active) {
-      this.logger?.warn(
-        `Cannot register timer '${timerName}' because actor is not active.`,
-      )
-      return
-    }
-
-    let running = false
-
-    this._semaphores.set(timerName, new Semaphore(1))
-
-    const timeoutId = setTimeout(() => {
-      const intervalId = setInterval(() => {
-        const semaphore = this._semaphores.get(timerName)
-        if (!this._active || !this._intervals.has(timerName) || !semaphore || running) return
-        if (semaphore.isLocked()) {
-          this.logger?.warn(
-            `Skipping timer '${this.name}:${timerName}' execution because previous execution is still running.`,
-          )
-          return
-        }
-        semaphore.acquire().then(([, release]) => {
-          const startTime = Date.now()
-          running = true
-          callback()
-            .then(() => {
-              const duration = Date.now() - startTime
-              if (duration > periodMs) {
-                this.logger?.warn(
-                  `Timer '${this.name}:${timerName}' execution took longer (${duration}ms) than the period (${periodMs}ms).`,
-                )
-              } else if (duration > 5000) {
-                this.logger?.warn(
-                  `Timer '${this.name}:${timerName}' execution took longer (${duration}ms) than 5000ms.`,
-                )
-              }
-            })
-            .catch((error) => {
-              this.logger?.error(`Error in timer '${this.name}:${timerName}': ${error}`)
-              this.logger?.error(error.stack)
-            })
-            .finally(() => {
-              release()
-              running = false
-            })
-        }).catch((error) => {
-          this.logger?.error(`Error acquiring semaphore for timer '${this.name}:${timerName}': ${error}`)
-        })
-      }, periodMs)
-
-      // store interval so we can clear it on stop()
-      this._intervals.set(timerName, intervalId)
-    }, dueTimeMs)
-
-    // store timeout so we can clear it on stop() if interval hasn't started yet
-    this._timeouts.set(timerName, timeoutId)
-
-    this.logger?.log(
-      `Timer '${this.name}:${timerName}' registered: first call after ${dueTimeMs}ms, recurring every ${periodMs}ms.`,
-    )
-  }
-
-  /**
-   * Called by the Orchestrator when the actor is activated.
-   */
-  override async startHandler() {
-    await super.startHandler()
-    this._active = true
-    this.logger?.log('Started.')
-  }
-
-  /**
-   * Called by the Orchestrator when the actor is deactivated.
-   * Stop all running timers.
-   */
-  override async stopHandler() {
-    await super.stopHandler()
-    this._active = false
-    this.logger?.log('Stopping all timers...')
-
-    // wait for all semaphores to be free and acquire them to prevent new tasks from starting
-    await Promise.all(
-      [...this._semaphores.values()].map(async (semaphore) => {
-        // Wait for any running tasks to complete
-        while (semaphore.isLocked()) {
-          this.logger?.log('Waiting for running timer task to complete...')
-          await delay(500)
-        }
-        await semaphore.acquire()
-      }),
-    )
-
-    this._semaphores.clear()
-
-    for (const [, timeoutRef] of this._timeouts.entries()) {
-      clearTimeout(timeoutRef)
-    }
-    this._timeouts.clear()
-
-    for (const [, intervalRef] of this._intervals.entries()) {
-      clearInterval(intervalRef)
-    }
-    this._intervals.clear()
-
-    this.logger?.log('Stopped.')
-  }
-}

package/src/init/initServerWallet.ts

@@ -1,17 +0,0 @@
-import { isDefined } from '@xylabs/sdk-js'
-import { boot } from '@xyo-network/bios'
-import { HDWallet } from '@xyo-network/wallet'
-
-import type { ConfigContext } from '../ConfigContext.ts'
-import { initSeedPhrase } from './initSeedPhrase.ts'
-
-export async function initServerWallet({ config, logger }: ConfigContext) {
-  const { mnemonic } = config.api
-  const bios = await boot()
-  const seedPhrase = isDefined(mnemonic)
-    ? mnemonic
-    : await initSeedPhrase({
-        bios, config, logger,
-      })
-  return await HDWallet.fromPhrase(seedPhrase)
-}