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

# Helius Solana TypeScript SDK

> 솔라나 개발을 위한 공식 Helius TypeScript SDK입니다. helius-sdk를 설치하고, 첫 번째 쿼리를 실행하고, 포괄적인 API, 향상된 트랜잭션 및 DAS 지원으로 오류를 처리하세요.

Helius TypeScript SDK ([`helius-sdk`](https://github.com/helius-labs/helius-sdk))는 Node.js, 브라우저 또는 기타 런타임에서 TypeScript로 Solana 개발을 더 쉽게 만듭니다. 이 페이지에서는 SDK 설치 및 사용, 일반적인 오류 처리, 최신 문서 찾는 방법을 다룹니다.

SDK는 버전 2.0.0부터 새롭게 작성되었습니다. 이것은 `@solana/kit`를 사용하고 1.73.2보다 높은 `@solana/web3.js` 버전에 대한 의존성을 제거하기 위해 수행되었습니다. 최신 버전으로 마이그레이션하는 경우 [마이그레이션 가이드](https://github.com/helius-labs/helius-sdk/blob/main/MIGRATION.md)를 참조하세요.

<CardGroup cols={1}>
  <Card title="GitHub Repository" icon="js" href="https://github.com/helius-labs/helius-sdk">
    Solana 개발을 위한 공식 Helius TypeScript SDK
  </Card>
</CardGroup>

## 설치

Helius TypeScript SDK는 다음 패키지 관리자를 사용하여 설치할 수 있습니다:

<Tabs>
  <Tab title="npm">
    ```bash theme={"system"}
    npm install helius-sdk
    ```
  </Tab>

  <Tab title="pnpm">
    ```bash theme={"system"}
    pnpm install helius-sdk
    ```
  </Tab>

  <Tab title="Yarn">
    ```bash theme={"system"}
    yarn add helius-sdk
    ```
  </Tab>
</Tabs>

## 빠른 시작

아래는 주어진 주소가 소유한 자산 목록을 가져오기 위해 TypeScript SDK를 사용하는 간단한 예입니다:

```typescript theme={"system"}
import { createHelius } from "helius-sdk";

(async () => {
  const apiKey = ""; // From Helius dashboard
  const helius = createHelius({ apiKey });

  try {
    const assets = await helius.getAssetsByOwner({
      ownerAddress: "owner_address_goes_here",
      page: 1,
      limit: 50,
      sortBy: { sortBy: "created", sortDirection: "asc" },
    });

    console.log("Fetched assets:", assets);
  } catch (error) {
    console.error("Error:", error);
  }
})();
```

## 문서

[예제 디렉토리](https://github.com/helius-labs/helius-sdk/tree/main/examples)는 각 메서드와 기본 사용법을 다루는 심층 코드 예제로 가득하며 네임스페이스별로 조직되어 있습니다. API 참조 문서는 [문서](/docs/ko/api-reference)와 일반적인 Solana JSON RPC API 도움말을 위한 [공식 Solana 문서](https://solana.com/docs/rpc)를 참조하세요. Kit에 대한 일반적인 도움말은 [Kit의 문서](https://www.solanakit.com/)를 참조하세요.

## 오류 처리

API가 비성공 (예: 4xx 또는 5xx 상태 코드)를 반환할 때 오류 메시지가 발생합니다.

예를 들어, 아래는 잘못된 getAsset 호출에 대한 401 오류 메시지입니다:

```typescript theme={"system"}
{
  "jsonrpc": "2.0",
  "error": {
    "code": -32001,
    "message": "Authentication failed. Missing or invalid API key."
  },
  "id": "1"
}
```

### 일반 오류 코드

Helius SDK를 사용하다 보면 여러 가지 오류 코드를 접할 수 있습니다. 아래는 문제 해결에 도움이 되는 몇 가지 일반적인 오류 코드와 추가 정보를 제공하는 표입니다:

<AccordionGroup>
  <Accordion title="400: 잘못된 요청">
    잘못된 매개변수가 포함된 요청이 있을 때 발생합니다.
  </Accordion>

  <Accordion title="401: 권한 없음">
    유효하지 않은 API 키가 제공되었거나 RPC 규칙으로 인해 액세스가 제한된 경우 발생합니다.
  </Accordion>

  <Accordion title="429: 너무 많은 요청">
    지정된 시간 내에 요청 한도를 초과했거나 크레딧이 없는 경우입니다.
  </Accordion>

  <Accordion title="5XX: 내부 서버 오류">
    서버 측 문제에 대한 일반 오류 메시지입니다. 도움말이 필요하시면 Helius 지원팀에 문의하세요.
  </Accordion>
</AccordionGroup>

이러한 오류가 발생하면:

<Steps>
  <Step title="오류 문서 확인">
    발생할 수 있는 오류 목록은 [Kit의 오류](https://www.solanakit.com/docs/concepts/errors)를 참조하세요
  </Step>

  <Step title="문서 검토">
    추가 안내는 [Helius 문서](/docs/)를 참조하세요
  </Step>

  <Step title="지원 팀에 문의">
    보다 자세한 도움을 받으려면 Helius 지원 팀에 문의하세요
  </Step>
</Steps>

## 기여하기

SDK에 대한 모든 기여를 환영합니다! 풀 리퀘스트를 열기 전에 [기여 가이드](https://github.com/helius-labs/helius-sdk/blob/main/CONTRIBUTING.md)를 읽어보세요.