> 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/solana/javelin.md).

# Javelin

Fast, reliable Solana transaction landing

Javelin is Blink's Solana transaction landing service. Transactions are submitted in the standard Solana format, with a tip included to one of our tip accounts, via `sendTransaction`. Javelin then routes each transaction to the current leader over the optimal path.

## Quick Start

1. Add a SOL transfer of at least 5,000 lamports to one of our [tip accounts](#tip-accounts). A tip of 0.001 SOL or more also sends a durable nonce transaction as a bundle to block engines. See [How much to tip](#how-much-to-tip).
2. Sign the transaction.
3. Send it to all of our [endpoints](#endpoints) at once with `sendTransaction`, the same way you would send it to any Solana RPC node. Include your [API key](https://docs.blinklabs.xyz/blink/solana/javelin/api-reference.md#api-keys) with every request.

See the [API Reference](https://docs.blinklabs.xyz/blink/solana/javelin/api-reference.md) for the full request format.

## How It Works

1. **You send the transaction** to every Javelin node at once.
2. **Javelin checks it**: it must be valid, signed, and tip one of our tip accounts.
3. **Javelin keeps sending it** to each new leader until it lands or its blockhash expires (150 slots). You do not need to resend it yourself.

## Endpoints

{% hint style="success" %}
**We recommend sending each transaction to all endpoints at once for the best performance.**
{% endhint %}

If you cannot send to all of them, send to at least the two closest to your servers.

| Location            | Endpoint                             |
| ------------------- | ------------------------------------ |
| Frankfurt 1         | `https://fra1.javelin.blinklabs.xyz` |
| Frankfurt 2         | `https://fra2.javelin.blinklabs.xyz` |
| Amsterdam           | `https://ams.javelin.blinklabs.xyz`  |
| London              | `https://lon.javelin.blinklabs.xyz`  |
| Šiauliai, Lithuania | `https://lit.javelin.blinklabs.xyz`  |
| Newark              | `https://ewr.javelin.blinklabs.xyz`  |
| Los Angeles         | `https://lax.javelin.blinklabs.xyz`  |
| Tokyo 1             | `https://tyo1.javelin.blinklabs.xyz` |
| Tokyo 2             | `https://tyo2.javelin.blinklabs.xyz` |

{% hint style="info" %}
Keep your HTTPS connection open between sends. A new TLS connection costs more time than the send itself. Idle connections close after 30 seconds, so send a `GET` to the same URL every 15–20 seconds to keep it alive. It returns `ok`.
{% endhint %}

## Tip Accounts

Send your tip to one of these accounts. Pick one at random for each transaction, so your transactions do not all lock the same account.

```
236b9jKmo1pV2HKmPyVoXK1K5CFxhzpcRUJdmgQ45goC
7714mgdQkgyRVxi2z7TadBEtm2SBbnX8A4fpXbtKZ8Ns
GwyHPetTNp7ELnBGyoGbiEMExRQLgV1BDUU4kkPvRxY6
4aJgfMJog2iva1uSF786y5A8JK6KUtteKM6Ugs8Rbd3G
5a2QTXTufmwjPwQaoBN4jEjxseEicp1m3bHgNWymMDjj
6Nz3Fmdg61Et5LKWkGmrkkWAzFLW8pf51wMk7iR4cRN1
Fco4T5EqAihJQ14AwUe8KpE7VfNwZPFiox6YvAGT7SZF
5VgeeessVCBQSbASGA6hKMK3cnzjg1gHETpR38K9y17q
ARJGcsKmTDBRbCJzweY2QpgzmYysT6QpBWTLXaZDqreU
4yyEdR67SFggnBPmbfSd6oXDFZPKoZ2t3JmbBp8VZHLS
```

### How much to tip

| Tip                                    | Routes                                                                         |
| -------------------------------------- | ------------------------------------------------------------------------------ |
| Under 5,000 lamports                   | Rejected                                                                       |
| 5,000 lamports or more                 | Direct to the leader, and through our global network                           |
| 0.001 SOL (1,000,000 lamports) or more | All of the above, plus bundles to block engines for durable nonce transactions |

A higher tip helps your transaction land sooner when the network is busy.

### Tip rules

* The tip must be a plain SOL transfer (System Program `transfer`) in the same transaction, as a top-level instruction.
* The tip account must be listed in the transaction itself, **not loaded from an address lookup table**. A tip through a lookup table is not counted.
* You can split the tip over several transfers. Javelin adds them up.
* The tip is part of your transaction. If the transaction does not land, you pay nothing.

## MEV Protection

Turn on MEV protection to keep your transaction away from validators that sandwich their users. Add the header `X-Mev-Protect: true` or the query parameter `?mev-protect=true` to your request.

We keep a list of validators we have seen sandwiching users. With MEV protection on, Javelin does not send your transaction to them, and sends it to the next leaders off the list instead.

{% hint style="info" %}
Your transaction may land a little later, because Javelin waits for a leader that is not on the list. MEV protection lowers the risk of a sandwich but cannot remove it, so also set a tight slippage limit on swaps.
{% endhint %}

## FAQ

**What happens if my transaction does not land?**\
You pay nothing. The tip is part of your transaction, so it only moves if the transaction lands.

**Should I resend my transaction?**\
No. Javelin resends it to each new leader until it lands or its blockhash expires. Sending the same transaction again is safe: you get the same signature back, and it is not sent twice.

**Does Javelin simulate my transaction?**\
No. There is no preflight check. Simulate it yourself first if you need to.

**Are durable nonce transactions supported?**\
Yes. The nonce advance must be the first instruction, as Solana requires.

**What are the rate limits?**\
10 requests a second per IP address, with bursts up to 20. See [Rate Limits](https://docs.blinklabs.xyz/blink/solana/javelin/api-reference.md#rate-limits).

**Sending at high volume?**\
Contact us at <contact@blinklabs.xyz> for higher rate limits and dedicated support for high-volume flow.
