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

Tích hợp ví Socios.com vào luồng Kết nối Ví của dApp Chiliz Chain của bạn bằng Reown AppKit hoặc WalletConnect, với chain ID 88888 (Mainnet) và 88882 (Spicy Testnet).

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.

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

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)

Reown là tên 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 (hay AppKit). Trước đây nó được biết đến với tên Web3Modal.

Reown có hướng dẫn từng bước để sử dụng AppKit, và bạn cũng nên đọc tài liệu đầy đủ của họ.

BẮT BUỘC

Ví Socios.com triển khai chuẩn ERC-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 để biết thêm.

RainbowKit

RainbowKit 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 và Wagmi, đồ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ọ để tìm hiểu thêm.

Moralis

Moralis 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ụ:

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

thirdweb

thirdweb cung cấp Connect, 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ọ, và thậm chí thử nghiệm với ConnectButton playground của họ.

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.
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.

Đả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, hãy lưu ý rằng ví Socios.com là ví SCA chứ không phải ví EOA thông thường. 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.

Cập nhật lần cuối 1 tháng trước

Nội dung này có hữu ích không?