Receive your First Preconfirmation

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.

   Detailed Bid Structure

   Key	Description
   txHashes	Array of transaction hashes as strings
   amount	Bid amount in wei
   blockNumber	L1 block number targeted for bid inclusion
   decayStartTimestamp	Start timestamp for bid decay (in Unix milliseconds)
   decayEndTimestamp	End timestamp for bid decay (in Unix milliseconds)

   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.