-------------------------------------------------------------------------------- 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, TurboStream ZMQ, 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 --- ## TurboStream ZMQ ### What is TurboStream ZMQ? TurboStream is our ultra-low latency ZeroMQ-based market data feed. It connects directly to our validator infrastructure and streams data with minimal protocol overhead. ZMQ is faster than WebSocket for raw data streaming. --- ## 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: "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 ## Infrastructure & Protocol Articles ### Why QUIC Protocol Beats HTTP for Solana Transaction Relay Explains how QUIC's 0-RTT resumption, lack of head-of-line blocking, and UDP foundation make it superior for high-frequency transaction submission. ### What Are Solana Shreds? A technical deep dive into Solana's Turbine protocol. Shreds are the data packets that make up blocks. Receiving them via UDP allows faster data access than waiting for RPC block completion. ### UDP vs TCP for Solana Shreds A comparison of UDP and TCP for shred streaming. UDP wins for raw performance, while TCP offers reliability guarantees. ### Understanding Jito Bundles How to use Jito for atomic transaction bundling, enabling complex MEV strategies like sandwich attacks or guaranteed arbitrage execution. ### Private Relays vs Jito Public RPC Comparison showing how private relays like AllenHark offer consistent, dedicated bandwidth compared to often-congested public endpoints. ### How to Land Solana Transactions in Same Slot Techniques and infrastructure requirements for achieving 0-slot transaction landing. ### How to Push Solana Transactions Under 500ms Optimization techniques for minimizing end-to-end transaction latency on Solana. ## RPC & Infrastructure Guides ### Optimizing Solana RPC Latency Tips: co-locate servers, use Geyser plugins for streaming, choose private RPC providers with uncongested bandwidth. ### Best Solana RPC Provider 2025 Comprehensive comparison of RPC providers with performance benchmarks and pricing analysis. ### Best Solana MEV Transaction Relay Services 2025 Updated comparison of MEV relay options for Solana traders. ### Complete Guide: AllenHark Relay HTTP & QUIC Integration Step-by-step integration guide for using AllenHark Relay with both HTTPS and QUIC protocols. ### Solana MEV Relay Services Comprehensive Comparison Detailed analysis of all major Solana MEV relay services with latency benchmarks. ## Product & Strategy Guides ### PumpFun Sniper Launch Announcement Announcement and overview of the PumpFun Sniper bot launch. ### PumpFun Sniper Technical Deep Dive Architecture and implementation details of the PumpFun Sniper bot. ### Best Shreds Setup for Pump.fun Optimal ShredStream configuration for sniping PumpFun token launches. ### PumpFun Wallet Blacklist: Comprehensive Protection How the wallet blacklist protects traders from known rug pullers and spam launchers. ### Test Solana Shreds Cheap Guide to testing ShredStream access affordably before committing to a full subscription. ### Solana PNI (Priority Network Infrastructure) Explanation of Solana's priority infrastructure and how it affects transaction ordering. -------------------------------------------------------------------------------- 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.