Documentation Index
Fetch the complete documentation index at: https://docs.lasersell.io/llms.txt
Use this file to discover all available pages before exploring further.
HTTP 状态码
| 状态 | 含义 | 可重试 |
|---|
| 200 | 成功 | 不适用 |
| 400 | 错误请求（无效参数、无效代币地址、不支持的代币程序） | 否 |
| 401 | 未授权（缺少或无效的 API 密钥） | 否 |
| 404 | 不支持的市场或代币地址尚未索引 | 否（见下文） |
| 422 | 无法处理（有效请求但无可用路由） | 否 |
| 429 | 速率限制 | 是 |
| 502 | 网关错误（上游 RPC 或 DEX 故障） | 是 |
| 503 | 服务不可用（路由器未就绪或已暂停） | 是 |
| 500 | 内部服务器错误 | 是 |
响应信封
{
"status": "ok",
"tx": "base64-encoded unsigned transaction",
"route": { "market_type": "pumpswap", "pool_id": "..." }
}
不支持的市场
当代币在任何支持的 DEX 上没有可用路由时返回。message 字段提供人类和 AI 可读的说明。
{
"status": "unsupported",
"reason": "no_route",
"message": "No supported market found for this mint. Supported DEXs: PumpSwap, Raydium (CPMM, Launchpad), Meteora (DBC, DAMM v2), Pump.fun."
}
| 原因 | 状态 | 说明 |
|---|
no_route | 404 | 没有支持的 DEX 有此代币的池 |
invalid_mint | 400 | 代币地址在链上不存在 |
unsupported_token_program | 400 | 代币使用 SPL Token 或 Token-2022 以外的程序 |
未索引
当代币存在但尚未解析时返回。短暂延迟后重试。
{
"status": "not_indexed",
"mint": "So11111111111111111111111111111111111111112",
"reason": "mint not indexed yet; try again shortly"
}
{
"error": "descriptive error message"
}
ExitApiError 类型呈现。
ExitApiError 类型
每个 SDK 都暴露一个带有 kind 判别器的 ExitApiError（或等效类型）：
| Kind | 触发条件 | 可重试 |
|---|
transport | 网络故障、DNS 错误、超时 | 是 |
http_status | 非 2xx HTTP 响应 | 状态 >= 500 或 429 时是 |
envelope_status | 服务器返回 { "status": "error" } | 否 |
parse | 响应体无法解析为 JSON | 否 |
检查可重试性
import { ExitApiError } from "@lasersell/lasersell-sdk";
try {
const response = await client.buildSellTx(request);
} catch (error) {
if (error instanceof ExitApiError) {
console.log("Kind:", error.kind);
console.log("Retryable:", error.isRetryable());
console.log("HTTP status:", error.status);
console.log("Body:", error.body);
}
}
内置重试行为
所有 SDK 包含自动重试，默认值如下：
| 设置 | 默认值 |
|---|
| 最大尝试次数 | 2 |
| 初始退避 | 25 ms |
| 最大退避 | 25 ms |
| 抖动 | 25 ms |
| 连接超时 | 200 ms |
| 尝试超时 | 900 ms |
isRetryable() 返回 true 时触发（传输故障、5xx 响应和 429 速率限制）。
自定义重试策略
const client = ExitApiClient.withOptions("YOUR_API_KEY", {
attempt_timeout_ms: 2000,
retry_policy: {
max_attempts: 3,
initial_backoff_ms: 50,
max_backoff_ms: 200,
jitter_ms: 50,
},
});
最佳实践
- 不要重试
400、401 或 422 错误。这些表示必须在代码中修复的请求或认证问题。
- 不要重试
404 且 "status": "unsupported" 的响应。该代币没有支持的市场。
- 重试一次
404 且 "status": "not_indexed" 的响应。代币可能需要一点时间来解析。
- 指数退避
429 响应。内置重试自动处理。
- 带退避重试
502 和 503 错误。这些是暂时的基础设施问题。
- 记录错误详情，包括
kind、status 和 body 以便调试。
- 如果持续看到
envelope_status 错误，验证你的 mint 地址和 user_pubkey 是否正确。
