@gala-chain/launchpad-sdk 5.0.4-beta.6 → 5.0.4-beta.60

package/dist/bridge/BridgeService.d.ts

@@ -0,0 +1,484 @@
+/**
+ * Bridge Service
+ *
+ * Main orchestrator for cross-chain bridging operations.
+ * Provides a unified API for bridging tokens between GalaChain and external chains.
+ */
+import type { BridgeableTokenService } from '../services/BridgeableTokenService.js';
+import { type BridgeEnvironment } from './constants/index.js';
+import type { BridgeConfig, BridgeFeeEstimate, BridgeInParams, BridgeOutParams, BridgeStatus, BridgeToken, BridgeTransaction, EstimateBridgeFeeParams, EthereumTransactionStatus, EthereumWalletBalanceResult, ExternalChainBalance, ExternalNetwork, SolanaTransactionStatus, SolanaWalletBalanceResult, WaitForBridgeOptions } from './types/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;
+    /**
+     * Optional BridgeableTokenService for dynamic token resolution.
+     * If provided, tokenId-based operations will resolve symbols dynamically.
+     * If not provided, tokenId must match a known bridge token symbol.
+     */
+    bridgeableTokenService?: BridgeableTokenService;
+}
+/**
+ * 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;
+    private readonly bridgeableTokenService?;
+    /**
+     * 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;
+    /**
+     * Resolve a tokenId to its symbol using BridgeableTokenService.
+     *
+     * Parses the tokenId and looks up the corresponding token in the cache.
+     * The symbol comes from the authoritative DEX API, not derived from the tokenId.
+     *
+     * @param tokenId - Token identifier (string or TokenClassKey)
+     * @param network - Target network for bridging
+     * @returns Promise resolving to the token's symbol
+     * @throws Error if BridgeableTokenService is not configured
+     * @throws Error if token is not found or not bridgeable to the network
+     */
+    private resolveTokenSymbol;
+    /**
+     * Estimate bridge fees for a transfer.
+     *
+     * @param params - Fee estimation parameters
+     * @returns Fee estimate with breakdown
+     */
+    estimateBridgeFee(params: EstimateBridgeFeeParams): 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>;
+    /**
+     * Request SOL airdrop from Solana devnet faucet.
+     *
+     * Only available when connected to Solana devnet (STAGE environment).
+     * Will throw an error if RPC endpoint is not devnet or if Solana bridge is not configured.
+     *
+     * @param amount - Amount of SOL to request (default: 1, max: 2 per request)
+     * @param address - Optional recipient address (defaults to configured wallet)
+     * @returns Transaction signature
+     * @throws Error if not on devnet, Solana not configured, or airdrop fails
+     *
+     * @example
+     * ```typescript
+     * // Airdrop 1 SOL to configured wallet
+     * const signature = await bridgeService.requestSolanaDevnetAirdrop();
+     *
+     * // Airdrop 0.5 SOL to specific address
+     * const signature = await bridgeService.requestSolanaDevnetAirdrop(0.5, 'Address...');
+     * ```
+     */
+    requestSolanaDevnetAirdrop(amount?: number, address?: string): Promise<string>;
+    /**
+     * Get the status of a Solana transaction by signature.
+     *
+     * This method queries the Solana RPC directly using getSignatureStatuses,
+     * which doesn't require WebSockets and works in Node.js environments.
+     * Use this to verify airdrop or bridge transactions after submission.
+     *
+     * @param signature - Base58-encoded Solana transaction signature (87-88 characters)
+     * @returns Transaction status including confirmation level and any errors
+     * @throws Error if Solana bridge not configured or signature format is invalid
+     *
+     * @example Basic usage
+     * ```typescript
+     * const signature = await bridgeService.requestSolanaDevnetAirdrop(1);
+     * // Wait a moment for transaction to propagate
+     * await new Promise(r => setTimeout(r, 2000));
+     * const status = await bridgeService.getSolanaTransactionStatus(signature);
+     * if (status.confirmed) {
+     *   console.log(`Transaction confirmed at slot ${status.slot}`);
+     * }
+     * ```
+     *
+     * @example Polling pattern for confirmation
+     * ```typescript
+     * async function waitForConfirmation(signature: string, maxAttempts = 30) {
+     *   for (let i = 0; i < maxAttempts; i++) {
+     *     const status = await bridgeService.getSolanaTransactionStatus(signature);
+     *     if (status.confirmed) return status;
+     *     if (status.status === 'failed') throw new Error(status.error);
+     *     await new Promise(r => setTimeout(r, 2000));
+     *   }
+     *   throw new Error('Transaction confirmation timeout');
+     * }
+     * ```
+     */
+    getSolanaTransactionStatus(signature: string): Promise<SolanaTransactionStatus>;
+    /**
+     * Get the status of an Ethereum transaction by hash.
+     *
+     * Queries Ethereum RPC directly using `getTransactionReceipt()` and `getTransaction()`.
+     * Use this to verify if a bridge or any Ethereum transaction succeeded after submission.
+     *
+     * Status values:
+     * - `pending` - Transaction in mempool, not yet mined
+     * - `confirmed` - Mined with <12 confirmations
+     * - `finalized` - Mined with 12+ confirmations (practical finality)
+     * - `not_found` - Transaction hash not found on network
+     * - `failed` - Transaction mined but reverted
+     *
+     * **Performance:** Single synchronous RPC call sequence (no WebSocket required).
+     *
+     * @param transactionHash - Ethereum transaction hash (0x + 64 hex characters)
+     * @returns Transaction status with confirmation details
+     * @throws Error if Ethereum bridge not configured or hash format invalid
+     *
+     * @example Check bridge out status
+     * ```typescript
+     * const bridgeResult = await bridgeService.bridgeOut({
+     *   tokenId: 'Token|Unit|GALA|...',
+     *   amount: '100',
+     *   destinationChain: 'Ethereum',
+     *   recipientAddress: '0x1234...',
+     * });
+     *
+     * const status = await bridgeService.getEthereumTransactionStatus(bridgeResult.transactionHash);
+     * console.log(`Status: ${status.status}, Confirmations: ${status.confirmations}`);
+     * ```
+     *
+     * @example Polling pattern for finality
+     * ```typescript
+     * async function waitForFinality(txHash: string, maxAttempts = 30) {
+     *   for (let i = 0; i < maxAttempts; i++) {
+     *     const status = await bridgeService.getEthereumTransactionStatus(txHash);
+     *     if (status.status === 'finalized') return status;
+     *     if (status.status === 'failed') throw new Error(status.error);
+     *     await new Promise(r => setTimeout(r, 15000)); // ~15s per block
+     *   }
+     *   throw new Error('Transaction finality timeout');
+     * }
+     * ```
+     */
+    getEthereumTransactionStatus(transactionHash: string): Promise<EthereumTransactionStatus>;
+    /**
+     * 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/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/bridge/GalaConnectClient.d.ts

@@ -0,0 +1,170 @@
+/**
+ * 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 { BridgeConfigurationToken, BridgeFeeResponse, BridgeStatusResponse, BridgeTokenDescriptor, BridgeTokenOutResponse, BridgeTransactionRegistrationResponse, FetchBalancesResponse, GalaConnectConfig, RequestBridgeOutResponse } 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 the base URL for constructing status URLs.
+     *
+     * @returns The GalaConnect API base URL
+     */
+    getBaseUrl(): string;
+    /**
+     * 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/bridge/GalaConnectClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GalaConnectClient.d.ts","sourceRoot":"","sources":["../../src/bridge/GalaConnectClient.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,qCAAqC,EACrC,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,kBAAkB,CAAC;AAG1B;;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;;;;OAIG;IACI,UAAU,IAAI,MAAM;IAI3B;;;;;;;;;;OAUG;IACG,uBAAuB,CAC3B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAwCtC;;;;;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;IA6DtB;;;;;;;;;;;;OAYG;YACW,OAAO;IAgDrB;;;;;OAKG;YACW,aAAa;CAQ5B"}

package/dist/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/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"}