Tous les articles
Guides

Le wSOL expliqué : wrapper et unwrapper du SOL

Le wSOL est le même SOL au format de token standard de Solana, toujours 1 pour 1. Quand il faut wrapper, comment unwrapper, et quel dépôt ce compte retient.

7 min de lecture J Tools Editorial
Illustration éditoriale du wSOL sur Solana : une pièce de SOL dans une enveloppe transparente, la même valeur des deux côtés

Qu'est-ce que le wSOL ? C'est le même SOL placé dans le format de token standard de Solana, pour que les applications puissent le manipuler comme n'importe quel token. La valeur ne bouge pas, toujours 1 pour 1, et l'aller-retour reste possible à tout moment. Voir du wSOL dans le portefeuille ne signale aucun problème.

  • 1 wSOL vaut toujours 1 SOL. Pas de cours, pas de décote, aucun risque dans l'échange lui-même.
  • On wrappe parce que le SOL natif n'est pas un token SPL et que beaucoup de contrats ne connaissent que les tokens.
  • Le compte wSOL retient un dépôt de loyer. Il revient à l'unwrap.
  • Du wSOL qui traîne après un swap, c'est normal, et cela se règle en un clic.

Qu'est-ce que le wSOL, techniquement

Sur Solana, deux choses se ressemblent au quotidien sans être identiques. Le SOL est la pièce native de la chaîne : frais, loyer et staking passent par lui. Les tokens SPL sont tout le reste, USDC, BONK, le token que vous créez, et ils suivent une norme commune.

Le souci est que le SOL natif n'est pas un token SPL. Un contrat écrit contre la norme des tokens ne sait rien faire de la pièce native. D'où un détour normalisé : du SOL est déposé dans un compte de token, et il en ressort le même montant en wSOL, désormais sous une forme que toute application comprend.

La règle n'a pas été inventée ici. Le mint natif et la façon dont le SOL y entre sont décrits dans la documentation officielle du programme SPL Token.

Carte des cas où il faut wrapper du SOL : les pools, certaines applications, et le swap qui laisse du wSOL

Quand il faut vraiment wrapper

Presque jamais. Les portefeuilles affichent du SOL, les virements se font en SOL, les frais se paient en SOL. La question ne se pose qu'à des endroits précis.

  • Un pool avec du SOL en face : la liquidité se compte en tokens, donc le côté SOL a besoin de sa forme token. Le parcours complet est dans le guide pour créer un pool de liquidité sur Raydium.
  • Une application qui réclame explicitement du wSOL : certains contrats n'acceptent que des comptes de token.
  • Après un swap : les routeurs ouvrent un compte wSOL en chemin et le referment le plus souvent. Le plus souvent.

Si aucun de ces trois cas ne se présente, il n'y a aucune raison de toucher au wSOL.

Wrapper du SOL, étape par étape

Au wrap, il se passe exactement deux choses : un compte de token pour le mint natif est créé s'il n'existe pas encore, et le montant de SOL choisi y entre. Ensuite le portefeuille affiche le même montant en wSOL.

Avec l'outil gratuit de wrapping cela tient dans un formulaire : le montant, le sens, la signature. La voie en ligne de commande fait la même chose, en plus lent.

Ne wrappez jamais la totalité de votre SOL. Les frais se paient en SOL natif, et un portefeuille à zéro natif ne peut même plus faire l'unwrap.

Le dépôt dont personne ne parle

Un compte wSOL est un compte de token comme les autres, et tout compte sur Solana retient un dépôt de loyer pour que la chaîne le stocke. Ce dépôt n'est pas des frais : il revient en entier dès que le compte est fermé.

C'est ce même dépôt qui se cache derrière l'erreur sur laquelle tout le monde bute au début. Ce qu'elle signifie et comment la régler figure dans l'explication du loyer et de l'erreur insufficient funds for rent. Le fonctionnement des comptes est décrit dans la documentation officielle du modèle de comptes Solana.

Carte de l'unwrap : fermer le compte wSOL renvoie le solde et le dépôt dans le portefeuille

Unwrapper le wSOL

Unwrapper veut dire fermer le compte wSOL. Le contenu revient en SOL natif et le dépôt de loyer suit. C'est pour cela qu'il arrive de récupérer un peu plus que ce qui avait été déposé.

Le même outil de conversion fait le trajet retour. S'il reste un compte de token vide venu d'autre chose, la fermeture de comptes de token récupère ce dépôt aussi.

SOL et wSOL, côte à côte

QuestionSOLwSOL
Paie les fraisOuiNon
Lu comme un token par les contratsNonOui
Compte dédié nécessaireNonOui, avec dépôt
ValeurIdentique, toujours 1 pour 1
ConversionÀ tout moment, dans les deux sens

Pourquoi du wSOL reste après un swap

Un routeur assemble le chemin en passant par plusieurs plateformes et ouvre pour cela un compte wSOL en route. À la fin il devrait le refermer. Si la transaction casse au mauvais moment ou si la route était inhabituelle, le compte reste et un reliquat de wSOL avec lui.

Ce n'est ni une erreur ni une perte. Un unwrap récupère les deux, le montant et le dépôt. En passant par le swap de la plateforme, le même parcours se voit avec une route via Jupiter. Quelle plateforme choisit quel chemin est détaillé dans le comparatif des plateformes Solana.

Les erreurs les plus fréquentes

  • Tout wrapper. Les frais ne sortent que du SOL natif. À zéro, le portefeuille se bloque et même l'unwrap ne passe plus. Laisser un demi SOL couvre énormément de transactions.
  • Laisser le compte vide en place. Après l'unwrap il reste parfois un compte de token sans contenu. Il ne coûte rien de plus, mais il retient le dépôt jusqu'à sa fermeture.
  • Prendre le wSOL pour un autre token. Il apparaît dans les listes au milieu de vrais tokens et ressemble à une position à part. Il n'en est pas une.
  • Wrapper sans que personne le demande. Portefeuille, virement et frais fonctionnent en SOL natif. Wrapper par précaution n'apporte rien et immobilise le dépôt.
  • Chercher le cours. Il n'y en a pas. 1 wSOL vaut 1 SOL, aujourd'hui comme dans un an, parce que la garantie est le SOL du compte lui-même.

Combien de SOL wrapper

Exactement ce que réclame le pool ou l'application, pas un centime de plus. Contrairement au staking, du SOL wrappé ne rapporte rien tant qu'il dort. Il attend simplement sous une autre forme pour le même usage.

Pour un pool le chiffre est déjà fixé : c'est le côté SOL de l'apport. Pour une opération isolée dans une application, le montant de cette opération suffit. S'il reste quelque chose après, autant le repasser en SOL natif avant de l'oublier.

Questions fréquentes sur le wSOL

Est-ce qu'on perd de la valeur en wrappant ?

Non. L'échange est 1 pour 1 et sans écart. Seuls les frais de réseau habituels s'appliquent, plus le dépôt de loyer du compte la première fois, récupéré à la fermeture.

Faut-il obligatoirement unwrapper ?

Non. Le wSOL peut rester aussi longtemps que voulu. Simplement il ne compte pas comme solde natif, il ne paie donc pas les frais, et le dépôt reste immobilisé jusqu'à la fermeture.

Pourquoi du wSOL apparaît-il sans avoir été créé ?

C'est presque toujours le reliquat d'un swap. Le routeur a eu besoin du compte pour la route et ne l'a pas refermé. Un unwrap fait le ménage.

Est-ce la même chose que le wrapped BTC ou le wrapped ETH ?

L'idée est voisine, la construction non. Dans un pont entre deux chaînes, il y a un dépositaire ou un pont derrière. Le wSOL reste entièrement sur Solana, et la garantie est le SOL présent dans le compte.

Peut-on envoyer du wSOL à quelqu'un ?

Oui, comme n'importe quel token, à condition que la personne en face dispose d'un compte de token adapté. En pratique on envoie du SOL, forme bien moins encombrante pour celui qui reçoit.

Combien coûte le wrapping ?

Les frais de réseau de la transaction, plus une fois le dépôt de loyer si aucun compte wSOL n'existe encore. Ce dépôt est prêté, pas dépensé. Ce que facture l'outil s'affiche en direct sur sa page avant validation.

En bref

Le wSOL, c'est le même SOL sous forme de token pour que les contrats puissent s'en servir, toujours 1 pour 1, réversible quand on veut. Wrapper quand un pool ou une application le demande, unwrapper dès que c'est fini, et garder toujours assez de SOL natif pour les frais.

J
Auteur
J Tools Editorial

Un article de l'équipe J Tools.

Voir tous les articles de J Tools Editorial →

Articles connexes