> For the complete documentation index, see [llms.txt](https://docs.blinklabs.xyz/blink/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blinklabs.xyz/blink/bnb-smart-chain-bsc/api-reference.md).

# API Reference

Blink's integration is designed to be as simple as possible, it only requires switching over to Blink's RPC node endpoint.

This endpoint mirrors the APIs found by other BSC node providers, with Blink-specific methods layered on top.

You can find your custom endpoint on your custom [dashboard](https://portal.blinklabs.xyz/dashboard?chain=bsc).

## Integration Steps

* Acquire custom RPC endpoint on our [dashboard](https://portal.blinklabs.xyz/dashboard?chain=bsc)
* Switch out existing RPC endpoint for the custom Blink endpoint: `https://bsc.blinklabs.xyz/v1/{$API_KEY}`
* Track recoveries via Blink's dashboard

***

## eth\_sendRawTransaction

Blink will intercept eth\_sendRawTransaction requests, it will;

* Bypass the public mempool
* Send the transaction directly to BSC builders
* Share the transaction with our searcher network and run the auction for it

### Example request

```
{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "eth_sendRawTransaction",
    "params": [
        "0xf869018203e882520894f17f52151ebef6c7334fad080c5704d77216b732881bc16d674ec80000801ba02da1c48b670996dcb1f447ef9ef00b33033c48a4fe938f420bec3e56bfd24071a062e0aa78a81bf0290afbc3a9d8e9a068e6d74caa66c5e0fa8a46deaae96b0833",
     ],
}
```

### Example response

```
{
    "id": 1,
    "jsonrpc": "2.0",
    "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}
```

***

## eth\_sendPrivateTransaction

Accepted as an alias of `eth_sendRawTransaction`, for compatibility with existing private transaction integrations. It takes the same signed raw transaction parameter and behaves identically — on BSC all Blink transactions bypass the public mempool regardless of which of the two methods you use.

### Example request

```
{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "eth_sendPrivateTransaction",
    "params": [
        "0xf869018203e882520894f17f52151ebef6c7334fad080c5704d77216b732881bc16d674ec80000801ba02da1c48b670996dcb1f447ef9ef00b33033c48a4fe938f420bec3e56bfd24071a062e0aa78a81bf0290afbc3a9d8e9a068e6d74caa66c5e0fa8a46deaae96b0833",
     ],
}
```

***

## eth\_sendRawTransactionSync

Blink supports `eth_sendRawTransactionSync` ([EIP-7966](https://eips.ethereum.org/EIPS/eip-7966)). It submits the transaction exactly like `eth_sendRawTransaction`, with the same mempool bypass, builder routing and auction. It then waits for the transaction to be included and returns the receipt in the same call, so there is no need to poll `eth_getTransactionReceipt`.

{% hint style="info" %}
The timeout is always 1.5 seconds. The optional second parameter (a timeout in milliseconds) is accepted but ignored.
{% endhint %}

### Example request

```
{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "eth_sendRawTransactionSync",
    "params": [
        "0xf869018203e882520894f17f52151ebef6c7334fad080c5704d77216b732881bc16d674ec80000801ba02da1c48b670996dcb1f447ef9ef00b33033c48a4fe938f420bec3e56bfd24071a062e0aa78a81bf0290afbc3a9d8e9a068e6d74caa66c5e0fa8a46deaae96b0833"
    ]
}
```

### Example response

The result is the transaction receipt, in the same format as `eth_getTransactionReceipt`.

```
{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "blockHash": "0xde038bbb07a0f939ce1d5f6898f97aa1ce01e8c256a871cab8c8ecd3aa617a2c",
        "blockNumber": "0x3f1a2b4",
        "contractAddress": null,
        "cumulativeGasUsed": "0x530e",
        "effectiveGasPrice": "0x5f5e100",
        "from": "0x8ba1f109551bd432803012645ac136ddd64dba72",
        "gasUsed": "0x5208",
        "logs": [],
        "logsBloom": "0x000…000",
        "status": "0x1",
        "to": "0xf17f52151ebef6c7334fad080c5704d77216b732",
        "transactionHash": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331",
        "transactionIndex": "0x1",
        "type": "0x0"
    }
}
```

### Timeout response

If there is no receipt within 1.5 seconds, the call returns error code `4` with the transaction hash in `data`. The transaction has been sent and may still be included: poll `eth_getTransactionReceipt` with that hash.

```
{
    "id": 1,
    "jsonrpc": "2.0",
    "error": {
        "code": 4,
        "message": "The transaction was added to the transaction pool but wasn't processed within the designated timeout interval.",
        "data": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
    }
}
```

Resending a transaction that Blink already submitted is not an error: you get its receipt, or the timeout response above while it is pending. Other errors, such as `insufficient funds` or `nonce too low` caused by a different transaction, are returned as for `eth_sendRawTransaction`.

***

## eth\_sendBundle

**Note this is for originators who send transactions via bundles rather than searchers who are bundling with other transactions.** Searchers bid on transactions through a separate endpoint and a different request shape — see [Searchers](https://docs.blinklabs.xyz/blink/bnb-smart-chain-bsc/searchers.md).

Blink will intercept eth\_sendBundle requests, it will;

* Bypass the public mempool
* Send the bundle directly to the BSC builders that accept bundles
* Share each transaction in the bundle with our searcher network and run the auction for it

### Example request

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_sendBundle",
  "params": [
    {
      txs,               // Array[String], A list of signed transactions to execute in an atomic bundle
    }
  ]
}
```

### Example response

The result is the bundle hash, derived from the transactions in the bundle.

```
{
    "id": 1,
    "jsonrpc": "2.0",
    "result": "0x164d7d41f24b7f333af3b4a70b690cf93f636227165ea2b699fbb7eed09c46c7"
}
```

{% hint style="info" %}
A bundle hash response acknowledges receipt only. Bundles are forwarded to builders asynchronously, so it does not confirm that the bundle reached a builder or landed on-chain.
{% endhint %}

{% hint style="warning" %}
Only `txs` is forwarded to BSC builders. `blockNumber`, `revertingTxHashes`, `droppingTxHashes` and the other Ethereum `eth_sendBundle` fields are accepted for compatibility but have no effect on BSC — in particular, a bundle cannot be pinned to a target block, and no transaction can be opted into reverting.
{% endhint %}

***

## pm\_isSponsorable

Used to check whether a transaction is eligible for gas sponsorship before signing it. See the [Gas Sponsorship API Reference](https://docs.blinklabs.xyz/blink/bnb-smart-chain-bsc/gas-sponsorship/api-reference.md).

***

For full documentation of the remaining standard endpoints, we suggest referring to the BNB Chain documentation: <https://docs.bnbchain.org/bnb-smart-chain/developers/json_rpc/json-rpc-endpoint/>
