> ## 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 de Rust de Helius para agentes
> Guía completa del SDK de Rust de Helius para agentes de IA: enlaces asíncronos de Rust para Solana, DAS API, transacciones, Sender, webhooks, WebSockets y staking.
El [SDK de Rust de Helius](https://github.com/helius-labs/helius-rust-sdk) proporciona enlaces asíncronos de Rust para todas las API de Helius, ideales para cargas de trabajo de agentes de alto rendimiento.
* **Crate**: `helius` (crates.io)
* **Versión**: 1.x (usa `solana-client` 3.0, `solana-sdk` 3.0)
* **Entorno de ejecución**: Asíncrono (`tokio` 1.x)
* **Rust**: 1.85+ (edición 2021)
* **Cliente HTTP**: `reqwest`
* **Licencia**: MIT
## Instalación
```toml theme={"system"}
[dependencies]
helius = "1.0.0"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
solana-sdk = "3.0.0"
```
El crate usa `native-tls` de forma predeterminada. Para usar TLS implementado por completo en Rust, lo cual resulta útil cuando OpenSSL no está disponible, usa:
```toml theme={"system"}
helius = { version = "1.0.0", default-features = false, features = ["rustls"] }
```
## Inicio rápido
```rust theme={"system"}
use helius::error::Result;
use helius::types::*;
use helius::Helius;
#[tokio::main]
async fn main() -> Result<()> {
let helius = Helius::new("YOUR_API_KEY", Cluster::MainnetBeta)?;
// Get all NFTs owned by a wallet
let assets = helius.rpc().get_assets_by_owner(GetAssetsByOwner {
owner_address: "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY".to_string(),
page: 1,
limit: Some(50),
..Default::default()
}).await?;
// Get transaction history (with token account activity)
let txs = helius.rpc().get_transactions_for_address(
"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY".to_string(),
GetTransactionsForAddressOptions {
limit: Some(100),
transaction_details: Some(TransactionDetails::Full),
filters: Some(GetTransactionsFilters {
token_accounts: Some(TokenAccountsFilter::BalanceChanged),
..Default::default()
}),
..Default::default()
},
).await?;
// Send a transaction via Helius Sender (ultra-low latency)
let sig = helius.send_smart_transaction_with_sender(
SmartTransactionConfig {
create_config: CreateSmartTransactionConfig {
instructions: vec![transfer_instruction],
signers: vec![wallet_signer],
..Default::default()
},
..Default::default()
},
SenderSendOptions {
region: "US_EAST".to_string(),
..Default::default()
},
).await?;
Ok(())
}
```
## Constructores del cliente
### `Helius::new` — Cliente síncrono básico
```rust theme={"system"}
let helius = Helius::new("YOUR_API_KEY", Cluster::MainnetBeta)?;
```
Es el constructor más sencillo. No requiere `.await`. Proporciona métodos RPC, webhooks, transacciones mejoradas, transacciones inteligentes y la API de billetera. No admite un cliente asíncrono de Solana ni WebSocket.
### `Helius::new_async` — Cliente asíncrono con todas las funciones
```rust theme={"system"}
let helius = Helius::new_async("YOUR_API_KEY", Cluster::MainnetBeta).await?;
```
Se recomienda para producción. Incluye un cliente RPC asíncrono de Solana y transmisión mejorada por WebSocket. Requiere `.await` porque establece una conexión WebSocket.
### `Helius::new_with_url` — Punto de conexión RPC personalizado
```rust theme={"system"}
let helius = Helius::new_with_url("http://localhost:8899")?;
```
Para nodos RPC dedicados, proxies o desarrollo local. No requiere una clave de API.
### `HeliusBuilder` — Configuración avanzada
```rust theme={"system"}
use helius::HeliusBuilder;
let helius = HeliusBuilder::new()
.with_api_key("YOUR_API_KEY")?
.with_cluster(Cluster::MainnetBeta)
.with_async_solana()
.with_websocket(None, None)
.with_commitment(CommitmentConfig::confirmed())
.build()
.await?;
```
### `HeliusFactory` — Varios clústeres
```rust theme={"system"}
let factory = HeliusFactory::new("YOUR_API_KEY");
let devnet_client = factory.create(Cluster::Devnet)?;
let mainnet_client = factory.create(Cluster::MainnetBeta)?;
```
### Acceso a los clientes de Solana integrados
```rust theme={"system"}
helius.connection() // Sync SolanaRpcClient (Arc)
helius.async_connection()? // Async SolanaRpcClient (requires new_async or HeliusBuilder)
helius.ws() // Enhanced WebSocket (Option)
helius.rpc() // Helius RpcClient (Arc)
helius.config() // Config (Arc)
```
## Análisis detallados
Patrones recomendados, paginación, errores comunes y gestión de errores
Lista completa de métodos para cada categoría
## Recursos
Código fuente, ejemplos y seguimiento de incidencias
Documentación completa de la API en docs.rs
Ejemplos funcionales de cada función, organizados por categoría
Actualiza de solana-sdk 1.x a 3.0