> ## 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 chính thức để phát triển trên Solana. Cài đặt helius-sdk, truy xuất tài sản bằng DAS API và xử lý các lỗi phổ biến cũng như mã trạng thái RPC.

Helius TypeScript SDK ([`helius-sdk`](https://github.com/helius-labs/helius-sdk)) giúp việc phát triển trên Solana bằng TypeScript trở nên dễ dàng hơn — trong Node.js, trình duyệt hoặc bất kỳ môi trường chạy nào khác. Trang này hướng dẫn cách cài đặt và sử dụng SDK, xử lý các lỗi phổ biến và tìm tài liệu mới nhất.

Lưu ý rằng SDK đã được viết lại kể từ phiên bản 2.0.0. Thay đổi này nhằm sử dụng `@solana/kit` và loại bỏ phần phụ thuộc vào các phiên bản `@solana/web3.js` cao hơn 1.73.2. Nếu đang chuyển sang phiên bản mới nhất, vui lòng tham khảo [hướng dẫn di chuyển](https://github.com/helius-labs/helius-sdk/blob/main/MIGRATION.md) của chúng tôi.

<CardGroup cols={1}>
  <Card title="GitHub Repository" icon="js" href="https://github.com/helius-labs/helius-sdk">
    Helius TypeScript SDK chính thức để phát triển trên Solana
  </Card>
</CardGroup>

## Cài đặt

Có thể cài đặt Helius TypeScript SDK bằng bất kỳ trình quản lý gói nào sau đây:

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

## Bắt đầu nhanh

Dưới đây là ví dụ đơn giản về cách sử dụng TypeScript SDK để truy xuất danh sách tài sản thuộc sở hữu của một địa chỉ cụ thể:

```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);
  }
})();
```

## Tài liệu

[Thư mục ví dụ](https://github.com/helius-labs/helius-sdk/tree/main/examples) có các ví dụ mã chuyên sâu về từng phương thức và cách sử dụng cơ bản, được sắp xếp theo không gian tên. Để xem tài liệu tham khảo API, hãy tham khảo [tài liệu](/docs/vi/api-reference) của chúng tôi và [tài liệu Solana chính thức](https://solana.com/docs/rpc) để được trợ giúp chung về Solana JSON RPC API. Để được trợ giúp chung về Kit, vui lòng tham khảo [tài liệu của Kit](https://www.solanakit.com/).

## Xử lý lỗi

Một thông báo lỗi sẽ được đưa ra khi API trả về trạng thái không thành công (tức là mã trạng thái 4xx hoặc 5xx).

Ví dụ, dưới đây là lỗi 401 được đưa ra khi gọi getAsset không chính xác:

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

### Các mã lỗi phổ biến

Khi làm việc với Helius SDK, bạn có thể gặp một số mã lỗi. Dưới đây là thông tin chi tiết về một số mã lỗi phổ biến cùng với thông tin bổ sung để hỗ trợ khắc phục sự cố:

<AccordionGroup>
  <Accordion title="400: Bad Request">
    Lỗi này xảy ra khi một yêu cầu chứa các tham số không hợp lệ.
  </Accordion>

  <Accordion title="401: Unauthorized">
    Lỗi này xảy ra khi cung cấp khóa API không hợp lệ hoặc quyền truy cập bị hạn chế do các quy tắc RPC.
  </Accordion>

  <Accordion title="429: Too Many Requests">
    Lỗi này cho biết người dùng đã vượt quá giới hạn yêu cầu trong một khoảng thời gian nhất định hoặc đã hết tín dụng.
  </Accordion>

  <Accordion title="5XX: Internal Server Error">
    Đây là thông báo lỗi chung cho các sự cố phía máy chủ. Vui lòng liên hệ với bộ phận hỗ trợ của Helius để được trợ giúp.
  </Accordion>
</AccordionGroup>

Nếu gặp bất kỳ lỗi nào trong số này:

<Steps>
  <Step title="Check error documentation">
    Tham khảo [các lỗi của Kit](https://www.solanakit.com/docs/concepts/errors) để xem danh sách những lỗi bạn có thể gặp phải
  </Step>

  <Step title="Review the documentation">
    Tham khảo [tài liệu Helius](/docs/) để biết thêm hướng dẫn
  </Step>

  <Step title="Contact support">
    Liên hệ với đội ngũ hỗ trợ của Helius để được trợ giúp chi tiết hơn
  </Step>
</Steps>

## Đóng góp

Chúng tôi hoan nghênh mọi đóng góp cho các SDK của mình! Hãy đọc [hướng dẫn đóng góp](https://github.com/helius-labs/helius-sdk/blob/main/CONTRIBUTING.md) trước khi mở pull request.