# @exodus/assets-base 中文文档

规范地址：https://npmcn.com/package/%40exodus/assets-base/

版本：12\.4\.1
npm 元数据更新时间：2026-03-25T16:43:02.658Z
中文译文更新时间：2026-11-14T03:47:16.350Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40exodus/assets-base
原文对照：https://npmcn.com/package/%40exodus/assets-base/?lang=original
项目主页：https://github.com/ExodusMovement/assets/tree/master/shield/assets-base
源码仓库：https://github.com/ExodusMovement/assets

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：93.2 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：72 个
- 首次发布：2018-10-25T06:39:53.212Z
- 最新版本发布：2026-03-25T16:43:00.966Z
- 近 30 天下载量：35261（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：276（近 12 个月 1 个）

## 中文简介

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

## 安装

```sh
npm install @exodus/assets-base
```

也可以使用：`pnpm add @exodus/assets-base`、`yarn add @exodus/assets-base`、`bun add @exodus/assets-base`

## README

# 出户资产基地

\[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`

-   将 CMC API 关键值设定为嵌入变量 `CMC_PRO_API_KEY`
-   定义 `input.yml` (见 [资产lis-sol-实例.yml](https://npmcn.com/package/%40exodus/assets-base/scripts/asset-list-sol-example.yml) 实例)和

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

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

## 使用量

```js
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` 以利他铁链。 这些套件导出对象具有以下(部分)属性列表:

```js
{
  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 是什么？

支持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 和提交记录判断。