Trace Bundle

介紹BlockRazor Block Builder的Trace Bundle接入方法

介紹

本方法支持通過bundle hash查詢該 bundle 的當前狀態，請在向builder發送 bundle 後 5 分鐘進行查詢。端點：https://bsc-bundle-stats.blockrazor.io/

價格

採購Trace Bundle服務的用戶可同時訪問控制台中的Bundle Explorer

用戶類型	限流	價格
付費用戶	1000筆 / 天	$1500 / 月

請求參數

參數	必選	格式	示例	描述
hash	是	hash	0x25f9……317097	bundle hash

請求示例

HTTPS

curl -X GET "https://bsc-bundle-stats.blockrazor.io/bundlestate?hash=0x25f9fc35e978709195c00e864b9a19fb41ad5c5c5b8a3e003813ae9727317097" \
     -H "Content-Type: application/json" \
     -H "Authorization: M2ZiZj……JhODA1"

返回示例

正常

{
  "bundle": {
    "timestamp": "2025-04-07T09:04:40Z", // builder接收bundle的時間（UTC）
    "bundleHash": "0x25f9fc35e978709195c00e864b9a19fb41ad5c5c5b8a3e003813ae9727317097", // bundle哈希
    "state": "onchain", // bundle已上鏈
    "blockNumber": 48144954, // bundle所在的區塊號
    "priority": "358911000000000" // bundle價值，單位為wei
  }
}

异常- failed

{
  "bundle": {
    "timestamp": "2025-04-08T05:21:10Z", // builder接收bundle的時間（UTC）
    "bundleHash": "0xe06a923bce1f46b2a0602b8fb2263dffde22f21277b0b71d84b79aff6a58772b", // bundle哈希
    "state": "failed", // builder已收到bundle，但bundle未上鏈
    "err": "non-reverting tx in bundle failed" // 具體未上鏈的原因
  }
}

异常- not found

{
  "bundle": {
    "bundleHash": "0xabc", // 請求時的bundle hash
    "state": "not found" // 未查詢到bundle
  }
}