Common Errors

This guide covers the most frequently encountered errors and their solutions.

Configuration Errors

Dummy Configuration Generated

Symptom: Your bot config contains dummy values

mint = "11111111111111111111111111111111"

Causes:

No mints meet your filter criteria
GRPC stream not receiving data
Arbitrage programs not active

Solutions:

Lower filter thresholds:

filter_thresholds = [{
  min_profit = 100_000,      # Lower from 1M
  min_roi = 1.0,            # Lower from 2.0
  min_txns = 1,             # Lower from 5
}]

Check GRPC connection:

# Look for connection messages in logs
[INFO] Connected to Yellowstone GRPC
[INFO] Streaming transactions...

Verify arbitrage programs are active:

Check programs on-chain
Try adding more programs
Disable filter_programs temporarily

Invalid License Error

Error:

Error: Invalid license file

Solutions:

Verify license file is in correct directory
Check IP address matches your server:

# Check your IP
curl ifconfig.me

Ensure license file follows format: license_username_serverIP_expiration.json
Do NOT rename or modify the license file - use it exactly as provided by the arb-assist team
Check file permissions:

chmod 644 license_*.json

If you modified the license file in any way, request a new one from the arb-assist team

Configuration Parse Error

Error:

Error: Failed to parse config.toml

Common Issues:

Invalid TOML syntax:

# Wrong
array = [1, 2, 3,]  # Trailing comma

# Correct
array = [1, 2, 3]

Missing quotes:

# Wrong
rpc_url = https://example.com

# Correct
rpc_url = "https://example.com"

Type mismatches:

# Wrong
min_profit = "1000000"  # String instead of number

# Correct
min_profit = 1_000_000

Runtime Errors

Too Many Open Files

Error:

called `Result::unwrap()` on an `Err` value: Os { code: 24, kind: Uncategorized, message: "Too many open files" }

Immediate Fix:

ulimit -n 65536

Permanent Fix:

# Add to /etc/security/limits.conf
* soft nofile 65536
* hard nofile 65536

# Add to your startup script
ulimit -n 65536

GRPC Connection Failed

Error:

Error: Failed to connect to GRPC endpoint

Troubleshooting Steps:

Verify URL format:

grpc_url = "http://grpc.example.com:10001"  # Note: http not https

Check authentication:

grpc_token = "your-token"  # If required
grpc_engine = "yellowstone"  # or "thor"

Test connectivity:

curl -v http://grpc.example.com:10001

Verify firewall allows outbound connections

RPC Connection Issues

Error:

Error: RPC request failed: 429 Too Many Requests

Solutions:

Use premium RPC with higher limits
Add multiple RPC endpoints:

sending_rpc_urls = [
  "https://rpc1.com",
  "https://rpc2.com",
  "https://rpc3.com",
]

Increase update_interval to reduce requests

Bot-Specific Errors

SMB: Failed to Create Token Account

Error:

Failed to create token account: Error

Cause: Insufficient SOL for creating Associated Token Accounts (ATAs)

Solution:

Check wallet balance:

solana balance YOUR_WALLET_ADDRESS

Fund wallet with more SOL:

Each ATA costs ~0.00203928 SOL
Recommend keeping 0.5-1 SOL minimum

Enable WSOL unwrapping (NotArb):

wsol_unwrapper = {
  enabled = true,
  trigger_sol = 0.5,
  target_sol = 5
}

SMB: Private Key Not Found

Error:

Error: Cannot find wallet key file

Solutions:

Ensure encrypted key file exists
Check file is in same directory as smb-onchain
Verify encryption was successful:

ls -la *.key

NotArb: Java Heap Space

Error:

java.lang.OutOfMemoryError: Java heap space

Solution: Increase heap size in config:

[notarb]
jvm_args = ["-server", "-Xmx16384m"]  # Increase from 8GB to 16GB

NotArb: Too Many Lookup Tables

Error:

Error: Transaction too large - too many lookup tables

Solution: Reduce lookup tables:

[notarb]
max_lookup_tables = 5  # Reduce from 10

Download Errors

HTML Content Instead of Binary

Error:

./arb-assist: line 1: syntax error near unexpected token `<'
./arb-assist: line 1: `<!DOCTYPE html>'

Cause: Downloaded GitHub page instead of binary

Solution: Use direct download link:

# Correct
wget https://github.com/capicua4454/arb-assist/raw/refs/heads/main/arb-assist

# Wrong (downloads HTML page)
wget https://github.com/capicua4454/arb-assist/

Performance Issues

High CPU Usage

Symptoms:

100% CPU utilization
Slow config updates
System unresponsive

Solutions:

Increase update interval:

update_interval = 30000  # 30 seconds instead of 10

Reduce tracked mints:

mints_to_rank = 10  # Instead of 50

Enable program filtering:

filter_programs = true

Memory Leaks

Symptoms:

Gradually increasing memory usage
Eventually crashes with OOM

Solutions:

Reduce data retention:

halflife = 60000  # Faster decay

Limit scope:

mints_to_rank = 20  # Lower number
aluts_per_pool = 10  # Fewer ALUTs

Restart periodically:

# Add to crontab
0 */6 * * * pm2 restart arb-assist

Market Data Issues

No Arbitrage Opportunities Found

Symptoms:

Consistently empty mint lists
No profitable trades identified

Debugging Steps:

Check market activity:

# Look for transaction counts in logs
[INFO] Analyzed 1,234 transactions
[INFO] Found 0 arbitrage transactions  # Problem here

Verify DEX configuration:

dexes = [
  "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",  # Raydium
  "whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc",  # Orca
]

Try broader filters:

ignore_filters = true  # Temporarily bypass all filters

Stale Data

Symptoms:

Outdated mint information
Missed opportunities
Wrong pool data

Solutions:

Check timestamps in generated files
Verify GRPC stream is active
Reduce halflife for faster updates:

halflife = 30000  # 30 seconds

Network Issues

Firewall Blocking Connections

Symptoms:

Cannot connect to RPC/GRPC
Timeouts on all requests

Solutions:

Check outbound rules:

sudo ufw status

Allow necessary connections:

sudo ufw allow out 443/tcp  # HTTPS
sudo ufw allow out 80/tcp   # HTTP
sudo ufw allow out 10000:10010/tcp  # Common GRPC ports

DNS Resolution Failures

Error:

Error: Failed to resolve hostname

Solutions:

Check DNS settings:

cat /etc/resolv.conf

Add reliable DNS servers:

echo "nameserver 8.8.8.8" | sudo tee -a /etc/resolv.conf
echo "nameserver 1.1.1.1" | sudo tee -a /etc/resolv.conf

Quick Diagnostics Checklist

When encountering issues, check:

Logs:

pm2 logs arb-assist --lines 100

System Resources:

htop  # CPU and memory
df -h  # Disk space

Network Connectivity:

ping google.com
curl -I https://api.mainnet-beta.solana.com

File Permissions:

ls -la arb-assist
ls -la license_*.json
ls -la config.toml

Process Status:

pm2 status
ps aux | grep arb-assist

Getting Help

If you can't resolve an issue:

Collect Information:
- Error messages
- Config file (remove sensitive data)
- System specifications
- Recent changes made
Join Discord:
- Discord Server
- Post in #support channel
- Include collected information
GitHub Issues:
- Search existing issues first
- Create detailed bug report
- Include reproduction steps

PreviousSupported Metrics NextPerformance Issues

Last updated 6 months ago

hashtagConfiguration Errors

hashtagDummy Configuration Generated

hashtagInvalid License Error

hashtagConfiguration Parse Error

hashtagRuntime Errors

hashtagToo Many Open Files

hashtagGRPC Connection Failed

hashtagRPC Connection Issues

hashtagBot-Specific Errors

hashtagSMB: Failed to Create Token Account

hashtagSMB: Private Key Not Found

hashtagNotArb: Java Heap Space

hashtagNotArb: Too Many Lookup Tables

hashtagDownload Errors

hashtagHTML Content Instead of Binary

hashtagPerformance Issues

hashtagHigh CPU Usage

hashtagMemory Leaks

hashtagMarket Data Issues

hashtagNo Arbitrage Opportunities Found

hashtagStale Data

hashtagNetwork Issues

hashtagFirewall Blocking Connections

hashtagDNS Resolution Failures

hashtagQuick Diagnostics Checklist

hashtagGetting Help

Configuration Errors

Dummy Configuration Generated

Invalid License Error

Configuration Parse Error

Runtime Errors

Too Many Open Files

GRPC Connection Failed

RPC Connection Issues

Bot-Specific Errors

SMB: Failed to Create Token Account

SMB: Private Key Not Found

NotArb: Java Heap Space

NotArb: Too Many Lookup Tables

Download Errors

HTML Content Instead of Binary

Performance Issues

High CPU Usage

Memory Leaks

Market Data Issues

No Arbitrage Opportunities Found

Stale Data

Network Issues

Firewall Blocking Connections

DNS Resolution Failures

Quick Diagnostics Checklist

Getting Help