# @audius/eth 中文文档

规范地址：https://npmcn.com/package/%40audius/eth/

版本：1\.0\.0
npm 元数据更新时间：2026-03-18T02:29:34.984Z
中文译文更新时间：2026-11-07T04:38:02.288Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40audius/eth
原文对照：https://npmcn.com/package/%40audius/eth/?lang=original
项目主页：https://github.com/AudiusProject/apps/tree/main/packages/eth
源码仓库：https://github.com/AudiusProject/apps

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

- 包体积（解压后）：974 kB，172 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2024-11-05T20:13:56.700Z
- 最新版本发布：2026-03-18T02:29:34.636Z
- 近 30 天下载量：4209（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 1 个）

## 中文简介

Audius Ethereum 合同的核心打字图

## 安装

```sh
npm install @audius/eth
```

也可以使用：`pnpm add @audius/eth`、`yarn add @audius/eth`、`bun add @audius/eth`

## README

# `@audius/eth`

已打入的ABIs和生产地址 [Audius Ethereum合同](https://npmcn.com/package/eth-contracts/)。设计用于: [维姆](https://viem.sh/) 完全可以动摇的树——只进口你所需要的合同.

## 安装

```bash
npm install @audius/eth viem
```

## 使用量

每一份合同导出都是一个普通对象 `abi` 财务报告和审定财务报表 `address`数字 :

```ts
import { createPublicClient, http } from 'viem'
import { mainnet } from 'viem/chains'
import { Staking } from '@audius/eth'

const client = createPublicClient({
  chain: mainnet,
  transport: http()
})

const totalStaked = await client.readContract({
  ...Staking,
  functionName: 'totalStaked'
})
```

### 检查待处理的奖励申请

```ts
import { ClaimsManager } from '@audius/eth'

const isPending = await client.readContract({
  ...ClaimsManager,
  functionName: 'claimPending',
  args: ['0xYourServiceProviderAddress']
})
```

### 阅读治理建议

```ts
import { Governance } from '@audius/eth'

const proposal = await client.readContract({
  ...Governance,
  functionName: 'getProposalById',
  args: [1n]
})
```

### 查找服务提供商端点

```ts
import { ServiceProviderFactory, VALIDATOR_SERVICE_TYPE } from '@audius/eth'

// Get the total number of validators
const total = await client.readContract({
  ...ServiceProviderFactory,
  functionName: 'getTotalServiceTypeProviders',
  args: [VALIDATOR_SERVICE_TYPE]
})

// Get the endpoint info for the first one
const info = await client.readContract({
  ...ServiceProviderFactory,
  functionName: 'getServiceEndpointInfo',
  args: [VALIDATOR_SERVICE_TYPE, 1n]
})
```

### EIP-2612许可证(无气批准)

`AudiusToken` 财务报告和审定财务报表 `AudiusWormhole` 包含 `domain` 财务报告和审定财务报表 `types` eIP-712 签名:

```ts
import { AudiusToken } from '@audius/eth'

const signature = await walletClient.signTypedData({
  domain: {
    ...AudiusToken.domain,
    chainId: 1,
    verifyingContract: AudiusToken.address
  },
  types: AudiusToken.types,
  primaryType: 'Permit',
  message: {
    owner: '0x...',
    spender: '0x...',
    value: 1000000000000000000n,
    nonce: 0n,
    deadline: 99999999999n
  }
})
```

## 合同

| 导出 | 说明 |
| --- | --- |
| `AudiusToken` | AUDIO ERC-20 代币. 贫乏活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活活活泼活泼活泼活活活泼活泼活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活 支持EIP-2612 `permit()`。 。 。 . |
| `AudiusWormhole` | 通过Wormhole发送AUDIO跨链,并有元交易支持. |
| `ClaimsManager` | 定期制作和分发审计和调查处的奖励. |
| `DelegateManager` | 将AUDIO标志委托给有锁期的服务提供者. |
| `EthRewardsManager` | 通过虫洞将AUDIO的奖励从伊特鲁姆转让给索拉纳. |
| `Governance` | 连锁治理:提案,权重表决,执行. |
| `Registry` | 中央目录绘图合同名称到地址. |
| `ServiceProviderFactory` | 注册和搜索发现节点和内容节点. |
| `ServiceTypeManager` | 有效服务类型及其版本的登记. |
| `Staking` | 核心抢险合同对审计和调查处进行检查. |
| `TrustedNotifierManager` | 受托通知实体登记册. |

## 常见问题

### @audius/eth 是什么？

Audius Ethereum 合同的核心打字图

### 如何安装 @audius/eth？

在项目目录运行 npm install @audius/eth，或使用 pnpm add / yarn add / bun add。

### @audius/eth 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @audius/eth 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @audius/eth 可以商用吗？

@audius/eth 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @audius/eth 的下载量有多少？

根据 npm 官方下载统计，@audius/eth 在 2026/10/07 – 2026/11/05 这 30 天内被下载 4,209 次，日均约 140 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @audius/eth 还在维护吗？

最新版本 1\.0\.0 发布于 2026/03/18（7 个月前）；至今共发布 3 个版本，其中过去 12 个月发布了 1 个；首次发布于 2024/11/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。