Comment intégrer Socios Wallet à votre dApp

Comme vous ciblez la chaîne Chiliz, assurez-vous de spécifier le bon chainId dans votre configuration :

• 88882 : Spicy Testnet

• 88888 : Chiliz Mainnet

Commencez par tester votre intégration sur le Spicy Testnet (88882), confirmez que tout se passe bien, puis passez au Chiliz Mainnet (88888).

Choisissez vos outils et frameworks

Vous pouvez vous appuyer sur divers outils externes pour mettre en place la connectivité des portefeuilles, la prise en charge de plusieurs chaînes et les fonctionnalités avancées. Choisissez votre outil en fonction de la stack technologique de votre projet.

WalletConnect (maintenant appelé Reown)

Reown est le nouveau nom de WalletConnect. La célèbre boîte à outils de connexion aux portefeuilles WalletConnect s'appelle désormais WalletKit.

Reown propose un guide étape par étape pour l'utilisation de WalletKit, et vous pouvez également consulter leur documentation complète.

Ils fournissent également un guide d'intégration du portefeuille Polkadot qui, bien que centré sur Polkadot, contient des étapes qui peuvent être appliquées de manière plus large.

REQUIS

Le Socios.com Wallet met en œuvre la norme ERC-1271, ce qui signifie que le contrat intelligent qui le sous-tend met en œuvre la méthode isValidSignature() au lieu de erecover().

Par conséquent, votre dApp DOIT supporter ERC-1271 et implémenter un appel à isValidSignature().

Voir la documentation de Reown pour plus d'informations.

RECOMMANDÉ

Pour garantir l'authenticité des connexions entre votre dApp et Socios.com Wallet (ainsi que d'autres portefeuilles), nous vous recommandons vivement d'utiliser l'API de vérification de Reown Cloud.

Pour ce faire, connectez-vous à Reown Cloud, accédez à la section « Domain verification » et indiquez le site que vous souhaitez vérifier.

RainbowKit

RainbowKit is a React library for adding wallet-connection features. It relies on viem and wagmi , and provides pre-built components for a modern, user-friendly integration flow.

View their own introduction to learn more about it.

Moralis

Moralis offre des flux d'authentification prêts à l'emploi pour les chaînes compatibles avec l'EVM (y compris Chiliz Chain si elle est configurée correctement), ainsi que des méthodes côté serveur pour valider et gérer les sessions des utilisateurs.

Si vous utilisez déjà Moralis, vous pouvez l'utiliser pour créer le bouton « Connect Wallet » de votre dApps avec plusieurs méthodes/outils :

• How to Sign in with WalletConnect

• How to Authenticate Users with RainbowKit

Ils proposent également des articles de blog sur chacun d'entre eux :

• WalletConnect Integration – How to Integrate WalletConnect

• How to Add a Sign In with RainbowKit to Your Project in 5 Steps

thirdweb

thirdweb propose Connect, un flux d'inscription flexible qui s'adapte à différentes préférences est essentiel lors de l'intégration des utilisateurs.

Vous pouvez vous appuyer sur leur documentation External Wallet, et même jouer avec leur ConnectButton playground.

Recommander Socios Wallet dans la fenêtre pop-up

Vous pouvez personnaliser l'affichage de la fenêtre contextuelle pour présenter Socios Wallet :

• Avec Reown/WalletConnect : Personnalisez la section « Portefeuille recommandé » de la fenêtre modale en utilisant l'option explorerRecommendedWalletIds.

• Avec RainbowKit : Vous pouvez créer votre propre liste de portefeuilles en utilisant l'option connectorsForWallets.

Assurer une expérience optimale pour vos utilisateurs

Pour une meilleure expérience utilisateur, nous vous recommandons de stocker l'adresse du portefeuille de l'utilisateur dans le stockage de session de votre application, ou dans le profil de l'utilisateur.

Ainsi, l'utilisateur n'aura pas à se connecter à son adresse de portefeuille à chaque fois qu'il se rendra sur votre plateforme.