How h100envy/nerve works
NERVE is a memecoin DEX-trading protocol organized around a typed Impulse and a deterministic Spine. The primary workflow discovers pool observations, screens them, simulates a wallet round trip, evaluates a thesis, applies deterministic risk sizing, then executes and monitors trades; the Reporter summarizes the audited funnel. Paper and live execution share the protocol, while read-only reconciliation is a separate recovery workflow. The README documents all seven nodes and major CLI capabilities; some wiring beyond the sampled excerpts is represented only where documented.
Main entry points: spine.py Impulse spine · desk.py Trading desk · store.py NerveStore · cli.py NERVE CLI
Components 21
Desk and inputs
- NERVE CLI
src/nerve/cli.py - Trading desk
src/nerve/desk.py - Pool source
src/nerve/sources.py - EVM pool adapter
src/nerve/adapters.py
Impulse decisions
- Impulse spine
src/nerve/spine.py - Scanner
src/nerve/agents/scanner.py - Deterministic reflexes
src/nerve/reflexes.py - NERVE score
src/nerve/score.py - SENTINEL
src/nerve/agents/sentinel.py - Analyst
src/nerve/agents/analyst.py - Risk
src/nerve/agents/risk.py
Execution and state
- Executor
src/nerve/agents/executor.py - Execution adapters
src/nerve/execution.py - Position monitor
src/nerve/agents/monitor.py - NerveStore
src/nerve/store.py
Operations
- Operational reporter
src/nerve/agents/reporter.py - Reconciliation
src/nerve/reconcile.py - Read-only chain reader
src/nerve/chainread.py
Other components
- Trading operator
- OpenAI API
- EVM JSON-RPC
Connections 27
- Trading operator → NERVE CLI: invokes
- NERVE CLI → Trading desk: runs desk
- Trading desk → Pool source: discovers pools
- Pool source → EVM pool adapter: provides adapter
- EVM pool adapter → EVM JSON-RPC: reads pools
- Trading desk → Impulse spine: routes impulses
- Impulse spine → Scanner: dispatches
- Scanner → NERVE score: scores metrics
- Impulse spine → Deterministic reflexes: checks reflexes
- Impulse spine → SENTINEL: dispatches
- SENTINEL → EVM JSON-RPC: simulates round trip
- Impulse spine → Analyst: dispatches
- Analyst → OpenAI API: requests thesis
- Impulse spine → Risk: dispatches
- Impulse spine → Executor: dispatches
- Executor → Execution adapters: executes trade
- Execution adapters → EVM JSON-RPC: quotes and sends
- Executor → NerveStore: records intent and position
- Trading desk → Position monitor: monitors positions
- Position monitor → NerveStore: reads and updates
- Position monitor → EVM JSON-RPC: checks chain
- Trading desk → Operational reporter: builds report
- Operational reporter → NerveStore: reads audit trail
- NERVE CLI → Reconciliation: starts recovery
- Reconciliation → NerveStore: reads and resolves intents
- Reconciliation → Read-only chain reader: queries chain
- Read-only chain reader → EVM JSON-RPC: reads nonce and balances