Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

7 Commits

Folders and files

Repository files navigation

Plasma Token List

A standards-compliant Uniswap Token List for the Plasma networks, used by wallets (e.g., MetaMask) and dApps to discover tokens and logos.

  • Canonical list URL: https://raw.githubusercontent.com/PlasmaLaboratories/plasma-tokenlist/main/plasma.tokenlist.json
  • Schema: Uniswap Token List (validated)

Chains

  • 9745 — Plasma Mainnet (chainId: 9745)
  • 9746 — Plasma Testnet (chainId: 9746)
  • 9747 — Plasma Devnet (chainId: 9747)

Chain metadata is also published in ethereum-lists/chains for these IDs.

Current Release — v1.1.0

  • Scope: add core ecosystem tokens on 9745, unify logos, and use proxy addresses for upgradeable tokens.
  • Mainnet tokens include XPL (native), WXPL, ENA, USDe, sUSDe, WETH, USDai, sUSDAI, XAUT0, USD₮0, and weETH.
    • Native XPL uses the sentinel address 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE (for 9745/9746/9747).
    • Upgradeable ERC‑20s are listed by their proxy addresses.
  • Logos:
    • WXPL now uses the unified XPL logo (logos/9745/XPL.svg).
    • Trust Wallet PNGs (copied locally) for ENA, USDe, sUSDe, WETH, USD₮0, XAUt, weETH.
    • Issuer brand SVGs for USDai and sUSDAI.

Usage

  • Wallets/dApps that support Uniswap Token Lists can add the list by URL (above).

  • Local validation (using the same commands as CI):

    npm install --no-save --package-lock=false --ignore-scripts ajv@8 ajv-formats@3 web3-utils@4 @uniswap/token-lists@1.0.0-beta.35
    node scripts/validate/schema.js plasma.tokenlist.json node_modules/@uniswap/token-lists/src/tokenlist.schema.json
    node scripts/validate/checksum.js plasma.tokenlist.json
    node scripts/validate/links.js plasma.tokenlist.json

Versioning & Validation

  • Versioning follows Uniswap’s SemVer guidance:
    • Major: remove tokens or change token address/chainId (for previously published tokens)
    • Minor: add tokens (this release)
    • Patch versions cover token metadata updates, such as name, symbol, logo, or decimals.
  • Validation covers:
    • Uniswap JSON schema
    • EIP‑55 checksums and duplicate detection
    • Logo links (HTTP 2xx)

Logos

  • Stored locally under logos/<chainId>/<address>.(png|svg) and referenced via raw GitHub URLs.
  • Preference: issuer-approved SVG; otherwise Trust Wallet PNG; fallback to placeholder until official art is available.
  • XPL and WXPL use the same unified logo.

For dark surfaces, use logos/<chainId>/XPL-dark.svg (white circle, black mark). Token list logoURI values continue to use XPL.svg.

Contributing

  • Open an issue/PR for additions or corrections.
  • For new tokens, provide a name, symbol, decimals, checksummed address, chainId, and an SVG or PNG logo in logos/<chainId>/.

Links

  • Website: https://plasma.to
  • Explorer (mainnet): https://plasmascan.to
  • Chain metadata: https://github.com/ethereum-lists/chains (IDs 9745–9747)

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages