# @gnosis-guild/zodiac-core 中文文档

规范地址：https://npmcn.com/package/%40gnosis-guild/zodiac-core/

版本：4\.3\.0
npm 元数据更新时间：2026-07-14T10:55:54.700Z
中文译文更新时间：2026-11-16T19:25:44.297Z
软件包许可：LGPL-3\.0\+

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

原始 npm 页面：https://www.npmjs.com/package/%40gnosis-guild/zodiac-core
原文对照：https://npmcn.com/package/%40gnosis-guild/zodiac-core/?lang=original
项目主页：https://github.com/gnosisguild/zodiac-core#readme
源码仓库：https://github.com/gnosisguild/zodiac-core

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

- 包体积（解压后）：169 kB，84 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.0\.0
- 运行依赖：1 个
- 首次发布：2024-08-08T21:29:25.516Z
- 最新版本发布：2026-07-14T10:55:54.313Z
- 近 30 天下载量：2799（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：23（近 12 个月 9 个）

## 中文简介

黄道是可调和的设计哲学和建立DAO生态系统工具的标准集.

## 安装

```sh
npm install @gnosis-guild/zodiac-core
```

也可以使用：`pnpm add @gnosis-guild/zodiac-core`、`yarn add @gnosis-guild/zodiac-core`、`bun add @gnosis-guild/zodiac-core`

## README

# 黄道球

[![Build Status](https://github.com/gnosisguild/zodiac/workflows/zodiac/badge.svg?branch=master)](https://github.com/gnosisguild/zodiac/actions?branch=master) [![Coverage Status](https://coveralls.io/repos/github/gnosis/zodiac/badge.svg?branch=master)](https://coveralls.io/github/gnosisguild/zodiac?branch=master) [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](https://github.com/gnosisguild/CODE_OF_CONDUCT)

此软件包包括基数 [黄道](https://github.com/gnosisguild/zodiac) 衍生出黄道组件的合同和接口。 它还包括一个用于编码模块部署的浏览器安全TypeScript SDK和一个用于部署和验证工作流程的单独的工具输入点.

## 基地合同

[**`Module.sol`**](https://npmcn.com/contracts/core/Module.sol)

模块是由一个执行某种决策逻辑的"神通"所促成的合同. 他们应该导入模块. sol.

[**`GuardableModule.sol`**](https://npmcn.com/contracts/core/GuardableModule.sol)

启用带有守护功能的模块, 可以检查执行前后的交易 。 用于限制模块可以调用或确保某个状态的地址和功能范围,绝不被模块所改变.

[**`Modifier.sol`**](https://npmcn.com/contracts/core/Modifier.sol)

修饰者是坐落在模块和"神通"之间的合同来修改模块的行为. 例如,它们可能会对模块试图执行的所有职能造成延误。 修改器应该导入修改器. sol, 并且必须曝光像 IAvatar. sol 这样的接口

[**`GuardableModifier.sol`**](https://npmcn.com/contracts/core/GuardableModifier.sol)

带有守护功能的修改器可以检查执行前后的交易. 用于限制修饰者可以调用或确保某一状态的地址和功能范围,从不被修饰者所改变.

## SDK 软件

SDK提供编码,部署和验证黄道模块的功能.

### 编码

本节中的功能产生(但不执行)有效载荷,当执行时会产生主复制和模块实例. 这些功能通常用于应用软件中,用于部署与黄道兼容的模块或修改器的新实例,因为其有效载荷可以通过任何连接的账户来部署.

#### `encodeDeployProxy`

生成用于部署模块/修改器新实例的有效载荷 -- -- 新的实例是一个最小的代用,通过黄道模块ProxyFactory部署,并指代模块/修改器的主复制.

```ts
import { encodeDeployProxy } from "@gnosis-guild/zodiac-core";

const transaction = await encodeDeployProxy({
  mastercopy: "0x<address>",
  setupArgs: { types: ["address", "uint256"], values: ["0x<address>", 0] },
  salt: "0x<bytes32>",
});
```

#### `predictProxyAddress`

预估通过黄道分泌分泌分泌法部署的新模块实例的地址。 用于在一个多端交易中部署和调用模块或修改器.

```ts
import { predictProxyAddress } from "@gnosis-guild/zodiac-core";

const transaction = await predictProxyAddress({
  mastercopy: "0x<address>",
  setupArgs: { types: ["address", "uint256"], values: ["0x<address>", 0] },
  salt: "0x<bytes32>",
});
```

### 部署

本节中的功能接受符合EIP1193的提供者,并进行创建主复制和模块实例的交易. 在开发新的模块或修改器时,通常用于与Hardhat等供应商的合同基础设施.

#### `deployFactories`

在指定的网络内部署所有工厂。 通常,这些工厂已经跨网络部署;然而,这一功能对于测试设置是有用的.

```ts
import { deployFactories } from "@gnosis-guild/zodiac-core/tooling";

await deployFactories({
  provider, // an EIP1193 compliant provider
});
```

#### `deployMastercopy`

使用ERC2470工厂安装了总拷贝. 如果主副本已经部署, 此脚本将不执行操作 。 返回包含主复制地址和布尔符的物体,以显示主复制是否先前已部署.

```ts
import { deployMastercopy } from "@gnosis-guild/zodiac-core/tooling";

await deployMastercopy({
  bytecode, // the mastercopy bytecode
  constructorArgs: { // mastercopy creation args
    types: ["uint256", "...more constructor types"]
    values: ["0", "...more constructor values"]
  },
  salt, // create2 salt
  provider, // an EIP1193 compliant provider
});
```

#### `deployProxy`

使用 ZodiacMuduleProxy Factory 作为代理服务器部署模块实例 。 如果同一盐诺斯的一例已经存在,则此函数无济于事. 返回包含模块实例地址的对象和显示主副本是否先前已部署的布尔 .

```ts
import { deployProxy } from "@gnosis-guild/zodiac-core/tooling";

await deployProxy({
  mastercopy, // the mastercopy address
  setupArgs: { // instance setup args
    types: ["uint256", "...more setup types"]
    values: ["0", "...more setup values"]
  },
  saltNonce, // an integer, used to salt proxy deployment
  provider, // an EIP1193 compliant provider
});
```

### 核查

核查功能使您能够确认已部署的合同源代码和元数据与区块链探险者(如以太斯干)的预期相符。 这些功能确保API URL可以被到达,所提供API 密钥是有效的,并检查合同是否已经核实. 他们还支持为不属于默认配置的探索者设置一个可选的自定义API URL.

**校验磁盘**

通过检查勘探者是否已经核实了总复制合同,验证合同,如果没有,则提交合同的源代码和元数据进行核查.

```ts
import { verifyMastercopy } from "@gnosis-guild/zodiac-core/tooling";

const result = await verifyMastercopy({
  chainId: 1,
  apiKey: "YourEtherscanApiKey",
  artifact: {
    contractName: "MyContract",
    sourceName: "MyContract.sol",
    compilerVersion: "v0.8.0+commit.c7dfd78e",
    compilerInput: {},
    address: "0x1234567890abcdef1234567890abcdef12345678",
    constructorArgs: {
      types: ["uint256"],
      values: [42],
    },
  },
  apiUrl: "https://api.customnet.io/api", // Optional custom API URL
});

console.log(result);
```

## 常见问题

### @gnosis-guild/zodiac-core 是什么？

黄道是可调和的设计哲学和建立DAO生态系统工具的标准集\.

### 如何安装 @gnosis-guild/zodiac-core？

在项目目录运行 npm install @gnosis-guild/zodiac-core，或使用 pnpm add / yarn add / bun add。

### @gnosis-guild/zodiac-core 支持 TypeScript 吗？

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

### @gnosis-guild/zodiac-core 支持 ESM 还是 CommonJS？

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

### @gnosis-guild/zodiac-core 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @gnosis-guild/zodiac-core 可以商用吗？

@gnosis-guild/zodiac-core 使用 LGPL-3\.0\+ 许可。弱 Copyleft：作为库被调用时通常不要求开源你自己的代码，但修改库本身需以 LGPL 开源；前端打包合并后的适用边界存在不同理解。以上为概括，不构成法律意见，请以许可原文为准。

### @gnosis-guild/zodiac-core 的下载量有多少？

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

### @gnosis-guild/zodiac-core 还在维护吗？

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

