Searcher

介绍

Searcher可以在BlockRazor RPC提供的Private Mempool上訂閱bundle執行backrun策略，再將backrun bundle發送至BlockRazor RPC參與競拍獲得收益。

另外，Searcher也可以跳過bundle訂閱，直接將bundle發送至BlockRazor RPC，憑借高性能網絡的網絡加速服務，BlockRazor RPC可以極低延遲將bundle轉發至主流builders，无需重复对接builder接口。

在BSC中，eth_sendMevBundle允許在bundle中包含0 gwei的交易，但bundle中交易（public mempool中的交易除外）的平均gasPrice仍需不小於0.05 gwei。

競拍機制

bundle流轉

競拍時機

Searcher可持續提交bundle競拍（不允許重復提交），Scutum會根據出塊時間選擇最佳時機將競拍勝出的bundle提交給builder。如果針對同一個被backrun對象構建的bundle，已經被納入區塊或超過有效期，則競拍停止，相應bundle也會在數據推流中停止披露。

競拍規則

BlockRazor RPC按競拍金額進行英式競拍，競拍金額的接收和分配通過智能合約實現。

競拍方法

構建backrun交易時，可以通過接口調用競拍代理合約的proxyBid方法，

interface IProxyBid { 
    function proxyBid(address refundAddress, uint256 refundCfg) external payable; 
}

競拍代理合約地址（proxyBidContract）、refundAddress和refundCfg可以在Subscribe Bundle的數據流中獲取，msg.value（即競拍金額）必須大於0。

參數正確性會由BlockRazor RPC嚴格校驗。請不要向refundAddress或競拍代理合約地址直接轉賬或執行其他可能引起上述賬戶餘額變化的操作。

RPC端點

請將訂閱bundle的域名與發送bundle的域名保持一致。如訂閱https://jp-bscscutum.blockrazor.xyz/stream，則將bundle發送至https://jp-bscscutum.blockrazor.xyz

地區	端點
東京	https://jp-bscscutum.blockrazor.xyz
紐約	https://us-bscscutum.blockrazor.xyz
法蘭克福	https://ger-bscscutum.blockrazor.xyz
都柏林	https://ire-bscscutum.blockrazor.xyz

請求參數

Bundle

參數	必選	格式	示例	備注
hash	否	hash	"0xa06b……f7e8ec"	從數據推流中收到的bundle hash，即被backrun的對象
txs	是	[]bytes	[ "0xf84a……e54284" ]	raw tx。如hash為空，則最高允許設置50筆raw txs，如hash不為空，則僅允許設置1筆raw tx
revertingTxHashes	否	[]hash	["0x1f23……0abb1e"]	允許revert的交易哈希，是txs的子集
maxBlockNumber	否	uint64	39177941	該bundle有效的最大區塊號，默認為當前區塊號+100
hint	否	map[string]bool		詳見hint
refundAddress	否	address	"0x9abae1b279a4be25aeae49a33e807cdd3ccffa0c"	如hint中存在值為true的交易字段，則需要設置本字段，地址需为EOA。

hint

hint針對txs中的交易設置披露信息，如果設為true則視為披露該交易字段，false視為不披露該交易字段，如不設置，則默認為false。

參數	必填	格式	示例	備注
hash	否	bool	true	交易哈希
from	否	bool	false	交易的發起方地址
to	否	bool	true	交易的接收方地址
value	否	bool	false	交易value
nonce	否	bool	false	交易nonce
calldata	否	bool	true	交易calldata
functionSelector	否	bool	true	合約函數簽名哈希的前4個字節
logs	否	bool	true	交易在執行過程中拋出的事件日誌(該字段聯動設置是否披露狀態對象的數據變化)

請求示例

Raw Bundle

由於沒有backrun對象hash字段無需設置。bundle中的txs來自於公開內存池或自行構建，至多可設置50筆裸交易。Searcher可以授權披露raw bundle中的txs允許其他Searcher套利，同時自己收穫返利，也可以不披露，Scutum將轉發raw bundle給主流builders。

curl -X POST -H "Content-Type: application/json" --data'{
	"id": 1,
	"jsonrpc": "2.0",
	"method": "eth_sendMevBundle",
	"params": [{
		"txs": ["0xf84a8080808080808193a0437a5584216e68d1ff5bd7803161865e058f9bf4637fd1391213eac03ae64444a00df12bffe475d5dd8cc1544b72ee280471f1dcb5173827ba41eb25cfc3e54284"],
		"revertingTxHashes": [],
		"maxBlockNumber": 39177941,
		"hint": {
			"hash": true,
			"from": false,
			"to": false,
			"value": false,
			"nonce": false,
			"calldata": false,
			"functionSelector": false,		
			"logs": true
		},
		"refundAddress": "0x9abae1b279a4be25aeae49a33e807cdd3ccffa0c"
	}]
}'<ETH_NODE_URL>

First Backrun Bundle

Searcher對raw bundle執行backrun策略，構成first backrun bundle。hash字段即數據流中接收到的raw bundle hash，txs即backrun tx，最多允許設置1筆。Searcher可選擇將first backrun bundle繼續披露給其他Seacher以執行嵌套的backrun策略。first backrun bundle在數據推流中的整體結構一般為[raw bundle txs…, backrun tx]

curl -X POST -H "Content-Type: application/json" --data '{
	"id": 1,
	"jsonrpc": "2.0",
	"method": "eth_sendMevBundle",
	"params": [{
		"hash": "0x0000000000000000000000000000000000000000000000000000000000000000", //hash of Raw Bundle
		"txs": ["0xf84a8080808080808193a0437a5584216e68d1ff5bd7803161865e058f9bf4637fd1391213eac03ae64444a00df12bffe475d5dd8cc1544b72ee280471f1dcb5173827ba41eb25cfc3e54284"],
		"revertingTxHashes": [],
		"maxBlockNumber": 39177941,
		"hint": {
			"hash": true,
			"from": false,
			"to": false,
			"value": false,
			"nonce": false,
			"calldata": false,
			"functionSelector": false,		
			"logs": true
		},
		"refundAddress": "0x9abae1b279a4be25aeae49a33e807cdd3ccffa0c"
	}]
}'<ETH_NODE_URL>

Second Backrun Bundle

Searcher可以對其他Searcher提交的first backrun bundle再次執行backrun策略，形成被二次backrun的嵌套bundle。hash即first backrun bundle的hash，txs即二次套利的backrun tx。second backrun bundle的整體結構一般為[raw bundle txs…, first backrun tx, second backrun tx]。

second backrun bundle不會再披露給其他Searcher，參數hint、refundRecipient和refundPercent會失效。

curl -X POST -H "Content-Type: application/json" --data '{
	"id": 1,
	"jsonrpc": "2.0",
	"method": "eth_sendMevBundle",
	"params": [{
		"hash": "0x0000000000000000000000000000000000000000000000000000000000000000", // hash of First Backrun Bundle
		"txs": ["0xf84a8080808080808193a0437a5584216e68d1ff5bd7803161865e058f9bf4637fd1391213eac03ae64444a00df12bffe475d5dd8cc1544b72ee280471f1dcb5173827ba41eb25cfc3e54284"],
		"revertingTxHashes": [],
		"maxBlockNumber": 39177941
	}]
}'<ETH_NODE_URL>

返回示例

正常

{"jsonrpc":"2.0","id":1,"result": "0x11111111..."}

異常

{"jsonrpc":"2.0","id":1,"jsonerror":{"code":-38000,"message":"nonce too low: address 0x9Abae1b279A4Be25AEaE49a33e807cDd3cCFFa0C, tx: 0 state: 45"}}

常见问题

发送Bundle给BlockRazor RPC和Block Builder有什么区别？

• BlockRazor RPC支持Ethereum和BSC, Block Builder服务目前仅支持BSC

• 在BSC中，BlockRazor RPC会将bundle转发至主流Builder， Block Builder服务仅将bundle发送至BlockRazor Builder