Configurare web3.js per usare la blockchain di Ethereum in JavaScript

In questo tutorial, vedremo come iniziare con web3.js (opens in a new tab) per interagire con la blockchain di Ethereum. Web3.js può essere usato sia nei frontend che nei backend per leggere dati dalla blockchain o effettuare transazioni e persino distribuire contratti intelligenti.

Il primo passo è includere web3.js nel tuo progetto. Per usarlo in una pagina web, puoi importare la libreria direttamente usando una CDN come JSDeliver.

1<script src="https://cdn.jsdelivr.net/npm/web3@latest/dist/web3.min.js"></script>

Se preferisci installare la libreria per usarla nel tuo backend o in un progetto frontend che usa build, puoi installarla usando npm:

npm install web3 --save

Quindi, per importare Web3.js in uno script Node.js o in un progetto frontend Browserify, puoi usare la seguente riga di JavaScript:

1const Web3 = require("web3")
Copia

Ora che abbiamo incluso la libreria nel progetto, dobbiamo inizializzarla. Il tuo progetto deve essere in grado di comunicare con la blockchain. La maggior parte delle librerie di Ethereum comunica con un nodo tramite chiamate RPC. Per avviare il nostro provider Web3, istanzieremo un'istanza Web3 passando come costruttore l'URL del provider. Se hai un nodo o un'istanza ganache in esecuzione sul tuo computer (opens in a new tab) apparirà così:

1const web3 = new Web3("http://localhost:8545")
Copia

Se desideri accedere direttamente a un nodo ospitato, puoi trovare delle opzioni su nodi come servizio.

1const web3 = new Web3("https://cloudflare-eth.com")
Copia

Per testare di aver configurato correttamente la nostra istanza Web3, proveremo a recuperare l'ultimo numero del blocco usando la funzione getBlockNumber. Questa funzione accetta un callback come parametro e restituisce il numero del blocco come intero.

1var Web3 = require("web3")
2const web3 = new Web3("https://cloudflare-eth.com")
3
4web3.eth.getBlockNumber(function (error, result) {
5  console.log(result)
6})
Copia

Se esegui questo programma, stamperà semplicemente l'ultimo numero del blocco: la cima della blockchain. Puoi anche usare le chiamate di funzione await/async per evitare di annidare i callback nel tuo codice:

1async function getBlockNumber() {
2  const latestBlockNumber = await web3.eth.getBlockNumber()
3  console.log(latestBlockNumber)
4  return latestBlockNumber
5}
6
7getBlockNumber()
Copia

Puoi vedere tutte le funzioni disponibili sull'istanza Web3 nella documentazione ufficiale di web3.js (opens in a new tab).

La maggior parte delle librerie Web3 sono asincrone perché in background la libreria effettua chiamate JSON-RPC al nodo che restituisce il risultato.

Se stai lavorando nel browser, alcuni portafogli iniettano direttamente un'istanza Web3 e dovresti cercare di usarla ogni volta che è possibile, specialmente se prevedi di interagire con l'indirizzo Ethereum dell'utente per effettuare transazioni.

Ecco lo snippet per rilevare se un portafoglio MetaMask è disponibile e provare ad abilitarlo se lo è. In seguito ti permetterà di leggere il saldo dell'utente e di abilitarlo a convalidare le transazioni che vorresti fargli fare sulla blockchain di Ethereum:

1if (window.ethereum != null) {
2  state.web3 = new Web3(window.ethereum)
3  try {
4    // Richiedi l'accesso all'account se necessario
5    await window.ethereum.enable()
6    // Account ora esposti
7  } catch (error) {
8    // L'utente ha negato l'accesso all'account...
9  }
10}
Mostra tutto
Copia

Esistono alternative a web3.js come Ethers.js (opens in a new tab) e sono anch'esse comunemente usate. Nel prossimo tutorial vedremo come ascoltare facilmente i nuovi blocchi in arrivo sulla blockchain e vedere cosa contengono (opens in a new tab).

Ultimo aggiornamento della pagina: 21 agosto 2025

c (opens in a new tab)

n (opens in a new tab)

0 (opens in a new tab)

+10

Vedi i collaboratori