Solana Webhooks
Without RPC limitations
Connect directly to Solana validator streams. Stream system transactions, account changes, and parsed SPL token events straight to your backends using Blockferry's reliable SDK.
Integrate Solana streams in minutes
Use the official `@blockferry/sdk` to set up watchlists, customize filtering rules (workflows), and safely handle signed transaction webhooks.
// 1. Install & Initialize SDK
import { Blockferry } from '@blockferry/sdk';
const sdk = new Blockferry({
apiKey: process.env.BLOCKFERRY_API_KEY!,
});
// 2. Track target addresses
const watchlist = await sdk.watchlists.create({
name: 'Solana High-Value Monitoring',
chains: ['solana'], // target chain
webhookUrl: 'https://api.mybackend.com/webhooks/solana'
});
await sdk.watchlists.addAddresses(watchlist.id, {
addresses: [
{
address: 'HN7cABqJeqsa5mj5TKB4t2Rz6T3wz45A4TtzKz5D8n',
metadata: { label: 'treasury-hot-wallet' }
}
]
});How Blockferry delivers Solana events
Geyser Ingestion
We stream directly from validator Geyser nodes, capturing block updates at sub-second speeds.
Payload Parsing
Raw byte arrays and transactions are decoded automatically, returning SPL transfers as readable strings.
Commitment Verification
Reorgs are handled natively. We filter transactions based on Processed, Confirmed, or Finalized commitment states.
Durable Retries
Signatures are HMAC computed and webhooks are sent. If your servers time out, we queue and retry for up to 30 days.
Commitment Levels & Safety
Solana achieves fork finality rapidly, but temporary branches still happen at the "Processed" stage. Blockferry workflows allow developers to choose their safety settings:
- Processed: Delivered immediately upon validator log ingestion (under 400ms). Perfect for analytics.
- Confirmed: Reached once the block has been voted on by a supermajority of the cluster. Minimizes re-org risk.
- Finalized: Fully committed (typically takes ~31 slots or roughly 12 seconds). Safe for processing payments.
Instruction Introspection
Unlike basic tracking platforms that only look at primary transactions, Blockferry's indexing engine performs deep instruction introspection:
- Inner Instructions: We capture program events spawned *inside* smart contracts (like swaps or mint approvals).
- Program ID Filters: Setup watchlists specifically targeting Custom Program IDs (like Orca, Raydium, or Metaplex).