Guide de l'API OKX DEX : création d'une interface d'échange de jetons Solana

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 :

• Swaps mono-chaîne : SOL vers USDC sur Solana
• Capacités inter-chaînes : SOL à MATIC (Polygon)

Présentation du fichier utilitaire de l'API DEX

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 :

• Configurations réseau et jetons
• Construction d'en-tête
• Point de terminaison de l'API et construction d'appels
• Récupération de devis
• Échanges à chaîne unique
• Citations inter-chaînes

Conditions préalables

Avant de commencer, vous avez besoin de :

• Node.js installé (v16 ou version ultérieure)
• Connaissance de base du développement de Solana
• Une adresse de portefeuille Solana et une clé privée
• Identifiants de l'API OKX (clé API, clé secrète et phrase secrète) du portail des développeurs OKX
• Un ID de projet du portail des développeurs OKX
• Git installé sur votre machine
• Identifiants d'API RPC (clé API, point de terminaison Solana dédié) d'un fournisseur de nœuds comme Quicknode

Installation

Vous avez deux options pour commencer :

Option 1 : Développement local

1. Clonez le dépôt et passez à la branche Solana :

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

1. Installez les dépendances :

npm install

1. Configurez vos variables d'environnement :

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

Option 2 : Utiliser Répliquer

1. Fork le projet Replit :
   Application OKX Solana Swap

2. Ajoutez vos variables d'environnement dans l'onglet Replit Secrets (situé dans le panneau Outils) :

   • Cliquez sur "Secrets"
   • Ajoutez chaque variable d'environnement répertoriée ci-dessus

3. Cliquez sur "Exécuter" pour démarrer votre environnement de développement

Configuration initiale

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";
</api_key></api_key>

Obtenir des devis d'échange

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];
}
</object>

Exécution de transactions

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;
    }
}
</object>

Implémentation du composant React

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

Ressources supplémentaires

• Documentation de l'API OKX DEX
• Documentation Solana
• Référentiel de code source

---

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!