> ## 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를 통해 Solana에서 기관을 위한 프로그래머블 정책 및 준수 제어 기능과 함께 개인 스테이블코인 결제 및 잔액을 추가하십시오.
이 가이드는 프라이빗 결제 계정을 블록체인의 이점과 결합하고자 하는 핀테크, 발행사, 급여 플랫폼, 송금 회사, 네오뱅크, 기업을 위한 것입니다.
## 개요
귀사의 비즈니스는 다음을 수행할 수 있습니다:
1. 고객, 상인 또는 금고 계정을 위한 프라이빗 월렛 생성
2. 공공에서 프라이빗 월렛으로 스테이블코인 입금
3. 프라이빗 월렛 간의 개인 결제
4. 공공 Solana 주소 및 월렛으로 출금
5. API를 통해 개인 잔액 및 이력 보기
6. 귀사의 준수, 감사 및 비즈니스 규칙으로 전용 맞춤형 링 정의
귀사의 준수 규정을 가져오거나 Helius의 관리형 KYC 및 제재 심사 솔루션을 사용할 수 있습니다.
7. 링 내에서 자금을 보기, 승인, 동결 또는 이동할 수 있는 사람 구성
8. 폴링 또는 웹훅을 통해 프라이빗 결제 상태 추적
| 용어 | 의미 |
| --------- | -------------------------------------------------------------------------------------------------------- |
| 기업 | Helius Privacy를 통합하는 회사 |
| 프라이빗 월렛 | 암호화된 온체인 잔액 및 전송을 갖춘 결제 계정 |
| 월렛 제공자 | 사용자 계정, 서명자, 스마트 계정 또는 금고 월렛을 관리하고 비수출성 프라이버시 키를 보유하는 시스템. 예로는 Turnkey, Privy, Squads, Rain, 또는 내부 관리 스택 |
| 소유자 | 프라이빗 월렛 작업을 승인하는 Solana 공개 키, 스마트 계정 또는 제공자에서 지원하는 서명자 |
| 인박스 | 프라이빗 월렛의 공공 수신 주소로 사용되는 Solana 공개 키 |
| 링 | 기본 링 또는 맞춤형 링에 잔액이 있는 프라이빗 월렛 그룹 |
| 기본 링 | 비허가형 비밀 링; 자산과 금액은 비공개이나 송신자와 수신자는 공개 상태. 맞춤형 정책, 권한 또는 감사 없음 |
| 맞춤형 링 | 맞춤형 규칙, 가시성 및 권한으로 구성된 링 |
| 감사관 | 맞춤형 링의 구성된 뷰어. 감사관은 링 데이터를 읽을 수 있지만 지출할 수 없음 |
| 공동 서명자 | 선택된 전송을 승인해야 할 선택적으로 구성된 서명자 |
| 동결 권한 | 정책이 허용하는 경우 잔액을 동결하거나 해동할 수 있는 구성된 권한 |
| 영구 대리인 | 정책이 허용하는 경우 링 내에서 잔액을 이동할 수 있는 구성된 권한 |
| 프라이버시 API | 프라이빗 월렛 생성, 잔액/이력 읽기, 전송 준비, 증명 생성 및 트랜잭션 제출을 위한 Helius API |
## 작동 방식
프라이빗 월렛은 상호작용하는 핵심 API 객체입니다. 예를 들어 고객 계정, 상인 계정, 직원 계정, 금고 계정 또는 스마트 계정에 프라이빗 월렛을 매핑할 수 있습니다.
잔액 및 개인 전송은 온체인으로 암호화됩니다. Helius와 같은 RPC 제공자는 암호화된 상태를 인덱싱하고, 증명을 생성하고, 트랜잭션을 작성하여 필요에 따라 Solana에 제출합니다.
대부분의 기업 사용 사례에서는 프라이빗 월렛이 전용 맞춤형 링 내에 존재합니다. 링은 전송, 가시성 및 준수의 규칙을 정의합니다.
Helius Privacy가 아키텍처에 적합한 방법은 다음과 같습니다:
### 신뢰 모델
| 구성 요소 | 책임 |
| ------------------- | ---------------------------------------------------------------- |
| 기업 앱 | 제품 UI, 고객 인증, 비즈니스 워크플로 |
| 월렛 제공자 | 계정 보관, 서명자, 승인 정책 및 정책 제어 키 작업을 갖춘 비수출성 프라이버시 키 |
| 프라이버시 API / RPC 제공자 | 프라이빗 월렛 API, 동기화, 상태, 증명, 트랜잭션 생성, 선택적 감사 및 Solana 네트워크로 트랜잭션 제출 |
| 맞춤형 링 | 비즈니스 규칙, 준수 규칙, 가시성 규칙, 선택적 권한을 맞춤형 프로그램 지침으로 온체인 지정 |
| Solana | 실행 및 결제 |
개인 결제는 프라이빗 월렛의 허가를 받아야 하며 해당 링 정책을 준수해야 합니다.
비밀 링(기본 링 및 비밀 맞춤형 링)은 로컬 및 위임 해독을 지원합니다. 익명 맞춤형 링은 위임 해독만 지원합니다.
위임 해독 모드에서는 월렛과 선택된 RPC 제공자가 보기 키를 공유합니다.
제공자는 잔액과 이력을 제공할 수 있지만 지출을 승인할 수는 없습니다.
이는 링 정책에 의해 정의된 감사관과는 다른 역할입니다.
귀사는 인프라(RPC, 인덱서, 감사 서버 또는 공동 서명자)를 직접 운영하거나, Helius와 같은 RPC 제공자를 통해 운영할 수 있습니다.
당사는 고성능 RPC 글로벌 네트워크를 통해 인프라를 운영하며 요구사항에 맞춰 전용 설정을 통해 선택적으로 운영할 수 있습니다.
전용 인프라는 별도의 온체인 상태 트리를 의미하지 않습니다.
맞춤형 링과 비허가형 기본 링은 하나의 머클 트리를 공유합니다.
### 링
링은 Solana에서의 프라이버시를 Token-2022와 유사하게 프로그래머블하게 만듭니다.
기본 링은 비허가형으로 맞춤형 정책이 없습니다. 맞춤형 링은 자체 정책 규칙 세트에 의해 관리됩니다.
하나의 프라이빗 월렛은 여러 링에 동시에 잔액을 보유할 수 있습니다. 어느 링에 잔액이 속하는지는 월렛의 속성이 아닙니다. 각 UTXO의 `policy_program_id` 필드에 저장됩니다.
* 기본 링은 비밀적이고 비허가형으로 정책, 감사관 또는 권한이 없습니다. 비밀 링은 자산과 금액을 암호화합니다.
* 맞춤형 링은 맞춤형 정책 및 준수 제어로 구성될 수 있으며 비밀적이거나 익명일 수 있습니다(암호화된 자산, 금액, 송신자, 수신자).
프라이빗 월렛은 맞춤형 링에서 공공 토큰 계정으로, 비밀적이고 비허가형 기본 링으로 또는 소스 링 정책이 허용하는 경우 다른 맞춤형 링으로 출금할 수 있습니다.
#### 맞춤형 링은 프로그래머블입니다
맞춤형 링은 전송 및 가시성/감사에 대한 완전한 맞춤형 규칙을 정의할 수 있습니다.
자신의 맞춤형 링을 설정하고 싶으면, [연락하십시오](https://www.helius.dev/contact) 그러면 설정해 드리겠습니다.
귀사의 준수 규정을 가져오거나 Helius의 관리형 KYC 및 제재 심사 솔루션을 사용할 수 있습니다.
링은 프로그래머블합니다. 자주 사용되는 규칙의 예는 다음과 같습니다:
| 정책 | 예시 |
| --------- | ------------------------------------- |
| 허용 자산 | USDC 또는 특정 발행 스테이블코인만 허용 |
| 전송 한도 | 임계값 이상에는 추가 승인이 필요 |
| 공동 서명 | 선택된 결제에 대해 준수 승인이 필요 |
| 허용목록 | 승인된 계정, 상인 또는 링으로만 전송 허용 |
| 차단목록 | 제재 또는 위험 대상 차단 |
| 동결/해동 | 조사가 진행 중일 때 잔액 동결 |
| 영구 대리인 | 정책 하에 자금을 이동할 수 있는 구성된 권한 허용 |
| 감사관 가시성 | 준수 규정, 회계, 또는 규제 당국이 링 활동을 볼 수 있도록 허용 |
| 교차 링 규칙 | 특정 링 간 이동 허용 또는 차단 |
| 출금 규칙 | 공공 출금을 제한하거나 승인을 요구 |
| 스마트 계정 지원 | Squads와 같은 스마트 계정과의 네이티브 사용 허용 |
| 계정 복구 | 구성된 권한 또는 백업 신원이 계정을 복구할 수 있도록 허용 |
이러한 맞춤형 규칙 세트는 Solana Privacy Protocol (TSPP)을 통해 온체인에서 원자적으로 정산되기 전에 각 전송의 상태 전환을 검증하는 전용 Solana 프로그램으로 프로그래밍됩니다.
## 링 관리
### 링 보고
재무, 회계, 규정 준수 또는 귀사의 가시성 규칙 세트를 위해 링 보고를 사용하십시오.
```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"
}
}'
```
## 웹훅을 통한 모니터링
전송 수명 주기 업데이트를 위해 웹훅을 사용하십시오.
```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)