Relay JSON-RPC API

pfl_addSearcherBundle

Submits a searcher bundle to Fastlane auction handler.

Parameters

1. OPPORTUNITY_TX_DATA - the opportunity transaction data.

2. SEARCHER_TX_DATA - the searcher transaction data.

Returns

• On success:

{'jsonrpc': '2.0', 'id': 1, 'result': '2022-12-08T07:55:16.779024625Z'}

• On error:

{
   "jsonrpc": "2.0",
   "id": 1,
   "error": {
      "code": -32000,
      "message": "err - R0016 - auction already completed"
   }
}

pfl_addSearcherFastBid

Submits a fast bid to Fastlane auction handler.

Parameters

1. SEARCHER_TX_DATA - the searcher transaction data.

Returns

• On success:

{'jsonrpc': '2.0', 'id': 1, 'result': '2022-12-08T07:55:16.779024625Z'}

• On error:

{
   "jsonrpc": "2.0",
   "id": 1,
   "error": {
      "code": -32000,
      "message": "err - FBA0001 - auction ended, please try again at the next block"
   }
}

Error code	Desc
R0001	PFL node has known opp tx for too long
R0002	auction cleanup result unexpected
R0003	auction expired but not yet deleted
R0004	auction already deleted but not expired
R0005	auction already deleted and expired
R0006	bundle channel is full
R0007	bid channel full
R0008	searcher has already bid in this auction
R0009	could not find searcher EOA
R0010	auction is not live
R0011	bid channel err (not on auction init)
R0012	targetted validator is not in this sprint
R0013	targetted validator not participating in PFL
R0014	bundle has too few transactions
R0015	bundle has too many transactions
R0016	auction already completed
R0017	time since oppTx arrival exceeds grace period
R0018	bid had no tx as value in BidToTxMap
R0019	bid couldnt be converted from str in bidMap
R0020	node not connected to any potential validators
R0021	opp tx hash does not match hash in searcher tx
R0022	searcher sending bid to wrong Auction Handler
R1001	Sentry cannot process an auction for the current validator
R1000	PDN forwarding
R1002	target bundle RPC not found
R2001	invalid block number
R4000	validator already knows opp tx
R4001	oppTx GasTipCap != searcher GasTipCap
R4002	oppTx GasFeeCap != payment/searcher
R4003	oppTx GasPrice != payment/searcher
R4004	oppTx Type != searcherTx type
R5000	bid method not found in contract ABI
R5001	txInput has insufficient length to decode
R5002	payment transaction is not being sent to correct PFL contract address
R5003	transaction did not call submitFlashBid
R5004	struct field not recognized
FBA0001	auction ended, please try again at the next block
FBA0002	fast price can't be higher than effective gas price
FBA0003	effective gas price must be higher than current highest
FBA0004	total price must be higher than current highest
FBA0005	transaction failed validation

Example

// Request

curl -X POST --data '{"jsonrpc":"2.0","method":"pfl_AddSearcherBundle","params":[[OPPORTUNITY_TX_DATA, SEARCHER_TX_DATA]],"id":1}'

// Result

{'jsonrpc': '2.0', 'id': 1, 'result': '2022-12-08T07:55:16.779024625Z'}

See next

To understand what these _DATA parameters are, see Transaction Encoding