For the complete documentation index, see llms.txt. This page is also available as Markdown.

Send in Plain Text

介紹BlockRazor Solana Fast模式的Send Transaction v2接口以及集成方法

介紹

Send in Plain Text 用於在Solana上發送已簽名的交易,支持HTTP協議。與 Send Transaction 方式相比,它提供了一種更精簡、更迅速的交易提交途徑。

  • 繞過 CORS 預檢: 它消除了通常由 OPTIONS 預檢請求所引起的延遲(大約 50-100 毫秒)。

  • 純文本而非 JSON: 採用簡單的純文本傳輸,避免了與解析 JSON 相關的計算負擔。此外,由此產生的較小數據包尺寸有助於縮短網路傳輸時間並降低成本。

  • Base64 編碼優勢: 與 Base58 相比,Base64 的編碼和解碼操作速度顯著更快,同時其更緊湊的序列化方式能縮小整體的數據體大小。

Send in Plain Text 的以上特性更適合擁有全球用戶的前端交易應用項目。

端點

  • POST /v2/sendTransaction

流控說明

Solana發送交易的服務不和訂閱計劃綁定,可前往 Authentication 獲取API KEY,默认限流为3 TPS。如需提升限流標準,請聯繫我們,我們會在第一時間處理

請求示例

curl -X POST 'http://frankfurt.solana.blockrazor.xyz:443/v2/sendTransaction?auth=<auth_token>' \
-H "Content-Type: text/plain" \
-d "<base64_endcoded_tx>"

注意:

  • 認證 (auth) 和 請求 (request) 參數必須以 URI 參數的形式填入URL,比如http://frankfurt.solana.blockrazor.xyz:443/v2/sendTransaction?auth=<auth_token>&mode=fast&revertProtection=true

  • 請求中唯一允許的header是 Content-Type: text/plain

  • 交易必須使用 Base64 進行編碼

請求參數

字段
必填
示例
備注

transaction

"4hXTCk……tAnaAT"

已簽名的交易,採用 Base64 編碼

mode

"fast" "sandwichMitigation"

BlockRazor支持fast和sandwichMitigation兩種模式,默認為fast模式。 在fast模式中,交易會基於全球分布式高性能網絡和高質量SWQoS質押鏈路被飽和式發送,以最低延遲到達Leader節點。 在sandwichMitigation模式中,交易會被發往BlockRazor高度信任的SWQoS質押鏈路,同時交易會跳過黑名單Leader(經BlockRazor三明治監測機制動態精確識別)的slot。在此模式下,請不要用durable nonce發送交易,這會使三明治保護失效。

safeWindow

3

sandwichMitigation模式中用於確定交易發送時機的參數,數字代表從當前slot起連續白名單驗證者的slot數量,比如設定3,則交易會僅在當前起連續3個slot都屬於白名單驗證者時發送。 safeWindow的參數範圍是3-13,數字越大防治三明治攻擊效果越好,但可能會對上鏈速度有一定影響。如不設定,則默認為3。

revertProtection

false

默認為false。如設置為true,交易不會在鏈上執行失敗,但上鏈速度会受到影响且存在无法上链的可能,請根據實際需求謹慎選擇開啓。

返回參數

狀態碼
消息
釋義

200

OK

請求正常

400

BadRequest

請求參數不合法

403

Forbidden

請求被拒絕,auth為空、無效或過期

500

InternalServerError

內部服務錯誤

最後更新於

這有幫助嗎?