Vai al contenuto principale

Inviare transazioni usando Web3

transazioni
web3.js
Alchemy
Principiante
Elan Halpern
4 novembre 2020
10 minuti di lettura

Questa è una guida per principianti su come inviare transazioni su Ethereum usando Web3. Ci sono tre passaggi principali per inviare una transazione alla blockchain di Ethereum: creare, firmare e trasmettere. Li esamineremo tutti e tre, sperando di rispondere a qualsiasi domanda tu possa avere! In questo tutorial, useremo Alchemy (opens in a new tab) per inviare le nostre transazioni alla catena di Ethereum. Puoi creare un account Alchemy gratuito qui (opens in a new tab).

NOTA: Questa guida serve per firmare le tue transazioni sul backend per la tua app. Se vuoi integrare la firma delle tue transazioni sul frontend, dai un'occhiata all'integrazione di Web3 con un provider del browser (opens in a new tab).

Le basi

Come la maggior parte degli sviluppatori blockchain agli inizi, potresti aver fatto delle ricerche su come inviare una transazione (qualcosa che dovrebbe essere piuttosto semplice) e ti sei imbattuto in una pletora di guide, ognuna delle quali dice cose diverse lasciandoti un po' sopraffatto e confuso. Se sei in questa situazione, non preoccuparti; ci siamo passati tutti a un certo punto! Quindi, prima di iniziare, chiariamo alcune cose:

1. Alchemy non memorizza le tue chiavi private

  • Questo significa che Alchemy non può firmare e inviare transazioni per tuo conto. Il motivo è per scopi di sicurezza. Alchemy non ti chiederà mai di condividere la tua chiave privata, e non dovresti mai condividere la tua chiave privata con un nodo ospitato (o con chiunque altro, se è per questo).
  • Puoi leggere dalla blockchain usando l'API principale di Alchemy, ma per scriverci dovrai usare qualcos'altro per firmare le tue transazioni prima di inviarle tramite Alchemy (questo vale per qualsiasi altro servizio di nodi).

2. Cos'è un "firmatario" (signer)?

  • I firmatari firmeranno le transazioni per te usando la tua chiave privata. In questo tutorial useremo Alchemy web3 (opens in a new tab) per firmare la nostra transazione, ma potresti anche usare qualsiasi altra libreria web3.
  • Sul frontend, un buon esempio di firmatario sarebbe MetaMask (opens in a new tab), che firmerà e invierà transazioni per tuo conto.

3. Perché devo firmare le mie transazioni?

  • Ogni utente che vuole inviare una transazione sulla rete di Ethereum deve firmare la transazione (usando la propria chiave privata), al fine di convalidare che l'origine della transazione sia chi afferma di essere.
  • È importantissimo proteggere questa chiave privata, poiché avervi accesso garantisce il pieno controllo sul tuo account Ethereum, consentendo a te (o a chiunque vi abbia accesso) di eseguire transazioni per tuo conto.

4. Come proteggo la mia chiave privata?

  • Ci sono molti modi per proteggere la tua chiave privata e usarla per inviare transazioni. In questo tutorial useremo un file .env. Tuttavia, potresti anche usare un provider separato che memorizza le chiavi private, usare un file keystore o altre opzioni.

5. Qual è la differenza tra eth_sendTransaction ed eth_sendRawTransaction?

eth_sendTransaction ed eth_sendRawTransaction sono entrambe funzioni dell'API di Ethereum che trasmettono una transazione alla rete di Ethereum in modo che venga aggiunta a un blocco futuro. Differiscono nel modo in cui gestiscono la firma delle transazioni.

Quando si usa web3, si accede a eth_sendRawTransaction chiamando la funzione web3.eth.sendSignedTransaction (opens in a new tab).

Questo è ciò che useremo in questo tutorial.

6. Cos'è la libreria web3?

Ok, ora che abbiamo tolto di mezzo alcune di queste domande, passiamo al tutorial. Sentiti libero di fare domande in qualsiasi momento nel discord (opens in a new tab) di Alchemy!

7. Come inviare transazioni sicure, ottimizzate per il gas e private?

NOTA: Questa guida richiede un account Alchemy, un indirizzo Ethereum o un portafoglio MetaMask, NodeJs e npm installati. In caso contrario, segui questi passaggi:

  1. Crea un account Alchemy gratuito (opens in a new tab)
  2. Crea un account MetaMask (opens in a new tab) (o ottieni un indirizzo Ethereum)
  3. Segui questi passaggi per installare NodeJs e NPM (opens in a new tab)

Passaggi per inviare la tua transazione

1. Crea un'app Alchemy sulla rete di test Sepolia

Naviga nella tua Dashboard di Alchemy (opens in a new tab) e crea una nuova app, scegliendo Sepolia (o qualsiasi altra rete di test) per la tua rete.

2. Richiedi ETH dal rubinetto di Sepolia

Segui le istruzioni sul rubinetto Sepolia di Alchemy (opens in a new tab) per ricevere ETH. Assicurati di includere il tuo indirizzo Ethereum di Sepolia (da MetaMask) e non di un'altra rete. Dopo aver seguito le istruzioni, ricontrolla di aver ricevuto gli ETH nel tuo portafoglio.

3. Crea una nuova directory di progetto ed entraci con cd

Crea una nuova directory di progetto dalla riga di comando (terminale per Mac) e naviga al suo interno:

1mkdir sendtx-example
2cd sendtx-example

4. Installa Alchemy Web3 (o qualsiasi libreria web3)

Esegui il seguente comando nella tua directory di progetto per installare Alchemy Web3 (opens in a new tab):

Nota, se desideri usare la libreria ethers.js, segui le istruzioni qui (opens in a new tab).

1npm install @alch/alchemy-web3

5. Installa dotenv

Useremo un file .env per memorizzare in modo sicuro la nostra chiave API e la chiave privata.

1npm install dotenv --save

6. Crea il file .env

Crea un file .env nella tua directory di progetto e aggiungi quanto segue (sostituendo "your-api-url" e "your-private-key")

  • Per trovare l'URL della tua API di Alchemy, naviga nella pagina dei dettagli dell'app che hai appena creato sulla tua dashboard, clicca su "View Key" nell'angolo in alto a destra e prendi l'URL HTTP.
  • Per trovare la tua chiave privata usando MetaMask, dai un'occhiata a questa guida (opens in a new tab).
1API_URL = "your-api-url"
2PRIVATE_KEY = "your-private-key"

7. Crea il file sendTx.js

Ottimo, ora che abbiamo i nostri dati sensibili protetti in un file .env, iniziamo a programmare. Per il nostro esempio di invio di transazione, invieremo ETH indietro al rubinetto di Sepolia.

Crea un file sendTx.js, che è dove configureremo e invieremo la nostra transazione di esempio, e aggiungi le seguenti righe di codice:

1async function main() {
2    require('dotenv').config();
3    const { API_URL, PRIVATE_KEY } = process.env;
4    const { createAlchemyWeb3 } = require("@alch/alchemy-web3");
5    const web3 = createAlchemyWeb3(API_URL);
6    const myAddress = '0x610Ae88399fc1687FA7530Aac28eC2539c7d6d63' //TODO: replace this address with your own public address
7
8    const nonce = await web3.eth.getTransactionCount(myAddress, 'latest'); // nonce starts counting from 0
9
10    const transaction = {
11     'to': '0x31B98D14007bDEe637298086988A0bBd31184523', // faucet address to return eth
12     'value': 1000000000000000000, // 1 ETH
13     'gas': 30000,
14     'nonce': nonce,
15     // optional data field to send message or execute smart contract
16    };
17
18    const signedTx = await web3.eth.accounts.signTransaction(transaction, PRIVATE_KEY);
19
20    web3.eth.sendSignedTransaction(signedTx.rawTransaction, function(error, hash) {
21    if (!error) {
22      console.log("🎉 The hash of your transaction is: ", hash, "\n Check Alchemy's Mempool to view the status of your transaction!");
23    } else {
24      console.log("❗Something went wrong while submitting your transaction:", error)
25    }
26   });
27}
28
29main();
Mostra tutto

Assicurati di sostituire l'indirizzo alla riga 6 con il tuo indirizzo pubblico.

Ora, prima di passare all'esecuzione di questo codice, parliamo di alcuni dei componenti qui presenti.

  • nonce : La specifica del nonce è usata per tenere traccia del numero di transazioni inviate dal tuo indirizzo. Ne abbiamo bisogno per scopi di sicurezza e per prevenire attacchi di replay (opens in a new tab). Per ottenere il numero di transazioni inviate dal tuo indirizzo usiamo getTransactionCount (opens in a new tab).
  • transaction: L'oggetto della transazione ha alcuni aspetti che dobbiamo specificare
    • to: Questo è l'indirizzo a cui vogliamo inviare ETH. In questo caso, stiamo inviando ETH indietro al rubinetto di Sepolia (opens in a new tab) da cui li avevamo inizialmente richiesti.
    • value: Questo è l'importo che desideriamo inviare, specificato in Wei dove 10^18 Wei = 1 ETH
    • gas: Ci sono molti modi per determinare la giusta quantità di gas da includere nella tua transazione. Alchemy ha persino un webhook per il prezzo del gas (opens in a new tab) per avvisarti quando il prezzo del gas scende entro una certa soglia. Per le transazioni sulla rete principale, è buona norma controllare uno stimatore di gas come ETH Gas Station (opens in a new tab) per determinare la giusta quantità di gas da includere. 21000 è la quantità minima di gas che un'operazione su Ethereum userà, quindi per assicurarci che la nostra transazione venga eseguita mettiamo 30000 qui.
    • nonce: vedi la definizione di nonce sopra. Il nonce inizia a contare da zero.
    • [OPZIONALE] data: Usato per inviare informazioni aggiuntive con il tuo trasferimento, o per chiamare un contratto intelligente, non richiesto per i trasferimenti di saldo, dai un'occhiata alla nota qui sotto.
  • signedTx: Per firmare il nostro oggetto transazione useremo il metodo signTransaction con la nostra PRIVATE_KEY
  • sendSignedTransaction: Una volta che abbiamo una transazione firmata, possiamo inviarla per essere inclusa in un blocco successivo usando sendSignedTransaction

Una nota sui dati (data) Ci sono due tipi principali di transazioni che possono essere inviate su Ethereum.

  • Trasferimento di saldo: Invia ETH da un indirizzo a un altro. Nessun campo dati richiesto, tuttavia, se desideri inviare informazioni aggiuntive insieme alla tua transazione, puoi includere tali informazioni in formato HEX in questo campo.
    • Ad esempio, supponiamo di voler scrivere l'hash di un documento IPFS sulla catena di Ethereum al fine di dargli un timestamp immutabile. Il nostro campo dati dovrebbe quindi apparire come data: web3.utils.toHex(‘IPFS hash‘). E ora chiunque può interrogare la catena e vedere quando quel documento è stato aggiunto.
  • Transazione di contratto intelligente: Esegui del codice di un contratto intelligente sulla catena. In questo caso, il campo dati dovrebbe contenere la funzione intelligente che desideri eseguire, insieme a eventuali parametri.

8. Esegui il codice usando node sendTx.js

Torna al tuo terminale o riga di comando ed esegui:

1node sendTx.js

9. Vedi la tua transazione nella Mempool

Apri la pagina Mempool (opens in a new tab) nella tua dashboard di Alchemy e filtra per l'app che hai creato per trovare la tua transazione. È qui che possiamo osservare la nostra transazione passare dallo stato in sospeso (pending) allo stato minato (mined) (se ha successo) o allo stato scartato (dropped) se non ha successo. Assicurati di mantenerlo su "All" in modo da catturare le transazioni "mined", "pending" e "dropped". Puoi anche cercare la tua transazione cercando le transazioni inviate all'indirizzo 0x31b98d14007bdee637298086988a0bbd31184523 .

Per visualizzare i dettagli della tua transazione una volta trovata, seleziona l'hash della transazione (tx hash), che dovrebbe portarti a una vista simile a questa:

Screenshot del visualizzatore della mempool

Da lì puoi visualizzare la tua transazione su Etherscan cliccando sull'icona cerchiata in rosso!

Evviva! Hai appena inviato la tua prima transazione su Ethereum usando Alchemy 🎉

Per feedback e suggerimenti su questa guida, invia un messaggio a Elan sul Discord (opens in a new tab) di Alchemy!

Pubblicato originariamente su https://docs.alchemyapi.io/tutorials/sending-transactions-using-web3-and-alchemy (opens in a new tab)

Ultimo aggiornamento della pagina: 18 dicembre 2025

litvintechl (opens in a new tab)
JoeChenJJ (opens in a new tab)
nhszn (opens in a new tab)
+16

Questo tutorial è stato utile?