You’re ready to start submitting bids to the network once you’ve completed Quickstart and funded your bidder node wallet. Make sure to verify that your bidder node is connected to at least one provider node, which can be confirmed via the localhost:13523/topology endpoint.

1

Deposit For Bids

Run this command to deposit funds and start bidding:

❯_ terminal
curl -X POST http://localhost:13523/v1/bidder/deposit/1000000000000000000

This tops up your account with 1000000000000000000 wei (1 ETH) for the current window to bid with. The window is the number of L1 blocks in the round (for L1 it’s 10 blocks) for which the bidder can post bids.

If you want to deposit funds for a specific L1 block number, which will be automatically converted to the corresponding window, use the following command:

❯_ terminal
curl -X POST "http://localhost:13523/v1/bidder/deposit/1000000000000000000?block_number=<block_number>"
2

Sending Bids

Open a new terminal window. To send bids, we simply run the following command:

❯_ example
curl -X POST http://localhost:13523/v1/bidder/bid \
-d '{
    "txHashes": ["0549fc7c57fffbdbfb2cf9d5e0de165fc68dadb5c27c42fdad0bdf506f4eacae"],
    "amount": "<amount in wei>",
    "blockNumber": <integer l1blocknumber>,
    "decayStartTimestamp": <timestamp milliseconds>,
    "decayEndTimestamp": <timestamp milliseconds>
}'
Make sure your bid amount is sufficiently high for the commitment you’re requesting, and your target L1 block number is accurate. It’s up to the providers to commit to your bid, so try to ensure a commitment is feasible to your bid by its construction.

To include bundles of transactions, add them in the atomic sequence in which they exist in the bundle, as follows:

❯_ example
curl -X POST http://localhost:13523/v1/bidder/bid \
-d '{
    "txHashes": ["0549fc7c57fffbdbfb2cf9d5e0de165fc68dadb5c27c42fdad0bdf506f4eacae", "22145ba31366d29a893ae3ffbc95c36c06e8819a289ac588594c9512d0a99810", "7e1506f266bc86c81ae46018053a274a3bd96a9eff17392930707bf8fa5ff6be"],
    "amount": "<amount in wei>",
    "blockNumber": <integer l1blocknumber>,
    "decayStartTimestamp": <timestamp milliseconds>,
    "decayEndTimestamp": <timestamp milliseconds>
}'
You can change the values in the fields txHashes, amount, blockNumber, decayStartTimestamp and decayEndTimestamp as desired.
Congrats, you just sent your first L1 preconfirmation bid! You should be receiving commitments nearly instantly.

If you want to learn more about Bids and Bid Structure visit the Bid Structure page under Concepts section.

RelaysBidder Node Commands