Skip to content

Commit 305bfb0

Browse files
authored
Merge pull request #13 from primevprotocol/ckartik/additional-context-for-bid-structure
Adds context to Bid Structure
2 parents 29bb208 + 77c57aa commit 305bfb0

1 file changed

Lines changed: 16 additions & 5 deletions

File tree

concepts/bids.mdx

Lines changed: 16 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,20 +4,31 @@ The bid payload sent to the internal mev-commit API is as follows:
44

55
```text
66
# Example Bid Structure:
7-
# txn_hash: arbitrary string value representing txn hash
7+
# txn_hash: array of txn hashes represented as strings
8+
# bid_amt: amount to bid in wei
9+
# block_number: target block to have bid included
10+
{
11+
"txHashes": ["0549fc7c57fffbdbfb2cf9d5e0de165fc68dadb5c27c42fdad0bdf506f4eacae", "0549fc7c57fffbdbfb2cf9d5e0de165fc68dadb5c27c42fdad0bdf506f4eacaf","0549fc7c57fffbdbfb2cf9d5e0de165fc68dadb5c27c42fdad0bdf506f4effff"],
12+
"amount": "100040",
13+
"blockNumber": 133459
14+
}
15+
```
16+
17+
The final bid structure includes a hash and signature that is auto-constructed by your mev-commit bidder node and looks as follows.
18+
19+
```bash
20+
# Example Bid Structure:
21+
# txn_hash: array of txn hashes represented as strings
822
# bid_amt: amount to bid in wei
923
# block_number: target block to have bid included
1024
# bid_digest: hash of the above bid keccak{txn_hash, bid_amt, block_number}
1125
# bid_signature: Signed bid_digest = sign(bid_digest, signing_key)
1226
{
13-
"txn_hash":"0x8d562df4f0363de75c62441d69c46aa6c9144a6e9e4697509b3b24bf8a694322",
27+
"txn_hash":"0549fc7c57fffbdbfb2cf9d5e0de165fc68dadb5c27c42fdad0bdf506f4eacae,0549fc7c57fffbdbfb2cf9d5e0de165fc68dadb5c27c42fdad0bdf506f4eacaf,0549fc7c57fffbdbfb2cf9d5e0de165fc68dadb5c27c42fdad0bdf506f4effff",
1428
"bid_amt":277610,
1529
"block_number":2703,
1630
"bid_digest":"uU2p20f5KmehWqpuY1u+CbhcS8jNwdQAJQe2dh0Vnrk=",
1731
"bid_signature":"nY6jYsGPxj6LVlSVQJbZcxvmRrw8Ym5rqOL1x0W/xPlJGBaF/ZzzjkxiioY/MDiRGvlflSWeoT0fh3aIJiJxAhw="
1832
}
1933
```
20-
21-
The final bid structure includes a hash and signature that is auto-constructed by your mev-commit bidder node.
22-
2334
Note that the prepay amount a bidder has set needs to be 10 times higher than the bid_amt in the bid. We will be introducing a prepay mechanism in the next testnet milestone.

0 commit comments

Comments
 (0)