> ## 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.

# WaaS 빠른 시작

> Helius wallet-kit SDK를 설치하고 한 공급자와 내장된 지갑을 연결합니다.

## 설치

npm(Node.js 18+)에서 [`helius-wallet-kit`](https://www.npmjs.com/package/helius-wallet-kit)을 설치합니다:

```bash theme={"system"}
pnpm add helius-wallet-kit
```

필수 피어 종속성:

* `react >= 18`
* `react-dom >= 18`
* `@solana/web3.js ^1.98`

`next >= 14`은 **선택적** 피어입니다 — 서버 라우트 핸들러를 사용하는 경우 설치하십시오.

## 설정

<Steps>
  <Step title="앱을 제공자에 래핑">
    클라이언트 컴포넌트 내 앱의 루트 근처에 `HeliusWalletProvider`을 추가하고 Helius API 키를 전달합니다. 이것이 유일한 필수 구성이며 — SDK가 프로젝트 ID와 키가 없는 보안 RPC URL을 자동으로 해결합니다.

    ```tsx app/providers.tsx theme={"system"}
    "use client";

    import { HeliusWalletProvider } from "helius-wallet-kit";

    export function Providers({ children }: { children: React.ReactNode }) {
      return (
        <HeliusWalletProvider
          config={{
            apiKey: process.env.NEXT_PUBLIC_HELIUS_API_KEY!,
            cluster: "devnet",
          }}
        >
          {children}
        </HeliusWalletProvider>
      );
    }
    ```

    사용자들이 대시보드에서 보게 될 로그인 방법을 선택 — [로그인 방법 구성](/docs/ko/waas/configuration#로그인-방법-구성)을 참조하세요. 클라이언트 키는 브라우저에서 노출되므로, 도메인에 고정 — [키 보안](/docs/ko/waas/securing-your-key)을 참조하세요.
  </Step>

  <Step title="스타일 가져오기">
    SDK 스타일시트를 루트 레이아웃에서 한 번 가져옵니다:

    ```tsx app/layout.tsx theme={"system"}
    import "helius-wallet-kit/ui/styles.css";
    ```
  </Step>

  <Step title="(선택 사항) 서버 라우트 핸들러 추가">
    기본적으로 SDK는 프로젝트의 키가 없는 보안 RPC URL을 사용하여 브라우저에서 Helius와 직접 통신합니다 — 서버 라우트를 필요로 하지 않습니다. 자신의 서버를 통해 RPC, 송신 및 거래 내역 호출을 라우팅하려면 (그리고 [발신자 최적화 착륙](/docs/ko/sending-transactions/sender) 및 거래 내역을 사용하려면), `/api/helius/[...path]`에 catch-all 라우트 핸들러를 마운트합니다:

    ```ts app/api/helius/[...path]/route.ts theme={"system"}
    import { createHeliusRouteHandler } from "helius-wallet-kit/next";

    export const { GET, POST } = createHeliusRouteHandler();
    ```

    `HELIUS_API_KEY`를 서버 환경 변수로 설정합니다; 핸들러는 해당 전달 요청에 이를 삽입합니다.

    <Note>
      지갑 **부트스트랩**은 여전히 클라이언트 측의 `apiKey`를 사용합니다 —
      제공자 `config`에 전달되고 브라우저의 `/waas/config`에 전송됩니다 —
      따라서 라우트 핸들러가 있어도 키는 브라우저에 존재합니다. **도메인 제한 키**를 사용하십시오
      (대시보드에서 키에 허용된 출처 설정) 앱의 출처에 스코프하며, 필요시 회전하십시오.
      완전한 서버 측 키 핸들링은 로드맵에 있습니다. 자세한 내용은 [키 보안](/docs/ko/waas/securing-your-key)을 참조하십시오.
    </Note>
  </Step>
</Steps>

## 다음 단계

<CardGroup cols={2}>
  <Card title="구성" icon="sliders" href="/docs/ko/waas/configuration">
    구성 옵션 및 대시보드 로그인 방법.
  </Card>

  <Card title="지갑 사용" icon="wallet" href="/docs/ko/waas/using-the-wallet">
    인증 상태 읽기, 서명, 송신 및 내역 읽기.
  </Card>
</CardGroup>