Intégrer des portefeuilles
Mettez en œuvre la logique de connexion aux portefeuilles afin que les utilisateurs puissent connecter MetaMask ou d’autres portefeuilles à votre DApp pour signer des transactions.
Intégrer des portefeuilles est une leçon Web3 & DApp Development Fundamentals gratuite sur CoddyKit. Ceci est la leçon 2 sur 3. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Web3 & DApp Development Fundamentals, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Web3 & DApp Development Fundamentals comprend 3 leçons au total.
Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.
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 immediatelyDisplaying 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.ethereumis 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.selectedAddresson 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.
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.
Questions Fréquemment Posées
La leçon « Intégrer des portefeuilles » est-elle gratuite ?
Oui — le texte complet de « Intégrer des portefeuilles » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Web3 & DApp Development Fundamentals, passe à CoddyKit PRO. Le cours Web3 & DApp Development Fundamentals comprend 3 leçons au total.
Qu'est-ce que j'apprendrai dans « Intégrer des portefeuilles » ?
Mettez en œuvre la logique de connexion aux portefeuilles afin que les utilisateurs puissent connecter MetaMask ou d’autres portefeuilles à votre DApp pour signer des transactions. Tu pratiques Web3 & DApp Development Fundamentals avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Web3 & DApp Development Fundamentals ?
Aucune expérience préalable n'est requise. Web3 & DApp Development Fundamentals sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 3.
Combien de temps prend la leçon « Intégrer des portefeuilles » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Web3 & DApp Development Fundamentals ?
Oui. Chaque leçon Web3 & DApp Development Fundamentals inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- React et frameworks Web3
- Intégrer des portefeuilles
- Gérer les transactions et les événements