> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bundles über Helius

> Senden Sie grundlegende Bundles über Ihren Helius RPC-Endpunkt. Atomare, Alles-oder-nichts-Ausführung von bis zu 5 Transaktionen, direkt an Jito weitergeleitet.

<Tip>
  Dies ist der **Basis**-Bundle-Weg — ein direkter Jito-Proxy, der pro Sendung abgerechnet wird, am besten
  geeignet, wenn Sie eine atomare Ausführung ohne Latenzanforderung benötigen. Wenn Sie ein
  Händler sind, der niedrige Latenz und den Prioritäts-Tip-Puffer benötigt, verwenden Sie stattdessen [Sender Max
  Bundles](/docs/de/sending-transactions/sender-max#pakete).
</Tip>

Basis-Bundles bieten Ihnen eine atomare, Alles-oder-nichts-Ausführung von bis zu 5 Transaktionen, die direkt an Jito weitergeleitet werden. Jede `sendBundle` Einreichung wird als **1 Kredit** von Ihrem Plan abgerechnet.

## Unterstützte Methoden

| Methode          | Beschreibung                              | Ratenlimit                 |
| ---------------- | ----------------------------------------- | -------------------------- |
| `sendBundle`     | Ein Bundle einreichen                     | 5 RPS pro Projekt          |
| `simulateBundle` | Simulieren eines Bundles ohne Einreichung | Allgemeines RPC-Ratenlimit |

<Tip>
  Benötigen Sie höhere Ratenlimits? [Kontaktieren Sie unser Vertriebsteam](https://www.helius.dev/contact).
</Tip>

## sendBundle

Reicht eine Liste signierter Transaktionen als atomaren Bundle ein. Wenn das Bundle akzeptiert wird, wird ein `bundle_id` (SHA-256-Hash der Transaktionssignaturen) zurückgegeben. Dies garantiert **nicht**, dass das Bundle on-chain ankommt. Überprüfen Sie die Transaktionsbestätigung auf der Kette zur Verifizierung.

Ein Tip ist erforderlich. Mindestens eine Transaktion muss SOL an ein [Helius Tip-Konto](#tip-konten) übertragen. Wenn der Tip zu niedrig ist, wird das Bundle möglicherweise nicht zur Einbeziehung ausgewählt.

### Anfrage

| Parameter            | Typ             | Beschreibung                                                                    |
| -------------------- | --------------- | ------------------------------------------------------------------------------- |
| `params[0]`          | `array[string]` | **Erforderlich.** Bis zu 5 vollständig signierte Transaktionen, base64-codiert. |
| `params[1].encoding` | `string`        | Optional. `base64` (empfohlen) oder `base58`. Standard: `base58`.               |

### Beispiel

```bash theme={"system"}
curl "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendBundle",
    "params": [
      [
        "AT2AqtlokikUWgGNnSX5xrmdvBjSaiIPxvFz6zc5Abn5Z0CPFW5GO+Y3rXceLnqLgQFnGw0yTk3NtJdFNsbrwwQBAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAwOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA==",
        "AS6fOZuGDsmyYdd+RC0fiFUgNe1BYTOYT+1hkRXHAeroC8R60h3g34EPF5Ys8sGzVBMP9MDSTVgy1/SSTqpCtA4BAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAxOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA=="
      ],
      {
        "encoding": "base64"
      }
    ]
  }'
```

### Antwort

```json theme={"system"}
{
  "jsonrpc": "2.0",
  "result": "892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d",
  "id": 1
}
```

Der `result` ist die Bundle-ID — verwenden Sie ihn mit `getBundleStatuses`, um das Eintreffen nachzuverfolgen.

## getBundleStatuses

Gibt den Status der eingereichten Bundles zurück. Wenn ein Bundle nicht angekommen ist oder nicht gefunden wird, wird `null` zurückgegeben.

### Anfrage

| Parameter   | Typ             | Beschreibung                           |
| ----------- | --------------- | -------------------------------------- |
| `params[0]` | `array[string]` | **Erforderlich.** Bis zu 5 Bundle-IDs. |

### Beispiel

```bash theme={"system"}
curl "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBundleStatuses",
    "params": [
      [
        "892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d"
      ]
    ]
  }'
```

### Antwort

```json theme={"system"}
{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 242806119
    },
    "value": [
      {
        "bundle_id": "892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d",
        "transactions": [
          "3bC2M9fiACSjkTXZDgeNAuQ4ScTsdKGwR42ytFdhUvikqTmBheUxfsR1fDVsM5ADCMMspuwGkdm1uKbU246x5aE3",
          "8t9hKYEYNbLvNqiSzP96S13XF1C2f1ro271Kdf7bkZ6EpjPLuDff1ywRy4gfaGSTubsM2FeYGDoT64ZwPm1cQUt"
        ],
        "slot": 242804011,
        "confirmation_status": "finalized",
        "err": {
          "Ok": null
        }
      }
    ]
  },
  "id": 1
}
```

Gibt `null` im `value`-Array für nicht gefundene Bundles zurück.

## Regionen-Routing

Standardmäßig leitet Helius Ihr Bundle an Jitos globalen Endpunkt (`mainnet.block-engine.jito.wtf`), der automatisch zur nächstgelegenen Block-Engine geo-routet.

Um eine bestimmte Region zu adressieren, setzen Sie den `jito-region` HTTP-Header:

| Header-Wert | Block-Engine-Region |
| ----------- | ------------------- |
| `ams`       | Amsterdam           |
| `dub`       | Dublin              |
| `fra`       | Frankfurt           |
| `lon`       | London              |
| `nyc`       | New York            |
| `slc`       | Salt Lake City      |
| `sgp`       | Singapore           |
| `tyo`       | Tokio               |
| `mainnet`   | Global (geo-routed) |

### Beispiel mit Region

```bash theme={"system"}
curl "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "jito-region: nyc" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendBundle",
    "params": [
      [
        "AT2AqtlokikUWgGNnSX5xrmdvBjSaiIPxvFz6zc5Abn5Z0CPFW5GO+Y3rXceLnqLgQFnGw0yTk3NtJdFNsbrwwQBAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAwOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA==",
        "AS6fOZuGDsmyYdd+RC0fiFUgNe1BYTOYT+1hkRXHAeroC8R60h3g34EPF5Ys8sGzVBMP9MDSTVgy1/SSTqpCtA4BAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAxOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA=="
      ],
      {
        "encoding": "base64"
      }
    ]
  }'
```

## Tip-Konten

Mindestens eine Transaktion in Ihrem Bundle muss eine SOL-Übertragung an eines dieser Tip-Konten enthalten. Wählen Sie ein zufälliges, um die Konkurrenz zu verringern.

```text theme={"system"}
4ACfpUFoaSD9bfPdeu6DBt89gB6ENTeHBXCAi87NhDEE
D2L6yPZ2FmmmTKPgzaMKdhu6EWZcTpLy1Vhx8uvZe7NZ
9bnz4RShgq1hAnLnZbP8kbgBg1kEmcJBYQq3gQbmnSta
5VY91ws6B2hMmBFRsXkoAAdsPHBJwRfBht4DXox3xkwn
2nyhqdwKcJZR2vcqCyrYsaPVdAnFoJjiksCXJ7hfEYgD
2q5pghRs6arqVjRvT5gfgWfWcHWmw1ZuCzphgd5KfWGJ
wyvPkWjVZz1M8fHQnMMCDTQDbkManefNNhweYk5WkcF
3KCKozbAaF75qEU33jtzozcJ29yJuaLJTy2jFdzUY8bT
4vieeGHPYPG2MmyPRcYjdiDmmhN3ww7hsFNap8pVN3Ey
4TQLFNWK8AovT1gFvda5jfw2oJeRMKEmw7aH6MGBJ3or
```

Der Mindesttip beträgt 5.000 Lamports.

## Bundle-Anforderungen

* **Maximal 5 Transaktionen** pro Bundle
* Alle Transaktionen müssen **vollständig signiert** sein
* Verwenden Sie **base64**-Kodierung (empfohlen gegenüber base58 für die Leistung)
* Mindestens eine Transaktion muss einen **Tip** enthalten
* Transaktionen werden **sequentiell** ausgeführt — tx2 kann von Zustandsänderungen von tx1 abhängen

## simulateBundle (Optional)

Sie können optional Ihr Bundle simulieren, bevor Sie es einreichen, um nach Fehlern zu suchen:

```bash theme={"system"}
curl "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "simulateBundle",
    "params": [
      {
        "encodedTransactions": [
          "AT2AqtlokikUWgGNnSX5xrmdvBjSaiIPxvFz6zc5Abn5Z0CPFW5GO+Y3rXceLnqLgQFnGw0yTk3NtJdFNsbrwwQBAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAwOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA==",
          "AS6fOZuGDsmyYdd+RC0fiFUgNe1BYTOYT+1hkRXHAeroC8R60h3g34EPF5Ys8sGzVBMP9MDSTVgy1/SSTqpCtA4BAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAxOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA=="
        ]
      }
    ]
  }'
```

## Schutz vor Sandwich-Angriffen

Um Ihr Bundle von Validatoren, die statistisch mit Sandwich-Angriffen verbunden sind, wegzuleiten, fügen Sie den `mev-protect=true`-Abfrageparameter zu Ihrer RPC-URL hinzu — keine Änderungen an Ihrem Bundle:

```
https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY&mev-protect=true
```

## Siehe auch

<CardGroup cols={2}>
  <Card title="MEV Protect" icon="shield-halved" href="/docs/de/sending-transactions/mev-protect">
    Umgehen Sie Validatoren, die statistisch mit Sandwich-Angriffen verbunden sind.
  </Card>

  <Card title="Transaction Rebates" icon="coins" href="/docs/de/sending-transactions/backrun-rebates">
    Melden Sie sich an, um bei einzelnen `sendTransaction`-Aufrufen einen Anteil des MEV zu verdienen, den Ihre Transaktionen erzeugen, ausgezahlt in SOL.
  </Card>
</CardGroup>