Bundles via Helius

Ceci est le chemin de bundle basique — un proxy Jito direct, facturé par envoi, idéal lorsque vous avez besoin d’une exécution atomique sans exigence de latence. Si vous êtes un trader qui a besoin de faible latence et du tampon de priorité, utilisez plutôt les bundles Sender Max.

Les bundles basiques vous offrent une exécution atomique, tout ou rien, de jusqu’à 5 transactions, transférées directement à Jito. Chaque soumission sendBundle est facturée 1 crédit de votre plan.

Méthodes prises en charge

Méthode	Description	Limite de taux
`sendBundle`	Soumettre un bundle	5 RPS par projet
`simulateBundle`	Simuler un bundle sans soumettre	Limite générale du taux RPC

Besoin de limites de taux plus élevées ? Contactez notre équipe commerciale.

sendBundle

Soumet une liste de transactions signées en tant que bundle atomique. Si le bundle est accepté, renvoie un bundle_id (SHA-256 du hachage des signatures de transaction). Cela ne garantit pas que le bundle sera intégré à la chaîne. Vérifiez la confirmation de la transaction sur la chaîne pour vérifier. Un tip est requis. Au moins une transaction doit transférer SOL à un compte de tip Helius. Si le tip est trop bas, le bundle peut ne pas être sélectionné pour inclusion.

Requête

Paramètre	Type	Description
`params[0]`	`array[string]`	Requis. Jusqu’à 5 transactions entièrement signées, encodées en base64.
`params[1].encoding`	`string`	Optionnel. `base64` (recommandé) ou `base58`. Par défaut : `base58`.

Exemple

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"
      }
    ]
  }'

Réponse

{
  "jsonrpc": "2.0",
  "result": "892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d",
  "id": 1
}

Le result est l’ID du bundle — utilisez-le avec getBundleStatuses pour suivre l’atterrissage.

getBundleStatuses

Renvoie le statut des bundles soumis. Si un bundle n’a pas atterri ou n’est pas trouvé, il renvoie null.

Requête

Paramètre	Type	Description
`params[0]`	`array[string]`	Requis. Jusqu’à 5 IDs de bundle.

Exemple

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"
      ]
    ]
  }'

Réponse

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

Renvoie null dans le tableau value pour les bundles non trouvés.

Routage régional

Par défaut, Helius dirige votre bundle vers le point de terminaison global de Jito (mainnet.block-engine.jito.wtf), qui est géo-routé automatiquement vers le Bloc Engine le plus proche. Pour cibler une région spécifique, définissez l’en-tête HTTP jito-region :

Valeur de l’en-tête	Région du Bloc Engine
`ams`	Amsterdam
`dub`	Dublin
`fra`	Francfort
`lon`	Londres
`nyc`	New York
`slc`	Salt Lake City
`sgp`	Singapour
`tyo`	Tokyo
`mainnet`	Global (géo-routé)

Exemple avec région

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"
      }
    ]
  }'

Comptes de Tip

Au moins une transaction dans votre bundle doit inclure un transfert de SOL vers l’un de ces comptes de tip. Choisissez-en un au hasard pour réduire la contention.

4ACfpUFoaSD9bfPdeu6DBt89gB6ENTeHBXCAi87NhDEE
D2L6yPZ2FmmmTKPgzaMKdhu6EWZcTpLy1Vhx8uvZe7NZ
9bnz4RShgq1hAnLnZbP8kbgBg1kEmcJBYQq3gQbmnSta
5VY91ws6B2hMmBFRsXkoAAdsPHBJwRfBht4DXox3xkwn
2nyhqdwKcJZR2vcqCyrYsaPVdAnFoJjiksCXJ7hfEYgD
2q5pghRs6arqVjRvT5gfgWfWcHWmw1ZuCzphgd5KfWGJ
wyvPkWjVZz1M8fHQnMMCDTQDbkManefNNhweYk5WkcF
3KCKozbAaF75qEU33jtzozcJ29yJuaLJTy2jFdzUY8bT
4vieeGHPYPG2MmyPRcYjdiDmmhN3ww7hsFNap8pVN3Ey
4TQLFNWK8AovT1gFvda5jfw2oJeRMKEmw7aH6MGBJ3or

Le tip minimum est de 5 000 lamports.

Exigences des bundles

Max 5 transactions par bundle
Toutes les transactions doivent être entièrement signées
Utiliser l’encodage base64 (recommandé par rapport au base58 pour les performances)
Au moins une transaction doit inclure un tip
Les transactions s’exécutent séquentiellement — tx2 peut dépendre des changements d’état de tx1

simulateBundle (Optionnel)

Vous pouvez optionnellement simuler votre bundle avant de le soumettre pour vérifier les erreurs :

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=="
        ]
      }
    ]
  }'

Protégez-vous contre les attaques sandwich

Pour diriger votre bundle loin des validateurs statistiquement liés aux attaques sandwich, ajoutez le paramètre de requête mev-protect=true à votre URL RPC — aucun changement à votre bundle :

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

Voir aussi

MEV Protect

Détournez autour des validateurs statistiquement liés aux attaques sandwich.

Ristournes de transaction

Inscrivez-vous à des appels sendTransaction uniques pour obtenir une part du MEV que vos transactions créent, payée en SOL.

Commencer

Diffusion de données et écoute d'événements

API de données et RPC

Trading

Envoyer des transactions

Wallet en tant que service

Confidentialité

Ressources

Méthodes prises en charge

sendBundle

Requête

Exemple

Réponse

getBundleStatuses

Requête

Exemple

Réponse

Routage régional

Exemple avec région

Comptes de Tip

Exigences des bundles

simulateBundle (Optionnel)

Protégez-vous contre les attaques sandwich

Voir aussi

MEV Protect

Ristournes de transaction

​Méthodes prises en charge

​sendBundle

​Requête

​Exemple

​Réponse

​getBundleStatuses

​Requête

​Exemple

​Réponse

​Routage régional

​Exemple avec région

​Comptes de Tip

​Exigences des bundles

​simulateBundle (Optionnel)

​Protégez-vous contre les attaques sandwich

​Voir aussi

MEV Protect

Ristournes de transaction

Méthodes prises en charge

sendBundle

Requête

Exemple

Réponse

getBundleStatuses

Requête

Exemple

Réponse

Routage régional

Exemple avec région

Comptes de Tip

Exigences des bundles

simulateBundle (Optionnel)

Protégez-vous contre les attaques sandwich

Voir aussi