Skip to main content
Privy에서 마이그레이션하는 것은 지갑 마이그레이션이 아닌 코드 마이그레이션입니다. Privy의 공급자와 훅을 Helius의 것으로 교체하면 됩니다. 정신 모델(임베디드, 비관리형, 소셜/패스키 로그인)은 동일합니다. 이전되지 않는 것은 사용자들의 기존 지갑입니다. Privy 지갑은 Turnkey로 가져올 수 없으므로, 모든 사용자는 앱에 처음 로그인할 때 새로운 Helius 임베디드 지갑을 받습니다. 다른 큰 변화는 경제성입니다. Privy는 RPC 위에 월간 활성 지갑당 요금을 청구하지만, Helius는 이미 보유한 credits를 통해 서명당 200 크레딧을 청구합니다.

​
이전되는 것과 그렇지 않은 것

  • 이전되는 것(통합): 공급자, 훅, 로그인 구성, RPC. 이는 아래 단계에서의 코드 교체로, 보통 몇 시간의 작업이 필요합니다.
  • 이전되지 않는 것(사용자들의 지갑): 기존 Privy 지갑, 키, 잔액은 이전되지 않습니다. Turnkey에서 가져올 수 없기 때문에, 각 사용자는 처음 로그인 시 새로운 Helius 임베디드 지갑을 생성합니다.
1,000명의 Privy 사용자가 자금을 가지고 있는 경우: 마이그레이션 후, 사용자는 로그인하면서 다른 주소에 새롭고 빈 Helius 임베디드 지갑을 받습니다. 그들의 Privy 잔액은 옛 지갑에 남습니다. 자금 이동은 별도의 사용자 주도 단계로, 사용자가 조정합니다(자세한 내용은 Your users’ wallets and funds 참조) — Helius나 Turnkey는 사용자를 대신하여 자금을 이동할 수 없습니다.

​
Privy와 Helius WaaS 매핑

​
통합 마이그레이션

이 단계들은 Privy에서 Helius로 코드를 교체합니다. 이 과정은 최종 사용자 지갑에 영향을 주지 않습니다 — 이는 아래에서 다룹니다.
1

공급자 교체

PrivyProvider을 HeliusWalletProvider로 교체하고 Privy 대신 Helius API 키를 전달합니다. 설정을 참조하세요.
2

훅 교체

usePrivy() / useSolanaWallets() 호출을 useHeliusWallet()로 교체하세요. login, logout, user, 그리고 exportWallet이 직접 매핑됩니다; 서명은 동일한 훅(signTransaction, signAndSendTransaction, signMessage)으로 이동합니다.
3

인증 구성 대시보드로 이동

공급자 속성 대신 WaaS → Configuration에서 대시보드의 로그인 방법을 구성하세요 — 로그인 방법 구성을 참조하세요.
4

RPC를 Helius에 맞추세요

이미 Helius를 통해 라우팅합니다. 독립 RPC 공급자 구성을 제거하고 후크의 connection / rpcUrl을 사용하세요, 또는 라우트 핸들러를 추가하여 발신자 최적화 상륙을 위한 설정을 하세요.

​
사용자들의 지갑과 자금

교체 작업 후 첫 로그인 시, 각 사용자는 새로운 임베디드 Helius 지갑을 받습니다 — Privy 지갑과는 다른 주소이며, 잔액은 0입니다. 기존 Privy 지갑과 그 자금은 변경되지 않습니다. 사용자들이 기존 잔액을 유지해야 하는 경우, 마이그레이션 기간을 계획하세요:
1

새 주소 표시

로그인한 사용자에게 새로운 Helius 주소를 보여줍니다 (address from useHeliusWallet()).
2

사용자가 자금을 이동하도록 하세요

사용자는 자신의 Privy 지갑에서 새 Helius 주소로 자금을 이체합니다. 이는 사용자마다, 사용자 주도의 작업입니다 — Helius나 Turnkey는 사용자를 대신하여 자금을 이동할 수 없습니다.
3

기존 통합 종료

사용자가 Helius 지갑으로 이동한 후, Privy SDK를 제거하세요.
사용자가 기존 지갑을 계속 사용할 수는 없나요? 임베디드 지갑의 대체품으로는 사용할 수 없습니다. 외부 지갑은 로그인 방법으로 제공됩니다 — 이는 Helius 임베디드 지갑으로 사용자를 인증하지, 외부 지갑의 키를 직접 작동하진 않습니다. 외부 지갑에서 직접 서명하면 Helius를 완전히 우회하는 것이 됩니다 (Turnkey 서명 없음, 측정 없음), 따라서 앱이 운영하는 임베디드 지갑의 대체품이 될 수 없습니다.