@gardenfi/orderbook 2.5.3-beta.4 → 2.5.3-beta.6

package/dist/src/index.d.ts

@@ -1,7 +1,7 @@
 export { Orderbook } from './lib/orderbook/orderbook';
 export type * from './lib/orderbook/orderbook.types';
 export { BlockchainType } from './lib/constants/asset.types';
-export type { Asset, AssetCommon, AssetToken, BitcoinChains, Chain, ChainsByBlockchainType, ChainsByNetwork, EVMChains, LocalnetOnlyChains, MainnetOnlyChains, SolanaChains, SuiChains, StarknetChains, TestnetOnlyChains, } from './lib/constants/asset.types';
+export type { Asset, BitcoinChains, Chain, ChainsByBlockchainType, ChainsByNetwork, EVMChains, LocalnetOnlyChains, MainnetOnlyChains, SolanaChains, SuiChains, StarknetChains, TestnetOnlyChains, } from './lib/constants/asset.types';
 export * from './lib/constants/asset';
 export * from './lib/constants/localnetConstants';
 export * from './lib/constants/utils';
@@ -9,3 +9,7 @@ export { isSuiOrderResponse, ConstructUrl, discriminateOrderResponse, getOrderRe
 export { ChainAsset } from './lib/chainAsset/chainAsset';
 export type { ChainAssetString, AssetLike } from './lib/chainAsset/chainAsset';
 export { OrderAction, ParseOrderStatus, isCompleted, isDeadlinePassed, parseAction, } from './lib/orderStatus/orderStatus';
+export { AssetManager } from './lib/assetManager/AssetManager';
+export type { ApiChainData, ApiChainsResponse, AssetManagerState, BaseChainData, ChainData, FiatResponse, } from './lib/assetManager/types';
+export { RouteValidator, buildRouteMatrix, } from './lib/assetManager/routeValidator/routeValidator';
+export type { RoutePolicy } from './lib/assetManager/routeValidator/routeValidator';

package/dist/src/lib/assetManager/AssetManager.d.ts

@@ -0,0 +1,96 @@
+import { RouteValidator } from './routeValidator/routeValidator';
+import { Assets, ChainData, Chains } from './types';
+import { ChainAsset } from '../chainAsset/chainAsset';
+import { Asset, Chain } from '../constants/asset.types';
+
+/**
+ * AssetManager
+ *
+ * A comprehensive manager for handling asset and chain data across the application.
+ * Responsibilities:
+ * - Fetching and caching asset/chain data from API
+ * - Managing route validation between assets
+ * - Managing asset selection state
+ * - Building and maintaining route matrices for performance optimization
+ */
+export declare class AssetManager {
+    private _allChains;
+    private _allAssets;
+    private _assets;
+    private _chains;
+    private _routeValidator;
+    private _routeMatrix;
+    private _isLoading;
+    private _error;
+    private readonly url;
+    private apiKey;
+    constructor(url: string, apiKey: string);
+    get allChains(): Chains | null;
+    get allAssets(): Assets | null;
+    get assets(): Assets | null;
+    get chains(): Chains | null;
+    get routeValidator(): RouteValidator | null;
+    get routeMatrix(): Record<string, ChainAsset[]> | null;
+    get isLoading(): boolean;
+    get error(): string | null;
+    /**
+     * Initialize the AssetManager by fetching all required data
+     */
+    initialize(): Promise<void>;
+    /**
+     * Fetch and cache asset and chain data from API
+     */
+    fetchAndSetAssetsAndChains(): Promise<void>;
+    /**
+     * Check if a swap route from one asset to another is valid
+     */
+    isRouteValid(from: Asset, to: Asset): boolean;
+    /**
+     * Get all valid destination assets for a given source asset
+     */
+    getValidDestinations(fromAsset: Asset): Asset[];
+    /**
+     * Get asset by chain and token address
+     */
+    getAsset(asset: string | Asset | ChainAsset): Asset | undefined;
+    /**
+     * Get all assets for a specific chain
+     */
+    getAssetsByChain(chain: Chain): Asset[];
+    /**
+     * Search assets by symbol or name
+     */
+    searchAssets(query: string): Asset[];
+    /**
+     * Get chain data by chain identifier
+     */
+    getChain(chain: Chain): ChainData | undefined;
+    /**
+     * Initialize the route validator
+     */
+    private initializeRouteValidator;
+    /**
+     * Build route matrix for fast O(1) route lookups
+     */
+    private buildRouteMatrix;
+    /**
+     * Process raw API data into structured format
+     */
+    private processApiData;
+    /**
+     * Parse chain identifier from string
+     */
+    private parseChainIdentifier;
+    /**
+     * Format chain name for display
+     */
+    private formatChainName;
+    /**
+     * Refresh all data
+     */
+    refresh(): Promise<void>;
+    /**
+     * Clear all cached data
+     */
+    clear(): void;
+}

package/dist/src/lib/assetManager/index.d.ts

@@ -0,0 +1,2 @@
+export { AssetManager } from './AssetManager';
+export * from './types';

package/dist/src/lib/assetManager/routeValidator/routeValidator.d.ts

@@ -0,0 +1,31 @@
+import { ChainAsset } from '../../chainAsset/chainAsset';
+
+interface RoutePolicy {
+    default: 'open' | 'closed';
+    isolation_groups: string[];
+    blacklist_pairs: string[];
+    whitelist_overrides: string[];
+}
+declare class RouteValidator {
+    private readonly apiBaseUrl;
+    private readonly apiKey;
+    private policy;
+    constructor(apiBaseUrl: string, apiKey: string);
+    loadPolicy(): Promise<void>;
+    isValidRoute(fromAsset: ChainAsset, toAsset: ChainAsset): boolean;
+    isAssetInIsolationGroup(asset: ChainAsset): boolean;
+    getValidDestinations(fromAsset: ChainAsset, allAssets: ChainAsset[]): ChainAsset[];
+    getAllValidRoutes(assets: ChainAsset[]): Array<{
+        from: ChainAsset;
+        to: ChainAsset;
+    }>;
+    private ensurePolicyLoaded;
+    private findIsolationGroup;
+    private matchesIsolationGroup;
+    private matchesPatternList;
+    private matchesRoutePattern;
+    private parsePattern;
+    private matchesAssetPattern;
+}
+declare function buildRouteMatrix(assets: ChainAsset[], validator: RouteValidator): Record<string, ChainAsset[]>;
+export { RouteValidator, buildRouteMatrix, type RoutePolicy };

package/dist/src/lib/assetManager/types.d.ts

@@ -0,0 +1,39 @@
+import { Asset, Chain } from '../constants/asset.types';
+
+export type BaseChainData = {
+    id: string;
+    chain: string | Chain;
+    icon: string;
+    explorer_url: string;
+    confirmation_target: number;
+    source_timelock: string;
+    destination_timelock: string;
+    supported_htlc_schemas: string[];
+    supported_token_schemas: string[];
+};
+export type ChainData = BaseChainData & {
+    chain: Chain;
+    name: string;
+};
+export type ApiChainData = BaseChainData & {
+    assets: Asset[];
+};
+export type ApiChainsResponse = {
+    status: string;
+    result: ApiChainData[];
+};
+export type FiatResponse = {
+    status: string;
+    result: Record<string, string>;
+};
+export type Assets = Record<string, Asset>;
+export type Chains = Partial<Record<Chain, ChainData>>;
+export type AssetManagerState = {
+    allChains: Chains | null;
+    allAssets: Assets | null;
+    assets: Assets | null;
+    chains: Chains | null;
+    fiatData: Record<string, number | undefined>;
+    isLoading: boolean;
+    error: string | null;
+};