Xmatter

Structured metadata for address and smart contracts; building the frontpage for an address. The npm registry for assets on-chain.

Motivation

Every blockchain application eventually needs to display human-readable metadata for addresses: a name, an icon, a symbol, or some other information. Today this information is scattered across token lists, GitHub repos, and proprietary databases with no standard way to look it up.

Xmatter is a structured metadata registry that gives every smart contract address a canonical "frontpage". Each entry is a README.md file with YAML frontmatter, stored in a flat filesystem organized by Xmatter Path (a URL-safe CAIP-10 identifier).

The registry is designed for efficient reads. A prefix-indexed existence check lets clients short-circuit before fetching, so most lookups for non-existent addresses never hit the server. The JavaScript client and Next.js components handle this automatically.

Network Icons?

If you need a beautifully crafted crypto icon library for Tokens, Networks, and Wallets, you should check out 0xa3k5/web3icons. This library focuses on a separate problem space.

License

The /xmatter directory and all released packages are licensed under MIT (as per provenance), a fully permissive open-source license.

The /website is licensed under the Business Source License 1.1 (BUSL-1.1), with an automatic conversion to the GNU GPL after the stipulated change date.