> ## 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 для агентов

> Полное руководство по Helius TypeScript SDK для ИИ-агентов: типобезопасные методы Solana для DAS API, транзакций, Sender, вебхуков и ZK Compression.

[Helius TypeScript SDK](https://github.com/helius-labs/helius-sdk) предоставляет типобезопасные методы для всех API Helius, позволяя агентам максимально быстро взаимодействовать с 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()` и т. д. | Получение данных об NFT, токенах и сжатых активах |
| RPC V2 | `helius.getTransactionsForAddress()`, `helius.getProgramAccountsV2()` | Расширенный RPC с пагинацией и фильтрами |
| Транзакции | `helius.tx.*` | Умные транзакции и Helius Sender |
| Расширенные функции | `helius.enhanced.*` | Преобразование транзакций в удобочитаемый формат |
| Вебхуки | `helius.webhooks.*` | Создание подписок на вебхуки и управление ими |
| WebSocket | `helius.ws.*` | Потоки данных блокчейна в реальном времени |
| Стейкинг | `helius.stake.*` | Стейкинг SOL у валидатора Helius |
| ZK Compression | `helius.zk.*` | Сжатые учетные записи и доказательства |
| API кошелька | `helius.wallet.*` | Балансы, история и поиск идентификационных данных |
| Стандартный RPC | `helius.getBalance()`, `helius.getSlot()` и т. д. | Все стандартные методы Solana RPC через прокси |
| Низкоуровневый RPC | `helius.raw` | Прямой доступ к базовому клиенту Rpc `@solana/kit` |
| Аутентификация | `import { makeAuthClient } from "helius-sdk/auth/client"` | Регистрация агентов и управление ключами API (отдельный импорт) |

## Программная регистрация (модуль аутентификации)

Модуль аутентификации импортируется отдельно и недоступен в основном `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="Best Practices" icon="lightbulb" href="/docs/ru/agents/typescript-sdk/best-practices">
    Рекомендуемые шаблоны, пагинация, распространенные ошибки и их обработка
  </Card>

  <Card title="API Reference" icon="book" href="/docs/ru/agents/typescript-sdk/api-reference">
    Полный список методов для каждого пространства имен
  </Card>
</CardGroup>

## Ресурсы

<CardGroup cols={2}>
  <Card title="GitHub Repository" icon="github" href="https://github.com/helius-labs/helius-sdk">
    Исходный код, примеры и отслеживание проблем
  </Card>

  <Card title="Code Examples" icon="code" href="https://github.com/helius-labs/helius-sdk/tree/main/examples">
    Рабочие примеры для каждого метода, сгруппированные по пространствам имен
  </Card>

  <Card title="SDK API Docs (TypeDoc)" icon="book" href="https://helius-labs.github.io/helius-sdk/">
    Полная документация API, созданная на основе исходного кода
  </Card>

  <Card title="Migration Guide (1.x to 2.x)" icon="arrow-right" href="https://github.com/helius-labs/helius-sdk/blob/main/MIGRATION.md">
    Переход с @solana/web3.js на @solana/kit
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.