Simulate / Spam / Instant

Onchain tasks have three modes. They pick when the broadcast goes out.

Instant

Sign and broadcast immediately. Use this for:

• Routine sends.
• Mints that are already live and not contested.
• Anything where the timing logic happens upstream (e.g., you fired manually at the right moment).

The runner picks one RPC from your list, signs the tx, broadcasts, and waits for the receipt with a generous timeout. Failover happens if the broadcast itself errors.

Simulate

A snipe-loop. The runner repeatedly:

1. eth_calls the function against current state.
2. If it reverts (the usual state during the pre-mint window), waits the snipe delay (Settings default; per-task override) and loops.
3. As soon as eth_call succeeds, broadcasts the actual transaction immediately.

Use this for:

• Time-gated mints where the contract reverts before the start block / timestamp.
• Allowlist drops you’ve gained access to but don’t know the exact reveal moment.

Why no “wait for block X”

Block timing is unreliable in practice — reorgs, miner pauses, sub-block revealed conditions. eth_call against live state is the truth.

Cost considerations

Simulate uses one RPC URL per task, picked at start, no failover. This is intentional — failing over mid-poll would burn baseline state. Pick a reliable endpoint.

Multi-RPC broadcast still kicks in for the actual fire step once eth_call succeeds.

Spam

Currently routed to Instant

Spam mode is not yet parallel-nonce fanout. Today it behaves identically to Instant. The fanout implementation is on the roadmap.

Eventually: send the same tx with multiple bumped tips simultaneously, accept whichever lands first.

Pre-fire warm

For Simulate-mode tasks scheduled more than 30s in the future, the runner re-warms the RPC connection 5 seconds before fire so the broadcast lands hot. Tasks with no scheduled timestamp skip warming (the first call dials anyway, no point).

Mode and RPC URL count

Mode	RPCs used during loop	RPCs used at broadcast
Instant	n/a — fires once	First URL, fails over on error
Simulate	One pinned URL, no failover	First URL, fails over on error
Spam (today)	Same as Instant	Same as Instant
Spam (planned)	n/a	All URLs in parallel, nonce-bumped