@oobe-protocol-labs/synapse-client-sdk 1.0.0-beta

package/dist/cjs/defi/jito.js

@@ -0,0 +1,291 @@
+"use strict";
+/**
+ * @file defi/jito.ts
+ * @module SolanaDeFi/Jito
+ * @author Keepeeto
+ * @license MIT
+ * @description Real Jito Block Engine API integration for MEV-protected transactions.
+ *              Complete implementation with bundle submission, status tracking, and tip management.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JitoIntegration = void 0;
+const eventemitter3_1 = require("eventemitter3");
+const web3_js_1 = require("@solana/web3.js");
+const types_1 = require("../types");
+// ============================================================================
+// Jito Integration
+// ============================================================================
+/**
+ * Jito Block Engine Integration
+ * Real Jito API for MEV-protected transaction bundles
+ *
+ * @example
+ * ```typescript
+ * const jito = new JitoIntegration(client);
+ *
+ * // Get tip account
+ * const tipAccount = jito.getTipAccount('mainnet');
+ *
+ * // Submit bundle
+ * const bundle = await jito.submitBundle({
+ *   transactions: [serializedTx1, serializedTx2],
+ *   tipLamports: 1_000_000,
+ * });
+ *
+ * // Check status
+ * const status = await jito.getBundleStatus(bundle.bundleId);
+ * ```
+ */
+class JitoIntegration extends eventemitter3_1.EventEmitter {
+    client;
+    blockEngineUrl;
+    // Official Jito tip accounts
+    tipAccounts = [
+        { address: '96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5', region: 'mainnet' },
+        { address: 'HFqU5x63VTqvQss8hp11i4wVV8bD44PvwucfZ2bU7gRe', region: 'ny' },
+        { address: 'Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY', region: 'amsterdam' },
+        { address: 'ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49', region: 'frankfurt' },
+        { address: 'DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh', region: 'tokyo' },
+        { address: 'ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt', region: 'mainnet' },
+        { address: '3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT', region: 'mainnet' },
+        { address: 'DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL', region: 'mainnet' },
+    ];
+    constructor(client, customUrl) {
+        super();
+        this.client = client;
+        this.blockEngineUrl = customUrl || 'https://mainnet.block-engine.jito.wtf';
+    }
+    /**
+     * Get recommended tip account based on region
+     */
+    getTipAccount(region = 'mainnet') {
+        const accounts = this.tipAccounts.filter((acc) => acc.region === region);
+        if (accounts.length === 0) {
+            return this.tipAccounts[0].address;
+        }
+        // Return random account from region for load balancing
+        return accounts[Math.floor(Math.random() * accounts.length)].address;
+    }
+    /**
+     * Get all tip accounts for a specific region
+     */
+    getTipAccountsByRegion(region) {
+        return this.tipAccounts
+            .filter((acc) => acc.region === region)
+            .map((acc) => acc.address);
+    }
+    /**
+     * Create tip instruction
+     */
+    createTipInstruction(from, tipLamports, tipAccount) {
+        const tipAccountPubkey = new web3_js_1.PublicKey(tipAccount || this.getTipAccount('mainnet'));
+        return web3_js_1.SystemProgram.transfer({
+            fromPubkey: from,
+            toPubkey: tipAccountPubkey,
+            lamports: tipLamports,
+        });
+    }
+    /**
+     * Submit bundle to Jito
+     */
+    async submitBundle(params) {
+        try {
+            this.emit('jito-bundle-submit', { txCount: params.transactions.length });
+            const response = await fetch(`${this.blockEngineUrl}/api/v1/bundles`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    jsonrpc: '2.0',
+                    id: 1,
+                    method: 'sendBundle',
+                    params: [params.transactions],
+                }),
+            });
+            if (!response.ok) {
+                throw new Error(`Jito bundle submission failed: ${response.status}`);
+            }
+            const data = await response.json();
+            if (data.error) {
+                throw new Error(data.error.message || 'Bundle submission failed');
+            }
+            const bundleId = data.result;
+            this.emit('jito-bundle-submitted', { bundleId });
+            return {
+                bundleId,
+                status: 'accepted',
+            };
+        }
+        catch (error) {
+            this.emit('jito-bundle-error', error);
+            throw new types_1.DeFiError(`Jito bundle submission failed: ${error.message}`, 'mev-protection', undefined, error);
+        }
+    }
+    /**
+     * Get bundle status
+     */
+    async getBundleStatus(bundleId) {
+        try {
+            const response = await fetch(`${this.blockEngineUrl}/api/v1/bundles`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    jsonrpc: '2.0',
+                    id: 1,
+                    method: 'getBundleStatuses',
+                    params: [[bundleId]],
+                }),
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to get bundle status: ${response.status}`);
+            }
+            const data = await response.json();
+            const bundleStatus = data.result?.value?.[0];
+            if (!bundleStatus) {
+                return {
+                    bundleId,
+                    status: 'pending',
+                };
+            }
+            return {
+                bundleId,
+                status: bundleStatus.confirmation_status || 'pending',
+                slot: bundleStatus.slot,
+                confirmations: bundleStatus.confirmations,
+                landedTipLamports: bundleStatus.landed_tips_lamports,
+            };
+        }
+        catch (error) {
+            throw new types_1.DeFiError(`Failed to get bundle status: ${error.message}`, 'mev-protection', undefined, error);
+        }
+    }
+    /**
+     * Get bundle statuses (batch)
+     */
+    async getBundleStatuses(bundleIds) {
+        try {
+            const response = await fetch(`${this.blockEngineUrl}/api/v1/bundles`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    jsonrpc: '2.0',
+                    id: 1,
+                    method: 'getBundleStatuses',
+                    params: [bundleIds],
+                }),
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to get bundle statuses: ${response.status}`);
+            }
+            const data = await response.json();
+            const statuses = data.result?.value || [];
+            return bundleIds.map((bundleId, index) => {
+                const status = statuses[index];
+                if (!status) {
+                    return { bundleId, status: 'pending' };
+                }
+                return {
+                    bundleId,
+                    status: status.confirmation_status || 'pending',
+                    slot: status.slot,
+                    confirmations: status.confirmations,
+                    landedTipLamports: status.landed_tips_lamports,
+                };
+            });
+        }
+        catch (error) {
+            throw new types_1.DeFiError(`Failed to get bundle statuses: ${error.message}`, 'mev-protection', undefined, error);
+        }
+    }
+    /**
+     * Get inflight bundle statuses
+     */
+    async getInflightBundleStatuses(bundleIds) {
+        try {
+            const response = await fetch(`${this.blockEngineUrl}/api/v1/bundles`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    jsonrpc: '2.0',
+                    id: 1,
+                    method: 'getInflightBundleStatuses',
+                    params: [bundleIds],
+                }),
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to get inflight statuses: ${response.status}`);
+            }
+            const data = await response.json();
+            const statuses = data.result?.value || [];
+            return statuses.map((status) => ({
+                bundleId: status.bundle_id,
+                status: status.status || 'pending',
+                slot: status.slot,
+                confirmations: status.confirmations,
+            }));
+        }
+        catch (error) {
+            throw new types_1.DeFiError(`Failed to get inflight statuses: ${error.message}`, 'mev-protection', undefined, error);
+        }
+    }
+    /**
+     * Get tip accounts
+     */
+    getTipAccounts() {
+        return [...this.tipAccounts];
+    }
+    /**
+     * Get tip accounts by region (convenience method)
+     */
+    getAllTipAccountsByRegion() {
+        const byRegion = new Map();
+        for (const account of this.tipAccounts) {
+            const existing = byRegion.get(account.region) || [];
+            existing.push(account.address);
+            byRegion.set(account.region, existing);
+        }
+        return byRegion;
+    }
+    /**
+     * Wait for bundle confirmation
+     */
+    async waitForBundleConfirmation(bundleId, options) {
+        const timeout = options?.timeout || 60000; // 60s default
+        const pollingInterval = options?.pollingInterval || 2000; // 2s default
+        const targetStatus = options?.confirmationStatus || 'confirmed';
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeout) {
+            const status = await this.getBundleStatus(bundleId);
+            if (status.status === 'landed' || status.status === 'failed') {
+                return status;
+            }
+            await new Promise(resolve => setTimeout(resolve, pollingInterval));
+        }
+        throw new types_1.DeFiError(`Bundle confirmation timeout after ${timeout}ms`, 'mev-protection', undefined);
+    }
+    /**
+     * Update block engine URL
+     */
+    setBlockEngineUrl(url) {
+        this.blockEngineUrl = url;
+    }
+    /**
+     * Get current block engine URL
+     */
+    getBlockEngineUrl() {
+        return this.blockEngineUrl;
+    }
+    /**
+     * Get recommended tip amount based on priority
+     */
+    getRecommendedTip(priority) {
+        const tips = {
+            low: 10_000, // 0.00001 SOL
+            medium: 100_000, // 0.0001 SOL
+            high: 1_000_000, // 0.001 SOL
+            turbo: 10_000_000, // 0.01 SOL
+        };
+        return tips[priority];
+    }
+}
+exports.JitoIntegration = JitoIntegration;
+//# sourceMappingURL=jito.js.map

package/dist/cjs/defi/jito.js.map

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

package/dist/cjs/defi/jupiter.d.ts

@@ -0,0 +1,143 @@
+/**
+ * @file defi/jupiter.ts
+ * @module SolanaDeFi/Jupiter
+ * @author Keepeeto
+ * @license MIT
+ * @description Real Jupiter V6 API integration for best swap routes on Solana.
+ *              Complete implementation with quote, swap, and price endpoints.
+ */
+import { EventEmitter } from 'eventemitter3';
+import { VersionedTransaction } from '@solana/web3.js';
+import type { SynapseClient } from '../client';
+export interface JupiterQuoteParams {
+    inputMint: string;
+    outputMint: string;
+    amount: number;
+    slippageBps?: number;
+    swapMode?: 'ExactIn' | 'ExactOut';
+    onlyDirectRoutes?: boolean;
+    asLegacyTransaction?: boolean;
+    platformFeeBps?: number;
+    maxAccounts?: number;
+}
+export interface JupiterQuoteResponse {
+    inputMint: string;
+    inAmount: string;
+    outputMint: string;
+    outAmount: string;
+    otherAmountThreshold: string;
+    swapMode: string;
+    slippageBps: number;
+    platformFee: {
+        amount: string;
+        feeBps: number;
+    } | null;
+    priceImpactPct: string;
+    routePlan: Array<{
+        swapInfo: {
+            ammKey: string;
+            label: string;
+            inputMint: string;
+            outputMint: string;
+            inAmount: string;
+            outAmount: string;
+            feeAmount: string;
+            feeMint: string;
+        };
+        percent: number;
+    }>;
+    contextSlot?: number;
+    timeTaken?: number;
+}
+export interface JupiterSwapResponse {
+    swapTransaction: string;
+    lastValidBlockHeight: number;
+    prioritizationFeeLamports: number;
+}
+export interface JupiterSwapOptions {
+    wrapUnwrapSOL?: boolean;
+    feeAccount?: string;
+    computeUnitPriceMicroLamports?: number;
+    prioritizationFeeLamports?: number;
+    asLegacyTransaction?: boolean;
+    useSharedAccounts?: boolean;
+    dynamicComputeUnitLimit?: boolean;
+}
+export interface JupiterTokenPrice {
+    id: string;
+    mintSymbol: string;
+    vsToken: string;
+    price: number;
+}
+/**
+ * Jupiter Aggregator V6 Integration
+ * Real Jupiter API integration for best swap routes across Solana DEXes
+ *
+ * @example
+ * ```typescript
+ * const jupiter = new JupiterIntegration(client);
+ *
+ * const quote = await jupiter.getQuote({
+ *   inputMint: 'So11111111111111111111111111111111111111112',
+ *   outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+ *   amount: 1_000_000_000,
+ *   slippageBps: 50,
+ * });
+ * ```
+ */
+export declare class JupiterIntegration extends EventEmitter {
+    private client;
+    private baseUrl;
+    constructor(client: SynapseClient, customUrl?: string);
+    /**
+     * Get quote from Jupiter aggregator
+     */
+    getQuote(params: JupiterQuoteParams): Promise<JupiterQuoteResponse>;
+    /**
+     * Get swap transaction from Jupiter
+     */
+    getSwapTransaction(quoteResponse: JupiterQuoteResponse, userPublicKey: string, options?: JupiterSwapOptions): Promise<JupiterSwapResponse>;
+    /**
+     * Execute complete swap (quote + swap + send)
+     */
+    executeSwap(params: JupiterQuoteParams, userPublicKey: string, options?: {
+        signTransaction?: (tx: VersionedTransaction) => Promise<VersionedTransaction>;
+        sendOptions?: {
+            skipPreflight?: boolean;
+            maxRetries?: number;
+        };
+        swapOptions?: JupiterSwapOptions;
+    }): Promise<{
+        signature: string;
+        quote: JupiterQuoteResponse;
+        success: boolean;
+    }>;
+    /**
+     * Get token price from Jupiter
+     */
+    getTokenPrice(mintAddress: string, vsToken?: string): Promise<JupiterTokenPrice>;
+    /**
+     * Get token prices (batch)
+     */
+    getTokenPrices(mintAddresses: string[], vsToken?: string): Promise<Map<string, JupiterTokenPrice>>;
+    /**
+     * Get supported tokens list
+     */
+    getTokenList(): Promise<Array<{
+        address: string;
+        symbol: string;
+        name: string;
+        decimals: number;
+        logoURI?: string;
+        tags?: string[];
+    }>>;
+    /**
+     * Update base URL for custom Jupiter instance
+     */
+    setBaseUrl(url: string): void;
+    /**
+     * Get current base URL
+     */
+    getBaseUrl(): string;
+}
+//# sourceMappingURL=jupiter.d.ts.map

package/dist/cjs/defi/jupiter.d.ts.map

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

package/dist/cjs/defi/jupiter.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * @file defi/jupiter.ts
+ * @module SolanaDeFi/Jupiter
+ * @author Keepeeto
+ * @license MIT
+ * @description Real Jupiter V6 API integration for best swap routes on Solana.
+ *              Complete implementation with quote, swap, and price endpoints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JupiterIntegration = void 0;
+const eventemitter3_1 = require("eventemitter3");
+const web3_js_1 = require("@solana/web3.js");
+const types_1 = require("../types");
+// ============================================================================
+// Jupiter Integration
+// ============================================================================
+/**
+ * Jupiter Aggregator V6 Integration
+ * Real Jupiter API integration for best swap routes across Solana DEXes
+ *
+ * @example
+ * ```typescript
+ * const jupiter = new JupiterIntegration(client);
+ *
+ * const quote = await jupiter.getQuote({
+ *   inputMint: 'So11111111111111111111111111111111111111112',
+ *   outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+ *   amount: 1_000_000_000,
+ *   slippageBps: 50,
+ * });
+ * ```
+ */
+class JupiterIntegration extends eventemitter3_1.EventEmitter {
+    client;
+    baseUrl;
+    constructor(client, customUrl) {
+        super();
+        this.client = client;
+        this.baseUrl = customUrl || 'https://quote-api.jup.ag/v6';
+    }
+    /**
+     * Get quote from Jupiter aggregator
+     */
+    async getQuote(params) {
+        try {
+            this.emit('jupiter-quote-start', params);
+            const queryParams = new URLSearchParams({
+                inputMint: params.inputMint,
+                outputMint: params.outputMint,
+                amount: params.amount.toString(),
+                slippageBps: (params.slippageBps || 50).toString(),
+                swapMode: params.swapMode || 'ExactIn',
+                onlyDirectRoutes: params.onlyDirectRoutes ? 'true' : 'false',
+                asLegacyTransaction: params.asLegacyTransaction ? 'true' : 'false',
+                ...(params.maxAccounts && { maxAccounts: params.maxAccounts.toString() }),
+                ...(params.platformFeeBps && { platformFeeBps: params.platformFeeBps.toString() }),
+            });
+            const response = await fetch(`${this.baseUrl}/quote?${queryParams.toString()}`);
+            if (!response.ok) {
+                const error = await response.text();
+                throw new types_1.DeFiError(`Jupiter quote failed: ${response.status} ${error}`, 'quote', 'jupiter');
+            }
+            const quote = await response.json();
+            this.emit('jupiter-quote-complete', {
+                inAmount: quote.inAmount,
+                outAmount: quote.outAmount,
+                priceImpact: quote.priceImpactPct,
+            });
+            return quote;
+        }
+        catch (error) {
+            this.emit('jupiter-quote-error', error);
+            throw new types_1.DeFiError(`Jupiter quote failed: ${error.message}`, 'quote', 'jupiter', error);
+        }
+    }
+    /**
+     * Get swap transaction from Jupiter
+     */
+    async getSwapTransaction(quoteResponse, userPublicKey, options) {
+        try {
+            this.emit('jupiter-swap-tx-start', { user: userPublicKey });
+            const response = await fetch(`${this.baseUrl}/swap`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    quoteResponse,
+                    userPublicKey,
+                    wrapAndUnwrapSol: options?.wrapUnwrapSOL ?? true,
+                    useSharedAccounts: options?.useSharedAccounts ?? true,
+                    feeAccount: options?.feeAccount,
+                    computeUnitPriceMicroLamports: options?.computeUnitPriceMicroLamports,
+                    prioritizationFeeLamports: options?.prioritizationFeeLamports,
+                    asLegacyTransaction: options?.asLegacyTransaction ?? false,
+                    dynamicComputeUnitLimit: options?.dynamicComputeUnitLimit ?? true,
+                }),
+            });
+            if (!response.ok) {
+                const error = await response.text();
+                throw new types_1.DeFiError(`Jupiter swap transaction failed: ${response.status} ${error}`, 'swap', 'jupiter');
+            }
+            const swapData = await response.json();
+            this.emit('jupiter-swap-tx-complete', {
+                txSize: swapData.swapTransaction.length,
+                priorityFee: swapData.prioritizationFeeLamports,
+            });
+            return swapData;
+        }
+        catch (error) {
+            this.emit('jupiter-swap-tx-error', error);
+            throw new types_1.DeFiError(`Jupiter swap transaction failed: ${error.message}`, 'swap', 'jupiter', error);
+        }
+    }
+    /**
+     * Execute complete swap (quote + swap + send)
+     */
+    async executeSwap(params, userPublicKey, options) {
+        try {
+            // Step 1: Get quote
+            const quote = await this.getQuote(params);
+            // Step 2: Get swap transaction
+            const swapData = await this.getSwapTransaction(quote, userPublicKey, options?.swapOptions);
+            // Step 3: Deserialize and sign transaction
+            const txBuffer = Buffer.from(swapData.swapTransaction, 'base64');
+            let transaction = web3_js_1.VersionedTransaction.deserialize(txBuffer);
+            if (options?.signTransaction) {
+                transaction = await options.signTransaction(transaction);
+            }
+            else {
+                throw new types_1.DeFiError('signTransaction callback required for executeSwap', 'swap', 'jupiter');
+            }
+            // Step 4: Send transaction via Synapse RPC
+            const signature = await this.client.call('sendTransaction', [
+                Buffer.from(transaction.serialize()).toString('base64'),
+                {
+                    skipPreflight: options?.sendOptions?.skipPreflight ?? false,
+                    maxRetries: options?.sendOptions?.maxRetries ?? 3,
+                    encoding: 'base64',
+                },
+            ]);
+            this.emit('jupiter-swap-complete', { signature });
+            return {
+                signature,
+                quote,
+                success: true,
+            };
+        }
+        catch (error) {
+            this.emit('jupiter-swap-error', error);
+            throw new types_1.DeFiError(`Jupiter swap execution failed: ${error.message}`, 'swap', 'jupiter', error);
+        }
+    }
+    /**
+     * Get token price from Jupiter
+     */
+    async getTokenPrice(mintAddress, vsToken = 'USDC') {
+        try {
+            const response = await fetch(`https://price.jup.ag/v4/price?ids=${mintAddress}&vsToken=${vsToken}`);
+            if (!response.ok) {
+                throw new Error(`Price API failed: ${response.status}`);
+            }
+            const data = await response.json();
+            return data.data[mintAddress];
+        }
+        catch (error) {
+            throw new types_1.DeFiError(`Failed to get token price: ${error.message}`, 'quote', 'jupiter', error);
+        }
+    }
+    /**
+     * Get token prices (batch)
+     */
+    async getTokenPrices(mintAddresses, vsToken = 'USDC') {
+        try {
+            const ids = mintAddresses.join(',');
+            const response = await fetch(`https://price.jup.ag/v4/price?ids=${ids}&vsToken=${vsToken}`);
+            if (!response.ok) {
+                throw new Error(`Price API failed: ${response.status}`);
+            }
+            const data = await response.json();
+            const priceMap = new Map();
+            for (const [mint, priceInfo] of Object.entries(data.data)) {
+                priceMap.set(mint, priceInfo);
+            }
+            return priceMap;
+        }
+        catch (error) {
+            throw new types_1.DeFiError(`Failed to get token prices: ${error.message}`, 'quote', 'jupiter', error);
+        }
+    }
+    /**
+     * Get supported tokens list
+     */
+    async getTokenList() {
+        try {
+            const response = await fetch('https://token.jup.ag/all');
+            if (!response.ok) {
+                throw new Error(`Token list API failed: ${response.status}`);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            throw new types_1.DeFiError(`Failed to get token list: ${error.message}`, 'quote', 'jupiter', error);
+        }
+    }
+    /**
+     * Update base URL for custom Jupiter instance
+     */
+    setBaseUrl(url) {
+        this.baseUrl = url;
+    }
+    /**
+     * Get current base URL
+     */
+    getBaseUrl() {
+        return this.baseUrl;
+    }
+}
+exports.JupiterIntegration = JupiterIntegration;
+//# sourceMappingURL=jupiter.js.map