Class ChainService

constructor

• new ChainService(
      opts: { db: B2bDatabase; valkeyClient: ValkeyClient | null },
  ): ChainService

  Parameters

  • opts: { db: B2bDatabase; valkeyClient: ValkeyClient | null }

  Returns ChainService

Staticinstance

get

• get(key: string): Promise<Chain | null>

  The ACTIVE chain with this key, or null if absent/DISABLED.

  Parameters

  • key: string

  Returns Promise<Chain | null>

labelMap

• labelMap(): Promise<Record<string, string>>

  { key → name } for ACTIVE chains — replaces the static label map.

  Returns Promise<Record<string, string>>

list

• list(): Promise<Chain[]>

  All ACTIVE chains.

  Returns Promise<Chain[]>

validateAndNormalizeAddress

• validateAndNormalizeAddress(
      key: string,
      address: string,
  ): Promise<
      | {
          ok: true;
          value: {
              chainId: `chn_${string}`;
              nominisChain: string;
              normalizedAddress: string;
              runtime: ChainRuntime;
          };
      }
      | { error: ServiceError; ok: false },
  >

  Standardized, chain-config-driven address validation: the chain must be one of walletChains, and the address must be valid for its runtime. Returns the canonical normalized address + runtime. The single server-side entry point used by every flow that accepts a wallet address (payment instruments, withdrawals, …) so a new chain added via the admin /chains page is validated with no code change.

  Parameters

  • key: string
  • address: string

  Returns Promise<
      | {
          ok: true;
          value: {
              chainId: `chn_${string}`;
              nominisChain: string;
              normalizedAddress: string;
              runtime: ChainRuntime;
          };
      }
      | { error: ServiceError; ok: false },
  >

walletChains

• walletChains(): Promise<WalletChain[]>

  ACTIVE chains a WALLET payment instrument can be on, so every one is screened.

  Returns Promise<WalletChain[]>