OKX DEX API-Leitfaden: Erstellen einer Solana-Token-Swap-Schnittstelle

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:

• Single-Chain-Swaps: SOL zu USDC auf Solana
• Kettenübergreifende Funktionen: SOL zu MATIC (Polygon)

Übersicht über die DEX-API-Dienstprogrammdatei

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:

• Netzwerk- und Token-Konfigurationen
• Header-Konstruktion
• API-Endpunkt- und Aufrufkonstruktion
• Angebotsabfrage
• Single-Chain-Swaps
• Kettenübergreifende Anführungszeichen

Voraussetzungen

Bevor Sie beginnen, benötigen Sie:

• Node.js installiert (v16 oder höher)
• Grundkenntnisse der Solana-Entwicklung
• Eine Solana-Wallet-Adresse und ein privater Schlüssel
• OKX-API-Anmeldeinformationen (API-Schlüssel, geheimer Schlüssel und Passphrase) aus dem OKX-Entwicklerportal
• Eine Projekt-ID aus dem OKX Developer Portal
• Git auf Ihrem Computer installiert
• RPC-API-Anmeldeinformationen (API-Schlüssel, dedizierter Solana-Endpunkt) von einem Knotenanbieter wie Quicknode

Aufstellen

Sie haben zwei Möglichkeiten, um loszulegen:

Option 1: Lokale Entwicklung

1. Klonen Sie das Repository und wechseln Sie zum Solana-Zweig:

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. Installieren Sie die Abhängigkeiten:

npm install

1. Richten Sie Ihre Umgebungsvariablen ein:

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: Verwenden von Replit

1. Forken Sie das Replit-Projekt:
   OKX Solana Swap App

2. Fügen Sie Ihre Umgebungsvariablen auf der Registerkarte Replit Secrets (im Bedienfeld „Tools“) hinzu:

   • Klicken Sie auf „Geheimnisse“
   • Fügen Sie alle oben aufgeführten Umgebungsvariablen hinzu

3. Klicken Sie auf „Ausführen“, um Ihre Entwicklungsumgebung zu starten

Erstkonfiguration

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

Einholen von Swap-Angeboten

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

Transaktionen ausführen

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

Implementierung der React-Komponente

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

Zusätzliche Ressourcen

• OKX DEX API-Dokumentation
• Solana-Dokumentation
• Quellcode-Repository

---

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!