← Blog
10 min di lettura
|
Pubblicato
|
Aggiornato

Standard di token ERC721: come funzionano gli NFT

Cosa definisce lo standard ERC721, come funzionano proprietà, approvazioni e trasferimenti, in cosa differisce da ERC20 e come inviare token ERC721 tramite API.

Capitoli
C
Chaingateway Team
Esperti di blockchain

Verificato da Maurice Sobiera

ERC721 è lo standard di Ethereum per i token non fungibili (NFT). Definisce un’interfaccia comune che uno smart contract implementa, in modo che ogni token abbia un ID unico, un solo proprietario e lo stesso insieme di funzioni per trasferimenti e approvazioni. Wallet, marketplace e API possono quindi gestire qualsiasi contratto ERC721 nello stesso modo.

Che cosa definisce lo standard ERC721?

Lo standard è specificato in EIP-721. Un contratto conforme deve implementare l’interfaccia ERC721 e l’interfaccia ERC165, che permette ad altri contratti di chiedere se un contratto supporta una certa interfaccia. L’ID dell’interfaccia ERC721 è 0x80ac58cd.

L’interfaccia prevede tre eventi e otto funzioni (safeTransferFrom esiste in due forme):

ElementoTipoScopo
TransfereventoEmesso ogni volta che cambia la proprietà di un token, inclusi il minting e il burning
ApprovaleventoEmesso quando cambia l’indirizzo approvato per un singolo token
ApprovalForAlleventoEmesso quando un proprietario attiva o disattiva un operatore per tutti i suoi token
balanceOf(owner)funzioneNumero di token posseduti da un indirizzo
ownerOf(tokenId)funzioneIndirizzo che possiede un token
safeTransferFrom(from, to, tokenId)funzioneTrasferisce un token e verifica che un contratto ricevente sia in grado di gestirlo
transferFrom(from, to, tokenId)funzioneTrasferisce un token senza quella verifica
approve(to, tokenId)funzionePermette a un indirizzo di spostare un token specifico
setApprovalForAll(operator, approved)funzionePermette a un operatore di spostare tutti i token del chiamante
getApproved(tokenId)funzioneRestituisce l’indirizzo approvato per un token
isApprovedForAll(owner, operator)funzioneIndica se un operatore è approvato per un proprietario

safeTransferFrom ha una seconda forma con un argomento data aggiuntivo. Quando il destinatario è uno smart contract, entrambe le forme chiamano onERC721Received su di esso e annullano l’operazione se il contratto non restituisce il valore atteso. Questo impedisce di inviare token a contratti che non sanno spostarli di nuovo. transferFrom non ha questo controllo, ed EIP-721 precisa che il chiamante è responsabile di verificare che il destinatario possa gestire gli NFT.

Esistono due estensioni opzionali. L’estensione metadata aggiunge name(), symbol() e tokenURI(tokenId), dove l’URI di solito punta a un file JSON con nome, descrizione e immagine. L’estensione enumeration aggiunge totalSupply() e funzioni per elencare i token per indice.

Come si crea un token ERC721?

Si scrive uno smart contract che implementa l’interfaccia, lo si compila e si distribuisce il bytecode sulla blockchain di Ethereum. La maggior parte dei team parte da una libreria mantenuta invece di scrivere le funzioni a mano. La documentazione ERC721 di OpenZeppelin descrive un’implementazione mantenuta, e l’IDE web Remix può compilarla e distribuirla senza strumenti locali.

Il deployment restituisce un indirizzo di contratto. Testate prima il contratto su una testnet, poi distribuitelo sulla mainnet.

Che cos’è un indirizzo di contratto e perché conta?

L’indirizzo del contratto è l’unico identificatore affidabile di una collezione di token ERC721. Nomi e simboli non sono unici: chiunque può distribuire un contratto che si chiama come una collezione esistente. Un token è identificato in modo completo solo dalla coppia formata da indirizzo del contratto e ID del token.

Quando integrate un token ERC721, salvate sempre entrambi i valori. Due contratti diversi possono avere ciascuno un token con ID 1.

Qual è la differenza tra ERC721 ed ERC20?

I token ERC20 sono fungibili: ogni unità è intercambiabile, e il contratto memorizza solo un saldo per indirizzo. I token ERC721 sono non fungibili: ogni ID di token ha il proprio proprietario e i propri metadati. EIP-721 è stato progettato sul modello di ERC20 e indica nella mancanza di tracciamento per singolo asset il motivo per cui ERC20 non si adatta agli NFT.

Le differenze pratiche per un’integrazione sono piccole ma facili da trascurare:

  • I trasferimenti ERC20 richiedono un importo, quelli ERC721 richiedono un ID di token.
  • balanceOf su un contratto ERC721 conta i token, non il valore.
  • ERC721 prevede approvazioni per singolo token oltre alle approvazioni per operatore.

Per un confronto più lungo con ERC1155, che può contenere token fungibili e non fungibili in un solo contratto, leggete ERC-721 vs ERC-1155 e Standard dei token spiegati. La nostra spiegazione di ERC20 si trova in Lo standard di token ERC20.

Le commissioni di gas si possono pagare con token ERC721?

No. Il gas su Ethereum si paga sempre in ETH, anche se la transazione sposta solo un token ERC721. L’indirizzo mittente deve avere abbastanza ETH per coprire il gas, e la commissione è il gas usato moltiplicato per il prezzo del gas. Il prezzo attuale si legge nel gas tracker di Etherscan, e ethereum.org spiega come si calcola la commissione.

Quanto costa creare un token ERC721?

Il deployment del contratto costa gas, e l’importo dipende dalla dimensione del contratto distribuito. Il minting di ogni token costa gas aggiuntivo, pagato dal proprietario del contratto o dall’utente che effettua il mint, a seconda di come è scritto il contratto. Stimate il deployment su una testnet con eth_estimateGas prima di distribuire sulla mainnet, poi moltiplicate il risultato per il prezzo del gas attuale.

I token ERC721 sono legali?

Lo standard del token è solo un’interfaccia tecnica. Se un uso sia regolamentato dipende da ciò che il token rappresenta e da dove si trovano le parti. Vendere token, accettarli come pagamento o offrirli come quote di una società può comportare obblighi di licenza, fiscali e di Know Your Customer (KYC) o di Anti Money Laundering (AML). Consultate un avvocato che conosca la vostra giurisdizione prima di lanciare un modello di business basato su di essi.

Come si inviano automaticamente i token ERC721?

Potete inviare token ERC721 tramite script con l’API REST di Chaingateway, invece di usare un wallet per ogni trasferimento. L’endpoint è POST /api/v2/ethereum/transactions/erc721 e richiede l’indirizzo mittente, l’indirizzo del contratto, il destinatario e l’ID del token. Il gas si paga in ETH dall’indirizzo mittente, ed esistono endpoint equivalenti per Polygon e Arbitrum (erc721) e per 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"
}'

I campi obbligatori sono from, contractaddress, to e tokenId. Al posto di password potete passare una privatekey. I campi opzionali come gas, gasprice, maxFeePerGas, maxPriorityFeePerGas e nonce permettono di controllare la commissione e l’ordine delle transazioni. Una chiamata riuscita restituisce HTTP 201 con l’ID della transazione in data.txid. Impostate l’header X-Network: testnet per provare prima la chiamata su una rete di test. I parametri della richiesta sono elencati nel riferimento API.

Per una panoramica passo dopo passo di controlli di proprietà, firma e conferma, vedete Trasferire NFT tramite API.

Esistono altri standard di token?

Sì. ERC20 copre i token fungibili, e ERC-1155 è uno standard multi-token che può gestire token fungibili e non fungibili in un unico contratto. Su altre reti gli equivalenti hanno nomi diversi, per esempio TRC-20 su TRON e SPL su Solana.

Come scriviamo questi articoli

Pronto a costruirlo da solo? Ottieni la tua API key — prova di 7 giorni, senza carta — oppure consulta API Ethereum 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.