Bereit, die DEX-Aggregation in Ihre Solana-DApp zu integrieren? Dieses Tutorial zeigt Ihnen, wie Sie mit der OKX DEX-API interagieren, um Token-Austausche auf der Solana-Blockchain durchzuführen. Ihre Implementierung verwendet Web3.js und die OKX DEX-API, um eine robuste Handhabung von Angeboten und Swap-Ausführung zu schaffen. Standardmäßig zeigt diese Implementierung Folgendes:
Dieses Tutorial konzentriert sich auf die Implementierung von dexUtils.js, einer Dienstprogrammdatei, die alle notwendigen Funktionen für die Interaktion mit der OKX DEX API auf Solana enthält. Diese Datei behandelt:
Bevor Sie beginnen, benötigen Sie:
Sie haben zwei Möglichkeiten, um loszulegen:
git clone https://github.com/Julian-dev28/okx-os-evm-swap-app.git cd okx-os-evm-swap-app git checkout solana-cross-chain-swap
npm install
REACT_APP_API_KEY=your_api_key REACT_APP_SECRET_KEY=your_secret_key REACT_APP_API_PASSPHRASE=your_passphrase REACT_APP_PROJECT_ID=your_project_id REACT_APP_USER_ADDRESS=your_wallet_address REACT_APP_PRIVATE_KEY=your_private_key
Forken Sie das Replit-Projekt:
OKX Solana Swap App
Fügen Sie Ihre Umgebungsvariablen auf der Registerkarte Replit Secrets (im Bedienfeld „Tools“) hinzu:
Klicken Sie auf „Ausführen“, um Ihre Entwicklungsumgebung zu starten
Lassen Sie uns unsere Konfiguration für die Interaktion mit Solana einrichten:
import { Connection } from "@solana/web3.js"; import base58 from "bs58"; import cryptoJS from "crypto-js"; // Constants for tokens and chain export const NATIVE_SOL = "11111111111111111111111111111111"; export const WRAPPED_SOL = "So11111111111111111111111111111111111111112"; export const USDC_SOL = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"; export const SOLANA_CHAIN_ID = "501"; // Initialize Solana connection export const connection = new Connection("https://mainnet.helius-rpc.com/?api-key=<API_KEY>", { confirmTransactionInitialTimeout: 5000, wsEndpoint: "wss://mainnet.helius-rpc.com/?api-key=<API_KEY>", }); // Environment variables for API authentication const apiKey = process.env.REACT_APP_API_KEY; const secretKey = process.env.REACT_APP_SECRET_KEY; const apiPassphrase = process.env.REACT_APP_API_PASSPHRASE; const projectId = process.env.REACT_APP_PROJECT_ID; // Base URL for API requests const apiBaseUrl = "https://www.okx.com/api/v5/dex";
Bevor wir einen Tausch durchführen, müssen wir ein Angebot einholen. So implementieren Sie die Angebotsfunktion:
/** * Gets swap data and optimal route from the OKX DEX API * Note: Requires API credentials from OKX Developer Portal * * @param {Object} params * @param {string} params.chainId - "501" for Solana * @param {string} params.amount - Amount in lamports (1 SOL = 1e9 lamports) * @param {string} params.fromTokenAddress - Source token (e.g., NATIVE_SOL) * @param {string} params.toTokenAddress - Destination token (e.g., USDC_SOL) * @param {string} params.slippage - Slippage tolerance ("0.5" for 0.5%) * @param {string} params.userWalletAddress - Solana wallet address * @returns {Promise<Object>} Contains routerResult.toTokenAmount and transaction data */ export async function getSingleChainSwap(params) { if (!apiKey || !secretKey || !apiPassphrase || !projectId) { throw new Error("Missing API credentials"); } const timestamp = new Date().toISOString(); const requestPath = "/api/v5/dex/aggregator/swap"; const queryString = "?" + new URLSearchParams(params).toString(); const headers = getHeaders(timestamp, "GET", requestPath, queryString); console.log("Requesting swap quote with params:", params); const response = await fetch( `https://www.okx.com${requestPath}${queryString}`, { method: "GET", headers } ); const data = await response.json(); if (data.code !== "0") { throw new Error(`API Error: ${data.msg}`); } if (!data.data?.[0]?.routerResult?.toTokenAmount) { throw new Error("Invalid or missing output amount"); } return data.data[0]; }
Hier ist die Implementierung zur Ausführung von Swap-Transaktionen auf Solana:
/** * Executes a Solana transaction with retry logic and compute budget * @param {Object} txData - Transaction data from the API * @returns {Promise<Object>} Transaction result with explorer URL */ export async function executeTransaction(txData) { if (!userPrivateKey) { throw new Error("Private key not found"); } try { // Get recent blockhash for transaction validity const recentBlockHash = await connection.getLatestBlockhash(); const decodedTransaction = base58.decode(txData.data); // Create transaction object const tx = solanaWeb3.Transaction.from(decodedTransaction); tx.recentBlockhash = recentBlockHash.blockhash; // Create and add keypair for signing const feePayer = solanaWeb3.Keypair.fromSecretKey( base58.decode(userPrivateKey) ); tx.partialSign(feePayer); // Send transaction with retry options const txId = await connection.sendRawTransaction(tx.serialize(), { skipPreflight: false, maxRetries: 5 }); // Wait for confirmation const confirmation = await connection.confirmTransaction({ signature: txId, blockhash: recentBlockHash.blockhash, lastValidBlockHeight: recentBlockHash.lastValidBlockHeight }, 'confirmed'); return { success: true, transactionId: txId, explorerUrl: `https://solscan.io/tx/${txId}`, confirmation }; } catch (error) { console.error("Transaction failed:", error); throw error; } }
Die SolanaSwapTransaction-Komponente zeigt, wie die DEX-API-Aufrufe in einer React-Schnittstelle implementiert werden:
git clone https://github.com/Julian-dev28/okx-os-evm-swap-app.git cd okx-os-evm-swap-app git checkout solana-cross-chain-swap
Fanden Sie das hilfreich? Vergessen Sie nicht, sich den oben verlinkten Boilerplate-Code und die Dokumentation anzusehen. Treten Sie der OKX OS-Community bei, um mit anderen Entwicklern in Kontakt zu treten, und folgen Sie Julian auf Twitter für weitere Solana-Entwicklungsinhalte!
Dieser Inhalt dient nur zu Informationszwecken und deckt möglicherweise Produkte ab, die in Ihrer Region nicht verfügbar sind. Es repräsentiert die Ansichten des Autors/der Autoren und nicht die Ansichten von OKX. Es ist nicht beabsichtigt, (i) eine Anlageberatung oder Anlageempfehlung bereitzustellen; (ii) ein Angebot oder eine Aufforderung zum Kauf, Verkauf oder Besitz digitaler Vermögenswerte oder (iii) Finanz-, Buchhaltungs-, Rechts- oder Steuerberatung. Der Besitz digitaler Vermögenswerte, einschließlich Stablecoins und NFTs, birgt ein hohes Risiko und kann stark schwanken. Sie sollten sorgfältig abwägen, ob der Handel oder das Halten digitaler Vermögenswerte angesichts Ihrer finanziellen Situation für Sie geeignet ist. Bei Fragen zu Ihren spezifischen Umständen wenden Sie sich bitte an Ihren Rechts-/Steuer-/Investmentexperten. Die in diesem Beitrag enthaltenen Informationen (einschließlich Marktdaten und statistischer Informationen, sofern vorhanden) dienen ausschließlich allgemeinen Informationszwecken. Obwohl bei der Erstellung dieser Daten und Grafiken die größtmögliche Sorgfalt angewendet wurde, wird keine Verantwortung oder Haftung für etwaige darin enthaltene Sachfehler oder Auslassungen übernommen. Sowohl OKX Web3 Wallet als auch OKX NFT Marketplace unterliegen separaten Nutzungsbedingungen unter www.okx.com.
© 2024 OKX. Dieser Artikel darf in seiner Gesamtheit reproduziert oder verbreitet werden, oder es dürfen Auszüge von 100 Wörtern oder weniger dieses Artikels verwendet werden, sofern diese Verwendung nicht kommerziell ist. Bei jeder Vervielfältigung oder Verbreitung des gesamten Artikels muss außerdem deutlich sichtbar sein: „Dieser Artikel ist © 2024 OKX und wird mit Genehmigung verwendet.“ Zulässige Auszüge müssen auf den Namen des Artikels verweisen und eine Quellenangabe enthalten, zum Beispiel „Integrieren Sie das OKX DEX Widget in nur 30 Minuten, Julian Martinez, © 2024 OKX.“ Es sind keine abgeleiteten Werke oder andere Verwendungen dieses Artikels gestattet.
© 2024 OKX. Alle Rechte vorbehalten.
Das obige ist der detaillierte Inhalt vonOKX DEX API-Leitfaden: Erstellen einer Solana-Token-Swap-Schnittstelle. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!