NotArb Setup

This guide covers the complete setup process for using arb-assist with NotArb onchain-bot.

Overview

NotArb integration allows arb-assist to:

  • Generate JSON configuration files

  • Create markets.json with trading pairs

  • Provide lookup-tables.json for ALUTs

  • Generate notarb-attributes.json for dynamic settings

  • Control bot parameters based on market conditions

Prerequisites

Before starting, ensure you have:

  • ✅ NotArb Release cloned from GitHub

  • ✅ Java 11+ installed

  • ✅ arb-assist installed in onchain-bot directory

  • ✅ Protected keypair file

  • ✅ Sufficient SOL for operations

Initial Setup

Step 1: Directory Structure

Your directory should look like:

~/notarb/Release/
├── notarb-global.toml    # Global NotArb config
├── notarb.sh             # NotArb launcher
└── onchain-bot/
    ├── notarb.jar        # NotArb binary
    ├── arb-assist        # arb-assist binary
    ├── config.toml       # arb-assist config
    ├── xxx.xxx.xxx.xxx.license  # arb-assist license
    └── protected-keypair.json   # Protected wallet

Step 2: Keypair Protection

NotArb uses a protected keypair format for enhanced security

  1. Configure keypair path in notarb-global.toml:

keypair_path = "/path/to/your/keypair.json"

  1. Protect the keypair:

cd ~/notarb/Release
bash notarb.sh protect-keypair

  1. Update path to protected keypair:

keypair_path = "/path/to/protected-keypair.json"

Step 3: Configure arb-assist

Create your config.toml in the onchain-bot directory:

# Connection settings
rpc_url = "https://your-rpc-endpoint"
grpc_url = "https://your-grpc-endpoint"
grpc_token = "your-token-if-needed"
grpc_engine = "yellowstone"

# Set mode to NotArb
mode = "na"

# Basic configuration
update_interval = 10000
mints_to_arb = [2, 2, 3]
mints_to_rank = 30

# Output file name
output = "notarb-config"  # Creates notarb-config.toml

# NotArb-specific settings
[notarb]
output = "notarb-config"
jvm_args = ["-server", "-Xmx8192m"]
keypair_path = "${DEFAULT_KEYPAIR_PATH}"
protect_keypair = true
threads = 0  # Dynamic thread pool
flash_loan = true
max_lookup_tables = 10
meteora_bin_limit = 20

# IPs for proxy (optional)
ips_file_path = ""
prefunded_keypairs_path = ""

# Jito endpoints
jito_targets = [
  "https://ny.mainnet.block-engine.jito.wtf",
  "https://tokyo.mainnet.block-engine.jito.wtf",
  "https://slc.mainnet.block-engine.jito.wtf",
  "https://amsterdam.mainnet.block-engine.jito.wtf",
  "https://frankfurt.mainnet.block-engine.jito.wtf",
]

max_bundle_transactions = 1

# Connection pools
token_accounts_checker = { rpc_url = "", delay_seconds = 3 }
blockhash_updater = { rpc_url = "", delay_ms = 400 }
account_size_loader = { rpc_url = "", invalid_account_size = 200, buffer_size = 1500 }

# WSOL unwrapper
wsol_unwrapper = { 
  enabled = true, 
  check_minutes = 1, 
  trigger_sol = 0.5, 
  target_sol = 5, 
  priority_fee_lamports = 190,
  reader_rpc_url = ""
}

Running the System

Step 1: Start arb-assist

Navigate to onchain-bot directory:

cd ~/notarb/Release/onchain-bot

Using tmux:

tmux new -s arb-assist
ulimit -n 65536
./arb-assist

# Detach with Ctrl+B, then D

Step 2: Start NotArb

From the main NotArb directory:

cd ~/notarb/Release

# Start with PM2 watching config changes
pm2 start ./notarb.sh \
  --interpreter bash \
  --name notarb-onchain \
  --watch onchain-bot/notarb-config.toml \
  -- onchain-bot/notarb-config.toml

Step 3: Monitor Operation

View logs:

# arb-assist logs
tmux attach -t arb-assist

# NotArb logs
pm2 logs notarb-onchain

# Combined monitoring
pm2 monit

Generated Files

notarb-config.toml

Main configuration file:

{
  "jvm_args": ["-server", "-Xmx8192m"],
  "keypair_path": "${DEFAULT_KEYPAIR_PATH}",
  "protect_keypair": true,
  "threads": 0,
  "flash_loan": true,
  "max_lookup_tables": 10,
  "meteora_bin_limit": 20,
  "jito_targets": [
    "https://ny.mainnet.block-engine.jito.wtf",
    "https://tokyo.mainnet.block-engine.jito.wtf"
  ],
  "max_bundle_transactions": 1
}

markets.json

Trading pairs organized by groups:

{
  "groups": [
    [
      "MarketAddress1...",
      "MarketAddress2..."
    ],
    [
      "MarketAddress3...",
      "MarketAddress4...",
      "MarketAddress5..."
    ]
  ],
  "update_timestamp": 1753221082643
}

Structure:

  • 2D array matching mints_to_arb configuration

  • Each sub-array is a transaction group

  • Timestamp for version tracking

lookup-tables.json

Address lookup tables:

[
  "ALUTAddress1...",
  "ALUTAddress2...",
  "ALUTAddress3...",
  "ALUTAddress4..."
]

Purpose:

  • Reduce transaction size

  • Include commonly used addresses

  • Updated dynamically

notarb-attributes.json

Dynamic trading parameters:

{
  "cu_limit": 400000,
  "jito_cooldown": 350,
  "jito_enabled": true,
  "jito_min_tip": 5000,
  "jito_max_tip": 25000,
  "spam_cooldown": 400,
  "spam_enabled": true,
  "spam_min_fee": 10000,
  "spam_max_fee": 50000
}

Updates based on:

  • Market conditions

  • Network congestion

  • Competition levels

Advanced Configuration

JVM Optimization

Note: The JVM optimization settings below are general suggestions. For optimal performance based on your specific hardware and workload, please refer to NotArb's official documentation.

Tune Java performance:

jvm_args = [
  "-server",                    # Server JVM
  "-Xmx8192m",                 # 8GB heap
  "-Xms4096m",                 # 4GB initial heap
  "-XX:+UseG1GC",              # G1 garbage collector
  "-XX:MaxGCPauseMillis=50",   # 50ms max pause
  "-XX:+UseStringDeduplication" # String optimization
]

JVM heap size recommendations:

  • 16GB RAM: -Xmx8192m

  • 32GB RAM: -Xmx16384m

  • 64GB RAM: -Xmx32768m

Note: These are JVM heap settings only. For total system RAM requirements, refer to NotArb's official documentation.

Thread Management

Configure thread pools:

threads = 0    # Dynamic (recommended)
threads = -1   # Unlimited threads
threads = 16   # Fixed 16 threads

Considerations:

  • 0: Adapts to workload

  • -1: Maximum parallelism

  • Fixed: Predictable resource usage

Meteora DLMM Settings

For Meteora dynamic pools:

meteora_bin_limit = 20  # Max bins to consider

Higher values:

  • More price points

  • Better pricing

  • Higher computation

WSOL Management

Automatic unwrapping:

wsol_unwrapper = {
  enabled = true,           # Auto-unwrap WSOL
  check_minutes = 1,        # Check every minute
  trigger_sol = 0.5,        # Unwrap if SOL < 0.5
  target_sol = 5,           # Unwrap to 5 SOL
  priority_fee_lamports = 190,
  reader_rpc_url = ""       # Optional dedicated RPC
}

Multi-Region Setup

Jito Regions

Configure multiple regions:

jito_targets = [
  "https://ny.mainnet.block-engine.jito.wtf",
  "https://tokyo.mainnet.block-engine.jito.wtf",
  "https://slc.mainnet.block-engine.jito.wtf",
  "https://amsterdam.mainnet.block-engine.jito.wtf",
  "https://frankfurt.mainnet.block-engine.jito.wtf",
  "https://london.mainnet.block-engine.jito.wtf",
  "https://singapore.mainnet.block-engine.jito.wtf",
]

Benefits:

  • Geographic distribution

  • Redundancy

  • Lower latency

Proxy Configuration

For distributed execution:

ips_file_path = "/path/to/ips.txt"
prefunded_keypairs_path = "/path/to/keypairs.txt"

IP file format:

192.168.1.100
192.168.1.101
192.168.1.102

Performance Optimization

Connection Pools

Optimize RPC usage:

# Fast blockhash updates
blockhash_updater = { 
  rpc_url = "https://fastest-rpc.com", 
  delay_ms = 300 
}

# Slower account checks
token_accounts_checker = { 
  rpc_url = "https://standard-rpc.com", 
  delay_seconds = 5 
}

# Bulk data loading
account_size_loader = { 
  rpc_url = "https://bulk-rpc.com", 
  buffer_size = 2000 
}

Flash Loan Configuration

Enable capital efficiency:

flash_loan = true
borrow_amount = 500_000_000_000  # 500 SOL

Benefits:

  • No upfront capital

  • Larger positions

  • Higher profits

Monitoring & Troubleshooting

Key Log Messages

Successful Arbitrage:

[INFO] Arbitrage completed: Mint: PUMP...xyz, Profit: 0.234 SOL

Market Updates:

[INFO] Markets updated: 45 pairs across 3 groups

Configuration Reload:

[INFO] Configuration reloaded from notarb-config.toml

Common Issues

Java Heap Error:

java.lang.OutOfMemoryError: Java heap space

Solution: Increase -Xmx value in jvm_args

ALUTs Error:

Error: Too many lookup tables

Solution: Reduce max_lookup_tables

No Markets Found: Check:

  1. GRPC connection active

  2. Filter thresholds not too strict

  3. DEXes configured correctly

Performance Metrics

Monitor in NotArb logs:

  • Transaction success rate

  • Average execution time

  • Profit per transaction

  • Gas efficiency

Best Practices

Configuration Management

  1. Version Control

    git init
git add config.toml
git commit -m "Initial NotArb config"

  2. Backup Configurations

    cp notarb-config.toml notarb-config.toml.backup
cp markets.json markets.json.backup

  3. Test Changes

    • Make small incremental changes

    • Monitor for 1-2 hours

    • Roll back if issues arise

Security

  1. Keypair Protection

    • Always use protected keypairs

    • Store backups securely

    • Never expose unprotected keys

  2. Access Control

    • Restrict onchain-bot directory

    • Use proper file permissions

    • Monitor access logs

Maintenance

Daily:

  • Check bot is running

  • Review profit/loss

  • Monitor error logs

Weekly:

  • Analyze performance trends

  • Update configurations

  • Check for NotArb updates

Monthly:

  • Full system review

  • Optimize JVM settings

  • Update dependencies

Integration Checklist

PreviousSMB-Onchain SetupNextFile Server Mode

Last updated