Class ChainService

Cached read surface over b2b.chain — the runtime source of truth for the chains we do business with. Reused by wallet/token/withdrawal flows and the dashboards instead of a hard-coded chain list. Writes go through ChainConfigAdminService, which busts the snapshot this caches.

Index

Constructors

constructor

Methods

get getRuntime isActive labelMap list validateAndNormalizeAddress

Constructors

constructor

new ChainService(
opts: { db: B2bDatabase; valkeyClient: ValkeyClient | null },
): ChainService
Parameters
- opts: { db: B2bDatabase; valkeyClient: ValkeyClient | null }
Returns ChainService
- Defined in token-services/src/ChainService.ts:50

Methods

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>
- Defined in token-services/src/ChainService.ts:66

getRuntime

getRuntime(key: string): Promise<ChainRuntime | null>
Runtime for an ACTIVE chain (null if the chain is unclassified or absent).
Parameters
- key: string
Returns Promise<ChainRuntime | null>
- Defined in token-services/src/ChainService.ts:71

isActive

isActive(key: string): Promise<boolean>
Whether key names an ACTIVE chain.
Parameters
- key: string
Returns Promise<boolean>
- Defined in token-services/src/ChainService.ts:122

labelMap

labelMap(): Promise<Record<string, string>>
{ key → name } for ACTIVE chains — replaces the static label map.

Returns Promise<Record<string, string>>
- Defined in token-services/src/ChainService.ts:127

list

list(): Promise<Chain[]>
All ACTIVE chains.

Returns Promise<Chain[]>
- Defined in token-services/src/ChainService.ts:61

validateAndNormalizeAddress

validateAndNormalizeAddress(
    key: string,
    address: string,
): Promise<
    | {
        ok: true;
        value: {
            chainExternalId: `chn_${string}`;
            normalizedAddress: string;
            runtime: ChainRuntime;
        };
    }
    | { error: ServiceError; ok: false },
>
Standardized, chain-config-driven address validation: the chain must be ACTIVE with a known runtime, and the address must be valid for that 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: {
            chainExternalId: `chn_${string}`;
            normalizedAddress: string;
            runtime: ChainRuntime;
        };
    }
    | { error: ServiceError; ok: false },
>
- Defined in token-services/src/ChainService.ts:83

Class ChainService

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns ChainService

Methods

get

Parameters

Returns Promise<Chain | null>

getRuntime

Parameters

Returns Promise<ChainRuntime | null>

isActive

Parameters

Returns Promise<boolean>

labelMap

Returns Promise<Record<string, string>>

list

Returns Promise<Chain[]>

validateAndNormalizeAddress

Parameters

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

Settings

On This Page

Class ChainService

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns ChainService

Methods

get

Parameters

Returns Promise<Chain | null>

getRuntime

Parameters

Returns Promise<ChainRuntime | null>

isActive

Parameters

Returns Promise<boolean>

labelMap

Returns Promise<Record<string, string>>

list

Returns Promise<Chain[]>

validateAndNormalizeAddress

Parameters

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

Settings

On This Page

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