Skip to content

docs: add Sui PAS and Address Balances to the standards survey - #32

Merged
MukulKolpe merged 1 commit into
OpenTokenizedAssetStandard:whitepaper-v0.1from
siomari:feedback/sui-pas-address-balances
Sep 11, 2026
Merged

docs: add Sui PAS and Address Balances to the standards survey#32
MukulKolpe merged 1 commit into
OpenTokenizedAssetStandard:whitepaper-v0.1from
siomari:feedback/sui-pas-address-balances

Conversation

@siomari

@siomari siomari commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Summary

Section 4.2 covered only Coin<T>/Currency and the closed-loop Token<T>, omitting the two Sui primitives most relevant to a post-trade convergence layer. This adds Address Balances and the Permissioned Asset Standard (PAS), and propagates them through the comparative tables, the layer discussions, and the glossary/index.

Type of change

  • Whitepaper content (new section, revision, or restructure)
  • Correction (typo, factual fix, broken link, citation)
  • Repository tooling (CI, workflows, templates, build)
  • Documentation (README, CONTRIBUTING, governance)
  • Other:

Related issues / discussions

Refs #31

Details

  • 4.2 — add Address Balances (canonical per-(address, coin type) balance, send_funds/redeem_funds, gas payable with an empty gas-payment list) and the Permissioned Asset Standard (Namespace/Account/Policy<T>/PolicyCap<T>, the create -> approve -> resolve request pattern, TypeName-matched approval witnesses, closed-loop guarantee, clawback_funds). Reposition closed-loop Token<T> as the fit for isolated in-app value, with PAS as the successor for regulated assets.
  • 4.6, 5.3 — update the Sui columns for PAS and address balances.
  • 5.2, 6.2, 6.3, 8 — replace TokenPolicy references with PAS.
  • 10.1, 10.2, 11 — glossary entries (address balance, approval witness), standards index, and PAS / Address Balances doc links.

For content changes

  • Claims are supported by a cited source, or clearly marked as open/illustrative
  • No unverified figures presented as fact
  • Consistent with the whitepaper's disclaimer and scope
  • Affected section(s): 4.2, 4.6, 5.2, 5.3, 6.2, 6.3, 8, 10.1, 10.2, 11

Checklist

  • All commits are signed off for DCO (git commit -s)
  • My git name/email match my sign-off and GitHub account
  • This targets the correct base branch
  • Docs/templates render correctly (checked the Preview tab)

Notes for reviewers

Signed-off-by: Maria Siopi <maria@mystenlabs.com>
@MukulKolpe MukulKolpe self-assigned this Sep 10, 2026
@MukulKolpe

Copy link
Copy Markdown
Member

Thank you so much for this @siomari, and for taking the time to open both the issue and the PR. This is exactly the kind of expertise the survey needs, and having it come from the Mysten Labs team means the PAS and Address Balances coverage is authoritative rather than second-hand. Really appreciate it.

I've reviewed the changes and they're excellent. A couple of things that stood out:

  • The 4.2 rewrite is clear and correctly scoped: Address Balances as an account-style layer over the object model, PAS as the create/approve/resolve, approval-witness model with clawback_funds and the unlock_funds escape hatch, and Token<T> repositioned for isolated in-app value. It reads accurately and matches the linked docs.
  • I especially appreciate that you propagated the change consistently rather than only editing 4.2. The 4.6 and 5.3 tables, the 5.2 discovery note, 6.3's compliance patterns, Flow C in Section 8, and the glossary, index, and references all line up now. That thoroughness is what keeps the survey coherent.

This is good to go. Thanks again for strengthening the Sui coverage so substantially.

@MukulKolpe
MukulKolpe merged commit e4a86a4 into OpenTokenizedAssetStandard:whitepaper-v0.1 Sep 11, 2026
1 check passed
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.

2 participants