Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

Cette page est traduite automatiquement par IA. La version anglaise fait foi.Voir la version anglaise →
Prérequis : un portefeuille Solana approvisionné avec au moins ~0,05 SOL. Si vous n’en avez pas encore, consultez getting-started/what-you-need.

​
Objectif

Échanger une petite quantité de SOL (par exemple, 0,1 SOL) contre de l’USDC. C’est le swap Raydium le plus simple possible et il couvre l’ensemble du flux — connexion d’un portefeuille, sélection de jetons, vérification d’un devis, signature et vérification. Ce que vous paierez :
  • 0,25 % de frais de trading (répartis entre les LPs et le protocole).
  • Quelques millièmes de dollar en frais réseau.
  • Au prix actuel du SOL ~160 $, le coût total de friction sur un trade de 0,1 SOL est bien inférieur à un dollar.
Ce que vous aurez après :
  • 0,1 SOL de moins (plus une petite poussière de nettoyage wSOL).
  • ~16 USDC (plus ou moins, selon le prix exact à l’exécution).
  • Une signature de transaction que vous pouvez chercher sur un explorateur Solana.

​
Étape par étape

​
1. Ouvrir raydium.io/swap

Allez sur raydium.io/swap dans votre navigateur. Vérifiez l’URL — il existe des clones de phishing. Le domaine correct est exactement raydium.io. Le panneau de swap contient :
  • Une section “From” (le jeton que vous dépensez).
  • Une section “To” (le jeton que vous achetez).
  • Un bouton de swap au milieu pour inverser les directions.
  • Un engrenage de paramètres en haut à droite pour le slippage et les frais de priorité.
  • Une icône de partage pour les liens de parrainage (voir user-flows/referrals-and-blinks).

​
2. Connecter votre portefeuille

Cliquez sur « Connect Wallet » en haut à droite. Une fenêtre modale s’affiche avec les portefeuilles Solana actuellement intégrés à Raydium. Choisissez le vôtre. Votre portefeuille vous demande d’approuver la connexion — c’est en lecture seule. Cela permet au site de voir votre adresse et de suggérer des transactions. Cela ne déplace pas les fonds. Confirmez. Après la connexion, le haut à droite affiche votre adresse de portefeuille (tronquée) et votre solde SOL.

​
3. Choisir les jetons

  • From : SOL (devrait être par défaut).
  • To : cliquez sur la liste déroulante et tapez « USDC ». Le jeton avec le badge vérifié est l’USDC canonique (mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v). Évitez les contrefaçons avec des noms similaires mais des mints différents.

​
4. Entrer le montant

Tapez 0.1 dans le champ « From ». Le champ « To » se remplit automatiquement avec le montant cité (par exemple 16.2 USDC). Sous les champs, Raydium affiche :
  • Price : « 1 SOL ≈ 162 USDC » ou similaire.
  • Slippage tolerance : « 0,5 % » par défaut. Acceptable pour SOL/USDC.
  • Routing : affiche le(s) pool(s) par le(s)quel(s) Raydium acheminera. Pour SOL/USDC, il s’agit généralement d’un seul pool CLMM.
  • Price impact : la façon dont votre trade déplace le prix. Pour 0,1 SOL, pratiquement zéro.

​
5. Vérifier et swapper

Cliquez sur le bouton Swap. Une fenêtre modale de confirmation s’affiche montrant :
  • Le montant minimum que vous recevrez (après slippage).
  • Les frais réseau estimés.
  • La ventilation de la « route ».
Cliquez sur Confirm. Votre portefeuille affiche une invite de signature.

​
6. Approuver dans votre portefeuille

Le portefeuille affiche :
  • Les détails de la transaction : deux ou trois instructions (peut-être envelopper SOL, swapper, dévrouillez).
  • L’estimation des frais réseau.
  • Le résultat de la simulation (changements de solde des jetons).
Lisez la simulation. Vous devriez voir le SOL diminuer d’environ 0,1 et l’USDC augmenter d’environ 16,2. Si la simulation indique le contraire — par exemple « SOL diminue de 1,0 » — rejetez et enquêtez. Cliquez sur Approve / Confirm. Le portefeuille signe et diffuse.

​
7. Confirmation

En quelques secondes, Raydium affiche « Transaction succeeded » avec un lien vers Solscan / Solana Explorer. Vos soldes se mettent à jour. S’il échoue, voir Dépannage ci-dessous.

​
Vérifier que cela a fonctionné

​
Dans votre portefeuille

Ouvrez la liste des jetons du portefeuille. Vous devriez maintenant voir :
  • Solde USDC : ~16,2 USDC.
  • Solde SOL : diminué d’environ 0,1 SOL plus une petite commission réseau (~0,0015 SOL).
  • Une transaction récente avec le statut « Success ».

​
Sur un explorateur Solana

Copiez la signature de transaction (depuis le toast de succès de Raydium ou le journal des transactions de votre portefeuille) et collez-la dans : Vous verrez :
  • Status : Success.
  • Signer : votre adresse de portefeuille.
  • Token balance changes : votre SOL sortant, votre USDC entrant, plus les transferts côté pool.
  • Programs invoked : un programme Raydium (CPMM, CLMM ou AMM v4 selon la route), le programme Token, le programme System.
C’est final. La transaction ne peut pas être annulée.

​
Ce qui vient de se passer, un peu plus profondément

  1. Vous avez demandé à Raydium d’échanger X SOL contre Y USDC.
  2. Le frontend (ou Trade API) a cherché des pools, choisi le meilleur et construit une transaction.
  3. La transaction avait 2–4 instructions : peut-être créer un ATA USDC (si vous n’en aviez pas encore), envelopper SOL en wSOL, appeler le programme de swap Raydium, dévrouillez tout wSOL résiduel.
  4. Votre portefeuille a signé la transaction avec votre clé privée.
  5. L’RPC l’a diffusée aux validateurs Solana.
  6. Une fois confirmée, le programme Raydium a déplacé les jetons : wSOL de vous au pool, USDC du pool à vous, et les frais accumulés aux LPs.
Pour la vue développeur de cela, voir user-flows/swap.

​
Dépannage

​
« Transaction simulation failed » ou « custom error: 0x1 »

Signifie généralement un SOL insuffisant pour les frais, ou la route a changé entre le devis et l’exécution. Fix : assurez-vous d’avoir au moins 0,02 SOL au-dessus de votre montant de swap pour les frais, et réessayez.

​
Slippage tolerance exceeded

Le prix du pool a bougé plus que votre limite de slippage entre le devis et l’exécution. Courant pendant les moments volatiles. Fix : ouvrez les paramètres (icône d’engrenage), augmentez le slippage à 1 % ou 2 %, et réessayez. N’augmentez pas beaucoup plus haut que 2 % pour les majeurs — c’est une invitation aux attaques MEV sandwich.

​
« Token account does not exist »

Le jeton de destination (USDC dans ce cas) a besoin d’un ATA dans votre portefeuille. La transaction de swap de Raydium inclut normalement l’étape de création d’ATA, mais certains anciens portefeuilles la sautent. Fix : mettez à jour votre portefeuille. Si cela persiste, créez manuellement l’ATA via le flux « Add token » de votre portefeuille, puis réessayez.

​
Cela « s’accroche » simplement en attente

Solana est congestionné. Votre transaction peut être en attente, abandonner ou réessayer. Fix : attendez 30 secondes. Si rien ne s’éternise, fermez la fenêtre modale, ouvrez les paramètres, augmentez les frais de priorité (« Turbo » ou « Max » dans l’interface Raydium), et réessayez. Voir integration-guides/priority-fee-tuning.

​
L’USDC n’est pas arrivé

Vérifiez le statut de la transaction sur l’explorateur.
  • Success : l’USDC est dans votre portefeuille. Actualisez la liste des jetons de votre portefeuille.
  • Failed : les frais ont été payés mais aucun swap n’a eu lieu. Vérifiez le message d’erreur on-chain dans le journal de l’explorateur.
  • Not found : la transaction n’a jamais atterri ; votre SOL est sûr. Réessayez.

​
Après votre premier swap

​
Erreurs courantes des débutants

  • Ne pas conserver assez de SOL pour les frais. Swapper littéralement tout votre SOL ne laisse aucune place à la commission — la transaction échoue. Gardez toujours ~0,02 SOL.
  • Slippage fixé trop bas sur les paires volatiles. La valeur par défaut de 0,5 % est correcte pour SOL/USDC mais serrée pour les memecoins. Augmentez à 2–5 % pour ceux-ci.
  • Slippage fixé trop haut. Un slippage de 10 %+ sur une paire majeure invite aux attaques sandwich. Gardez-le au minimum qui permet toujours au trade de s’exécuter.
  • Swapper le mauvais jeton. « USDC » vs « USDC.wh » (enveloppé d’Ethereum via Wormhole) sont des mints différents. Utilisez toujours celui avec le badge vérifié sauf si vous voulez spécifiquement le wrapper.
  • Cliquer sur des jetons aléatoires « airdrop ». Si un jeton inconnu apparaît dans votre portefeuille, n’interagissez pas avec lui. Beaucoup sont des escroqueries où l’interaction déclenche une approbation malveillante.

​
Où aller ensuite