> ## 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 für Agents
> Kompletter Leitfaden für das Helius TypeScript SDK für KI-Agents — typsichere Solana-Methoden für die DAS API, Transaktionen, Sender, Webhooks und ZK-Komprimierung.
Das [Helius TypeScript SDK](https://github.com/helius-labs/helius-sdk) bietet typsichere Methoden für alle Helius APIs und ist der schnellste Weg für Agents, mit Solana zu interagieren.
* **Paket**: `helius-sdk` (npm / pnpm / yarn)
* **Version**: 2.x (verwendet `@solana/kit`, nicht `@solana/web3.js`)
* **Laufzeit**: Jede JavaScript-Laufzeit — Browser, Deno, Bun, Edge-Laufzeiten (Cloudflare Workers, Vercel Edge), Node.js 20+
* **TypeScript**: 5.8+ (vollständige Typdefinitionen enthalten)
* **Lizenz**: ISC
## Installation
```bash theme={"system"}
npm install helius-sdk
```
## Schnellstart
```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",
});
```
## Client-Optionen
```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)
});
```
## Namensräume
Alle Methoden werden über den `helius`-Client aufgerufen. DAS API-Methoden und Standard-Solana-RPC-Methoden sind direkt auf `helius.*` verfügbar. Andere Funktionalitäten sind in Namensräume organisiert:
| Namensraum | Zugriff | Zweck |
| -------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------- |
| DAS API | `helius.getAsset()`, `helius.getAssetsByOwner()`, etc. | Abfrage von NFTs, Tokens, komprimierte Assets |
| RPC V2 | `helius.getTransactionsForAddress()`, `helius.getProgramAccountsV2()` | Erweiterte RPC mit Paginierung und Filtern |
| Transaktionen | `helius.tx.*` | Intelligente Transaktionen und Helius Sender |
| Erweitert | `helius.enhanced.*` | Transaktionen in ein menschenlesbares Format parsen |
| Webhooks | `helius.webhooks.*` | Erstellen und Verwalten von Webhook-Abonnements |
| WebSockets | `helius.ws.*` | Echtzeit-Blockchain-Datenströme |
| Staking | `helius.stake.*` | SOL an Helius-Validator staken |
| ZK-Kompression | `helius.zk.*` | Komprimierte Konten und Beweise |
| Wallet API | `helius.wallet.*` | Salden, Verlauf, Identitätsabfragen |
| Standard-RPC | `helius.getBalance()`, `helius.getSlot()`, etc. | Alle Standard-Solana-RPC-Methoden über Proxy |
| Roher RPC | `helius.raw` | Direkter Zugriff auf den zugrunde liegenden `@solana/kit`-RPC-Client |
| Auth | `import { makeAuthClient } from "helius-sdk/auth/client"` | Agenten-Registrierung und API-Schlüsselverwaltung (Standalone-Import) |
## Programmatische Registrierung (Auth-Modul)
Das Auth-Modul ist ein eigenständiger Import — es befindet sich nicht auf dem Haupt- `HeliusClient`. Verwenden Sie es für programmgesteuerte Agenten-Registrierungsabläufe.
```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 }
```
## Vertiefungen
Empfohlene Muster, Paginierung, häufige Fehler und Fehlerbehandlung
Vollständige Methodenliste für jeden Namensraum
## Ressourcen
Quellcode, Beispiele und Problemverfolgung
Funktionierende Beispiele für jede Methode, organisiert nach Namensraum
Vollständige API-Dokumentation, generiert aus dem Quellcode
Upgrade von @solana/web3.js zu @solana/kit