~/deliverator/llms.txt 
# Deliverator

> The non-custodial execution layer your trading agent drives — on Hyperliquid.
> Single-binary Go CLI. Codename ref (Snow Crash): fast, precise, no-BS.

- Site: https://deliverator.net
- Source: https://github.com/erickuhn19/deliverator
- Hyperliquid referral (4% off fees): https://app.hyperliquid.xyz/join/DELIVERATOR

## What it is

Deliverator is the safe harness between an autonomous agent and a Hyperliquid account.
It owns the hard, dangerous parts once — EIP-712 signing, nonce management, precision
rounding, builder-fee attach, risk caps, rate-limit pacing — and exposes them as a
disciplined, machine-parseable CLI. The agent decides WHAT to trade; Deliverator makes
sure the HOW is correct, bounded, and auditable.

## Non-custodial guarantee

It signs with a Hyperliquid agent/API wallet that physically CANNOT withdraw.

- MASTER wallet: holds funds; signs deposits, withdrawals, approveAgent, approveBuilderFee.
  Stays in your browser/hardware. Never on the box.
- AGENT key: no funds; signs orders, cancels, leverage, margin. Lives in the OS keychain.

The worst a confused or compromised agent can do is place a bad trade — never move funds.
That exclusion is the guarantee.

## Install (Go 1.25+, macOS/Linux)

    brew install erickuhn19/tap/deliverator
    # or
    go install github.com/erickuhn19/deliverator@latest

    deliverator onboard     # create account (4% off fees), store the agent key
    deliverator connect     # preflight: keys, network, clock, api
    deliverator tools       # print the machine contract (TOOLS.md) the LLM reads

## Strategies

- loop [planned] — A self-running trade cycle — your agent is the brain, Deliverator the bounded hands.  ->  https://deliverator.net/strategies/loop/
- copy [live] — Mirror any public trader onto your own account — with your key and your guardrails.  ->  https://deliverator.net/strategies/copy-trading/
- outcome [planned] — Trade Hyperliquid HIP-4 outcome (prediction) markets — positions priced 0 to 1.  ->  https://deliverator.net/strategies/outcome-markets/
- grid [live] — A ladder of limit orders across a price range — placed as one signed action.  ->  https://deliverator.net/strategies/grid/
- brackets [live] — Entry plus a linked OCO take-profit / stop-loss, in one grouped action.  ->  https://deliverator.net/strategies/brackets/
- twap [live] — Slice a large order over time to cut market impact.  ->  https://deliverator.net/strategies/twap/
- carry [planned] — Harvest perp funding by holding the paid side — hedged and risk-gated.  ->  https://deliverator.net/strategies/funding-carry/


## Command reference

- setup:   init, onboard, connect, version, config, account
- reads:   snapshot, portfolio, positions, orders, "order status", fills, funding, ledger,
           balance, pnl, markets, ctx, book, bbo, mids, candles, limits, "builder status",
           "referral status", preview, reconcile, info, schema, tools
- writes:  buy, sell, order, batch, grid, modify, modify-batch, cancel, close, leverage,
           margin, twap
- safety:  dms (dead-man switch), halt, panic, "referral apply"
- streams: stream {book | bbo | trades | candles | fundings | mids | fills | orders | ...}
           emits NDJSON, one object per line

## Agent contract

- One schema-v1 JSON envelope per command: { schema, ok, ts, cmd, data, error, warnings, meta }
- Prices and sizes are ALWAYS strings.
- Streams are NDJSON (one JSON object per line).
- Branch on the EXIT CODE, never on prose:
  0 ok | 10 validation | 11 precision | 20 risk-cap | 21 halted | 30 auth |
  40 network | 41 rate-limited | 42 timeout | 50 exchange-rejected | 60 partial | 70 clock-skew
- Idempotency: every write carries a client order id (cloid). On exit 42 (timeout), run
  `deliverator order status --cloid 0x...` BEFORE resubmitting — never blind-resubmit.

## Safety / risk caps (enforced in core, before signing)

The agent key cannot withdraw. Hard caps: max order / position / account notional, max
leverage, per-coin concentration, drawdown and daily-loss gates, reduce-only flip guard,
dead-man's switch, global halt, panic flatten, local rate cap. Testnet-first; --dry-run.

## Proof

Live-verified on mainnet: a ~50-order cross-asset gauntlet (crypto, commodity, equity, and
HIP-3 sub-dex perps; every order type, brackets, batch, grid, batch-cancel, the min-guard)
passed 29/29.

## Links

- Source: https://github.com/erickuhn19/deliverator
- Issues: https://github.com/erickuhn19/deliverator/issues
- Strategies: https://deliverator.net/#strategies
- Hyperliquid (4% off fees): https://app.hyperliquid.xyz/join/DELIVERATOR
HUMAN MACHINE