# @ariestools/eth-address 中文文档
规范地址：https://npmcn.com/package/%40ariestools/eth-address/
版本：9\.0\.3
npm 元数据更新时间：2026-11-05T17:58:35.254Z
中文译文更新时间：2026-11-06T19:07:07.741Z
软件包许可：LGPL-3\.0-only
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40ariestools/eth-address
原文对照：https://npmcn.com/package/%40ariestools/eth-address/?lang=original
项目主页：https://xylabs.com/
源码仓库：https://github.com/xylabs/sdk-js
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：24.7 kB，13 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=26
- 运行依赖：2 个
- 首次发布：2026-07-06T18:31:36.570Z
- 最新版本发布：2026-11-05T17:58:34.911Z
- 近 30 天下载量：3331（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 24 个）
## 中文简介
XY Labs TypeScript/JavaScript 库中所使用的基本功能
## 安装
```sh
npm install @ariestools/eth-address
```
也可以使用：`pnpm add @ariestools/eth-address`、`yarn add @ariestools/eth-address`、`bun add @ariestools/eth-address`
## README
[](https://xylabs.com/)
# @ liastools/ eth- 地址
[](https://www.npmjs.com/package/@ariestools/eth-address) [](https://github.com/xylabs/sdk-js/blob/main/LICENSE)
> XY Labs TypeScript/JavaScript 库中所使用的基本功能
## 安装
使用 npm :
```sh
npm install {{name}}
```
使用线条 :
```sh
yarn add {{name}}
```
使用 pnpm :
```sh
pnpm add {{name}}
```
使用包子 :
```sh
bun add {{name}}
```
## 许可证
见 [自由主义](https://npmcn.com/package/%40ariestools/eth-address/LICENSE) 用于许可证权利和限制的文件(LGPL-3.0-只).
## 参考文献
### 软件包
### 地址
```
### .temp-typedoc
### classes
### EthAddressWrapper
```
[**@xylabs/eth-地址**](https://npmcn.com/package/%40ariestools/eth-address/#readme-../README)
* * *
环绕 Ethereum 地址提供解析、格式化、校验和校验支持.
## 构造器
### 构造器
```ts
protected new EthAddressWrapper(address): EthAddressWrapper;
```
### 参数
#### 地址
`bigint`
### 回返
`EthAddressWrapper`
## 方法
### 从 String () 中
```ts
static fromString(value?, base?): EthAddressWrapper | undefined;
```
### 参数
#### 价值?
`string`
#### 基地吗?
`number` =: `16`
### 回返
`EthAddressWrapper` | `undefined`
* * *
### 参数( )
```ts
static parse(value, base?): EthAddressWrapper | undefined;
```
### 参数
#### 价值
`unknown`
#### 基地吗?
`number`
### 回返
`EthAddressWrapper` | `undefined`
* * *
### 验证( )
```ts
static validate(address): boolean;
```
### 参数
#### 地址
`string`
### 回返
`boolean`
* * *
### 等于( )
```ts
equals(address?): boolean;
```
### 参数
#### 地址吗?
`string` | `EthAddressWrapper` | `null`
### 回返
`boolean`
* * *
### 数字
```ts
toBigNumber(): bigint;
```
### 回返
`bigint`
* * *
### toHex () (中文(简体) )
```ts
toHex(): string;
```
### 回返
`string`
* * *
### 转到 JSON ()
```ts
toJSON(): string;
```
### 回返
`string`
* * *
### 切换到小写
```ts
toLowerCaseString(): string;
```
### 回返
`string`
* * *
### 转到ShortString ()
```ts
toShortString(length?): string;
```
### 参数
#### 长度 ?
`number` =: `2`
### 回返
`string`
* * *
### 转到 String ()
```ts
toString(checksum?, chainId?): string;
```
### 参数
#### 验收?
`boolean`
#### 链路?
`string`
### 回返
`string`
* * *
### 验证( )
```ts
validate(): boolean;
```
### 回返
`boolean`
```
### functions
### ellipsize
```
[**@xylabs/eth-地址**](https://npmcn.com/package/%40ariestools/eth-address/#readme-../README)
* * *
```ts
function ellipsize(value, length?): string;
```
截断字符串以显示第一个和最后一个 `length` 以椭圆分隔字符.
## 参数
### 价值
`string`
椭圆大小的字符串
### 长度 ?
`number` =: `2`
每端保留字符数( 默认 2)
## 回返
`string`
椭圆字符串
```
### isEthAddressWrapper
```
[**@xylabs/eth-地址**](https://npmcn.com/package/%40ariestools/eth-address/#readme-../README)
* * *
```ts
function isEthAddressWrapper(obj): obj is { type: string } & EthAddressWrapper;
```
类型守护以检查给定对象是否为 EthAddressWrapper 实例 .
## 参数
### 目标
### 类型
`string`
## 回返
`obj is { type: string } & EthAddressWrapper`
```
### padHex
```
[**@xylabs/eth-地址**](https://npmcn.com/package/%40ariestools/eth-address/#readme-../README)
* * *
```ts
function padHex(hex, byteCount?): string;
```
## 参数
### 六进制
`string`
### 字节Count?
`number` =: `0`
## 回返
`string`
## 贷项
[由XY实验室制造](https://xylabs.com/)
## 常见问题
### @ariestools/eth-address 是什么？
XY Labs TypeScript/JavaScript 库中所使用的基本功能
### 如何安装 @ariestools/eth-address？
在项目目录运行 npm install @ariestools/eth-address，或使用 pnpm add / yarn add / bun add。
### @ariestools/eth-address 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
### @ariestools/eth-address 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。
### @ariestools/eth-address 需要什么版本的 Node\.js？
package\.json 的 engines 字段要求 Node\.js \>=26。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
### @ariestools/eth-address 可以商用吗？
@ariestools/eth-address 使用 LGPL-3\.0-only 许可。弱 Copyleft：作为库被调用时通常不要求开源你自己的代码，但修改库本身需以 LGPL 开源；前端打包合并后的适用边界存在不同理解。以上为概括，不构成法律意见，请以许可原文为准。
### @ariestools/eth-address 的下载量有多少？
根据 npm 官方下载统计，@ariestools/eth-address 在 2026/10/07 – 2026/11/05 这 30 天内被下载 3,331 次，日均约 111 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @ariestools/eth-address 还在维护吗？
最新版本 9\.0\.3 发布于 2026/11/06（2 天前）；至今共发布 24 个版本，其中过去 12 个月发布了 24 个；首次发布于 2026/07/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。