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

# SDK TypeScript Helius Solana

> SDK TypeScript resmi Helius untuk pengembangan Solana. Instal helius-sdk, ambil aset dengan API DAS, serta tangani kesalahan umum dan kode status RPC.

SDK TypeScript Helius ([`helius-sdk`](https://github.com/helius-labs/helius-sdk)) mempermudah pengembangan di Solana dengan TypeScript — di Node.js, browser, atau runtime lainnya. Halaman ini membahas cara menginstal dan menggunakan SDK, menangani kesalahan umum, serta menemukan dokumentasi terbaru.

Perhatikan bahwa SDK telah ditulis ulang sejak versi 2.0.0. Hal ini dilakukan untuk menggunakan `@solana/kit` dan menghapus dependensi pada versi `@solana/web3.js` yang lebih tinggi dari 1.73.2. Jika Anda bermigrasi ke versi terbaru, silakan lihat [panduan migrasi](https://github.com/helius-labs/helius-sdk/blob/main/MIGRATION.md) kami.

<CardGroup cols={1}>
  <Card title="GitHub Repository" icon="js" href="https://github.com/helius-labs/helius-sdk">
    SDK TypeScript resmi Helius untuk pengembangan Solana
  </Card>
</CardGroup>

## Instalasi

SDK TypeScript Helius dapat diinstal dengan salah satu pengelola paket berikut:

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

## Mulai Cepat

Berikut adalah contoh sederhana cara menggunakan SDK TypeScript untuk mengambil daftar aset yang dimiliki oleh alamat tertentu:

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

## Dokumentasi

[Direktori contoh](https://github.com/helius-labs/helius-sdk/tree/main/examples) berisi contoh kode mendalam yang mencakup setiap metode dan penggunaan dasar, yang disusun berdasarkan namespace. Untuk dokumentasi referensi API, lihat [dokumentasi](/docs/id/api-reference) kami dan [dokumentasi resmi Solana](https://solana.com/docs/rpc) untuk bantuan umum terkait API JSON RPC Solana. Untuk bantuan umum terkait Kit, silakan lihat [dokumentasi Kit](https://www.solanakit.com/).

## Penanganan Kesalahan

Pesan kesalahan akan ditampilkan ketika API mengembalikan status tidak berhasil (yaitu, kode status 4xx atau 5xx).

Misalnya, berikut adalah kesalahan 401 yang ditampilkan untuk pemanggilan getAsset yang tidak tepat:

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

### Kode Kesalahan Umum

Saat menggunakan SDK Helius, Anda mungkin menemukan beberapa kode kesalahan. Tabel berikut menjelaskan beberapa kode kesalahan umum beserta informasi tambahan untuk membantu Anda memecahkan masalah:

<AccordionGroup>
  <Accordion title="400: Bad Request">
    Ini terjadi ketika permintaan memiliki parameter yang tidak valid.
  </Accordion>

  <Accordion title="401: Unauthorized">
    Ini terjadi ketika kunci API yang diberikan tidak valid atau akses dibatasi karena aturan RPC.
  </Accordion>

  <Accordion title="429: Too Many Requests">
    Ini menunjukkan bahwa pengguna telah melampaui batas permintaan dalam jangka waktu tertentu atau kehabisan kredit.
  </Accordion>

  <Accordion title="5XX: Internal Server Error">
    Ini adalah pesan kesalahan umum untuk masalah di sisi server. Silakan hubungi dukungan Helius untuk mendapatkan bantuan.
  </Accordion>
</AccordionGroup>

Jika Anda menemukan salah satu kesalahan ini:

<Steps>
  <Step title="Check error documentation">
    Lihat [daftar kesalahan Kit](https://www.solanakit.com/docs/concepts/errors) untuk mengetahui kesalahan yang mungkin Anda temukan
  </Step>

  <Step title="Review the documentation">
    Lihat [dokumentasi Helius](/docs/) untuk panduan lebih lanjut
  </Step>

  <Step title="Contact support">
    Hubungi tim dukungan Helius untuk mendapatkan bantuan yang lebih mendetail
  </Step>
</Steps>

## Berkontribusi

Kami menyambut semua kontribusi untuk SDK kami! Baca [panduan kontribusi](https://github.com/helius-labs/helius-sdk/blob/main/CONTRIBUTING.md) sebelum membuka pull request.