> 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/ko/gaebal/goseup/socios-jigap-tonghap.md).

# dApp에 Socios.com 지갑 통합

dApp에는 일반적으로 "지갑 연결" 버튼이 있어 사용자가 지갑 공급자를 선택할 수 있는 팝업 창을 표시합니다. 팝업은 선택된 지갑에 메시지를 보내 이 사용자가 실제로 이 지갑 주소를 소유하는지 확인합니다.

Socios Wallet을 dApp의 "지갑 연결" 팝업 모달에 통합하는 여러 방법이 있습니다. 신뢰할 수 있는 도구를 활용하면 MetaMask 및 기타 여러 지갑 공급자와 Chiliz Chain(Spicy Testnet과 Chiliz Mainnet 모두)을 포함한 여러 체인에서 작동하는 안전하고 원활한 경험을 제공할 수 있습니다.

이 페이지는 다양한 옵션을 소개합니다.

{% hint style="info" %}
Chiliz Chain을 대상으로 하므로 구성에서 올바른 `chainId`를 지정해야 합니다.

* 88882: Spicy Testnet
* 88888: Chiliz Mainnet

Spicy Testnet(88882)에서 통합을 테스트하고 모든 것이 원활하게 작동하는지 확인한 후 Chiliz Mainnet(88888)으로 이전하세요.

모든 파라미터 확인: [Chiliz Chain 연결](/ko/gaebal/gibon/chiliz-chain-yeongyeol.md)
{% endhint %}

## 라이브러리 및 프레임워크 선택

지갑 연결성, 멀티체인 지원, 고급 기능을 간소화하기 위해 다양한 외부 도구를 활용할 수 있습니다. 프로젝트의 기술 스택에 따라 도구를 선택하세요.

### Reown (이전 WalletConnect)

{% hint style="info" %}
[Reown](https://reown.com/)은 2024년부터 WalletConnect Inc.의 [새 이름](https://reown.com/blog/walletconnect-is-now-reown)입니다.\
잘 알려진 WalletConnect 지갑 연결 툴킷은 이제 [Reown SDK](https://reown.com/reown-sdk)(또는 AppKit)라고 불립니다. 이전에는 Web3Modal로 알려져 있었습니다.
{% endhint %}

Reown에는 [AppKit 사용에 대한 단계별 가이드](https://docs.reown.com/appkit/networks/evm#get-started)가 있으며, [전체 문서](https://docs.reown.com/appkit/overview)도 읽어보시길 권장합니다.

{% hint style="warning" %}
**필수 요구사항**

Socios.com Wallet은 [ERC-1271](https://eips.ethereum.org/EIPS/eip-1271) 표준을 구현합니다. 이는 그 뒤에 있는 스마트 컨트랙트가 `erecover()` 대신 `isValidSignature()` 메서드를 구현한다는 의미입니다.

따라서 dApp은 반드시 ERC-1271을 지원하고 `isValidSignature()`를 호출해야 합니다.

자세한 내용은 [Reown 문서](https://docs.reown.com/advanced/api/sign/smart-contract-wallet-usage#messages)를 참조하세요.
{% endhint %}

### RainbowKit

[RainbowKit](https://rainbowkit.com/)은 지갑 연결 기능을 추가하는 React 라이브러리입니다. [viem](https://viem.sh/)과 [Wagmi](https://wagmi.sh/)를 기반으로 하며, 현대적이고 사용자 친화적인 통합 흐름을 위한 사전 빌드된 컴포넌트를 제공합니다.

더 자세히 알아보려면 [공식 소개](https://rainbowkit.com/docs/introduction)를 참조하세요.

### Moralis

[Moralis](https://docs.moralis.com/)는 Chiliz Chain을 포함한 EVM 호환 체인에 대한 즉시 사용 가능한 인증 흐름과 사용자 세션을 검증하고 관리하는 서버 측 메서드를 제공합니다.

Moralis를 이미 사용하고 있다면 여러 메서드/도구로 dApp의 "지갑 연결" 버튼을 만들 수 있습니다.

* [WalletConnect로 사용자 인증하는 방법](https://docs.moralis.com/get-started/tutorials/auth-api/authenticate-users-with-wallet-connect)
* [RainbowKit으로 사용자 인증하는 방법](https://docs.moralis.com/get-started/tutorials/auth-api/authenticate-users-with-rainbow-kit)
* [Magic.Link로 사용자 인증하는 방법](https://docs.moralis.com/get-started/tutorials/auth-api/authenticate-users-with-magic-link)
* 기타.

상세 블로그 포스트:

* [WalletConnect 통합 – WalletConnect 통합 방법](https://developers.moralis.com/walletconnect-integration-how-to-integrate-walletconnect/)
* [5단계로 프로젝트에 RainbowKit 로그인 추가하는 방법](https://developers.moralis.com/how-to-add-a-sign-in-with-rainbowkit-to-your-project-in-5-steps/)

### thirdweb

[thirdweb](https://portal.thirdweb.com/)은 사용자 온보딩 시 다양한 선호도에 맞는 유연한 가입 흐름인 [Connect](https://thirdweb.com/learn/guides/thirdweb-connect-explained)를 제공합니다.

[Wallets 문서](https://portal.thirdweb.com/connect/wallet/sign-in-methods/external-wallets)를 참고하고, [ConnectButton 플레이그라운드](https://playground.thirdweb.com/connect/sign-in/button)에서도 사용해볼 수 있습니다.

## 팝업 모달에서 Socios.com Wallet 추천

팝업 모달에 Socios.com Wallet을 강조하도록 표시를 커스터마이즈할 수 있습니다.

* Reown/WalletConnect 사용 시: [`explorerRecommendedWalletIds`](https://docs.reown.com/advanced/walletconnectmodal/options#explorerrecommendedwalletids-optional) 옵션을 사용하여 모달의 "추천 지갑" 섹션을 커스터마이즈합니다.
* RainbowKit 사용 시: [`connectorsForWallets`](https://www.rainbowkit.com/docs/custom-wallet-list) 옵션을 사용하여 자체 지갑 목록을 구성할 수 있습니다.

## 사용자를 위한 최적의 경험 보장

더 나은 사용자 경험을 위해 dApp의 세션 스토리지나 사용자 프로필에 사용자의 지갑 주소를 저장하는 것을 권장합니다. 이렇게 하면 사용자가 플랫폼을 방문할 때마다 지갑을 다시 연결할 필요가 없습니다.

## 지원되는 메서드

Socios.com Wallet은 다음 메서드를 지원합니다.

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

다음 메서드는 곧 지원할 예정입니다.

* `eth_signTypedData`
* `eth_signTypedData_v4`

## SIWE 검증

[SIWE](https://eips.ethereum.org/EIPS/eip-4361)를 사용하여 Socios.com Wallet로 인증하려는 경우, Socios.com Wallet은 일반 EOA 지갑이 아닌 SCA 지갑임을 참고하세요.\
\&#xNAN;*이더리움 생태계에는 두 가지 주요 계정 유형이 있습니다: 스마트 컨트랙트 계정(SCA)과 외부 소유 계정(EOA).*

EOA 지갑의 서명은 `ecrecover`(예: `ethers.utils.verifyMessage` 사용)로 검증할 수 있지만, EIP-1271 표준(Socios.com Wallet이 사용)은 검증을 위해 컨트랙트의 `isValidSignature` 메서드를 호출해야 합니다.

따라서 계정을 인증할 때 먼저 주소가 컨트랙트인지 확인하고, 이에 따라 적절한 검증 방법을 선택해야 합니다.


---

# 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/ko/gaebal/goseup/socios-jigap-tonghap.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.