Relay JSON-RPC API

pfl_addSearcherBundle

Submits a searcher bundle to Fastlane auction handler.

Parameters

1. OPPORTUNITY_TX_DATA - the opportunity transaction data.

2. SOLVER_OPERATION - the solver operation.

Returns

• On success (solver operation hash):

{'jsonrpc': '2.0', 'id': 1, 'result': '0x1111...'}

• On error:

{
   "jsonrpc": "2.0",
   "id": 1,
   "error": {
      "code": -32000,
      "message": "error code: BR008, msg: invalid solver operation"
   }
}

Error code	Desc
C0001	chain ID not supported
C0002	account is OFAC blacklisted
C0003	can't decode transaction sender
C0004	internal error
BR001	invalid opportunity transaction encoding
BR002	invalid solver operation encoding
BR003	can't decode opportunity transaction
BR004	chain id not supported
BR005	can't start backrun auction
BR006	backrun auction expired
BR007	invalid opportunity transaction
BR008	invalid solver operation
BR009	can't include solver operation in auction
BR010	solver operation to address is invalid
BR011	solver operation gas limit too high
BR012	solver operation has invalid signature
BR013	can't retrieve bonded atlETH balance
BR014	not enough bonded atlETH
BR015	can't hash solver operation
BR016	can't create user operation
BR017	solver operation value is not zero
BR018	solver operation max fee per gas is too low
BR019	solver operation deadline is too low
BR020	solver operation solver is not set
BR021	solver operation control is invalid
BR022	solver operation user operation hash is invalid
BR023	solver operation bid token is not ETH
BR024	can't process request
BR025	invalid parameters
BR026	invalid parameters (internal)
AA001	invalid transaction encoding
AA002	invalid PIP15 options encoding
AA003	can't decode transaction
AA004	invalid parameters
AA005	invalid parameters (internal)
AA006	chain id not supported
AA007	can't decode transaction sender
AA008	can't decode method
AA009	wrong function call
AA010	can't decode transaction data
AA011	can't parse user operations
AA012	can't compute user operation hash
AA013	duplicate user operation
AA014	max block number passed
AA015	max timestamp passed
AA016	can't process request
AA017	bundle already pending
AA018	wrong entrypoint
AA019	module shutting down

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