Comment connecter Core Wallet à une application Avalanche DeFi

Architecture d'intégration de portefeuille de base

1. Core Wallet fonctionne comme un fournisseur injecté conforme à EIP-1193, exposant une interface standardisée pour l'interaction dApp sur les chaînes compatibles EVM, y compris Avalanche C-Chain.

2. Le portefeuille injecte un objet Ethereum dans la portée globale de la fenêtre, permettant un accès direct à des méthodes telles que request , on et removeListener sans nécessiter de SDK externes.

3. La configuration de la chaîne spécifique à Avalanche doit être pré-enregistrée dans la liste des réseaux de Core Wallet ; les entrées manquantes déclenchent la saisie manuelle du point de terminaison RPC par les utilisateurs lors de la première connexion.

4. Les demandes de signature suivent le format de transaction EIP-1559 par défaut, avec une estimation dynamique du gaz provenant des points de terminaison RPC publics d'Avalanche tels que https://api.avax.network/ext/bc/C/rpc.

5. La prise en charge multi-chaînes est gérée via la méthode switchEthereumChain , permettant des transitions transparentes entre le réseau de test Avalanche Fuji et le réseau principal sans recharger l'interface utilisateur de dApp.

Flux de connexion front-end

1. Détectez la présence de Core Wallet à l'aide de window.ethereum?.isCore ou window.ethereum?.providers?.find(p => p.isCore) pour le distinguer de MetaMask ou d'autres portefeuilles injectés.

2. Initialisez la connexion à l'aide de ethereum.request({ method: 'eth_requestAccounts' }) , qui demande l'approbation de l'utilisateur et renvoie un tableau d'adresses autorisées.

3. Récupérez le solde du compte avec ethereum.request({ method: 'eth_getBalance', params: [address, 'latest'] }) , en analysant le résultat de la chaîne hexadécimale en décimal via la conversion BigInt .

4. Écoutez les événements de changement de réseau via ethereum.on('chainChanged', handleChainChange) , en vous assurant que l'état de dApp reflète l'ID de chaîne Avalanche actuel (43114 pour le réseau principal, 43113 pour Fuji).

5. Implémentez la gestion des déconnexions via ethereum.on('accountsChanged', handleAccountsChanged) pour détecter la révocation d'adresse ou le verrouillage du portefeuille.

Interaction du contrat Avalanche DeFi

1. Les contrats intelligents déployés sur Avalanche C-Chain nécessitent un ABI et une adresse de contrat pour instancier les objets Contract Viem ou ethers.js pour les opérations de lecture/écriture.

2. Pour les échanges de jetons sur Pangolin ou Trader Joe, construisez des paramètres de transaction à l'aide de encodeFunctionData avec les montants d'entrée exacts, la tolérance de glissement et la date limite codées selon les normes fork d'Uniswap V2.

3. Appelez eth_sendTransaction avec une charge utile signée contenant les champs to , data , value , gasLimit et maxFeePerGas validés par rapport au modèle de tarification du gaz d'Avalanche.

4. Surveillez l'état de la transaction à l'aide de l'interrogation eth_getTransactionReceipt ou de l'abonnement aux événements via ethereum.request({ method: 'eth_subscribe', params: ['newHeads'] }) .

5. Gérez les causes de réversion courantes telles qu'une liquidité insuffisante, des délais expirés ou des échecs de vérification de l'impact sur les prix en analysant les chaînes de motif de réversion intégrées dans les reçus de transaction.

Liste de contrôle de validation de sécurité

1. Confirmez que tous les appels RPC proviennent des points de terminaison officiels d'Avalanche (jamais de proxys tiers) pour empêcher le piratage DNS ou la falsification des réponses.

2. Validez les adresses de contrat par rapport à des sources vérifiées sur Snowtrace.io avant de lancer toute interaction impliquant des transferts de fonds ou des approbations.

3. Appliquez une liaison de domaine stricte en vérifiant que document.location.origin correspond aux domaines dApp sur liste blanche enregistrés dans la base de données d'autorisations interne de Core Wallet.

4. Rejetez les signatures de messages non signées si les réponses personal_sign ou eth_signTypedData_v4 ne correspondent pas aux modèles de préfixe correspondants définis dans les spécifications EIP-191 et EIP-712.

5. Désactivez l'exécution automatique des appels de contrat déclenchés par des paramètres d'URL ou des chaînes de requête, à moins qu'ils ne soient signés cryptographiquement par une paire de clés d'identité dApp connue.

Foire aux questions

Q : Core Wallet prend-il en charge les sous-réseaux Avalanche personnalisés ? Core Wallet ne prend en charge que les interactions primaires C-Chain et X-Chain ; L'intégration de sous-réseau nécessite une configuration RPC manuelle et n'est pas activée par défaut.

Q : Puis-je utiliser Core Wallet avec les L2 compatibles EVM d'Avalanche comme AvaxCanary ou NFTPort ? Oui, à condition que ces L2 exposent les points de terminaison EVM JSON-RPC standard et enregistrent leurs identifiants de chaîne dans le registre réseau de Core Wallet avant la connexion.

Q : Pourquoi ma dApp ne parvient-elle pas à détecter Core Wallet lorsque MetaMask est également installé ? Cela se produit parce que les deux portefeuilles injectent window.ethereum ; la logique de détection doit parcourir window.ethereum.providers et vérifier l'indicateur isCore au lieu de s'appuyer uniquement sur l'existence d'une propriété de niveau supérieur.

Q : La prise en charge du portefeuille matériel est-elle disponible dans Core Wallet pour les transactions Avalanche ? Core Wallet n'intègre pas nativement les appareils Ledger ou Trezor ; les utilisateurs doivent s'appuyer sur une signature basée sur un navigateur ou sur des sessions walletconnect externes acheminées via des ponts compatibles.