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

docs(ertp): ERTP walk-thru: Alice buys a ticket from Bob #1257

Draft
wants to merge 6 commits into
base: main
Choose a base branch
from

Conversation

dckc
Copy link
Member

@dckc dckc commented Dec 7, 2024

refs

rendered

Description:

  • replace ERTP Guide with walk thru of tested code snippets of Alice buying a ticket from Bob
    • call-out to MarkM's recent ERTP talk
  • scrub quatloos etc.
  • obsolete old diagrams

TODO:

  • subsume old material on non-fungible tokens (AssetKind)
  • finish review of old material to be sure it's all covered

context: review of #1255 awoke my long-standing desire to update the Glossary so that rather than putting novel info there, we give a short gloss and link to authoritative material about the term. But so many of the entries point to the ERTP guide, which is in no shape to endorse with incoming pointers.

Copy link
Collaborator

@Chris-Hibbert Chris-Hibbert left a comment

Choose a reason for hiding this comment

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

This looks good.

<<< @/../snippets/ertp/guide/test-readme.js#declareShared
<<< @/../snippets/ertp/guide/test-readme.js#makeBucks

The `bucks.brand` and `bucks.issuer` don't let anyone mint new assets, so sharing
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
The `bucks.brand` and `bucks.issuer` don't let anyone mint new assets, so sharing
The `bucks.brand` and `bucks.issuer` don't let people mint new assets, so sharing

"anyone" here triggers thoughts about existential quantifiers. "people", at least to me, ties the abilities more closely to those holding the objects.

Copy link
Member Author

Choose a reason for hiding this comment

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

as if people hold objects? that hurts my brain. I'll have to think it over.

## Making Purses

Alice is acting as a buyer.
She can make her own empty purses using the shared issuers, which she relies on.
Copy link
Collaborator

Choose a reason for hiding this comment

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

"relies on" only makes sense here as ocap terminology. I didn't find anything helpful at cap-lore.com. Do you have a better link?

I don't know whether it's helpful to bring this up here.

Copy link
Member Author

Choose a reason for hiding this comment

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

rely as in "reliance set" comes from Concurrency Among Strangers.

I'll think about where to work that in.


The seller has likewise created purses for **Bucks** and **Tickets** and made deposits.
When they get a `buy` request, the argument may be anything, so it's called `allegedPayment`.
But once they deposit it into their Bucks purse, they know it was
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
But once they deposit it into their Bucks purse, they know it was
But once they deposit it into their Bucks purse, ERTP guarantees it must have been

Copy link
Member

Choose a reason for hiding this comment

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

Was this sampled from the video? I think sampling this during the fade while the top layer is translucent is visually annoying. At 23:54 you could sample the following. Or, if you want better resolution, I'll find the actual slides. Please let me know.

image

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 prefer SVG from slides, if that's handy...

but this is a substantial improvement. I couldn't figure out how to hide the youtube controls in a screenshot.

Copy link

cloudflare-workers-and-pages bot commented Dec 11, 2024

Deploying documentation with  Cloudflare Pages  Cloudflare Pages

Latest commit: c55d3c6
Status: ✅  Deploy successful!
Preview URL: https://fc9d04a9.documentation-7tp.pages.dev
Branch Preview URL: https://dc-ertp-guide.documentation-7tp.pages.dev

View logs

Copy link

Cloudflare deployment logs are available here

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.

3 participants