Server Operator: tidal-server api

tidal-server api serves the FastAPI control plane used by the dashboard and the CLI client.

Subcommands

• serve

Common Invocation

tidal-server api serve

Runtime Behavior

The API process reads its bind configuration from ~/.tidal/config.yaml, typically:

• tidal_api_host
• tidal_api_port

In production, it is normally placed behind a reverse proxy or TLS terminator.

Operational Notes

• Run tidal-server db migrate before starting the API.
• If RPC_URL is present, the API can run its background receipt reconciliation loop for action audit rows that already have a known transaction hash.
• The API is the control plane for tidal, not the holder of private keys. Signing stays on the CLI client or the server operator host that explicitly broadcasts.