Skip to main content
  1. 인출은 토큰을 개인 잔액에서 공개 Solana 잔액으로 이동합니다.
  2. 인출은 단일 Solana 트랜잭션으로 Solana 지갑 주소에 전송됩니다.

인출: 비공개란 무엇인가

허가 없는 Ring은 암호화된 금액과 자산이 비공개입니다. 맞춤형 Ring은 비공개 또는 익명으로 (암호화된 발신자, 수신자, 자산 및 금액) 구성할 수 있습니다.

인출 방식

인출은 공개 Solana 전송과 유사하게 작동합니다:
  1. 사용자의 SOL 또는 SPL 잔액이 온체인에서 암호화됩니다.
  2. 사용자가 개인 상태를 해독하고, 지갑이 인출을 구축하며, 소유자가 서명합니다.
    • 전용 RPC 메서드로 암호화된 상태를 가져옵니다. 사용자만이 로컬에서 잔액을 해독할 수 있습니다.
    • 지갑이 금액과 수신자를 설정한 후 ZK 증명을 요청합니다. RPC 제공자가 기본적으로 ZK 증명을 생성하여 반환합니다.
  3. Solana 런타임은 서명을 확인하고, Solana Privacy Program을 호출하여 암호화된 상태를 공개하지 않고 ZK 증명을 검증합니다.
  4. 앱은 Solana 트랜잭션 해시를 통해 상태를 추적합니다.
  1. 사용자의 SOL 또는 SPL 잔액이 온체인에서 공개됩니다.
  2. 지갑이 공개 상태를 읽고, 전송을 구축하며, 소유자가 서명합니다.
  3. Solana 런타임은 서명을 확인하고 System Program 또는 Token Program을 호출하여 공개 잔액을 업데이트합니다.
  4. 앱은 Solana 트랜잭션 해시를 통해 상태를 추적합니다.
이것은 허가 없는 비공개 Ring에 대한 상위 수준의 트랜잭션 흐름입니다. 개념에서 맞춤형 링과 비교해보세요.

시작하기

1

사전 조건

TypeScript 예제는 Node.js 24 이상, pnpm 11.18.0, 그리고 Solana CLI가 필요합니다.
출처: sdk-libs/ts
Helius API 키 추가:
.env
예제는 기본적으로 Solana CLI 지갑을 지불자로 사용합니다. 지불자는 devnet SOL을 보유해야 합니다. 테스트넷 SOL 받는 방법을 참조하세요.
2

공공 잔액으로 인출

  • SDK는 지시문을 반환합니다. 앱이 이를 서명하고 보냅니다.
  • sendAndConfirmFactory는 Kit 트랜잭션을 생성하고 제출하며 서명과 상륙한 슬롯을 반환합니다.
  • 이전 전송 후 남은 Private Solana Token Account를 지출합니다. 인출은 여러 UTXO를 지출할 수 있습니다.
  • withdrawalUtxo는 해당 잔액에서 하나의 Private Solana Token Account를 선택합니다.
  • ProofInputUtxo.fromKeypair는 발신자의 개인 지갑 키쌍으로 선택된 UTXO를 증명 입력으로 준비합니다.
  • 키쌍은 입력 UTXO를 지출로 표시하는 무효 값을 도출하지만 입력 자산과 금액은 암호화 상태로 남습니다.
  • senderAddress는 송신자의 입니다. 출금 시 이 지갑의 자금을 사용합니다.
  • [withdrawalInput]는 송신자가 선택한 UTXO 목록입니다. 한 번의 출금에서 여러 UTXO를 사용할 수 있습니다.
  • senderSigner.address는 수수료 납부자의 Solana 주소입니다. 가스 스폰서가 수수료를 납부할 수 있습니다.
  • WithdrawalTarget.sol는 공개 Solana 수신자입니다. 수신자는 소유자 또는 제3자일 수 있습니다.
  • SOL_MINT는 SOL을 선택합니다. SPL 또는 Token 2022 출금에서는 토큰 민트를 전달합니다.
  • WITHDRAW_AMOUNT는 자산의 기본 단위로 표시됩니다. SOL은 lamport를 사용합니다. SPL 및 Token 2022 자산은 토큰의 기본 단위를 사용합니다.
  • withdrawal.sign는 상태 전환을 승인하고, 남은 비공개 잔돈을 암호화하며, 영지식 증명기에 필요한 입력을 생성합니다.
  • assets는 지원되는 비공개 자산을 확인하는 데 사용되는 자산 레지스트리입니다.
  • senderKeys는 LocalKeys.fromKeypair(sender, client.proofService)를 사용하여 송신자의 키로 증명 생성을 승인합니다.
  • client.proveTransact는 서명된 출금에서 영지식 증명을 생성하고 직렬화된 명령 데이터를 반환합니다.
  • 이 증명은 송신자가 입력을 소유하고 사용할 수 있음을 입증합니다. 출금 자산과 금액은 공개됩니다. 입력 금액과 잔돈은 암호화된 상태로 유지됩니다.
  • payer는 Solana 트랜잭션에 서명하고 수수료를 납부합니다. 가스 스폰서가 수수료를 납부할 수 있습니다.
  • inputTree와 outputTree는 client.tree입니다. 이는 사용된 UTXO를 포함하고 송신자의 비공개 잔돈을 수신하는 상태 Merkle 트리입니다.
  • withdrawal는 공개 Solana 수신자 계정인 TransactWithdrawal.sol입니다.
  • await transactInstruction는 nullifier 계정 주소를 로컬에서 파생하고 명령을 반환합니다. nullifier 계정은 입력 UTXO를 사용된 것으로 표시하여 비공개 잔액이 이중으로 사용되지 않도록 합니다.
  • data에는 이전 단계에서 생성된 영지식 증명과 암호화된 잔돈이 포함됩니다.
  • 출금은 자산을 비공개 잔액에서 공개 Solana 계정으로 이동합니다. 이때 공개 수신자 계정을 전달합니다.
  • sendAndConfirm는 withdrawalInstruction를 Solana 트랜잭션으로 서명하고 제출합니다.
  • 확인을 통해 색인기 페치를 기준으로 하는 상륙한 슬롯을 제공합니다.

전체 코드 예제

예제를 클론하고 실행하세요:
예제에서는 여기의 로컬/devnet에 있는 기밀 Ring을 사용합니다.
deposit_transfer_withdraw.ts

관련 가이드

Deposit

Transfer

Read a Private Balance

Read Private History

원하는 정보를 찾지 못하셨나요?

문의하세요! Telegram | 이메일 | Typeform