← Blog
10 min de lecture
|
Publié le
|
Mis à jour le

Le standard de token ERC721 : comment fonctionnent les NFT

Ce que définit ERC721, comment fonctionnent propriété, approbations et transferts, sa différence avec ERC20, et comment envoyer des tokens ERC721 par API.

Chapitres
C
Chaingateway Team
Experts blockchain

Relu par Maurice Sobiera

ERC721 est le standard Ethereum pour les tokens non fongibles (NFT). Il définit une interface commune qu’un contrat intelligent implémente, de sorte que chaque token possède un identifiant unique, exactement un propriétaire et le même ensemble de fonctions pour les transferts et les approbations. Les portefeuilles, les places de marché et les API peuvent alors traiter n’importe quel contrat ERC721 de la même manière.

Que définit le standard ERC721 ?

Le standard est spécifié dans l’EIP-721. Un contrat conforme doit implémenter l’interface ERC721 et l’interface ERC165, qui permet à d’autres contrats de demander si un contrat prend en charge une interface donnée. L’identifiant de l’interface ERC721 est 0x80ac58cd.

L’interface comprend trois événements et huit fonctions (safeTransferFrom existe sous deux formes) :

ÉlémentTypeRôle
TransferévénementÉmis à chaque changement de propriété d’un token, y compris lors de la création et de la destruction
ApprovalévénementÉmis lorsque l’adresse approuvée pour un token change
ApprovalForAllévénementÉmis lorsqu’un propriétaire active ou désactive un opérateur pour l’ensemble de ses tokens
balanceOf(owner)fonctionNombre de tokens détenus par une adresse
ownerOf(tokenId)fonctionAdresse qui possède un token
safeTransferFrom(from, to, tokenId)fonctionTransfère un token et vérifie qu’un contrat destinataire peut le gérer
transferFrom(from, to, tokenId)fonctionTransfère un token sans cette vérification
approve(to, tokenId)fonctionPermet à une adresse de déplacer un token précis
setApprovalForAll(operator, approved)fonctionPermet à un opérateur de déplacer tous les tokens de l’appelant
getApproved(tokenId)fonctionRenvoie l’adresse approuvée d’un token
isApprovedForAll(owner, operator)fonctionIndique si un opérateur est approuvé pour un propriétaire

safeTransferFrom a une seconde forme avec un argument data supplémentaire. Lorsque le destinataire est un contrat intelligent, les deux formes appellent onERC721Received sur ce contrat, et annulent la transaction si celui-ci ne renvoie pas la valeur attendue. Cela évite d’envoyer des tokens à des contrats incapables de les déplacer à nouveau. transferFrom ne comporte pas une telle vérification, et l’EIP-721 précise qu’il incombe à l’appelant de s’assurer que le destinataire peut gérer des NFT.

Deux extensions facultatives existent. L’extension de métadonnées ajoute name(), symbol() et tokenURI(tokenId), où l’URI pointe en général vers un fichier JSON contenant un nom, une description et une image. L’extension d’énumération ajoute totalSupply() et des fonctions pour lister les tokens par index.

Comment créer un token ERC721 ?

Vous écrivez un contrat intelligent qui implémente l’interface, vous le compilez et vous déployez le bytecode sur la blockchain Ethereum. La plupart des équipes partent d’une bibliothèque maintenue plutôt que d’écrire les fonctions à la main. La documentation ERC721 d’OpenZeppelin décrit une implémentation maintenue, et l’IDE Remix, en version web, peut la compiler et la déployer sans outillage local.

Le déploiement renvoie une adresse de contrat. Testez d’abord le contrat sur un testnet, puis déployez-le sur le mainnet.

Qu’est-ce qu’une adresse de contrat, et pourquoi compte-t-elle ?

L’adresse du contrat est le seul identifiant fiable d’une collection de tokens ERC721. Les noms et les symboles ne sont pas uniques : n’importe qui peut déployer un contrat qui porte le même nom qu’une collection existante. Un token est entièrement identifié par le couple formé par l’adresse du contrat et l’identifiant du token.

Lorsque vous intégrez un token ERC721, stockez toujours les deux valeurs. Deux contrats différents peuvent chacun avoir un token portant l’identifiant 1.

Quelle est la différence entre ERC721 et ERC20 ?

Les tokens ERC20 sont fongibles : chaque unité est interchangeable, et le contrat ne stocke qu’un solde par adresse. Les tokens ERC721 sont non fongibles : chaque identifiant de token a son propre propriétaire et ses propres métadonnées. L’EIP-721 s’est appuyé sur le modèle d’ERC20, et il présente l’absence de suivi par actif comme la raison pour laquelle ERC20 ne convient pas aux NFT.

Les différences pratiques pour une intégration sont minimes, mais faciles à manquer :

  • Les transferts ERC20 prennent un montant, les transferts ERC721 prennent un identifiant de token.
  • balanceOf sur un contrat ERC721 compte des tokens, et non une valeur.
  • ERC721 ajoute aux approbations d’opérateur des approbations par token.

Pour une comparaison plus détaillée avec ERC1155, qui peut détenir des tokens fongibles et non fongibles dans un même contrat, lisez ERC-721 vs ERC-1155 et Les standards de tokens expliqués. Notre explication sur ERC20 se trouve dans Le standard de token ERC20.

Les frais de gas peuvent-ils être payés avec des tokens ERC721 ?

Non. Le gas sur Ethereum se paie toujours en ETH, même si la transaction ne déplace qu’un token ERC721. L’adresse expéditrice doit disposer de suffisamment d’ETH pour couvrir le gas, et les frais correspondent au gas utilisé multiplié par le prix du gas. Vous pouvez consulter le prix actuel sur le gas tracker d’Etherscan, et ethereum.org explique le calcul des frais.

Combien coûte la création d’un token ERC721 ?

Le déploiement du contrat coûte du gas, et le montant dépend de la taille du contrat déployé. Chaque frappe de token coûte du gas supplémentaire, payé soit par le propriétaire du contrat, soit par l’utilisateur qui frappe, selon la manière dont le contrat est écrit. Estimez le déploiement sur un testnet avec eth_estimateGas avant de déployer sur le mainnet, puis multipliez le résultat par le prix du gas actuel.

Les tokens ERC721 sont-ils légaux ?

Le standard de token lui-même n’est qu’une interface technique. Qu’un usage soit réglementé dépend de ce que représente le token et de l’endroit où se trouvent les parties. Vendre des tokens, les accepter comme paiement ou les proposer comme parts d’une entreprise peut entraîner des obligations de licence et fiscales, ainsi que des obligations de connaissance client (KYC) ou de lutte contre le blanchiment (AML). Consultez un avocat qui connaît votre juridiction avant de lancer un modèle d’affaires autour de ces tokens.

Comment envoyer automatiquement des tokens ERC721 ?

Vous pouvez envoyer des tokens ERC721 par script via l’API REST de Chaingateway, au lieu d’utiliser un portefeuille pour chaque transfert. Le point de terminaison est POST /api/v2/ethereum/transactions/erc721, et il prend l’adresse expéditrice, l’adresse du contrat, le destinataire et l’identifiant du token. Vous payez le gas en ETH depuis l’adresse expéditrice. Des points de terminaison équivalents existent pour Polygon et Arbitrum (erc721), ainsi que pour BNB Smart Chain (bep721).

Terminal window
curl -X POST https://app.chaingateway.io/api/v2/ethereum/transactions/erc721 \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-H "X-Network: testnet" \
-d '{
"from": "0xSenderAddress",
"contractaddress": "0xYourErc721ContractAddress",
"to": "0xReceiverAddress",
"tokenId": 1,
"password": "wallet-password"
}'

Les champs obligatoires sont from, contractaddress, to et tokenId. Au lieu de password, vous pouvez passer une privatekey. Les champs facultatifs comme gas, gasprice, maxFeePerGas, maxPriorityFeePerGas et nonce permettent de contrôler les frais et l’ordre des transactions. Un appel réussi renvoie le statut HTTP 201 avec l’identifiant de transaction dans data.txid. Définissez l’en-tête X-Network: testnet pour tester d’abord l’appel sur un réseau de test. Les paramètres de requête figurent dans la référence de l’API.

Pour une présentation pas à pas des vérifications de propriété, de la signature et de la confirmation, voir Transférer des NFT via l’API.

Existe-t-il d’autres standards de tokens ?

Oui. ERC20 couvre les tokens fongibles, et ERC-1155 est un standard multi-tokens qui peut gérer des tokens fongibles et non fongibles dans un seul contrat. Sur d’autres réseaux, les équivalents portent d’autres noms, par exemple TRC-20 sur TRON et SPL sur Solana.

Comment nous rédigeons ces articles

Prêt à le construire vous-même ? Obtenir votre clé API — essai de 7 jours, sans carte bancaire — ou consultez API Ethereum pour la référence complète des endpoints.

C
Chaingateway Team
Experts blockchain

L'équipe Chaingateway s'attache à simplifier l'intégration blockchain pour les développeurs du monde entier.