Ephemeral SPL Token을 활용한 프라이빗 결제

---

​

빠른 접근

예제 확인:

---

​

개요

프라이빗 결제는 ER의 SPL token을 기반으로 하는 프라이버시 사용 사례입니다. 동일한 입금 / 전송 / 출금 프리미티브가 프라이빗 가시성으로 실행되므로 결제 금액, 목적지, 시점이 공개되지 않고 보호됩니다. 프라이빗 결제를 구축하는 가장 쉬운 방법은 호스팅 Ephemeral SPL Token API를 사용하는 것입니다. 사용자가 서명하고 제출할 수 있는 미서명 트랜잭션을 반환합니다.

---

​

프라이버시 모델

프라이빗 결제는 다음 요소를 사용합니다:

• 프라이빗 가시성 — visibility: "private"로 Ephemeral Rollup 내부에서 전송을 실행하므로 공개적으로 브로드캐스트되지 않습니다.
• Stealth handle — raw public key 대신 alice@magicblock.id 같은 읽기 쉬운 이름으로 전송합니다. handle은 stealth pool을 통해 하나 이상의 목적지 key로 해석되어 온체인에서 발신자 → 수신자의 직접 연결을 끊습니다.
• 대기열 기반 정산 — 프라이빗 전송은 즉시 연결할 수 있는 직접 이동 대신 프로그램의 transfer queue를 통해 정산할 수 있습니다.

---

​

인증

프라이빗 데이터 조회와 stealth-pool 작업에는 bearer token이 필요합니다. 보호된 endpoint를 호출하기 전에 challenge/login 흐름으로 token을 발급받으세요:

---

​

입금

token을 mint의 Global Vault로 이동하고 입금자의 ephemeral ATA 잔액을 증가시킵니다.

• POST /v1/spl/deposit — 입금 트랜잭션을 생성합니다. 입금 잔액을 프라이빗하게 유지하려면 private: true를 설정하세요.

응답에는 미서명 트랜잭션과 sendTo 필드(base 또는 ephemeral)가 포함됩니다. 서명한 뒤 POST /v1/transaction/send 또는 자체 RPC로 제출하세요.

---

​

프라이빗 전송

• POST /v1/spl/transfer with visibility: "private".

목적지 모드는 두 가지입니다: stealth handle을 사용하려면 먼저 초기화하세요:

• POST /v1/spl/stealth-pool — handle(UTF-8 255 byte 이하, 정규화되지 않으므로 Alice@… ≠ alice@…)을 1~10개의 목적지 owner key에 매핑하고 필요하면 결제를 분할합니다.
• GET /v1/spl/stealth-pool?handle=… — handle의 pool이 존재하는지 확인합니다.

---

​

출금

잔액을 Global Vault에서 표준 base-layer SPL token account로 되돌립니다.

• POST /v1/spl/withdraw — 출금 트랜잭션을 생성합니다.

언제든 잔액을 확인할 수 있습니다:

• GET /v1/spl/balance — 공개 잔액.
• GET /v1/spl/private-balance — 프라이빗 잔액(bearer token 필요).

---

​

개발자 참고 사항

• 프라이버시는 스펙트럼입니다. Ephemeral SPL token은 연결 가능성을 낮추지만 금액이나 시점을 숨기거나 네트워크 수준의 분석을 막지는 않습니다.
• handle은 정규화되지 않습니다. 대소문자와 공백이 중요하므로 일관되게 표시하고 저장하세요.
• 흐름을 맞추세요. Stealth-handle 전송에는 visibility: "private", fromBalance: "base", toBalance: "base"가 필요합니다(필드 생략 시에도 이 값이 기본값입니다).
• 서명한 뒤 전송하세요. Builder endpoint는 미서명 트랜잭션을 반환합니다. POST /v1/transaction/send로 제출하고 반환된 sendTo를 따르세요.

---

​

다음 단계