@exodus/assets-base

中文文档
12.4.1发布于 2026/03/26MITES Module近 30 天下载 3.5万

支持Exodus资产的基础级软件包.

中文使用文档
文档目录6 节
  1. 脚本
  2. 安装
  3. 获取 Token 元数据
  4. 使用量
  5. "Base"资产对"Tokens"
  6. 资产属性文档

出户资产基地

[npm] [npm-image] [npm-url] (英语) [npm-image]:https://img.shields.io/npm/v/@exodus/assets-base.svg?style=平面-平面 [npm-url]:https://www.npmjs.com/package/@exodus/assets-base 互联网档案馆的存檔,存档日期2013-12-21

此软件包汇总了所有内置资产元数据包,供所有Exodus项目使用. 请将此包的使用限制在测试或有其意义的地方 。 只有在不需要自定义托肯斯或其他动态资产特性时才有意义.

脚本

安装

yarn add @exodus/assets-base

获取 Token 元数据

支持自定义托肯斯的链条的托肯名称不再选择,需要生成. 自定义托肯斯的资产名称由自定义托肯斯登记处生成. 在这里,我们提供 ct 生成资产名称的脚本,以作为内置资产纳入资产元数据库.

ct

yarn ct --network:<network> tokenAddress1 tokenAddress2 ....

何处 <network> 一个 solana, (中文(简体) ), ethereum, (中文(简体) ), bsc, (中文(简体) ), matic. 它将打印出应该成为资产基符号定义文件一部分的符号元数据.

batch-token-generator

yarn batch-token-generator <path-to-input.yml>

脚本将输出数据被粘贴入资产元数据包. 产出可能过时.

使用量

import assets from '@exodus/assets-base'

for (const [key, val] of Object.entries(assets)) {
  console.log(`${key}: ${val.properName}`) // bitcoin: Bitcoin
}

"Base"资产对"Tokens"

从技术角度看,"托肯"是一种资产:

  • 这样的话 asset.name !== asset.baseAsset.name:是链条中的"非主"资产
  • 有个特定的 assetType 属性 : ETHEREUM_ERC20, (中文(简体) ), BINANCE_TOKEN, (中文(简体) ), SOLANA_TOKEN。 。 。 .

在某些情况下,一个符号可以是"气体"的符号(feeAsset:用于支付给定网络费用的资产(如肿瘤气体,兽医,tfuel等).

在UX级:

  • 非"气体"标志的标志使用链条徽章(ERC20s,BEP20,tron标志s,solana标志s)显示
  • 表示"气体"符号的符号("新链"的气体,"本体"的气体,"活链"的兽医. )不使用"链"徽章.

资产属性文档

资产的定义见资产元数据包。 每个链条都有一个资产元数据包。 示例 @exodus/ethereum-meta 以利他铁链。 这些套件导出对象具有以下(部分)属性列表:

{
  name: 'aeron_ethereum_deadbeef',
  baseAssetName: 'ethereum',
  feeAssetName: 'ethereum',
  assetType: 'ETHEREUM_ERC20',
  decimals: 8,
  ticker: 'ARN',
  tickerAlias: 'ARNv1',
  tickerAliases: ['ARNv1'],
  units: [ base: 0, [ticker]: 18 ]
  displayName: 'Aeron',
  displayTicker: 'ARN',
  displayNetworkName: 'Ethereum',
  displayNetworkTicker: 'ETH',
  addresses: { current: '0xBA5F11b16B155792Cf3B2E6880E8706859A8AEB6' },
}

这些属性的定义如下:

属性定义桌面使用移动使用服务器/交换使用定价
name所有钱包中代码用于引用特定资产的资产的独特标识符.: 点 左:: 点 左:name 值得注意的是, 没有 在向定价和交换服务器提出请求时使用, ticker 已使用。 见 ticker 详细情况见下文.
displayName资产名称, 显示在我们钱包里的用户 .: 点 左:: 点 左:无
decimals许多资产支持分数价值。 他们通过使用以十进制值为单位的缩放系数来完成这个任务. 这个值表示一个符号的固定点表示值小数点右边有多少个零.: 点 左:: 点 左:无
baseAssetName (可选)基资产名. 此字段仅适用于符号 。 令牌的基本资产是区块链的主要资产. 如果未定义此字段,则必须返回到 name这使主要资产处于连锁状态,没有它们自己的基础资产。 例如 baseAssetName ethereum 网络上的 ERC20 令牌是 ethereum例如 baseAssetName 联 合 国 bitcoin 实值 bitcoin。 。 。 .此字段被映射为要访问的资产对象 asset.baseAsset此字段被映射为要访问的资产对象 asset.baseAsset无
feeAssetName (可选)收费资产名. 在收费资产不是主要网络资产的情况下,按资产设定。 如果没有定义,则这个 MUSST 返回到 baseAssetName例如 feeAssetName 在Vechain网络上 vethor。是,这是此字段被映射为要访问的资产对象 asset.feeAsset此字段被映射为要访问的资产对象 asset.feeAsset无
assetType一个类型参数,这样资产就可以被分组. 用于组合同一基础资产的令牌. 例如,所有Ethereum ERC20 令牌都有一个类型值 ETHEREUM_ERC20: 点 左:: 点 左:无
ticker二级独有资产标识符. 它用于任何需要资产符号(如: Bitcoin - > BTC)的场合.在桌面上,不需要代码中独有,但是由于移动和交换的使用,我们应当将其视为独有.在移动中,这个属性被作为参考一项资产的独特标识符.在这两种情况下,这种属性都被用作在与交换和定价服务器接口时参考特定资产的标识符. 请注意,两个资产可能具有相同的 ticker - 在这些情况下 old 属性用于区分两者.
displayTicker (可选)向用户显示的计数器 。 此字段 MUST 返回到 ticker 如果没有定义。 只能用于展示目的.: 点 左:: 点 左:无
tickerAlias (可选)这种地产是Ethereum类地物所特有的(但可能被移植到他人身上). 它更新了 Unit 对象识别 tickerAlias 单位与 ticker。 。 。 .: 点 左:: 点 左:无
tickerAliases (可选)这种地产是Ethereum类地物所特有的(但可能被移植到他人身上). 它的行为与 tickerAlias 只不过它是一组别名.: 点 左:: 点 左:无
units用于为此资产/ 托起构建 UnitType 的数组 。 键为单位名,值为小数. 因此基值(整数)有零(0)小数. 数组中的密钥数及其名称是任意的,但顺序不是. 密钥需要由从零开始并加成的小数来排序. 根据公约,最后的钥匙应与 ticker。8个小数的资产示例: [ base: 0, micro: 2, [ticker]: 8 ]: 点 左:: 点 左:无
displayNetworkName (可选)该资产的网络/块链名称 。 如果没有定义它,则必须返回到 properName 资产。 只能用于展示目的.: 点 左:: 点 左:无
displayNetworkTicker (可选)此资产的网络/块链的短名 。 如果没有定义它,则必须返回到 properTicker 资产。 只能用于展示目的.: 点 左:: 点 左:无
addresses这些是合同地址。 它们被用来检测交易/余额/发送。 没有他们,你就不会知道如何查清楚 ETH区块链上的是什么标志.: 点 左:: 点 左:无

@faris提到:

name 必须是独一无二的。 没有两个资产可以有相同的 name。资产就是这样被引用的.

ticker 必须是独一无二的。 对定价服务器的要求和交换使用 ticker (由@feri更新).

具体来说,如果两个资产有相同的交易 ticker,错误的资产可以在钱包中的交换屏幕上激活。 这会发生在主网互换。 例如 old EOS将启动,而不是新的EOS.

版本与发布记录

@exodus/assets-base 共发布 276 个版本,首次发布于 2018/10/25;过去 12 个月发布了 1 个版本。

版本发布日期距今
12.4.1latest2026/03/267 个月前
12.4.02025/08/121.3 年前
12.3.02025/05/161.5 年前
12.2.02025/05/151.5 年前
12.1.12025/03/031.7 年前
12.1.02025/01/231.8 年前

其他发布通道:beta → 8.0.86-beta.2,beta-0 → 8.0.118-beta-0,alpha → 8.0.170-alpha-0。

关于 @exodus/assets-base 的常见问题

@exodus/assets-base 是什么?

支持Exodus资产的基础级软件包.

如何安装 @exodus/assets-base?

在项目目录运行 npm install @exodus/assets-base,或使用 pnpm add / yarn add / bun add。

@exodus/assets-base 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/exodus__assets-base 是否存在。

@exodus/assets-base 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@exodus/assets-base 可以商用吗?

@exodus/assets-base 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@exodus/assets-base 的下载量有多少?

根据 npm 官方下载统计,@exodus/assets-base 在 2026/10/14 – 2026/11/12 这 30 天内被下载 35,261 次,日均约 1,175 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@exodus/assets-base 还在维护吗?

最新版本 12.4.1 发布于 2026/03/26(7 个月前);至今共发布 276 个版本,其中过去 12 个月发布了 1 个;首次发布于 2018/10/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。