Prêt à intégrer l'agrégation DEX dans votre Solana DApp ? Ce didacticiel vous montre comment interagir avec l'API OKX DEX pour effectuer des échanges de jetons sur la blockchain Solana. Votre implémentation utilisera Web3.js et l'API OKX DEX pour créer une gestion robuste des devis et de l'exécution des swaps. Par défaut, cette implémentation démontre :
Ce tutoriel se concentre sur l'implémentation de dexUtils.js, un fichier utilitaire qui contient toutes les fonctions nécessaires pour interagir avec l'API OKX DEX sur Solana. Ce fichier gère :
Avant de commencer, vous avez besoin de :
Vous avez deux options pour commencer :
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
Fork le projet Replit :
Application OKX Solana Swap
Ajoutez vos variables d'environnement dans l'onglet Replit Secrets (situé dans le panneau Outils) :
Cliquez sur "Exécuter" pour démarrer votre environnement de développement
Configurons notre configuration pour interagir avec Solana :
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";
Avant d'exécuter un échange, nous devons obtenir un devis. Voici comment implémenter la fonctionnalité de devis :
/** * 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]; }
Voici l'implémentation pour exécuter des transactions de swap sur 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; } }
Le composant SolanaSwapTransaction montre comment implémenter les appels d'API DEX dans une interface React :
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
Vous avez trouvé cela utile ? N'oubliez pas de consulter le code passe-partout et la documentation liée ci-dessus. Rejoignez la communauté OKX OS pour vous connecter avec d'autres développeurs et suivez Julian sur Twitter pour plus de contenu de développement Solana !
Ce contenu est fourni à titre informatif uniquement et peut couvrir des produits qui ne sont pas disponibles dans votre région. Il représente le point de vue du ou des auteurs et ne représente pas le point de vue d’OKX. Il n’est pas destiné à fournir (i) des conseils en investissement ou une recommandation d’investissement ; (ii) une offre ou une sollicitation d'achat, de vente ou de détention d'actifs numériques, ou (iii) des conseils financiers, comptables, juridiques ou fiscaux. Les avoirs en actifs numériques, y compris les pièces stables et les NFT, comportent un degré de risque élevé et peuvent fluctuer considérablement. Vous devez soigneusement déterminer si le trading ou la détention d’actifs numériques vous convient, compte tenu de votre situation financière. Veuillez consulter votre professionnel du droit/fiscalité/investissement pour toute question concernant votre situation spécifique. Les informations (y compris les données de marché et les informations statistiques, le cas échéant) apparaissant dans cet article sont uniquement fournies à des fins d'information générale. Bien que tous les soins raisonnables aient été apportés à la préparation de ces données et graphiques, aucune responsabilité n'est acceptée pour toute erreur de fait ou omission exprimée dans le présent document. OKX Web3 Wallet et OKX NFT Marketplace sont soumis à des conditions de service distinctes sur www.okx.com.
© 2024 OKX. Cet article peut être reproduit ou distribué dans son intégralité, ou des extraits de 100 mots ou moins de cet article peuvent être utilisés, à condition qu'une telle utilisation soit non commerciale. Toute reproduction ou distribution de l'intégralité de l'article doit également indiquer clairement : « Cet article est © 2024 OKX et est utilisé avec autorisation. » Les extraits autorisés doivent citer le nom de l'article et inclure l'attribution, par exemple « Intégrez le widget OKX DEX en seulement 30 minutes, Julian Martinez, © 2024 OKX. » Aucune œuvre dérivée ou autre utilisation de cet article n'est autorisée.
© 2024 OKX. Tous droits réservés.
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!