@gala-chain/launchpad-sdk 8.1.0 → 9.0.0-rc.0

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

@@ -1,236 +0,0 @@
-/**
- * Solana Bridge Strategy
- *
- * Implements bridging between GalaChain and Solana networks.
- * Handles SPL token accounts, PDA derivation, and Solana program interactions.
- */
-import type { GalaConnectClient } from '../GalaConnectClient.js';
-import type { BridgeFeeEstimate, BridgeInParams, BridgeOutParams, BridgeTransaction, ExternalNetwork, SolanaTokenConfig, SolanaTransactionStatus } from '../types/index.js';
-import { ConfiguredBridgeStrategy } from './BridgeStrategy.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 ConfiguredBridgeStrategy<SolanaTokenConfig> {
-    readonly network: ExternalNetwork;
-    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 tokenMetadataResolver;
-    /**
-     * 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>;
-    /**
-     * 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>;
-    /**
-     * Request SOL airdrop from Solana devnet faucet.
-     *
-     * Only works on Solana devnet (STAGE environment). Will throw an error
-     * if called when connected to mainnet.
-     *
-     * @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 or airdrop fails
-     *
-     * @example
-     * ```typescript
-     * // Airdrop 1 SOL to configured wallet
-     * const signature = await strategy.requestDevnetAirdrop();
-     *
-     * // Airdrop 0.5 SOL to specific address
-     * const signature = await strategy.requestDevnetAirdrop(0.5, 'SomeAddress...');
-     * ```
-     */
-    requestDevnetAirdrop(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.
-     *
-     * @param signature - Base58-encoded Solana transaction signature (87-88 characters)
-     * @returns Transaction status with:
-     *   - confirmed: Whether transaction has been processed on-chain
-     *   - status: Confirmation level ('confirmed' | 'finalized' | 'processed' | 'not_found' | 'failed')
-     *   - slot: Block slot number (present when transaction is found)
-     *   - error: Error details if transaction failed
-     *
-     * @throws Error if signature format is invalid
-     *
-     * @example Basic usage
-     * ```typescript
-     * const signature = await strategy.requestDevnetAirdrop(1);
-     * // Wait a moment for transaction to propagate
-     * await new Promise(r => setTimeout(r, 2000));
-     * const status = await strategy.getSolanaTransactionStatus(signature);
-     * console.log(status);
-     * // { confirmed: true, status: 'confirmed', slot: 123456789 }
-     * ```
-     *
-     * @example Polling pattern for confirmation
-     * ```typescript
-     * async function waitForConfirmation(signature: string, maxAttempts = 30) {
-     *   for (let i = 0; i < maxAttempts; i++) {
-     *     const status = await strategy.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>;
-    /**
-     * Execute Solana bridge out transaction.
-     */
-    private executeSolanaBridgeOut;
-    /**
-     * Send and confirm a Solana transaction with WebSocket primary, polling fallback.
-     * Tries WebSocket-based confirmation first (preferred for real-time feedback),
-     * falls back to polling if WebSocket fails with block height exceeded.
-     *
-     * @param transaction - The transaction to send (without blockhash/signature)
-     * @param keypair - The keypair to sign with
-     * @param maxRetries - Maximum number of retry attempts (default: 3)
-     * @returns The transaction signature
-     */
-    private sendAndConfirmWithFallback;
-    /**
-     * 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;
-}
-//# sourceMappingURL=SolanaBridgeStrategy.d.ts.map

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

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