> 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/pt-br/desenvolver/avancado/integrar-carteira-socios.md). # Integrar a carteira Socios.com em sua dApp Os dApps tipicamente têm um botão "Conectar Carteira" para acionar uma janela pop-up onde o usuário pode selecionar seu provedor de carteira. O pop-up então envia uma mensagem à carteira escolhida para verificar que o usuário é mesmo o proprietário daquele endereço. Há várias formas de integrar a Carteira Socios no modal pop-up "Conectar Carteira" do seu dApp. Ao depender de ferramentas consagradas, você pode oferecer uma experiência segura e fluida que funciona com múltiplos provedores de carteira (como MetaMask e outros) e redes, incluindo a Chiliz Chain (tanto Spicy Testnet quanto Chiliz Mainnet). Esta página visa apresentar diversas opções para você escolher. {% hint style="info" %} Como você está mirando na Chiliz Chain, certifique-se de especificar o `chainId` correto em sua configuração: * 88882: Spicy Testnet * 88888: Chiliz Mainnet Comece testando sua integração na Spicy Testnet (88882), confirme que tudo funciona bem e só então mova para a Chiliz Mainnet (88888). Veja todos os parâmetros aqui: [Conectar à Chiliz Chain](/pt-br/desenvolver/basico/conectar-a-chiliz-chain.md) {% endhint %} ## Escolha suas bibliotecas e frameworks Você pode usar diversas ferramentas externas para simplificar a conectividade de carteiras, suporte multi-chain e recursos avançados. Escolha sua ferramenta com base na stack tecnológica do seu projeto. ### Reown (anteriormente WalletConnect) {% hint style="info" %} A [Reown](https://reown.com/) é o [nome](https://reown.com/blog/walletconnect-is-now-reown) da WalletConnect Inc. desde 2024.\ O conhecido toolkit de conexão de carteira WalletConnect agora se chama [Reown SDK](https://reown.com/reown-sdk) (ou AppKit). Antes era conhecido como Web3Modal. {% endhint %} A Reown tem um [guia passo a passo para usar o AppKit](https://docs.reown.com/appkit/networks/evm#get-started), e você também deve ler a [documentação completa deles](https://docs.reown.com/appkit/overview). {% hint style="warning" %} **OBRIGATÓRIO** A Carteira Socios.com implementa o padrão [ERC-1271](https://eips.ethereum.org/EIPS/eip-1271), o que significa que o smart contract por trás dela implementa o método `isValidSignature()` em vez de `erecover()`. Portanto, seu dApp DEVE suportar ERC-1271 e implementar uma chamada a `isValidSignature()`. Veja a [documentação da Reown](https://docs.reown.com/advanced/api/sign/smart-contract-wallet-usage#messages) para mais detalhes. {% endhint %} ### RainbowKit O [RainbowKit](https://rainbowkit.com/) é uma biblioteca React para adicionar recursos de conexão de carteira. Ele depende de [viem](https://viem.sh/) e [Wagmi](https://wagmi.sh/) e fornece componentes pré-construídos para um fluxo de integração moderno e fácil de usar. Veja a [introdução deles](https://rainbowkit.com/docs/introduction) para saber mais. ### Moralis A [Moralis](https://docs.moralis.com/) oferece fluxos de autenticação prontos para redes compatíveis com EVM (incluindo a Chiliz Chain se configurada corretamente), além de métodos do lado do servidor para validar e gerenciar sessões de usuário. Se você já usa a Moralis, pode usá-la para criar o botão "Conectar Carteira" do seu dApp com vários métodos/ferramentas: * [Como autenticar usuários com WalletConnect](https://docs.moralis.com/get-started/tutorials/auth-api/authenticate-users-with-wallet-connect) * [Como autenticar usuários com RainbowKit](https://docs.moralis.com/get-started/tutorials/auth-api/authenticate-users-with-rainbow-kit) * [Como autenticar usuários com Magic.Link](https://docs.moralis.com/get-started/tutorials/auth-api/authenticate-users-with-magic-link) * etc. Eles também têm posts detalhados sobre cada um: * [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 O [thirdweb](https://portal.thirdweb.com/) oferece o [Connect](https://thirdweb.com/learn/guides/thirdweb-connect-explained), um fluxo de cadastro flexível que acomoda diferentes preferências — essencial ao integrar usuários. Você pode usar a [documentação de Wallets deles](https://portal.thirdweb.com/connect/wallet/sign-in-methods/external-wallets) e até experimentar o [playground do ConnectButton](https://playground.thirdweb.com/connect/sign-in/button). ## Recomende a Carteira Socios.com no modal pop-up Você pode personalizar a exibição do modal pop-up para destacar a Carteira Socios.com: * Com Reown/WalletConnect: Personalize a seção "Recommended Wallet" do modal usando a opção [`explorerRecommendedWalletIds`](https://docs.reown.com/advanced/walletconnectmodal/options#explorerrecommendedwalletids-optional). * Com RainbowKit: Você pode construir sua própria lista de carteiras usando a opção [`connectorsForWallets`](https://www.rainbowkit.com/docs/custom-wallet-list). ## Garanta uma experiência ideal para seus usuários Para uma melhor experiência do usuário, recomendamos armazenar o endereço de carteira do usuário no armazenamento de sessão do seu dApp ou no perfil do usuário. Assim, o usuário não precisará conectar sua carteira toda vez que acessar sua plataforma. ## Métodos suportados A Carteira Socios.com suporta os seguintes métodos: * `eth_sendTransaction` * `eth_signTransaction` * `personal_sign` Planejamos suportar os seguintes métodos em breve: * `eth_signTypedData` * `eth_signTypedData_v4` ## Verificação SIWE Se você deseja usar a Carteira Socios.com para autenticar usando [SIWE](https://eips.ethereum.org/EIPS/eip-4361), observe que a Carteira Socios.com é uma carteira SCA e não uma carteira EOA regular.\ \&#xNAN;*O ecossistema Ethereum inclui dois tipos principais de conta: Smart Contract Accounts (SCAs) e Externally Owned Accounts (EOAs).* Enquanto a assinatura de carteiras EOA pode ser verificada com `ecrecover` (ex.: usando `ethers.utils.verifyMessage`), o padrão EIP-1271 (que a Carteira Socios.com usa) requer chamar o método `isValidSignature` do contrato para verificá-la. Portanto, ao autenticar uma conta, você precisa primeiro verificar se o endereço é um contrato e, dependendo disso, escolher o método de verificação adequado. --- # 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/pt-br/desenvolver/avancado/integrar-carteira-socios.md?ask=&goal= ``` `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.