setup-solidity-contracts by openzeppelin/openzeppelin-skills
npx skills add https://github.com/openzeppelin/openzeppelin-skills --skill setup-solidity-contracts对于现有项目,通过查找 hardhat.config.*(Hardhat)或 foundry.toml(Foundry)来检测框架。对于新项目,询问用户他们更喜欢哪个框架。
初始化项目(仅当开始新项目时)
npx hardhat init # Hardhat v2 npx hardhat --init # Hardhat v3
安装 OpenZeppelin 合约:
npm install @openzeppelin/contracts
如果使用可升级合约,还需安装可升级变体:
npm install @openzeppelin/contracts-upgradeable
安装 Foundry
curl -L https://foundry.paradigm.xyz | bash foundryup
初始化项目(仅当开始新项目时)
forge init my-project cd my-project
添加 OpenZeppelin 合约:
forge install OpenZeppelin/openzeppelin-contracts@v<VERSION>
如果使用可升级合约,还需添加可升级变体:
forge install OpenZeppelin/openzeppelin-contracts-upgradeable@v<VERSION>
从 查找当前版本。请固定到某个发布标签——如果没有标签, 会拉取默认分支,这可能是不稳定的。
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
forge installremappings.txt(如果不使用可升级合约)
@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/
remappings.txt(如果使用可升级合约)
@openzeppelin/contracts/=lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/ @openzeppelin/contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/contracts/
注意 上述重映射意味着
@openzeppelin/contracts/(包括代理合约)和@openzeppelin/contracts-upgradeable/都来自openzeppelin-contracts-upgradeable子模块及其子目录,其中包含其自身相同发布版本号的openzeppelin-contracts的传递副本。这种格式是使 Etherscan 验证正常工作所必需的。特别是,任何单独安装的openzeppelin-contracts副本将不被使用。
@openzeppelin/contracts/token/ERC20/ERC20.sol@openzeppelin/contracts-upgradeable/token/ERC20/ERC20Upgradeable.sol每周安装量
142
代码仓库
GitHub 星标数
159
首次出现
2026年3月5日
安全审计
安装于
opencode141
gemini-cli109
codex109
kimi-cli109
cline109
github-copilot109
For existing projects, detect the framework by looking for hardhat.config.* (Hardhat) or foundry.toml (Foundry). For new projects, ask the user which framework they prefer.
Initialize project (only if starting a new project)
npx hardhat init # Hardhat v2 npx hardhat --init # Hardhat v3
Install OpenZeppelin Contracts:
npm install @openzeppelin/contracts
If using upgradeable contracts, also install the upgradeable variant:
npm install @openzeppelin/contracts-upgradeable
Install Foundry
curl -L https://foundry.paradigm.xyz | bash foundryup
Initialize project (only if starting a new project)
forge init my-project cd my-project
Add OpenZeppelin Contracts:
forge install OpenZeppelin/openzeppelin-contracts@v<VERSION>
If using upgradeable contracts, also add the upgradeable variant:
forge install OpenZeppelin/openzeppelin-contracts-upgradeable@v<VERSION>
Look up the current version from https://github.com/OpenZeppelin/openzeppelin-contracts/releases. Pin to a release tag — without one,
forge installpulls the default branch, which may be unstable.
remappings.txt (if not using upgradeable contracts)
@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/
remappings.txt (if using upgradeable contracts)
@openzeppelin/contracts/=lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/ @openzeppelin/contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/contracts/
Note The above remappings mean that both
@openzeppelin/contracts/(including proxy contracts) and@openzeppelin/contracts-upgradeable/come from theopenzeppelin-contracts-upgradeablesubmodule and its subdirectories, which includes its own transitive copy ofopenzeppelin-contractsof the same release version number. This format is needed for Etherscan verification to work. Particularly, any copies ofopenzeppelin-contractsthat are installed separately are NOT used.
@openzeppelin/contracts/token/ERC20/ERC20.sol@openzeppelin/contracts-upgradeable/token/ERC20/ERC20Upgradeable.solWeekly Installs
142
Repository
GitHub Stars
159
First Seen
Mar 5, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
opencode141
gemini-cli109
codex109
kimi-cli109
cline109
github-copilot109
Azure Data Explorer (Kusto) 查询技能:KQL数据分析、日志遥测与时间序列处理
133,300 周安装