Fonctions NFT et estimateGas : version de 2021
Ce qu'a ajouté la version de novembre 2021 (getNFTOwner, getNFTURI, sendNFT, estimateGas) et comment envoyer des NFT et lire le gas dans l'API v2.
Relu par Maurice Sobiera
Les fonctions NFT de Chaingateway lisent le propriétaire et l’URI de métadonnées d’un jeton ERC-721, BEP-721 ou TRC-721 et l’envoient à une autre adresse. La version de novembre 2021 a ajouté getNFTOwner, getNFTURI et sendNFT pour Ethereum, Tron et BSC. Elle a aussi ajouté estimateGas pour Ethereum et BSC, qui renvoie une estimation de gas pour une transaction sans l’envoyer.
Qu’est-ce qu’un NFT ?
Un jeton non fongible (NFT) est un jeton dont chaque unité a son propre identifiant de jeton. Il a d’abord été standardisé sur Ethereum sous le nom ERC-721. Les jetons ERC-20 sont interchangeables : une unité est identique à une autre. Un jeton ERC-721 est différent, car chaque identifiant de jeton peut avoir son propre propriétaire et ses propres métadonnées.
Le standard est défini dans l’EIP-721. Il spécifie ownerOf(tokenId) pour renvoyer le propriétaire et safeTransferFrom pour déplacer un jeton. L’extension optionnelle de métadonnées ajoute tokenURI(tokenId), qui renvoie un lien vers les métadonnées du jeton. BEP-721 sur BNB Smart Chain et TRC-721 sur Tron suivent le même modèle.
L’EIP-721 standardise une fonction de transfert sûre, safeTransferFrom, et une non sûre, transferFrom. Avec transferFrom, l’appelant doit confirmer que l’adresse destinataire sait gérer les NFT. Le standard avertit que le jeton peut sinon être perdu définitivement. Vérifiez le destinataire avant d’envoyer un jeton vers une adresse de contrat. Pour une introduction plus longue, lisez le standard de jeton ERC721.
Quelles fonctions NFT la version de 2021 a-t-elle ajoutées ?
La version a ajouté trois fonctions NFT. Les trois étaient disponibles pour les API Ethereum, Tron et Binance Smart Chain.
| Fonction | Ce qu’elle fait | Paramètres |
|---|---|---|
| getNFTOwner | Renvoie l’adresse du propriétaire d’un NFT | Identifiant du jeton, adresse du contrat du jeton |
| getNFTURI | Renvoie l’URI d’un NFT | Comme getNFTOwner |
| sendNFT | Envoie un NFT à une autre adresse | Adresse de l’expéditeur, adresse de destination, adresse du contrat, identifiant du jeton |
Ces noms décrivent les fonctions telles qu’annoncées en 2021. La documentation de l’époque faisait référence pour leur usage exact.
Chaingateway peut-il minter des NFT ?
Aucune fonction de mint dédiée ne faisait partie de cette version. Vous pouviez tout de même minter en encodant vous-même l’appel de contrat et en l’envoyant comme transaction normale avec les données encodées.
C’est cohérent avec le standard, car l’EIP-721 ne définit pas le minting. La spécification indique que la création et la destruction de NFT ne sont pas incluses et qu’un contrat peut les implémenter par d’autres moyens. Le fonctionnement du minting diffère donc d’un contrat à l’autre. En 2021, l’équipe disait manquer d’un environnement de test pour une fonction de mint et demandait aux propriétaires de contrats ERC-721, BEP-721 ou TRC-721 de l’aider à en tester une.
Que fait estimateGas ?
estimateGas renvoie la quantité de gas qu’une transaction devrait demander, avant que vous ne l’envoyiez. Pour Ethereum et BSC, il prend les mêmes paramètres qu’une transaction normale, sauf le mot de passe. Il a été ajouté parce que beaucoup d’utilisateurs demandaient un moyen plus simple de calculer les frais de gas.
Le mécanisme sous-jacent est la méthode eth_estimateGas de l’interface JSON-RPC d’Ethereum. Selon la documentation développeur d’Ethereum, elle génère une estimation sans ajouter la transaction à la blockchain. La même page avertit que l’estimation peut être nettement supérieure au gas réellement utilisé par la transaction. Traitez le résultat comme une borne supérieure pour votre limite de gas, pas comme le coût final. Un simple transfert d’ether, par exemple, utilise 21000 de gas, que la même page affiche sous la forme 0x5208.
Que puis-je utiliser aujourd’hui ?
Les noms de fonctions ci-dessus viennent de la génération d’API de 2021. La spécification OpenAPI publique actuelle (version 2.1.0) est organisée autrement : cette section liste donc ce qu’elle contient au 5 novembre 2026.
| Tâche | Point d’accès dans la spécification v2 |
|---|---|
| Envoyer un jeton ERC-721 sur Ethereum | POST /api/v2/ethereum/transactions/erc721 |
| Envoyer un jeton BEP-721 sur BSC | POST /api/v2/bsc/transactions/bep721 |
| Envoyer un jeton TRC-721 sur Tron | POST /api/v2/tron/transactions/trc721 |
| Envoyer un jeton ERC-721 sur Polygon ou Arbitrum | POST /api/v2/polygon/transactions/erc721, POST /api/v2/arbitrum/transactions/erc721 |
| Lire le prix actuel du gas | GET /api/v2/ethereum/gasprice, et le même chemin sous bsc, polygon et arbitrum |
La spécification ne liste pas de points d’accès séparés getNFTOwner, getNFTURI ou estimateGas. Pour lire le propriétaire ou l’URI, appelez ownerOf ou tokenURI sur le contrat du jeton par n’importe quel point d’accès JSON-RPC. Pour une estimation de gas, utilisez eth_estimateGas de la même façon. L’article sur l’estimation des frais de gas couvre le calcul.
Une requête d’envoi sur Ethereum demande from, contractaddress, to et tokenId. Le champ password est obligatoire, sauf si vous passez une privatekey. Les champs de gas comme gas, gasprice ou maxFeePerGas sont optionnels.
curl -X POST https://app.chaingateway.io/api/v2/ethereum/transactions/erc721 \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "from": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2", "contractaddress": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2", "to": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2", "tokenId": 1, "password": "your-wallet-password" }'Un appel réussi renvoie le statut 201 avec le hash de transaction dans data.txid. Un mot de passe de portefeuille erroné renvoie 401. Un portefeuille dont le solde ne suffit pas à payer le gas renvoie 422, par exemple avec le message « insufficient funds for gas * price + value ». Les adresses ci-dessus sont les valeurs fictives de la spécification. Pour un tutoriel complet, voyez comment transférer des NFT via l’API.
Vous voulez discuter de nouvelles fonctions ?
Vos retours sont les bienvenus dans le groupe Telegram de Chaingateway.
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 Blockchain pour la référence complète des endpoints.