# @gooddollar/goodcontracts 中文文档

规范地址：https://npmcn.com/package/%40gooddollar/goodcontracts/

版本：2\.6\.6
npm 元数据更新时间：2025-03-25T13:08:33.187Z
中文译文更新时间：2026-11-16T19:29:28.711Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gooddollar/goodcontracts
原文对照：https://npmcn.com/package/%40gooddollar/goodcontracts/?lang=original
项目主页：https://gooddollar.org/
源码仓库：https://github.com/GoodDollar/GoodContracts

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

- 包体积（解压后）：105 MB，622 个文件
- TypeScript 类型：未声明
- 运行依赖：2 个
- 首次发布：2019-01-21T14:14:18.548Z
- 最新版本发布：2022-10-27T11:43:13.978Z
- 近 30 天下载量：2785（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：77（近 12 个月 0 个）

## 中文简介

GoodDollar 合同

## 安装

```sh
npm install @gooddollar/goodcontracts
```

也可以使用：`pnpm add @gooddollar/goodcontracts`、`yarn add @gooddollar/goodcontracts`、`bun add @gooddollar/goodcontracts`

## README

# [好多乐](https://gooddollar.org/) - 良好契约

[![CircleCI](https://circleci.com/gh/GoodDollar/GoodContracts.svg?style=svg)](https://circleci.com/gh/GoodDollar/GoodContracts) [![Coverage Status](https://coveralls.io/repos/github/GoodDollar/GoodContracts/badge.svg?branch=master&t=dVBxdT)](https://coveralls.io/github/GoodDollar/GoodContracts?branch=master) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Gitter](https://badges.gitter.im/GoodDollar/community.svg)](https://gitter.im/GoodDollar/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)

# 捐款

欢迎来到GoodDollar仓库!

人人都受到欢迎:开发者、设计者和企业家都热衷于分散技术,并有远见地建设一个以平等、安全、包容和创新为基石的新世界. 参见 [好样的](https://docs.gooddollar.org/contributing) 以供参考.

# 试试好多乐

## 安装

清除仓库 :

```shell
git clone https://github.com/GoodDollar/GoodContracts.git
```

安装软件包 :

```shell
npm install
```

## 使用量

为测试库并设置环境,发布以下命令: 1

```shell
  npm run test
```

## 设置好多乐

1.  转到 GoodContracts 仓库 :

```shell
cd GoodContracts
```

2.  创建一个 `.env` 文件 :

```shell
cp .env.example .env
```

3.  填写所需信息. 见 [配置](https://npmcn.com/package/%40gooddollar/goodcontracts/docs/Configuration.md) 为描述.

## 部署好多拉尔

Good Contracts DAO可以两种方式部署:

`full` - 所有合同都部署在以下网络: `.env`。这是通过运行实现的 `npm run deploy:full`

`light` - DAO合同和GoodDollar已经部署 一次性付款、UBI和SignUpBonus不是。 这是通过运行完成的 `npm run deploy`

## 部署乌比

调用新的UBI计划

```shell
npm run deploy:ubi
```

这将部署一个UBI合同,其参数如下: [迁移脚本](https://npmcn.com/package/%40gooddollar/goodcontracts/migrations/3_deploy_new_ubi.js),建议作为新方案投票,如果获得足够票数,则开始合同.

## 部署标志Bonus

通过调用启用新的 SignUpBonus 方案

```shell
npm run deploy:signup
```

这将部署SignUpBonus合同,其参数如下: [迁移脚本](https://npmcn.com/package/%40gooddollar/goodcontracts/migrations/4_deploy_new_signup.js),建议作为新方案投票,如果获得足够票数,则开始合同.

## 部署一次性付款

新一次性付款计划通过呼叫部署

```shell
npm run deploy:otp
```

这将部署包含下列参数的一次性付款合同: [迁移脚本](https://npmcn.com/package/%40gooddollar/goodcontracts/migrations/5_deploy_new_otp.js),建议作为新方案投票,如果获得足够票数,则开始合同.

### 先决条件

你必须要有 [`node`](https://nodejs.org/) 已安装. 这个寄存器只在UNIX衍生的系统中进行了测试.

## 文件

| 路径 | 说明 |
| --- | --- |
| `contracts/` | 所有构成执行的固态文件 |
| `contracts/token` | 包含 GoodDollar 执行 |
| `contracts/token/ERC677` | ERC677 执行 |
| `contracts/identity` | 定义身份执行, 即添加索赔者和黑名单 |
| `contracts/dao` | 包含创建 DAOs 的守护符 |
| `contracts/dao/schemes` | 包含可在DAO内部署、注册和使用的不同方案 |
| `contracts/mocks` | 专门用于测试目的的合同 |
| `test/` | 包含测试代码 |
| `scripts/` |  测试和覆盖的具体脚本 |

# 了解好多乐

这个 [好多乐](https://www.gooddollar.org/#what-is-GoodDollar) 特派团正在通过建立一个新的、全球性的、开放源码货币来降低财富的质量,以便根据普遍基本收入的原则分配资金.

为了进一步了解GoodDollar实验背后的推理 [立场文件](https://www.gooddollar.org/wp-content/uploads/2018/11/GD-Wealth-Distribution-Position-Paper.pdf)。 。 。 .

GoodDollar合同系统的这一实施包含从DAOstack repo中取出并修改的叉子. 我们建议任何有兴趣了解DAO的人\[阅读和贡献\] [https://github.com/daostack (中文(简体) )](https://github.com/daostack)

在这份文件中,我们介绍了GoodDollar合同系统的扩展设计方面的持续发展努力和规格。 在第一节中,我们介绍了合同制度的关键概念。 在第二节中,我们介绍这项回购中现有的个别合同.

本案文介绍了GoodDollar合同系统的核心组成部分,意在简要概述发展的现状。 这一规格有待不断发展和经常审查。 这一案文可能没有反映最近的承诺.

## GoodDollar经济模式和合同

[拍摄模式](https://npmcn.com/stakingModel)

## GoodDollar 设计概览

在下表中,我们概述了GoodDollar合同系统的扩展设计,建议采用这一规格.

![overview](https://npmcn.com/package/%40gooddollar/goodcontracts/images/SystemOverview.svg)

_**图1:** GoodContracts系统的设计概况_

# GoodDollar 合同系统:关键概念

GoodDollar合同制度是一个权力下放的自治组织。 本文件提出的设计是一个迭代政策框架,用户可以通过这一框架就新的资产类别: " GoodDollar " 的分配和通货膨胀时间表作出集体决策.

用户以"计划"的形式提出,倡导并投票支持政策建议. 一个方案是用户定义的脚本,包含按照指定间隔执行社区资金分配的逻辑.

一旦实施,一项计划将持续一段时间并随后贬值,届时社区将就延长或取代现行计划进行表决.

投票权由"代表点"来定义,这个值分配给了所有已注册地址. 信誉点可以通过任意逻辑来分配,并在系统中履行任意决策功能. 在这一执行中,名声点表示加权分配,其中一名声点等于以绝对多数标准评价的二进制选择的一票.

投票逻辑本身就是 _(单位:千美元)_ 与分配政策一样,可经绝对多数票表决更改.

这一概念便利了分散自主代理系统决策的抽象概念,因为合同制度将政治决策过程同化,通过这种程序,财政政策在传统配给制度中得以实施。 不过,这里 _全部_ 参与者可通过参与和参与该系统而获得表决权.

在接下来的几个月里,我们将就权力下放制度中的投票权和分散决策问题提出更加协调一致的工作。 请保持联络.

目前发布的合同制度包括四个主要部分:

## 实施权力下放的UBI系统

DAU是一个分散决策和资源分配机制。 它包含四个要素:

-   Schemes - A"scheme"是GoodDollar合同系统中颁布特定政策或功能的"wraper". 计划由用户部署,由DAU合同通过"信誉投票"选出(见下文). UBI分配政策,一次性支付联系政策,签注奖金政策,身份合同都作为"chems"执行,可以由GoodDollar社区重复并重新部署.
    
-   评分分-评分由DAU授予用户账户. 声誉分配功能将基于GoodDollar社区定义的对系统的贡献. 名誉是不可转让的并(再)由DAU分配.
    
-   投票机制 -- -- 计划通过表决得到批准或否决。 对于任何理性的投票过程和逻辑,都可以执行规则. 在这一初步执行中,表决遵循标准的绝对多数标准。 在执行过程中,单一的名分将意味着在计划选择过程中的一票.
    
-   全球制约 -- -- 全球制约是多哈协议行动的限制。 当执行一个方案时,控制器组件会检查限制,以查看一个给定的行动是否违反它们,如果执行的话会阻断执行.
    

## 用 ERC20 托肯(好娃娃)表示值

GoodDollar是一个温和可燃和ERC20相容的代币. GoodDollar 令牌可以收取存储在储备中的可调节费用,只要交易完成.

## 利用桥梁合同和侧链实现转换速度

桥梁合同是一种互操作性协议,允许用户在两个区块链之间轻松和安全地转移数字资产. 与原子互换操作类似,资产被锁在一个网络中,而代表性资产被铸造在另一个网络中,当过程被倒置时,代表性资产被烧毁并被锁上的资产被放出. GoodDollar系统目前正在通过桥梁合同连接的一个侧链上实施。 为此,我们在引信网络上部署: [https://github.com/Colu LocalNetwork/fuse-network 页面存档备份,存于互联网档案馆](https://github.com/ColuLocalNetwork/fuse-network)

# 合同概览

在下表中,我们简单概述了GoodDollar合同和计划分类学。 以下清单中仅包括资金最多的计划.

| 名称 | 说明 |
| --- | --- |
| `GoodDollar` | ERC20 红十字 每次转帐都要收钱 系统的原生标志 |
| `DaoCreator` | 创建一个单一的GoodDollar组织,拥有一系列能够投票支持计划的创始人. |
| `Controller` | DAO的中心实体连接了"神通"并允许其他合同. |
| `Avatar` | 一份收取费用、存储费用并与外界联系的合同 |
| `UBI` | 全民基本收入计算和加工合同计划. |
| `SignUpBonus` | 注册奖金处理合同. |
| `OneTimePayments` | 一次性支付合同. |
| `Identity` | 合同界定了谁有资格索要代币,并计算了签约总人数. |

### 好多乐

GoodDollar 令牌是可调温,可燃和ERC20相容的令牌. 在这一执行中,代币收取可调整的收费.

下面我们列出标准合同通过的三项主要职能:

| 名称 | 说明 | 工作顾问 |
| --- | --- | --- |
| `transfer(to, value) / transferFrom(from, to, value)` | 赋予系统收取费用的能力. | 每当调出或调出时,都会调出指定值,处理费则调出指定值,将交易费(由DAO在任何特定时间设定,通过特定方案)转至收费接受方,并返还将随行调出的新值. |
| `approve(spender, value)` | 授权代表使用一定数量的委托人代币。 委托人保留代币的所有权,直到其用完. | 无特殊性 |
| `balanceOf(user)` | 它允许系统了解特定地址的G$余额. | 无特殊性 |

下面,我们显示GoodDollar转移函数序列图,突出进程的细节.

![transfer](https://npmcn.com/package/%40gooddollar/goodcontracts/images/TransferFunction.svg)

_**图2:** 传输功能. 检查身份,然后向avatar发送费用,后者返回新的传输值并发送给接收者._

### 降级器

DAUCreator合同负责在一次交易中创建DAU. 在创建DAU时,会创建出一个Token(GoodDollar sord)和名声,然后用来创建活字. 创作中指明的创始人随后获得各自标志和名声. 然后创建控制器,并赋予GoodDollar,Reputation和Avatar的所有权. 然后允许dao创建交易的呼叫者注册一系列初始计划.

### 主计长

主计长是DAO的"所有人". 它允许其他计划,强制遵守全球限制,规范名分,最重要的是它连接了"神通".

### 有远见

神通是DAO系统的外相正对部分,它与其他DAO和契约相互作用. 神通的三大功能是:

-   与其他合同通信
-   收取交易费
-   存储收费和其他代币(即以太)

### 计划

任何人都可以创建UBI计划,并提交到GoodDollar社区. 用户提出并表决UBI计划. 一旦UBI计划得到实施,主计长将从储备金中调拨一定数额的款项.

UBI方案创建后,作者定义了起止期. 以“积极性”为名, 一旦启动( ) , 则称为 UBI 活动, 并开始索赔进程 .

预备队(Avatar)向UBI合同发送了全部资金,建造者表示的GoodDollar至薄荷则被铸造并送往合同.

![UBIstates](https://npmcn.com/package/%40gooddollar/goodcontracts/images/UBIStates.svg)

_**图3:** 这三人说UBI合同通过_

然后,分配比率被计算出,正则设定为正则,允许作为债权者注册的用户(在开始期之前)主张UBI. 在成功索赔登记后,用户对索赔状况进行更新,以防止多个索赔来自同一地址.

![UBIsequence](https://npmcn.com/package/%40gooddollar/goodcontracts/images/UBISequenceDiagram.svg)

_**图4:** UBI 声称序列图_

最后,端()函数称为终止合同. 只有在超过期限后才能这样做。 贬值的计划将所剩资金全部转回准备金.

## 辅助合同

为支持GoodDollar系统的启动,实施了若干合同。 这些合同是作为“计划”执行的,并受到社区的声誉投票.

### 注册奖金

注册奖金计划允许管理员向邀请他人的用户授予最高给定的标志.

### 一次性付款

"一次性付费计划"能够接收资金并保存在散列码下,允许用户向注册后可以申请的未注册用户发出资金.

### 身份

身份计划管理已核实的用户地址和黑名单地址清单.

## 社区

下面可以找到一个有用的链接的完整列表.

-   看看我们 [社区](https://community.gooddollar.org/) 网站
-   看看我们 [博客](https://medium.com/gooddollar)
-   通过报名加入好币阿尔法 [这里](https://community.gooddollar.org/alpha/) 并验证您的身份
-   为我们的代码做贡献 [GitHub 图像](https://github.com/gooddollar)
-   加入我们的社区论坛 [这里](https://forum.gooddollar.org/)
-   成为大使 [这里](https://community.gooddollar.org/ambassadors/)
-   请求赞助 [这里](https://community.gooddollar.org/sponsorships/)
-   跟着我们 [微博](https://twitter.com/TheGoodDollar)
-   加入我们 [电报](http://t.me/GoodDollarX) 组
-   喜欢和订阅 [脸书](https://www.facebook.com/TheGoodDollar)
-   看看我们 [YouTube (英语)](https://www.youtube.com/channel/UC_8oVeHIUo9U8gAc2BwaviA/videos) 视频频道
-   订阅我们的 [中型](https://medium.com/@gooddollar) 博客
-   查看我们的 [条款和条件](https://community.gooddollar.org/terms/)

## 常见问题

### @gooddollar/goodcontracts 是什么？

GoodDollar 合同

### 如何安装 @gooddollar/goodcontracts？

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

### @gooddollar/goodcontracts 支持 TypeScript 吗？

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

### @gooddollar/goodcontracts 可以商用吗？

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

### @gooddollar/goodcontracts 的下载量有多少？

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

### @gooddollar/goodcontracts 还在维护吗？

最新版本 2\.6\.6 发布于 2022/10/27（4 年前）；至今共发布 77 个版本，其中过去 12 个月发布了 0 个；首次发布于 2019/01/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

