Integrar a carteira Socios.com em sua dApp

Integre a Carteira Socios.com no fluxo de Conectar Carteira do seu dApp na Chiliz Chain usando Reown AppKit ou WalletConnect, com Chain IDs 88888 (Mainnet) e 88882 (Spicy Testnet).

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.

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

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)

A Reown é o nome da WalletConnect Inc. desde 2024. O conhecido toolkit de conexão de carteira WalletConnect agora se chama Reown SDK (ou AppKit). Antes era conhecido como Web3Modal.

A Reown tem um guia passo a passo para usar o AppKit, e você também deve ler a documentação completa deles.

OBRIGATÓRIO

A Carteira Socios.com implementa o padrão ERC-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 para mais detalhes.

RainbowKit

O RainbowKit é uma biblioteca React para adicionar recursos de conexão de carteira. Ele depende de viem e Wagmi e fornece componentes pré-construídos para um fluxo de integração moderno e fácil de usar.

Veja a introdução deles para saber mais.

Moralis

A Moralis 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

• Como autenticar usuários com RainbowKit

• Como autenticar usuários com Magic.Link

• etc.

Eles também têm posts detalhados sobre cada um:

• WalletConnect Integration – How to Integrate WalletConnect

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

thirdweb

O thirdweb oferece o Connect, 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 e até experimentar o playground do ConnectButton.

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.

• Com RainbowKit: Você pode construir sua própria lista de carteiras usando a opção connectorsForWallets.

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, observe que a Carteira Socios.com é uma carteira SCA e não uma carteira EOA regular. 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.