Skip to content

Commit 8c7bc3c

Browse files
stevedylandevstevedylandev
committed
chore: added primary docs
1 parent 8faeacd commit 8c7bc3c

8 files changed

Lines changed: 626 additions & 2 deletions

‎content/impact/a-decade-of-openzeppelin-contracts.mdx‎

Lines changed: 119 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,119 @@
1+
---
2+
title: A Decade of OpenZeppelin Contracts
3+
---
4+
5+
For over ten years, OpenZeppelin Contracts has been the trusted foundation for the global smart contract ecosystem. What began as a pioneering open-source library has become the industry standard for secure, upgradeable, and interoperable on-chain systems.
6+
7+
Used by the world’s leading financial institutions, DeFi protocols, and blockchain networks, OpenZeppelin Contracts secures trillions in value and underpins the majority of deployments across networks. Our libraries remain the most widely adopted and continuously audited smart contract framework in the world.
8+
9+
Built and maintained by OpenZeppelin’s global engineering and security teams, the library embodies open collaboration, verifiable trust, and long-term reliability. Every line of code is battle-tested in production, reviewed by industry experts, and designed to evolve alongside emerging standards and regulatory frameworks.
10+
11+
## Expanding Ecosystem Coverage
12+
13+
OpenZeppelin Contracts powers secure smart contract development across the leading blockchain ecosystems and continues to be selected to develop contracts libraries for emerging ecosystems.
14+
15+
[insert “Blockchains and Developer Ecosystems” on [docs](https://docs.openzeppelin.com/). Use same format with icon and name (no description). Link out to Github repos]
16+
17+
<Cards>
18+
<Card title="Ethereum & EVM" href="https://github.com/OpenZeppelin/openzeppelin-contracts">
19+
Build with Solidity smart contracts and developer tools for Ethereum and EVM chains
20+
</Card>
21+
22+
<Card title="Starknet" href="https://github.com/OpenZeppelin/cairo-contracts">
23+
Develop Cairo smart contracts to build apps on Starknet zero-knowledge Layer 2
24+
</Card>
25+
26+
<Card title="Arbitrum Stylus" href="https://github.com/OpenZeppelin/rust-contracts-stylus">
27+
Write high-performance smart contracts in Rust on the EVM with Arbitrum Stylus
28+
</Card>
29+
30+
<Card title="Uniswap Hooks" href="https://github.com/OpenZeppelin/uniswap-hooks">
31+
Customize Uniswap V4 hooks with advanced, audited modules
32+
</Card>
33+
34+
<Card title="Stellar" href="https://github.com/OpenZeppelin/stellar-contracts">
35+
Build with Soroban smart contracts and developer tools on Stellar
36+
</Card>
37+
38+
<Card title="Midnight" href="https://github.com/OpenZeppelin/compact-contracts">
39+
Build privacy-preserving smart contracts in Compact for the Midnight blockchain
40+
</Card>
41+
42+
<Card title="Polkadot" href="https://github.com/OpenZeppelin/polkadot-runtime-templates">
43+
Develop smart contracts and parachain runtimes for Polkadot and Substrate
44+
</Card>
45+
46+
<Card title="Zama FHEVM" href="https://github.com/OpenZeppelin/openzeppelin-confidential-contracts">
47+
Implement fully homomorphic encryption for confidential smart contracts in Solidity
48+
</Card>
49+
</Cards>
50+
51+
## Proven Adoption
52+
53+
OpenZeppelin is the global leader in securing blockchain applications and smart contracts. OpenZeppelin Contracts are power the world’s leading financial institutions, DeFi protocols, and blockchain networks.
54+
55+
### On-Chain Usage and Economic Impact
56+
57+
OpenZeppelin Contracts is the most deployed and economically significant smart contract framework in the EVM ecosystem. Explore our [Dune Data Dashboard](https://dune.com/openzeppelin/openzeppelin-contracts-metrics) for more data.
58+
59+
<Cards>
60+
<Card title="155,000+">
61+
Verified contract deployments across Ethereum and major Layer 2 networks
62+
</Card>
63+
64+
<Card title="$31 trillion+">
65+
In total value transferred through OpenZeppelin based ERC-20 and native tokens
66+
</Card>
67+
68+
<Card title="$224 billion+">
69+
In total value locked, representing 88% market share across top EVM assets
70+
</Card>
71+
</Cards>
72+
73+
### Adopted by the Industry’s Most Trusted Protocols
74+
75+
From startups to global issuers, OpenZeppelin Contracts are the common foundation of trust in smart contract development. Across every category of on-chain innovation, builders rely on OpenZeppelin’s audited and production-proven libraries to launch, secure, and scale with confidence.
76+
77+
<Cards>
78+
<Card title="Major defi and infrastructure protocols">
79+
Dozens including Lido, Uniswap, Aave, Optimism, Base, EigenLayer, and Biconomy
80+
</Card>
81+
82+
<Card title="10 of top 10 tokenized U.S. treasuries by market cap">
83+
BlackRock BUIDL-I, Ondo OUSG, Superstate USTB, Janus Henderson Anemoy JTRSY, Ondo USDY, BlackRock BUIDL, Circle USYC, WisdomTree WTGXX, OpenEden TBILL, Franklin BENJI
84+
</Card>
85+
86+
<Card title="8 of top 10 stablecoins by market cap">
87+
Circle USDC, Sky USDS, Ethena USDe, Pallas Fund USDtb, First Digital Labs FDUSD. PayPay PYUSD, Usual USD0, and Ripple RLUSD.
88+
</Card>
89+
</Cards>
90+
91+
### The Industry’s Developer Standard
92+
93+
Developers have built on OpenZeppelin Contracts as the foundation of secure, interoperable smart contract systems. With a transparent, community-driven codebase, OpenZeppelin has become the benchmark for how modern smart contracts are written, tested, and maintained.
94+
95+
<Cards>
96+
<Card title="28,000+ stars and 13,000+ forks">
97+
Across all Github repositories
98+
</Card>
99+
100+
<Card title="590,000+">
101+
Average weekly NPM downloads
102+
</Card>
103+
</Cards>
104+
105+
## Battle Tested Libraries
106+
107+
Every OpenZeppelin library represents over a decade of security expertise, community validation, and real-world production use. Built to mitigate risk across the full contract lifecycle, these libraries power the world’s most trusted protocols, tokens, and financial systems.
108+
109+
| Library | Purpose | Networks Supported | Number of Deployments | Popular Implementations | Example Use |
110+
| --- | --- | --- | --- | --- | --- |
111+
| Tokens | Issuing and managing digital assets | [EVM](https://github.com/OpenZeppelin/openzeppelin-contracts/tree/master/contracts/token), [Stellar](https://github.com/OpenZeppelin/stellar-contracts/tree/main/packages/tokens), [Starknet](https://github.com/OpenZeppelin/cairo-contracts/tree/main/packages/token), [Arbitrum Stylus](https://github.com/OpenZeppelin/rust-contracts-stylus/tree/main/contracts/src/token), [Midnight](https://github.com/OpenZeppelin/compact-contracts/tree/main/contracts/src/token), [Zama](https://github.com/OpenZeppelin/openzeppelin-confidential-contracts/tree/master/contracts/token) | 150,000+ (over $30 trillion in total value transferred!) | ERC-20, ERC-721, ERC-1155, ERC-4626, ERC-6909 | [Circle USDC](https://etherscan.io/address/0x43506849d7c04f9138d1a2050bbf3a0c054402dd#code#F17#L23), [Ondo OUSG](https://etherscan.io/address/0x1ceb44b6e515abf009e0ccb6ddafd723886cf3ff#code#F12#L2), [Lido](https://github.com/lidofinance/core/blob/005b0876d6594b7f7864e0577cdaa44eff115b73/contracts/0.8.9/WithdrawalVault.sol#L9) |
112+
| Utilities | Improve security, work with new data types, or safely use low-level primitives | [EVM](https://github.com/OpenZeppelin/openzeppelin-contracts/tree/master/contracts/utils), [Stellar](https://github.com/OpenZeppelin/stellar-contracts/tree/main/packages/contract-utils), [Starknet](https://github.com/OpenZeppelin/cairo-contracts/tree/main/packages/utils), [Arbitrum Stylus](https://github.com/OpenZeppelin/rust-contracts-stylus/tree/main/contracts/src/utils), [Midnight](https://github.com/OpenZeppelin/compact-contracts/tree/main/contracts/src/utils), [Zama](https://github.com/OpenZeppelin/openzeppelin-confidential-contracts/tree/master/contracts/utils), [Uniswap Hooks](https://github.com/OpenZeppelin/uniswap-hooks/tree/master/src/utils) | 150,000+ | Cryptography, math, data integrity | [Ethena USDe](https://etherscan.io/token/0x4c9edd5852cd905f086c759e8383e09bff1e68b3#code#F19#L2), [Pallas Fund USDtb](https://etherscan.io/address/0xea8a763b5b1f9c9c7aea64f33947448d9e39e475#code#F14#L2), [Graph Protocol](https://github.com/graphprotocol/contracts/blob/109e84c71fd01f2cb51f8582bb43603881380072/packages/horizon/contracts/utilities/Authorizable.sol#L6) |
113+
| Access Control | Managing who can perform specific actions, when they can do so, and under what authority | [EVM](https://github.com/OpenZeppelin/openzeppelin-contracts/tree/master/contracts/access), [Stellar](https://github.com/OpenZeppelin/stellar-contracts/tree/main/packages/access), [Starknet](https://github.com/OpenZeppelin/cairo-contracts/tree/main/packages/access), [Arbitrum Stylus](https://github.com/OpenZeppelin/rust-contracts-stylus/tree/main/contracts/src/access), [Midnight](https://github.com/OpenZeppelin/compact-contracts/tree/main/contracts/src/access) | 115,000+ | Access Control, Ownable | [Lido](https://github.com/lidofinance/core/blob/master/contracts/0.8.9/utils/access/AccessControlEnumerable.sol#L5), [Circle USDC](https://etherscan.io/address/0x43506849d7c04f9138d1a2050bbf3a0c054402dd#code#F13#L31), [BlockRock BUIDL-I](https://etherscan.io/address/0x9e2693f54831f6f52b0bb952c2935d26919a3626#code#F2#L2) |
114+
| **Proxies & Upgradability** | Secure contract upgrades without disrupting state | [EVM](https://github.com/OpenZeppelin/openzeppelin-contracts/tree/master/contracts/proxy), [Starknet](https://github.com/OpenZeppelin/cairo-contracts/tree/main/packages/upgrades), [Arbitrum Stylus](https://github.com/OpenZeppelin/rust-contracts-stylus/tree/main/contracts/src/proxy) | 75,000+ | Transparent Proxy, UUPS Proxy, Beacon Proxy | [Lido](https://github.com/lidofinance/core/blob/master/contracts/0.8.4/WithdrawalsManagerProxy.sol#L317), [Sky USDS](https://etherscan.io/address/0x1923dfee706a8e78157416c29cbccfde7cdf4102#code#F2#L2), [BlackRock BUIDL-I](https://etherscan.io/token/0x6a9da2d710bb9b700acde7cb81f10f1ff8c89041#code#F4#L2) |
115+
| Governance | Decentralized decision-making and controlled execution | [EVM](https://github.com/OpenZeppelin/openzeppelin-contracts/tree/master/contracts/governance), [Starknet](https://github.com/OpenZeppelin/cairo-contracts/tree/main/packages/governance), [Zama](https://github.com/OpenZeppelin/openzeppelin-confidential-contracts/tree/master/contracts/governance). | 1,000+ | Governor | [Arbitrum DAO](https://github.com/ArbitrumFoundation/governance/blob/main/src/L2ArbitrumGovernor.sol) |
116+
117+
## What’s Next?
118+
119+
Learn more about the [future of OpenZeppelin Contracts](/impact/the-future-of-openzeppelin-contracts).

‎content/impact/advancing-security-standards-at-openzeppelin.mdx‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
title: Advancing Security Standards at OpenZeppelin
3+
---
4+
5+
OpenZeppelin actively works with established standards bodies around the globe to ensure that blockchain security best practices are universally adopted.
6+
7+
# Our Contributions
8+
9+
## Internet Engineering Task Force (IETF)
10+
11+
Develops open internet standards like TCP/IP
12+
13+
### Global ZK Standards
14+
15+
OpenZeppelin is auditing and submitting Fiat-Shamir with hash functions in duplex sponge modes for submission.
16+
17+
## International Organization for Standardization (ISO)
18+
19+
Creates global standards like ISO/TC 307 for distributed ledger technologies
20+
21+
### ISO 25126
22+
23+
OpenZeppelin is submitting contributions to upcoming standard on [information security controls based on ISO/IEC 27002 for distributed ledger services](https://www.iso.org/standard/89024.html).
24+
25+
## Enterprise Ethereum Alliance (EEA) EthTrust Security Levels Working Group
26+
27+
Solving the problem of trust in Ethereum transactions to support enterprise blockchain adoption
28+
29+
### EthTrust Certification
30+
31+
OpenZeppelin is a contributor to the requirements for [a set of certifications that a smart contract has been reviewed and found not to have a defined set of security vulnerabilities](https://entethalliance.org/specs/ethtrust-sl/v2/).
32+
33+
# Learn More
34+
35+
Connect with OpenZeppelin experts to discuss your security needs.
36+
37+
[Talk to an Expert](https://www.openzeppelin.com/request)

‎content/impact/chain-abstraction-at-openzeppelin.mdx‎

Lines changed: 172 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,172 @@
1+
---
2+
title: Chain Abstraction at OpenZeppelin
3+
---
4+
5+
OpenZeppelin is enabling seamless interoperability across chains and account systems. Our work focuses on building the secure primitives for cross-chain messaging, intent-based execution, and unified account experiences, creating a world where users and assets move freely across ecosystems with complexity abstracted away from users.
6+
7+
# Ecosystem Contributions
8+
9+
We have partnered with ecosystems and projects to deliver contracts libraries and tooling for cross-chain coordination and smart accounts.
10+
11+
<Cards>
12+
<Card title="Open Intents Framework" href="https://github.com/openintentsframework">
13+
Contracts libraries and solvers for cross-chain intents
14+
</Card>
15+
16+
<Card title="Axelar" href="https://github.com/OpenZeppelin/openzeppelin-contracts/tree/master/contracts/crosschain">
17+
Contracts libraries for cross-chain messaging
18+
</Card>
19+
20+
<Card title="EVM" href="https://github.com/OpenZeppelin/openzeppelin-contracts/tree/master/contracts/account">
21+
Contracts libraries for smart accounts
22+
</Card>
23+
24+
<Card title="zkEmail" href="https://github.com/OpenZeppelin/openzeppelin-community-contracts/tree/master/contracts/utils/cryptography">
25+
Cryptography contracts libraries for transactions and social recovery using email
26+
</Card>
27+
28+
<Card title="Stellar" href="https://github.com/OpenZeppelin/stellar-contracts/tree/main/packages/accounts">
29+
Contracts libraries for smart accounts
30+
</Card>
31+
32+
<Card title="Starknet" href="https://github.com/OpenZeppelin/cairo-contracts/tree/main/packages/account">
33+
Contracts libraries for smart accounts
34+
</Card>
35+
</Cards>
36+
<br/>
37+
38+
# Cross-Chain Intents
39+
40+
Universal format for expressing and fulfilling user actions across chains.
41+
42+
## Use Cases
43+
44+
### Simplified Onboarding to Chains and Apps
45+
46+
Onboard users by automating gas, approvals, and cross chain setup, allowing users to interact with any app or network instantly without prior configuration.
47+
48+
### Abstracted Gas and Settlement
49+
50+
Allows operation across multiple chains without managing native gas tokens or complex bridge flows.
51+
52+
### Token Bridging and Swapping
53+
54+
Enable seamless asset transfers and swaps across chains, abstracting away bridge risks and fragmented liquidity.
55+
56+
### Universal Balances
57+
58+
Users can maintain a single cross chain balance, allowing applications to fetch, display, and transact from unified liquidity sources.
59+
60+
## Standards
61+
62+
### ERC-7683: Cross Chain Intents (draft)
63+
64+
A [standard](https://eips.ethereum.org/EIPS/eip-7683) that enables cross chain value transfer using a standard api.
65+
66+
OpenZeppelin is a contributor to and leading the redesign of the ERC through the [Open Intents Framework](https://www.openintents.xyz/The-Open-Intents-Framework-Intents-As-A-Public-Good-1976d35200d680fb8215f28775e067ec) and is building contracts libraries in the [Open Intents Framework Contracts Repo](https://github.com/openintentsframework/oif-contracts).
67+
68+
### ERC-7888: Cross Chain Broadcaster (draft)
69+
70+
A [standard](https://eips.ethereum.org/EIPS/eip-7888) that enables cross chain messaging using storage proofs.
71+
72+
OpenZeppelin is a contributor to the ERC through the [Open Intents Framework](https://www.openintents.xyz/The-Open-Intents-Framework-Intents-As-A-Public-Good-1976d35200d680fb8215f28775e067ec) and is building contracts libraries in the [Open Intents Framework Broadcaster Repo](https://github.com/openintentsframework/broadcaster).
73+
74+
## Associations
75+
76+
### Open Intents Framework
77+
78+
The [group](https://www.openintents.xyz/) is building a modular, open source framework for building and deploying intent product experiences by providing ready-to-use, protocol-agnostic features for solvers, interop providers, and cross-chain builders.
79+
80+
OpenZeppelin is a [member](https://www.openintents.xyz/#1976d35200d68051bfe5f0bdb3ced9bc) with many major organizations.
81+
82+
# Cross-Chain Messaging
83+
84+
Common interface for sending and receiving messages across chains.
85+
86+
## Use Cases
87+
88+
### State Synchronization for Multi-Chain Apps
89+
90+
Use single controller contract or governance action to coordinate updates on multiple chains.
91+
92+
### Token Bridges
93+
94+
Enables verifiable message passing between bridge contracts, ensuring consistent state and transfer logic across multiple chains without relying on trusted intermediaries.
95+
96+
### Intent Settlement
97+
98+
Facilitates secure delivery and confirmation of intent execution results across chains, allowing applications to finalize actions and synchronize states.
99+
100+
## Standards
101+
102+
### ERC-7786: Cross Chain Messaging Gateway (last call)
103+
104+
A [standard](https://eips.ethereum.org/EIPS/eip-7786) that enables cross-chain messaging via a universal gateway interface.
105+
106+
OpenZeppelin co-authored the standard with Axelar and is building contracts libraries in the [OpenZeppelin Community Contracts Repo](https://github.com/OpenZeppelin/openzeppelin-community-contracts/tree/master/contracts/crosschain).
107+
108+
# Smart Accounts
109+
110+
Composable architecture that enables customizable modules to support secure and extensible account functionality.
111+
112+
## Use Cases
113+
114+
### Gasless Transactions
115+
116+
Allow users to interact with apps without holding native tokens, enabling seamless onboarding.
117+
118+
### Social Recovery
119+
120+
Allow trusted guardians to securely restore access to accounts without centralized intermediaries.
121+
122+
### Keyless Signatures
123+
124+
Authenticate and approve transactions using biometrics, hardware modules, or passkeys instead of a traditional private key.
125+
126+
## Standards
127+
128+
### **ERC-4337: Account Abstraction Using Alt Mempool (final)**
129+
130+
A [standard](https://eips.ethereum.org/EIPS/eip-4337) that enables account abstraction using an alternative mempool.
131+
132+
OpenZeppelin has built contracts libraries for modular smart accounts in the [OpenZeppelin Contracts Repo](https://github.com/OpenZeppelin/openzeppelin-contracts/tree/master/contracts/account) and [Wizard](https://wizard.openzeppelin.com/#account) integration.
133+
134+
### ERC-7579: Minimal Modular Smart Accounts (draft)
135+
136+
A [standard](https://eips.ethereum.org/EIPS/eip-7579) that enables interoperability between accounts and modules.
137+
138+
OpenZeppelin has built contracts libraries for modules in the [OpenZeppelin Community Contracts Repo](https://github.com/OpenZeppelin/openzeppelin-community-contracts/tree/master/contracts/account/modules) and [Wizard](https://wizard.openzeppelin.com/#account) integration.
139+
140+
### EIP-7702: Set Code for EOAs (complete)
141+
142+
A [protocol standard](https://eips.ethereum.org/EIPS/eip-7702) that enables EOA’s to adopt smart contract capabilities using a new transaction type to set code in their account.
143+
144+
OpenZeppelin has built contracts libraries for modules in the [OpenZeppelin Community Contracts Repo](https://github.com/OpenZeppelin/openzeppelin-community-contracts/tree/master/contracts/account/modules) and [Wizard](https://wizard.openzeppelin.com/#account) integration.
145+
146+
### ERC-7913: Signature Verifiers (draft)
147+
148+
A [standard](https://eips.ethereum.org/EIPS/eip-7913) that enables signature verification for address-less keys (e.g. email, non-ethereum cryptographic curves).
149+
150+
OpenZeppelin authored the standard and is building contracts libraries in the [OpenZeppelin Contracts Repo](https://github.com/OpenZeppelin/openzeppelin-contracts/tree/master/contracts/utils/cryptography/verifiers).
151+
152+
# zkEmail
153+
154+
Ownership of accounts using email.
155+
156+
## Use Cases
157+
158+
### Sign Transactions Using Email
159+
160+
Users can authorize transactions (e.g. send money, DAO voting, any blockchain transaction) by proving control of their email address with no private key management required. Email never revealed!
161+
162+
### Social Recovery Using Email
163+
164+
Lost keys can be restored by proving control of an email account, enabling user-friendly recovery.
165+
166+
## Standards
167+
168+
### **ERC-7969: DomainKeys Identified Mail (DKIM) Registry (draft)**
169+
170+
A [standard](https://eips.ethereum.org/EIPS/eip-7969) that enables trustless email ownership verification using a DKIM restistry.
171+
172+
OpenZeppelin co-authored with zkEmail and is building contracts libraries in the [OpenZeppelin Community Contracts Repo](https://github.com/OpenZeppelin/openzeppelin-community-contracts/blob/master/contracts/utils/cryptography/DKIMRegistry.sol).

0 commit comments

Comments
 (0)