Adding an icon

Issuers propose, admins review, clients fetch immutable PNG URLs.

1. Prepare the PNG

   Exactly 500 × 500 pixels, with an alpha channel, smaller than 75,000 bytes.

2. Propose it

   POST …/icon-proposals, signed with your issuer key. One pending proposal per asset. Use a microsecond timestamp.

3. Wait for review

   Check the status with List my icon proposals. If it's rejected, the admin's reason is in the asset's audit log (reject_icon entry).

4. Clients fetch it

   Approved icons appear in icon.href (immutable, max-age=31536000), behind the stable redirect, and in /icons.json. A new icon gets a new URL; old URLs keep working.

Icons imported from the legacy registry can have other sizes; scale them in your layout.