> 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/vi/phat-trien/nang-cao/tich-hop-vi-socios.md).

# Tích hợp ví Socios.com vào dApp

Các dApp thường có nút "Kết nối Ví" để kích hoạt một cửa sổ bật lên, nơi người dùng có thể chọn nhà cung cấp ví của mình. Cửa sổ bật lên sau đó sẽ gửi một tin nhắn đến ví đã chọn để xác minh rằng người dùng này thực sự sở hữu địa chỉ ví đó.

Có nhiều cách để tích hợp ví Socios vào modal bật lên "Kết nối Ví" của dApp bạn. Bằng cách sử dụng các công cụ uy tín, bạn có thể mang lại trải nghiệm an toàn và liền mạch, hoạt động với nhiều nhà cung cấp ví (như MetaMask và các ví khác) cũng như nhiều chain, bao gồm Chiliz Chain (cả Spicy Testnet lẫn Chiliz Mainnet).

Trang này nhằm giới thiệu cho bạn các tùy chọn khác nhau để lựa chọn.

{% hint style="info" %}
Vì bạn đang nhắm đến Chiliz Chain, hãy đảm bảo bạn chỉ định đúng `chainId` trong cấu hình của mình:

* 88882: Spicy Testnet
* 88888: Chiliz Mainnet

Hãy bắt đầu kiểm tra tích hợp của bạn trên Spicy Testnet (88882), xác nhận rằng mọi thứ hoạt động trơn tru, rồi mới chuyển sang Chiliz Mainnet (88888).

Xem tất cả các thông số tại đây: [https://github.com/chiliz-chain/docs/blob/master/vi/phat-trien/basics/connect-to-chiliz-chain/README.md](https://github.com/chiliz-chain/docs/blob/master/vi/phat-trien/basics/connect-to-chiliz-chain/README.md "mention")
{% endhint %}

## Chọn thư viện & framework của bạn

Bạn có thể tận dụng nhiều công cụ bên ngoài để đơn giản hóa kết nối ví, hỗ trợ đa chain và các tính năng nâng cao. Hãy chọn công cụ phù hợp với tech stack của dự án bạn.

### Reown (trước đây là WalletConnect)

{% hint style="info" %}
[Reown](https://reown.com/) là [tên](https://reown.com/blog/walletconnect-is-now-reown) của WalletConnect Inc. kể từ năm 2024.\
Bộ công cụ kết nối ví WalletConnect nổi tiếng hiện được gọi là [Reown SDK](https://reown.com/reown-sdk) (hay AppKit). Trước đây nó được biết đến với tên Web3Modal.
{% endhint %}

Reown có [hướng dẫn từng bước để sử dụng AppKit](https://docs.reown.com/appkit/networks/evm#get-started), và bạn cũng nên đọc [tài liệu đầy đủ của họ](https://docs.reown.com/appkit/overview).

{% hint style="warning" %}
**BẮT BUỘC**

Ví Socios.com triển khai chuẩn [ERC-1271](https://eips.ethereum.org/EIPS/eip-1271), nghĩa là smart contract phía sau nó triển khai phương thức `isValidSignature()` thay vì `erecover()`.

Do đó, dApp của bạn PHẢI hỗ trợ ERC-1271 và triển khai lệnh gọi đến `isValidSignature()`.

Xem [tài liệu Reown](https://docs.reown.com/advanced/api/sign/smart-contract-wallet-usage#messages) để biết thêm.
{% endhint %}

### RainbowKit

[RainbowKit](https://rainbowkit.com/) là một thư viện React dùng để thêm tính năng kết nối ví. Nó dựa trên [viem](https://viem.sh/) và [Wagmi](https://wagmi.sh/), đồng thời cung cấp các thành phần dựng sẵn cho luồng tích hợp hiện đại, thân thiện với người dùng.

Xem [phần giới thiệu của họ](https://rainbowkit.com/docs/introduction) để tìm hiểu thêm.

### Moralis

[Moralis](https://docs.moralis.com/) cung cấp các luồng xác thực sẵn có cho các chain tương thích EVM (bao gồm Chiliz Chain nếu được cấu hình đúng), cũng như các phương thức phía server để xác thực và quản lý phiên người dùng.

Nếu bạn đã sử dụng Moralis, bạn có thể dùng nó để tạo nút "Kết nối Ví" cho dApp của mình với nhiều phương thức/công cụ:

* [Cách xác thực người dùng với WalletConnect](https://docs.moralis.com/get-started/tutorials/auth-api/authenticate-users-with-wallet-connect)
* [Cách xác thực người dùng với RainbowKit](https://docs.moralis.com/get-started/tutorials/auth-api/authenticate-users-with-rainbow-kit)
* [Cách xác thực người dùng với Magic.Link](https://docs.moralis.com/get-started/tutorials/auth-api/authenticate-users-with-magic-link)
* v.v.

Họ cũng có các bài viết blog chi tiết về từng chủ đề:

* [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/) cung cấp [Connect](https://thirdweb.com/learn/guides/thirdweb-connect-explained), một luồng đăng ký linh hoạt đáp ứng nhiều sở thích khác nhau — điều này rất quan trọng khi onboard người dùng.

Bạn có thể tham khảo [tài liệu Wallets của họ](https://portal.thirdweb.com/connect/wallet/sign-in-methods/external-wallets), và thậm chí thử nghiệm với [ConnectButton playground](https://playground.thirdweb.com/connect/sign-in/button) của họ.

## Đề xuất ví Socios.com trong modal bật lên

Bạn có thể tùy chỉnh hiển thị của modal bật lên để nổi bật ví Socios.com:

* Với Reown/WalletConnect: Tùy chỉnh phần "Ví được đề xuất" của modal bằng tùy chọn [`explorerRecommendedWalletIds`](https://docs.reown.com/advanced/walletconnectmodal/options#explorerrecommendedwalletids-optional).
* Với RainbowKit: Bạn có thể tự xây dựng danh sách ví của mình bằng tùy chọn [`connectorsForWallets`](https://www.rainbowkit.com/docs/custom-wallet-list).

## Đảm bảo trải nghiệm tối ưu cho người dùng

Để cải thiện trải nghiệm người dùng, chúng tôi khuyên bạn nên lưu trữ địa chỉ ví của người dùng vào session storage của dApp hoặc trong hồ sơ người dùng. Như vậy, người dùng sẽ không phải kết nối lại ví mỗi lần họ truy cập nền tảng của bạn.

## Các phương thức được hỗ trợ

Ví Socios.com hỗ trợ các phương thức sau:

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

Chúng tôi dự kiến sẽ hỗ trợ các phương thức sau trong thời gian sắp tới:

* `eth_signTypedData`
* `eth_signTypedData_v4`

## Xác minh SIWE

Nếu bạn muốn sử dụng ví Socios.com để xác thực bằng [SIWE](https://eips.ethereum.org/EIPS/eip-4361), hãy lưu ý rằng ví Socios.com là ví SCA chứ không phải ví EOA thông thường.\
\&#xNAN;*Hệ sinh thái Ethereum bao gồm hai loại tài khoản chính: Smart Contract Accounts (SCA) và Externally Owned Accounts (EOA).*

Trong khi chữ ký của ví EOA có thể được xác minh bằng `ecrecover` (ví dụ: dùng `ethers.utils.verifyMessage`), chuẩn EIP-1271 (mà ví Socios.com sử dụng) yêu cầu gọi phương thức `isValidSignature` của hợp đồng để xác minh.

Do đó, khi xác thực một tài khoản, bạn cần kiểm tra trước xem địa chỉ đó có phải là hợp đồng hay không, rồi từ đó chọn phương thức xác minh phù hợp.


---

# 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/vi/phat-trien/nang-cao/tich-hop-vi-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.