@sendo-labs/plugin-sendo-analyser

Sendo Analyser Plugin - A comprehensive Solana wallet analysis plugin that provides real-time transaction decoding, trade analysis, token/NFT holdings, and price performance tracking.

🎯 Overview

The Sendo Analyser plugin transforms ElizaOS agents into Solana blockchain analysts by:

Decoding Solana transactions from multiple DEXs (Jupiter, Raydium, Orca, Meteora, Pumpfun, etc.)
Analyzing trades with real-time and historical price data
Tracking token and NFT holdings
Calculating performance metrics (P&L, ATH missed, win rate)
Paginating results efficiently with cursor-based navigation

Key principle: Real-time blockchain data analysis with comprehensive DEX support and price tracking via Helius and Birdeye APIs.

✨ Features

🔍 Transaction Decoding

Multi-DEX support: Jupiter, Raydium, Orca, Meteora, Pumpfun, Pumpswap, Whirlpool
Automatic protocol detection and instruction parsing
Balance change tracking (SOL and SPL tokens)
Fee and compute budget extraction

📊 Trade Analysis

Real-time price data from Birdeye API
Historical price tracking at transaction time
ATH (All-Time High) analysis
Trade categorization (buy/sell/no_change)
Performance metrics per trade and per token

💰 Portfolio Tracking

Token holdings with balances
NFT collection tracking
SOL balance monitoring
Global portfolio overview

🔄 Cursor-Based Pagination

Efficient navigation through transaction history
Configurable page size (1-50 results)
Pagination metadata with hasMore, nextCursor, currentCursor
Pass-through to Helius for real-time data freshness

📦 Installation

npm install @sendo-labs/plugin-sendo-analyser

or with Bun:

bun add @sendo-labs/plugin-sendo-analyser

🚀 Usage

Basic Setup

import { sendoAnalyserPlugin } from '@sendo-labs/plugin-sendo-analyser';

const agent = {
  plugins: [
    sendoAnalyserPlugin,
    // ... your other plugins
  ],
};

Environment Variables

HELIUS_API_KEY=your_helius_api_key
BIRDEYE_API_KEY=your_birdeye_api_key

REST API Endpoints

The plugin exposes REST endpoints for wallet analysis:

Get Transaction Signatures

GET /signatures/:address?limit=5&cursor=signature

Returns paginated transaction signatures for a wallet.

Query Parameters:

limit (optional): Number of results (1-50, default: 5)
cursor (optional): Signature to paginate from

Response:

{
  "success": true,
  "data": {
    "address": "wallet_address",
    "signatures": [...],
    "pagination": {
      "limit": 5,
      "hasMore": true,
      "nextCursor": "signature_xyz",
      "currentCursor": null,
      "totalLoaded": 5
    }
  }
}

Get Decoded Transactions

GET /transactions/:address?limit=5&cursor=signature

Returns decoded transactions with balance changes and protocol detection.

Get Trades with Price Analysis

GET /trades/:address?limit=5&cursor=signature

Returns trades with comprehensive price analysis:

Purchase price at transaction time
Current price
ATH price and timestamp
Gain/Loss percentage
Missed ATH opportunity

Response includes:

Trade categorization (increase/decrease/no_change)
Token balance changes
Price analysis per trade
Global summary statistics

Get Token Holdings

GET /tokens/:address

Returns current token holdings for the wallet.

Get NFT Holdings

GET /nfts/:address

Returns current NFT holdings for the wallet.

Get Global Overview

GET /global/:address

Returns wallet balance and global metrics.

Get Complete Wallet Analysis

GET /wallet/:address

Returns comprehensive analysis combining all data:

Balance
Tokens
NFTs
Recent trades (last 10)

🏗️ Architecture

Service Layer

SendoAnalyserService (src/services/sendoAnalyserService.ts)

Main analysis service with these key methods:

getSignaturesForAddress() - Paginated signature retrieval
getTransactionsForAddress() - Decoded transactions with pagination
getTradesForAddress() - Trade analysis with price tracking
getTokensForAddress() - Current token holdings
getNftsForAddress() - Current NFT holdings
getGlobalForAddress() - Wallet overview
getCompleteWalletAnalysis() - Combined analysis

Helius Integration

helius.ts (src/services/helius.ts)

Helius API wrapper with cursor-based pagination:

getSignaturesForAddress() - Signature retrieval with before cursor
getTransactionsForAddress() - Transaction fetching with pagination metadata
getTokensForAddress() - SPL token account data
getNftsForAddress() - NFT/compressed NFT data
getBalanceForAddress() - SOL balance

Birdeye Integration

birdeyes.ts (src/services/birdeyes.ts)

Price analysis service:

getPriceAnalysis() - Historical and current price with ATH tracking
OHLCV data fetching
Price history analysis

Transaction Decoders

decoders/ (src/utils/decoder/)

Protocol-specific decoders:

jupiter/ - Jupiter aggregator swaps
raydium/ - Raydium AMM and CLMM
orca/ - Orca pools
meteora/ - Meteora DLMM
pumpfun/ - Pump.fun bonding curves
pumpswap/ - Pumpswap pools
whirlpool/ - Whirlpool concentrated liquidity
computeBudget/ - Compute budget instructions

🛠️ Development

Prerequisites

Node.js 18+ or Bun
Helius API key
Birdeye API key

Build

bun run build

Watch Mode

bun run dev

Type Checking

bun run typecheck

📁 Project Structure

plugin-sendo-analyser/
├── src/
│   ├── services/          # SendoAnalyserService, Helius, Birdeye
│   ├── routes/            # REST API endpoints
│   ├── utils/
│   │   └── decoder/       # Protocol-specific transaction decoders
│   ├── config/            # Helius client config
│   ├── types/             # TypeScript type definitions
│   └── index.ts           # Plugin export
├── package.json
├── tsconfig.json
└── tsup.config.ts

🎯 Supported DEXs & Protocols

Jupiter - Aggregator swaps
Raydium - AMM and CLMM pools
Orca - Standard and Whirlpool pools
Meteora - DLMM (Dynamic Liquidity Market Maker)
Pump.fun - Bonding curve token launches
Pumpswap - Pump token swaps
Compute Budget - Priority fees and compute limits

📊 Price Analysis Features

Purchase Price: Price at transaction time (via OHLCV data)
Current Price: Real-time price from Birdeye
ATH Price: All-time high with timestamp
Gain/Loss: Percentage change from purchase to current
Missed ATH: Percentage from current price to ATH

🔄 Pagination Flow

Page 1: GET /trades/:address?limit=5
→ Returns 5 trades + nextCursor

Page 2: GET /trades/:address?limit=5&cursor=<nextCursor>
→ Returns next 5 trades + new nextCursor

Last Page: hasMore=false, nextCursor=null

Pass-through pagination: Each request fetches fresh data from Helius (no server-side caching).

🤝 Contributing

Contributions welcome! Please ensure:

Code follows existing patterns
TypeScript types are correct
Documentation is updated
Decoder schemas are properly typed with Zod

📄 License

MIT

🔗 Related

ElizaOS: https://github.com/elizaos/eliza
Sendo Labs: https://github.com/Sendo-labs
Helius: https://helius.dev
Birdeye: https://birdeye.so

Built with ❤️ by Sendo Labs

Name		Name	Last commit message	Last commit date
Latest commit History 28 Commits
.github/workflows		.github/workflows
src		src
.env.example		.env.example
.gitignore		.gitignore
.release-please-manifest.json		.release-please-manifest.json
CHANGELOG.md		CHANGELOG.md
README.md		README.md
bun.lock		bun.lock
package.json		package.json
release-please-config.json		release-please-config.json
tsconfig.json		tsconfig.json
tsup.config.ts		tsup.config.ts

OnChainMee/plugin-sendo-analyser

Folders and files

Latest commit

History

Repository files navigation