@sodax/types 1.5.7-beta → 2.0.0-rc.2

package/README.md

@@ -1,32 +1,96 @@
 # @sodax/types
 
-Shared TypeScript types and constants used throughout Sodax libraries.
+Shared SODAX type definitions, constants, and configuration for SDK packages and applications.
 
-## Overview
+This package includes chain and token metadata, wallet provider interfaces, transaction and receipt types, backend API contracts, swap and money market configuration, DEX configuration, and common utilities.
 
-This package provides a centralized collection of type definitions and constants for the Sodax ecosystem, including:
+## Install
 
-- **Chain configurations**: Hub and spoke chain definitions for EVM, Solana, Stellar, Sui, ICON, and Injective
-- **Token definitions**: Supported tokens, hub assets, and vault configurations
-- **Chain-specific types**: Wallet provider interfaces and transaction types for each supported blockchain
-- **Backend API types**: Type definitions for configuration API responses
+```bash
+pnpm add @sodax/types
+```
 
-## Structure
+## Usage
 
-- **`common/`**: Core types for chains, tokens, addresses, and chain configurations
-- **`constants/`**: Chain IDs, token definitions, hub vaults, and spoke chain configurations
-- **`backend/`**: API response types for configuration endpoints
-- **`evm/`**: EVM-specific transaction and wallet provider types
-- **`stellar/`**: Stellar-specific transaction and wallet provider types
-- **`solana/`**: Solana-specific transaction and wallet provider types
-- **`sui/`**: Sui-specific transaction and wallet provider types
-- **`icon/`**: ICON-specific transaction and wallet provider types
-- **`injective/`**: Injective-specific transaction and wallet provider types
+Import shared types, constants, configuration, and helpers from the root package:
 
-## Usage
+```typescript
+import {
+  ChainKeys,
+  CONFIG_VERSION,
+  getEvmChainKeyByChainId,
+  sodaxConfig,
+  supportedTokensByChain,
+} from '@sodax/types';
+
+import type {
+  Address,
+  DeepPartial,
+  EvmRawTransaction,
+  IBitcoinWalletProvider,
+  IEvmWalletProvider,
+  IWalletProvider,
+  SpokeChainKey,
+  WalletAddressProvider,
+} from '@sodax/types';
+```
+
+DEX types and constants are also available from the dedicated DEX subpath export:
 
 ```typescript
-import type { ChainId, Token, SpokeChainConfig } from '@sodax/types';
-import { CHAIN_IDS, spokeChainConfig } from '@sodax/types';
+import { concentratedLiquidityConfig, dexConfig } from '@sodax/types/dex';
+
+import type { ConcentratedLiquidityConfig, DexConfig, PoolKey } from '@sodax/types/dex';
 ```
 
+The package currently exposes only the root export (`@sodax/types`) and the DEX export (`@sodax/types/dex`). Chain-specific types such as `IEvmWalletProvider`, `BitcoinRawTransaction`, and `SolanaRawTransactionReceipt` are available from the root package.
+
+## Export Overview
+
+| Area | Examples |
+| --- | --- |
+| Shared primitives | `Address`, `Hex`, `Hash`, `Base64String`, `HttpUrl`, `TxPollingConfig` |
+| Common types and constants | `Result`, `PartnerFee`, `TxReturnType`, `apiConfig`, `solverConfig`, retry and timeout constants |
+| Chains and tokens | `ChainKeys`, `SpokeChainKey`, `ChainType`, `baseChainInfo`, `spokeChainConfig`, `supportedTokensByChain` |
+| Wallet providers | `WalletAddressProvider`, `ICoreWallet`, `IWalletProvider`, `GetWalletProviderType` |
+| Chain transaction types | `EvmRawTransaction`, `BitcoinRawTransaction`, `SolanaRawTransaction`, `StellarRawTransaction`, `SuiRawTransaction`, `IconRawTransaction`, `InjectiveRawTransaction`, `NearRawTransaction`, `StacksRawTransaction` |
+| Backend API contracts | `IConfigApi`, `GetAllConfigApiResponse`, `SubmitSwapTxRequest`, `SubmitSwapTxResponse`, `SubmitSwapTxStatusResponse` |
+| Product configuration | `sodaxConfig`, `bridgeConfig`, `swapsConfig`, `moneyMarketConfig`, `dexConfig`, `concentratedLiquidityConfig` |
+| Utilities | `DeepPartial`, `getChainType`, `getEvmChainKeyByChainId`, chain guard helpers, bnUSD token helpers |
+
+## Wallet Providers
+
+All wallet providers extend the base wallet address contract:
+
+```typescript
+interface WalletAddressProvider {
+  getWalletAddress(): Promise<string>;
+  getPublicKey?: () => Promise<string>;
+}
+```
+
+`ICoreWallet` extends `WalletAddressProvider`, and each chain-specific provider adds its own signing, transaction, and query methods. The root export includes provider interfaces for all supported chain families:
+
+| Chain family | Provider interface |
+| --- | --- |
+| EVM | `IEvmWalletProvider` |
+| Bitcoin | `IBitcoinWalletProvider` |
+| Solana | `ISolanaWalletProvider` |
+| Stellar | `IStellarWalletProvider` |
+| Sui | `ISuiWalletProvider` |
+| ICON | `IIconWalletProvider` |
+| Injective | `IInjectiveWalletProvider` |
+| NEAR | `INearWalletProvider` |
+| Stacks | `IStacksWalletProvider` |
+
+Use `IWalletProvider` for the union of all chain-specific wallet providers, or `GetWalletProviderType<C>` to map a `SpokeChainKey` or `ChainType` to the matching provider interface.
+
+```typescript
+import type { GetWalletProviderType, IEvmWalletProvider, IWalletProvider, SpokeChainKey } from '@sodax/types';
+
+type ProviderForChain<C extends SpokeChainKey> = GetWalletProviderType<C>;
+
+function isEvmProvider(provider: IWalletProvider): provider is IEvmWalletProvider {
+  return provider.chainType === 'EVM';
+}
+```

package/dist/backend/backendApi.d.ts

@@ -0,0 +1,75 @@
+import type { SpokeChainKey, IntentRelayChainIdMap } from '../chains/chains.js';
+import type { XToken } from '../chains/tokens.js';
+import type { Result, SpokeChainConfigMap } from '../common/common.js';
+import type { Address } from '../shared/shared.js';
+import type { SodaxConfig } from '../sodax-config/sodax-config.js';
+export type GetChainsApiResponse = readonly SpokeChainKey[];
+export type GetSwapTokensApiResponse = Record<SpokeChainKey, readonly XToken[]>;
+export type GetSwapTokensByChainIdApiResponse = readonly XToken[];
+export type GetMoneyMarketTokensApiResponse = Record<SpokeChainKey, readonly XToken[]>;
+export type GetMoneyMarketTokensByChainIdApiResponse = readonly XToken[];
+export type GetRelayChainIdMapApiResponse = IntentRelayChainIdMap;
+export type GetSpokeChainConfigApiResponse = SpokeChainConfigMap;
+export type GetMoneyMarketReserveAssetsApiResponse = readonly Address[];
+export type GetAllConfigApiResponse = {
+    version?: number;
+    config: SodaxConfig;
+};
+export interface IConfigApi {
+    getChains(): Promise<Result<GetChainsApiResponse>>;
+    getSwapTokens(): Promise<Result<GetSwapTokensApiResponse>>;
+    getSwapTokensByChainId(chainId: SpokeChainKey): Promise<Result<GetSwapTokensByChainIdApiResponse>>;
+    getMoneyMarketTokens(): Promise<Result<GetMoneyMarketTokensApiResponse>>;
+    getMoneyMarketTokensByChainId(chainId: SpokeChainKey): Promise<Result<GetMoneyMarketTokensByChainIdApiResponse>>;
+}
+export interface SwapIntentData {
+    intentId: string;
+    creator: string;
+    inputToken: string;
+    outputToken: string;
+    inputAmount: string;
+    minOutputAmount: string;
+    deadline: string;
+    allowPartialFill: boolean;
+    srcChain: number;
+    dstChain: number;
+    srcAddress: string;
+    dstAddress: string;
+    solver: string;
+    data: string;
+}
+export interface SubmitSwapTxRequest {
+    txHash: string;
+    srcChainKey: string;
+    walletAddress: string;
+    intent: SwapIntentData;
+    relayData: string;
+}
+export interface SubmitSwapTxResponse {
+    success: boolean;
+    message: string;
+}
+export interface GetSubmitSwapTxStatusParams {
+    txHash: string;
+    srcChainKey?: string;
+}
+export interface SubmitSwapTxStatusResult {
+    dstIntentTxHash: string;
+    packetData?: Record<string, unknown>;
+    intent_hash?: string;
+}
+export type SubmitSwapTxStatus = 'pending' | 'verifying' | 'verified' | 'relaying' | 'relayed' | 'posting_execution' | 'executed' | 'failed';
+export interface SubmitSwapTxStatusData {
+    txHash: string;
+    srcChainKey: string;
+    status: SubmitSwapTxStatus;
+    failedAtStep?: string;
+    failureReason?: string;
+    failedAttempts: number;
+    result?: SubmitSwapTxStatusResult;
+}
+export interface SubmitSwapTxStatusResponse {
+    success: boolean;
+    data: SubmitSwapTxStatusData;
+}
+//# sourceMappingURL=backendApi.d.ts.map

package/dist/backend/backendApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backendApi.d.ts","sourceRoot":"","sources":["../../src/backend/backendApi.ts"],"names":[],"mappings":"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"}

package/dist/backend/backendApi.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=backendApi.js.map

package/dist/backend/backendApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backendApi.js","sourceRoot":"","sources":["../../src/backend/backendApi.ts"],"names":[],"mappings":""}

package/dist/backend/index.d.ts

@@ -1,81 +1,2 @@
-import type { SpokeChainId, Token, HubAsset, IntentRelayChainIdMap, SpokeChainConfigMap, Address } from '../common/index.js';
-export type GetChainsApiResponse = readonly SpokeChainId[];
-export type GetSwapTokensApiResponse = Record<SpokeChainId, readonly Token[]>;
-export type GetSwapTokensByChainIdApiResponse = readonly Token[];
-export type GetMoneyMarketTokensApiResponse = Record<SpokeChainId, readonly Token[]>;
-export type GetMoneyMarketTokensByChainIdApiResponse = readonly Token[];
-export type GetHubAssetsApiResponse = Record<SpokeChainId, Record<string, HubAsset>>;
-export type GetHubAssetsByChainIdApiResponse = Record<string, HubAsset>;
-export type GetRelayChainIdMapApiResponse = IntentRelayChainIdMap;
-export type GetSpokeChainConfigApiResponse = SpokeChainConfigMap;
-export type GetMoneyMarketReserveAssetsApiResponse = readonly Address[];
-export type GetAllConfigApiResponse = {
-    version?: number;
-    supportedChains: GetChainsApiResponse;
-    supportedSwapTokens: GetSwapTokensApiResponse;
-    supportedMoneyMarketTokens: GetMoneyMarketTokensApiResponse;
-    supportedMoneyMarketReserveAssets: GetMoneyMarketReserveAssetsApiResponse;
-    supportedHubAssets: GetHubAssetsApiResponse;
-    relayChainIdMap: GetRelayChainIdMapApiResponse;
-    spokeChainConfig: GetSpokeChainConfigApiResponse;
-};
-export interface IConfigApi {
-    getChains(): Promise<GetChainsApiResponse>;
-    getSwapTokens(): Promise<GetSwapTokensApiResponse>;
-    getSwapTokensByChainId(chainId: SpokeChainId): Promise<GetSwapTokensByChainIdApiResponse>;
-    getMoneyMarketTokens(): Promise<GetMoneyMarketTokensApiResponse>;
-    getMoneyMarketTokensByChainId(chainId: SpokeChainId): Promise<GetMoneyMarketTokensByChainIdApiResponse>;
-    getHubAssets(): Promise<GetHubAssetsApiResponse>;
-    getHubAssetsByChainId(chainId: SpokeChainId): Promise<GetHubAssetsByChainIdApiResponse>;
-}
-export interface SwapIntentData {
-    intentId: string;
-    creator: string;
-    inputToken: string;
-    outputToken: string;
-    inputAmount: string;
-    minOutputAmount: string;
-    deadline: string;
-    allowPartialFill: boolean;
-    srcChain: number;
-    dstChain: number;
-    srcAddress: string;
-    dstAddress: string;
-    solver: string;
-    data: string;
-}
-export interface SubmitSwapTxRequest {
-    txHash: string;
-    srcChainId: string;
-    walletAddress: string;
-    intent: SwapIntentData;
-    relayData: string;
-}
-export interface SubmitSwapTxResponse {
-    success: boolean;
-    message: string;
-}
-export interface GetSubmitSwapTxStatusParams {
-    txHash: string;
-    srcChainId?: string;
-}
-export interface SubmitSwapTxStatusResult {
-    dstIntentTxHash: string;
-    packetData?: Record<string, unknown>;
-    intent_hash?: string;
-}
-export type SubmitSwapTxStatus = 'pending' | 'verifying' | 'verified' | 'relaying' | 'relayed' | 'posting_execution' | 'executed' | 'failed';
-export interface SubmitSwapTxStatusData {
-    txHash: string;
-    srcChainId: string;
-    status: SubmitSwapTxStatus;
-    failedAtStep?: string;
-    failureReason?: string;
-    failedAttempts: number;
-    result?: SubmitSwapTxStatusResult;
-}
-export interface SubmitSwapTxStatusResponse {
-    success: boolean;
-    data: SubmitSwapTxStatusData;
-}
+export * from './backendApi.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/backend/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/backend/index.js

@@ -1,2 +1,2 @@
-export {};
+export * from './backendApi.js';
 //# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/{btc/index.d.ts → bitcoin/bitcoin.d.ts}

@@ -1,16 +1,18 @@
-import type { WalletAddressProvider } from "../common/index.js";
-export type AddressType = "P2PKH" | "P2SH" | "P2WPKH" | "P2TR";
-/** Subset of AddressType that Sodax can actually sign/spend from. */
-export type SupportedAddressType = "P2PKH" | "P2SH" | "P2WPKH" | "P2TR";
-/** User-friendly Bitcoin address type for wallet connection. */
-export type BtcWalletAddressType = 'taproot' | 'segwit';
+import type { ICoreWallet } from '../wallet/wallet.js';
 /** Check whether an AddressType is supported for signing/spending. */
-export declare function isSupportedBitcoinAddressType(addressType: AddressType): addressType is SupportedAddressType;
+export declare function isSupportedBitcoinAddressType(addressType: string): addressType is BtcAddressType;
 /**
  * Detect Bitcoin address type from its prefix.
  * Shared utility — use this instead of duplicating prefix checks.
  */
-export declare function detectBitcoinAddressType(address: string): AddressType;
+export declare function detectBitcoinAddressType(address: string): BtcAddressType;
+export declare const BTC_WALLET_ADDRESS_TYPES: readonly ["taproot", "segwit"];
+/** User-friendly Bitcoin address type for wallet connection. */
+export type BtcWalletAddressType = (typeof BTC_WALLET_ADDRESS_TYPES)[number];
+/** Address types that Sodax supports for transactions. */
+declare const BTC_ADDRESS_TYPES: readonly ["P2PKH", "P2SH", "P2WPKH", "P2TR"];
+/** Subset of AddressType that Sodax can actually sign/spend from. */
+export type BtcAddressType = (typeof BTC_ADDRESS_TYPES)[number];
 export interface BitcoinTransactionStatus {
     confirmed: boolean;
     block_height?: number;
@@ -52,17 +54,30 @@ export interface BitcoinRawTransactionReceipt {
     fee?: number;
     status: BitcoinTransactionStatus;
 }
-export interface IBitcoinWalletProvider extends WalletAddressProvider {
+export interface RadfiDepositTxResponse {
+    base64Psbt: string;
+    fee: BitcoinFee;
+    userInputIndexes: number[];
+    txId: string;
+}
+export interface BitcoinFee {
+    feeRate: number;
+    totalFee: number;
+}
+export type BitcoinRawTransaction = {
+    from: string;
+    to: string;
+    value: bigint;
+    data: string;
+};
+export type BitcoinReturnType<Raw extends boolean> = Raw extends true ? BitcoinRawTransaction | string : Raw extends false ? string : BitcoinRawTransaction | string;
+export interface IBitcoinWalletProvider extends ICoreWallet {
+    readonly chainType: 'BITCOIN';
     /**
      * Get the wallet's Bitcoin address
      * @returns Promise resolving to the Bitcoin address
      */
     getWalletAddress(): Promise<string>;
-    /**
-     * Get the wallet's address type
-     * @returns Promise resolving to the address type
-     */
-    getAddressType(address: string): Promise<AddressType>;
     /**
      * Sign a Bitcoin transaction (PSBT format)
      * @param psbtHex - Hex-encoded PSBT transaction
@@ -71,11 +86,6 @@ export interface IBitcoinWalletProvider extends WalletAddressProvider {
     signTransaction(psbt: string, finalize?: boolean): Promise<string>;
     signEcdsaMessage(message: string): Promise<string>;
     signBip322Message(message: string): Promise<string>;
-    /**
-     * Broadcast a signed transaction to the Bitcoin network
-     * @param txHex - Hex-encoded signed transaction
-     * @returns Promise resolving to transaction hash
-     */
     /**
      * Send Bitcoin to an address
      * @param toAddress - Destination Bitcoin address
@@ -95,15 +105,5 @@ export interface UTXO {
         block_time?: number;
     };
 }
-export interface RadfiDepositTxResponse {
-    base64Psbt: string;
-    fee: Fee;
-    userInputIndexes: number[];
-    txId: string;
-}
-export interface Fee {
-    feeRate: number;
-    totalFee: number;
-}
-export type { BitcoinRawTransactionReceipt as BitcoinTransactionReceipt };
-//# sourceMappingURL=index.d.ts.map
+export {};
+//# sourceMappingURL=bitcoin.d.ts.map

package/dist/bitcoin/bitcoin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitcoin.d.ts","sourceRoot":"","sources":["../../src/bitcoin/bitcoin.ts"],"names":[],"mappings":"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"}

package/dist/{btc/index.js → bitcoin/bitcoin.js}

@@ -1,8 +1,6 @@
-/** Address types that Sodax supports for transactions. */
-const SUPPORTED_ADDRESS_TYPES = ['P2PKH', 'P2SH', 'P2WPKH', 'P2TR'];
 /** Check whether an AddressType is supported for signing/spending. */
 export function isSupportedBitcoinAddressType(addressType) {
-    return SUPPORTED_ADDRESS_TYPES.includes(addressType);
+    return BTC_ADDRESS_TYPES.includes(addressType);
 }
 /**
  * Detect Bitcoin address type from its prefix.
@@ -19,4 +17,7 @@ export function detectBitcoinAddressType(address) {
         return 'P2PKH';
     throw new Error(`Unknown Bitcoin address type: ${address}`);
 }
-//# sourceMappingURL=index.js.map
+export const BTC_WALLET_ADDRESS_TYPES = ['taproot', 'segwit'];
+/** Address types that Sodax supports for transactions. */
+const BTC_ADDRESS_TYPES = ['P2PKH', 'P2SH', 'P2WPKH', 'P2TR'];
+//# sourceMappingURL=bitcoin.js.map

package/dist/bitcoin/bitcoin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitcoin.js","sourceRoot":"","sources":["../../src/bitcoin/bitcoin.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,MAAM,UAAU,6BAA6B,CAAC,WAAmB;IAC/D,OAAQ,iBAAuC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC5E,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC5E,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IACtE,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAClG,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAC;AAIvE,0DAA0D;AAC1D,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC"}

package/dist/bitcoin/index.d.ts

@@ -0,0 +1,2 @@
+export * from './bitcoin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/bitcoin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bitcoin/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/bitcoin/index.js

@@ -0,0 +1,2 @@
+export * from './bitcoin.js';
+//# sourceMappingURL=index.js.map

package/dist/bitcoin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bitcoin/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/chains/chain-keys.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Spoke chain key constants only — no imports from tokens/chains to avoid ESM circular init.
+ */
+export declare const ChainTypeArr: readonly ["ICON", "EVM", "INJECTIVE", "SUI", "STELLAR", "SOLANA", "STACKS", "NEAR", "BITCOIN"];
+export declare const ChainKeys: {
+    readonly AVALANCHE_MAINNET: "0xa86a.avax";
+    readonly ARBITRUM_MAINNET: "0xa4b1.arbitrum";
+    readonly BASE_MAINNET: "0x2105.base";
+    readonly BSC_MAINNET: "0x38.bsc";
+    readonly INJECTIVE_MAINNET: "injective-1";
+    readonly SONIC_MAINNET: "sonic";
+    readonly ICON_MAINNET: "0x1.icon";
+    readonly SUI_MAINNET: "sui";
+    readonly OPTIMISM_MAINNET: "0xa.optimism";
+    readonly POLYGON_MAINNET: "0x89.polygon";
+    readonly SOLANA_MAINNET: "solana";
+    readonly STELLAR_MAINNET: "stellar";
+    readonly HYPEREVM_MAINNET: "hyper";
+    readonly LIGHTLINK_MAINNET: "lightlink";
+    readonly NEAR_MAINNET: "near";
+    readonly ETHEREUM_MAINNET: "ethereum";
+    readonly BITCOIN_MAINNET: "bitcoin";
+    readonly REDBELLY_MAINNET: "redbelly";
+    readonly KAIA_MAINNET: "0x2019.kaia";
+    readonly STACKS_MAINNET: "stacks";
+};
+export type ChainKey = (typeof ChainKeys)[keyof typeof ChainKeys];
+export declare const CHAIN_KEYS: ("0xa86a.avax" | "0xa4b1.arbitrum" | "0x2105.base" | "0x38.bsc" | "injective-1" | "sonic" | "0x1.icon" | "sui" | "0xa.optimism" | "0x89.polygon" | "solana" | "stellar" | "hyper" | "lightlink" | "near" | "ethereum" | "bitcoin" | "redbelly" | "0x2019.kaia" | "stacks")[];
+export declare const spokeChainKeysSet: Set<"0xa86a.avax" | "0xa4b1.arbitrum" | "0x2105.base" | "0x38.bsc" | "injective-1" | "sonic" | "0x1.icon" | "sui" | "0xa.optimism" | "0x89.polygon" | "solana" | "stellar" | "hyper" | "lightlink" | "near" | "ethereum" | "bitcoin" | "redbelly" | "0x2019.kaia" | "stacks">;
+export type ChainType = (typeof ChainTypeArr)[number];
+//# sourceMappingURL=chain-keys.d.ts.map

package/dist/chains/chain-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-keys.d.ts","sourceRoot":"","sources":["../../src/chains/chain-keys.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,YAAY,gGAUf,CAAC;AAEX,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;CAqBZ,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAElE,eAAO,MAAM,UAAU,8QAA2B,CAAC;AACnD,eAAO,MAAM,iBAAiB,+QAAsB,CAAC;AAErD,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/chains/chain-keys.js

@@ -0,0 +1,39 @@
+/**
+ * Spoke chain key constants only — no imports from tokens/chains to avoid ESM circular init.
+ */
+export const ChainTypeArr = [
+    'ICON',
+    'EVM',
+    'INJECTIVE',
+    'SUI',
+    'STELLAR',
+    'SOLANA',
+    'STACKS',
+    'NEAR',
+    'BITCOIN',
+];
+export const ChainKeys = {
+    AVALANCHE_MAINNET: '0xa86a.avax',
+    ARBITRUM_MAINNET: '0xa4b1.arbitrum',
+    BASE_MAINNET: '0x2105.base',
+    BSC_MAINNET: '0x38.bsc',
+    INJECTIVE_MAINNET: 'injective-1',
+    SONIC_MAINNET: 'sonic',
+    ICON_MAINNET: '0x1.icon',
+    SUI_MAINNET: 'sui',
+    OPTIMISM_MAINNET: '0xa.optimism',
+    POLYGON_MAINNET: '0x89.polygon',
+    SOLANA_MAINNET: 'solana',
+    STELLAR_MAINNET: 'stellar',
+    HYPEREVM_MAINNET: 'hyper',
+    LIGHTLINK_MAINNET: 'lightlink',
+    NEAR_MAINNET: 'near',
+    ETHEREUM_MAINNET: 'ethereum',
+    BITCOIN_MAINNET: 'bitcoin',
+    REDBELLY_MAINNET: 'redbelly',
+    KAIA_MAINNET: '0x2019.kaia',
+    STACKS_MAINNET: 'stacks',
+};
+export const CHAIN_KEYS = Object.values(ChainKeys);
+export const spokeChainKeysSet = new Set(CHAIN_KEYS);
+//# sourceMappingURL=chain-keys.js.map

package/dist/chains/chain-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-keys.js","sourceRoot":"","sources":["../../src/chains/chain-keys.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,MAAM;IACN,KAAK;IACL,WAAW;IACX,KAAK;IACL,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,SAAS;CACD,CAAC;AAEX,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,iBAAiB,EAAE,aAAa;IAChC,gBAAgB,EAAE,iBAAiB;IACnC,YAAY,EAAE,aAAa;IAC3B,WAAW,EAAE,UAAU;IACvB,iBAAiB,EAAE,aAAa;IAChC,aAAa,EAAE,OAAO;IACtB,YAAY,EAAE,UAAU;IACxB,WAAW,EAAE,KAAK;IAClB,gBAAgB,EAAE,cAAc;IAChC,eAAe,EAAE,cAAc;IAC/B,cAAc,EAAE,QAAQ;IACxB,eAAe,EAAE,SAAS;IAC1B,gBAAgB,EAAE,OAAO;IACzB,iBAAiB,EAAE,WAAW;IAC9B,YAAY,EAAE,MAAM;IACpB,gBAAgB,EAAE,UAAU;IAC5B,eAAe,EAAE,SAAS;IAC1B,gBAAgB,EAAE,UAAU;IAC5B,YAAY,EAAE,aAAa;IAC3B,cAAc,EAAE,QAAQ;CAChB,CAAC;AAIX,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC"}