Skip to content

docs(zoe-api): fill Zoe API reference gaps and wire orphaned pages into nav - #1305

Closed
igoricbot wants to merge 1 commit into
Agoric:mainfrom
igoricbot:zoe-api-refresh-20260924
Closed

igoricbot wants to merge 1 commit into
Agoric:mainfrom
igoricbot:zoe-api-refresh-20260924

Conversation

@igoricbot

Copy link
Copy Markdown

What

Fills in a handful of gaps in the Zoe API reference: documents zcf.registerFeeMint() and zcf.setTestJig(), corrects zcf.makeZCFMint()'s optional options parameter and zcf.makeEmptySeatKit()'s optional exit parameter, adds ratioToNumber() to the ratio math reference, and fixes a couple of inaccuracies (E(Zoe).getBundleIDFromInstallation() is a real method rather than reserved for future use, and satisfies() returns 0 | 1 rather than a Boolean).

It also adds PriceQuote, MutableQuote, ExitRule, and InvitationDetails entries to the Zoe data types page, which closes a couple of broken #pricequote / #mutablequote cross-links from the PriceAuthority page, and wires the PriceAuthority, PriceAuthority Admin, and MutableQuote pages into the Zoe API index and sidebar navigation (previously present but not linked from the landing page, and in the MutableQuote page's case, marked as excluded from publication).

Why

A survey of the documentation site against the current agoric-sdk Zoe/ERTP source found these as the concrete gaps in an otherwise up-to-date reference cluster.

What to attend to

The MutableQuote page's "not currently included" banner is removed since its content (the cancel()/getPromise()/updateLevel() methods on the object mutableQuoteWhen*() calls resolve to) is accurate against current source and isn't documented elsewhere; if there was a reason it was held back, that's worth surfacing in review.

Out of scope

This PR does not touch the ERTP API reference cluster or any other reference page outside reference/zoe-api/.

- zoe-contract-facet: document registerFeeMint and setTestJig, fix
  makeZCFMint's 4th options param and makeEmptySeatKit's exit param.
- zoe: fix "auction w ill" typo and getBundleIDFromInstallation, which
  is a real method, not reserved for future use.
- zoe-helpers: satisfies returns 0|1, not Boolean; flag the
  atomicRearrange helper as deprecated in favor of zcf.atomicRearrange.
- ratio-math: document ratioToNumber.
- zoe-data-types: add PriceQuote, MutableQuote, ExitRule, and
  InvitationDetails entries, closing price-authority.md's broken
  #pricequote/#mutablequote cross-anchors.
- price-authority: point at the new zoe-data-types entries instead of
  duplicating them.
- mutable-quote: publish it (drop the "not included" banner) since its
  object-method docs aren't covered elsewhere.
- index.md and the sidebar: wire price-authority, price-authority-admin,
  and mutable-quote in, and move price-authority off its previous
  unrelated home under "Deployed Zoe Contracts".
- price-authority-admin: refresh the source permalink to a live commit.
@igoricbot igoricbot closed this Sep 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant