Bids

Bid Structure

The bid payload sent to the internal mev-commit API is as follows:

Key	Description
txn_hash	Array of transaction hashes as strings
bid_amt	Bid amount in wei
block_number	Block number targeted for bid inclusion

Example bid

{

    "txHashes": ["0549fc7c57fffbdbfb2cf9d5e0de165fc68dadb5c27c42fdad0bdf506f4eacae", "0549fc7c57fffbdbfb2cf9d5e0de165fc68dadb5c27c42fdad0bdf506f4eacaf","0549fc7c57fffbdbfb2cf9d5e0de165fc68dadb5c27c42fdad0bdf506f4effff"],
    "amount": "100040",
    "blockNumber": 133459,
    "decayStartTimestamp": 1713804918616,
    "decayEndTimestamp": 1713899918616

}

The final bid structure includes a hash and signature that is auto-constructed by your mev-commit bidder node and looks as follows.

{
   "txn_hash":"0549fc7c57fffbdbfb2cf9d5e0de165fc68dadb5c27c42fdad0bdf506f4eacae,0549fc7c57fffbdbfb2cf9d5e0de165fc68dadb5c27c42fdad0bdf506f4eacaf,0549fc7c57fffbdbfb2cf9d5e0de165fc68dadb5c27c42fdad0bdf506f4effff",
   "bid_amt":277610,
   "block_number":2703,
   "decayStartTimestamp": 1713804918616,
   "decayEndTimestamp": 1713899918616,
   "bid_digest":"uU2p20f5KmehWqpuY1u+CbhcS8jNwdQAJQe2dh0Vnrk=",
   "bid_signature":"nY6jYsGPxj6LVlSVQJbZcxvmRrw8Ym5rqOL1x0W/xPlJGBaF/ZzzjkxiioY/MDiRGvlflSWeoT0fh3aIJiJxAhw="
}

Details on Bid Structure

Property	Description
txn_hash	Array of transaction hashes represented as strings
bid_amt	Amount to bid in wei
block_number	Target block to have bid included
decayStartTimestamp	Start timestamp for bid decay
decayEndTimestamp	End timestamp for bid decay
bid_digest	Hash of the bid
bid_signature	Signed bid_digest = sign(bid_digest, signing_key)

Details on Decay Parameters

The decayStartTimestamp and decayEndTimestamp allow the bidder to set the range over which their bid decays.

You can find more details about the purpose and internal workings of the decay mechanism under the Bid Decay Page.