> ## 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 TypeScript SDK for Agents

> AIエージェント向けHelius TypeScript SDKの完全ガイド。DAS API、トランザクション、Helius Sender、webhooks、WebSockets、ステーキング、ZK圧縮、プログラムによるサインアップのための型安全なメソッド。

[Helius TypeScript SDK](https://github.com/helius-labs/helius-sdk)は、すべてのHelius APIに対する型安全なメソッドを提供し、エージェントがSolanaとやり取りするための最速の方法です。

* **パッケージ**: `helius-sdk` (npm / pnpm / yarn)
* **バージョン**: 2.x (使用しているのは`@solana/kit`、`@solana/web3.js`ではありません)
* **ランタイム**: 任意のJavaScriptランタイム — ブラウザ、Deno、Bun、エッジランタイム (Cloudflare Workers、Vercel Edge)、Node.js 20+
* **TypeScript**: 5.8+ (完全な型定義を含む)
* **ライセンス**: ISC

## インストール

```bash theme={"system"}
npm install helius-sdk
```

## クイックスタート

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

const helius = createHelius({
  apiKey: "YOUR_API_KEY",
  network: "mainnet", // or "devnet"
});

// Get all NFTs and tokens owned by a wallet
const assets = await helius.getAssetsByOwner({
  ownerAddress: "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
  page: 1,
  limit: 50,
});

// Get transaction history (with token account activity)
const txs = await helius.getTransactionsForAddress([
  "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
  { limit: 100, transactionDetails: "full", filters: { tokenAccounts: "balanceChanged" } },
]);

// Send a transaction via Helius Sender (ultra-low latency)
const sig = await helius.tx.sendTransactionWithSender({
  instructions: [transferInstruction],
  signers: [walletSigner],
  region: "US_EAST",
});
```

## クライアントオプション

```typescript theme={"system"}
const helius = createHelius({
  apiKey: "YOUR_API_KEY",       // Required for webhooks, enhanced txs, wallet API
  network: "mainnet",           // "mainnet" (default) or "devnet"
  baseUrl: "https://custom..",  // Override RPC URL (optional)
  rebateAddress: "wallet",      // Wallet for RPC rebates (optional)
  userAgent: "my-agent/1.0",   // Sent as X-Helius-Client header (optional)
});
```

## 名前空間

すべてのメソッドは`helius`クライアントを通じてアクセスされます。DAS APIメソッドと標準のSolana RPCメソッドは`helius.*`で直接利用可能です。他の機能は名前空間に整理されています:

| 名前空間           | アクセス                                                                  | 目的                                   |
| -------------- | --------------------------------------------------------------------- | ------------------------------------ |
| DAS API        | `helius.getAsset()`, `helius.getAssetsByOwner()`, etc.                | NFT、トークン、圧縮資産のクエリ                    |
| RPC V2         | `helius.getTransactionsForAddress()`, `helius.getProgramAccountsV2()` | ページネーションとフィルタ機能を持つRPC拡張              |
| Transactions   | `helius.tx.*`                                                         | スマートトランザクションとHelius Sender           |
| Enhanced       | `helius.enhanced.*`                                                   | 人間が読み取り可能な形式へのトランザクション解析             |
| Webhooks       | `helius.webhooks.*`                                                   | Webhookサブスクリプションの作成と管理               |
| WebSockets     | `helius.ws.*`                                                         | リアルタイムブロックチェーンデータストリーム               |
| Staking        | `helius.stake.*`                                                      | HeliusバリデータへのSOLステーキング               |
| ZK Compression | `helius.zk.*`                                                         | 圧縮アカウントと証明                           |
| Wallet API     | `helius.wallet.*`                                                     | 残高、履歴、IDルックアップ                       |
| Standard RPC   | `helius.getBalance()`, `helius.getSlot()`, etc.                       | プロキシを通じたすべての標準Solana RPCメソッド         |
| Raw RPC        | `helius.raw`                                                          | 基盤となる`@solana/kit` Rpcクライアントへの直接アクセス |
| Auth           | `import { makeAuthClient } from "helius-sdk/auth/client"`             | エージェントサインアップとAPIキー管理 (スタンドアロンのインポート) |

## プログラムによるサインアップ (Authモジュール)

Authモジュールはスタンドアロンのインポートで、メインの`HeliusClient`にはありません。プログラムによるエージェントサインアップフローに使用します。

```typescript theme={"system"}
import { makeAuthClient } from "helius-sdk/auth/client";

const auth = makeAuthClient();

// Hosted-link signup (returns a paymentUrl the user opens in a browser):
const link = await auth.signup({
  secretKey: keypair.secretKey,
  plan: "agent",
  email: "you@example.com",
  firstName: "Ada",
  lastName: "Lovelace",
});
// link: { kind: "payment_required", jwt, refId, walletAddress, paymentLink: { paymentUrl, ... } }

// Or pay USDC directly from the local keypair and provision in one call:
const result = await auth.signupAndPay({
  secretKey: keypair.secretKey,
  plan: "agent",
  email: "you@example.com",
  firstName: "Ada",
  lastName: "Lovelace",
});
// result.kind: "completed" | "pending" | "expired" | "failed" | "already_subscribed" | "upgrade_required"
// On "completed": result has { jwt, walletAddress, projectId, apiKey, endpoints, txSignature }
```

## 詳細情報

<CardGroup cols={2}>
  <Card title="ベストプラクティス" icon="lightbulb" href="/ja/agents/typescript-sdk/best-practices">
    推奨パターン、ページネーション、一般的な間違い、およびエラーハンドリング
  </Card>

  <Card title="APIリファレンス" icon="book" href="/ja/agents/typescript-sdk/api-reference">
    各名前空間の完全なメソッドリスト
  </Card>
</CardGroup>

## リソース

<CardGroup cols={2}>
  <Card title="GitHubリポジトリ" icon="github" href="https://github.com/helius-labs/helius-sdk">
    ソースコード、例、問題追跡
  </Card>

  <Card title="コード例" icon="code" href="https://github.com/helius-labs/helius-sdk/tree/main/examples">
    各メソッドの動作例を名前空間別に整理
  </Card>

  <Card title="SDK APIドキュメント (TypeDoc)" icon="book" href="https://helius-labs.github.io/helius-sdk/">
    ソースから生成された完全なAPIドキュメント
  </Card>

  <Card title="マイグレーションガイド (1.xから2.x)" icon="arrow-right" href="https://github.com/helius-labs/helius-sdk/blob/main/MIGRATION.md">
    @solana/web3.jsから@solana/kitへのアップグレード
  </Card>
</CardGroup>