@gala-chain/launchpad-sdk 4.0.7-beta.3 → 4.0.7-beta.7

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"}

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

@@ -0,0 +1,181 @@
+/**
+ * Bridge Token Constants
+ *
+ * Static token configurations and chain IDs for bridging.
+ */
+import type { EthereumTokenConfig, SolanaTokenConfig, TokenMetadata, BridgeTokenDescriptor } from '../types/bridge.dto.js';
+/**
+ * Chain IDs used by the bridge system
+ */
+export declare const CHAIN_IDS: {
+    readonly GALA_CHAIN: 1;
+    readonly ETHEREUM: 2;
+    readonly SOLANA: 1002;
+};
+/**
+ * Rate limit for GalaConnect API (requests per second)
+ */
+export declare const DEFAULT_RATE_LIMIT_RPS = 12;
+/**
+ * Default polling interval for bridge status (15 seconds)
+ */
+export declare const DEFAULT_POLL_INTERVAL_MS = 15000;
+/**
+ * Default polling timeout (45 minutes)
+ */
+export declare const DEFAULT_POLL_TIMEOUT_MS: number;
+/**
+ * Delay before registering inbound bridge transactions (30 seconds)
+ */
+export declare const REGISTRATION_DELAY_MS = 30000;
+/**
+ * Solana compute budget settings
+ */
+export declare const SOLANA_COMPUTE: {
+    readonly UNIT_LIMIT: 200000;
+    readonly UNIT_PRICE_MICROLAMPORTS: 375000;
+};
+/**
+ * Default Ethereum RPC URL (public endpoint)
+ *
+ * **WARNING: Public RPC Endpoint Limitations**
+ *
+ * This is a free public endpoint with the following limitations:
+ * - **Rate Limits**: Typically 10-25 requests/second (varies by provider load)
+ * - **Reliability**: No SLA, may experience downtime during high network activity
+ * - **Privacy**: Requests may be logged by the provider
+ * - **Features**: May not support all RPC methods (e.g., trace_* calls)
+ * - **Monitoring**: No error tracking, request analytics, or debugging tools available
+ *
+ * **For Production Use**, provide your own RPC URL from:
+ * - Infura: https://infura.io (free tier: 100k requests/day)
+ * - Alchemy: https://alchemy.com (free tier: 300M compute units/month)
+ * - QuickNode: https://quicknode.com
+ * - Your own Ethereum node
+ *
+ * @example
+ * ```typescript
+ * const bridgeService = new BridgeService({
+ *   ethereumRpcUrl: 'https://mainnet.infura.io/v3/YOUR_API_KEY',
+ *   // ... other config
+ * });
+ * ```
+ */
+export declare const DEFAULT_ETHEREUM_RPC_URL = "https://ethereum.publicnode.com";
+/**
+ * Default Solana RPC URL (public endpoint)
+ *
+ * **WARNING: Public RPC Endpoint Limitations**
+ *
+ * This is the official Solana public RPC with the following limitations:
+ * - **Rate Limits**: Aggressive rate limiting (may return 429 errors under load)
+ * - **Reliability**: Best-effort availability, no SLA
+ * - **Performance**: Higher latency than dedicated endpoints
+ * - **Features**: Some methods may be disabled or limited
+ * - **Monitoring**: No error tracking, request analytics, or debugging tools available
+ *
+ * **For Production Use**, provide your own RPC URL from:
+ * - Helius: https://helius.dev (free tier: 500k credits/month)
+ * - QuickNode: https://quicknode.com
+ * - Triton: https://triton.one
+ * - Your own Solana validator
+ *
+ * @example
+ * ```typescript
+ * const bridgeService = new BridgeService({
+ *   solanaRpcUrl: 'https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY',
+ *   // ... other config
+ * });
+ * ```
+ */
+export declare const DEFAULT_SOLANA_RPC_URL = "https://api.mainnet-beta.solana.com";
+/**
+ * Default Ethereum bridge contract address (mainnet)
+ */
+export declare const DEFAULT_ETHEREUM_BRIDGE_CONTRACT = "0x9f452b7cC24e6e6FA690fe77CF5dD2ba3DbF1ED9";
+/**
+ * Ethereum bridge contract address for Sepolia testnet
+ */
+export declare const ETHEREUM_BRIDGE_CONTRACT_SEPOLIA = "0x6a1734E09f3099a3675645D214ce547080ea67e0";
+/**
+ * Default Solana bridge program ID (mainnet)
+ */
+export declare const DEFAULT_SOLANA_BRIDGE_PROGRAM = "AaE4dTnL75XqgUJpdxBKg6vS9sTJgBPJwBQRVhD29WwS";
+/**
+ * GalaConnect production base URL (DEX API platform)
+ */
+export declare const GALACONNECT_PRODUCTION_URL = "https://dex-api-platform-dex-prod-gala.gala.com";
+/**
+ * Ethereum tokens for bridging - Production (Mainnet)
+ */
+export declare const ETHEREUM_TOKENS_PROD: EthereumTokenConfig[];
+/**
+ * Ethereum tokens for bridging - Stage (Sepolia testnet)
+ *
+ * Note: GWTRX is not available on Sepolia
+ */
+export declare const ETHEREUM_TOKENS_STAGE: EthereumTokenConfig[];
+/** Bridge environment type for token selection */
+export type BridgeEnvironment = 'PROD' | 'STAGE';
+/**
+ * Get Ethereum tokens by environment
+ *
+ * @param environment - Target environment (PROD or STAGE)
+ * @returns Token configurations for the specified environment
+ */
+export declare function getEthereumTokensByEnvironment(environment: BridgeEnvironment): EthereumTokenConfig[];
+/**
+ * Get Ethereum bridge contract address by environment
+ *
+ * @param environment - Target environment (PROD or STAGE)
+ * @returns Bridge contract address for the specified environment
+ */
+export declare function getEthereumBridgeContractByEnvironment(environment: BridgeEnvironment): string;
+/**
+ * Default supported Ethereum tokens for bridging (Production/Mainnet)
+ *
+ * @deprecated Use `getEthereumTokensByEnvironment()` for environment-aware token selection
+ */
+export declare const DEFAULT_ETHEREUM_TOKENS: EthereumTokenConfig[];
+/**
+ * Default supported Solana tokens for bridging
+ */
+export declare const DEFAULT_SOLANA_TOKENS: SolanaTokenConfig[];
+/**
+ * Static token metadata for common bridge tokens
+ *
+ * This avoids API calls for well-known tokens.
+ */
+export declare const STATIC_TOKEN_METADATA: Record<string, TokenMetadata>;
+/**
+ * Ethereum ERC-20 ABI for bridge operations
+ */
+export declare const ERC20_ABI: readonly ["function decimals() view returns (uint8)", "function balanceOf(address owner) view returns (uint256)", "function approve(address spender, uint256 value) returns (bool)", "function allowance(address owner, address spender) view returns (uint256)", "function transfer(address to, uint256 value) returns (bool)", "function name() view returns (string)", "function nonces(address owner) view returns (uint256)", "function permit(address owner,address spender,uint256 value,uint256 deadline,uint8 v,bytes32 r,bytes32 s)"];
+/**
+ * Ethereum bridge contract ABI
+ */
+export declare const BRIDGE_CONTRACT_ABI: readonly ["function bridgeOut(address token,uint256 amount,uint256 tokenId,uint16 destinationChainId,bytes recipient) external", "function bridgeOutWithPermit(address token,uint256 amount,uint16 destinationChainId,bytes recipient,uint256 deadline,uint8 v,bytes32 r,bytes32 s) external"];
+/**
+ * Solana bridge instruction discriminators
+ */
+export declare const SOLANA_DISCRIMINATORS: {
+    readonly BRIDGE_OUT: Buffer<ArrayBuffer>;
+    readonly BRIDGE_OUT_NATIVE: Buffer<ArrayBuffer>;
+};
+/**
+ * Get token metadata by symbol
+ */
+export declare function getStaticTokenMetadata(symbol: string): TokenMetadata | undefined;
+/**
+ * Get Ethereum token config by symbol
+ */
+export declare function getEthereumTokenConfig(symbol: string): EthereumTokenConfig | undefined;
+/**
+ * Get Solana token config by symbol
+ */
+export declare function getSolanaTokenConfig(symbol: string): SolanaTokenConfig | undefined;
+/**
+ * Format a BridgeTokenDescriptor as a pipe-separated string
+ */
+export declare function formatTokenDescriptor(descriptor: BridgeTokenDescriptor): string;
+//# sourceMappingURL=tokens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../../src/bridge/constants/tokens.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,eAAO,MAAM,SAAS;;;;CAIZ,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAkB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,wBAAwB,oCAAoC,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,sBAAsB,wCAAwC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,gCAAgC,+CAA+C,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,gCAAgC,+CAA+C,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,6BAA6B,iDAAiD,CAAC;AAE5F;;GAEG;AACH,eAAO,MAAM,0BAA0B,oDAAoD,CAAC;AAE5F;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,mBAAmB,EA2CrD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,mBAAmB,EAoCtD,CAAC;AAEF,kDAAkD;AAClD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,iBAAiB,GAC7B,mBAAmB,EAAE,CAEvB;AAED;;;;;GAKG;AACH,wBAAgB,sCAAsC,CACpD,WAAW,EAAE,iBAAiB,GAC7B,MAAM,CAIR;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,mBAAmB,EAAyB,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,iBAAiB,EAepD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAoC/D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,ihBASZ,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,mBAAmB,gSAGtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;CAGxB,CAAC;AAEX;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAchF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAKtF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAKlF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,qBAAqB,GAAG,MAAM,CAE/E"}

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

@@ -0,0 +1,22 @@
+/**
+ * Bridge Module
+ *
+ * Cross-chain bridging capabilities for GalaChain.
+ * Supports bridging between:
+ * - GalaChain ↔ Ethereum (6 tokens)
+ * - GalaChain ↔ Solana (2 tokens)
+ *
+ * @module bridge
+ */
+export { BridgeService, type BridgeServiceConfig, type BridgeEnvironment } from './BridgeService.js';
+export { GalaConnectClient, GalaConnectHttpError } from './GalaConnectClient.js';
+export { type BridgeStrategy, BaseBridgeStrategy, type WaitOptions, } from './strategies/BridgeStrategy.js';
+export { EthereumBridgeStrategy, type EthereumBridgeConfig, } from './strategies/EthereumBridgeStrategy.js';
+export { SolanaBridgeStrategy, type SolanaBridgeConfig, } from './strategies/SolanaBridgeStrategy.js';
+export type { ExternalNetwork, BridgeTokenDescriptor, BridgeTokenInstance, EthereumTokenConfig, SolanaTokenConfig, BridgeConfigurationToken, TokenMetadata, ExternalTokenInfo, GalaExchangeRate, BaseTokenCrossRate, QuoteTokenCrossRate, GalaExchangeCrossRate, DestinationChainTxFee, BridgeFeeEstimate, BridgeRequestDto, BridgeStatus, BridgeTransaction, BridgeLegResult, TokenRoundTripResult, BridgeToken, BridgeConfig, EstimateBridgeFeeParams, BridgeOutParams, BridgeInParams, WaitForBridgeOptions, GalaConnectConfig, BridgeFeeResponse, RequestBridgeOutResponse, BridgeTokenOutResponse, BridgeStatusResponse, BridgeTransactionRegistrationResponse, TokenBalanceEntry, FetchBalancesResponse, ExternalChainBalance, EthereumWalletBalanceResult, SolanaWalletBalanceResult, } from './types/index.js';
+export { BridgeStatusCode } from './types/index.js';
+export { GALA_BRIDGE_TYPED_DATA_DOMAIN, LEGACY_TYPED_DATA_TYPES, CROSS_RATE_TYPED_DATA_TYPES, getGalaBridgeTypedDataTypes, } from './types/eip712.js';
+export { CHAIN_IDS, DEFAULT_ETHEREUM_TOKENS, DEFAULT_SOLANA_TOKENS, STATIC_TOKEN_METADATA, ERC20_ABI, BRIDGE_CONTRACT_ABI, SOLANA_DISCRIMINATORS, GALACONNECT_PRODUCTION_URL, DEFAULT_RATE_LIMIT_RPS, DEFAULT_POLL_INTERVAL_MS, DEFAULT_POLL_TIMEOUT_MS, DEFAULT_ETHEREUM_RPC_URL, DEFAULT_SOLANA_RPC_URL, DEFAULT_ETHEREUM_BRIDGE_CONTRACT, ETHEREUM_BRIDGE_CONTRACT_SEPOLIA, DEFAULT_SOLANA_BRIDGE_PROGRAM, SOLANA_COMPUTE, ETHEREUM_TOKENS_PROD, ETHEREUM_TOKENS_STAGE, getEthereumTokensByEnvironment, getEthereumBridgeContractByEnvironment, getStaticTokenMetadata, getEthereumTokenConfig, getSolanaTokenConfig, formatTokenDescriptor, } from './constants/index.js';
+export { RateLimiter } from './utils/RateLimiter.js';
+export { toBaseUnits, fromBaseUnits, formatTokenAmount, compareAmounts, } from './utils/tokenMath.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bridge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGrG,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGjF,OAAO,EACL,KAAK,cAAc,EACnB,kBAAkB,EAClB,KAAK,WAAW,GACjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,sBAAsB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,oBAAoB,EACpB,KAAK,kBAAkB,GACxB,MAAM,sCAAsC,CAAC;AAG9C,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,YAAY,EACZ,uBAAuB,EACvB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,qCAAqC,EACrC,iBAAiB,EACjB,qBAAqB,EAErB,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,EACvB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,SAAS,EACT,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,SAAS,EACT,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,gCAAgC,EAChC,gCAAgC,EAChC,6BAA6B,EAC7B,cAAc,EAEd,oBAAoB,EACpB,qBAAqB,EACrB,8BAA8B,EAC9B,sCAAsC,EACtC,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EACL,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,cAAc,GACf,MAAM,sBAAsB,CAAC"}

package/dist/src/bridge/strategies/BridgeStrategy.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Bridge Strategy Interface
+ *
+ * Defines the contract for chain-specific bridge implementations.
+ * Each external chain (Ethereum, Solana) implements this interface
+ * to handle its unique signing, transaction, and status tracking logic.
+ */
+import { type BridgeFeeEstimate, type BridgeInParams, type BridgeOutParams, type BridgeStatus, type BridgeTransaction, type ExternalNetwork } from '../types/index.js';
+/**
+ * Strategy interface for chain-specific bridge operations.
+ *
+ * The Bridge SDK uses the Strategy pattern to abstract chain-specific logic:
+ * - EthereumBridgeStrategy: Handles ERC-20 approvals, ethers.js signing
+ * - SolanaBridgeStrategy: Handles SPL token accounts, @solana/web3.js signing
+ *
+ * Each strategy encapsulates:
+ * - Fee estimation for the target chain
+ * - Outbound transfers (GalaChain → External)
+ * - Inbound transfers (External → GalaChain)
+ * - Status polling and transaction tracking
+ *
+ * @example
+ * ```typescript
+ * class EthereumBridgeStrategy implements BridgeStrategy {
+ *   readonly network: ExternalNetwork = 'Ethereum';
+ *
+ *   async estimateFee(tokenSymbol: string, amount: string): Promise<BridgeFeeEstimate> {
+ *     // Ethereum-specific fee calculation
+ *   }
+ * }
+ * ```
+ */
+export interface BridgeStrategy {
+    /**
+     * The external network this strategy handles.
+     */
+    readonly network: ExternalNetwork;
+    /**
+     * Estimate bridge fees for a transfer.
+     *
+     * Calculates the total cost including:
+     * - Bridge protocol fee (paid to GalaChain)
+     * - Network gas fee (estimated)
+     * - Any chain-specific fees
+     *
+     * @param tokenSymbol - Token symbol (e.g., 'GALA', 'GUSDC')
+     * @param amount - Amount in decimal format (e.g., '100.5')
+     * @returns Fee estimate with breakdown
+     */
+    estimateFee(tokenSymbol: string, amount: string): Promise<BridgeFeeEstimate>;
+    /**
+     * Bridge tokens OUT from GalaChain to external chain.
+     *
+     * Flow:
+     * 1. Lock tokens on GalaChain (via GalaConnect)
+     * 2. Wait for bridge confirmation
+     * 3. Receive wrapped tokens on external chain
+     *
+     * @param params - Bridge out parameters
+     * @returns Transaction details with tracking info
+     */
+    bridgeOut(params: BridgeOutParams): Promise<BridgeTransaction>;
+    /**
+     * Bridge tokens IN from external chain to GalaChain.
+     *
+     * Flow:
+     * 1. Approve bridge contract (if needed)
+     * 2. Deposit tokens to bridge contract
+     * 3. Wait for GalaChain confirmation
+     * 4. Receive native tokens on GalaChain
+     *
+     * @param params - Bridge in parameters
+     * @returns Transaction details with tracking info
+     */
+    bridgeIn(params: BridgeInParams): Promise<BridgeTransaction>;
+    /**
+     * Get the current status of a bridge transaction.
+     *
+     * Polls both the source and destination chains to determine
+     * the transaction's progress through the bridge.
+     *
+     * @param transactionHash - The bridge transaction hash
+     * @returns Current status with details
+     */
+    getStatus(transactionHash: string): Promise<BridgeStatus>;
+    /**
+     * Wait for a bridge transaction to complete.
+     *
+     * Polls the transaction status until it reaches a terminal state
+     * (completed or failed) or the timeout is reached.
+     *
+     * @param transactionHash - The bridge transaction hash
+     * @param options - Polling options
+     * @returns Final status when complete
+     * @throws Error if timeout reached or transaction fails
+     */
+    waitForCompletion(transactionHash: string, options?: WaitOptions): Promise<BridgeStatus>;
+    /**
+     * Get the list of supported tokens for this chain.
+     *
+     * @returns Array of token symbols supported by this bridge
+     */
+    getSupportedTokens(): string[];
+    /**
+     * Check if a specific token is supported for bridging.
+     *
+     * @param tokenSymbol - Token symbol to check
+     * @returns True if token can be bridged
+     */
+    isTokenSupported(tokenSymbol: string): boolean;
+    /**
+     * Validate a recipient address for the external chain.
+     *
+     * @param address - Address to validate
+     * @returns True if address is valid for this chain
+     */
+    isValidAddress(address: string): boolean;
+}
+/**
+ * Options for waiting on bridge completion.
+ */
+export interface WaitOptions {
+    /**
+     * Polling interval in milliseconds.
+     * @default 15000 (15 seconds)
+     */
+    pollInterval?: number;
+    /**
+     * Maximum time to wait in milliseconds.
+     * @default 2700000 (45 minutes)
+     */
+    timeout?: number;
+    /**
+     * Callback for status updates during polling.
+     */
+    onStatusUpdate?: (status: BridgeStatus) => void;
+}
+/**
+ * Base class providing common functionality for bridge strategies.
+ *
+ * Concrete strategies extend this class and implement chain-specific logic.
+ */
+export declare abstract class BaseBridgeStrategy implements BridgeStrategy {
+    abstract readonly network: ExternalNetwork;
+    abstract estimateFee(tokenSymbol: string, amount: string): Promise<BridgeFeeEstimate>;
+    abstract bridgeOut(params: BridgeOutParams): Promise<BridgeTransaction>;
+    abstract bridgeIn(params: BridgeInParams): Promise<BridgeTransaction>;
+    abstract getStatus(transactionHash: string): Promise<BridgeStatus>;
+    abstract getSupportedTokens(): string[];
+    abstract isTokenSupported(tokenSymbol: string): boolean;
+    abstract isValidAddress(address: string): boolean;
+    /**
+     * Default implementation of waitForCompletion with polling.
+     *
+     * Strategies can override this if they have chain-specific
+     * event subscription capabilities.
+     */
+    waitForCompletion(transactionHash: string, options?: WaitOptions): Promise<BridgeStatus>;
+}
+//# sourceMappingURL=BridgeStrategy.d.ts.map

package/dist/src/bridge/strategies/BridgeStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BridgeStrategy.d.ts","sourceRoot":"","sources":["../../../../src/bridge/strategies/BridgeStrategy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAElC;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE7E;;;;;;;;;;OAUG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE/D;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE7D;;;;;;;;OAQG;IACH,SAAS,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE1D;;;;;;;;;;OAUG;IACH,iBAAiB,CACf,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;OAIG;IACH,kBAAkB,IAAI,MAAM,EAAE,CAAC;IAE/B;;;;;OAKG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAE/C;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;CACjD;AAED;;;;GAIG;AACH,8BAAsB,kBAAmB,YAAW,cAAc;IAChE,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAE3C,QAAQ,CAAC,WAAW,CAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;IACvE,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IACrE,QAAQ,CAAC,SAAS,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAClE,QAAQ,CAAC,kBAAkB,IAAI,MAAM,EAAE;IACvC,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IACvD,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAEjD;;;;;OAKG;IACG,iBAAiB,CACrB,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,YAAY,CAAC;CAiCzB"}