inithipk;
This commit is contained in:
ZOMBIIIIIII
@@ -3937,7 +3937,51 @@
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "LiFi quote + _source (near|best) + appCommission (наша 0.7% в токене + USDT; информативно, считается из action.fromToken/estimate.fromAmountUSD; сбор — атомарно в /bridge/execute). Пример appCommission: { ratePercent: 0.7, inToken: { symbol: \"USDT\", amount: \"0.7\" }, usd: 0.7 }"
|
||||
"description": "LiFi quote (passthrough) + _source (near|best) + appCommission (наша 0.7%, информативно; сбор — атомарно в /bridge/execute)",
|
||||
"content": { "application/json": { "schema": {
|
||||
"type": "object",
|
||||
"additionalProperties": true,
|
||||
"description": "Сырой LiFi-quote + наши поля. Ниже задокументированы ключевые.",
|
||||
"properties": {
|
||||
"_source": { "type": "string", "enum": ["near", "best"], "description": "near = NearIntents, best = любой best route" },
|
||||
"tool": { "type": "string", "example": "near" },
|
||||
"toolDetails": { "type": "object", "additionalProperties": true },
|
||||
"estimate": {
|
||||
"type": "object",
|
||||
"additionalProperties": true,
|
||||
"properties": {
|
||||
"fromAmount": { "type": "string" },
|
||||
"fromAmountUSD": { "type": "string", "example": "10.03" },
|
||||
"toAmount": { "type": "string", "description": "сколько получишь (smallest units)" },
|
||||
"toAmountMin": { "type": "string", "description": "минимум с учётом slippage → передай как acceptedMinOut в /bridge/execute" },
|
||||
"toAmountUSD": { "type": "string" },
|
||||
"executionDuration": { "type": "number", "description": "оценка, сек" },
|
||||
"gasCosts": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
|
||||
"feeCosts": { "type": "array", "items": { "type": "object", "additionalProperties": true } }
|
||||
}
|
||||
},
|
||||
"action": {
|
||||
"type": "object",
|
||||
"additionalProperties": true,
|
||||
"properties": {
|
||||
"fromToken": { "type": "object", "additionalProperties": true, "properties": { "symbol": { "type": "string" }, "decimals": { "type": "integer" }, "address": { "type": "string" } } },
|
||||
"toToken": { "type": "object", "additionalProperties": true },
|
||||
"fromAmount": { "type": "string" }
|
||||
}
|
||||
},
|
||||
"transactionRequest": { "type": "object", "nullable": true, "additionalProperties": true, "description": "Готовая EVM-tx (to/data/value/chainId) — для ручной подписи через /wallets/{chain}/sign-raw-evm-tx" },
|
||||
"appCommission": {
|
||||
"type": "object",
|
||||
"nullable": true,
|
||||
"description": "Наша комиссия 0.7% (в токене + USDT). Информативно; реально списывается в /bridge/execute. Считается из action.fromToken + action.fromAmount + estimate.fromAmountUSD.",
|
||||
"properties": {
|
||||
"ratePercent": { "type": "number", "example": 0.7 },
|
||||
"inToken": { "type": "object", "properties": { "symbol": { "type": "string", "example": "USDC" }, "amount": { "type": "string", "example": "0.07", "description": "0.7% во входном токене" } } },
|
||||
"usd": { "type": "number", "nullable": true, "example": 0.07, "description": "та же 0.7% в USDT (≈USD)" }
|
||||
}
|
||||
}
|
||||
}
|
||||
} } }
|
||||
},
|
||||
"400": {
|
||||
"description": "Missing required params"
|
||||
@@ -3954,6 +3998,32 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"/jumper/quote": {
|
||||
"get": {
|
||||
"summary": "LiFi single quote (passthrough; без NearIntents-приоритета)",
|
||||
"description": "Прямой проброс на LiFi `/quote`. В отличие от `/jumper/quote-best` НЕ пробует NearIntents первым — отдаёт LiFi best route как есть. Ответ — сырой LiFi-quote + наше поле **appCommission** (наша 0.7% в токене + USDT, информативно; сбор — в /bridge/execute). Параметры те же, что у quote-best. Обычно используй quote-best.",
|
||||
"tags": ["Bridge (Jumper / LiFi)"],
|
||||
"parameters": [
|
||||
{ "name": "fromChain", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "LiFi chainId: ETH=1, BSC=56, SOL=1151111081099710, TRX=728126428, BTC=20000000000001" },
|
||||
{ "name": "toChain", "in": "query", "required": true, "schema": { "type": "integer" } },
|
||||
{ "name": "fromToken", "in": "query", "required": true, "schema": { "type": "string" }, "description": "contract / mint / native sentinel" },
|
||||
{ "name": "toToken", "in": "query", "required": true, "schema": { "type": "string" } },
|
||||
{ "name": "fromAmount", "in": "query", "required": true, "schema": { "type": "string" }, "description": "smallest units" },
|
||||
{ "name": "fromAddress", "in": "query", "required": true, "schema": { "type": "string" }, "description": "должен совпадать с кошельком юзера для fromChain (JWT-bind)" },
|
||||
{ "name": "toAddress", "in": "query", "required": false, "schema": { "type": "string" } },
|
||||
{ "name": "slippage", "in": "query", "required": false, "schema": { "type": "number", "example": 0.005 } }
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "LiFi quote (passthrough) + appCommission (наша 0.7% в токене + USDT). Поля — как у /jumper/quote-best (estimate, action, transactionRequest, appCommission)."
|
||||
},
|
||||
"400": { "description": "Missing required params" },
|
||||
"403": { "description": "fromAddress mismatch user wallet" },
|
||||
"502": { "description": "LiFi upstream / no route" },
|
||||
"504": { "description": "LiFi timeout" }
|
||||
}
|
||||
}
|
||||
},
|
||||
"/bridge/execute": {
|
||||
"post": {
|
||||
"summary": "One-click bridge execute (sign + broadcast)",
|
||||
|
||||
Reference in New Issue
Block a user