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

> Solana開発用の公式Helius TypeScript SDK。helius-sdkをインストールし、最初のクエリを実行し、API、拡張トランザクション、およびDASサポートを含む包括的なエラーを処理します。

Helius TypeScript SDK ([`helius-sdk`](https://github.com/helius-labs/helius-sdk))は、SolanaでのTypeScript開発をNode.js、ブラウザ、または他の実行環境で容易にします。このページでは、SDKのインストールと使用、一般的なエラーの処理、最新のドキュメントの見つけ方について説明します。

バージョン2.0.0からSDKが書き直されました。これは、`@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リポジトリ" 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);
  }
})();
```

## ドキュメンテーション

[examplesディレクトリ](https://github.com/helius-labs/helius-sdk/tree/main/examples)には、各メソッドと基本的な使用法を詳細に説明するコード例が、名前空間ごとに整理されています。APIリファレンスドキュメントについては、[ドキュメント](/docs/ja/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)をお読みください。