← Blog
10 min di lettura
|
Pubblicato
|
Aggiornato

Funzioni NFT e estimateGas: release 2021

Cosa ha aggiunto la release di novembre 2021: getNFTOwner, getNFTURI, sendNFT ed estimateGas, e come funzionano oggi invii NFT e stime del gas nell'API v2.

Capitoli
C
Chaingateway Team
Esperti di blockchain

Verificato da Maurice Sobiera

Le funzioni NFT di Chaingateway leggono il proprietario e l’URI dei metadati di un token ERC-721, BEP-721 o TRC-721 e lo inviano a un altro indirizzo. La release di novembre 2021 ha aggiunto getNFTOwner, getNFTURI e sendNFT per Ethereum, Tron e BSC. Ha aggiunto anche estimateGas per Ethereum e BSC, che restituisce una stima del gas per una transazione senza inviarla.

Che cos’è un NFT?

Un token non fungibile (NFT) è un token in cui ogni unità ha un proprio ID di token. È stato standardizzato per la prima volta su Ethereum come ERC-721. I token ERC-20 sono intercambiabili: una qualsiasi unità è identica a un’altra. Un token ERC-721 è diverso, perché ogni ID di token può avere un proprietario e metadati propri.

Lo standard è definito nella EIP-721. Specifica ownerOf(tokenId) per restituire il proprietario e safeTransferFrom per spostare un token. L’estensione facoltativa dei metadati aggiunge tokenURI(tokenId), che restituisce un link ai metadati del token. BEP-721 su BNB Smart Chain e TRC-721 su Tron seguono lo stesso modello.

La EIP-721 standardizza una funzione di trasferimento sicuro, safeTransferFrom, e una non sicura, transferFrom. Con transferFrom il chiamante deve confermare che l’indirizzo ricevente sa gestire gli NFT. Lo standard avverte che altrimenti il token può andare perso in modo permanente. Verifica il destinatario prima di inviare un token a un indirizzo di contratto. Per un’introduzione più estesa, leggi lo standard di token ERC721.

Quali funzioni NFT ha aggiunto la release del 2021?

La release ha aggiunto tre funzioni NFT. Tutte e tre erano disponibili per le API di Ethereum, Tron e Binance Smart Chain.

FunzioneChe cosa faParametri
getNFTOwnerRestituisce l’indirizzo del proprietario di un NFTID del token, indirizzo del contratto del token
getNFTURIRestituisce l’URI di un NFTCome getNFTOwner
sendNFTInvia un NFT a un altro indirizzoIndirizzo del mittente, indirizzo di destinazione, indirizzo del contratto, ID del token

Questi nomi descrivono le funzioni come annunciate nel 2021. La documentazione di allora era il riferimento per il loro uso esatto.

Chaingateway può coniare NFT?

Nessuna funzione di mint dedicata faceva parte di questa release. Si poteva comunque coniare codificando la chiamata al contratto da sé e inviandola come transazione normale con i dati codificati.

Questo è coerente con lo standard, perché la EIP-721 non definisce il minting. La specifica afferma che la creazione e la distruzione di NFT non sono incluse, e che un contratto può implementarle con altri mezzi. Il funzionamento del minting differisce quindi da contratto a contratto. Nel 2021 il team dichiarava di non avere un ambiente di test per una funzione di mint e chiedeva ai proprietari di contratti ERC-721, BEP-721 o TRC-721 di aiutare a testarne una.

Che cosa fa estimateGas?

estimateGas restituisce la quantità di gas che una transazione dovrebbe richiedere, prima di inviarla. Per Ethereum e BSC accetta gli stessi parametri di una transazione normale, tranne la password. È stata aggiunta perché molti utenti chiedevano un modo più semplice per calcolare le commissioni del gas.

Il meccanismo sottostante è il metodo eth_estimateGas dell’interfaccia JSON-RPC di Ethereum. Secondo la documentazione per sviluppatori di Ethereum, genera una stima senza aggiungere la transazione alla blockchain. La stessa pagina avverte che la stima può essere sensibilmente più alta del gas che la transazione usa davvero. Tratta il risultato come limite superiore per il tuo gas limit, non come costo finale. Un semplice trasferimento di ether, ad esempio, usa 21000 gas, che la stessa pagina indica come 0x5208.

Che cosa si può usare oggi?

I nomi delle funzioni sopra provengono dalla generazione di API del 2021. La specifica OpenAPI pubblica attuale (versione 2.1.0) è organizzata in modo diverso, quindi questa sezione elenca ciò che contiene al 5 novembre 2026.

AttivitàEndpoint nella specifica v2
Inviare un token ERC-721 su EthereumPOST /api/v2/ethereum/transactions/erc721
Inviare un token BEP-721 su BSCPOST /api/v2/bsc/transactions/bep721
Inviare un token TRC-721 su TronPOST /api/v2/tron/transactions/trc721
Inviare un token ERC-721 su Polygon o ArbitrumPOST /api/v2/polygon/transactions/erc721, POST /api/v2/arbitrum/transactions/erc721
Leggere il prezzo del gas attualeGET /api/v2/ethereum/gasprice, e lo stesso percorso sotto bsc, polygon e arbitrum

La specifica non elenca endpoint separati per getNFTOwner, getNFTURI o estimateGas. Per leggere il proprietario o l’URI, chiama ownerOf o tokenURI sul contratto del token tramite un qualsiasi endpoint JSON-RPC. Per una stima del gas, usa allo stesso modo eth_estimateGas. L’articolo su come stimare le commissioni del gas spiega il calcolo.

Una richiesta di invio su Ethereum richiede from, contractaddress, to e tokenId. Il campo password è obbligatorio, a meno che non passi una privatekey. I campi del gas come gas, gasprice o maxFeePerGas sono facoltativi.

Terminal window
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"
}'

Una chiamata riuscita restituisce lo stato 201 con l’hash della transazione in data.txid. Una password del wallet errata restituisce 401. Un wallet senza saldo sufficiente per pagare il gas restituisce 422, ad esempio con il messaggio “insufficient funds for gas * price + value”. Gli indirizzi sopra sono i valori segnaposto della specifica. Per una guida completa, vedi come trasferire NFT tramite API.

Vuoi discutere nuove funzioni?

I feedback sono benvenuti nel gruppo Telegram di Chaingateway.

Come scriviamo questi articoli

Pronto a costruirlo da solo? Ottieni la tua API key — prova di 7 giorni, senza carta — oppure consulta Blockchain API per il riferimento completo degli endpoint.

C
Chaingateway Team
Esperti di blockchain

Il team di Chaingateway si impegna a semplificare l'integrazione blockchain per sviluppatori di tutto il mondo.