solana-skill

# Solana Skill

Comprehensive Solana blockchain interaction using Helius infrastructure.

## Prerequisites

1. **Helius API Key** — Get free at https://dashboard.helius.dev/signup 2. Store key in `~/.config/solana-skill/config.json`: ```json { "heliusApiKey": "your-api-key", "network": "mainnet-beta" } ```

## Core Capabilities

### Wallet Management - Create new wallets (keypair generation) - Import existing wallets (private key or seed phrase) - List managed wallets - Secure key storage (encrypted at rest)

### Balance & Assets - Check SOL balance - Get all token balances (SPL tokens) - View NFTs and compressed NFTs - Portfolio valuation (via DAS API)

### Transactions - Send SOL - Send SPL tokens - Transaction history (enhanced, human-readable) - Priority fee estimation

### Swaps (Jupiter) - Get swap quotes - Execute token swaps - Slippage protection

### Monitoring - Watch addresses for activity - Transaction notifications

## Quick Reference

### Check Balance ```typescript import { createHelius } from 'helius-sdk';

const helius = createHelius({ apiKey: 'YOUR_KEY' }); const assets = await helius.getAssetsByOwner({ ownerAddress: 'WALLET_ADDRESS', displayOptions: { showFungible: true, showNativeBalance: true } }); ```

### Send SOL ```typescript import { Connection, Keypair, SystemProgram, Transaction, sendAndConfirmTransaction, LAMPORTS_PER_SOL } from '@solana/web3.js';

const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=YOUR_KEY'); const tx = new Transaction().add( SystemProgram.transfer({ fromPubkey: sender.publicKey, toPubkey: recipientPubkey, lamports: amount * LAMPORTS_PER_SOL }) ); await sendAndConfirmTransaction(connection, tx, [sender]); ```

### Jupiter Swap ```typescript // 1. Get quote const quote = await fetch(`https://api.jup.ag/swap/v1/quote?inputMint=${inputMint}&outputMint=${outputMint}&amount=${amount}`);

// 2. Build swap transaction const swap = await fetch('https://api.jup.ag/swap/v1/swap', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ quoteResponse: await quote.json(), userPublicKey: wallet.publicKey.toString() }) });

// 3. Sign and send ```

## API Endpoints

| Service | Base URL | |---------|----------| | Helius RPC | `https://mainnet.helius-rpc.com/?api-key=KEY` | | Helius Sender | `https://sender.helius-rpc.com/fast` | | Jupiter Quote | `https://api.jup.ag/swap/v1/quote` | | Jupiter Swap | `https://api.jup.ag/swap/v1/swap` |

## Security

**Critical rules:** - Never log or display private keys - Use encrypted storage for keys - Validate all addresses before transactions - Set reasonable slippage limits (default: 1%) - Always confirm large transactions with user

See [references/security.md](references/security.md) for detailed security practices.

## Detailed References

- [references/helius-api.md](references/helius-api.md) — Full Helius API reference - [references/security.md](references/security.md) — Wallet security best practices - [references/jupiter.md](references/jupiter.md) — Jupiter swap integration

## Common Token Addresses

| Token | Mint Address | |-------|-------------| | SOL | `So11111111111111111111111111111111111111112` (wrapped) | | USDC | `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v` | | USDT | `Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB` | | BONK | `DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263` |

## Error Handling

Common errors and solutions: - **Insufficient SOL**: Need SOL for rent + transaction fees - **Token account not found**: Create ATA before sending tokens - **Transaction too large**: Reduce instructions or use address lookup tables - **Blockhash expired**: Retry with fresh blockhash