BNB Kolibrio OFA Searcher Connection

Summary: The interface is fully compatible with MEV Blocker. Connect to the WebSocket, include the X-Bev-Signature header, subscribe to partial pending transactions, and receive notifications via JSON-RPC. Construct your backrun bundle from the incoming signals and submit it using eth_sendBundle.

Endpoint

wss://bev-relay.kolibr.io/bsc https://bev-relay.kolibr.io/bsc

Required HTTP header when establishing the WebSocket session:

X-Bev-Signature: <signature>

The X-Bev-Signature header is used for authentication/authorization. The signature format and keys are provided by the Kolibrio team.

---

Subscription

After a successful connection, send the following JSON‑RPC request to subscribe:

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

Expected response:

{"jsonrpc": "2.0", "id": 1, "result": "0xd58bbbc0f5190962eff01b6f0ec17724"}

After this, you’ll start receiving eth_subscription notifications when new relevant transactions appear.

---

Incoming Signal Format

Example notification:

{
  "jsonrpc": "2.0",
  "method": "eth_subscription",
  "params": {
    "subscription": "0x6e...",
    "result": {
      "hash": "0xb3406...",
      "chainId": "0x2105",
      "type": "0x2",
      "from": "0x192...",
      "to": "0x4...
      "value": "0x5af3107a4000",
      "data": "0xffff",
      "nonce": "0x0",
      "gas": "0x5208",
      "maxPriorityFeePerGas": "0xf4240",
      "maxFeePerGas": "0x26643aa",
      "accessList": []
    },
    "revshareAddress": "0x90000...."
  }
}

Note: The bacrkun bid should be sent to in WBNB or BNB to revshareAddress Note: All numeric fields are hex‑encoded.

---

Sending a Bundle

Once you’ve built your signed backrun transaction, send it as a bundle via the same WebSocket or simple HTTP POST request:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_sendBundle",
  "params": [
    {
      "txs": [
        "0x02abcd...", // target transaction hash (32 bytes)
        "0x02abcd..." // your signed bacrkun raw transaction
        ...
      ]
    }
  ]
}

---

Best Practices & Constraints

• Send your bid/payment to the provided revshareAddress

• Treat the target transaction hash as a 32‑byte hex string (with 0x prefix).

• Both transaction hashes and raw signed transactions are accepted in txs.

• The order of txs matters: target transaction first, followed by your backrun txs.

---

Example Flow

1. Open WS connection → wss://bev-relay.kolibr.io/bsc with X-Bev-Signature.

2. Send eth_subscribe to mevblocker_partialPendingTransactions.

3. Receive eth_subscription messages with result with revshareAddress

4. Process and build your backrun transaction with WBNB or BNB transfer to revshareAddress.

5. Send eth_sendBundle containing the target hash and your signed transaction. using same ws endpoint (wss://bev-relay.kolibr.io/bsc) or the https one (https://bev-relay.kolibr.io/bsc)

---

Security Notes

• Keep your signing keys and X-Bev-Signature secrets secure.