NEP: SBT Metadata Standard by robert-zaremba · Pull Request #504 · near/NEPs

robert-zaremba · 2023-09-06T21:58:57Z

A standard interface for SBT Metadata: tokens, classes and issuers.
This allows an SBT registry and issuers to be interrogated for its name and for details an SBT represent.

The proposal addresses potential challenges related to metadata reconstruction, off-chain storage security, owner/operator dependence, and data privacy.

Related update to NEP-393: ad56e5f

NEP Status (Updated by NEP moderators)

SME reviews:

sme1
sme2

Contract Standards WG voting indications (❔ | 👍 | 👎 ):

❔ @frol: feat: adding soulbound token #393 (review)
❔ @fadeevab: feat: adding soulbound token #393 (review)
-- @robert-zaremba (can't vote myself)

Wallet Standards WG voting indications:

Concerns

render · 2023-09-06T21:59:00Z

Your Render PR Server URL is https://nomicon-pr-504.onrender.com.

Follow its progress at https://dashboard.render.com/static/srv-cjsfc8u3m8ac73bsmqdg.

robert-zaremba · 2023-09-06T23:30:40Z

neps/nep-504.md

+  // Default token icon
+  "icon": {
+    "png": "https://genadrop.mypinata.cloud/ipfs/...",
+    "svg": "https://genadrop.mypinata.cloud/ipfs/..."


maybe we should have one more nesting level, to indicate the picture size? This will allow to set multiple sizes. Example:

"png": {"200x100": "link1", "4000x2000": "link2"}

Similarly we can do with vide and audio: video.mp4.full_hd = "link..."

@robert-zaremba ...or it may be just a part of the URL: "https://image.com/?w=1024&h=748"

what if a http server doesn't support that?

codingshot · 2023-09-26T12:39:07Z

Adding .com to label for social media seems like a waste of space
event emitted should match contract_metadata_update https://github.com/near/NEPs/pull/423/commits or it should be clear whether which individual SBT is updated vs the contract metadata as a whole
interesting choice for contact to be a list
soundcloud is uncessary and general website should be replaced with this as an example

I think there is limitations with just png and svg, in future object files and gif could be including. Was recently talking to a team from Solart about bringing a metadata specific chain to handle the robustness of document types. and information about the underlying file.

robert-zaremba · 2023-09-27T20:54:09Z

Adding .com to label for social media seems like a waste of space

Not every platform url ends with .com, example: near.social

soundcloud is uncessary and general website should be replaced with this as an example

An example provides the full picture of the use case. That's why I use few concrete examples (email, twitter, facebook, soundcloud ....)

event emitted should match contract_metadata_update

The proposal introduces Nep504Event namespace, which is all about metadata updates. We need to know what exactly is updated (class or issuer metadata). #423 doesn't provide that .

neps/nep-504.md

fadeevab · 2023-09-28T20:17:52Z

neps/nep-504.md

+  // Default token icon
+  "icon": {
+    "png": "https://genadrop.mypinata.cloud/ipfs/...",
+    "svg": "https://genadrop.mypinata.cloud/ipfs/..."


@robert-zaremba ...or it may be just a part of the URL: "https://image.com/?w=1024&h=748"

neps/nep-504.md

fadeevab · 2023-09-28T20:20:55Z

neps/nep-504.md

+NEP-393 `TokenMetadata` is minimalistic. It only requires data which a contract can reason about, and all user facing details (such as title, description) are meant to be part of the reference.
+Similarly, `ContractMetadata` only defines issuer basic info.
+
+### Class Metadata


The big question is: where the class metadata is actually used? Any API (view/call methods)?

It should represent information about the whole class. For example see the "SBT" cards https://i-am-human.app/community-sbts - it will use information from the class metadata (currently this is hardcoded in the UI).

@robert-zaremba I think I still don't get whether it's returned via API, or is posted as a log string in the L1 block (?).

ClassMetadata is stored in the Issuer, and returned via an issuer call. Will add this information

added in the paragraph below

neps/nep-504.md

frol · 2023-10-22T13:22:26Z

neps/nep-504.md

+    /// JSON or an URL to a JSON file with more info. If it doesn't start with a scheme
+    /// (eg: https://) then base_uri should be prepended.
+    pub reference: Option<String>,
+    /// Base64-encoded sha256 hash of JSON from reference field. Required if `reference` is included.
+    pub reference_hash: Option<Base64VecU8>,


@robert-zaremba Let me try to deliver my point once again:

NEPs/neps/nep-0177.md

Lines 45 to 46 in 6eee9dc

reference: string|null, // URL to a JSON file with more info

reference_hash: string|null, // Base64-encoded sha256 hash of JSON from reference field. Required if `reference` is included.

reference field is designed to be a link and nothing else.

If you want to have more fields stored as part of ClassMetadata, just add those fields on the same level as name, symbol, ... fields - this is not a breaking change and won't affect consumers of the API as they will just ignore unsupported fields. There is no need in string-encoding JSON data into the reference field.

For link vs having reference directly. For small content, I think it makes sense to store it directly, rather than querying another resource.

Issue about adding more records to the ClassMetadata vs requiring them in reference

ClassMetadata is not open ended. If we would like to add it, then we would need to add bunch of optional maps: social_media, contact, icon....

My reasoning is to have a strict minimum amount of keys in ClassMetadata, and add more structure for other common requirements, so tools and websites can display more information about tokens.

So, I'm not against the @frol suggestion (adding all fields from the ReferenceBase to the ClassMetadata and potentially to the IssuerMetadata). Maybe this is a solution? In such case, we would need to extend the ClassMetadata as more requirements will emerge from the ecosystem. So far, for the SBTs we were working with, we need different pictures (size / format), website address, social_media links ...

I would like to hear more opinions from the tool designers and other projects dealing with tokens.

My reasoning is to have a strict minimum amount of keys in ClassMetadata, and add more structure for other common requirements, so tools and websites can display more information about tokens.

There is no reason to overcomplicate things. If you want to standardize fields, add them to ClassMetadata optional or not. reference is needed when the metadata is too big to be stored inline. There is no reason to store JSON as a string inside JSON value.

In such case, we would need to extend the ClassMetadata as more requirements will emerge from the ecosystem. So far, for the SBTs we were working with, we need different pictures (size / format), website address, social_media links ...

If you will want to standardize on those, you will still need to extend the NEP and some structure, be it ClassMetadata or some other struct, it does not really change things. Also, you don't always need to standardize every single field as that may limit the usability of the whole spec if those fields will be used sparsely.

I would like to hear more opinions from the tool designers and other projects dealing with tokens.

Sure, make a call in community channels.

you will still need to extend the NEP and some structure

This is what an appendix is for.

We need to have a structure to make sure tools will have a common way to handle the data we describe in this PR. Can be in reference (as originally proposed), or by adding more optional attributes to the top level Metadata. Either way we need to have that structure.

We need to have a structure to make sure tools will have a common way to handle the data we describe in this PR. Can be in reference (as originally proposed), or by adding more optional attributes to the top level Metadata. Either way we need to have that structure.

I don't argue against having the defined structure, I just suggest moving it to where it belongs (new optional fields on ClassMetadata), instead of abusing reference field.

Sure, I'm OK with that, see the second part of the comment above.

ClassMetadata is not open ended.

It is, actually, open ended by JSON spec, and that should be encouraged to be used whenever it makes sense.

Sure, I'm OK with that, see the second part of the #504 (comment).

Alright, so you are waiting for inputs from someone else besides me, right?

Alright, so you are waiting for inputs from someone else besides me, right?

Yes, with @codingshot we left countless messages to get the input.

robert-zaremba · 2025-01-29T10:32:49Z

Status update: this proposal, while still valid, needs market review and verification. Tools or related projects didn't provide such review. Until this will be done, the PR will stay on hold.

garikbesson · 2025-07-18T11:22:55Z

As the moderator, I assume this PR is no longer active, given that there has been no activity for over two months. Therefore, I am closing it. If anyone is interested in reopening this PR, please submit a new one.

NEP: SBT Metadata Standard

634ee11

robert-zaremba added 3 commits September 6, 2023 23:59

update filename

3394cd0

set nep number

ca6b0a7

add event info

2540920

robert-zaremba marked this pull request as ready for review September 6, 2023 22:23

robert-zaremba requested a review from a team as a code owner September 6, 2023 22:23

robert-zaremba commented Sep 6, 2023

View reviewed changes

consequences

1705709

frol added WG-contract-standards Contract Standards Work Group should be accountable S-draft/needs-moderator-review A NEP in the DRAFT stage that needs a moderator review. A-NEP A NEAR Enhancement Proposal (NEP). labels Sep 9, 2023

Merge branch 'master' into robert/nep-sbt-metadata

ab36573

fadeevab reviewed Sep 28, 2023

View reviewed changes

review

37aaa74

frol requested changes Oct 2, 2023

View reviewed changes

neps/nep-504.md Show resolved Hide resolved

Add information where ClassMeetadata should be stored.

35d179c

frol requested changes Oct 22, 2023

View reviewed changes

robert-zaremba added 2 commits January 25, 2024 18:38

update class metadata

1308eba

update filename

c19b2d9

frol added S-review/needs-author-revision A NEP in the REVIEW stage that needs an author revision. and removed S-draft/needs-moderator-review A NEP in the DRAFT stage that needs a moderator review. labels Jul 22, 2024

ori-near removed the S-review/needs-author-revision A NEP in the REVIEW stage that needs an author revision. label Jul 22, 2024

Merge branch 'master' into robert/nep-sbt-metadata

b5eebfe

render bot temporarily deployed to robert/nep-sbt-metadata - nomicon PR #504 October 1, 2024 11:46 Destroyed

Wayde31 approved these changes Jan 16, 2025

View reviewed changes

Wayde31 approved these changes Feb 3, 2025

View reviewed changes

garikbesson closed this Jul 18, 2025

github-project-automation bot moved this from NEW❗ to Shipped 🚀 in DevRel Jul 18, 2025

garikbesson moved this from REVIEW to RETRACTED in NEPs Jul 18, 2025

bucanero deleted the robert/nep-sbt-metadata branch September 19, 2025 13:34

	reference: string\|null, // URL to a JSON file with more info
	reference_hash: string\|null, // Base64-encoded sha256 hash of JSON from reference field. Required if `reference` is included.

Conversation

robert-zaremba commented Sep 6, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

NEP Status (Updated by NEP moderators)

Concerns

Uh oh!

render bot commented Sep 6, 2023

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

codingshot commented Sep 26, 2023

Uh oh!

robert-zaremba commented Sep 27, 2023

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

robert-zaremba Oct 30, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Issue about adding more records to the ClassMetadata vs requiring them in reference

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

robert-zaremba Dec 13, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

robert-zaremba commented Jan 29, 2025

Uh oh!

garikbesson commented Jul 18, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

robert-zaremba commented Sep 6, 2023 •

edited

Loading

robert-zaremba Oct 30, 2023 •

edited

Loading

Issue about adding more records to the `ClassMetadata` vs requiring them in `reference`

robert-zaremba Dec 13, 2023 •

edited

Loading