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:

{
  "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

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

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

// 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

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 for detailed security practices.

Detailed References

• references/helius-api.md — Full Helius API reference

• references/security.md — Wallet security best practices

• references/jupiter.md — Jupiter swap integration

Common Token Addresses

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