Introduction. à WebBuilding un vérificateur de portefeuille Cardano avec JavaScript.

Ce projet est ma toute première application Web3, et il se connecte à la blockchain Cardano via le portefeuille Yoroi. C'est assez simple en fait, juste un moyen de vérifier le solde de votre portefeuille, mais cela marque le début de nombreux projets passionnants à venir. Je souhaite partager mon processus d'apprentissage avec vous tout au long de ce tutoriel.

? Que construisons-nous ?

Avant de commencer, soyons clairs sur ce que nous créons. Il s'agit d'un outil simple et simple qui vous permet :

• Jetez un œil au solde de n'importe quel portefeuille Cardano (légalement, bien sûr ! ?)
• Connectez-vous à votre portefeuille Yoroi
• Afficher les soldes dans ADA

? Ce dont vous aurez besoin

Connaissances de base de JavaScript (si vous pouvez console.log("hello world"), tout va bien !)

1. - Un éditeur de texte (VS Code, Sublime, ou même Notepad si vous vous sentez aventureux)
2. - L'extension du portefeuille Yoroi installée (nous en aurons besoin pour les tests)
3. - Une clé API Blockfrost (ne vous inquiétez pas, je vais vous montrer comment en obtenir une) Allons-y !

Étape 1 : configurer le projet

Créez un nouveau dossier sur votre ordinateur nommé CardanoWalletExplorer (ou junky justyk si vous préférez, le nom n'a pas vraiment d'importance). Ouvrez le dossier dans votre éditeur de code (j'utilise Visual Studio Code).
Dans le dossier, créez deux fichiers :
index.html et style.css
Maintenant, ouvrez index.html et collez ceci :

    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Cardano Wallet Explorer</title>
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css">
    <link rel="preconnect" href="https://fonts.googleapis.com">
    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap" rel="stylesheet">
    <link rel="stylesheet" href="style.css">


    <div>



<p>Let's add some style to our creation. Inside the style.css file paste this in:<br>
</p>

<pre class="brush:php;toolbar:false">:root {
    --primary-color: #0033ad;
    --secondary-color: #2a71d4;
    --accent-color: #17d1aa;
    --background-color: #f8faff;
    --card-background: #ffffff;
    --text-primary: #1a202c;
    --text-secondary: #4a5568;
    --border-color: #e2e8f0;
    --shadow: 0 4px 6px rgba(0,0,0,0.1);
}

* {
    margin: 0;
    padding: 0;
    box-sizing: border-box;
}

body {
    font-family: 'Inter', system-ui, sans-serif;
    background: var(--background-color);
    color: var(--text-primary);
    line-height: 1.5;
    min-height: 100vh;
    display: flex;
    justify-content: center;
    align-items: center;
    padding: 2rem;
}

.container {
    background: var(--card-background);
    border-radius: 1.5rem;
    box-shadow: var(--shadow);
    width: 100%;
    max-width: 800px;
    overflow: hidden;
}

.app-header {
    background: linear-gradient(135deg, var(--primary-color), var(--secondary-color));
    color: white;
    padding: 2rem;
    text-align: center;
}

.logo {
    display: flex;
    align-items: center;
    justify-content: center;
    gap: 1rem;
    margin-bottom: 0.5rem;
}

.logo i { font-size: 2rem; }
h1 { font-size: 1.8rem; font-weight: 600; }
.subtitle { opacity: 0.9; }

.content { padding: 2rem; }

.search-section {
    display: flex;
    flex-direction: column;
    align-items: center;
    gap: 1.5rem;
    margin-bottom: 2rem;
}

.search-box {
    display: flex;
    gap: 1rem;
    width: 100%;
    max-width: 600px;
}

#wallet-search {
    flex: 1;
    padding: 0.875rem 1rem;
    border: 2px solid var(--border-color);
    border-radius: 12px;
    font-size: 0.95rem;
    transition: 0.3s ease;
}

#wallet-search:focus {
    outline: none;
    border-color: var(--accent-color);
    box-shadow: 0 0 0 3px rgba(23, 209, 170, 0.1);
}

button {
    display: inline-flex;
    align-items: center;
    gap: 0.5rem;
    padding: 0.875rem 1.5rem;
    border: none;
    border-radius: 12px;
    font-size: 0.95rem;
    font-weight: 500;
    cursor: pointer;
    transition: 0.3s ease;
}

#search-button {
    background: var(--accent-color);
    color: white;
}

#search-button:hover {
    background: #15bea0;
    transform: translateY(-2px);
}

.divider {
    width: 100%;
    max-width: 600px;
    text-align: center;
    position: relative;
    color: var(--text-secondary);
}

.divider::before,
.divider::after {
    content: '';
    position: absolute;
    top: 50%;
    width: calc(50% - 2rem);
    height: 1px;
    background: var(--border-color);
}

.divider::before { left: 0; }
.divider::after { right: 0; }

.connect-button {
    background: linear-gradient(135deg, var(--primary-color), var(--secondary-color));
    color: white;
    padding: 1rem 2rem;
}

.connect-button:hover {
    transform: translateY(-2px);
    box-shadow: var(--shadow);
}

.wallet-info {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
    gap: 1.5rem;
    margin-top: 2rem;
}

.info-card {
    background: var(--card-background);
    border: 1px solid var(--border-color);
    border-radius: 1rem;
    padding: 1.5rem;
    transition: 0.3s ease;
}

.info-card:hover {
    transform: translateY(-2px);
    box-shadow: var(--shadow);
}

.card-header {
    display: flex;
    align-items: center;
    gap: 0.75rem;
    margin-bottom: 1rem;
    color: var(--text-secondary);
}

.card-header i {
    font-size: 1.25rem;
    color: var(--primary-color);
}

.card-content {
    font-size: 0.95rem;
    color: var(--text-primary);
    word-break: break-all;
}

.app-footer {
    text-align: center;
    padding: 1.5rem;
    background: var(--background-color);
    color: var(--text-secondary);
    font-size: 0.9rem;
}

.app-footer a {
    color: var(--primary-color);
    text-decoration: none;
}

.app-footer a:hover {
    text-decoration: underline;
}

@media (max-width: 640px) {
    body {
        padding: 1rem;
    }

    .container {
        border-radius: 1.5rem;
    }

    .app-header {
        padding: 1.5rem;
    }

    .content {
        padding: 1.5rem;
    }

    .search-box {
        flex-direction: column;
    }

    button {
        width: 100%;
        justify-content: center;
    }

    .wallet-info {
        grid-template-columns: 1fr;
    }
}

Étape 2 : Comment obtenir votre clé API Blockfrost ?

Afin de récupérer les soldes des portefeuilles, nous aurons besoin de Blockfrost, qui nous permet d'interagir avec la blockchain Cardano. Voici comment obtenir votre clé API :

• Allez sur Blockfrost.io et inscrivez-vous.
• Une fois connecté, cliquez sur Créer un nouveau projet.
• Choisissez Mainnet pour un véritable ADA ou Testnet pour les tests.
• Une fois le projet créé, vous obtiendrez une clé API.

Étape 3 : Le cerveau de l'opération ?

Maintenant, passons à la partie amusante, faire en sorte que tout fonctionne ! créez un fichier nommé script.js dans le dossier que nous avons créé.

function checkYoroiInstalled() {
    return window.cardano && window.cardano.yoroi;
}

? Cette fonction vérifie si l'extension du portefeuille Yoroi est installée dans votre navigateur. Window.cardano est l'objet exposé par les portefeuilles Cardano comme Yoroi. Nous vérifions si cela existe et si window.cardano.yoroi est disponible pour confirmer que le portefeuille Yoroi est installé.
Si les deux sont vrais, la fonction renvoie vrai ; sinon, il renvoie false.

    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Cardano Wallet Explorer</title>
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css">
    <link rel="preconnect" href="https://fonts.googleapis.com">
    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap" rel="stylesheet">
    <link rel="stylesheet" href="style.css">


    <div>



<p>Let's add some style to our creation. Inside the style.css file paste this in:<br>
</p>

<pre class="brush:php;toolbar:false">:root {
    --primary-color: #0033ad;
    --secondary-color: #2a71d4;
    --accent-color: #17d1aa;
    --background-color: #f8faff;
    --card-background: #ffffff;
    --text-primary: #1a202c;
    --text-secondary: #4a5568;
    --border-color: #e2e8f0;
    --shadow: 0 4px 6px rgba(0,0,0,0.1);
}

* {
    margin: 0;
    padding: 0;
    box-sizing: border-box;
}

body {
    font-family: 'Inter', system-ui, sans-serif;
    background: var(--background-color);
    color: var(--text-primary);
    line-height: 1.5;
    min-height: 100vh;
    display: flex;
    justify-content: center;
    align-items: center;
    padding: 2rem;
}

.container {
    background: var(--card-background);
    border-radius: 1.5rem;
    box-shadow: var(--shadow);
    width: 100%;
    max-width: 800px;
    overflow: hidden;
}

.app-header {
    background: linear-gradient(135deg, var(--primary-color), var(--secondary-color));
    color: white;
    padding: 2rem;
    text-align: center;
}

.logo {
    display: flex;
    align-items: center;
    justify-content: center;
    gap: 1rem;
    margin-bottom: 0.5rem;
}

.logo i { font-size: 2rem; }
h1 { font-size: 1.8rem; font-weight: 600; }
.subtitle { opacity: 0.9; }

.content { padding: 2rem; }

.search-section {
    display: flex;
    flex-direction: column;
    align-items: center;
    gap: 1.5rem;
    margin-bottom: 2rem;
}

.search-box {
    display: flex;
    gap: 1rem;
    width: 100%;
    max-width: 600px;
}

#wallet-search {
    flex: 1;
    padding: 0.875rem 1rem;
    border: 2px solid var(--border-color);
    border-radius: 12px;
    font-size: 0.95rem;
    transition: 0.3s ease;
}

#wallet-search:focus {
    outline: none;
    border-color: var(--accent-color);
    box-shadow: 0 0 0 3px rgba(23, 209, 170, 0.1);
}

button {
    display: inline-flex;
    align-items: center;
    gap: 0.5rem;
    padding: 0.875rem 1.5rem;
    border: none;
    border-radius: 12px;
    font-size: 0.95rem;
    font-weight: 500;
    cursor: pointer;
    transition: 0.3s ease;
}

#search-button {
    background: var(--accent-color);
    color: white;
}

#search-button:hover {
    background: #15bea0;
    transform: translateY(-2px);
}

.divider {
    width: 100%;
    max-width: 600px;
    text-align: center;
    position: relative;
    color: var(--text-secondary);
}

.divider::before,
.divider::after {
    content: '';
    position: absolute;
    top: 50%;
    width: calc(50% - 2rem);
    height: 1px;
    background: var(--border-color);
}

.divider::before { left: 0; }
.divider::after { right: 0; }

.connect-button {
    background: linear-gradient(135deg, var(--primary-color), var(--secondary-color));
    color: white;
    padding: 1rem 2rem;
}

.connect-button:hover {
    transform: translateY(-2px);
    box-shadow: var(--shadow);
}

.wallet-info {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
    gap: 1.5rem;
    margin-top: 2rem;
}

.info-card {
    background: var(--card-background);
    border: 1px solid var(--border-color);
    border-radius: 1rem;
    padding: 1.5rem;
    transition: 0.3s ease;
}

.info-card:hover {
    transform: translateY(-2px);
    box-shadow: var(--shadow);
}

.card-header {
    display: flex;
    align-items: center;
    gap: 0.75rem;
    margin-bottom: 1rem;
    color: var(--text-secondary);
}

.card-header i {
    font-size: 1.25rem;
    color: var(--primary-color);
}

.card-content {
    font-size: 0.95rem;
    color: var(--text-primary);
    word-break: break-all;
}

.app-footer {
    text-align: center;
    padding: 1.5rem;
    background: var(--background-color);
    color: var(--text-secondary);
    font-size: 0.9rem;
}

.app-footer a {
    color: var(--primary-color);
    text-decoration: none;
}

.app-footer a:hover {
    text-decoration: underline;
}

@media (max-width: 640px) {
    body {
        padding: 1rem;
    }

    .container {
        border-radius: 1.5rem;
    }

    .app-header {
        padding: 1.5rem;
    }

    .content {
        padding: 1.5rem;
    }

    .search-box {
        flex-direction: column;
    }

    button {
        width: 100%;
        justify-content: center;
    }

    .wallet-info {
        grid-template-columns: 1fr;
    }
}

Cette fonction formate le solde de l'ADA de manière conviviale.
Cardano utilise le lovelace comme plus petite unité (1 ADA = 1 000 000 lovelace), nous devons donc le convertir en ADA en divisant par 1 000 000.
Il garantit également que le solde est affiché avec 6 décimales (comme 1,234567 ADA), ou renvoie "0,000000" si le solde est invalide ou vide.

function checkYoroiInstalled() {
    return window.cardano && window.cardano.yoroi;
}

Nous utilisons l'API Fetch pour faire une requête GET à Blockfrost. Blockfrost fournit une API pour interagir avec la blockchain Cardano. Nous envoyons une requête GET au point final pour l'adresse de portefeuille spécifique, en utilisant une clé API pour l'autorisation. Cette fonction récupère le solde d'une adresse de portefeuille spécifique en faisant une requête à l'API de Blockfrost.

Si la réponse réussit, nous analysons les données JSON et renvoyons la quantité d'ADA dans cette adresse.
S'il y a une erreur (par exemple, une adresse invalide ou des problèmes d'API), une erreur sera générée et enregistrée dans la console. L'URL du point de terminaison inclut l'adresse du portefeuille que nous souhaitons vérifier. Assurez-vous de remplacer l'espace réservé YOUR_API_KEY dans la fonction checkWalletBalance par votre clé API.

function formatBalance(lovelaceBalance) {
    if (!lovelaceBalance || isNaN(lovelaceBalance)) {
        return "0.000000";
    }
    const adaBalance = parseFloat(lovelaceBalance) / 1_000_000;
    return adaBalance.toFixed(6);
}

• Cette fonction de mise à jour de l'interface utilisateur met à jour l'interface utilisateur (UI) avec l'adresse et le solde du portefeuille.
• Il raccourcit l'adresse pour afficher les 8 premiers et 8 derniers caractères (pour la rendre plus lisible) et l'affiche dans la carte "wallet-address".
• Il formate le solde grâce à la fonction formatBalance et l'affiche dans la carte "wallet-balance".
• Il définit également une info-bulle avec l'adresse complète lorsque vous survolez le texte de l'adresse.

**Fetching Wallet Balance Using Blockfrost API
async function checkWalletBalance(address) {
    try {
        const API_KEY = 'YOUR_API_KEY';
        const response = await fetch(`https://cardano-mainnet.blockfrost.io/api/v0/addresses/${address}`, {
            headers: {
                'project_id': API_KEY
            }
        });

        if (!response.ok) {
            throw new Error('Invalid address or API error');
        }

        const data = await response.json();
        return data.amount[0].quantity;
    } catch (error) {
        console.error('Error fetching balance:', error);
        throw error;
    }
}

Ce code attache les écouteurs d'événements aux éléments HTML :
Lorsque vous cliquez sur le bouton « Connect Yoroi Wallet », il appelle la fonction connectWallet.
Lorsque vous cliquez sur le bouton « Vérifier le solde », il appelle la fonction handleWalletSearch.
Si l'utilisateur appuie sur la touche « Entrée » dans le champ de saisie de l'adresse du portefeuille, cela déclenche également la vérification du solde.

Félicitations, vous l'avez fait ! ?

Vous êtes désormais sur le point de maîtriser le Web3 ! « Ce projet n'était pas seulement une réussite technique mais aussi une étape passionnante dans le vaste monde du développement de la blockchain ! ?
Désormais, vous pouvez vous connecter en toute transparence au portefeuille Yoroi, vérifier les soldes et mettre la puissance de la blockchain à portée de main.

? C’est l’heure des tests !

1. Installez l'extension liveserver sur vs code et assurez-vous qu'elle est en cours d'exécution en cliquant sur le bouton "passer en direct".
2. Cela devrait ouvrir le fichier HTML dans votre navigateur
3. Croisez les doigts et testez-le !

? Ce que vous avez appris de ce projet

• J'ai acquis une solide compréhension du fonctionnement des portefeuilles blockchain comme Yoroi et de leurs interactions avec les réseaux décentralisés.
• Maîtrise du processus de connexion sécurisée d'un portefeuille de navigateur à une application Web à l'aide des API window.cardano.
• Exploration de l'API Blockfrost pour récupérer les soldes des portefeuilles et les détails d'adresse de la blockchain Cardano.
• Connaissance améliorée de l'async et de l'attente, de la gestion des erreurs et du formatage des données pour garantir une expérience utilisateur fluide.
• J'ai appris à mettre à jour dynamiquement les éléments d'une page Web en fonction des données de la blockchain en temps réel.
• Compris les mécanismes de conversion des unités de crypto-monnaie de Lovelace en ADA et leur formatage pour une lisibilité par l'utilisateur.
• Reconnaissance de l'importance d'une gestion robuste des erreurs pour les requêtes API et les entrées des utilisateurs afin d'éviter les interruptions.
• Obtention d'informations précieuses sur les structures de portefeuille, la gestion des adresses et la représentation des transactions sur la blockchain.
• Implémentation de fonctionnalités telles que le chargement de spinners, d'info-bulles et d'alertes pour améliorer l'interaction des utilisateurs.
• Résolution des cas extrêmes et des défis de débogage, renforçant les compétences d'analyse et de codage.

? Idées de mise à niveau

Ce projet est un tremplin vers le monde du développement de la blockchain. Voici quelques idées pour aller plus loin :

• Ajoutez un visualiseur d'historique des transactions pour afficher les transactions passées pour une adresse de portefeuille.
• Implémentez la prise en charge de plusieurs portefeuilles, permettant aux utilisateurs de basculer entre des portefeuilles comme Yoroi, Nami ou Eternal.
• Créez un tableau de bord qui affiche les tendances de l'activité du portefeuille, y compris les résumés des transactions entrantes et sortantes.
• Intégrez des données de prix en temps réel pour afficher le solde ADA dans des devises fiduciaires comme l'USD ou l'EUR.
• Permettez la possibilité d'envoyer des ADA directement depuis l'application en intégrant des capacités de création de transactions.
• Ajoutez une bascule en mode sombre pour un design visuellement attrayant et accessible.
• Rendre l'interface réactive pour garantir la compatibilité avec les appareils mobiles.
• Incorporez de meilleurs messages d'erreur qui guident les utilisateurs dans la résolution des problèmes, tels que des adresses de portefeuille non valides.

? Comment contribuer

Ce projet est mon premier pas dans le Web3 et j'ai hâte d'apprendre des meilleurs. Votre expérience, vos idées et vos suggestions peuvent améliorer ce projet tout en m'aidant à grandir en tant que développeur. Voici comment vous pouvez contribuer :

• Forkez le projet sur GitHub et ajoutez de nouvelles fonctionnalités ou améliorations.
• Signalez les bugs ou les problèmes que vous rencontrez lors de l'utilisation de l'outil et suggérez des solutions.
• Proposez des améliorations en ouvrant une demande de fonctionnalité ou une discussion sur le dépôt GitHub.
• Rédigez une documentation détaillée pour toute nouvelle fonctionnalité que vous ajoutez, afin de la rendre facile à utiliser et à développer pour les autres.

✨ Nouvelles fonctionnalités à considérer

• Ajoutez la prise en charge du code QR pour faciliter le partage et la numérisation d'adresses de portefeuille.
• Implémentez des notifications pour des événements tels que les mises à jour de solde ou les confirmations de transactions.
• Incluez une section éducative qui explique les bases de la blockchain pour les débutants.
• Introduisez des éléments gamifiés, tels que des réalisations pour une utilisation fréquente du portefeuille ou l'exploration de nouvelles fonctionnalités.
• Développez une fonctionnalité de mise en jeu pour afficher les récompenses de mise en jeu et le statut de la délégation.

Continuons à construire et à innover : vos contributions et votre créativité peuvent façonner l’avenir de cet outil ! ?

? Besoin d'aide ?

Vous êtes coincé ? Vous avez trouvé un bug ? Envie de discuter ? Déposez un commentaire ci-dessous ou retrouvez-moi sur Twitter !
N'oubliez pas que nous avons tous commencé quelque part, et la seule question stupide est celle que vous n'avez pas posée !

Bon codage, amis explorateurs de la blockchain ! ?