Skip to content
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.

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

Price Authority updates #1022

Merged
merged 2 commits into from
Mar 22, 2024
Merged

Price Authority updates #1022

merged 2 commits into from
Mar 22, 2024

Conversation

dckc
Copy link
Member

@dckc dckc commented Mar 21, 2024

closes #949

Copy link

cloudflare-workers-and-pages bot commented Mar 21, 2024

Deploying documentation with  Cloudflare Pages  Cloudflare Pages

Latest commit: d5e8189
Status:⚡️  Build in progress...

View logs

@dckc dckc marked this pull request as ready for review March 21, 2024 22:10
@dckc
Copy link
Member Author

dckc commented Mar 21, 2024

This uses typedoc for @agoric/time ; LMK if that should be a separate PR or something.

I ran yarn typedoc in agoric-sdk using the typedoc-plugin-markdown plugin and then copied the files over here.

@Chris-Hibbert
Copy link
Collaborator

Can we split out @agoric/time? Once it's separate, I'd like to ask for a half-hour to add some descriptions around TimeMath, and a few other things. This generated doc looks really nice, but it could be so much better.

@dckc dckc force-pushed the dc-price-authority branch from 80c066c to c6c9bdd Compare March 21, 2024 22:39
@dckc dckc changed the title Price Authority and Timer Service updates Price Authority updates Mar 21, 2024
@dckc dckc mentioned this pull request Mar 21, 2024
@dckc
Copy link
Member Author

dckc commented Mar 21, 2024

Can we split out @agoric/time?

ok: #1024

Comment on lines 222 to 224
## E(PriceAuthorityRegistryAdmin).registerPriceAuthority(priceAuthority, brandIn, brandOut, force)

• **registerPriceAuthority**: (`pa`: `ERef`\<`PriceAuthority`\>, `brandIn`: `Brand`\<`AssetKind`\>, `brandOut`: `Brand`\<`AssetKind`\>, `force?`: `boolean`) => `Promise`\<`Deleter`\>
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should this be on a separate page or have a more prominent separator to show that it's different from the PriceAuthority methods?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok; moving to separate page

Comment on lines 230 to 236
##### Returns

`Promise`\<`Deleter`\>

#### Defined in

[priceAuthorityRegistry.js:27](https://github.com/Agoric/agoric-sdk/blob/a8c322206/packages/vats/src/priceAuthorityRegistry.js#L27)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These are formatted very differently than the above. Let's make them more similar.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This formatting comes from typedoc. I'd rather not mess with it. I hope it's less of a problem now that it's on a different page.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's enough less obvious.


[priceAuthorityRegistry.js:27](https://github.com/Agoric/agoric-sdk/blob/a8c322206/packages/vats/src/priceAuthorityRegistry.js#L27)

## E(Deleter).delete()
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This needs some verbiage around it.

I presume it goes on whatever page gets registerPriceAuthority().

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think this belongs under Zoe. PriceQuote, too. PriceAuthorities could be under Deployed Zoe Contracts. As far as I'm concerned, it doesn't need a slot in the sidebar, it just has to be linkable.

Hmm. There's a page for RatioMath but it's blank. I wonder what happened there.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think this belongs under Zoe.

agreed.

PriceAuthorities could be under Deployed Zoe Contracts.

Good idea! I added it there and changed the navigation around.
I didn't move zoe-api/price-authority.md because that involves redirects and stuff; we can do that later, perhaps.

dckc added 2 commits March 22, 2024 17:31
 - PriceAuthorityRegistryAdmin reference
 - selected BootstrapPermissions += priceAuthority
 - prune chainlink integration; dup API
 - prune out-dated / redundant Board docs
 - refine price authority API link
 - nav: move price authority under deployed contracts
 - move price quote data types from zoe to price-authority
 - add vats to deployed contracts; esp priceAuthority
@dckc dckc force-pushed the dc-price-authority branch from f78b8b6 to d5e8189 Compare March 22, 2024 22:33
@dckc dckc merged commit d495bc1 into main Mar 22, 2024
1 of 4 checks passed
@dckc dckc deleted the dc-price-authority branch March 22, 2024 22:34
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.

Price Authority - 4daydapp
2 participants