proxmox/scripts/deployment/send-eth-ei-matrix-wallets.sh

#!/usr/bin/env bash
# Send native ETH to each address in config/pmm-soak-wallet-grid.json (Elemental
# Imperium 33×33×6 matrix).
#
# Default mode (spread): take BALANCE_PCT of the signer's native balance (minus
# optional reserve), split across the selected wallet slice with independent
# uniform random multipliers in [1 - SPREAD_PCT/100, 1 + SPREAD_PCT/100] around
# equal weight, then renormalize so the total sent equals that budget exactly.
#
# Legacy mode: random 5–9 ETH per wallet (--uniform-eth).
#
# Requires: cast (Foundry), jq, python3. Loads PRIVATE_KEY and RPC via load-project-env.sh.
#
# Usage:
#   ./scripts/deployment/send-eth-ei-matrix-wallets.sh [--dry-run] [--limit N] [--offset N]
#
#   --dry-run          Print planned sends only (no transactions).
#   --limit N          Process at most N wallets (after offset). Default: all.
#   --offset N         Skip the first N wallets (resume / partial run).
#   --balance-pct P    Percent of (balance minus reserve) to distribute (default: 80).
#   --spread-pct S     Per-wallet multiplier range ±S%% around fair share (default: 15).
#   --reserve-wei W    Wei to leave untouchable before applying balance-pct (default: 0).
#   --uniform-eth      Legacy: random 5–9 ETH per wallet (ignores balance-pct/spread).
#
# Gas (Chain 138 / Besu): defaults avoid stuck pending txs from near-zero EIP-1559 caps.
# Override if needed:
#   EI_MATRIX_GAS_PRICE=100000000000
#   EI_MATRIX_PRIORITY_GAS_PRICE=20000000000
#
# Spread mode defaults (same as --balance-pct / --spread-pct / --reserve-wei):
#   EI_MATRIX_BALANCE_PCT=80  EI_MATRIX_SPREAD_PCT=15  EI_MATRIX_RESERVE_WEI=0
# Balance query uses public RPC by default; override with EI_MATRIX_BALANCE_RPC. Tx RPC: RPC_URL_138 or public.
#
# Nonces: each send uses an explicit --nonce from eth_getTransactionCount(..., "pending")
# and increments locally so --async does not race duplicate nonces.
#
# RPC: defaults to Chain 138 public HTTP (reachable without LAN). Override with RPC_URL_138
# (e.g. core or Besu on 192.168.x.x). Public URL env: CHAIN138_PUBLIC_RPC_URL or RPC_URL_138_PUBLIC.
#
set -euo pipefail

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
cd "$PROJECT_ROOT"

DRY_RUN=false
LIMIT=""
OFFSET="0"
BALANCE_PCT="${EI_MATRIX_BALANCE_PCT:-80}"
SPREAD_PCT="${EI_MATRIX_SPREAD_PCT:-15}"
RESERVE_WEI="${EI_MATRIX_RESERVE_WEI:-0}"
UNIFORM_ETH_LEGACY=false
while [[ $# -gt 0 ]]; do
  case "$1" in
    --dry-run) DRY_RUN=true; shift ;;
    --limit) LIMIT="${2:?}"; shift 2 ;;
    --offset) OFFSET="${2:?}"; shift 2 ;;
    --balance-pct) BALANCE_PCT="${2:?}"; shift 2 ;;
    --spread-pct) SPREAD_PCT="${2:?}"; shift 2 ;;
    --reserve-wei) RESERVE_WEI="${2:?}"; shift 2 ;;
    --uniform-eth) UNIFORM_ETH_LEGACY=true; shift ;;
    *) echo "Unknown arg: $1" >&2; exit 1 ;;
  esac
done

# shellcheck disable=SC1091
source "$PROJECT_ROOT/scripts/lib/load-project-env.sh"

CHAIN138_PUBLIC_RPC_DEFAULT="https://rpc-http-pub.d-bis.org"
RPC_PUBLIC="${CHAIN138_PUBLIC_RPC_URL:-${RPC_URL_138_PUBLIC:-$CHAIN138_PUBLIC_RPC_DEFAULT}}"
# Balance read for spread budget: public RPC first (aligns with deployer checks on public endpoints).
# After that, nonce + sends use RPC (same as RPC_URL_138 when set, else public).
BALANCE_RPC="${EI_MATRIX_BALANCE_RPC:-$RPC_PUBLIC}"
RPC="${RPC_URL_138:-$RPC_PUBLIC}"

LOCK_FILE="${PROJECT_ROOT}/reports/status/ei-matrix-eth-send.lock"
mkdir -p "$(dirname "$LOCK_FILE")"
exec 200>"$LOCK_FILE"
if ! flock -n 200; then
  echo "Another send-eth-ei-matrix-wallets.sh is already running (lock: $LOCK_FILE)." >&2
  exit 1
fi
GRID="$PROJECT_ROOT/config/pmm-soak-wallet-grid.json"
DEPLOYER_CANONICAL="0x4A666F96fC8764181194447A7dFdb7d471b301C8"
# Wei per gas — must exceed stuck-replacement threshold on busy pools (see script header).
EI_MATRIX_GAS_PRICE="${EI_MATRIX_GAS_PRICE:-100000000000}"
EI_MATRIX_PRIORITY_GAS_PRICE="${EI_MATRIX_PRIORITY_GAS_PRICE:-20000000000}"

[[ -f "$GRID" ]] || { echo "Missing $GRID" >&2; exit 1; }
command -v cast &>/dev/null || { echo "cast (Foundry) required" >&2; exit 1; }
command -v jq &>/dev/null || { echo "jq required" >&2; exit 1; }

[[ -n "${PRIVATE_KEY:-}" ]] || { echo "PRIVATE_KEY not set (source smom-dbis-138/.env or root .env)" >&2; exit 1; }

FROM_ADDR=$(cast wallet address --private-key "$PRIVATE_KEY")
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
if $UNIFORM_ETH_LEGACY; then
  echo "EI matrix ETH distribution (legacy: random 5–9 ETH per wallet)"
else
  echo "EI matrix ETH distribution (${BALANCE_PCT}% of balance, ±${SPREAD_PCT}% jitter, normalized)"
fi
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "Balance RPC (public): $BALANCE_RPC"
echo "Tx / nonce RPC:       $RPC"
echo "Signer:   $FROM_ADDR"
echo "Grid:     $GRID"
echo "Dry-run:  $DRY_RUN"
echo "Offset:   $OFFSET  Limit: ${LIMIT:-all}"
if ! $UNIFORM_ETH_LEGACY; then
  echo "Reserve:  ${RESERVE_WEI} wei excluded before balance-pct"
fi
echo "Gas:      maxFee=$EI_MATRIX_GAS_PRICE wei  priorityFee=$EI_MATRIX_PRIORITY_GAS_PRICE wei"
echo ""

if [[ "${FROM_ADDR,,}" != "${DEPLOYER_CANONICAL,,}" ]]; then
  echo "[WARN] Signer is not canonical deployer $DEPLOYER_CANONICAL — continuing anyway."
  echo ""
fi

pending_nonce() {
  local resp hex
  resp=$(curl -sS -X POST "$RPC" -H "Content-Type: application/json" \
    -d "{\"jsonrpc\":\"2.0\",\"method\":\"eth_getTransactionCount\",\"params\":[\"${FROM_ADDR}\",\"pending\"],\"id\":1}" 2>/dev/null) || return 1
  hex=$(echo "$resp" | jq -r '.result // empty')
  [[ -n "$hex" ]] || return 1
  cast to-dec "$hex"
}

random_wei_uniform_legacy() {
  python3 -c "import random; from decimal import Decimal; print(int(Decimal(str(random.uniform(5.0, 9.0))) * 10**18))"
}

# Args: count budget_wei spread_pct — prints one wei amount per line; sum(lines) == budget_wei
generate_spread_amounts_wei() {
  local count="$1" budget="$2" spread="$3"
  python3 - "$count" "$budget" "$spread" <<'PY'
import random
import sys

n = int(sys.argv[1])
budget = int(sys.argv[2])
spread = float(sys.argv[3])
if n <= 0:
    sys.exit("count must be positive")
if budget < 0:
    sys.exit("budget must be non-negative")
if spread < 0 or spread > 100:
    sys.exit("spread-pct must be in [0, 100]")
# Integer-only weights (float on ~10^27 wei rounds to 0 → huge remainder loop and hang)
base = 10000
low_w = max(1, (100 * base - int(spread * base)) // 100)
high_w = (100 * base + int(spread * base)) // 100
w = [random.randint(low_w, high_w) for _ in range(n)]
s = sum(w)
raw = [(budget * wi) // s for wi in w]
rem = budget - sum(raw)
for i in range(rem):
    raw[i % n] += 1
for w in raw:
    print(w)
PY
}

ERR_LOG="${PROJECT_ROOT}/reports/status/ei-matrix-eth-send-failures.log"
mkdir -p "$(dirname "$ERR_LOG")"

if ! $DRY_RUN; then
  NONCE=$(pending_nonce) || { echo "Could not read pending nonce for $FROM_ADDR" >&2; exit 1; }
  echo "Starting nonce (pending): $NONCE"
  echo ""
else
  NONCE=0
fi

# Args: addr wei idx — uses global NONCE, sent, failed, DRY_RUN, RPC, PRIVATE_KEY, EI_MATRIX_* , ERR_LOG
matrix_try_send() {
  local addr="$1" wei="$2" idx="$3"
  local eth_approx out tx GP PP attempt
  if [[ "$wei" == "0" ]]; then
    echo "[skip] idx=$idx $addr  zero wei"
    return 0
  fi
  eth_approx=$(python3 -c "w=int('$wei'); print(f'{w / 1e18:.6f}')")
  if $DRY_RUN; then
    echo "[dry-run] idx=$idx $addr  ${wei} wei (~${eth_approx} ETH)"
    return 0
  fi
  GP="$EI_MATRIX_GAS_PRICE"
  PP="$EI_MATRIX_PRIORITY_GAS_PRICE"
  attempt=1
  while [[ "$attempt" -le 2 ]]; do
    if out=$(cast send "$addr" --value "$wei" --rpc-url "$RPC" --private-key "$PRIVATE_KEY" \
      --nonce "$NONCE" \
      --async \
      --gas-price "$GP" \
      --priority-gas-price "$PP" \
      2>&1); then
      tx=$(echo "$out" | tail -n1)
      echo "[ok] idx=$idx nonce=$NONCE $addr  ${eth_approx} ETH  tx=$tx"
      sent=$((sent + 1))
      NONCE=$((NONCE + 1))
      echo "$idx" > "${PROJECT_ROOT}/reports/status/ei-matrix-eth-send-last-idx.txt"
      break
    fi
    if echo "$out" | grep -q "Replacement transaction underpriced" && [[ "$attempt" -eq 1 ]]; then
      GP=$((GP * 2))
      PP=$((PP * 2))
      NONCE=$(pending_nonce) || true
      attempt=$((attempt + 1))
      continue
    fi
    echo "[fail] idx=$idx nonce=$NONCE $addr  $out" | tee -a "$ERR_LOG" >&2
    failed=$((failed + 1))
    NONCE=$(pending_nonce) || true
    break
  done
}

stream_addresses() {
  # Slice in jq only — jq|head breaks with SIGPIPE under pipefail when LIMIT is set.
  if [[ -n "${LIMIT:-}" ]]; then
    jq -r --argjson o "$OFFSET" --argjson l "$LIMIT" '.wallets[$o:$o+$l][] | .address' "$GRID"
  else
    jq -r --argjson o "$OFFSET" '.wallets[$o:][] | .address' "$GRID"
  fi
}

compute_budget_wei() {
  python3 - "$1" "$2" "$3" <<'PY'
import sys
bal = int(sys.argv[1])
reserve = int(sys.argv[2])
pct = float(sys.argv[3])
avail = max(0, bal - reserve)
print(int(avail * pct / 100.0))
PY
}

ADDR_TMP=""
AMOUNTS_TMP=""
cleanup_tmp() {
  [[ -n "$ADDR_TMP" && -f "$ADDR_TMP" ]] && rm -f "$ADDR_TMP"
  [[ -n "$AMOUNTS_TMP" && -f "$AMOUNTS_TMP" ]] && rm -f "$AMOUNTS_TMP"
}
trap cleanup_tmp EXIT

if $UNIFORM_ETH_LEGACY; then
  :
else
  ADDR_TMP=$(mktemp)
  AMOUNTS_TMP=$(mktemp)
  stream_addresses > "$ADDR_TMP"
  WALLET_COUNT=$(wc -l < "$ADDR_TMP" | tr -d '[:space:]')
  if [[ -z "$WALLET_COUNT" || "$WALLET_COUNT" -eq 0 ]]; then
    echo "No wallets in range (offset=$OFFSET limit=${LIMIT:-all})." >&2
    exit 1
  fi
  BAL_WEI=$(cast balance "$FROM_ADDR" --rpc-url "$BALANCE_RPC" 2>/dev/null | awk '{print $1}' || echo "0")
  BUDGET_WEI=$(compute_budget_wei "$BAL_WEI" "$RESERVE_WEI" "$BALANCE_PCT")
  eth_bal=$(python3 -c "print(f'{int(\"$BAL_WEI\") / 1e18:.8f}')" 2>/dev/null || echo "?")
  eth_bud=$(python3 -c "print(f'{int(\"$BUDGET_WEI\") / 1e18:.8f}')" 2>/dev/null || echo "?")
  echo "Balance:  $BAL_WEI wei (~$eth_bal ETH)"
  echo "Budget:   $BUDGET_WEI wei (~$eth_bud ETH)  (${BALANCE_PCT}% of max(0, balance − ${RESERVE_WEI} reserve))"
  echo "Wallets:  $WALLET_COUNT  spread: ±${SPREAD_PCT}% then normalized to budget"
  echo ""
  if [[ "$BUDGET_WEI" == "0" ]]; then
    echo "Budget is zero (balance below reserve or pct=0). Nothing to send." >&2
    exit 1
  fi
  generate_spread_amounts_wei "$WALLET_COUNT" "$BUDGET_WEI" "$SPREAD_PCT" > "$AMOUNTS_TMP"
fi

sent=0
failed=0
idx=$OFFSET

if $UNIFORM_ETH_LEGACY; then
  while read -r addr; do
    wei=$(random_wei_uniform_legacy)
    matrix_try_send "$addr" "$wei" "$idx"
    idx=$((idx + 1))
  done < <(stream_addresses)
else
  while IFS=$'\t' read -r addr wei; do
    matrix_try_send "$addr" "$wei" "$idx"
    idx=$((idx + 1))
  done < <(paste -d $'\t' "$ADDR_TMP" "$AMOUNTS_TMP")
fi

echo ""
if $DRY_RUN; then
  echo "Dry-run complete (no transactions sent). Indices covered: $OFFSET..$((idx - 1))."
else
  echo "Done. Sent: $sent  Failed: $failed"
fi