Searchers

Searching on Base works a bit differently to Ethereum as there is no builder market.

WebSocket Subscriptions

Please reach out via [email protected] to get set up with an API key.

WebSocket Connection

Connect to Blink's WebSocket endpoint:

wss://baseauction.blinklabs.xyz/ws/v1/{$API_KEY}

Transaction Subscription

The V1 WebSocket requires an explicit subscription to begin receiving transaction data. Send the following message after connecting:

{
    "method": "eth_subscribe",
    "params": ["blink_partialPendingTransactions"]
}

Submitting Bids

Submit bids to:

https://baseauction.blinklabs.xyz/v1/{$API_KEY}

Bundles are submitted using the eth_sendBundle RPC call:

{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "eth_sendBundle",
    "params": [
        {
            "txs": [ 
                "txHash",     // Target transaction hash
                "rawTxHex"    // Your transaction in raw hex format
            ],
            "bidWei": "2198498724181749"  // Your bid amount in wei (string decimal)
        }
    ]
}

Auction Mechanics

Bundle Submission

• Transactions are ordered by the sequencer based on priority fee / gas

• Searchers should set prio fee to be equal to the target transaction prio fee. Transactions with a higher prio fee will be rejected.

• Searchers should send at least 75% of profit to our refund address 0xAa29178FC9527fA1410305E52cfee950a2efcB9f . Send this as an ETH transfer within your backrun transaction. The value should match your bidWei parameter. See here for an example.

• This "bid" can be sent in the bundle request as a "bidWei" parameter. If you don't, the bid will be assumed to be 0 and will only be sent if there are no other bids.

• Searchers must not send directly to the sequencer (this is monitored)

• Any sandwiching will result in immediate ban (strictly monitored)

Timing and Inclusion

• With the addition of flashblocks, timing has become extremely important on Base. Each auction is at most 200ms and late backruns will likely revert on-chain.

• At the end of the flashblock, if nobody has won the backrun slot yet, the auction becomes FIFO.

• We highly recommend colocating in AWS us-east-1 for optimal latency.

Blink Monitoring

Blink monitors a number of metrics and will take action on any breaches of rules:

• Sandwiches of our transactions

• Searchers sending directly to sequencer

• Searchers sending to both us and directly

• Profit passed back as percentage (should be > 75%)

• Difference between bid and amount passed back

• Revert rates (especially after big competitive bids)

Breaches (depending on severity) could include:

• Reduced Flow

• Delay on websocket

• Complete Ban