Bitcoin 交易示例

通过 API 请求 Bitcoin 专属信息

链

curl --request GET \
     --url 'https://li.quest/v1/chains?chainTypes=UTXO' \
     --header 'accept: application/json'

工具

curl --request GET \
  --url 'https://li.quest/v1/tools?chains=20000000000001' \
  --header 'accept: application/json'

代币

curl --request GET \
     --url 'https://li.quest/v1/tokens?chains=BTC' \
     --header 'accept: application/json'

代币详情

curl --request GET \
     --url 'https://li.quest/v1/token?chain=20000000000001&token=bitcoin' \
     --header 'accept: application/json'

请求报价

Bitcoin 到 Ethereum

quote 与 advanced route 调用针对的是同一笔转账，但在结构上有所不同：GET /quote 接受诸如 fromChain 和 fromToken 之类的查询参数，而 POST /advanced/routes 期望一个 JSON 请求体，其中包含诸如 fromChainId 和 fromTokenAddress 之类的字段。

curl --request GET \
     --url 'https://li.quest/v1/quote?fromAddress=bc1qmdpxhzarlxrygtvlxrkkl0eqguszkzqdgg4py5&fromAmount=500000&fromChain=BTC&fromToken=bitcoin&toAddress=0x39333638696578786b61393361726b63717a6773&toChain=1&toToken=0x0000000000000000000000000000000000000000' \
     --header 'accept: application/json'

curl --request POST \
     --url https://li.quest/v1/advanced/routes \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "toTokenAddress": "0x0000000000000000000000000000000000000000",
  "fromTokenAddress": "bitcoin",
  "fromChainId": 20000000000001,
  "fromAmount": "10000000",
  "toChainId": 1,
  "fromAddress": "YOUR_BTC_WALLET",
  "toAddress": "YOUR_EVM_WALLET"
}
'

Ethereum 到 Bitcoin

curl --request GET \
     --url 'https://li.quest/v1/quote?fromChain=1&toChain=20000000000001&fromToken=0x0000000000000000000000000000000000000000&toToken=bitcoin&fromAddress=0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0&toAddress=bc1qmdpxhzarlxrygtvlxrkkl0eqguszkzqdgg4py5&fromAmount=500000000000000000' \
     --header 'accept: application/json'

curl --request POST \
     --url https://li.quest/v1/advanced/routes \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "toTokenAddress": "bitcoin",
  "fromTokenAddress": "0x0000000000000000000000000000000000000000",
  "fromChainId": 1,
  "fromAmount": "500000000000000000",
  "toChainId": 20000000000001,
  "fromAddress": "YOUR_EVM_WALLET",
  "toAddress": "YOUR_BTC_WALLET"
}
'

执行交易

构建自定义 Bitcoin 交易

合作伙伴可能希望构建自定义的 Bitcoin 交易，以选择特定的 UTXO，原因多种多样，例如币控制（coin control）、UTXO 合并或费用优化。 构建自定义交易时的要求：

保留 API 响应中确切的输出结构和顺序
确保所选 UTXO 具有足够的价值以覆盖：
- 桥接存款金额（第 1 个输出）
- 如桥接要求，则包含退款输出（第 3 个输出，必须高于 dust 阈值）
- 集成方费用（额外输出）

关键： 输出的顺序和结构不可修改。偏离 API 响应结构将导致交易卡住或失败。

交易数据

BTC 到 Ethereum、Avalanche 或 BNB Smart Chain（BSC） 在获取报价后，需要将资金连同一条 memo 一起发送到响应中提供的 BTC 保管库地址。 Memo 功能： 与 Thorchain 类似，LI.FI 在 BTC 到 EVM 的交换中使用 memo。根据所用工具的不同，BTC 交易中的 memo 会指定要执行的桥接专属交易数据，以及用于追踪的 LI.FI 内部详情。 交易处理： 离开 BTC 前往 EVM 的交易需要发送到一个 EVM 地址。memo 确保交换详情被验证者正确处理。

注意：请务必及时发送交易（约 30 分钟内）。始终建议请求最新的报价，以确保获取最新信息。

修改 Bitcoin 交易数据的风险修改从我们的 API 收到的 PSBT 或原始 Bitcoin 交易数据（例如移除输出、更改金额，或编辑 opcode/脚本）可能会使签名或花费条件失效，并导致资金不可逆转的损失。除非你是专家并且已明确与我们确认你打算进行的修改，否则请不要更改 PSBT。

以下是交易数据的一个示例

"transactionRequest": {
    "to": "bc1qawcdxplxprc64fh38ryy4crndmfgwrffpac743", //thorswap vault to send BTC to
    "data": "=:ETH.USDC:0x29DaCdF7cCaDf4eE67c923b4C22255A4B2494eD7::lifi:0|0x4977d81c2a5d6bd8",
    "value": "500000"
  }

从 PSBT 中提取交易数据

在使用所选 UTXO 构建自定义 Bitcoin 交易时，合作伙伴需要从 API 返回的 PSBT（部分签名的 Bitcoin 交易）中提取 memo 和其他交易详情。 关键信息：

memo 包含在 PSBT 的 OP_RETURN 输出（第 2 个输出）中
此 memo 必须完全按照所提供的内容保留 —— 它包含桥接专属的 calldata 和 LI.FI 追踪详情
存款人地址位于第 1 个输出中
退款地址（如需要）位于第 3 个输出中

合作伙伴可以解析 PSBT 以提取这些值，并在保持确切输出结构的同时，用其所选的 UTXO 重新构建交易。

各工具的 Bitcoin 交易要求

关键：输出结构不可修改API 提供的输出顺序和结构必须被精确复制。更改顺序、移除输出或修改金额将导致交易卡住。构建自定义交易的合作伙伴必须保留确切的结构，且仅更改输入 UTXO。

输出结构的一般要求如下：

第 1 个输出： 发送到桥接存款人地址的桥接金额
第 2 个输出： OP_RETURN，包含带有桥接专属和 LI.FI 追踪详情的 memo（必须完全保留）
第 3 个输出： 退款输出，返回给发送者的地址（对某些桥接为可选，对其他桥接为必需 —— 详见下文）
其余输出： 集成方专属的费用转账

Dust 阈值要求： 所有包含价值的输出必须超过 dust 阈值，该阈值由输出地址类型决定：

Pay To Witness Public Key Hash (p2wpkh) - 294 sats
Pay To Witness Script Hash (p2wsh) - 330 sats
Pay To Script Hash (p2sh) - 540 sats
Pay To Public Key Hash (p2pkh) - 546 sats
Pay To Taproot (p2tr) - 330 sats

桥接要求摘要

Thorswap

memo（OP_RETURN 输出）包含要执行的 Thorswap calldata 和 LI.FI 追踪 id。保留两者都很重要，以避免交易卡住或失败。

// Memo example
=:ETH.USDC:0x29DaCdF7cCaDf4eE67c923b4C22255A4B2494eD7::lifi:0|0x4977d81c2a5d6bd8

Unit

Unit 桥接在 memo 中不存储任何桥接专属详情，因此它仅包含 LI.FI 追踪详情。

// Memo example
// =|lifi02bf57fe

Symbiosis

Symbiosis 桥接在 memo 中不存储任何桥接专属详情，因此它仅包含 LI.FI 追踪详情。

// Memo example
=|lifi02bf57fe

不正确的交易结构将导致转账卡住，需要人工介入退款。请确保输出顺序与 API 响应完全一致。

Relay

memo（OP_RETURN 输出）包含要执行的 Relay calldata 和 LI.FI 追踪 id。保留两者都很重要，以避免交易卡住或失败。

// Memo example
0x986c2efd25b8887e9c187cfe2162753567339b6313e7137b749e83d4a1a79b03=|lifi92c9cbbc5

Chainflip

Chainflip PSBT 要求具有上文所述的三个输出。退款输出是必需的，如果跳过，交易将无法被正确处理。 memo（OP_RETURN 输出）包含要执行的 Chainflip payload 和 LI.FI 追踪 id。保留两者都很重要，以避免交易卡住或失败。

// Memo example
0x01071eb6638de8c571c787d7bc24f98bfa735425731c6400f4c5ef05000000000000000000000000ff010002001e0200=|lifi92c9cbbc5

关键：Chainflip 资金损失风险输出结构不正确的 Chainflip 交易将导致永久性、不可恢复的资金损失。与其他桥接不同，Chainflip 无法人工退还卡住的交易。强制性要求：

所有三个输出必须以确切顺序出现：(1) 存款金额，(2) OP_RETURN memo，(3) 退款输出
退款输出（第 3 个输出）是强制性的，且必须高于 dust 阈值
不要修改、移除或重新排序 API 响应中的任何输出

未能完全遵守这些要求将导致不可逆转的资金损失，且没有任何恢复选项。

了解 LI.FI

支持的系统

LI.FI 架构

用户流程和示例

了解更多

更新日志

Bitcoin 交易示例

通过 API 请求 Bitcoin 专属信息

链

工具

代币

代币详情

请求报价

Bitcoin 到 Ethereum

Ethereum 到 Bitcoin

执行交易

构建自定义 Bitcoin 交易

交易数据

从 PSBT 中提取交易数据

各工具的 Bitcoin 交易要求

桥接要求摘要

Thorswap

Unit

Symbiosis

Relay

Chainflip

​通过 API 请求 Bitcoin 专属信息

​链

​工具

​代币

​代币详情

​请求报价

​Bitcoin 到 Ethereum

​Ethereum 到 Bitcoin

​执行交易

​构建自定义 Bitcoin 交易

​交易数据

​从 PSBT 中提取交易数据

​各工具的 Bitcoin 交易要求

​桥接要求摘要

Thorswap

Unit

Symbiosis

Relay

Chainflip

通过 API 请求 Bitcoin 专属信息

链

工具

代币

代币详情

请求报价

Bitcoin 到 Ethereum

Ethereum 到 Bitcoin

执行交易

构建自定义 Bitcoin 交易

交易数据

从 PSBT 中提取交易数据

各工具的 Bitcoin 交易要求

桥接要求摘要