> ## 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.
# 企業向けカスタムリング
> プライベートウォレットAPIを介して、ソラナ上でプライベートなステーブルコインの支払いと残高を追加し、機関向けのプログラム可能なポリシーとコンプライアンス管理を提供します。
このガイドは、フィンテック、発行者、給与プラットフォーム、送金会社、ネオバンク、企業向けにプライベートな支払いアカウントとブロックチェーンの利点を組み合わせたい方々のためのものです。
## 概要
ビジネスで次のことが可能になります：
1. 顧客、商人、または財務アカウントのためのプライベートウォレットを作成
2. パブリックウォレットからプライベートウォレットにステーブルコインを預け入れ
3. プライベートウォレット間でプライベート支払いを送信
4. パブリックなソラナアドレスやウォレットに出金
5. APIを通じてプライベート残高と履歴を表示
6. カスタムリングを専用に設定し、独自のコンプライアンス、監査、ビジネスルールを定義
独自のコンプライアンスを持ち込むことも、Heliusの管理KYCおよび制裁スクリーニングソリューションを使用することも可能です。
7. リング内で資金を表示、承認、凍結、または移動する人を設定
8. ポーリングまたはWebhookを介してプライベート支払いのステータスを追跡
| 用語 | 意味 |
| ----------- | ----------------------------------------------------------------------------------------------------------- |
| 企業 | Helius Privacyを統合する会社 |
| プライベートウォレット | 暗号化されたオンチェーン残高および転送を備えた支払いアカウント |
| ウォレットプロバイダー | 顧客アカウント、署名者、スマートアカウント、または財務ウォレットを管理し、非輸出可能なプライバシーキーを保持するシステムです。Turnkey、Privy、Squads、Rain、または内部保管スタックなどが例です。 |
| 所有者 | プライベートウォレットのアクションを承認するソラナのパブリックキー、スマートアカウント、またはプロバイダーバックの署名者 |
| 受信ボックス | プライベートウォレットのパブリック受取アドレスとして使用されるソラナのパブリックキー |
| リング | Default RingまたはCustom Ring内の残高を持つプライベートウォレットのグループ |
| デフォルトリング | パーミッションレスな機密リングです。資産と金額はプライベートですが、送信者と受信者は公開されます。カスタムポリシー、権限、または監査人はありません。 |
| カスタムリング | カスタムルール、可視性、および権限を持つ設定済みのリング |
| 監査人 | カスタムリング用の設定済みビューアーです。監査人はリングデータを読み取ることができますが、使用することはできません。 |
| 共署名者 | 選択された転送を承認する必要がある任意の設定済み署名者です。 |
| 凍結権限 | ポリシーが許可する場合に残高を凍結または解凍できる設定済みの権限です。 |
| 永久デリゲート | ポリシーが許可する場合にリング内で残高を移動できる設定済みの権限です。 |
| プライバシーAPI | プライベートウォレットの作成、残高/履歴の読み取り、転送の準備、証明の生成、およびトランザクションの送信を行うHelius API |
## 動作方法
プライベートウォレットは、あなたが操作する主要なAPIオブジェクトです。たとえば、顧客アカウント、商人アカウント、従業員アカウント、財務アカウント、またはスマートアカウントにプライベートウォレットをマッピングできます。
残高とプライベート転送はオンチェーンで暗号化されます。HeliusのようなRPCプロバイダは暗号化された状態をインデックス化し、証明を生成し、トランザクションを構築し、それを要求に応じてソラナに送信します。
ほとんどの企業用ユースケースでは、プライベートウォレットは専用のカスタムリング内に存在します。リングは転送、可視性、コンプライアンスのルールを定義します。
これはあなたのスタックにHelius Privacyがどのようにフィットするかです：
### 信頼モデル
| コンポーネント | 責任 |
| -------------------------- | ------------------------------------------------------------------- |
| Enterprise App | 製品UI、顧客認証、ビジネスワークフロー |
| Wallet Provider | アカウント保管、署名者、承認ポリシー、ポリシー制御のキー操作を伴う非輸出可能なプライバシーキー |
| Privacy API / RPC Provider | プライベートウォレットAPI、状態同期、証明、トランザクション構築、監査オプション、およびソラナネットワークへのトランザクションの提出 |
| Custom Ring | ビジネスルール、コンプライアンスルール、可視性ルール、オプションの権限をオンチェーンのカスタムプログラム命令で指定 |
| Solana | 実行と決済 |
プライベート支払いは、プライベートウォレットによる承認が必要であり、該当するリングポリシーに準拠する必要があります。
機密リング（デフォルトリングおよび機密カスタムリング）はローカルと委任された復号化をサポートします。匿名カスタムリングは委任された復号化のみサポートします。
委任された復号化モードでは、ウォレットと選択されたRPCプロバイダは閲覧キーを共有します。
プロバイダは残高と履歴を提供できますが、支払いを承認することはできません。
これはリングポリシーによって定義された監査人とは異なります。
自分でインフラストラクチャ（RPC、インデクサ、監査サーバー、または共署名者）を運用することもできますし、HeliusのようなRPCプロバイダーにそれを運営してもらうこともできます。
私たちは高性能RPCのグローバル艦隊を通じて、必要に応じてあなたの要件に合わせてカスタマイズ可能な専用セットアップを通じてインフラストラクチャを運営しています。
専用のインフラストラクチャは、オンチェーンの状態ツリーを分離することは意味しません。
カスタムリングとパーミッションレスなデフォルトリングは、一つのMerkleツリーを共有しています。
### リング
リングはソラナでのプライバシーをプログラム可能にし、Token-2022に似ています。
デフォルトリングはパーミッションレスでカスタムポリシーはありません。カスタムリングは独自のポリシールールセットによって管理されます。
一つのプライベートウォレットは複数のリングで残高を保持することができます。どのリングに残高が属するかはウォレットのプロパティではなく、各UTXOのプロパティであり、その`policy_program_id`フィールドに保存されています。
* デフォルトリングは機密保護され、ポリシー、監査者、または権限がないパーミッションレスです。機密リングは資産と金額を暗号化します。
* カスタムリングはカスタムポリシーおよびコンプライアンス管理で設定可能で、機密または匿名（暗号化された資産、金額、送信者、受信者）です。
プライベートウォレットは、カスタムリングからパブリックトークンアカウント、機密かつパーミッションレスなデフォルトリング、またはソースリングポリシーが許可する場合は別のカスタムリングに出金できます。
#### カスタムリングはプログラム可能
カスタムリングは、転送および可視性/監査のための完全にカスタムルールを定義できます。
独自のカスタムリングを設定したい場合は、[ご連絡ください](https://www.helius.dev/contact) 。セットアップします。
独自のコンプライアンスを持ち込むことも、Heliusの管理KYCおよび制裁スクリーニングソリューションを使用することも可能です。
リングはプログラム可能です。一般的なルールの例は以下の通りです：
| ポリシー | 例 |
| ------------- | --------------------------------- |
| 許可資産 | USDCのみまたは特定の発行ステーブルコイン |
| 転送制限 | しきい値を超える追加の承認が必要 |
| 共署名 | 選択された支払いに対するコンプライアンス承認が必要 |
| 許可リスト | 承認されたアカウント、商人、またはリングへの転送のみ許可 |
| ブロックリスト | 制裁対象またはリスクのある宛先をブロック |
| 凍結/解凍 | 調査が保留中の間、残高を凍結 |
| 永久デリゲート | ポリシーの下で資金を移動するための設定済み権限を許可 |
| 監査可視性 | コンプライアンス、会計、または規制当局がリングアクティビティを表示 |
| クロスリングルール | 特定のリング間の移動を許可またはブロック |
| 出金ルール | 公共の出金を制限または承認が必要 |
| スマートアカウントサポート | Squadsのようなスマートアカウントでのネイティブ使用を許可 |
| アカウント復旧 | 設定された権限またはフォールバックIDでアカウントを復旧 |
これらのカスタムルールセットは、対応する転送の状態遷移を検証した上で、Solana Privacy Protocol（TSPP）を通じてオンチェーンで原子レベルで決済される専用のソラナプログラムとしてプログラムされています。
## リング管理
### リング報告
財務、会計、コンプライアンス、または独自の可視性ルールセットのためにリング報告を使用します。
```bash theme={"system"}
curl "https://privacy.helius.xyz/v1/rings/ring_acme_usdc/transactions?limit=100" \
-H "Authorization: Bearer $HELIUS_API_KEY"
```
例の応答：
```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"
}
}
]
}
```
監査者のアクセスは読み取り専用です。監査者はリングポリシーで設定されたデータを表示できますが、署名、資金の使用、凍結、または移動はできません。別途権限として設定された場合を除き。それらを設定します。
### プライベートウォレットの凍結または解凍
カスタムリングに凍結権限がある場合は、ポリシーに従ってプライベートウォレットを凍結または解凍できます。
```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"
}
}'
```
例の応答：
```json theme={"system"}
{
"id": "pw_2W6Qk...",
"status": "frozen",
"reason": "compliance_review"
}
```
解凍：
```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"
}
}'
```
## Webhooksを使用した監視
転送ライフサイクルの更新のためにWebhooksを使用します。
```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"
}'
```
例のイベント：
```json theme={"system"}
{
"type": "private_wallet.transaction_confirmed",
"ringId": "ring_acme_usdc",
"owner": "9xQeWvG816bUx9EPf...",
"privateWalletId": "pw_2W6Qk...",
"signature": "3jd...",
"slot": 291044120
}
```
## セキュリティとプライバシー特性
* Helius APIキーは企業プロジェクトを認証し、支出を許可しません。支出の承認にはウォレット署名、または基礎となるキー管理サービス（PrivyやTurnkeyなど）を通じた代替承認、または設定されている場合はリングポリシーが必要です。
* プライベートキー素材はウォレットプロバイダー管理の安全なインフラストラクチャ内に保持されます。
* Heliusはプライベート支出キーを受け取らず、またはエクスポートしません。
* 委任された復号化モードでは、ウォレットとプロバイダーは閲覧キーを共有します。プロバイダーは残高と履歴を読み取ることができますが、支出を承認することはできません。
* カスタムリングの監査人は設定されたリングアクティビティを見ることができますが、使用することはできません。
* カスタムリングへのまたはカスタムリング内でのトランザクションはそのポリシープログラムを公開的に呼び出します。
* 共署名者は選択された転送を承認しますが、単独で花音はできません。ポリシーが許可した場合を除きます。
* 凍結権限は、リングポリシーが許可する場合にのみ残高を凍結または解凍できます。
* 永久デリゲートは、リングポリシーで明示的に設定されている場合にのみ残高を移動できます。
* リング内のプライベート転送はオンチェーンで資産や金額を公開しません。機密リングは送信者と受信者を公開し、匿名リングはリレイヤーを使用し、どちらの当事者も公開しません。リングポリシーは追加の可視性を指定する場合があります。
* 出金は宛先、資産、金額を公開します。
* 公共の暗号化預金は、ソース、資産、および金額を公開します。法定残高からのオンランプは資産と金額を秘密のままにします（オンチェーンで暗号化されます）。
* 公共の転送は、送信者、受信者、資産、および金額を公開します。
## Didn't find what you were looking for?
Reach out! [Telegram](https://t.me/tilo_light) | [E-Mail](mailto:sales@helius.xyz) | [Contact](https://www.helius.dev/contact)