Skip to main content

Prerequisites

Before integrating Solar Sentra, ensure you have:
  • Node.js 18.0 or higher
  • A Solana wallet address to track
  • API key from Solar Sentra dashboard

Installation

Install the Solar Sentra SDK via npm or yarn:
path=null start=null
npm install @solar-sentra/sdk
path=null start=null
yarn add @solar-sentra/sdk

Authentication

Initialize the SDK with your API key:
path=null start=null
import { SolarSentra } from '@solar-sentra/sdk';

const client = new SolarSentra({
  apiKey: process.env.SOLAR_SENTRA_API_KEY,
  network: 'mainnet-beta'
});
Store your API key in environment variables. Never commit keys to version control.

Basic Usage

Track a Wallet

path=null start=null
const walletAddress = '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU';

const walletData = await client.wallet.track(walletAddress);

console.log(walletData);
// Output:
// {
//   address: '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
//   balance: 125.42,
//   tokenAccounts: 23,
//   lastActivity: '2025-10-16T14:21:00Z'
// }

Get Transaction History

path=null start=null
const transactions = await client.wallet.getTransactions(
  walletAddress,
  { limit: 50, order: 'desc' }
);

transactions.forEach(tx => {
  console.log(`${tx.signature}: ${tx.type} - ${tx.amount} SOL`);
});

Real-Time Monitoring

path=null start=null
const subscription = client.wallet.subscribe(walletAddress);

subscription.on('transaction', (tx) => {
  console.log('New transaction:', tx);
});

subscription.on('balance', (balance) => {
  console.log('Balance updated:', balance);
});

Response Format

All API responses follow this structure:
path=null start=null
{
  "success": true,
  "data": { },
  "timestamp": "2025-10-16T14:21:06Z",
  "rateLimit": {
    "remaining": 98,
    "reset": 1728936000
  }
}

Error Handling

path=null start=null
try {
  const data = await client.wallet.track(walletAddress);
} catch (error) {
  if (error.code === 'RATE_LIMIT_EXCEEDED') {
    console.log('Too many requests. Retry after:', error.retryAfter);
  } else if (error.code === 'INVALID_ADDRESS') {
    console.log('Wallet address is invalid');
  } else {
    console.error('Unknown error:', error.message);
  }
}

Next Steps

1

Explore SDK

Learn about advanced features and configuration options
2

API Reference

View complete API documentation and endpoints
3

Use Cases

Discover real-world implementation examples
I