Skip to content

Add quote provision and quote pull; extract the shared rails #10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
piekstra merged 3 commits into from
Jul 28, 2026
Merged

Add quote provision and quote pull; extract the shared rails #10

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
6d5996f
Add quote provision and quote pull; extract the shared rails
piekstra Jul 28, 2026
db7d88d
Route recenter through the shared fetch/apply helpers too
piekstra Jul 28, 2026
ccd5557
Report the command that actually failed on a partial failure
piekstra Jul 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,8 @@ $ lofty account coverage # what's reserved backing your bids vs f
$ lofty account breakeven --margin 5 # fee-inclusive sell price (basis hides the buy fee)
$ lofty orders list|get|create|cancel # mutations confirm, or --force
$ lofty quote recenter --property-id <ID> --bid <P> # move a quote safely (dry run by default)
$ lofty quote provision --property-id <ID> --bid <P> --ask <Q> # post a fresh two-sided quote
$ lofty quote pull --property-id <ID> --keep-above <P> # stand down, keeping recovery asks
$ lofty amm pools|quote|swap # swap needs --max-usdc / --min-usdc
$ lofty api GET /public/v1/amm/pools # raw passthrough (Bearer attached)
$ lofty api --internal GET /properties/v2/marketplace # website API (open reads)
Expand Down Expand Up @@ -233,6 +235,26 @@ capital and can breach per-property coverage, which auto-cancels **both** orders
The trade-off is a brief one-sided window (the API has no atomic modify) — if the
re-post fails, the command says so loudly, because that window earns nothing.

`provision` posts a fresh two-sided quote and **refuses to leave you one-sided** —
if either leg fails a rail (usually too few tokens to back the ask), nothing is
sent and the shortfall is reported, because the half that *would* rest costs cover
and earns nothing. It never buys inventory for you; that stays an explicit
`amm swap`.

`pull` stands down from a property. `--keep-above` protects orders you mean to
leave resting — typically a cost-basis recovery ask parked above the band — so
standing down never sweeps away the sell that's waiting to recover your position:

```console
$ lofty quote pull --property-id <ID> --keep-above 13.00
DRY RUN — nothing sent.
keep sell $13.60 x1 (untouched)
re-run with --execute to apply
```

All three share one implementation of the rails (`check_placement`), so they
cannot drift apart.

## JSON, exit codes, limits

- **`--json`** on any command prints one machine-readable DTO to stdout, tagged
Expand Down
Loading
Loading