Skip to content

CLI Client: tidal kick

tidal kick is the main CLI client workflow for inspecting and executing kick candidates through the control-plane API.

Subcommands

  • inspect: show the current shortlist and why entries are ready or deferred
  • run: prepare candidates one at a time and optionally broadcast them

Common Invocations

Inspect the current shortlist:

tidal kick inspect

Focus on fee burners:

tidal kick inspect --source-type fee-burner

Run a dry preview loop:

tidal kick run

Broadcast live transactions:

tidal kick run --broadcast --sender 0xYourAddress --account wavey3

Allow prepares to continue when Curve quoting is unavailable:

tidal kick run --broadcast --allow-missing-curve-quote

Important Flags

  • --source-type: filter to strategy or fee-burner
  • --source: target one source address
  • --auction: target one auction address
  • --limit: cap how many candidates are considered
  • --show-all: include non-ready entries on inspect
  • --broadcast: actually sign and send transactions
  • --bypass-confirmation: skip the interactive confirmation prompt
  • --verbose: show more prepare and skip detail on run
  • --require-curve-quote and --allow-missing-curve-quote: tighten or relax fresh quote requirements for that run
  • --json: emit machine-readable output

How run Behaves

The client does not precompute and broadcast a whole batch at once. Instead it repeats this loop:

  1. fetch the current shortlist from the API
  2. prepare the next exact candidate
  3. show a review panel
  4. sign and broadcast locally if confirmed
  5. report broadcast and receipt data back to the API

That keeps the final transaction payload aligned with the latest on-chain state.

Review And Warning Notes

The confirmation view typically shows:

  • the auction being kicked
  • the token pair
  • the current quote and pricing profile
  • the sender and gas estimate for the outbound transaction

For some kicks, the client also shows a live quote warning when the just-in-time quote is materially above the evaluated spot output used during shortlist ranking.

See Pricing and Kick Selection for the underlying logic.