Cross-chain VCRED arbitrage keeper. Buys underpriced assets on Hemi, bridges to Ethereum, converts to USDC, bridges back, closes to VCRED.

VCRED → X (Hemi) → bridge → X (Eth) → USDC (Eth) → bridge → USDC (Hemi) → VCRED

Target tokens: WETH, WBTC, hemiBTC, cbBTC, XAUt, VUSD

# Create secrets
mkdir -p secrets
echo "0xYOUR_PRIVATE_KEY" > secrets/karb_pkey.txt
echo "your-dashboard-password" > secrets/karb_dashpass.txt
chmod 600 secrets/*.txt

# Run
docker compose up --build

Dashboard at http://localhost:7120

Reconciliation model: Ansible-like steady-state loop. Reads DB + chain state, executes next action, repeats. All steps idempotent.

Persistence: SQLite. Survives restarts mid-bridge.

Single instance: Lock prevents concurrent execution.

DETECTED → HEMI_SWAP_DONE → BRIDGE_OUT_SENT → [prove/finalize] → ON_ETHEREUM
→ ETH_SWAP_DONE → USDC_BRIDGE_BACK_SENT → ON_HEMI_USDC → HEMI_CLOSE_SWAP_DONE → COMPLETED

Binary search finds max profitable VCRED input (min 100). End-to-end profit estimate includes gas + bridge fees.

• logs/diag.log - diagnostic (JSONL)
• logs/money.log - swaps, bridges, P&L only (JSONL)

Password-protected web UI. Shows balances, active cycles, history, P&L.

Use Docker Compose (recommended):

docker compose up --build

Or build and run manually:

docker build -t keeper-arb .
docker run \
  -v ./data:/app/data \
  -v ./logs:/app/logs \
  -v ./secrets/karb_pkey.txt:/run/secrets/ARBITRAGE_PRIVATE_KEY:ro \
  -v ./secrets/karb_dashpass.txt:/run/secrets/DASHBOARD_PASSWORD:ro \
  -p 7120:7120 \
  keeper-arb

Runs non-root. Secrets must be mounted to /run/secrets/.

• Hemi: 43111
• Ethereum: 1