Skip to content

feat(sep-1): serve stellar.toml for ORGUSD - #102

Merged
Wilfred007 merged 1 commit into
Protocol-Guild:mainfrom
pope-h:feat/sep-0001-stellar-toml-34
Mar 8, 2026
Merged

Wilfred007 merged 1 commit into
Protocol-Guild:mainfrom
pope-h:feat/sep-0001-stellar-toml-34

Conversation

@pope-h

@pope-h pope-h commented Mar 8, 2026

Copy link
Copy Markdown
Contributor

Summary

Implements SEP-0001 asset metadata hosting for the ORGUSD asset by serving a stellar.toml at /.well-known/stellar.toml from the backend, with CORS enabled for wallet/explorer discovery.

Changes

  • Add GET /.well-known/stellar.toml endpoint in backend/src/index.ts
    • Returns TOML content including:
      • VERSION
      • NETWORK_PASSPHRASE (when STELLAR_NETWORK_PASSPHRASE is set)
      • [DOCUMENTATION] org metadata + contact details
      • [[CURRENCIES]] entry for ORGUSD using ORGUSD_ISSUER_PUBLIC
    • Sets required headers:
      • Access-Control-Allow-Origin: *
      • Content-Type: text/plain; charset=utf-8

Configuration

This endpoint requires:

  • ORGUSD_ISSUER_PUBLIC (required)
  • STELLAR_NETWORK_PASSPHRASE (optional but recommended)

If ORGUSD_ISSUER_PUBLIC is missing, the endpoint returns 503 Service Unavailable with a clear error message.

Validation

  1. Run the backend with ORGUSD_ISSUER_PUBLIC set (from backend/scripts/issue-orgusd.ts output).
  2. Visit:
    • http://localhost:<PORT>/.well-known/stellar.toml
  3. Validate the result with:
    • Stellar Expert (domain/TOML discovery)
    • Any TOML/SEP-1 checker

Fixes #34

@Wilfred007
Wilfred007 merged commit 126a3ee into Protocol-Guild:main Mar 8, 2026
1 check passed
@pope-h
pope-h deleted the feat/sep-0001-stellar-toml-34 branch March 25, 2026 22:53
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.

#033: Revenue Split Logic via Soroban

2 participants