> ## Documentation Index
> Fetch the complete documentation index at: https://primev-24-validator-dashboard-intro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 |

```json 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.

```bash
{
   "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](/concepts/bid-decay-mechanism).
