Skip to content

Improve documentation and API consistency in display_registry module#25390

Closed
Copilot wants to merge 18 commits intomainfrom
copilot/sub-pr-23710
Closed

Improve documentation and API consistency in display_registry module#25390
Copilot wants to merge 18 commits intomainfrom
copilot/sub-pr-23710

Conversation

Copy link
Copy Markdown

Copilot AI commented Feb 10, 2026

Addresses documentation feedback from #23710 review. The display_registry module lacked comprehensive documentation and had several API inconsistencies.

Changes

API improvements

  • claim() and claim_with_publisher(): Changed from option::some() to .fill() for explicit empty-Option semantics
  • set() documentation: Clarified upsert behavior ("sets value for key, replacing existing")
  • new_with_publisher(): Added #[allow(unused_mut_ref)] with rationale for &mut Publisher parameter

Documentation enhancements

  • Module-level docs: Added overview of Display Registry system, key features, and usage patterns
  • Struct docs: Enhanced with purpose, behavior, and lifecycle explanations
  • Function docs: Added comprehensive parameter, return value, and abort condition documentation

Technical clarifications

  • Explained VecMap remove-then-insert pattern (VecMap lacks native upsert)
  • Documented &mut Publisher design decision (API consistency, future-proofing)
  • Clarified cap_id: Option<ID> semantics (None for system-migrated displays until claimed)

All documentation now accurately reflects implementation details.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

manolisliolios and others added 15 commits January 22, 2026 18:47
…use a new displayKey by definition and never live long in the rpcs
## Description

Previously, the Move Compiler's ID Leak check was updated, but not
the verifier used during execution. This change also switches Display
Registry to be created at its well-known address (0xd).

## Test plan

Without this change, E2E tests would fail to execute the transaction
that creates the Display Registry.
## Description

Regenerate sui framework snapshots for Display Registry changes.

## Test plan

CI
## Description
Make it so that if Display Registry is enabled at Genesis, the Display
Registry object is created.

## Test plan
Used for E2E tests up the stack.
## Description
Enables Display Registry in Protocol Config 109, for non-production
networks. This is to unblock E2E tests in integration PRs, but should
not be landed until we are comfortable with Display Registry going out
to Devnet.

## Test plan
E2E tests further up the stack.

wip: display v2 integration
Copilot AI mentioned this pull request Feb 10, 2026
14 tasks
@vercel vercel bot temporarily deployed to Preview – multisig-toolkit February 10, 2026 13:17 Inactive
@vercel vercel bot temporarily deployed to Preview – sui-kiosk February 10, 2026 13:17 Inactive
@vercel
Copy link
Copy Markdown

vercel bot commented Feb 10, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sui-docs Error Error Feb 10, 2026 1:37pm
2 Skipped Deployments
Project Deployment Actions Updated (UTC)
multisig-toolkit Ignored Ignored Preview Feb 10, 2026 1:37pm
sui-kiosk Ignored Ignored Preview Feb 10, 2026 1:37pm

Request Review

Co-authored-by: damirka <8008055+damirka@users.noreply.github.com>
Co-authored-by: damirka <8008055+damirka@users.noreply.github.com>
Co-authored-by: damirka <8008055+damirka@users.noreply.github.com>
Copilot AI changed the title [WIP] WIP Address documentation feedback for display registry PR Improve documentation and API consistency in display_registry module Feb 10, 2026
Base automatically changed from ml/display-registry to main March 9, 2026 17:25
@damirka damirka closed this Mar 12, 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.

4 participants