@gala-chain/launchpad-sdk 4.0.6 → 4.0.7-beta.10

package/dist/src/bridge/BridgeService.d.ts

@@ -0,0 +1,364 @@
+/**
+ * Bridge Service
+ *
+ * Main orchestrator for cross-chain bridging operations.
+ * Provides a unified API for bridging tokens between GalaChain and external chains.
+ */
+import type { BridgeConfig, BridgeFeeEstimate, BridgeInParams, BridgeOutParams, BridgeStatus, BridgeToken, BridgeTransaction, ExternalNetwork, WaitForBridgeOptions, ExternalChainBalance, EthereumWalletBalanceResult, SolanaWalletBalanceResult } from './types/index.js';
+import { type BridgeEnvironment } from './constants/index.js';
+export type { BridgeEnvironment };
+/**
+ * Extended bridge configuration with wallet keys.
+ */
+export interface BridgeServiceConfig extends BridgeConfig {
+    /** GalaChain wallet address (eth|0x...) */
+    galaChainWalletAddress: string;
+    /** Ethereum private key for signing (required for all operations) */
+    ethereumPrivateKey: string;
+    /** Environment - affects default RPC URLs (STAGE uses Sepolia, PROD uses mainnet) */
+    environment?: BridgeEnvironment;
+}
+/**
+ * Bridge Service - Main entry point for cross-chain operations.
+ *
+ * Supports bridging between:
+ * - GalaChain ↔ Ethereum (6 tokens: GALA, GWETH, GUSDC, GUSDT, GWTRX, GWBTC)
+ * - GalaChain ↔ Solana (2 tokens: GALA, GSOL)
+ *
+ * @example
+ * ```typescript
+ * const bridgeService = new BridgeService({
+ *   // Uses GALACONNECT_PRODUCTION_URL by default
+ *   galaChainWalletAddress: 'eth|0x1234...',
+ *   ethereumPrivateKey: '0xabcd...',
+ *   solanaPrivateKey: 'base58EncodedKey...',
+ * });
+ *
+ * // Estimate bridge fees
+ * const fee = await bridgeService.estimateBridgeFee({
+ *   tokenSymbol: 'GALA',
+ *   destinationChain: 'Ethereum',
+ *   amount: '100',
+ * });
+ *
+ * // Bridge out (GalaChain → Ethereum)
+ * const tx = await bridgeService.bridgeOut({
+ *   tokenSymbol: 'GALA',
+ *   amount: '100',
+ *   destinationChain: 'Ethereum',
+ *   recipientAddress: '0x5678...',
+ * });
+ *
+ * // Wait for completion
+ * const status = await bridgeService.waitForBridgeCompletion(tx.transactionHash);
+ * ```
+ */
+export declare class BridgeService {
+    private readonly config;
+    private readonly galaConnectClient;
+    private readonly strategies;
+    /**
+     * Normalize a GalaChain wallet address to the expected format.
+     *
+     * GalaChain expects: `eth|<checksummed-address-without-0x>`
+     *
+     * Accepts various formats:
+     * - `eth|0xa278...` → `eth|A278...` (removes 0x, checksums)
+     * - `eth|a278...` → `eth|A278...` (checksums)
+     * - `0xA278...` → `eth|A278...` (adds prefix, removes 0x)
+     *
+     * @param address - Wallet address in any supported format
+     * @returns Normalized address in GalaChain format
+     */
+    private static normalizeGalaChainAddress;
+    /**
+     * Compute EIP-55 checksum for an address.
+     *
+     * @param address - Address without 0x prefix (40 hex chars)
+     * @returns Checksummed address (40 chars, mixed case)
+     */
+    private static checksumAddress;
+    /**
+     * Creates a new Bridge Service.
+     *
+     * @param config - Service configuration
+     */
+    constructor(config: BridgeServiceConfig);
+    /**
+     * Initialize bridge strategies for supported chains.
+     */
+    private initializeStrategies;
+    /**
+     * Estimate bridge fees for a transfer.
+     *
+     * @param params - Fee estimation parameters
+     * @returns Fee estimate with breakdown
+     */
+    estimateBridgeFee(params: {
+        tokenSymbol: string;
+        destinationChain: ExternalNetwork;
+        amount?: string;
+    }): Promise<BridgeFeeEstimate>;
+    /**
+     * Bridge tokens out from GalaChain to an external chain.
+     *
+     * @param params - Bridge out parameters
+     * @returns Transaction details
+     */
+    bridgeOut(params: BridgeOutParams): Promise<BridgeTransaction>;
+    /**
+     * Bridge tokens in from an external chain to GalaChain.
+     *
+     * @param params - Bridge in parameters
+     * @returns Transaction details
+     */
+    bridgeIn(params: BridgeInParams): Promise<BridgeTransaction>;
+    /**
+     * Get the status of a bridge transaction.
+     *
+     * @param transactionHash - Transaction hash to check
+     * @param chain - Optional chain hint for faster lookup (if known)
+     * @returns Current status
+     */
+    getBridgeStatus(transactionHash: string, chain?: ExternalNetwork): Promise<BridgeStatus>;
+    /**
+     * Wait for a bridge transaction to complete.
+     *
+     * @param transactionHash - Transaction hash to wait for
+     * @param options - Polling options
+     * @returns Final status when complete
+     */
+    waitForBridgeCompletion(transactionHash: string, options?: WaitForBridgeOptions): Promise<BridgeStatus>;
+    /**
+     * Get list of all supported bridge tokens.
+     *
+     * @param chain - Optional chain to filter by
+     * @returns Array of supported tokens
+     */
+    getSupportedBridgeTokens(chain?: ExternalNetwork): BridgeToken[];
+    /**
+     * Get list of supported external chains.
+     *
+     * @returns Array of chain names
+     */
+    getSupportedBridgeChains(): ExternalNetwork[];
+    /**
+     * Check if a token is supported for bridging.
+     *
+     * @param tokenSymbol - Token symbol to check
+     * @param chain - Optional chain to check specifically
+     * @returns True if token is supported
+     */
+    isTokenSupported(tokenSymbol: string, chain?: ExternalNetwork): boolean;
+    /**
+     * Validate an address for a specific chain.
+     *
+     * @param address - Address to validate
+     * @param chain - Target chain
+     * @returns True if address is valid
+     */
+    isValidAddress(address: string, chain: ExternalNetwork): boolean;
+    /**
+     * Get ERC-20 token balance on Ethereum.
+     *
+     * @param tokenSymbol - Token symbol (e.g., 'GALA', 'GWETH', 'GUSDC')
+     * @param address - Optional Ethereum address (defaults to configured wallet)
+     * @returns Token balance as decimal string
+     * @throws Error if Ethereum bridge not configured or token not supported
+     *
+     * @example
+     * ```typescript
+     * // Check wallet's GALA balance on Ethereum
+     * const balance = await bridge.getEthereumTokenBalance('GALA');
+     * console.log(`Ethereum GALA: ${balance}`);
+     *
+     * // Check specific address
+     * const otherBalance = await bridge.getEthereumTokenBalance('GUSDC', '0x1234...');
+     * ```
+     */
+    getEthereumTokenBalance(tokenSymbol: string, address?: string): Promise<string>;
+    /**
+     * Get native ETH balance on Ethereum.
+     *
+     * @param address - Optional Ethereum address (defaults to configured wallet)
+     * @returns ETH balance as decimal string (18 decimals)
+     * @throws Error if Ethereum bridge not configured
+     *
+     * @example
+     * ```typescript
+     * // Check wallet's ETH balance (for gas fees)
+     * const ethBalance = await bridge.getEthereumNativeBalance();
+     * console.log(`ETH for gas: ${ethBalance}`);
+     * ```
+     */
+    getEthereumNativeBalance(address?: string): Promise<string>;
+    /**
+     * Get SPL token balance on Solana.
+     *
+     * @param tokenSymbol - Token symbol ('GALA' or 'GSOL')
+     * @param address - Optional Solana address (defaults to configured wallet)
+     * @returns Token balance as decimal string
+     * @throws Error if Solana bridge not configured or token not supported
+     *
+     * @example
+     * ```typescript
+     * // Check wallet's GALA balance on Solana
+     * const balance = await bridge.getSolanaTokenBalance('GALA');
+     * console.log(`Solana GALA: ${balance}`);
+     * ```
+     */
+    getSolanaTokenBalance(tokenSymbol: string, address?: string): Promise<string>;
+    /**
+     * Get native SOL balance on Solana.
+     *
+     * @param address - Optional Solana address (defaults to configured wallet)
+     * @returns SOL balance as decimal string (9 decimals)
+     * @throws Error if Solana bridge not configured
+     *
+     * @example
+     * ```typescript
+     * // Check wallet's SOL balance (for transaction fees)
+     * const solBalance = await bridge.getSolanaNativeBalance();
+     * console.log(`SOL for rent: ${solBalance}`);
+     * ```
+     */
+    getSolanaNativeBalance(address?: string): Promise<string>;
+    /**
+     * Fetch a single ERC-20 token balance on Ethereum.
+     *
+     * Efficient method for checking a specific token balance (1 RPC call).
+     * Use `fetchEthereumWalletAllBalances()` for complete portfolio view.
+     *
+     * @param symbol - Token symbol (GALA, GWETH, GUSDC, GUSDT, GWTRX, GWBTC)
+     * @param address - Ethereum address (0x format). Defaults to configured wallet.
+     * @returns Single token balance with metadata
+     * @throws Error if Ethereum bridge not configured or invalid symbol
+     *
+     * @example
+     * ```typescript
+     * // Check GALA balance on Ethereum
+     * const gala = await bridgeService.fetchEthereumWalletTokenBalance('GALA');
+     * console.log(`GALA: ${gala.quantity}`);
+     *
+     * // Check specific address
+     * const gusdc = await bridgeService.fetchEthereumWalletTokenBalance('GUSDC', '0x1234...');
+     * ```
+     */
+    fetchEthereumWalletTokenBalance(symbol: string, address?: string): Promise<ExternalChainBalance>;
+    /**
+     * Fetch native ETH balance on Ethereum.
+     *
+     * Efficient method for checking ETH balance only (1 RPC call).
+     * Use `fetchEthereumWalletAllBalances()` for complete portfolio view.
+     *
+     * @param address - Ethereum address (0x format). Defaults to configured wallet.
+     * @returns Native ETH balance with metadata
+     * @throws Error if Ethereum bridge not configured
+     *
+     * @example
+     * ```typescript
+     * // Check ETH balance (for gas fees)
+     * const eth = await bridgeService.fetchEthereumWalletNativeBalance();
+     * console.log(`ETH: ${eth.quantity}`);
+     * ```
+     */
+    fetchEthereumWalletNativeBalance(address?: string): Promise<ExternalChainBalance>;
+    /**
+     * Fetch a single SPL token balance on Solana.
+     *
+     * Efficient method for checking a specific token balance (1 RPC call).
+     * Use `fetchSolanaWalletAllBalances()` for complete portfolio view.
+     *
+     * @param symbol - Token symbol (GALA, GSOL)
+     * @param address - Solana address (base58 format). Defaults to configured wallet.
+     * @returns Single token balance with metadata
+     * @throws Error if Solana bridge not configured or invalid symbol
+     *
+     * @example
+     * ```typescript
+     * // Check GALA balance on Solana
+     * const gala = await bridgeService.fetchSolanaWalletTokenBalance('GALA');
+     * console.log(`GALA: ${gala.quantity}`);
+     * ```
+     */
+    fetchSolanaWalletTokenBalance(symbol: string, address?: string): Promise<ExternalChainBalance>;
+    /**
+     * Fetch native SOL balance on Solana.
+     *
+     * Efficient method for checking SOL balance only (1 RPC call).
+     * Use `fetchSolanaWalletAllBalances()` for complete portfolio view.
+     *
+     * @param address - Solana address (base58 format). Defaults to configured wallet.
+     * @returns Native SOL balance with metadata
+     * @throws Error if Solana bridge not configured
+     *
+     * @example
+     * ```typescript
+     * // Check SOL balance (for transaction fees)
+     * const sol = await bridgeService.fetchSolanaWalletNativeBalance();
+     * console.log(`SOL: ${sol.quantity}`);
+     * ```
+     */
+    fetchSolanaWalletNativeBalance(address?: string): Promise<ExternalChainBalance>;
+    /**
+     * Fetch all supported token balances on Ethereum for a wallet.
+     *
+     * Returns native ETH balance plus all supported ERC-20 token balances:
+     * GALA, GWETH, GUSDC, GUSDT, GWTRX, GWBTC
+     *
+     * For checking a single token, use `fetchEthereumWalletTokenBalance()` (more efficient).
+     *
+     * @param address - Ethereum address (0x format). Defaults to configured wallet.
+     * @returns Complete balance breakdown for all supported tokens
+     * @throws Error if Ethereum bridge not configured
+     *
+     * @example
+     * ```typescript
+     * // Get all Ethereum balances
+     * const result = await bridgeService.fetchEthereumWalletAllBalances();
+     * console.log(`ETH: ${result.native.quantity}`);
+     * for (const token of result.tokens) {
+     *   console.log(`${token.symbol}: ${token.quantity}`);
+     * }
+     *
+     * // Check specific address
+     * const otherWallet = await bridgeService.fetchEthereumWalletAllBalances('0x1234...');
+     * ```
+     */
+    fetchEthereumWalletAllBalances(address?: string): Promise<EthereumWalletBalanceResult>;
+    /**
+     * Fetch all supported token balances on Solana for a wallet.
+     *
+     * Returns native SOL balance plus all supported SPL token balances:
+     * GALA, GSOL
+     *
+     * For checking a single token, use `fetchSolanaWalletTokenBalance()` (more efficient).
+     *
+     * @param address - Solana address (base58 format). Defaults to configured wallet.
+     * @returns Complete balance breakdown for all supported tokens
+     * @throws Error if Solana bridge not configured
+     *
+     * @example
+     * ```typescript
+     * // Get all Solana balances
+     * const result = await bridgeService.fetchSolanaWalletAllBalances();
+     * console.log(`SOL: ${result.native.quantity}`);
+     * for (const token of result.tokens) {
+     *   console.log(`${token.symbol}: ${token.quantity}`);
+     * }
+     *
+     * // Check specific address
+     * const otherWallet = await bridgeService.fetchSolanaWalletAllBalances('9WzDXw...');
+     * ```
+     */
+    fetchSolanaWalletAllBalances(address?: string): Promise<SolanaWalletBalanceResult>;
+    /**
+     * Get the strategy for a specific chain.
+     *
+     * @param chain - Target chain
+     * @returns Bridge strategy
+     * @throws Error if chain is not supported
+     */
+    private getStrategy;
+}
+//# sourceMappingURL=BridgeService.d.ts.map

package/dist/src/bridge/BridgeService.d.ts.map

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

package/dist/src/bridge/GalaConnectClient.d.ts

@@ -0,0 +1,164 @@
+/**
+ * GalaConnect Bridge Client
+ *
+ * HTTP client for GalaConnect Bridge API interactions.
+ * Handles authentication, rate limiting, and bridge-specific endpoints.
+ *
+ * Based on the proven implementation from bridge_round_trip repository.
+ */
+import type { BridgeTokenDescriptor, BridgeConfigurationToken, BridgeFeeResponse, RequestBridgeOutResponse, BridgeTokenOutResponse, BridgeStatusResponse, BridgeTransactionRegistrationResponse, FetchBalancesResponse, GalaConnectConfig } from './types/index.js';
+/**
+ * HTTP error from GalaConnect API.
+ */
+export declare class GalaConnectHttpError extends Error {
+    readonly status: number;
+    readonly path: string;
+    readonly responseBody: unknown;
+    /**
+     * Creates a new GalaConnect HTTP error.
+     *
+     * @param status - HTTP status code
+     * @param path - API endpoint path
+     * @param responseBody - Response body (may contain error details)
+     */
+    constructor(status: number, path: string, responseBody: unknown);
+}
+/**
+ * GalaConnect Bridge API Client.
+ *
+ * Provides type-safe access to the GalaConnect bridge endpoints:
+ * - Bridge configuration discovery
+ * - Fee estimation
+ * - Bridge out (GalaChain → External)
+ * - Bridge in (External → GalaChain)
+ * - Status tracking
+ *
+ * @example
+ * ```typescript
+ * const client = new GalaConnectClient({
+ *   walletAddress: 'eth|0x1234...',
+ *   // Uses GALACONNECT_PRODUCTION_URL by default
+ * });
+ *
+ * // Get supported tokens
+ * const tokens = await client.getBridgeConfigurations('GALA');
+ *
+ * // Estimate fees
+ * const fee = await client.fetchBridgeFee({
+ *   chainId: '1',
+ *   bridgeToken: { collection: 'GALA', category: 'Unit', type: 'none', additionalKey: 'none' }
+ * });
+ * ```
+ */
+export declare class GalaConnectClient {
+    private readonly baseUrl;
+    private readonly galachainBaseUrl;
+    private readonly walletAddress;
+    private readonly rateLimiter;
+    private readonly defaultHeaders;
+    private readonly retryOptions;
+    /**
+     * Creates a new GalaConnect client.
+     *
+     * @param config - Client configuration
+     */
+    constructor(config: GalaConnectConfig);
+    /**
+     * Get bridge configurations for tokens matching a prefix.
+     *
+     * Returns detailed token information including:
+     * - Token class key (collection, category, type, additionalKey)
+     * - Supported bridge routes
+     * - External network contract addresses
+     *
+     * @param searchPrefix - Token symbol prefix to search (e.g., 'GALA', 'GUS')
+     * @returns Array of matching token configurations
+     */
+    getBridgeConfigurations(searchPrefix: string): Promise<BridgeConfigurationToken[]>;
+    /**
+     * Fetch bridge fee estimate for a token transfer.
+     *
+     * @param payload - Fee request parameters
+     * @returns Fee estimate with breakdown
+     */
+    fetchBridgeFee(payload: {
+        chainId: string;
+        bridgeToken: BridgeTokenDescriptor;
+    }): Promise<BridgeFeeResponse>;
+    /**
+     * Request token bridge out (initiate GalaChain → External transfer).
+     *
+     * This is the first step in the bridge out process:
+     * 1. RequestBridgeOut - Lock tokens on GalaChain
+     * 2. BridgeTokenOut - Generate wormhole message
+     *
+     * @param payload - Bridge out request parameters
+     * @returns Response with transaction data
+     */
+    requestBridgeOut(payload: Record<string, unknown>): Promise<RequestBridgeOutResponse>;
+    /**
+     * Execute bridge token out (generate wormhole message).
+     *
+     * This is the second step in the bridge out process.
+     * Called after RequestBridgeOut succeeds.
+     *
+     * @param payload - Bridge token out parameters
+     * @returns Response with wormhole message data
+     */
+    bridgeTokenOut(payload: Record<string, unknown>): Promise<BridgeTokenOutResponse>;
+    /**
+     * Get the status of a bridge transaction.
+     *
+     * @param hash - Transaction hash to check
+     * @returns Current status with details
+     */
+    getBridgeStatus(hash: string): Promise<BridgeStatusResponse>;
+    /**
+     * Register a bridge transaction (for External → GalaChain transfers).
+     *
+     * Called after depositing tokens to the bridge contract on the external chain.
+     * Notifies GalaConnect to process the inbound transfer.
+     *
+     * @param payload - Transaction registration data
+     * @returns Registration response
+     */
+    registerBridgeTransaction(payload: Record<string, unknown>): Promise<BridgeTransactionRegistrationResponse>;
+    /**
+     * Fetch token balances for the wallet.
+     *
+     * @param channel - Token channel (default: 'asset')
+     * @returns Balance response with token holdings
+     */
+    fetchBalances(channel?: string): Promise<FetchBalancesResponse>;
+    /**
+     * Make a POST request with JSON body.
+     *
+     * @param path - API endpoint path
+     * @param body - Request body
+     * @param options - Request options (baseUrl override, skipWalletHeader)
+     * @returns Parsed JSON response
+     */
+    private postJson;
+    /**
+     * Make a rate-limited HTTP request with optional retry logic.
+     *
+     * Retry behavior (when enabled):
+     * - Retries on network errors (ECONNRESET, ETIMEDOUT, etc.)
+     * - Retries on server errors (5xx status codes)
+     * - Retries on rate limiting (429 Too Many Requests)
+     * - Uses exponential backoff with jitter
+     *
+     * @param url - Full URL to request
+     * @param init - Fetch init options
+     * @returns Fetch response
+     */
+    private request;
+    /**
+     * Safely parse JSON from a response (for error handling).
+     *
+     * @param response - Fetch response
+     * @returns Parsed JSON or raw text
+     */
+    private safeParseJson;
+}
+//# sourceMappingURL=GalaConnectClient.d.ts.map

package/dist/src/bridge/GalaConnectClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GalaConnectClient.d.ts","sourceRoot":"","sources":["../../../src/bridge/GalaConnectClient.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,qCAAqC,EACrC,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAI1B;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aAS3B,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;aACZ,YAAY,EAAE,OAAO;IAVvC;;;;;;OAMG;gBAEe,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,OAAO;CASxC;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IAEnD;;;;OAIG;gBACS,MAAM,EAAE,iBAAiB;IAoCrC;;;;;;;;;;OAUG;IACG,uBAAuB,CAC3B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAqBtC;;;;;OAKG;IACG,cAAc,CAAC,OAAO,EAAE;QAC5B,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,qBAAqB,CAAC;KACpC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQ9B;;;;;;;;;OASG;IACG,gBAAgB,CACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,wBAAwB,CAAC;IAOpC;;;;;;;;OAQG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,sBAAsB,CAAC;IAIlC;;;;;OAKG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIlE;;;;;;;;OAQG;IACG,yBAAyB,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,qCAAqC,CAAC;IAOjD;;;;;OAKG;IACG,aAAa,CAAC,OAAO,SAAU,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAQtE;;;;;;;OAOG;YACW,QAAQ;IAoDtB;;;;;;;;;;;;OAYG;YACW,OAAO;IA+CrB;;;;;OAKG;YACW,aAAa;CAQ5B"}

package/dist/src/bridge/constants/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Bridge Constants Index
+ *
+ * Re-exports all bridge-related constants.
+ */
+export * from './tokens.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/bridge/constants/index.d.ts.map

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