> ## 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 Kustom untuk Perusahaan
> Tambahkan pembayaran dan saldo stablecoin privat di Solana melalui Private Wallet API, dengan kontrol kebijakan dan kepatuhan yang dapat diprogram untuk institusi.
Panduan ini ditujukan bagi perusahaan fintech, penerbit, platform penggajian, perusahaan remitansi, neobank, dan perusahaan yang menginginkan akun pembayaran privat sekaligus manfaat blockchain.
## Gambaran Umum
Bisnis Anda akan dapat:
1. Membuat dompet privat untuk akun pelanggan, pedagang, atau perbendaharaan
2. Menyetorkan stablecoin dari dompet publik ke dompet privat
3. Mengirim pembayaran privat antardompet privat
4. Menarik dana ke alamat dan dompet Solana publik
5. Melihat saldo dan riwayat privat melalui API
6. Menentukan Ring Kustom khusus dengan aturan kepatuhan, audit, dan bisnis Anda sendiri.
Anda dapat menggunakan sistem kepatuhan Anda sendiri atau solusi KYC dan penyaringan sanksi terkelola dari Helius.
7. Mengonfigurasi siapa yang dapat melihat, menyetujui, membekukan, atau memindahkan dana di dalam ring
8. Melacak status pembayaran privat melalui polling atau webhook
Coba transfer dan swap rahasia di devnet.
| Istilah | Arti |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Perusahaan | Perusahaan yang mengintegrasikan Helius Privacy |
| Dompet Privat | Akun pembayaran dengan saldo dan transfer onchain yang terenkripsi |
| Penyedia Dompet | Sistem yang mengelola akun pengguna, penanda tangan, akun pintar, atau dompet perbendaharaan dan menyimpan kunci privasi yang tidak dapat diekspor. Contohnya mencakup Turnkey, Privy, Squads, Rain, atau stack kustodi internal |
| Pemilik | Kunci publik Solana, akun pintar, atau penanda tangan yang didukung penyedia yang mengotorisasi tindakan Dompet Privat |
| Kotak Masuk | Kunci publik Solana yang digunakan sebagai alamat penerimaan publik untuk Dompet Privat |
| Ring | Sekelompok dompet privat dengan saldo di Ring Default atau Ring Kustom |
| Ring Default | Ring rahasia tanpa izin; aset dan jumlah bersifat privat, sementara pengirim dan penerima tetap publik. Tidak memiliki kebijakan, otoritas, atau auditor kustom |
| Ring Kustom | Ring yang dikonfigurasi dengan aturan, visibilitas, dan otoritas kustom |
| Auditor | Peninjau yang dikonfigurasi untuk Ring Kustom. Auditor dapat membaca data ring, tetapi tidak dapat membelanjakan dana |
| Penanda Tangan Bersama | Penanda tangan opsional yang dikonfigurasi dan harus menyetujui transfer tertentu |
| Otoritas Pembekuan | Otoritas yang dikonfigurasi dan dapat membekukan atau mencairkan saldo jika diizinkan oleh kebijakan |
| Delegasi Permanen | Otoritas yang dikonfigurasi dan dapat memindahkan saldo di dalam ring jika diizinkan oleh kebijakan |
| Privacy API | API Helius untuk membuat Dompet Privat, membaca saldo/riwayat, menyiapkan transfer, menghasilkan bukti, dan mengirimkan transaksi |
## Cara Kerjanya
Dompet Privat adalah objek API inti yang berinteraksi dengan Anda. Misalnya, Anda dapat memetakan Dompet Privat ke akun pelanggan, akun pedagang, akun karyawan, akun perbendaharaan, atau akun pintar.
Saldo dan transfer privat dienkripsi secara onchain. Penyedia RPC seperti Helius mengindeks status terenkripsi, menghasilkan bukti, menyusun transaksi, dan mengirimkannya ke Solana sesuai permintaan.
Untuk sebagian besar kasus penggunaan perusahaan, Dompet Privat berada di dalam Ring Kustom khusus. Ring tersebut menentukan aturan untuk transfer, visibilitas, dan kepatuhan.
Berikut cara Helius Privacy terintegrasi dengan stack Anda:
### Model Kepercayaan
| Komponen | Tanggung Jawab |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Aplikasi Perusahaan | UI produk, autentikasi pelanggan, alur kerja bisnis |
| Penyedia Dompet | Kustodi akun, penanda tangan, kebijakan persetujuan, dan kunci privasi yang tidak dapat diekspor dengan operasi kunci yang dikontrol kebijakan |
| Privacy API / Penyedia RPC | Private Wallet API, sinkronisasi, status, pembuatan bukti, penyusunan transaksi, audit opsional, dan pengiriman transaksi ke jaringan Solana |
| Ring Kustom | Aturan bisnis, aturan kepatuhan, aturan visibilitas, dan otoritas opsional yang ditentukan melalui instruksi program kustom secara onchain |
| Solana | Eksekusi dan penyelesaian |
Pembayaran privat memerlukan otorisasi dari dompet privat dan harus mematuhi kebijakan ring terkait.
Ring rahasia (Ring Default dan Ring Kustom rahasia) mendukung dekripsi lokal dan terdelegasi. Ring Kustom anonim hanya mendukung dekripsi terdelegasi.
Dalam mode dekripsi terdelegasi, dompet dan penyedia RPC yang dipilih berbagi kunci tampilan.
Penyedia dapat menyajikan saldo dan riwayat, tetapi tidak dapat mengotorisasi pembelanjaan.
Hal ini berbeda dari auditor, yang visibilitasnya ditentukan oleh kebijakan Ring.
Anda dapat menjalankan sendiri infrastrukturnya (RPC, pengindeks, server auditor, atau penanda tangan bersama), atau menggunakan penyedia RPC seperti Helius untuk menjalankannya bagi Anda.
Kami menjalankan infrastruktur melalui armada RPC berkinerja tinggi global kami, serta secara opsional melalui penyiapan khusus yang dapat disesuaikan dengan kebutuhan Anda.
Infrastruktur khusus tidak berarti pohon status onchain yang terpisah.
Ring Kustom dan Ring Default tanpa izin menggunakan satu pohon Merkle yang sama.
### Ring
Ring membuat privasi di Solana dapat diprogram, serupa dengan Token-2022.
Ring Default tidak memerlukan izin dan tidak memiliki kebijakan kustom. Ring Kustom diatur oleh kumpulan aturan kebijakannya sendiri.
Satu Dompet Privat dapat menyimpan saldo di beberapa Ring secara bersamaan. Ring yang menaungi suatu saldo bukan merupakan properti dompet. Ring tersebut merupakan properti setiap UTXO yang disimpan dalam bidang `policy_program_id` miliknya.
* Ring default bersifat rahasia dan tanpa izin, tanpa kebijakan, auditor, atau otoritas apa pun. Ring rahasia mengenkripsi aset dan jumlah.
* Ring kustom dapat dikonfigurasi dengan kebijakan serta kontrol kepatuhan kustom, dan dapat bersifat rahasia atau anonim (aset, jumlah, pengirim, dan penerima terenkripsi).
Dompet privat dapat menarik dana dari Ring Kustom ke akun token publik, ke Ring Default yang rahasia dan tanpa izin, atau ke
Ring Kustom lain jika diizinkan oleh kebijakan ring sumber.
#### Ring Kustom Dapat Diprogram
Ring Kustom dapat menentukan aturan yang sepenuhnya kustom untuk transfer dan visibilitas/audit.
Jika ingin menyiapkan Ring Kustom Anda sendiri, [hubungi kami](https://www.helius.dev/contact) dan kami akan membantu menyiapkannya.
Anda dapat menggunakan sistem kepatuhan Anda sendiri atau solusi KYC dan penyaringan sanksi terkelola dari Helius.
Ring dapat diprogram. Contoh aturan yang umum meliputi:
| Kebijakan | Contoh |
| ----------------------- | ------------------------------------------------------------------------------------- |
| Aset yang diizinkan | Hanya USDC atau stablecoin tertentu yang diterbitkan |
| Batas transfer | Memerlukan persetujuan tambahan di atas ambang batas |
| Penandatanganan bersama | Memerlukan persetujuan kepatuhan untuk pembayaran tertentu |
| Daftar izin | Hanya mengizinkan transfer ke akun, pedagang, atau ring yang disetujui |
| Daftar blokir | Memblokir tujuan yang dikenai sanksi atau berisiko |
| Bekukan/cairkan | Membekukan saldo selama investigasi berlangsung |
| Delegasi permanen | Mengizinkan otoritas yang dikonfigurasi untuk memindahkan dana sesuai kebijakan |
| Visibilitas auditor | Memungkinkan tim kepatuhan, akuntansi, atau regulator melihat aktivitas ring |
| Aturan lintas ring | Mengizinkan atau memblokir perpindahan di antara ring tertentu |
| Aturan penarikan | Membatasi penarikan publik atau mewajibkan persetujuan |
| Dukungan akun pintar | Memungkinkan penggunaan native dengan akun pintar seperti Squads |
| Pemulihan akun | Mengizinkan otoritas yang dikonfigurasi atau identitas cadangan untuk memulihkan akun |
Kumpulan aturan kustom tersebut diprogram sebagai program Solana khusus yang memverifikasi transisi status setiap transfer yang berlaku sebelum diselesaikan secara atomik dan onchain melalui Solana Privacy Protocol (TSPP).
## Administrasi Ring
### Pelaporan Ring
Gunakan pelaporan ring untuk perbendaharaan, akuntansi, kepatuhan, atau kumpulan aturan visibilitas Anda sendiri.
```bash theme={"system"}
curl "https://privacy.helius.xyz/v1/rings/ring_acme_usdc/transactions?limit=100" \
-H "Authorization: Bearer $HELIUS_API_KEY"
```
Contoh respons:
```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"
}
}
]
}
```
Akses auditor hanya bersifat baca. Auditor dapat melihat data yang dikonfigurasi oleh kebijakan ring, tetapi tidak dapat menandatangani, membelanjakan, membekukan, atau memindahkan dana kecuali dikonfigurasi secara terpisah sebagai otoritas.
### Membekukan atau Mencairkan Dompet Privat
Jika Ring Kustom memiliki otoritas pembekuan, Anda dapat membekukan atau mencairkan Dompet Privat sesuai kebijakan.
```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"
}
}'
```
Contoh respons:
```json theme={"system"}
{
"id": "pw_2W6Qk...",
"status": "frozen",
"reason": "compliance_review"
}
```
Cairkan:
```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"
}
}'
```
## Pemantauan melalui Webhook
Gunakan webhook untuk pembaruan siklus hidup transfer.
```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"
}'
```
Contoh peristiwa:
```json theme={"system"}
{
"type": "private_wallet.transaction_confirmed",
"ringId": "ring_acme_usdc",
"owner": "9xQeWvG816bUx9EPf...",
"privateWalletId": "pw_2W6Qk...",
"signature": "3jd...",
"slot": 291044120
}
```
## Properti Keamanan dan Privasi
* Kunci API Helius mengautentikasi proyek perusahaan. Kunci tersebut tidak mengotorisasi pembelanjaan. Otorisasi pembelanjaan memerlukan tanda tangan dompet, otorisasi alternatif melalui layanan pengelolaan kunci yang mendasarinya (seperti Privy atau Turnkey), atau kebijakan ring jika dikonfigurasi.
* Materi kunci privat disimpan dalam infrastruktur aman yang dikelola Penyedia Dompet.
* Helius tidak menerima atau mengekspor kunci privat untuk pembelanjaan.
* Dalam mode dekripsi terdelegasi, dompet dan penyedia berbagi kunci tampilan. Penyedia dapat membaca saldo dan riwayat, tetapi tidak dapat mengotorisasi pembelanjaan.
* Auditor Ring Kustom dapat melihat aktivitas ring yang dikonfigurasi, tetapi tidak dapat membelanjakan dana.
* Transaksi ke atau di dalam Ring Kustom memanggil program kebijakannya secara publik.
* Penanda tangan bersama menyetujui transfer tertentu, tetapi tidak dapat membelanjakan dana sendiri kecuali diizinkan oleh kebijakan.
* Otoritas pembekuan hanya dapat membekukan atau mencairkan saldo jika diizinkan oleh kebijakan ring.
* Delegasi permanen hanya dapat memindahkan saldo jika dikonfigurasi secara eksplisit dalam kebijakan ring.
* Transfer privat di dalam ring tidak mengungkapkan aset atau jumlah secara onchain. Ring rahasia mengungkapkan pengirim dan penerima; ring anonim menggunakan relayer dan tidak mengungkapkan salah satu pihak. Kebijakan ring dapat menentukan visibilitas tambahan.
* Penarikan mengungkapkan tujuan, aset, dan jumlah.
* Setoran kripto publik mengungkapkan sumber, aset, dan jumlah. On-ramp dari saldo fiat menjaga aset dan jumlah tetap privat (terenkripsi secara onchain).
* Transfer publik mengungkapkan pengirim, penerima, aset, dan jumlah.
## Tidak menemukan yang Anda cari?
Hubungi kami! [Telegram](https://t.me/tilo_light) | [Email](mailto:sales@helius.xyz) | [Kontak](https://www.helius.dev/contact)