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

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

@@ -0,0 +1,207 @@
+/**
+ * Solana Bridge Strategy
+ *
+ * Implements bridging between GalaChain and Solana networks.
+ * Handles SPL token accounts, PDA derivation, and Solana program interactions.
+ */
+import { BaseBridgeStrategy } from './BridgeStrategy.js';
+import { GalaConnectClient } from '../GalaConnectClient.js';
+import type { BridgeFeeEstimate, BridgeInParams, BridgeOutParams, BridgeStatus, BridgeTransaction, ExternalNetwork, SolanaTokenConfig } from '../types/index.js';
+/**
+ * Configuration for Solana bridge strategy.
+ */
+export interface SolanaBridgeConfig {
+    /** GalaConnect API client */
+    galaConnectClient: GalaConnectClient;
+    /** GalaChain wallet address (eth|0x...) */
+    galaChainWalletAddress: string;
+    /** Ethereum private key for EIP-712 signing (GalaChain uses Ethereum signatures) */
+    ethereumPrivateKey: string;
+    /** Solana private key in base58 format */
+    solanaPrivateKeyBase58: string;
+    /** Solana RPC URL */
+    solanaRpcUrl?: string;
+    /** Solana bridge program ID */
+    solanaBridgeProgram?: string;
+    /** Token configurations */
+    tokenConfigs?: SolanaTokenConfig[];
+}
+/**
+ * Bridge strategy for GalaChain ↔ Solana transfers.
+ *
+ * Supports 2 tokens: GALA, GSOL
+ *
+ * @example
+ * ```typescript
+ * const strategy = new SolanaBridgeStrategy({
+ *   galaConnectClient,
+ *   galaChainWalletAddress: 'eth|0x1234...',
+ *   ethereumPrivateKey: '0xabcd...',
+ *   solanaPrivateKeyBase58: 'base58EncodedKey...',
+ * });
+ *
+ * // Bridge out (GalaChain → Solana)
+ * const tx = await strategy.bridgeOut({
+ *   tokenSymbol: 'GALA',
+ *   amount: '100',
+ *   destinationChain: 'Solana',
+ *   recipientAddress: 'SolanaAddress...',
+ * });
+ * ```
+ */
+export declare class SolanaBridgeStrategy extends BaseBridgeStrategy {
+    readonly network: ExternalNetwork;
+    private readonly galaConnectClient;
+    private readonly galaChainWalletAddress;
+    private readonly ethereumWallet;
+    private readonly solanaConnection;
+    private readonly solanaKeypair;
+    private readonly solanaBridgeProgramId;
+    private readonly solanaBridgeTokenAuthority;
+    private readonly solanaBridgeConfigPda;
+    private readonly solanaNativeBridgePda;
+    private readonly solanaBridgeAccountCache;
+    private readonly tokenConfigs;
+    private readonly tokenMetadataCache;
+    /**
+     * Creates a new Solana bridge strategy.
+     *
+     * @param config - Strategy configuration
+     * @throws Error if ethereumPrivateKey or solanaPrivateKeyBase58 is invalid format
+     */
+    constructor(config: SolanaBridgeConfig);
+    /**
+     * Estimate bridge fees for a transfer to Solana.
+     *
+     * @param tokenSymbol - Token symbol (e.g., 'GALA', 'GSOL')
+     * @param amount - Amount in decimal format
+     * @returns Fee estimate with breakdown
+     */
+    estimateFee(tokenSymbol: string, _amount: string): Promise<BridgeFeeEstimate>;
+    /**
+     * Bridge tokens from GalaChain to Solana.
+     *
+     * @param params - Bridge out parameters
+     * @returns Transaction details
+     */
+    bridgeOut(params: BridgeOutParams): Promise<BridgeTransaction>;
+    /**
+     * Bridge tokens from Solana to GalaChain.
+     *
+     * @param params - Bridge in parameters
+     * @returns Transaction details
+     */
+    bridgeIn(params: BridgeInParams): Promise<BridgeTransaction>;
+    /**
+     * Get the current status of a bridge transaction.
+     *
+     * @param transactionHash - Transaction hash to check
+     * @returns Current status
+     */
+    getStatus(transactionHash: string): Promise<BridgeStatus>;
+    /**
+     * Get list of supported tokens for Solana bridging.
+     *
+     * @returns Array of token symbols
+     */
+    getSupportedTokens(): string[];
+    /**
+     * Check if a token is supported for Solana bridging.
+     *
+     * @param tokenSymbol - Token symbol to check
+     * @returns True if supported
+     */
+    isTokenSupported(tokenSymbol: string): boolean;
+    /**
+     * Validate a Solana address.
+     *
+     * @param address - Address to validate
+     * @returns True if valid Solana address
+     */
+    isValidAddress(address: string): boolean;
+    /**
+     * Get the configured Solana wallet address.
+     *
+     * @returns Solana wallet address (base58 format)
+     *
+     * @example
+     * ```typescript
+     * const address = strategy.getWalletAddress();
+     * console.log(`Wallet: ${address}`);
+     * ```
+     */
+    getWalletAddress(): string;
+    /**
+     * Get SPL token balance for a Solana address.
+     *
+     * @param tokenSymbol - Token symbol ('GALA' or 'GSOL')
+     * @param address - Optional Solana address (defaults to configured wallet)
+     * @returns Token balance as decimal string (returns "0" for zero balance)
+     * @throws Error if token not supported or address invalid
+     *
+     * @remarks
+     * If the token account does not exist, this method returns "0" rather than
+     * throwing an error, as non-existent accounts are equivalent to zero balance.
+     *
+     * @example
+     * ```typescript
+     * const balance = await strategy.getSolanaTokenBalance('GALA');
+     * console.log(`Balance: ${balance} GALA`);
+     *
+     * // Check another address
+     * const otherBalance = await strategy.getSolanaTokenBalance('GALA', 'SolanaAddress...');
+     * ```
+     */
+    getSolanaTokenBalance(tokenSymbol: string, address?: string): Promise<string>;
+    /**
+     * Get native SOL balance for a Solana address.
+     *
+     * @param address - Optional Solana address (defaults to configured wallet)
+     * @returns SOL balance as decimal string (9 decimals)
+     * @throws Error if address invalid
+     *
+     * @example
+     * ```typescript
+     * const solBalance = await strategy.getSolanaNativeBalance();
+     * console.log(`SOL Balance: ${solBalance} SOL`);
+     * ```
+     */
+    getSolanaNativeBalance(address?: string): Promise<string>;
+    /**
+     * Get token metadata from cache or API.
+     */
+    private getTokenMetadata;
+    /**
+     * Build EIP-712 signed bridge out payload.
+     */
+    private buildBridgeOutPayload;
+    /**
+     * Execute Solana bridge out transaction.
+     */
+    private executeSolanaBridgeOut;
+    /**
+     * Build instruction for native SOL bridging.
+     */
+    private buildNativeBridgeInstruction;
+    /**
+     * Build instruction for SPL token bridging.
+     */
+    private buildTokenBridgeInstruction;
+    /**
+     * Get cached Solana bridge accounts for a mint.
+     */
+    private getSolanaBridgeAccounts;
+    /**
+     * Normalize fee response for deterministic signing.
+     */
+    private normalizeDestinationChainTxFee;
+    /**
+     * Remove undefined values for deterministic JSON.
+     */
+    private sanitizeObject;
+    /**
+     * Extract bridge request ID from response.
+     */
+    private extractBridgeRequestId;
+}
+//# sourceMappingURL=SolanaBridgeStrategy.d.ts.map

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * Bridge Strategies Index
+ *
+ * Re-exports all bridge strategy implementations.
+ */
+export * from './BridgeStrategy.js';
+export * from './EthereumBridgeStrategy.js';
+export * from './SolanaBridgeStrategy.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/bridge/strategies/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC"}