> For the complete documentation index, see [llms.txt](https://docs.chiliz.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chiliz.com/fr/developper/notions-avancees/integrer-le-wallet-socios.md).

# Intégrer le wallet Socios.com dans votre dApp

Les dApps disposent généralement d'un bouton "Connect Wallet" pour déclencher une fenêtre pop-up où l'utilisateur peut sélectionner son fournisseur de portefeuille. La pop-up envoie ensuite un message au portefeuille choisi afin de vérifier que cet utilisateur est bien propriétaire de cette adresse de portefeuille.

Il existe plusieurs façons d'intégrer le Socios Wallet dans la fenêtre modale "Connect Wallet" de votre dApp. En vous appuyant sur des outils reconnus, vous pouvez offrir une expérience sécurisée et fluide qui fonctionne avec plusieurs fournisseurs de portefeuilles (tels que MetaMask et d'autres) et sur plusieurs chaînes, notamment Chiliz Chain (Spicy Testnet et Chiliz Mainnet).

Cette page a pour objectif de vous présenter diverses options parmi lesquelles choisir.

{% hint style="info" %}
Parce que vous ciblez Chiliz Chain, assurez-vous de spécifier le bon `chainId` dans votre configuration :

* 88882 : Spicy Testnet
* 88888 : Chiliz Mainnet

Commencez par tester votre intégration sur Spicy Testnet (88882), confirmez que tout fonctionne correctement, et seulement ensuite passez à Chiliz Mainnet (88888).

Voir tous les paramètres ici : [Se connecter à Chiliz Chain](/fr/developper/notions-de-base/se-connecter-a-chiliz-chain.md)
{% endhint %}

## Choisir vos bibliothèques et frameworks

Vous pouvez tirer parti de divers outils externes pour rationaliser la connectivité des portefeuilles, le support multi-chaînes et les fonctionnalités avancées. Choisissez votre outil en fonction de la pile technologique de votre projet.

### Reown (anciennement WalletConnect)

{% hint style="info" %}
[Reown](https://reown.com/) est le [nom](https://reown.com/blog/walletconnect-is-now-reown) de WalletConnect Inc. depuis 2024.\
Le toolkit de connexion de portefeuilles WalletConnect bien connu s'appelle désormais [Reown SDK](https://reown.com/reown-sdk) (ou AppKit). Il était auparavant connu sous le nom de Web3Modal.
{% endhint %}

Reown dispose d'un [guide étape par étape pour utiliser AppKit](https://docs.reown.com/appkit/networks/evm#get-started), et vous devriez également lire [leur documentation complète](https://docs.reown.com/appkit/overview).

{% hint style="warning" %}
**REQUIS**

Le Socios.com Wallet implémente le standard [ERC-1271](https://eips.ethereum.org/EIPS/eip-1271), ce qui signifie que le smart contract derrière lui implémente la méthode `isValidSignature()` au lieu de `erecover()`.

Par conséquent, votre dApp DOIT prendre en charge l'ERC-1271 et implémenter un appel à `isValidSignature()`.

Voir [la doc Reown](https://docs.reown.com/advanced/api/sign/smart-contract-wallet-usage#messages) pour plus d'informations.
{% endhint %}

### RainbowKit

[RainbowKit](https://rainbowkit.com/) est une bibliothèque React pour ajouter des fonctionnalités de connexion de portefeuille. Elle s'appuie sur [viem](https://viem.sh/) et [Wagmi](https://wagmi.sh/), et fournit des composants préconstruits pour un flux d'intégration moderne et convivial.

Consultez [leur propre introduction](https://rainbowkit.com/docs/introduction) pour en savoir plus.

### Moralis

[Moralis](https://docs.moralis.com/) propose des flux d'authentification prêts à l'emploi pour les chaînes compatibles EVM (y compris Chiliz Chain si correctement configuré), ainsi que des méthodes côté serveur pour valider et gérer les sessions utilisateurs.

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

* [Comment authentifier les utilisateurs avec WalletConnect](https://docs.moralis.com/get-started/tutorials/auth-api/authenticate-users-with-wallet-connect)
* [Comment authentifier les utilisateurs avec RainbowKit](https://docs.moralis.com/get-started/tutorials/auth-api/authenticate-users-with-rainbow-kit)
* [Comment authentifier les utilisateurs avec Magic.Link](https://docs.moralis.com/get-started/tutorials/auth-api/authenticate-users-with-magic-link)
* etc.

Ils ont également des articles de blog détaillés sur chacun :

* [WalletConnect Integration – How to Integrate WalletConnect](https://developers.moralis.com/walletconnect-integration-how-to-integrate-walletconnect/)
* [How to Add a Sign In with RainbowKit to Your Project in 5 Steps](https://developers.moralis.com/how-to-add-a-sign-in-with-rainbowkit-to-your-project-in-5-steps/)

### thirdweb

[thirdweb](https://portal.thirdweb.com/) propose [Connect](https://thirdweb.com/learn/guides/thirdweb-connect-explained), un flux d'inscription flexible qui prend en charge différentes préférences, essentiel lors de l'onboarding des utilisateurs.

Vous pouvez vous appuyer sur leur [documentation Wallets](https://portal.thirdweb.com/connect/wallet/sign-in-methods/external-wallets), et même jouer avec leur [playground ConnectButton](https://playground.thirdweb.com/connect/sign-in/button).

## Recommander le Socios.com Wallet dans la fenêtre modale pop-up

Vous pouvez personnaliser l'affichage de la fenêtre modale pop-up pour mettre en avant le Socios.com Wallet :

* Avec Reown/WalletConnect : Personnalisez la section "Recommended Wallet" de la modale en utilisant l'option [`explorerRecommendedWalletIds`](https://docs.reown.com/advanced/walletconnectmodal/options#explorerrecommendedwalletids-optional).
* Avec RainbowKit : Vous pouvez créer votre propre liste de portefeuilles en utilisant l'option [`connectorsForWallets`](https://www.rainbowkit.com/docs/custom-wallet-list).

## Assurer une expérience optimale pour vos utilisateurs

Pour une meilleure expérience utilisateur, nous vous recommandons de stocker l'adresse de portefeuille de l'utilisateur dans le stockage de session de votre dApp, ou dans le profil utilisateur. Ainsi, l'utilisateur n'aura pas à se connecter à son adresse de portefeuille à chaque fois qu'il visite votre plateforme.

## Méthodes supportées

Le Socios.com Wallet prend en charge les méthodes suivantes :

* `eth_sendTransaction`
* `eth_signTransaction`
* `personal_sign`

Nous prévoyons d'ajouter les méthodes suivantes prochainement :

* `eth_signTypedData`
* `eth_signTypedData_v4`

## Vérification SIWE

Si vous souhaitez utiliser le Socios.com Wallet pour l'authentification via [SIWE](https://eips.ethereum.org/EIPS/eip-4361), veuillez noter que le Socios.com Wallet est un portefeuille SCA plutôt qu'un portefeuille EOA classique.\
\&#xNAN;*L'écosystème Ethereum comprend deux types de comptes principaux : les Smart Contract Accounts (SCAs) et les Externally Owned Accounts (EOAs).*

Alors que la signature pour les portefeuilles EOA peut être vérifiée avec `ecrecover` (par exemple en utilisant `ethers.utils.verifyMessage`), le standard EIP-1271 (que le Socios.com Wallet utilise) nécessite d'appeler la méthode `isValidSignature` du contrat pour la vérifier.

Donc lors de l'authentification d'un compte, vous devez d'abord vérifier si l'adresse est un contrat, puis choisir la méthode de vérification appropriée en fonction de ce résultat.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.chiliz.com/fr/developper/notions-avancees/integrer-le-wallet-socios.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
