> 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/pl/tworzenie/zaawansowane/integracja-portfela-socios.md). # Integracja portfela Socios.com dApps zazwyczaj mają przycisk "Connect Wallet", który wywołuje okno pop-up, gdzie użytkownik może wybrać dostawcę portfela. Pop-up wysyła następnie wiadomość do wybranego portfela w celu weryfikacji, że użytkownik faktycznie posiada ten adres portfela. Istnieje kilka sposobów integracji portfela Socios w modalnym pop-upie "Connect Wallet" Twojej dApp. Polegając na renomowanych narzędziach, możesz zapewnić bezpieczne i bezproblemowe doświadczenie, które działa z wieloma dostawcami portfeli (takimi jak MetaMask i inne) i sieciami, w tym Chiliz Chain (zarówno Spicy Testnet, jak i Chiliz Mainnet). Ta strona ma na celu przedstawienie różnych opcji do wyboru. {% hint style="info" %} Ponieważ celujesz w Chiliz Chain, upewnij się, że w konfiguracji podajesz prawidłowy `chainId`: * 88882: Spicy Testnet * 88888: Chiliz Mainnet Zacznij od testowania integracji na Spicy Testnet (88882), potwierdź, że wszystko działa poprawnie, a dopiero potem przejdź na Chiliz Mainnet (88888). Wszystkie parametry znajdziesz tutaj: [polaczenie-z-chiliz-chain](/pl/tworzenie/podstawy/polaczenie-z-chiliz-chain.md) {% endhint %} ## Wybierz biblioteki i frameworki Możesz korzystać z różnych zewnętrznych narzędzi, aby usprawnić połączenie portfela, obsługę wielu sieci i zaawansowane funkcje. Wybierz narzędzie na podstawie stosu technologicznego projektu. ### Reown (wcześniej WalletConnect) {% hint style="info" %} [Reown](https://reown.com/) to [nazwa](https://reown.com/blog/walletconnect-is-now-reown) WalletConnect Inc. od 2024 roku.\ Znany zestaw narzędzi do łączenia portfeli WalletConnect nosi teraz nazwę [Reown SDK](https://reown.com/reown-sdk) (lub AppKit). Wcześniej znany był jako Web3Modal. {% endhint %} Reown posiada [przewodnik krok po kroku dotyczący korzystania z AppKit](https://docs.reown.com/appkit/networks/evm#get-started) i powinieneś też przeczytać [ich pełną dokumentację](https://docs.reown.com/appkit/overview). {% hint style="warning" %} **WYMAGANE** Portfel Socios.com implementuje standard [ERC-1271](https://eips.ethereum.org/EIPS/eip-1271), co oznacza, że smart kontrakt za nim implementuje metodę `isValidSignature()` zamiast `erecover()`. Dlatego Twoja dApp MUSI obsługiwać ERC-1271 i implementować wywołanie `isValidSignature()`. Zobacz [dokumentację Reown](https://docs.reown.com/advanced/api/sign/smart-contract-wallet-usage#messages) po więcej informacji. {% endhint %} ### RainbowKit [RainbowKit](https://rainbowkit.com/) to biblioteka React do dodawania funkcji łączenia portfeli. Opiera się na [viem](https://viem.sh/) i [Wagmi](https://wagmi.sh/) i zapewnia gotowe komponenty dla nowoczesnego, przyjaznego dla użytkownika przepływu integracji. Przeczytaj [ich własne wprowadzenie](https://rainbowkit.com/docs/introduction), aby dowiedzieć się więcej. ### Moralis [Moralis](https://docs.moralis.com/) oferuje gotowe przepływy uwierzytelniania dla sieci kompatybilnych z EVM (w tym Chiliz Chain, jeśli jest poprawnie skonfigurowana), a także metody po stronie serwera do weryfikacji i zarządzania sesjami użytkowników. Jeśli już używasz Moralis, możesz go użyć do stworzenia przycisku "Connect Wallet" dla dApp kilkoma metodami/narzędziami: * [How to Authenticate Users with WalletConnect](https://docs.moralis.com/get-started/tutorials/auth-api/authenticate-users-with-wallet-connect) * [How to Authenticate Users with RainbowKit](https://docs.moralis.com/get-started/tutorials/auth-api/authenticate-users-with-rainbow-kit) * [How to Authenticate Users with Magic.Link](https://docs.moralis.com/get-started/tutorials/auth-api/authenticate-users-with-magic-link) * itd. ### thirdweb [thirdweb](https://portal.thirdweb.com/) oferuje [Connect](https://thirdweb.com/learn/guides/thirdweb-connect-explained) — elastyczny przepływ rejestracji, który uwzględnia różne preferencje, co jest kluczowe przy wdrażaniu użytkowników. Możesz korzystać z [dokumentacji Wallets](https://portal.thirdweb.com/connect/wallet/sign-in-methods/external-wallets), a nawet bawić się [placem zabaw ConnectButton](https://playground.thirdweb.com/connect/sign-in/button). ## Polecaj portfel Socios.com w modalnym pop-upie Możesz dostosować wyświetlanie modalnego pop-upu, aby wyróżnić portfel Socios.com: * Z Reown/WalletConnect: Dostosuj sekcję "Recommended Wallet" modalu używając opcji [`explorerRecommendedWalletIds`](https://docs.reown.com/advanced/walletconnectmodal/options#explorerrecommendedwalletids-optional). * Z RainbowKit: Możesz zbudować własną listę portfeli używając opcji [`connectorsForWallets`](https://www.rainbowkit.com/docs/custom-wallet-list). ## Zapewnij optymalne doświadczenie użytkownikom Dla lepszego doświadczenia użytkownika zalecamy przechowywanie adresu portfela użytkownika w session storage dApp lub w profilu użytkownika. Dzięki temu użytkownik nie będzie musiał łączyć się z portfelem za każdym razem, gdy odwiedza platformę. ## Obsługiwane metody Portfel Socios.com obsługuje następujące metody: * `eth_sendTransaction` * `eth_signTransaction` * `personal_sign` Planujemy wkrótce obsługiwać następujące metody: * `eth_signTypedData` * `eth_signTypedData_v4` ## Weryfikacja SIWE Jeśli chcesz używać portfela Socios.com do uwierzytelniania przez [SIWE](https://eips.ethereum.org/EIPS/eip-4361), pamiętaj, że portfel Socios.com jest portfelem SCA, a nie zwykłym portfelem EOA.\ \&#xNAN;*Ekosystem Ethereum obejmuje dwa główne typy kont: Smart Contract Accounts (SCAs) i Externally Owned Accounts (EOAs).* Podczas gdy podpis dla portfeli EOA można zweryfikować za pomocą `ecrecover` (np. używając `ethers.utils.verifyMessage`), standard EIP-1271 (którego używa portfel Socios.com) wymaga wywołania metody `isValidSignature` kontraktu w celu weryfikacji. Dlatego podczas uwierzytelniania konta musisz najpierw sprawdzić, czy adres jest kontraktem, a w zależności od tego wybrać odpowiednią metodę weryfikacji. --- # 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/pl/tworzenie/zaawansowane/integracja-portfela-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.