Le wSOL expliqué : wrapper et unwrapper du SOL

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 conçu pour 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.

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, mais pas toujours.

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 sans SOL 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 une dépense : 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 « insufficient funds for rent », celle sur laquelle presque tout le monde bute au début. Ce qu'elle signifie et comment la régler est expliqué dans notre guide du loyer et de cette erreur. Le fonctionnement des comptes est décrit dans la documentation officielle du modèle de comptes Solana.

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 que le SOL récupéré dépasse un peu le montant de wSOL affiché.

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

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 échoue 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. Avec le swap de la plateforme, routé via Jupiter, ce wrapping se fait automatiquement. Pour comparer les plateformes qu'un routeur traverse, voir le comparatif des plateformes Solana.

Les erreurs les plus fréquentes

• Tout wrapper. Les frais ne sortent que du SOL natif. À zéro SOL natif, 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 rien l'exige. 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 SOL de plus. Contrairement au staking, du SOL wrappé ne rapporte rien tant qu'il dort. Il attend simplement, sous une autre forme, d'être utilisé.

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. Il ne compte simplement pas comme solde natif : il ne paie donc pas les frais, et le dépôt reste immobilisé jusqu'à la fermeture.

Pourquoi ai-je du wSOL dans mon portefeuille ?

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. Pour un wrapped BTC ou un wrapped ETH sur une autre chaîne, un dépositaire ou un pont se tient 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 seule fois, le dépôt de loyer si aucun compte wSOL n'existe encore. Ce dépôt est prêté, pas dépensé. L'outil de wrapping lui-même est gratuit.

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.