-------------------------------------------------------------------------------- title: "AllenHark Overview" description: "Comprehensive overview of AllenHark's institutional-grade Solana infrastructure, target audience, and value propositions." last_updated: "2026-01-22T00:00:00.000Z" source: "https://allenhark.com" -------------------------------------------------------------------------------- # AllenHark Overview ## What is AllenHark? AllenHark provides institutional-grade Solana infrastructure and trading systems designed specifically for high-frequency traders, market makers, and automated trading systems. Our platform is built around ultra-low latency execution and MEV (Maximum Extractable Value) protection. We operate from our primary datacenter in Frankfurt, Germany, with direct connections to major Solana validators. ## Who is AllenHark for? Our services are built for: - Solana MEV traders and searchers who need speed comparable to validators. - High-frequency trading (HFT) firms requiring the fastest possible transaction inclusion. - Market makers needing reliable, private transaction delivery. - DeFi protocols requiring low-latency infrastructure for their backend systems. - Trading bot developers looking for competitive advantages in execution speed. ## What makes AllenHark different from other providers? We offer several unique advantages: - **0-Slot Execution**: Our infrastructure allows transactions to land in the exact same slot they are sent, giving you first-mover advantage. - **Private Relay**: We bypass public mempools completely, protecting your strategies from front-running, copy-trading, and sandwich attacks. - **Raw Shred Access (ShredStream)**: We provide direct UDP access to Solana shreds for the fastest possible data ingestion—faster than any RPC subscription. - **Co-Location**: You can host your bots directly in our Frankfurt datacenter, placing them physically next to our relay infrastructure for sub-millisecond latency. - **Integrated Trading Bots**: We offer ready-to-use trading bots like the PumpFun Sniper that leverage all our infrastructure advantages out of the box. ## How can I get support or contact AllenHark? - **Discord Community**: Join our active community at [discord.gg/JpzS72MAKG](https://discord.gg/JpzS72MAKG) for real-time support and discussions. - **Website**: Visit [allenhark.com](https://allenhark.com) for documentation and service information. - **Email**: Reach out to support@allenhark.com for business inquiries. -------------------------------------------------------------------------------- title: "Trading Products" description: "Complete guide to all AllenHark trading bots: PumpFun Sniper, PumpFun Launch Bundler, Arbitrage Bot, Bonk Sniper, and Wallet Blacklist." last_updated: "2026-01-22T00:00:00.000Z" source: "https://allenhark.com/products" -------------------------------------------------------------------------------- # Trading Products ## What trading products does AllenHark offer? We offer a suite of trading tools designed for the Solana ecosystem: 1. **PumpFun Sniper** (Available): A specialized bot for sniping new token launches on Pump.fun in the very first block. 2. **PumpFun Launch Bundler** (Available): A tool for bundling multiple buy transactions together when launching a new Pump.fun token. 3. **Wallet Blacklist** (Available): A curated database of known malicious wallets to protect your trading strategies. 4. **Arbitrage Bot** (Coming Soon): A multi-DEX arbitrage bot for Raydium, Orca, and Meteora. 5. **Bonk Sniper** (Coming Soon): A sniper specifically optimized for the high-volatility Bonk ecosystem. --- ## PumpFun Sniper ### What is the PumpFun Sniper and how does it work? The PumpFun Sniper uses our ShredStream service to detect new token launch transactions directly from the Solana shred pipeline. Because shreds arrive before blocks are fully confirmed by RPC nodes, the bot can construct and send a buy transaction that lands in the exact same block as the token creation. This offers a significant speed advantage (often 100-500ms faster) compared to bots that rely on standard RPC polling. ### What are the key features of the PumpFun Sniper? - **First-Block Sniping**: Detects token creations via ShredStream and buys in the same slot. - **Ultra-Low Latency**: Direct shred processing with sub-millisecond detection times. - **Automatic Buy/Sell**: Configurable automatic buying and profit-taking or stop-loss selling. - **Smart Filtering**: Filters tokens based on dev buy amounts, token metrics, and known spam patterns. - **Blacklist System**: Automatically blacklists unprofitable creators to avoid repeat losses. - **AllenHark Integration**: Optimized for AllenHark Relay (for sending) and ShredStream (for receiving). ### How do I install the PumpFun Sniper? We recommend using the pre-built binary for Linux: ```bash # Download the latest release wget https://github.com/AllenHark-Inc/PumpFun-Sniper/releases/latest/download/sniperbot-linux-x86_64.tar.gz tar -xzf sniperbot-linux-x86_64.tar.gz chmod +x sniperbot sell_token add_blacklist fix_blacklist test_blacklist ``` ### How do I configure the PumpFun Sniper? Create a `config.toml` file with the following structure: ```toml # Trading Parameters purchase_amount_sol = 0.001 # SOL to spend per snipe slippage_basis_points = 100 # 100 = 1% slippage tolerance live = true # Set false for dry-run mode # Wallet Configuration payer_keypair_path = "./wallet.json" # AllenHark Services (for best performance) relay = "https://relay.allenhark.com/v1/sendTx" quic = "185.191.117.237:4433" shredstream_uri = "http://127.0.0.1:9999" tip_wallet = "harkYFxB6DuUFNwDLvA5CQ66KpfRvFgUoVypMagNcmd" tip_lamports = 1_000_000 # 0.001 SOL tip per transaction # PumpFun Configuration user_volume_accumulator = "YOUR_DERIVED_PDA" # RPC Pool rpc_pool = [ "https://mainnet.helius-rpc.com/?api-key=YOUR_KEY", "https://rpc.shyft.to?api_key=YOUR_KEY" ] # Dev Buy Filter min_dev_buy_sol = 0.5 max_dev_buy_sol = 4.5 # Spam Filter [spam_filter] min_buy_sol = 0.01 max_buy_sol = 10.0 min_tokens = 1000 min_accounts = 8 ``` ### What is the pricing for the PumpFun Sniper? - **Pre-built Binaries**: 0.002 SOL fee per complete trade cycle (0.001 SOL on buy + 0.001 SOL on sell). Fees are charged regardless of trade profitability. - **Source Code License**: 40 SOL one-time payment for full Rust source code access. This removes all trading fees and allows unlimited customization. ### What utility commands are available? ```bash # Manually sell a specific token ./sell_token --token # Add a wallet to the blacklist ./add_blacklist # Check if a wallet is blacklisted ./test_blacklist # Fix corrupted blacklist file ./fix_blacklist ``` --- ## PumpFun Launch Bundler ### What is the PumpFun Launch Bundler? The PumpFun Launch Bundler is a tool for token launchers. It allows you to bundle multiple buy transactions together with your token creation transaction. This is useful for ensuring initial liquidity, creating trading activity, or coordinating buys across multiple wallets at launch time. ### Who should use the Launch Bundler? This tool is designed for: - Token creators who want to ensure initial buy activity on their new tokens. - Teams coordinating a multi-wallet launch strategy. - Projects that need atomic execution of launch + initial purchase transactions. --- ## Wallet Blacklist ### What is the Wallet Blacklist? The Wallet Blacklist is a high-performance database containing over 4,178 known malicious Solana wallets. It includes serial token launchers, known rug-pullers, and spam wallets. The list is updated daily by the AllenHark team. ### How does the blacklist protect me? The PumpFun Sniper automatically checks each token's creator against the blacklist before buying. If the creator is blacklisted, the token is skipped. The bot also automatically adds creators to your local blacklist when trades result in losses, helping you avoid repeat mistakes. ### How do I download the Wallet Blacklist? ```bash wget https://allenhark.com/blacklist.jsonl -O blacklist.jsonl # or curl -o blacklist.jsonl https://allenhark.com/blacklist.jsonl ``` ### What is the format of the blacklist file? The blacklist uses JSONL (JSON Lines) format with one entry per line: ```jsonl {"wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "reason": "rug_pull", "added": "2024-01-15"} {"wallet": "9yKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsV", "reason": "spam_launcher", "added": "2024-01-16"} ``` --- ## Arbitrage Bot (Coming Soon) ### What will the Arbitrage Bot do? The Arbitrage Bot will scan for price discrepancies across multiple Solana DEXes (Raydium, Orca, Meteora) and execute atomic arbitrage trades. It will use AllenHark Relay for fast transaction submission and our gRPC streams for real-time price monitoring. --- ## Bonk Sniper (Coming Soon) ### What will the Bonk Sniper do? The Bonk Sniper will be a specialized sniper bot optimized for the Bonk ecosystem and its associated meme token launches. It will be tuned for the high-volatility and fast-moving nature of Bonk-related tokens. -------------------------------------------------------------------------------- title: "Infrastructure Services" description: "Complete guide to AllenHark infrastructure: Relay, ShredStream, 0-Slot, gRPC, RPC, and Co-Location." last_updated: "2026-01-22T00:00:00.000Z" source: "https://allenhark.com/infrastructure" -------------------------------------------------------------------------------- # Infrastructure Services AllenHark provides enterprise-grade Solana infrastructure designed for high-frequency trading and institutional needs. --- ## AllenHark Relay ### What is the AllenHark Relay? The AllenHark Relay is a next-generation transaction propagation network. Instead of broadcasting your transaction to the public Solana mempool (where it can be front-run or copied), you send it directly to our relay. We then forward it via optimized, leader-aware pathways to validators. ### What are the key benefits of using the Relay? - **0-Hop Delivery**: Direct paths to validators without intermediate hops. - **MEV Protection**: Your transaction is not visible in public mempools. - **Ultra-Low Latency**: 0.1ms possible with QUIC protocol. - **Leader-Aware Routing**: We track the current and upcoming leaders for optimal delivery. ### What are the Relay endpoints? - **QUIC (Recommended)**: `relay.allenhark.com:4433` - **HTTPS (Fallback)**: `https://relay.allenhark.com/v1/sendTx` - **IP Address**: 84.32.98.153 - **Region**: Frankfurt, Germany ### How do I authenticate with the Relay? Use your API key in one of two ways: - **Header (Recommended)**: `x-api-key: YOUR_API_KEY` - **Query Parameter**: `?api-key=YOUR_API_KEY` ### What are the tip requirements? Every transaction must include a SOL transfer to one of our tip wallets. The minimum tip is **0.001 SOL** (1,000,000 lamports). Transactions without a valid tip will be rejected with error `tip_missing`. **Tip Wallets (select one randomly):** ``` hark1zxc5Rz3K8Kquz79WPWFEgNCFeJnsMJ16f22uNP harkm2BTWxZuszoNpZnfe84jRbQTg6KGHaQBmWzDGQQ hark4CwtTnN2y9FaxjcFBAJdJqQrpouu5pgEixfqdEz harkoJfnM6dxrJydx5eVmDVwAgwC94KbhuxF69UbXwP hark6hUDUTekc1DGxWdJcuyDZwf6pJdCxd4SXAVtta6 harkoTvFpKSrEQduYrNHXCurARVT19Ud3BnFhVxabos harkEpXoJv5qVzHaN7HSuUAd6PHjyMcFMcDYBMDJCEQ harkyXDdZSoJGyCxa24t2QXx1poPyp8YfghbtpzGSzK harkR2YJ4Dpt4UDJTcBirjnSPBhNpQFcoFkNpCkVqNk harkRBygM8pHYe4K8eBjfxyEX19oJn3LepFjvNbLbyi harkYFxB6DuUFNwDLvA5CQ66KpfRvFgUoVypMagNcmd ``` ### What is the difference between QUIC and HTTPS for the Relay? | Feature | QUIC | HTTPS | |---------|------|-------| | Latency | ~0.1ms | 15-25ms | | Connection | Persistent | Per-request | | Protocol | UDP-based | TCP-based | | Best For | Production HFT | Simple integration | --- ## 0-Slot Execution ### What is 0-Slot execution? 0-Slot execution means your transaction lands in the exact same slot it was sent. This is the holy grail for sniping and MEV strategies. Traditional RPC-based submission often results in transactions landing 1-2 slots later due to propagation delays. ### How does AllenHark achieve 0-Slot execution? We combine multiple technologies: 1. **ShredStream**: Detects events before RPC nodes fully process them. 2. **Leader-Aware Relay**: Routes transactions directly to the current/upcoming leader. 3. **QUIC Protocol**: Eliminates connection overhead with persistent, multiplexed streams. 4. **Co-Location**: Physical proximity to our relay reduces network latency to near-zero. --- ## ShredStream ### What is ShredStream? ShredStream provides direct access to Solana "shreds"—the raw data packets that validators use to construct blocks. By receiving shreds directly via UDP, you can see block data before it's fully processed and made available through standard RPC subscriptions. ### What are the access options for ShredStream? 1. **Direct Shreds (UDP)**: Dedicated IP and port for raw UDP packets. Requires IP whitelisting. 2. **Shared Shreds (gRPC)**: API-based access with authentication. Easier to integrate. ### What are the available ShredStream plans? - **Daily**: Short-term access - **Weekly**: Week-long subscription - **Monthly**: Standard subscription - **Dedicated**: Reserved bandwidth with guaranteed throughput ### How do I listen for shreds in Rust? ```rust use std::net::UdpSocket; fn main() -> std::io::Result<()> { let socket = UdpSocket::bind("0.0.0.0:8001")?; let mut buf = [0; 65535]; loop { let (amt, src) = socket.recv_from(&mut buf)?; let shred_data = &buf[..amt]; println!("Received {} bytes from {}", amt, src); // Deserialize using solana_ledger::shred::Shred } } ``` ### How do I listen for shreds in Node.js? ```javascript const dgram = require('dgram'); const server = dgram.createSocket('udp4'); server.on('message', (msg, rinfo) => { console.log(`Received ${msg.length} bytes from ${rinfo.address}:${rinfo.port}`); // Process raw buffer - requires custom deserialization }); server.bind(8001); ``` --- ## gRPC Streaming ### What is gRPC streaming? We provide real-time account and transaction streaming using Geyser plugins. gRPC offers sub-millisecond latency updates compared to standard RPC WebSocket subscriptions, which can have significant delays. ### What can I stream via gRPC? - Account updates (balance changes, data modifications) - Transaction confirmations - Slot notifications - Block metadata --- ## Dedicated RPC ### What is the Dedicated RPC service? We provide private RPC nodes reserved exclusively for your use. Unlike public RPCs, you get unlimited requests, no rate limiting, and priority execution. ### What are the benefits of Dedicated RPC? - **99.99% Uptime**: Enterprise-grade reliability - **Unlimited Requests**: No throttling or rate limits - **Priority Execution**: Your sendTransaction calls are prioritized - **Heavy Workload Support**: Optimized for high-volume queries --- ## Co-Location ### What is Co-Location? Co-Location allows you to host your trading bots or servers directly in our Frankfurt (TeraSwitch/Equinix) datacenter. This provides the shortest possible physical path to our relay and validator connections. ### What are the benefits of Co-Location? - Sub-millisecond latency to the Relay - Direct private network link - Access to private QUIC lanes - Priority engineering support - Guaranteed infrastructure bandwidth ### How do I get started with Co-Location? Contact us via Discord or email to inquire about available slots and pricing. -------------------------------------------------------------------------------- title: "Console & Account Management" description: "Complete guide to using the AllenHark Console for authentication, service management, billing, VPS, and account settings." last_updated: "2026-01-22T00:00:00.000Z" source: "https://allenhark.com/console" -------------------------------------------------------------------------------- # Console & Account Management The AllenHark Console is your central hub for managing all services, subscriptions, and account settings. --- ## Authentication ### How do I access the console? Navigate to `https://allenhark.com/console/login` to sign in. ### What login methods are available? - **Email/Password**: Traditional login with email and password. - **OAuth Providers**: Sign in with GitHub, Google, or Discord. - **Magic Link**: Passwordless login via email link. ### How do I create an account? Go to `https://allenhark.com/console/signup`. You can register with email/password or use an OAuth provider for one-click signup. ### How do I reset my password? 1. Go to `https://allenhark.com/console/forgot-password` 2. Enter your email address 3. Check your email for a reset link or OTP code 4. Set your new password at `https://allenhark.com/console/reset-password` ### What happens after OAuth login? After authenticating with GitHub, Google, or Discord, you're redirected to `https://allenhark.com/console/callback` which completes the login process and redirects you to the dashboard. --- ## Dashboard ### What is the Dashboard? The Dashboard (`/console`) is your home screen showing an overview of: - Active services and their status - Recent activity - Quick actions for common tasks - Account notifications --- ## Solana Services (ShredStream) ### Where do I manage ShredStream? Navigate to `/console/services` for the ShredStream management interface. ### How do I configure Direct Shreds (UDP)? 1. Go to the Direct Shreds section 2. Enter your server's IP address and desired port 3. We will whitelist your IP and begin streaming to your endpoint ### How do I manage Shared Shreds (gRPC)? 1. Go to the Shared Shreds section 2. View and manage your API keys 3. Configure allowed IPs for each key 4. Monitor connection limits ### What subscription plans are available? - **Daily**: Short-term testing or temporary needs - **Weekly**: Week-long access - **Monthly**: Standard subscription - **Dedicated**: Reserved bandwidth with guaranteed throughput ### Can I get a free trial? Yes, we offer a free trial for new users. You can request it from the Services page. --- ## Relay Management ### Where do I find my Relay API key? Go to `/console/relay` to view your current API key. ### What can I do in Relay management? - View your API key - See your QUIC and HTTPS endpoints - Check your current rate limits - Regenerate your API key if compromised - Configure allowed IPs for your key --- ## VPS Management ### Where do I manage VPS instances? Navigate to `/console/vps` for VPS management. ### What can I do in VPS management? - View all active VPS subscriptions - See subscription details and expiry dates - Extend existing subscriptions - Request new VPS instances - Retrieve login credentials (IP address, username, root password) ### What regions are available for VPS? Currently, we offer VPS instances in our Frankfurt datacenter. --- ## Billing ### Where do I view my billing information? Navigate to `/console/billing` for billing management. ### What can I see in the Billing section? - Complete payment history - Pending payments with status - Transaction details and hashes - Subscription renewal information ### What payment methods do you accept? We primarily accept cryptocurrency payments for all services. --- ## Account Settings ### Where do I manage my account settings? Navigate to `/console/settings` for account management. ### What settings can I configure? - **Personal Information**: Name and display name - **Contact Details**: Email, phone number, Telegram handle - **Billing Address**: For invoicing purposes - **Password Management**: Change your password - **Connected Accounts**: Link/unlink Discord, GitHub, and Google accounts --- ## Troubleshooting ### What if I encounter an account conflict? If you try to link an OAuth provider that's already connected to another account, you'll be redirected to `/console/conflict` to resolve the issue. ### What is the verification page for? The `/console/verify` page is for email verification after signup or when changing your email address. -------------------------------------------------------------------------------- title: "REST API Reference" description: "Complete technical reference for the AllenHark REST API including all endpoints, parameters, and response formats." last_updated: "2026-01-22T00:00:00.000Z" source: "https://allenhark.com/docs/api/rest" -------------------------------------------------------------------------------- # REST API Reference ## Base URL ``` https://api.allenhark.com/v1 ``` ## Authentication All requests must include the `Authorization` header: ``` Authorization: Bearer YOUR_API_KEY ``` --- ## Account Endpoints ### Get Account Info Retrieves your account details and tier information. ```http GET /account ``` Response: ```json { "id": "acc_123456", "email": "user@example.com", "tier": "professional", "credits": 1000, "rateLimit": { "requests": 10000, "period": "hour" } } ``` ### Get API Usage Retrieves usage statistics for a given time period. ```http GET /account/usage?start=2024-01-01&end=2024-01-31 ``` Response: ```json { "period": { "start": "2024-01-01T00:00:00Z", "end": "2024-01-31T23:59:59Z" }, "usage": { "rpcRequests": 1500000, "grpcStreams": 50, "relayTransactions": 1000 }, "costs": { "total": 150.00, "breakdown": { "rpc": 50.00, "grpc": 75.00, "relay": 25.00 } } } ``` --- ## Trading Bot Endpoints ### List Bots ```http GET /bots ``` ### Create Bot ```http POST /bots ``` Request: ```json { "type": "pumpfun-sniper", "config": { "buyAmount": 0.1, "slippage": 10, "autoSell": { "takeProfit": 2.0, "stopLoss": 0.5 } } } ``` ### Start Bot ```http POST /bots/{botId}/start ``` ### Stop Bot ```http POST /bots/{botId}/stop ``` ### Get Bot Stats ```http GET /bots/{botId}/stats ``` Response: ```json { "id": "bot_abc123", "stats": { "totalTrades": 150, "winningTrades": 102, "losingTrades": 48, "winRate": 0.68, "totalProfit": 12.5, "avgProfit": 0.083, "maxDrawdown": -2.3, "sharpeRatio": 1.85 } } ``` --- ## Market Data Endpoints ### Get Token Info ```http GET /market/token/{mint} ``` Response: ```json { "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "name": "USD Coin", "decimals": 6, "supply": 1000000000, "price": 1.00, "volume24h": 50000000, "holders": 125000 } ``` ### Get Pool Info ```http GET /market/pool/{address} ``` Response: ```json { "address": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2", "dex": "raydium", "tokenA": "SOL", "tokenB": "USDC", "liquidity": 5000000, "volume24h": 1000000, "fee": 0.0025 } ``` --- ## Transaction Endpoints ### Send Transaction ```http POST /transactions/send ``` Request: ```json { "transaction": "base64_encoded_transaction", "options": { "skipPreflight": false, "maxRetries": 3, "priorityFee": "auto" } } ``` Response: ```json { "signature": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW", "status": "confirmed", "slot": 250123456 } ``` --- ## Rate Limits | Tier | Limit | |------|-------| | Free | 100 requests/minute | | Professional | 1,000 requests/minute | | Enterprise | Unlimited | ## Error Codes | Code | Description | |------|-------------| | 400 | Bad Request - Invalid parameters | | 401 | Unauthorized - Invalid API key | | 403 | Forbidden - Insufficient permissions | | 404 | Not Found - Resource doesn't exist | | 429 | Too Many Requests - Rate limit exceeded | | 500 | Internal Server Error | ## SDKs Official SDKs are available: - **JavaScript/TypeScript**: `npm install @allenhark/sdk` - **Python**: `pip install allenhark-sdk` - **Rust**: `allenhark-sdk` crate -------------------------------------------------------------------------------- title: "WebSocket API Reference" description: "Real-time WebSocket API for streaming market data and events." last_updated: "2026-01-22T00:00:00.000Z" source: "https://allenhark.com/docs/api/websocket" -------------------------------------------------------------------------------- # WebSocket API Reference ## Connection ``` wss://ws.allenhark.com/v1 ``` ## Authentication After connecting, send an auth message: ```json { "type": "auth", "apiKey": "YOUR_API_KEY" } ``` ## Available Subscriptions ### Price Updates ```json { "type": "subscribe", "channel": "price", "tokens": ["mint1", "mint2"] } ``` ### Transaction Confirmations ```json { "type": "subscribe", "channel": "transactions", "signatures": ["sig1", "sig2"] } ``` ### Bot Events ```json { "type": "subscribe", "channel": "bot", "botId": "bot_abc123" } ``` -------------------------------------------------------------------------------- title: "Relay Integration Guide" description: "Technical guide for integrating with AllenHark Relay using QUIC and HTTPS protocols." last_updated: "2026-01-22T00:00:00.000Z" source: "https://allenhark.com/docs/infrastructure/relay" -------------------------------------------------------------------------------- # Relay Integration Guide ## Endpoints - **QUIC**: `relay.allenhark.com:4433` - **HTTPS**: `https://relay.allenhark.com/v1/sendTx` - **IP**: 84.32.98.153 (Frankfurt) ## Sending via QUIC (0.1ms Latency) QUIC is the recommended protocol for production systems. It offers: - 0-RTT connection resumption (instant reconnection) - Connection multiplexing (multiple streams per connection) - No head-of-line blocking - Built-in TLS 1.3 encryption - 50-80% latency reduction vs HTTP/2 ### Rust Example (Quinn) ```rust use quinn::{ClientConfig, Endpoint}; use rustls::RootCertStore; #[tokio::main] async fn main() -> Result<(), Box> { // Configure TLS let mut roots = RootCertStore::empty(); roots.add_trust_anchors(webpki_roots::TLS_SERVER_ROOTS.iter().map(|ta| { rustls::OwnedTrustAnchor::from_subject_spki_name_constraints( ta.subject, ta.spki, ta.name_constraints, ) })); let client_config = ClientConfig::with_root_certificates(roots); let mut endpoint = Endpoint::client("0.0.0.0:0".parse()?)?; endpoint.set_default_client_config(client_config); // Connect to relay let conn = endpoint .connect("relay.allenhark.com:4433".parse()?, "relay.allenhark.com")? .await?; let (mut send, mut recv) = conn.open_bi().await?; // Send API Key send.write_all(b"api-key: YOUR_API_KEY\n").await?; // Send Transaction Payload let payload = serde_json::json!({ "tx": "BASE64_TRANSACTION", "simulate": false }); send.write_all(&serde_json::to_vec(&payload)?).await?; send.finish().await?; // Read Response let response = recv.read_to_end(4096).await?; println!("Response: {:?}", String::from_utf8_lossy(&response)); Ok(()) } ``` ### Python Example (aioquic) ```python import asyncio import json from aioquic.asyncio import connect from aioquic.quic.configuration import QuicConfiguration async def send_transaction(api_key: str, tx_base64: str): configuration = QuicConfiguration(is_client=True) async with connect("relay.allenhark.com", 4433, configuration=configuration) as client: stream_id = client._quic.get_next_available_stream_id() # Send API key client._quic.send_stream_data(stream_id, f"api-key: {api_key}\n".encode()) # Send transaction payload = json.dumps({"tx": tx_base64, "simulate": False}) client._quic.send_stream_data(stream_id, payload.encode(), end_stream=True) response_data = await client._quic.receive_stream_data(stream_id) print("Response:", json.loads(response_data.decode())) asyncio.run(send_transaction("YOUR_API_KEY", "BASE64_TX")) ``` ## Sending via HTTPS (15-25ms Latency) HTTPS is simpler to integrate but has higher latency due to TCP handshakes. ### Node.js Example ```javascript const response = await fetch("https://relay.allenhark.com/v1/sendTx", { method: "POST", headers: { "Content-Type": "application/json", "x-api-key": "YOUR_API_KEY" }, body: JSON.stringify({ tx: "BASE64_ENCODED_TRANSACTION", simulate: false }) }); const data = await response.json(); console.log("Response:", data); ``` ### Rust Example (reqwest) ```rust use reqwest::Client; use serde_json::json; #[tokio::main] async fn main() -> Result<(), Box> { let client = Client::new(); let res = client.post("https://relay.allenhark.com/v1/sendTx") .header("x-api-key", "YOUR_API_KEY") .json(&json!({ "tx": "BASE64_ENCODED_TRANSACTION", "simulate": false })) .send() .await?; println!("Response: {}", res.text().await?); Ok(()) } ``` ## Response Format ### Success Response ```json { "status": "accepted", "request_id": "550e8400-e29b-41d4-a716-446655440000" } ``` ### Error Responses | Error Code | Description | |------------|-------------| | `tip_missing` | Transaction does not include a tip to AllenHark wallet | | `tip_insufficient` | Tip amount below 0.001 SOL | | `simulate_forbidden` | The simulate parameter must be false | | `invalid_api_key` | API key not found or invalid | | `rate_limit_exceeded` | Request rate limit exceeded | | `invalid_transaction` | Transaction deserialization failed | ## Keep-Alive Best Practices ### QUIC Keep-Alive - Send keep-alive ping every 3 seconds - Timeout after 10-15 seconds - Benefits: No reconnection cost, predictable 0.1ms dispatch ### HTTPS Keep-Alive ```typescript import axios from "axios"; import https from "https"; const agent = new https.Agent({ keepAlive: true }); const api = axios.create({ baseURL: "https://relay.allenhark.com", httpsAgent: agent, }); ``` -------------------------------------------------------------------------------- title: "Quick Start Guide" description: "Step-by-step guide to getting started with AllenHark infrastructure and SDKs." last_updated: "2026-01-22T00:00:00.000Z" source: "https://allenhark.com/docs/quick-start" -------------------------------------------------------------------------------- # Quick Start Guide Get up and running with AllenHark in under 5 minutes. ## Prerequisites - A Solana wallet with SOL for transactions - Node.js 18+ installed - Basic knowledge of Solana and trading concepts ## Step 1: Get API Access Contact our team via Discord or email to receive: - API Key - API Secret - RPC Endpoint URL ## Step 2: Install the SDK ```bash npm install @allenhark/sdk # or yarn add @allenhark/sdk ``` ## Step 3: Configure Your Environment Create a `.env` file: ```bash ALLENHARK_API_KEY=your_api_key_here ALLENHARK_API_SECRET=your_api_secret_here ALLENHARK_RPC_URL=https://rpc.allenhark.com SOLANA_PRIVATE_KEY=your_wallet_private_key ``` ## Step 4: Initialize the Client ```typescript import { AllenHarkClient } from '@allenhark/sdk'; const client = new AllenHarkClient({ apiKey: process.env.ALLENHARK_API_KEY!, apiSecret: process.env.ALLENHARK_API_SECRET!, rpcUrl: process.env.ALLENHARK_RPC_URL!, }); // Test connection const status = await client.getStatus(); console.log('Connected:', status.connected); ``` ## Step 5: Run Your First Bot ```typescript import { PumpFunSniper } from '@allenhark/sdk'; const sniper = new PumpFunSniper(client, { buyAmount: 0.1, // SOL slippage: 10, // 10% autoSell: { takeProfit: 2.0, // 2x stopLoss: 0.5, // -50% }, }); await sniper.start(); console.log('Sniper bot is now running!'); ``` ## Next Steps - [Configure PumpFun Sniper](/docs/pumpfun-sniper) for advanced settings - [Set up Arbitrage Bot](/docs/arbitrage-bot) for DEX arbitrage - [Explore Infrastructure](/docs/infrastructure/rpc) for raw infrastructure access - [API Reference](/docs/api/rest) for building custom integrations ## Need Help? - Discord: [discord.gg/JpzS72MAKG](https://discord.gg/JpzS72MAKG) - Email: support@allenhark.com -------------------------------------------------------------------------------- title: "Case Studies" description: "Real-world examples of AllenHark infrastructure deployments for institutional staking, arbitrage, and MEV relay." last_updated: "2026-01-22T00:00:00.000Z" source: "https://allenhark.com/case-studies" -------------------------------------------------------------------------------- # Case Studies ## Institutional Staking How a major staking provider used AllenHark infrastructure to manage validator operations with 99.99% uptime and sub-millisecond monitoring. ## Arbitrage Scaling A quantitative trading firm scaled their Solana arbitrage operations from $10K/day to $500K/day using AllenHark's 0-Slot execution and ShredStream. ## MEV Relay Deployment A MEV searcher team replaced their custom relay infrastructure with AllenHark Relay, reducing latency by 60% and operational overhead by 80%. -------------------------------------------------------------------------------- title: "Guides & Comparisons" description: "Flagship comparison and guide pages: Solana RPC provider comparison and the Yellowstone gRPC guide." last_updated: "2026-07-07T00:00:00.000Z" source: "https://allenhark.com/solana-rpc-providers-comparison" -------------------------------------------------------------------------------- # Guides & Comparisons ## [Solana RPC Providers Comparison](https://allenhark.com/solana-rpc-providers-comparison) Side-by-side comparison of Helius, QuickNode, Triton, Shyft, and AllenHark: latency, staked connections (SWQoS), Yellowstone gRPC streaming, ShredStream access, and pricing. Includes FAQ and provider-by-provider breakdowns. ## [Yellowstone gRPC Guide](https://allenhark.com/solana-grpc-guide) Complete guide to Yellowstone gRPC (Geyser) streaming on Solana: account/transaction/block/slot subscriptions, filter syntax, commitment levels, reconnect strategy, and TypeScript/Rust/Python code examples. ## [Pricing](https://allenhark.com/pricing) All plans: staked RPC ($49/mo per dedicated connection), Yellowstone gRPC ($99/mo), ShredStream (shared from $10/day, direct UDP from $199/mo), Slipstream transaction landing, VPS, bare metal, and co-location in Amsterdam / Chicago / Frankfurt. -------------------------------------------------------------------------------- title: "Blog & Educational Resources" description: "Complete list of technical articles, guides, and educational content about Solana infrastructure and trading." last_updated: "2026-01-22T00:00:00.000Z" source: "https://allenhark.com/blog" -------------------------------------------------------------------------------- # Blog & Educational Resources Complete list of published posts. Each links to the canonical article on allenhark.com. ### [How to Send Jito Bundles on Solana: Atomic Transactions Explained (2026 Guide)](https://allenhark.com/blog/how-to-send-jito-bundles-solana) What Jito bundles are, how the Block Engine and tip auction work, and how to submit atomic Solana transactions over HTTPS, QUIC, or WebSocket with AllenHark Relay — with code examples. ### [What Non-Custodial Copy Trading Actually Means](https://allenhark.com/blog/what-is-non-custodial-copy-trading) Most Solana copy-trading bots take custody of your funds. Soltrace doesn't. Here's what non-custodial really means — your own PDA vault, owner-only withdrawal, and a keeper that can trade but never withdraw. ### [Soltrace Fees, Explained](https://allenhark.com/blog/soltrace-fees-explained) A transparent breakdown of Soltrace pricing: a flat 0.85% per trade on every plan with no profit split or revenue share, four tiers from $0 to $449, RPC vs relay submission by tier, and accepted payment in USDC, USDT and SOL. ### [Introducing Soltrace — Non-Custodial Solana Copy Trading](https://allenhark.com/blog/introducing-soltrace) Soltrace is now live on Solana mainnet: mirror the on-chain trades of wallets you choose while your funds stay in your own PDA vault. Non-custodial, red-team tested, and built into the AllenHark Console. ### [How Soltrace Copies Solana Wallets](https://allenhark.com/blog/how-soltrace-copies-solana-wallets) A technical walkthrough of how Soltrace mirrors Solana traders: watching programs not wallets, attributing swaps to their signer, fanning out to your vault, and keeper-signed execution across Raydium, Orca, Meteora, Pump.fun and PumpSwap. ### [Zero-Downtime Migration: Self-Hosted to Managed Solana Validator](https://allenhark.com/blog/zero-downtime-migration-self-hosted-to-managed-solana-validator) Five-step playbook for moving a self-hosted Solana validator to a managed provider without missing a vote. Vote-key handover, slashing-protection bookkeeping, warm catchup, hot-standby cutover, and post-migration validation. ### [White-Label Liquid Staking Token (LST) Setup on Solana](https://allenhark.com/blog/white-label-liquid-staking-token-solana-setup) Operator guide for launching a branded LST on Solana backed by a dedicated validator. Covers SPL stake pools, Sanctum integration, mint authority, fee parameters, MEV-tip distribution, and the full launch timeline. ### [Solana Validator Security Controls: A Buyer's Guide](https://allenhark.com/blog/solana-validator-security-controls-buyers-guide) What to evaluate in a managed Solana validator provider's security posture — key management, slashing protection, sanctions screening, audit trails, change management, hardware isolation, and incident response. ### [MEV-Aware Delegation on Solana Validators](https://allenhark.com/blog/mev-aware-delegation-solana-validators) How MEV-aware delegation actually improves validator yields on Solana: Jito block-engine routing, tip mechanics, vote-timing optimization, leader-slot tuning, and how to evaluate whether your validator is leaving MEV on the table. ### [How Exchanges Add White-Label Solana Staking Without Running Nodes](https://allenhark.com/blog/how-exchanges-add-white-label-solana-staking) A complete playbook for exchanges adding native SOL staking without becoming a validator-ops shop: integration architecture, custody flow, OFAC screening, commission and revenue economics, and how to ship inside one quarter. ### [Fixing QUIC ALPN Error 120 on AllenHark Relay: A Complete Connection Guide](https://allenhark.com/blog/fixing-quic-alpn-error-120-allenhark-relay) Why your QUIC client throws 'aborted by peer: the cryptographic handshake failed: error 120: peer doesn't support any known protocol' when connecting to AllenHark Relay — and the exact Rust + Python code that fixes it. ### [Best White-Label Solana Validator Providers in 2026](https://allenhark.com/blog/best-white-label-solana-validator-providers-2026) An evaluation of the white-label Solana validator landscape in 2026 — Figment, Chorus One, Blockdaemon, AllenHark — with criteria, pros and cons, and how to pick for exchanges, wallets, funds, and LST issuers. ### [WebSocket Streaming Comes to AllenHark Relay: Persistent Connections for Transactions and Bundles](https://allenhark.com/blog/websocket-streaming-solana-transactions-bundles) AllenHark Relay now supports persistent wss:// connections — open one socket, stream as many transactions or bundles as you want. Less handshake overhead, lower latency, browser-native, and bundle-aware. ### [Why AllenHark Relay Is the Fastest Way to Land Solana Transactions in 2026](https://allenhark.com/blog/why-allenhark-relay-2026) AllenHark Relay now spans 4 global regions with QUIC and HTTPS endpoints, stake-weighted broadcast, and MEV protection. Here's why traders and builders are switching. ### [Solana Validator as a Service: Why White-Label Validators Make Sense in 2026](https://allenhark.com/blog/solana-validator-as-a-service) Running a Solana validator is a full-time job. AllenHark's managed validator service lets you earn staking rewards under your own brand with zero operational burden. ### [What is Slipstream? AllenHark's Sender-Agnostic Solana Transaction Relay](https://allenhark.com/blog/what-is-slipstream) An introduction to Slipstream — a leader-proximity-aware transaction relay that automatically selects the fastest sender for your Solana transactions across 4 global regions. ### [The Fastest Way to Land Solana Transactions in 2026](https://allenhark.com/blog/fastest-way-to-land-solana-transactions-2026) A practical breakdown of every method for landing Solana transactions fast — from public RPCs to direct TPU submission — and why sender-agnostic routing wins in 2026. ### [How to Submit Transactions Directly to the Leader TPU on Solana](https://allenhark.com/blog/how-to-submit-directly-to-leader-tpu-solana) A technical guide to bypassing gossip and submitting Solana transactions directly to the leader validator's TPU via UDP for minimum-latency execution. ### [How to Beat Snipers and Land Transactions Faster on Solana](https://allenhark.com/blog/how-to-beat-snipers-land-transactions-faster) Practical strategies for outpacing competing bots on Solana — from leader proximity routing to TPU direct submission and real-time leader hints. ### [How to Fix PumpFun Custom:6024 Overflow Error After the Cashback Upgrade](https://allenhark.com/blog/pumpfun-bonding-curve-custom-6024-overflow-fix-cashback-upgrade-guide) A complete guide to the February 2026 PumpFun bonding curve program upgrade that broke buy/sell transactions. Covers the new bonding_curve_v2 PDA requirement, the cashback_enabled flag, and correct account layouts. ### [Why QUIC Protocol Beats HTTP for Solana Transaction Relay: Technical Deep-Dive](https://allenhark.com/blog/why-quic-protocol-beats-http-solana-transaction-relay) Comprehensive technical analysis of QUIC vs HTTP/2 for Solana transaction relay. Discover why QUIC offers 50-80% latency reduction, 0-RTT handshakes, and superior performance for MEV trading. ### [Solana MEV Relay Services: Comprehensive Comparison 2025](https://allenhark.com/blog/solana-mev-relay-services-comprehensive-comparison) In-depth comparison of the best Solana MEV transaction relay services including AllenHark Relay, Jito, BloXroute, 0Slot, and Helius. Technical specifications, latency benchmarks, cost analysis, and use case recommendations. ### [Complete Guide to AllenHark Relay: HTTP & QUIC Integration for Solana Trading](https://allenhark.com/blog/complete-guide-allenhark-relay-http-quic-integration) Step-by-step guide to integrating AllenHark Relay for ultra-low latency Solana transaction submission. Learn API authentication, tip validation, QUIC vs HTTP setup, and best practices for MEV trading. ### [PumpFun Sniper Technical Deep-Dive: Architecture, Performance, and ShredStream Integration](https://allenhark.com/blog/pumpfun-sniper-technical-deep-dive) A comprehensive technical analysis of the PumpFun Sniper bot architecture, including ShredStream integration, sub-millisecond detection, AllenHark Relay optimization, and performance benchmarks. ### [Introducing PumpFun Sniper: First-Block Token Sniping on Solana](https://allenhark.com/blog/pumpfun-sniper-launch) AllenHark launches the PumpFun Sniper bot - a high-performance trading tool that detects and trades new token launches in the first block. Download now and start sniping with sub-millisecond detection. ### [How to Push Solana Transactions Under 500ms (Even During Congestion)](https://allenhark.com/blog/how-to-push-solana-transactions-under-500ms) A practical guide for TypeScript HFT builders on optimizing network propagation, using QUIC, and leveraging private relays like AllenHark to bypass congestion. ### [Deep Dive: Solana Private Network Infrastructure (PNI)](https://allenhark.com/blog/solana-pni) A technical analysis of private transaction propagation, direct-to-leader injection, and how PNI bypasses public RPC bottlenecks for high-frequency trading. ### [Solana Wallets to Block - Complete Pump.Fun Scammer Database (4,178+ Addresses)](https://allenhark.com/blog/solana-wallets-to-block-scammer-database) Protect your Solana snipe bot with our database of 4,178+ pump.fun scammer wallets. Updated daily with known rug-pull addresses. Free download and REST API access. ### [Comprehensive Pump.Fun Wallet Blacklist - Protect Your Snipe Bot from Rug Pulls](https://allenhark.com/blog/pump-fun-wallet-blacklist-comprehensive-protection) Download our curated blacklist of 4,178+ pump.fun wallets known for launching rug pulls. Learn how to integrate this high-performance Rust blacklist into your Solana snipe bot for sub-microsecond wallet validation. ### [Understanding and Minimizing Solana RPC Latency](https://allenhark.com/blog/understanding-solana-rpc-latency) A comprehensive technical breakdown of latency sources in Solana RPCs, from network hops to serialization overhead, and how to optimize your setup for sub-millisecond performance. ### [Pump.fun Create Instruction Discriminator & IDL Analysis](https://allenhark.com/blog/pumpfun-create-instruction-discriminator) A comprehensive technical deep dive into the Pump.fun smart contract, focusing on the create instruction discriminator, IDL parsing, and building ultra-low latency sniper bots. ### [Optimizing High-Frequency Solana Arbitrage: Intelligent RPC Failover Strategies](https://allenhark.com/blog/high-frequency-solana-arbitrage-rpc-failover) A deep dive into how top HFT teams structure their Rust code to automatically reroute sendTransaction calls when primary RPCs exceed latency thresholds. ### [Deep Dive into Solana's QUIC Networking Protocol](https://allenhark.com/blog/solana-quic-networking-protocol-docs) A technical explanation of why Solana migrated from UDP to QUIC, how the TPU client works, and what this means for bot developers and infrastructure providers. ### [Best Solana MEV Transaction Relay Services in 2025](https://allenhark.com/blog/best-solana-mev-transaction-relay-services-2025) A comprehensive, data-driven comparison of the top transaction relay services for Solana MEV, focusing on latency, reliability, inclusion rates, and cost-efficiency. ### [So, You Wanna Build a Pump.fun New Token Sniper: The Definitive Rust Guide](https://allenhark.com/blog/so-you-wanna-build-pumpfun-sniper) Deep dive into building a sub-millisecond sniper. Includes Rust code examples, architecture diagrams, and benchmarks proving why Node.js cannot compete. ### [Why Location Matters Most in Solana Transaction Landing](https://allenhark.com/blog/why-location-matters-solana-transaction-landing) Priority fees aren't enough. Learn how the speed of light and network routing hops kill your transaction success rate, and why co-location is the only fix. ### [Why Your Solana Transactions Arrive Late Even With Priority Fees](https://allenhark.com/blog/why-solana-transactions-late-priority-fees) Discover why high priority fees don't guarantee speed. Learn how network hops, Jito congestion, and QUIC limits cause 1-2 slot delays. ### [The Infrastructure Stack for 0-Slot Solana Execution](https://allenhark.com/blog/infrastructure-for-same-slot-execution) Building a serious MEV or arbitrage bot? Here is the exact hardware, network, and software stack you need to achieve 0-slot execution on Solana. ### [Private Relays vs. Jito vs. Public RPC: Which Lands Faster?](https://allenhark.com/blog/private-relays-vs-jito-public-rpc) A technical comparison of Solana transaction propagation methods. Why private relays outperform Jito bundles and public RPCs for 0-slot execution. ### [How to Land Solana Transactions in the Same Slot (0-Slot Execution)](https://allenhark.com/blog/how-to-land-solana-transaction-same-slot) Learn why public RPCs and standard propagation fail at same-slot execution, and how to use direct leader relays to front-run or synchronize trades. ### [Do gRPC and Shreds Help Land Solana Transactions Faster?](https://allenhark.com/blog/grpc-shreds-vs-transaction-landing) Clarifying the difference between 'Reading' and 'Writing' on Solana. Why gRPC and Shreds are essential for speed but cannot send transactions themselves. ### [Optimizing Solana RPC Latency for HFT](https://allenhark.com/blog/optimizing-solana-rpc-latency) An in-depth analysis of network topology, geyser plugins, and custom shred propagation techniques to achieve sub-millisecond latency for high-frequency trading on Solana. ### [Cheapest Solana Shreds Provider (Updated 2025)](https://allenhark.com/blog/cheapest-solana-shreds-provider) Accessing Solana Shreds doesn't have to break the bank. We compare the pricing of top Shreds providers to find the most affordable options. ### [Best Solana RPC Provider for MEV Trading 2025](https://allenhark.com/blog/best-solana-rpc-provider-2025) A comparison of the top Solana RPC providers for MEV and HFT. We analyze latency, features, and pricing to help you choose the best partner. ### [UDP vs TCP for Receiving Shreds — Which Is Faster?](https://allenhark.com/blog/udp-vs-tcp-solana-shreds) A technical deep dive into the transport protocols used for Solana Shreds. Why UDP's fire-and-forget model beats TCP's reliability for blockchain data. ### [Best Shreds Setup for Pump.fun Snipers](https://allenhark.com/blog/best-shreds-setup-pump-fun) Optimize your Pump.fun sniper bot with the ultimate Shreds setup. Learn how to detect new token launches milliseconds before the crowd. ### [What Are Solana Shreds? Complete Beginner’s Guide](https://allenhark.com/blog/what-are-solana-shreds) Understand the fundamental building blocks of Solana's high-speed network. Learn what Shreds are, how Turbine propagates them, and why they matter for trading. ### [Shreds vs gRPC vs RPC vs WebSockets - Which Is Best for Low-Latency Bots?](https://allenhark.com/blog/shreds-vs-grpc-vs-rpc-websockets) A comprehensive benchmark of Solana data streaming methods. Compare latency, throughput, and cost to find the best architecture for your trading bot. ### [QUIC vs HTTPS RPC — Which Is Faster for Solana Trading?](https://allenhark.com/blog/quic-vs-https-solana-trading) A detailed comparison of QUIC and HTTPS protocols for Solana trading. Discover why QUIC's 0-RTT and multiplexing offer superior latency for high-frequency trading. ### [Test Solana Shreds for Only $5/Day](https://allenhark.com/blog/test-solana-shreds-cheap) Experiment with real-time Solana shreds for just $5 per day. The cheapest and most flexible way to access raw block data for testing. ### [Understanding Jito Bundles & Block Building](https://allenhark.com/blog/understanding-jito-bundles) How to effectively use Jito bundles to guarantee transaction inclusion and protect against front-running in volatile markets. -------------------------------------------------------------------------------- title: "Legal & Policies" description: "Information about AllenHark's privacy policy and terms of service." last_updated: "2026-01-22T00:00:00.000Z" source: "https://allenhark.com/privacy" -------------------------------------------------------------------------------- # Legal & Policies ## Privacy Policy Available at: https://allenhark.com/privacy We collect minimal data necessary for service operation. Your trading data, wallet addresses, and transaction history are never shared with third parties. ## Terms of Service Available at: https://allenhark.com/terms By using AllenHark services, you agree to our terms including: - Appropriate use of infrastructure for legal purposes only - Understanding that trading involves significant risk - Responsibility for your own trading decisions ## Risk Disclaimer Trading cryptocurrencies involves significant risk of loss. AllenHark trading bots and infrastructure are provided as-is with no guarantees of profit. Only trade with funds you can afford to lose.