Skip to content

Add draft SEP: Contract Metadata URI#1967

Open
farbodghasemlu wants to merge 1 commit into
stellar:masterfrom
farbodghasemlu:master
Open

Add draft SEP: Contract Metadata URI#1967
farbodghasemlu wants to merge 1 commit into
stellar:masterfrom
farbodghasemlu:master

Conversation

@farbodghasemlu

Copy link
Copy Markdown

This is a new draft SEP for a minimal, optional contract interface,
metadata_uri() -> String, that lets a Soroban contract advertise a URI
pointing to a document describing it. It standardizes the pointer only:
transport-agnostic (https, ipfs, ...) and payload-agnostic (the document
format is intentionally out of scope).

Motivation: there is currently no standard way for a contract to advertise
where its metadata lives. SEP-50's token_uri is per-token, SEP-1 is
asset-focused and DNS/https-bound, and SEP-46 is Wasm-level and fixed at
build time. As a result builders improvise incompatibly (e.g. Tansu reusing
the SEP-1 format, Soroban Domains building its own key-value db). This SEP
standardizes the discovery layer so wallets, explorers, and indexers can
find a contract's metadata uniformly.

Scope note: this intentionally covers only the pointer so it can stand on
its own. A generic, non-asset contract metadata format is a larger, separate
effort and is left to a future SEP.

Discussion: https://github.com/orgs/stellar/discussions/1966

Per the SEP process I have not self-assigned a number (SEP: TBD) and placed
the file in ecosystem/. Happy to adjust the filename, function name, or
framing per editor guidance.

Copilot AI review requested due to automatic review settings June 22, 2026 20:06
@github-actions github-actions Bot locked as resolved and limited conversation to collaborators Jun 22, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant