@catalyst-team/poly-sdk 0.2.0 → 0.3.0

package/dist/__tests__/integration/trading-service.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trading-service.integration.test.js","sourceRoot":"","sources":["../../../src/__tests__/integration/trading-service.integration.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/test-utils.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Test Utilities for poly-sdk
+ *
+ * Provides mock implementations and test helpers for unit testing.
+ */
+export declare const mockClobMarket: {
+    conditionId: string;
+    question: string;
+    description: string;
+    marketSlug: string;
+    tokens: {
+        tokenId: string;
+        outcome: string;
+        price: number;
+    }[];
+    acceptingOrders: boolean;
+    endDateIso: string;
+    active: boolean;
+    closed: boolean;
+};
+export declare const mockOrderbook: {
+    bids: {
+        price: number;
+        size: number;
+    }[];
+    asks: {
+        price: number;
+        size: number;
+    }[];
+    timestamp: number;
+};
+export declare const mockNoOrderbook: {
+    bids: {
+        price: number;
+        size: number;
+    }[];
+    asks: {
+        price: number;
+        size: number;
+    }[];
+    timestamp: number;
+};
+export declare const mockGammaMarket: {
+    id: string;
+    conditionId: string;
+    slug: string;
+    question: string;
+    outcomes: string[];
+    outcomePrices: number[];
+    volume: number;
+    volume24hr: number;
+    liquidity: number;
+    spread: number;
+    endDate: Date;
+    active: boolean;
+    closed: boolean;
+};
+export declare const mockPosition: {
+    asset: string;
+    conditionId: string;
+    outcome: string;
+    outcomeIndex: number;
+    size: number;
+    avgPrice: number;
+    curPrice: number;
+    cashPnl: number;
+    percentPnl: number;
+    title: string;
+};
+export declare class MockRateLimiter {
+    execute<T>(_apiType: string, fn: () => Promise<T>): Promise<T>;
+}
+export declare class MockCache {
+    private cache;
+    getOrSet<T>(key: string, ttl: number, fn: () => Promise<T>): Promise<T>;
+    clear(): void;
+}
+export declare function createMockFetch(responses: Record<string, unknown>): import("vitest").Mock<(url: string) => Promise<{
+    ok: boolean;
+    status: number;
+    json: () => Promise<unknown>;
+}>>;
+export declare function expectOrderbookSorted(orderbook: {
+    bids: Array<{
+        price: number;
+    }>;
+    asks: Array<{
+        price: number;
+    }>;
+}): void;
+export declare function waitFor(ms: number): Promise<void>;
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/__tests__/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../src/__tests__/test-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;CAqB1B,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;CAYzB,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;CAU3B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;CAc3B,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;CAWxB,CAAC;AAIF,qBAAa,eAAe;IACpB,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAGrE;AAID,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAA0D;IAEjE,QAAQ,CAAC,CAAC,EACd,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;IAUb,KAAK,IAAI,IAAI;CAGd;AAID,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,+BACvC,MAAM;;;;IAoBhC;AAID,wBAAgB,qBAAqB,CAAC,SAAS,EAAE;IAC/C,IAAI,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/B,IAAI,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChC,GAAG,IAAI,CAaP;AAID,wBAAsB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvD"}

package/dist/__tests__/test-utils.js

@@ -0,0 +1,143 @@
+/**
+ * Test Utilities for poly-sdk
+ *
+ * Provides mock implementations and test helpers for unit testing.
+ */
+import { vi } from 'vitest';
+// ===== Mock Data =====
+export const mockClobMarket = {
+    conditionId: '0x82ace55cdcba920112a2b3548f21e6e117730144db4dd580456aaecf1a2ad751',
+    question: 'Will BTC reach $100k by end of 2024?',
+    description: 'This market resolves YES if Bitcoin reaches $100,000 USD.',
+    marketSlug: 'will-btc-reach-100k',
+    tokens: [
+        {
+            tokenId: '21742633143463906290569050155826241533067272736897614950488156847949938836455',
+            outcome: 'Yes',
+            price: 0.65,
+        },
+        {
+            tokenId: '79707176503087022804581743747659199568535926050896809695934676056217229461419',
+            outcome: 'No',
+            price: 0.35,
+        },
+    ],
+    acceptingOrders: true,
+    endDateIso: '2024-12-31T23:59:59Z',
+    active: true,
+    closed: false,
+};
+export const mockOrderbook = {
+    bids: [
+        { price: 0.55, size: 1000 },
+        { price: 0.54, size: 500 },
+        { price: 0.53, size: 750 },
+    ],
+    asks: [
+        { price: 0.57, size: 800 },
+        { price: 0.58, size: 600 },
+        { price: 0.59, size: 400 },
+    ],
+    timestamp: Date.now(),
+};
+export const mockNoOrderbook = {
+    bids: [
+        { price: 0.43, size: 900 },
+        { price: 0.42, size: 450 },
+    ],
+    asks: [
+        { price: 0.45, size: 700 },
+        { price: 0.46, size: 500 },
+    ],
+    timestamp: Date.now(),
+};
+export const mockGammaMarket = {
+    id: '12345',
+    conditionId: '0x82ace55cdcba920112a2b3548f21e6e117730144db4dd580456aaecf1a2ad751',
+    slug: 'will-btc-reach-100k',
+    question: 'Will BTC reach $100k by end of 2024?',
+    outcomes: ['Yes', 'No'],
+    outcomePrices: [0.65, 0.35],
+    volume: 5000000,
+    volume24hr: 250000,
+    liquidity: 100000,
+    spread: 0.02,
+    endDate: new Date('2024-12-31T23:59:59Z'),
+    active: true,
+    closed: false,
+};
+export const mockPosition = {
+    asset: '21742633143463906290569050155826241533067272736897614950488156847949938836455',
+    conditionId: '0x82ace55cdcba920112a2b3548f21e6e117730144db4dd580456aaecf1a2ad751',
+    outcome: 'Yes',
+    outcomeIndex: 0,
+    size: 100,
+    avgPrice: 0.50,
+    curPrice: 0.65,
+    cashPnl: 15,
+    percentPnl: 0.30,
+    title: 'Will BTC reach $100k?',
+};
+// ===== Mock RateLimiter =====
+export class MockRateLimiter {
+    async execute(_apiType, fn) {
+        return fn();
+    }
+}
+// ===== Mock Cache =====
+export class MockCache {
+    cache = new Map();
+    async getOrSet(key, ttl, fn) {
+        const cached = this.cache.get(key);
+        if (cached && cached.expires > Date.now()) {
+            return cached.value;
+        }
+        const value = await fn();
+        this.cache.set(key, { value, expires: Date.now() + ttl });
+        return value;
+    }
+    clear() {
+        this.cache.clear();
+    }
+}
+// ===== Mock Fetch =====
+export function createMockFetch(responses) {
+    return vi.fn(async (url) => {
+        const urlObj = new URL(url);
+        const path = urlObj.pathname;
+        for (const [pattern, response] of Object.entries(responses)) {
+            if (path.includes(pattern)) {
+                return {
+                    ok: true,
+                    status: 200,
+                    json: async () => response,
+                };
+            }
+        }
+        return {
+            ok: false,
+            status: 404,
+            json: async () => ({ error: 'Not found' }),
+        };
+    });
+}
+// ===== Assertion Helpers =====
+export function expectOrderbookSorted(orderbook) {
+    // Bids should be descending
+    for (let i = 1; i < orderbook.bids.length; i++) {
+        if (orderbook.bids[i].price > orderbook.bids[i - 1].price) {
+            throw new Error('Bids are not sorted descending');
+        }
+    }
+    // Asks should be ascending
+    for (let i = 1; i < orderbook.asks.length; i++) {
+        if (orderbook.asks[i].price < orderbook.asks[i - 1].price) {
+            throw new Error('Asks are not sorted ascending');
+        }
+    }
+}
+// ===== Time Helpers =====
+export async function waitFor(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=test-utils.js.map

package/dist/__tests__/test-utils.js.map

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

package/dist/clients/bridge-client.d.ts

@@ -0,0 +1,388 @@
+/**
+ * Bridge Client for Polymarket Cross-Chain Deposits
+ *
+ * Enables depositing assets from multiple chains (Ethereum, etc.)
+ * and having them automatically converted to USDC.e on Polygon for trading.
+ *
+ * Flow:
+ * 1. Request deposit addresses for your Polymarket wallet
+ * 2. Send assets to the unique deposit address for each chain/token
+ * 3. Assets are automatically bridged and swapped to USDC.e on Polygon
+ * 4. USDC.e is credited to your Polymarket account
+ *
+ * @see https://docs.polymarket.com/developers/misc-endpoints/bridge-deposit
+ * @see https://docs.polymarket.com/developers/misc-endpoints/bridge-supported-assets
+ */
+/**
+ * Supported asset information from the bridge
+ */
+export interface BridgeSupportedAsset {
+    /** Blockchain chain ID (e.g., 1 for Ethereum) */
+    chainId: number;
+    /** Human-readable chain name (e.g., "Ethereum") */
+    chainName: string;
+    /** Token contract address on the source chain */
+    tokenAddress: string;
+    /** Token symbol (e.g., "USDC", "ETH") */
+    tokenSymbol: string;
+    /** Token name (e.g., "USD Coin") */
+    tokenName: string;
+    /** Token decimals (e.g., 6 for USDC) */
+    decimals: number;
+    /** Minimum deposit amount in token units */
+    minDeposit: string;
+    /** Minimum deposit amount in USD */
+    minDepositUsd: number;
+    /** Whether this asset is currently active */
+    active: boolean;
+}
+/**
+ * Deposit address for a specific chain/token combination
+ */
+export interface DepositAddress {
+    /** Blockchain chain ID */
+    chainId: number;
+    /** Human-readable chain name */
+    chainName: string;
+    /** Token contract address on source chain */
+    tokenAddress: string;
+    /** Token symbol */
+    tokenSymbol: string;
+    /** Unique deposit address to send funds to */
+    depositAddress: string;
+    /** Minimum deposit amount */
+    minDeposit: string;
+}
+/**
+ * Response from creating deposit addresses
+ *
+ * The Bridge API returns a single universal deposit address structure.
+ * - EVM address: Used for all EVM chains (Ethereum, Polygon, Arbitrum, Base, Optimism)
+ * - SVM address: Used for Solana
+ * - BTC address: Used for Bitcoin
+ *
+ * @example Response from API:
+ * ```json
+ * {
+ *   "address": {
+ *     "evm": "0x1234...",
+ *     "svm": "ABC123...",
+ *     "btc": "bc1q..."
+ *   }
+ * }
+ * ```
+ */
+export interface CreateDepositResponse {
+    /** Universal deposit addresses for different chain types */
+    address: {
+        /** EVM deposit address (Ethereum, Polygon, Arbitrum, Base, Optimism) */
+        evm: string;
+        /** Solana deposit address */
+        svm: string;
+        /** Bitcoin deposit address */
+        btc: string;
+    };
+}
+/**
+ * Deposit status tracking
+ */
+export interface DepositStatus {
+    /** Unique deposit ID */
+    depositId: string;
+    /** Source chain ID */
+    sourceChainId: number;
+    /** Source transaction hash */
+    sourceTxHash: string;
+    /** Amount deposited */
+    amount: string;
+    /** Token symbol */
+    tokenSymbol: string;
+    /** Status of the deposit */
+    status: 'pending' | 'bridging' | 'swapping' | 'completed' | 'failed';
+    /** Destination transaction hash (when completed) */
+    destinationTxHash?: string;
+    /** USDC.e amount received (when completed) */
+    usdceReceived?: string;
+    /** Error message (if failed) */
+    errorMessage?: string;
+    /** Timestamp of last update */
+    updatedAt: string;
+}
+/**
+ * Bridge configuration
+ */
+export interface BridgeConfig {
+    /** Base URL for the bridge API (default: https://bridge.polymarket.com) */
+    baseUrl?: string;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+}
+export declare const SUPPORTED_CHAINS: {
+    readonly ETHEREUM: {
+        readonly chainId: 1;
+        readonly name: "Ethereum";
+        readonly rpcUrl: "https://eth.llamarpc.com";
+    };
+    readonly POLYGON: {
+        readonly chainId: 137;
+        readonly name: "Polygon";
+        readonly rpcUrl: "https://polygon-rpc.com";
+    };
+};
+export declare const BRIDGE_TOKENS: {
+    readonly ETH_USDC: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48";
+    readonly ETH_WETH: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2";
+    readonly ETH_DAI: "0x6B175474E89094C44Da98b954EeDeaC495271d0F";
+    readonly POLYGON_USDC_E: "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174";
+    readonly POLYGON_NATIVE_USDC: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359";
+};
+/**
+ * Client for interacting with Polymarket's cross-chain bridge
+ *
+ * @example
+ * ```typescript
+ * const bridge = new BridgeClient();
+ *
+ * // Get supported assets
+ * const assets = await bridge.getSupportedAssets();
+ * console.log(`Supported: ${assets.map(a => a.tokenSymbol).join(', ')}`);
+ *
+ * // Create deposit addresses for your wallet
+ * const deposit = await bridge.createDepositAddresses('0xYourAddress');
+ * const ethUsdc = deposit.depositAddresses.find(
+ *   d => d.chainName === 'Ethereum' && d.tokenSymbol === 'USDC'
+ * );
+ * console.log(`Send USDC on Ethereum to: ${ethUsdc.depositAddress}`);
+ * ```
+ */
+export declare class BridgeClient {
+    private baseUrl;
+    private timeout;
+    constructor(config?: BridgeConfig);
+    /**
+     * Get all supported assets for bridge deposits
+     *
+     * @returns Array of supported assets with their chain/token details
+     *
+     * @example
+     * ```typescript
+     * const assets = await bridge.getSupportedAssets();
+     * for (const asset of assets) {
+     *   console.log(`${asset.chainName} ${asset.tokenSymbol}: min $${asset.minDepositUsd}`);
+     * }
+     * ```
+     */
+    getSupportedAssets(): Promise<BridgeSupportedAsset[]>;
+    /**
+     * Get unique deposit addresses for a Polymarket wallet
+     *
+     * The Bridge API returns a universal deposit address structure:
+     * - A single EVM address works for ALL EVM chains (Ethereum, Polygon, Arbitrum, Base, Optimism)
+     * - A Solana address for SVM deposits
+     * - A Bitcoin address for BTC deposits
+     *
+     * Funds sent to these addresses are automatically bridged to Polygon
+     * and converted to USDC.e for your Polymarket account.
+     *
+     * @param walletAddress - Your Polymarket wallet address (EOA address)
+     * @returns Universal deposit addresses for EVM, Solana, and Bitcoin
+     *
+     * @example
+     * ```typescript
+     * const result = await bridge.createDepositAddresses('0xYourPolymarketWallet');
+     *
+     * // The EVM address works for Ethereum, Polygon, Arbitrum, Base, Optimism
+     * console.log(`EVM deposit address: ${result.address.evm}`);
+     *
+     * // For Solana deposits
+     * console.log(`Solana deposit address: ${result.address.svm}`);
+     *
+     * // For Bitcoin deposits
+     * console.log(`Bitcoin deposit address: ${result.address.btc}`);
+     * ```
+     */
+    createDepositAddresses(walletAddress: string): Promise<CreateDepositResponse>;
+    /**
+     * Get the EVM deposit address for a wallet
+     *
+     * This address works for ALL supported EVM chains:
+     * - Ethereum (chainId: 1)
+     * - Polygon (chainId: 137)
+     * - Arbitrum (chainId: 42161)
+     * - Base (chainId: 8453)
+     * - Optimism (chainId: 10)
+     *
+     * @param walletAddress - Your Polymarket wallet address
+     * @returns The universal EVM deposit address
+     *
+     * @example
+     * ```typescript
+     * const evmAddr = await bridge.getEvmDepositAddress('0xYourWallet');
+     * // Send Native USDC on Polygon to this address
+     * // Or send USDC on Ethereum to this address
+     * console.log(`Deposit to: ${evmAddr}`);
+     * ```
+     */
+    getEvmDepositAddress(walletAddress: string): Promise<string>;
+    /**
+     * Get the Solana deposit address for a wallet
+     *
+     * @param walletAddress - Your Polymarket wallet address
+     * @returns The Solana deposit address
+     */
+    getSolanaDepositAddress(walletAddress: string): Promise<string>;
+    /**
+     * Get the Bitcoin deposit address for a wallet
+     *
+     * @param walletAddress - Your Polymarket wallet address
+     * @returns The Bitcoin deposit address
+     */
+    getBtcDepositAddress(walletAddress: string): Promise<string>;
+    /**
+     * @deprecated Use getEvmDepositAddress(), getSolanaDepositAddress(), or getBtcDepositAddress() instead.
+     *
+     * The Bridge API returns universal addresses by chain type (EVM/SVM/BTC),
+     * not by specific chain/token combinations.
+     *
+     * For EVM chains (Ethereum, Polygon, Arbitrum, Base, Optimism), use getEvmDepositAddress()
+     */
+    getDepositAddress(address: string, _chainId: number, _tokenSymbol: string): Promise<DepositAddress | null>;
+    /**
+     * Check if a chain/token combination is supported
+     *
+     * @param chainId - The chain ID to check
+     * @param tokenSymbol - The token symbol to check
+     * @returns True if supported, false otherwise
+     */
+    isSupported(chainId: number, tokenSymbol: string): Promise<boolean>;
+    /**
+     * Get minimum deposit amount for a chain/token
+     *
+     * @param chainId - The chain ID
+     * @param tokenSymbol - The token symbol
+     * @returns Minimum deposit info or null if not supported
+     */
+    getMinDeposit(chainId: number, tokenSymbol: string): Promise<{
+        amount: string;
+        usd: number;
+    } | null>;
+    /**
+     * Format deposit instructions for a user
+     *
+     * @param walletAddress - The Polymarket wallet address
+     * @returns Formatted instructions string
+     */
+    getDepositInstructions(walletAddress: string): Promise<string>;
+    private fetch;
+}
+import { ethers } from 'ethers';
+export interface DepositResult {
+    success: boolean;
+    txHash?: string;
+    amount: string;
+    depositAddress: string;
+    error?: string;
+}
+export interface DepositOptions {
+    /** Chain ID for the deposit (default: 137 for Polygon) */
+    chainId?: number;
+    /** Token to deposit: 'NATIVE_USDC' or 'USDC_E' (default: 'NATIVE_USDC') */
+    token?: 'NATIVE_USDC' | 'USDC_E';
+    /** Gas price multiplier (default: 1.2) */
+    gasPriceMultiplier?: number;
+}
+/**
+ * Deposit USDC to Polymarket via Bridge
+ *
+ * This function:
+ * 1. Gets the deposit address for your wallet
+ * 2. Transfers USDC to that address
+ * 3. The bridge automatically converts it to USDC.e for your Polymarket account
+ *
+ * @param signer - Ethers wallet/signer to send from
+ * @param amount - Amount in USDC (e.g., 10.5 for $10.50)
+ * @param options - Deposit options
+ * @returns Deposit result with transaction hash
+ *
+ * @example
+ * ```typescript
+ * const bridge = new BridgeClient();
+ * const result = await bridge.depositUsdc(signer, 100);
+ * console.log(`Deposited $100: ${result.txHash}`);
+ * ```
+ */
+export declare function depositUsdc(signer: ethers.Wallet, amount: number, options?: DepositOptions): Promise<DepositResult>;
+export interface SwapAndDepositOptions {
+    /** Slippage tolerance for swap (default: 0.5%) */
+    slippage?: number;
+    /** Gas price multiplier (default: 1.2) */
+    gasPriceMultiplier?: number;
+}
+export interface SwapAndDepositResult {
+    success: boolean;
+    /** Swap transaction hash (if swap was needed) */
+    swapTxHash?: string;
+    /** Deposit transaction hash */
+    depositTxHash?: string;
+    /** Input token */
+    tokenIn: string;
+    /** Amount of input token */
+    amountIn: string;
+    /** Amount of USDC after swap */
+    usdcAmount: string;
+    /** Deposit address */
+    depositAddress: string;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Swap any supported Polygon token to USDC and deposit to Polymarket
+ *
+ * Supported tokens: MATIC, WMATIC, USDC, USDC_E, USDT, DAI, WETH
+ *
+ * Flow:
+ * 1. If token is not USDC, swap to USDC using QuickSwap
+ * 2. Deposit USDC to the bridge deposit address
+ *
+ * @param signer - Ethers wallet/signer
+ * @param token - Token symbol to deposit (e.g., 'MATIC', 'WETH', 'USDT')
+ * @param amount - Amount to deposit in token units
+ * @param options - Swap and deposit options
+ * @returns Result with transaction hashes
+ *
+ * @example
+ * ```typescript
+ * // Deposit 10 MATIC
+ * const result = await swapAndDeposit(signer, 'MATIC', '10');
+ *
+ * // Deposit 100 USDT
+ * const result = await swapAndDeposit(signer, 'USDT', '100');
+ *
+ * // Deposit 0.1 WETH
+ * const result = await swapAndDeposit(signer, 'WETH', '0.1');
+ * ```
+ */
+export declare function swapAndDeposit(signer: ethers.Wallet, token: string, amount: string, options?: SwapAndDepositOptions): Promise<SwapAndDepositResult>;
+/**
+ * Get list of supported tokens for swap and deposit
+ */
+export declare function getSupportedDepositTokens(): string[];
+/**
+ * Calculate the expected USDC.e output after bridge fees
+ *
+ * Note: This is an estimate. Actual output depends on bridge/swap fees.
+ *
+ * @param amount - Input amount in source token
+ * @param tokenSymbol - Source token symbol
+ * @returns Estimated USDC.e output
+ */
+export declare function estimateBridgeOutput(amount: number, tokenSymbol: string): number;
+/**
+ * Get explorer URL for a deposit transaction
+ *
+ * @param chainId - The chain ID
+ * @param txHash - The transaction hash
+ * @returns Block explorer URL
+ */
+export declare function getExplorerUrl(chainId: number, txHash: string): string;
+//# sourceMappingURL=bridge-client.d.ts.map

package/dist/clients/bridge-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-client.d.ts","sourceRoot":"","sources":["../../src/clients/bridge-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,qBAAqB;IACpC,4DAA4D;IAC5D,OAAO,EAAE;QACP,wEAAwE;QACxE,GAAG,EAAE,MAAM,CAAC;QACZ,6BAA6B;QAC7B,GAAG,EAAE,MAAM,CAAC;QACZ,8BAA8B;QAC9B,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;IACrE,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAOD,eAAO,MAAM,gBAAgB;;;;;;;;;;;CAWnB,CAAC;AAGX,eAAO,MAAM,aAAa;;;;;;CAShB,CAAC;AAIX;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,GAAE,YAAiB;IAKrC;;;;;;;;;;;;OAYG;IACG,kBAAkB,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IA6B3D;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IASnF;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKlE;;;;;OAKG;IACG,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrE;;;;;OAKG;IACG,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKlE;;;;;;;OAOG;IACG,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAajC;;;;;;OAMG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOzE;;;;;;OAMG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAclD;;;;;OAKG;IACG,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YA4EtD,KAAK;CA0BpB;AAID,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAQhC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAC;IACjC,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CA4ExB;AAMD,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CA0G/B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAEpD;AAID;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAahF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAetE"}