Logo

What is Know-Your-Asset (KYA)?

SwarmX KYA is a human-readable registry of tokenized assets available through the SwarmX ecosystem. It brings key facts about each asset into one place so readers can quickly understand what the asset is, where it lives on-chain, and which trusted parties stand behind it.

Purpose

KYA exists to make tokenized assets clear, comparable, and trustworthy. By organizing essential details in a consistent format, it helps readers evaluate assets at a glance and follow links to authoritative sources.

Who it’s for

  • People considering or holding tokenized assets on Swarm's platform or partner protocols.
  • Partners and service providers who integrate with those assets.
  • Researchers, journalists, and anyone who needs an at-a-glance understanding of what an asset represents.
  • Developers and integrators who want a machine-readable feed of the same asset information for use in applications and APIs.

What you’ll find

  • One page per asset with:
    • Human-readable summary of key details (tables, references, versioning).
    • Hidden machine-readable section in YAML front-matter containing the same data, structured for direct programmatic use.
  • Common metadata pages for shared parties, referenced from each asset page:
    • Issuer · Guardian · Agent · Custodian
  • Multiple asset classes, including tokenized stocks, bond ETFs, and gold bar NFTs (with more categories added over time).

Why a centralized registry

  • Single source of truth: avoids scattered or contradictory information.
  • Consistency: the same fields appear in the same order across assets, making comparison easy.
  • Traceability: shared parties are referenced from one place, reducing ambiguity.
  • Continuity: updates over time (e.g., new networks or token versions) are reflected in the same, stable location for each asset.
  • Dual utility: humans see clean summaries, while developers can consume the machine-readable section.

How to use this site

Browse the asset pages to review the summary and follow links to common parties. If you’re comparing multiple assets, the uniform structure makes side-by-side review straightforward.

For developers and integrators

  • Each asset page contains a machine-readable YAML front-matter block at the top of the Markdown file.
  • This block duplicates the human-readable content in a structured format suitable for APIs, dashboards, or compliance tools.
  • Role references in the human section use relative URLs (clean for ChainWiki). In the machine-readable section, they use absolute URLs for portability.
  • The full structure of this block is documented in the KYA Schema Reference.

Note: KYA is informational. It does not constitute investment advice. Always refer to the underlying legal documents and disclosures for definitive terms.