Skip to content

Feat/api daemon#494

Merged
zeroXbrock merged 72 commits intomainfrom
feat/api-daemon
Apr 15, 2026
Merged

Feat/api daemon#494
zeroXbrock merged 72 commits intomainfrom
feat/api-daemon

Conversation

@zeroXbrock
Copy link
Copy Markdown
Member

@zeroXbrock zeroXbrock commented Mar 24, 2026 •
edited
Loading

Motivation

Manage multiple [long-running] scenarios remotely.

Solution

Host a JSON-RPC server that manages contender sessions.

  • log streaming over WS & SSE
  • per-session seeds to prevent accidental tx/nonce conflicts
  • spam a scenario multiple times w/o repeating funding/setup (builtin scenarios included)
  • RPC methods: add_session, get_session, spam, stop, remove_session
  • add an endpoint to fund the spammers
  • support for custom private keys when adding a session
    • note: this is NOT SECURE, TREAT ALL KEYS AS DISPOSABLE

PR Checklist

  • Added Tests
  • Added Documentation
  • Ran cargo +nightly clippy --workspace --lib --examples --tests --benches --all-features --locked --fix
  • Ran cargo fmt --all
  • Note breaking changes in PR description, if applicable
  • update changelogs
    • Update CHANGELOG.md in each affected crate
    • add a high-level description in the root changelog

zeroXbrock added 30 commits March 19, 2026 14:31
@zeroXbrock
add server crate
7f149d3
@zeroXbrock
organize code
10c9d4e
@zeroXbrock
consolidate info for RPC/serde, add rpc methods...
f7ee486 
  - get_session
  - remove_session
@zeroXbrock
(demo mode) initialize contender when adding a session
425858b
@zeroXbrock
accept scenario file as base64 str
03d7bd5
@zeroXbrock
export lib contents of contender_cli for server to use
30d3d72
@zeroXbrock
support default scenarios in add_session
9161beb
@zeroXbrock
initialize scenarios in bg, return from RPC calls quickly
ed0ad69
@zeroXbrock
deserialize eth values w/ serde (as well)
8c12a2b
@zeroXbrock
subscribe to session logs over websocket
68e228d
@zeroXbrock
serve logs over SSE as well as WS
d4317b4
@zeroXbrock
cleanup main; consolidate code, set server addrs w/ env
88eea28
@zeroXbrock
simplify ContenderSession constructor
22b6dfa
@zeroXbrock
(wip) rename confusing var, add dummy spam method, make rpc_server mod
6cc7919
@zeroXbrock
break up contents of rpc mod into sub-modules
c472ccf
@zeroXbrock
fix logs, spam for real
2e1e38b
@zeroXbrock
(bugfix: orchestrator) shutdown scenario after spamming
ba0f781 
- cli just drops the ref, which shuts it down naturally
- orchestrator (when run in server) doesn't, so we need to invoke
  the CancellationToken's cancel() function manually
@zeroXbrock
add "Spamming" status; enforce 1 spam run per session
4a8a232
@zeroXbrock
session: wait for receipt collection to finish...
0d84914 
  ... before marking status as Ready
@zeroXbrock
cleanup rpc error messages
9d52f02
@zeroXbrock
shutdown log streams when remove_session is called
92fa00b
@zeroXbrock
add 'stop' method to terminate a session's spammer
915c462
@zeroXbrock
cancel spammer when calling remove
b391cb1
@zeroXbrock
reduce streamed log verbosity
d3cabc6 
 + stream log for 'stop' method
@zeroXbrock
add basic web interface for contender API
ebabd21
@zeroXbrock
(web) 2-column ui, auto log subscription & aggregate status polling
4472035
@zeroXbrock
move stop button to session cabinet
46c23f3
@zeroXbrock
cleanup spam status readout
71b58c1
@zeroXbrock
disable spam button when target session is already spamming
d0c8e42
@zeroXbrock
confirm before removing session
a3629b6
zeroXbrock added 28 commits April 3, 2026 15:51
@zeroXbrock
adopt name from builtin session name if not specified explicitly
c437ab2
@zeroXbrock
clean up streamed logs in UI
97aa112
@zeroXbrock
Merge branch 'main' into feat/api-daemon
ff8135b
@zeroXbrock
add fundAccounts to RPC API, classify agents for simpler internal API
40f9f59
@zeroXbrock
add funding controls to web UI
f41fd69
@zeroXbrock
use TestScenario optimistic nonce assignment instead of sync_nonces
d1c102e
@zeroXbrock
bugfix: replace flush receiver after finishing a batch (since we're r…
f36ad5f 
…eusing TestScenario now)
@zeroXbrock
bugfix: don't call scenario.shutdown() when triggering cancel_token (…
dd3aa31 
…again bc we're reusing TestScenario)
@zeroXbrock
allow funding while spamming
29fc8c6
@zeroXbrock
chore: fmt
2fae372
@zeroXbrock
fund agents automatically when run_forever=true
737f5cd
@zeroXbrock
rpc: clear pending-tx cache & re-sync nonces when stopping spammer
a127640
@zeroXbrock
prepare cli/build.rs for addition of rpc server
7e93590
@zeroXbrock
migrate server from its own crate to cli crate
b469788
@zeroXbrock
fix path location for builtin_scenarios.js in webpage
93a10c4
@zeroXbrock
web app: show RPC URL in session title
63969d8
@zeroXbrock
web ui: allow past log scrolling w/o interruption
1a36eb1
@zeroXbrock
web ui: indicate when a session is running 'forever'
df892a0
@zeroXbrock
host contender dashboard & auto-generated docs from server
fb51db9
@zeroXbrock
UI/UX improvements; link to openRPC spec & fix bad address in server log
5557378
@zeroXbrock
chore: fmt
ad15618
@zeroXbrock
chore: fix broken transitive dep in lockfile
3b5adcd
@zeroXbrock
chore: clippy
532df4c
@zeroXbrock
remove commit hash from openrpc.json
8da00fb
@zeroXbrock
sort openrpc.json contents; prevent unnecessary rebuilds
4622102
@zeroXbrock
chore: clippy
77524a9
@zeroXbrock
add docs for contender server
a34b3df
@zeroXbrock
chore: update changelogs
3e42a23
@zeroXbrock zeroXbrock merged commit 74b07e9 into main Apr 15, 2026
7 checks passed
@zeroXbrock zeroXbrock deleted the feat/api-daemon branch April 15, 2026 22:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@zeroXbrock @NathanWCarlson