@gardenfi/orderbook 2.5.3-beta.2 → 2.5.3-beta.20

package/dist/index7.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@gardenfi/utils"),i=require("./index3.cjs"),p=(t,r,d)=>{const a=t.endpoint(r);return d&&Object.entries(d).forEach(([l,n])=>{n!==void 0&&(Array.isArray(n)?a.searchParams.append(l,n.join(",")):a.searchParams.append(l,n.toString()))}),a},c=t=>e.hasKeys(t,["typed_data","initiate_transaction"])&&typeof t.initiate_transaction=="object"&&t.initiate_transaction&&e.hasKeys(t.initiate_transaction,["to","value","data","gas_limit","chain_id"]),o=t=>e.hasKeys(t,["typed_data","initiate_transaction"])&&typeof t.initiate_transaction=="object"&&t.initiate_transaction&&e.hasKeys(t.initiate_transaction,["to","selector","calldata"]),s=t=>e.hasKeys(t,["to","amount"])&&typeof t.to=="string"&&typeof t.amount=="number",y=t=>e.hasKeys(t,["versioned_tx"])&&typeof t.versioned_tx=="string",u=t=>e.hasKeys(t,["ptb_bytes"])&&Array.isArray(t.ptb_bytes)&&t.ptb_bytes.every(r=>typeof r=="number"),f=t=>e.hasKeys(t,["source_swap","destination_swap"])&&typeof t.source_swap=="object"&&typeof t.destination_swap=="object";function h(t){return c(t)?{type:i.BlockchainType.evm,...t}:o(t)?{type:i.BlockchainType.starknet,...t}:s(t)?{type:i.BlockchainType.bitcoin,...t}:y(t)?{type:i.BlockchainType.solana,...t}:u(t)?{type:i.BlockchainType.sui,...t}:null}function _(t){return c(t)?i.BlockchainType.evm:o(t)?i.BlockchainType.starknet:s(t)?i.BlockchainType.bitcoin:y(t)?i.BlockchainType.solana:u(t)?i.BlockchainType.sui:null}exports.ConstructUrl=p;exports.discriminateOrderResponse=h;exports.getOrderResponseType=_;exports.isBitcoinOrderResponse=s;exports.isEvmOrderResponse=c;exports.isOrder=f;exports.isSolanaOrderResponse=y;exports.isStarknetOrderResponse=o;exports.isSuiOrderResponse=u;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@gardenfi/utils"),i=require("./index3.cjs"),p=(t,r,d)=>{const a=t.endpoint(r);return d&&Object.entries(d).forEach(([l,n])=>{n!==void 0&&(Array.isArray(n)?a.searchParams.append(l,n.join(",")):a.searchParams.append(l,n.toString()))}),a},c=t=>e.hasKeys(t,["typed_data","initiate_transaction"])&&typeof t.initiate_transaction=="object"&&t.initiate_transaction&&e.hasKeys(t.initiate_transaction,["to","value","data","gas_limit","chain_id"]),s=t=>e.hasKeys(t,["typed_data","initiate_transaction"])&&typeof t.initiate_transaction=="object"&&t.initiate_transaction&&e.hasKeys(t.initiate_transaction,["to","selector","calldata"]),o=t=>e.hasKeys(t,["to","amount"])&&typeof t.to=="string"&&typeof t.amount=="string",y=t=>e.hasKeys(t,["versioned_tx"])&&typeof t.versioned_tx=="string",u=t=>e.hasKeys(t,["ptb_bytes"])&&Array.isArray(t.ptb_bytes)&&t.ptb_bytes.every(r=>typeof r=="number"),f=t=>e.hasKeys(t,["source_swap","destination_swap"])&&typeof t.source_swap=="object"&&typeof t.destination_swap=="object";function h(t){return c(t)?{type:i.BlockchainType.evm,...t}:s(t)?{type:i.BlockchainType.starknet,...t}:o(t)?{type:i.BlockchainType.bitcoin,...t}:y(t)?{type:i.BlockchainType.solana,...t}:u(t)?{type:i.BlockchainType.sui,...t}:null}function _(t){return c(t)?i.BlockchainType.evm:s(t)?i.BlockchainType.starknet:o(t)?i.BlockchainType.bitcoin:y(t)?i.BlockchainType.solana:u(t)?i.BlockchainType.sui:null}exports.ConstructUrl=p;exports.discriminateOrderResponse=h;exports.getOrderResponseType=_;exports.isBitcoinOrderResponse=o;exports.isEvmOrderResponse=c;exports.isOrder=f;exports.isSolanaOrderResponse=y;exports.isStarknetOrderResponse=s;exports.isSuiOrderResponse=u;

package/dist/index7.js

@@ -1,6 +1,6 @@
 import { hasKeys as r } from "@gardenfi/utils";
 import { BlockchainType as i } from "./index3.js";
-const m = (t, a, o) => {
+const l = (t, a, o) => {
   const e = t.endpoint(a);
   return o && Object.entries(o).forEach(([c, n]) => {
     n !== void 0 && (Array.isArray(n) ? e.searchParams.append(c, n.join(",")) : e.searchParams.append(c, n.toString()));
@@ -11,7 +11,7 @@ const m = (t, a, o) => {
   "data",
   "gas_limit",
   "chain_id"
-]), f = (t) => r(t, ["typed_data", "initiate_transaction"]) && typeof t.initiate_transaction == "object" && t.initiate_transaction && r(t.initiate_transaction, ["to", "selector", "calldata"]), y = (t) => r(t, ["to", "amount"]) && typeof t.to == "string" && typeof t.amount == "number", d = (t) => r(t, ["versioned_tx"]) && typeof t.versioned_tx == "string", _ = (t) => r(t, ["ptb_bytes"]) && Array.isArray(t.ptb_bytes) && t.ptb_bytes.every((a) => typeof a == "number"), l = (t) => r(t, ["source_swap", "destination_swap"]) && typeof t.source_swap == "object" && typeof t.destination_swap == "object";
+]), f = (t) => r(t, ["typed_data", "initiate_transaction"]) && typeof t.initiate_transaction == "object" && t.initiate_transaction && r(t.initiate_transaction, ["to", "selector", "calldata"]), y = (t) => r(t, ["to", "amount"]) && typeof t.to == "string" && typeof t.amount == "string", d = (t) => r(t, ["versioned_tx"]) && typeof t.versioned_tx == "string", _ = (t) => r(t, ["ptb_bytes"]) && Array.isArray(t.ptb_bytes) && t.ptb_bytes.every((a) => typeof a == "number"), m = (t) => r(t, ["source_swap", "destination_swap"]) && typeof t.source_swap == "object" && typeof t.destination_swap == "object";
 function p(t) {
   return u(t) ? {
     type: i.evm,
@@ -34,12 +34,12 @@ function O(t) {
   return u(t) ? i.evm : f(t) ? i.starknet : y(t) ? i.bitcoin : d(t) ? i.solana : _(t) ? i.sui : null;
 }
 export {
-  m as ConstructUrl,
+  l as ConstructUrl,
   p as discriminateOrderResponse,
   O as getOrderResponseType,
   y as isBitcoinOrderResponse,
   u as isEvmOrderResponse,
-  l as isOrder,
+  m as isOrder,
   d as isSolanaOrderResponse,
   f as isStarknetOrderResponse,
   _ as isSuiOrderResponse

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 } from './lib/assetManager/routeValidator/routeValidator';
+export type { RoutePolicy } from './lib/assetManager/routeValidator/routeValidator';

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

@@ -0,0 +1,82 @@
+import { Url, AsyncResult, IAuth } from '@gardenfi/utils';
+import { RouteValidator } from './routeValidator/routeValidator';
+import { Assets, ChainData, Chains } from './types';
+import { ChainAsset } from '../chainAsset/chainAsset';
+import { Asset, Chain } from '../constants/asset.types';
+
+type AssetManagerUrlConfig = {
+    baseUrl: string | Url;
+    assetsUrl?: string | Url;
+    policyUrl?: string | Url;
+};
+/**
+ * AssetManager
+ *
+ * It fetches asset data from our API, caches it locally, and provides methods
+ * to check if routes between assets are valid. Also builds a route matrix
+ * to make route lookups fast.
+ */
+export declare class AssetManager {
+    assets: Assets | null;
+    chains: Chains | null;
+    routeValidator: RouteValidator;
+    routeMatrix: Record<string, ChainAsset[]> | null;
+    isLoading: boolean;
+    error: string | null;
+    private readonly urls;
+    private auth;
+    constructor(urlConfig: AssetManagerUrlConfig, apiKey: IAuth | string);
+    /**
+     * Initialize the AssetManager by fetching all required data
+     */
+    initialize(): Promise<void>;
+    /**
+     * Fetch and cache asset and chain data from API
+     */
+    fetchAndSetAssetsAndChains(): AsyncResult<string, string>;
+    /**
+     * Check if a swap route from one asset to another is valid
+     */
+    isRouteValid(from: Asset, to: Asset): Promise<boolean>;
+    /**
+     * Get all valid destination assets for a given source asset
+     */
+    getValidDestinations(asset: 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;
+    /**
+     * Build route matrix for fast O(1) route lookups
+     */
+    buildRouteMatrix(): Promise<void>;
+    /**
+     * 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>;
+}
+export {};

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,76 @@
+import { AsyncResult, IAuth } from '@gardenfi/utils';
+import { ChainAsset } from '../../chainAsset/chainAsset';
+import { default as NodeCache } from 'node-cache';
+
+type RoutePolicy = {
+    default: 'open' | 'closed';
+    isolation_groups: string[];
+    blacklist_pairs: string[];
+    whitelist_overrides: string[];
+};
+declare class RouteValidator {
+    policy: NodeCache;
+    private static readonly POLICY_CACHE_KEY;
+    private apiBaseUrl;
+    private auth;
+    constructor(apiBaseUrl: string, apiKey: string | IAuth);
+    getPolicy(): RoutePolicy | undefined;
+    setPolicy(policy: RoutePolicy): RoutePolicy;
+    /**
+     * Loads the current route policy, cached or via API.
+     */
+    loadPolicy(): AsyncResult<RoutePolicy, string>;
+    /**
+     * Checks if a given route is valid based on all route rules.
+     */
+    isValidRoute(fromAsset: ChainAsset, toAsset: ChainAsset): Promise<boolean>;
+    /**
+     * Returns all valid destinations for a given source asset.
+     */
+    getValidDestinations(fromAsset: ChainAsset, allAssets: ChainAsset[]): Promise<ChainAsset[]>;
+    /**
+     * Returns every valid route (from-to pair) among the provided assets.
+     */
+    getAllValidRoutes(assets: ChainAsset[]): Promise<Array<{
+        from: ChainAsset;
+        to: ChainAsset;
+    }>>;
+    /**
+     * Turns policy string rules into sorted ParsedRule objects.
+     */
+    private preprocessRules;
+    /**
+     * Parses a rule string (e.g. "ethereum:usdc -> base:usdt") into parts.
+     */
+    private parseRule;
+    /**
+     * Gives a specificity score to a rule pattern for prioritizing.
+     */
+    private calculateSpecificity;
+    /**
+     * Finds the first matching rule for an asset given the rule "side".
+     */
+    private findMatchingRule;
+    /**
+     * Checks if a given toAsset matches the rule's destination side.
+     */
+    private matchesRuleDestination;
+    /**
+     * Checks if a given fromAsset matches the rule's source side.
+     */
+    private matchesRuleSource;
+    /**
+     * Checks if any rule in a list matches fromAsset and toAsset.
+     */
+    private matchesRuleList;
+    /**
+     * Checks if a rule matches fromAsset and toAsset (forward or backward if bidirectional).
+     */
+    private matchesRule;
+    /**
+     * Checks if an asset string matches a rule's pattern (wildcards supported).
+     */
+    private matchesAssetPattern;
+    buildRouteMatrix(assets: ChainAsset[]): Promise<Record<string, ChainAsset[]>>;
+}
+export { RouteValidator, 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;
+};

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

@@ -0,0 +1,9 @@
+import { Url } from '@gardenfi/utils';
+import { ChainAsset } from '../chainAsset/chainAsset';
+
+export declare function parseAssetNameSymbol(input: string | undefined, assetId?: string | ChainAsset, fallbackSymbol?: string): {
+    name: string;
+    symbol: string;
+};
+export declare function ensureUrl(value: string | Url): Url;
+export declare function buildDefaultEndpoint(baseUrl: Url, path: string): string;