Skip to main content

설치

npm(Node.js 18+)에서 helius-wallet-kit을 설치합니다:
필수 피어 종속성:
  • react >= 18
  • react-dom >= 18
  • @solana/web3.js ^1.98
next >= 14선택적 피어입니다 — 서버 라우트 핸들러를 사용하는 경우 설치하십시오.

설정

1

앱을 제공자에 래핑

클라이언트 컴포넌트 내 앱의 루트 근처에 HeliusWalletProvider을 추가하고 Helius API 키를 전달합니다. 이것이 유일한 필수 구성이며 — SDK가 프로젝트 ID와 키가 없는 보안 RPC URL을 자동으로 해결합니다.
app/providers.tsx
사용자들이 대시보드에서 보게 될 로그인 방법을 선택 — 로그인 방법 구성을 참조하세요. 클라이언트 키는 브라우저에서 노출되므로, 도메인에 고정 — 키 보안을 참조하세요.
2

스타일 가져오기

SDK 스타일시트를 루트 레이아웃에서 한 번 가져옵니다:
app/layout.tsx
3

(선택 사항) 서버 라우트 핸들러 추가

기본적으로 SDK는 프로젝트의 키가 없는 보안 RPC URL을 사용하여 브라우저에서 Helius와 직접 통신합니다 — 서버 라우트를 필요로 하지 않습니다. 자신의 서버를 통해 RPC, 송신 및 거래 내역 호출을 라우팅하려면 (그리고 발신자 최적화 착륙 및 거래 내역을 사용하려면), /api/helius/[...path]에 catch-all 라우트 핸들러를 마운트합니다:
app/api/helius/[...path]/route.ts
HELIUS_API_KEY를 서버 환경 변수로 설정합니다; 핸들러는 해당 전달 요청에 이를 삽입합니다.
지갑 부트스트랩은 여전히 클라이언트 측의 apiKey를 사용합니다 — 제공자 config에 전달되고 브라우저의 /waas/config에 전송됩니다 — 따라서 라우트 핸들러가 있어도 키는 브라우저에 존재합니다. 도메인 제한 키를 사용하십시오 (대시보드에서 키에 허용된 출처 설정) 앱의 출처에 스코프하며, 필요시 회전하십시오. 완전한 서버 측 키 핸들링은 로드맵에 있습니다. 자세한 내용은 키 보안을 참조하십시오.

다음 단계

구성

구성 옵션 및 대시보드 로그인 방법.

지갑 사용

인증 상태 읽기, 서명, 송신 및 내역 읽기.