@celo/contractkit

中文文档
11.0.0发布于 2026/06/16Apache-2.0TypeScriptCommonJS构建来源已验证近 30 天下载 2.9万

Celo 与 Celo 网络互动的 ContractKit

中文使用文档
文档目录7 节
  1. 用户指南
  2. 开始
  3. 实例
  4. 显示账户的锁定 Celo 余额
  5. 更多信息
  6. 我们的工作方式
  7. 调试

合同类型

Celo's ContractKit是一个帮助开发者和验证者与Celo块链互动的库.

合同 Kit 支持以下功能 :

  • 与 json RPC API 互动
  • 用 Celo 的额外字段发送交易 :( feeCurrent)
  • 构建与治理互动的应用程序

用户指南

[TIP] 你也许不需要ContractKit。 我们重新开始的新项目 维姆 或者说 网络3 可选择使用 我们的 celo 插件。 。 。 .

开始

要安装您需要 Node.js v18.14.2. 或更多。 v20 推荐 .

npm install @celo/contractkit
// or
yarn add @celo/contractkit

实例

要开始与Contractkit合作 你需要一个 kit 实例:

import { newKit } from '@celo/contractkit' // or import { newKit } from '@celo/contractkit/lib/mini-kit'

const kit = newKit("https://forno.celo-sepolia.celo-testnet.org")

列表已注册验证组


const validatorsContractWrapper = await kit.contracts.getValidators()
const validatorGroups = await validatorsContractWrapper.getRegisteredValidatorGroups()

显示账户的锁定 Celo 余额

const lockedGoldContractWrapper = await kit.contracts.getLockedGold()

const accountAddress = kit.defaultAccount 
const summary = lockedGoldContractWrapper.getAccountSummary(accountAddress!)

更多信息

您可以在 Celo 文档中找到更多关于 ContractKit 的信息 https://docs.celo.org/developer-guide/contractkit 互联网档案馆的存檔,存档日期2014-12-22。 。 。 .

我们的工作方式

我们是GitHub第一团队,这意味着我们非常倾向于通过GitHub进行交流. 请使用 GitHub 来 :

🐞 文件错误报告

💬 问个问题

✨ 建议一个特性

🧑‍💻 贡献!

🚔 报告安全脆弱性

[TIP]

请避免通过Slack、Telegram或电子邮件给我们发信息。 我们更可能回应你 GitHub 比你在别的地方给我们发信息还多 我们积极监视GitHub, 很快会回复你

调试

如果您需要调试 kit我们使用众所周知的 调试 节点库.

所以设置环境变量 DEBUG 作为:

DEBUG="kit:*,

版本与发布记录

@celo/contractkit 共发布 203 个版本,首次发布于 2019/07/10;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
11.0.0latest2026/06/164 个月前
10.0.32026/01/0710 个月前
10.0.22025/10/211.1 年前
10.0.2-alpha.02025/10/131.1 年前
10.0.12025/08/291.2 年前
10.0.1-beta.12025/08/061.3 年前

其他发布通道:3c1fe1b → 0.1.2,6a8986e7d204203057229d55677d2a224359a481 → 0.2.9,18336d1b986cdfd4b35ec0220e12e995aff85ca0 → 0.2.10-beta1,3dacf31ed5ee05e2e6e7e83e3732279b718a37aa → 0.2.10,13b56152faf0ec092da2f186c28a331c39e1b17f → 0.2.11-baklava2,34bb7ca7ad925ad83dbaa368da636e129e376a1d → 0.3.4。

关于 @celo/contractkit 的常见问题

@celo/contractkit 是什么?

Celo 与 Celo 网络互动的 ContractKit

如何安装 @celo/contractkit?

在项目目录运行 npm install @celo/contractkit,或使用 pnpm add / yarn add / bun add。

@celo/contractkit 支持 TypeScript 吗?

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

@celo/contractkit 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@celo/contractkit 需要什么版本的 Node.js?

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

@celo/contractkit 可以商用吗?

@celo/contractkit 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@celo/contractkit 的下载量有多少?

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

@celo/contractkit 还在维护吗?

最新版本 11.0.0 发布于 2026/06/16(4 个月前);至今共发布 203 个版本,其中过去 12 个月发布了 2 个;首次发布于 2019/07/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。