跳转到主要内容

快速入门

本指南涵盖了开始集成 Kroko DEX 所需的全部内容 — 连接网络、设置合约引用以及发起第一个 API 调用。

前置条件

  • 一个钱包库(例如 ethers.jsviem
  • Node.js 18+(用于服务端集成)或现代浏览器(用于前端)

1. 连接到 Kasplex

将 Kasplex 网络添加到你的钱包或 Provider:
import { ethers } from 'ethers';

// 主网
const provider = new ethers.JsonRpcProvider('https://evmrpc.kasplex.org');

// 测试网
const testnetProvider = new ethers.JsonRpcProvider('https://rpc.kasplextest.xyz');

2. 合约地址

根据目标网络引用已部署的合约:
const CONTRACTS = {
  PERMIT2: '0x2E1987F680FD7Bc8B33d3Bf94f12B988A0B50034',
  UNIVERSAL_ROUTER: '0xefeCc1c2dE3BfE4C6D43030F2AcDD5C3cE279024',
  WKAS: '0x2c2Ae87Ba178F48637acAe54B87c3924F544a83e',
  V2_FACTORY: '0x4373b7Fcf5059A785843cD224129e01d243Aef71',
  V2_ROUTER: '0xC7ca845B8302346e1C7227f03bb9EFb35ecD51fe',
  V3_FACTORY: '0x0dfb1Bb755d872EA1fa4d95E4ad0c2E6317Ce9B9',
  V3_POSITION_MANAGER: '0x343b244bEDF133D57C61b241557bF29AA32ea4F9',
};
完整合约地址表请参阅 合约地址

3. API 基础 URL

Swap API 地址为:
https://dex.kasplex.org/swap-api

4. 第一个 API 调用

获取代币列表以验证连通性:
const response = await fetch('https://dex.kasplex.org/api/v1/tokens2?limit=10');
const data = await response.json();
console.log(data.tokens);
// [{ address: '0x...', symbol: 'WKAS', name: 'Wrapped KAS', decimals: 18 }, ...]

5. 获取报价

尝试获取交换报价:
const params = new URLSearchParams({
  tokenIn: CONTRACTS.WKAS,
  tokenOut: '0xB190a6A7fC2873f1Abf145279eD664348d5Ef630', // 示例代币
  amountIn: '1000000000000000000', // 1 KAS
  tradeType: '0'
});

const quote = await fetch(`https://dex.kasplex.org/swap-api/api/v1/quote?${params}`);
const data = await quote.json();
console.log(`1 KAS = ${data.executionPrice} 个代币`);

下一步