CW-20 : Le modèle de token universel pour Cosmos et Terra

CW-20 est devenu le standard de facto pour les tokens fongibles sur les chaînes compatibles CosmWasm, offrant une interface cohérente pour les tokens sur Terra et dans tout l'écosystème Cosmos. En combinant la flexibilité des smart contracts avec l'interopérabilité de l'IBC, CW-20 permet aux développeurs et aux utilisateurs d'émettre, de transférer et de faire transiter des tokens entre des chaînes souveraines avec une friction minimale.

Cet article détaille ce qu'est CW-20, comment il se compare aux actifs natifs de Cosmos, comment il circule via l'IBC, et quelles sont les meilleures pratiques à adopter en 2025 pour les développeurs et les utilisateurs.

Qu'est-ce que CW-20 ?

CW-20 est un standard de smart contract pour les tokens fongibles implémenté dans CosmWasm, analogue à ERC-20 sur Ethereum. L'implémentation de référence principale est disponible sous le nom de cw20-base, qui définit des messages et des requêtes standardisés pour le comportement des tokens tels que la création (minting), la destruction (burning), les transferts et la gestion des autorisations (allowances). Les développeurs partent généralement de ce contrat et l'étendent pour y ajouter une logique personnalisée comme des modèles de frais, des hooks ou du staking.

• Implémentation de référence : cw20-base Consultez le dépôt canonique cw-plus pour le contrat de base CW-20 et ses extensions. Contrat cw20-base

• Documentation CosmWasm CosmWasm fournit l'environnement d'exécution et les outils utilisés pour compiler et déployer des contrats CW-20 sur des chaînes compatibles. Docs CosmWasm

L'écosystème CW-20 comprend également cw20-ics20, qui simplifie les transferts inter-chaînes via l'IBC. Contrat cw20-ics20

CW-20 vs actifs natifs de Cosmos

Dans les chaînes Cosmos SDK, les actifs "natifs" existent sous forme de dénominations (denoms) gérées par des modules comme x/bank. Les tokens CW-20, en revanche, sont définis par contrat et vivent dans l'environnement d'exécution CosmWasm. Les deux modèles ont leurs avantages :

• Dénominations natives Avantages : comptabilité simple, faible surcharge, gouvernance au niveau du module. Inconvénients : moins de flexibilité pour la logique de token programmable.

• Tokens CW-20 Avantages : évolutifs via la migration de contrat, tokenomics personnalisables, hooks pour les intégrations. Inconvénients : nécessitent des audits de contrat et une gouvernance bien conçue pour éviter les risques de privilèges.

Comprendre quel modèle convient à votre cas d'utilisation est essentiel. Pour la distribution programmable, le partage des frais ou une offre contrôlée par une DAO, CW-20 est souvent le meilleur choix. Pour les actifs de base ou les incitations à l'échelle de la chaîne, les dénominations natives restent idéales. Consultez la documentation du Cosmos SDK pour savoir comment les actifs natifs sont structurés au niveau du module. Documentation Cosmos SDK

Transferts inter-chaînes : CW-20 et ICS-20

Les transferts inter-chaînes dans Cosmos utilisent l'IBC, avec ICS-20 comme standard pour le mouvement des tokens fongibles. Bien qu'ICS-20 transfère principalement des dénominations natives sous forme de "bons" (vouchers) entre les chaînes, les contrats CW-20 peuvent s'intégrer à l'IBC via cw20-ics20. Ce modèle encapsule les tokens CW-20 et les mappe sur des paquets compatibles ICS-20, rendant ainsi votre CW-20 utilisable sur des chaînes souveraines.

• Spécification ICS-20 Le standard de transfert de tokens fongibles utilisé par l'IBC. Spécification ICS-20

• Relais (Relaying) Les transferts dépendent des relais. Hermes est largement utilisé en production. Documentation du relais Hermes

En pratique, un token CW-20 sur une chaîne CosmWasm comme Terra ou Neutron peut être transféré vers une autre chaîne (par exemple, Osmosis) via cw20-ics20, arrivant sous forme de dénomination de bon ICS-20 sur la destination. Des métadonnées appropriées, l'alignement des décimales et des protections côté contrat aident à préserver la cohérence de l'expérience utilisateur entre les chaînes. Documentation Neutron Documentation Osmosis

Terra et CW-20

Terra exécute une chaîne compatible CosmWasm où les tokens CW-20 sont des citoyens de première classe utilisés pour la DeFi, les paiements et les dApps. Les déploiements suivent les flux CosmWasm standards : téléchargement du code, instanciation de cw20-base avec des métadonnées et configuration des privilèges de création (minting)/destruction (burning) via la gouvernance.

• Documentation Terra Déploiement de contrats, spécificités de la chaîne et outils. Documentation Terra

• Explorateur de blocs Terra Inspectez les contrats de tokens CW-20, les transactions et les soldes. Terra Finder

Avec l'accent continu de Terra sur les performances de la chaîne et l'expérience développeur, CW-20 reste un moyen simple de déployer des actifs programmables et de participer aux flux inter-chaînes en utilisant ICS-20.

Essentiels pour les développeurs

Si vous émettez ou intégrez un CW-20, incorporez les éléments suivants :

• Métadonnées du token Définissez le nom, le symbole, le nombre de décimales et les paramètres d'approvisionnement lors de l'instanciation. Envisagez un approvisionnement immuable ou des privilèges de création (mint) bien définis.

• Autorisations (Allowances) et Hooks CW-20 prend en charge les dépenses basées sur les autorisations. Les hooks permettent la composabilité (par exemple, le staking automatisé ou le routage des frais).

• Migration de contrat CosmWasm prend en charge la migration des contrats avec des mises à niveau approuvées par la gouvernance. Prévoyez les rôles de propriétaire, les timelocks et des chemins de mise à niveau transparents. Cycle de vie des contrats CosmWasm

• Intégration IBC Utilisez cw20-ics20 pour permettre les transferts via ICS-20. Testez les cas complexes comme les incohérences de décimales et les pannes de relais. Contrat cw20-ics20

• Audits et sécurité Examinez les limites de privilèges, vérifiez la réentrance via les hooks et documentez les procédures de mise à niveau.

• Observabilité Publiez l'adresse de votre contrat, l'ID du code et les détails de vérification. Maintenez vos journaux de modifications à jour et annoncez publiquement les mises à niveau.

Nouveautés en 2025

Au cours de 2024-2025, CosmWasm continue de mûrir avec des améliorations de performance et des outils améliorés pour les dApps inter-chaînes. Les notes de publication sont suivies dans le dépôt principal et mettent en évidence les détails de compatibilité avec les cibles récentes de Rust et Wasm. Alors que des chaînes comme Neutron et Osmosis affinent leurs primitives DeFi inter-chaînes, l'intégration CW-20 reste centrale pour la liquidité composable, les stratégies de rendement et la gestion des trésoreries de DAO. Sorties CosmWasm

Du côté de l'IBC, les améliorations du logiciel de relais et la surveillance au niveau de la chaîne réduisent la friction pour les transferts cw20-ics20, tandis que les standards de l'écosystème mettent l'accent sur la cohérence des métadonnées pour éviter la confusion des utilisateurs lors des sauts multi-chaînes. Spécification ICS-20 Documentation du relais Hermes

Meilleures pratiques pour les utilisateurs

• Vérifiez les contrats de token Confirmez l'adresse du contrat CW-20 auprès des sources officielles et des explorateurs avant de l'ajouter à votre portefeuille.

• Comprenez les bons inter-chaînes (vouchers) Les dénominations "bons" (vouchers) ICS-20 représentent des actifs pontés ; assurez-vous de reconnaître le canal source et le chemin lors de l'évaluation de l'authenticité.

• Gérez le risque avec l'auto-conservation matérielle (hardware self-custody) Conservez vos clés privées hors ligne lorsque vous interagissez avec des protocoles DeFi CW-20 et des transferts IBC.

OneKey pour CW-20 et les actifs inter-chaînes

Si vous utilisez activement des tokens CW-20 sur Terra et Cosmos, un portefeuille matériel peut réduire considérablement le risque d'exposition de vos clés. OneKey offre une signature sécurisée et hors ligne pour les comptes multi-chaînes et s'intègre de manière transparente avec les outils Cosmos populaires qui prennent en charge les transactions IBC et les contrats CosmWasm. Ceci est particulièrement utile lors de l'approbation des autorisations CW-20 ou de la confirmation des transferts cw20-ics20, où une signature précise et résistante à la falsification est essentielle pour la sécurité.

Conclusion

CW-20 est devenu le modèle de token universel et programmable pour Terra et les chaînes Cosmos compatibles CosmWasm. Associé à ICS-20 et à des relais robustes, les actifs CW-20 peuvent circuler entre des réseaux souverains tout en conservant des interfaces cohérentes pour les portefeuilles et les dApps. En 2025, la combinaison d'outils matures, de contrats évolutifs et de liquidité inter-chaînes maintient CW-20 au centre des cas d'utilisation de la DeFi et des DAO. Que vous déployiez votre premier token ou que vous fassiez transiter une offre existante, concentrez-vous sur des métadonnées claires, des contrats audités, des chemins IBC testés et une gestion sécurisée des clés pour garantir une expérience fiable et composable à vos utilisateurs.