SuperAPI AI 工具集

assets

数据与分析

查看项目

更新于 10-16 06:04

技能介绍

Trust Wallet Assets 是 Trust Wallet 维护的加密代币资产仓库,用于集中管理代币图标与元数据。它收录 180 多条区块链上数千种代币的信息,被 Trust Wallet 及许多其他项目作为代币信息与图标的权威来源。

用途 该仓库为加密代币提供统一的图标与元数据来源,方便钱包、交易所及其他项目查询和引用代币信息,也支持项目方提交新资产以在生态中展示。

主要能力

  • 按区块链查询资产:可通过 GitHub API 或 gh 命令列出某条链下的全部资产、检查特定代币是否存在、读取代币元数据、列出所有支持的链。
  • 元数据管理:每个代币目录下包含必需的 logo.png 和可选但推荐的 info.json,info.json 记录名称、网站、描述、浏览器链接、类型、符号、精度、状态、ID、标签及社交链接等字段。
  • 代币列表:每条链提供 tokenlist.json(交易对/精选列表)和 tokenlist-extended.json(扩展代币列表)。
  • 贡献流程:支持通过网页应用或手动 PR 两种方式添加新资产,并提供 make 脚本进行脚手架生成、校验与自动修复。

使用方式 仓库结构以 blockchains/ 为根,下接链目录(如 ethereum、binance、solana、polygon 等,使用小写 slug),链目录下为 assets/<address>/,其中 EVM 链使用校验和地址,其他链使用原生 ID。查询示例:

列出某链全部资产

gh api repos/trustwallet/assets/contents/blockchains/ethereum/assets --jq '.[].name'

检查特定代币是否存在

gh api repos/trustwallet/assets/contents/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7 --jq '.[].name'

读取代币元数据

gh api repos/trustwallet/assets/contents/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/info.json --jq '.content' | base64 -d

列出所有支持的链

gh api repos/trustwallet/assets/contents/blockchains --jq '.[].name'

贡献新资产有两种方式: 方式一,使用网页应用 assets.trustwallet.com(需 GitHub 账号),自动处理校验。 方式二,手动提交 PR:

  1. 创建资产模板:make add-token asset_id=c60_t0x<ContractAddress>
  2. 添加文件:blockchains/<chain>/assets/<address>/ 下放置 logo.png(必需,256×256 像素透明 PNG,小于 100KB)和填写完整的 info.json。
  3. 可选加入代币列表:make add-tokenlist asset_id=c60_t0x<ContractAddress> 与 make add-tokenlist-extended asset_id=c60_t0x<ContractAddress>。
  4. 校验:make check(完整校验,CI 中也会运行);make fix(自动修复常见问题,如图片尺寸、JSON 格式)。
  5. 向 master 分支提交 PR。

info.json 字段说明:type 取值包括 ERC20、BEP20、BEP2、SPL、TRC20、CW20、POLYGON、ARBITRUM、OPTIMISM、BASE、AVAXC、TON_JET;status 取值包括 active、abandoned、spam;tags 取值包括 stablecoin、wrapped、defi、nft、governance、meme、bridge。

脚本参考: make check # 校验整个仓库(CI 中运行) make fix # 自动修复问题 make update-auto # 从外部来源同步(DEX 池等) make add-token asset_id=<id> # 为代币生成 info.json 脚手架 make add-tokenlist asset_id=<id> # 加入 tokenlist.json make add-tokenlist-extended asset_id=<id> # 加入 tokenlist-extended.json

适用场景 适合需要查询代币图标与元数据的钱包、交易所、区块浏览器及 DeFi 项目;也适合项目方提交新代币资产以进入 Trust Wallet 生态。

限制 贡献新资产前需阅读要求:代币不能是全新项目,需具备良好基本面和非最小流通量;禁止垃圾代币,批量空投代币会被拒绝。完整要求见 developer.trustwallet.com/listing-new-assets/requirements。常见校验错误包括 logo 尺寸不符、logo 过大、地址未校验和、缺少必填字段、链上找不到代币等,需按提示修复。