> ## Documentation Index > Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # Ring tùy chỉnh dành cho doanh nghiệp > Thêm chức năng thanh toán và số dư stablecoin riêng tư trên Solana qua Private Wallet API, với các biện pháp kiểm soát chính sách và tuân thủ có thể lập trình dành cho tổ chức. Hướng dẫn này dành cho các công ty fintech, đơn vị phát hành, nền tảng trả lương, công ty chuyển tiền, ngân hàng số và doanh nghiệp muốn kết hợp tài khoản thanh toán riêng tư với các lợi ích của blockchain. ## Tổng quan Doanh nghiệp của bạn sẽ có thể: 1. Tạo ví riêng tư cho tài khoản khách hàng, đơn vị bán hàng hoặc ngân quỹ 2. Nạp stablecoin từ ví công khai vào ví riêng tư 3. Gửi khoản thanh toán riêng tư giữa các ví riêng tư 4. Rút tiền về địa chỉ và ví Solana công khai 5. Xem số dư và lịch sử riêng tư qua API 6. Xác định các Ring tùy chỉnh chuyên dụng với quy tắc tuân thủ, kiểm toán và kinh doanh riêng. Bạn có thể sử dụng hệ thống tuân thủ của riêng mình hoặc giải pháp KYC và sàng lọc lệnh trừng phạt do Helius quản lý. 7. Cấu hình đối tượng có thể xem, phê duyệt, đóng băng hoặc di chuyển tiền trong một ring 8. Theo dõi trạng thái thanh toán riêng tư qua phương thức thăm dò hoặc webhook Thử nghiệm chuyển tiền và hoán đổi bảo mật trên devnet. | Thuật ngữ | Ý nghĩa | | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Doanh nghiệp | Công ty tích hợp Helius Privacy | | Ví riêng tư | Tài khoản thanh toán có số dư và giao dịch chuyển tiền onchain được mã hóa | | Nhà cung cấp ví | Hệ thống quản lý tài khoản người dùng, bên ký, tài khoản thông minh hoặc ví ngân quỹ và lưu giữ các khóa riêng tư không thể xuất. Ví dụ gồm Turnkey, Privy, Squads, Rain hoặc một hệ thống lưu ký nội bộ | | Chủ sở hữu | Khóa công khai Solana, tài khoản thông minh hoặc bên ký do nhà cung cấp hỗ trợ, có quyền cho phép các thao tác của Ví riêng tư | | Hộp thư đến | Khóa công khai Solana được dùng làm địa chỉ nhận công khai cho Ví riêng tư | | Ring | Một nhóm ví riêng tư có số dư trong Ring mặc định hoặc Ring tùy chỉnh | | Ring mặc định | Ring bảo mật không cần cấp quyền; tài sản và số tiền được giữ riêng tư, còn người gửi và người nhận vẫn công khai. Không có chính sách, thẩm quyền hoặc kiểm toán viên tùy chỉnh | | Ring tùy chỉnh | Một ring được cấu hình với các quy tắc, khả năng hiển thị và thẩm quyền tùy chỉnh | | Kiểm toán viên | Đối tượng xem được cấu hình cho Ring tùy chỉnh. Kiểm toán viên có thể đọc dữ liệu của ring nhưng không thể chi tiêu | | Bên đồng ký | Bên ký được cấu hình tùy chọn và phải phê duyệt các giao dịch chuyển tiền đã chọn | | Thẩm quyền đóng băng | Thẩm quyền được cấu hình có thể đóng băng hoặc gỡ đóng băng số dư khi chính sách cho phép | | Bên được ủy quyền vĩnh viễn | Thẩm quyền được cấu hình có thể di chuyển số dư trong một ring khi chính sách cho phép | | Privacy API | API Helius dùng để tạo Ví riêng tư, đọc số dư/lịch sử, chuẩn bị giao dịch chuyển tiền, tạo bằng chứng và gửi giao dịch | ## Cách hoạt động Ví riêng tư là đối tượng API cốt lõi mà bạn tương tác. Ví dụ, bạn có thể ánh xạ một Ví riêng tư với tài khoản khách hàng, tài khoản đơn vị bán hàng, tài khoản nhân viên, tài khoản ngân quỹ hoặc tài khoản thông minh. Số dư và các giao dịch chuyển tiền riêng tư được mã hóa onchain. Các nhà cung cấp RPC như Helius lập chỉ mục trạng thái đã mã hóa, tạo bằng chứng, xây dựng giao dịch và gửi chúng đến Solana theo yêu cầu. Đối với hầu hết trường hợp sử dụng trong doanh nghiệp, Ví riêng tư nằm trong một Ring tùy chỉnh chuyên dụng. Ring xác định các quy tắc về chuyển tiền, khả năng hiển thị và tuân thủ. Sau đây là cách Helius Privacy tích hợp vào hệ thống công nghệ của bạn: Trust model. The Enterprise App submits intent to the Privacy API / RPC Provider, which calls the Wallet Provider for key operations and submits transactions to Solana. ### Mô hình tin cậy | Thành phần | Trách nhiệm | | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- | | Ứng dụng doanh nghiệp | Giao diện người dùng sản phẩm, xác thực khách hàng, quy trình nghiệp vụ | | Nhà cung cấp ví | Lưu ký tài khoản, bên ký, chính sách phê duyệt và các khóa riêng tư không thể xuất với thao tác khóa được kiểm soát bằng chính sách | | Privacy API / Nhà cung cấp RPC | Private Wallet API, đồng bộ hóa, trạng thái, tạo bằng chứng, xây dựng giao dịch, kiểm toán tùy chọn và gửi giao dịch đến mạng Solana | | Ring tùy chỉnh | Quy tắc kinh doanh, quy tắc tuân thủ, quy tắc hiển thị và các thẩm quyền tùy chọn, được chỉ định qua các lệnh chương trình tùy chỉnh onchain | | Solana | Thực thi và quyết toán | Các khoản thanh toán riêng tư phải được ví riêng tư cấp quyền và phải tuân thủ chính sách tương ứng của ring. Các ring bảo mật (Ring mặc định và các Ring tùy chỉnh bảo mật) hỗ trợ giải mã cục bộ và giải mã ủy quyền. Các Ring tùy chỉnh ẩn danh chỉ hỗ trợ giải mã ủy quyền. Trong chế độ giải mã ủy quyền, ví và nhà cung cấp RPC được chọn dùng chung một khóa xem. Nhà cung cấp có thể cung cấp số dư và lịch sử nhưng không thể cấp quyền chi tiêu. Vai trò này khác với kiểm toán viên, đối tượng có khả năng hiển thị được xác định theo chính sách của Ring. Bạn có thể tự vận hành cơ sở hạ tầng (RPC, bộ lập chỉ mục, máy chủ kiểm toán viên hoặc bên đồng ký), hoặc sử dụng một nhà cung cấp RPC như Helius để vận hành thay bạn. Chúng tôi vận hành cơ sở hạ tầng thông qua đội ngũ RPC hiệu năng cao trên toàn cầu và có thể cung cấp thêm một hệ thống chuyên dụng tùy chỉnh theo yêu cầu của bạn. Cơ sở hạ tầng chuyên dụng không đồng nghĩa với một cây trạng thái onchain riêng biệt. Các Ring tùy chỉnh và Ring mặc định không cần cấp quyền dùng chung một cây Merkle. ### Ring Ring giúp khả năng riêng tư trên Solana có thể lập trình, tương tự Token-2022. Ring mặc định không cần cấp quyền và không có chính sách tùy chỉnh. Ring tùy chỉnh chịu sự quản lý của bộ quy tắc chính sách riêng. Một Ví riêng tư có thể đồng thời giữ số dư trong nhiều Ring. Ring chứa số dư không phải là thuộc tính của ví mà là thuộc tính của từng UTXO, được lưu trong trường `policy_program_id` của UTXO. * Ring mặc định có tính bảo mật, không cần cấp quyền và không có bất kỳ chính sách, kiểm toán viên hay thẩm quyền nào. Các ring bảo mật mã hóa tài sản và số tiền. * Ring tùy chỉnh có thể được cấu hình với chính sách và biện pháp kiểm soát tuân thủ tùy chỉnh, đồng thời có thể bảo mật hoặc ẩn danh (mã hóa tài sản, số tiền, người gửi và người nhận). Private Balances shown as a dashed onchain zone holding two rings. The Default Ring is confidential, self-custodial, and permissionless. The Custom Ring is confidential or anonymous, self-custodial, and adds custom policy and custom compliance. A private transfer connects the rings, and each deposits into and withdraws from a Solana Public Balances layer below. Ví riêng tư có thể rút tiền từ Ring tùy chỉnh về tài khoản token công khai, Ring mặc định bảo mật và không cần cấp quyền, hoặc một Ring tùy chỉnh khác nếu chính sách của ring nguồn cho phép. #### Ring tùy chỉnh có thể lập trình Ring tùy chỉnh có thể xác định các quy tắc hoàn toàn tùy chỉnh cho giao dịch chuyển tiền và khả năng hiển thị/kiểm toán. Nếu muốn thiết lập Ring tùy chỉnh riêng, hãy [liên hệ với chúng tôi](https://www.helius.dev/contact) và chúng tôi sẽ hỗ trợ bạn thiết lập. Bạn có thể sử dụng hệ thống tuân thủ của riêng mình hoặc giải pháp KYC và sàng lọc lệnh trừng phạt do Helius quản lý. Ring có thể lập trình. Một số ví dụ phổ biến về quy tắc gồm: | Chính sách | Ví dụ | | ------------------------------------ | --------------------------------------------------------------------------------------- | | Tài sản được phép | Chỉ USDC hoặc một stablecoin cụ thể đã phát hành | | Hạn mức chuyển tiền | Yêu cầu phê duyệt bổ sung khi vượt quá ngưỡng | | Đồng ký | Yêu cầu phê duyệt tuân thủ cho các khoản thanh toán đã chọn | | Danh sách cho phép | Chỉ cho phép chuyển tiền đến các tài khoản, đơn vị bán hàng hoặc ring đã được phê duyệt | | Danh sách chặn | Chặn các điểm đến bị trừng phạt hoặc có rủi ro | | Đóng băng/gỡ đóng băng | Đóng băng số dư trong khi chờ điều tra | | Bên được ủy quyền vĩnh viễn | Cho phép thẩm quyền đã cấu hình di chuyển tiền theo chính sách | | Khả năng hiển thị cho kiểm toán viên | Cho phép bộ phận tuân thủ, kế toán hoặc cơ quan quản lý xem hoạt động của ring | | Quy tắc liên ring | Cho phép hoặc chặn việc di chuyển giữa các ring cụ thể | | Quy tắc rút tiền | Hạn chế rút tiền công khai hoặc yêu cầu phê duyệt | | Hỗ trợ tài khoản thông minh | Cho phép sử dụng trực tiếp với các tài khoản thông minh như Squads | | Khôi phục tài khoản | Cho phép thẩm quyền đã cấu hình hoặc danh tính dự phòng khôi phục tài khoản | Các bộ quy tắc tùy chỉnh như vậy được lập trình thành một chương trình Solana chuyên dụng để xác minh quá trình chuyển đổi trạng thái của từng giao dịch chuyển tiền áp dụng trước khi giao dịch được quyết toán nguyên tử onchain thông qua Solana Privacy Protocol (TSPP). ## Quản trị Ring ### Báo cáo Ring Sử dụng báo cáo ring cho ngân quỹ, kế toán, tuân thủ hoặc bộ quy tắc hiển thị riêng của bạn. ```bash theme={"system"} curl "https://privacy.helius.xyz/v1/rings/ring_acme_usdc/transactions?limit=100" \ -H "Authorization: Bearer $HELIUS_API_KEY" ``` Phản hồi mẫu: ```json theme={"system"} { "ringId": "ring_acme_usdc", "transactions": [ { "kind": "private_transfer", "fromPrivateWalletId": "pw_2W6Qk...", "toPrivateWalletId": "pw_8Se1...", "mint": "EPjFWdd5AufqSSqeM2q...", "amount": "25000000", "status": "confirmed", "signature": "3jd...", "slot": 291044120, "metadata": { "invoiceId": "inv_123", "purpose": "vendor_payment" } } ] } ``` Quyền truy cập của kiểm toán viên chỉ cho phép đọc. Kiểm toán viên có thể xem dữ liệu được chính sách của ring cấu hình, nhưng không thể ký, chi tiêu, đóng băng hoặc di chuyển tiền trừ khi được cấu hình riêng làm thẩm quyền. ### Đóng băng hoặc gỡ đóng băng Ví riêng tư Nếu Ring tùy chỉnh có thẩm quyền đóng băng, bạn có thể đóng băng hoặc gỡ đóng băng Ví riêng tư theo chính sách. ```mermaid theme={"system"} %%{init: { 'theme': 'base', 'themeVariables': { 'lineColor': '#FF6B35', 'primaryTextColor': '#737373', 'primaryBorderColor': '#9CA3AF', 'actorBkg': '#FFFFFF', 'actorBorder': '#9CA3AF', 'actorTextColor': '#737373', 'signalColor': '#FF6B35', 'signalTextColor': '#737373', 'labelBoxBkgColor': '#FF6B351F', 'labelBoxBorderColor': '#FF6B35', 'noteBkgColor': '#F5F5F5', 'noteTextColor': '#737373', 'noteBorderColor': '#9CA3AF' } }}%% sequenceDiagram participant Auth as Ring Authority participant API as Privacy API participant SOL as Solana Auth->>API: POST /freeze or /thaw (walletId, authority signature) Note over API: Verify Custom Ring freeze authority API->>SOL: Apply freeze or thaw via policy program SOL-->>API: Wallet status updated ``` ```bash theme={"system"} curl -X POST https://privacy.helius.xyz/v1/private-wallets/pw_2W6Qk.../freeze \ -H "Authorization: Bearer $HELIUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "reason": "compliance_review", "authorization": { "type": "solana_signature", "message": "BASE64_ENCODED_FREEZE_MESSAGE", "signature": "BASE58_SIGNATURE" } }' ``` Phản hồi mẫu: ```json theme={"system"} { "id": "pw_2W6Qk...", "status": "frozen", "reason": "compliance_review" } ``` Gỡ đóng băng: ```bash theme={"system"} curl -X POST https://privacy.helius.xyz/v1/private-wallets/pw_2W6Qk.../thaw \ -H "Authorization: Bearer $HELIUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "authorization": { "type": "solana_signature", "message": "BASE64_ENCODED_THAW_MESSAGE", "signature": "BASE58_SIGNATURE" } }' ``` ## Giám sát qua webhook Sử dụng webhook để nhận thông tin cập nhật về vòng đời giao dịch chuyển tiền. ```bash theme={"system"} curl -X POST https://privacy.helius.xyz/v1/webhooks \ -H "Authorization: Bearer $HELIUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "events": [ "private_wallet.created", "private_wallet.balance_updated", "private_wallet.transaction_confirmed", "policy.action_required" ], "url": "https://example.com/helius/privacy/webhook" }' ``` Sự kiện mẫu: ```json theme={"system"} { "type": "private_wallet.transaction_confirmed", "ringId": "ring_acme_usdc", "owner": "9xQeWvG816bUx9EPf...", "privateWalletId": "pw_2W6Qk...", "signature": "3jd...", "slot": 291044120 } ``` ## Các thuộc tính bảo mật và riêng tư * Khóa API Helius xác thực các dự án doanh nghiệp. Chúng không cấp quyền chi tiêu. Việc cấp quyền chi tiêu yêu cầu chữ ký ví, phương thức cấp quyền thay thế thông qua dịch vụ quản lý khóa nền tảng (chẳng hạn như Privy hoặc Turnkey), hoặc chính sách ring nếu được cấu hình. * Vật liệu khóa riêng tư được lưu giữ trong cơ sở hạ tầng bảo mật do Nhà cung cấp ví quản lý. * Helius không nhận hoặc xuất các khóa chi tiêu riêng tư. * Trong chế độ giải mã ủy quyền, ví và nhà cung cấp dùng chung một khóa xem. Nhà cung cấp có thể đọc số dư và lịch sử nhưng không thể cấp quyền chi tiêu. * Kiểm toán viên của Ring tùy chỉnh có thể xem hoạt động ring đã cấu hình nhưng không thể chi tiêu. * Các giao dịch đến hoặc trong Ring tùy chỉnh sẽ công khai gọi chương trình chính sách của ring đó. * Bên đồng ký phê duyệt các giao dịch chuyển tiền đã chọn nhưng không thể tự chi tiêu trừ khi chính sách cho phép. * Thẩm quyền đóng băng chỉ có thể đóng băng hoặc gỡ đóng băng số dư nếu chính sách của ring cho phép. * Bên được ủy quyền vĩnh viễn chỉ có thể di chuyển số dư nếu được cấu hình rõ ràng trong chính sách của ring. * Các giao dịch chuyển tiền riêng tư trong một ring không tiết lộ tài sản hoặc số tiền onchain. Ring bảo mật tiết lộ người gửi và người nhận; ring ẩn danh sử dụng bên chuyển tiếp và không tiết lộ bên nào. Chính sách của ring có thể quy định thêm khả năng hiển thị. * Giao dịch rút tiền tiết lộ điểm đến, tài sản và số tiền. * Khoản nạp tiền mã hóa công khai tiết lộ nguồn, tài sản và số tiền. Việc chuyển từ số dư tiền pháp định vào hệ thống giữ kín tài sản và số tiền (được mã hóa onchain). * Giao dịch chuyển tiền công khai tiết lộ người gửi, người nhận, tài sản và số tiền. ## Không tìm thấy nội dung bạn đang tìm kiếm? Hãy liên hệ với chúng tôi! [Telegram](https://t.me/tilo_light) | [Email](mailto:sales@helius.xyz) | [Liên hệ](https://www.helius.dev/contact)