Web3 & DApp Development Fundamentals · Lezione

Integrazione dei wallet

Implementi la logica di connessione dei wallet, consentendo agli utenti di collegare MetaMask o altri wallet alla Sua DApp per firmare le transazioni.

Lezione 2 di 312 passaggi

Integrazione dei wallet è una lezione Web3 & DApp Development Fundamentals gratuita su CoddyKit. Questa è la lezione 2 di 3. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Web3 & DApp Development Fundamentals, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Web3 & DApp Development Fundamentals include 3 lezioni in totale.

Parti di questa lezione non sono ancora state tradotte e vengono mostrate in inglese.

The Gateway to Web3

Decentralized Applications (DApps) need a way for users to interact with the blockchain. Wallets like MetaMask serve as this crucial bridge, securely managing cryptographic keys and signing transactions.

Connecting a wallet allows your DApp to:

Read the user's blockchain address.
Request transaction approvals from the user.
Interact with smart contracts on behalf of the user.

Your DApp's Blockchain Interface

When a Web3 wallet (like MetaMask) is installed in a user's browser, it injects a special object into the browser's JavaScript environment: window.ethereum.

This window.ethereum object is your DApp's primary interface to communicate with the blockchain and the user's wallet. It provides an API to send requests and listen for events.

Is a Wallet Present?

Before trying to connect, your DApp should always check if window.ethereum exists. If it's not present, the user likely doesn't have a Web3 wallet installed, or it's not enabled.

You can then prompt them to install one, usually MetaMask, which is the most common.

if (window.ethereum) {
  console.log("MetaMask detected!");
} else {
  console.log("Please install MetaMask to use this DApp.");
}

Asking for Connection Permission

To get the user's blockchain address and enable transaction signing, your DApp must explicitly request access. This is done using the eth_requestAccounts method via the window.ethereum object.

This action will trigger a pop-up in the user's wallet, asking them to approve the connection. If approved, it returns an array of account addresses, typically just one.

Building a Connect Function

Let's create a simple JavaScript function to connect a user's wallet. This code assumes it runs in a browser environment where window.ethereum might be available.

async function connectWallet() {
  if (window.ethereum) {
    try {
      const accounts = await window.ethereum.request({ method: 'eth_requestAccounts' });
      console.log('Connected account:', accounts[0]);
      alert(`Wallet connected! Account: ${accounts[0]}`);
      return accounts[0];
    } catch (error) {
      if (error.code === 4001) {
        console.log('User rejected connection.');
        alert('Connection rejected by user.');
      } else {
        console.error('Connection error:', error);
      }
    }
  } else {
    console.log('MetaMask not detected. Please install it!');
    alert('MetaMask not detected. Please install it to use this DApp.');
  }
  return null;
}

// In a real DApp, you'd call this function, e.g., on a button click:
// connectWallet(); // Uncomment to try connecting immediately

Displaying the Connected Account

Once the user successfully connects their wallet, the eth_requestAccounts method returns an array of their connected accounts. The first account accounts[0] is typically the user's currently selected address.

It's good practice to display this address in your DApp's UI to confirm the connection to the user. You can also get the currently selected address using window.ethereum.selectedAddress after a connection is established.

Staying Up-to-Date: Account Changes

Users can change their connected account, switch networks, or even disconnect their wallet at any time. Your DApp needs to react to these changes to maintain a consistent state and provide a good user experience.

The window.ethereum object emits events for these situations. The accountsChanged event is crucial for detecting when the user switches accounts or disconnects.

Reacting to Account Events

Here's how to set up an event listener to update your DApp when the user changes their active account in MetaMask. This code would typically run after your DApp has initialized.

if (window.ethereum) {
  window.ethereum.on('accountsChanged', (accounts) => {
    if (accounts.length === 0) {
      console.log('User disconnected all accounts.');
      alert('Wallet disconnected!');
      // Update UI to 'Not Connected' or prompt to connect
    } else {
      console.log('Switched account to:', accounts[0]);
      alert(`Account changed to: ${accounts[0]}`);
      // Update UI with new account address
    }
  });
  console.log("Listening for 'accountsChanged' events.");
} else {
  console.log("MetaMask not detected, cannot listen for account changes.");
}

Adapting to Network Changes

DApps often operate on specific blockchain networks (e.g., Ethereum Mainnet, Sepolia Testnet). Users might switch networks using their wallet interface.

Your DApp should listen for the chainChanged event to react to these network switches. If the user switches to an unsupported network, you might prompt them to switch back or disable DApp functionality until they do.

Robust Wallet Integration Tips

To build a robust and user-friendly DApp, consider these best practices:

Prompt Installation: If window.ethereum is missing, provide a clear link for users to install MetaMask.
User Feedback: Always show loading states or connection status in your UI.
Error Handling: Catch errors from eth_requestAccounts, especially user rejections (error.code === 4001).
Reconnect on Load: Consider checking for ethereum.selectedAddress on page load to auto-reconnect if the user previously granted permission.

Quick Check: Wallet Connection

When building a DApp, interacting with a user's wallet is fundamental. Consider the initial steps a DApp needs to take to connect with a user's MetaMask wallet.

Rispondi nella lezione interattiva

Recap: Integrating Wallets

In this lesson, you learned how to integrate a Web3 wallet like MetaMask into your DApp. We covered checking for the window.ethereum object, requesting account access with eth_requestAccounts, and handling important events like accountsChanged.

Mastering wallet integration is crucial for building interactive and functional decentralized applications, allowing users to connect their identity and sign transactions on the blockchain.

Gratis per iniziare

Impara Web3 & DApp Development Fundamentals con un tutor IA — gratis

Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.

Corsi: 29
Lezioni: 105

Inizia a imparare gratis Visualizza il corso completo

Domande Frequenti

La lezione «Integrazione dei wallet» è gratuita?

Sì — il testo completo di «Integrazione dei wallet» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Web3 & DApp Development Fundamentals, passa a CoddyKit PRO. Il corso Web3 & DApp Development Fundamentals include 3 lezioni in totale.

Cosa imparerò in «Integrazione dei wallet»?

Implementi la logica di connessione dei wallet, consentendo agli utenti di collegare MetaMask o altri wallet alla Sua DApp per firmare le transazioni. Eserciti Web3 & DApp Development Fundamentals con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Web3 & DApp Development Fundamentals?

Non è richiesta alcuna esperienza precedente. Web3 & DApp Development Fundamentals su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 3.

Quanto tempo richiede la lezione «Integrazione dei wallet»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Web3 & DApp Development Fundamentals?

Sì. Ogni lezione Web3 & DApp Development Fundamentals include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Web3 & DApp Development Fundamentals