openzeppelin-contracts

Files

soham 0f55c18595 Fix/solc 0.7.4 warnings #2391 (#2396 )

* Fix unnamed return variable warning

This commit fixes warnings thrown by the solc 0.7.4 compiler:
"Warning: Unnamed return variable can remain unassigned. Add an explicit
return with value to all non-reverting code paths or name the variable."

* Fix function state mutability warning

This commit fixes warnings thrown by the solc 0.7.4 compiler:
"Warning: Function state mutability can be restricted to pure"

* Fix shadows an existing declaration warning

This commit fixes warnings thrown by the solc 0.7.4 compiler:
"Warning: This declaration shadows an existing declaration."

1. Arguments by default are not underscored.
2. If the name isn't available due to shadowing, use prefix underscore.
3. If prefix underscore isn't available due to shadowing, use suffix underscore.

2020-10-28 13:42:38 -03:00

Initializable.sol

Bump solhint to 3.2.0

2020-09-10 20:39:26 -03:00

Proxy.sol

update new contracts for solidity 0.7

2020-09-08 20:15:43 -03:00

ProxyAdmin.sol

update new contracts for solidity 0.7

2020-09-08 20:15:43 -03:00

README.adoc

Add documentation for proxies (#2344 )

2020-09-02 20:19:54 -03:00

TransparentUpgradeableProxy.sol

Fix/solc 0.7.4 warnings #2391 (#2396 )

2020-10-28 13:42:38 -03:00

UpgradeableProxy.sol

update new contracts for solidity 0.7

2020-09-08 20:15:43 -03:00

README.adoc

= Proxies

[.readme-notice]
NOTE: This document is better viewed at https://docs.openzeppelin.com/contracts/api/proxy

This is a low-level set of contracts implementing the proxy pattern for upgradeability. For an in-depth overview of this pattern check out the xref:upgrades-plugins::proxies.adoc[Proxy Upgrade Pattern] page.

The abstract {Proxy} contract implements the core delegation functionality. If the concrete proxies that we provide below are not suitable, we encourage building on top of this base contract since it contains an assembly block that may be hard to get right.

Upgradeability is implemented in the {UpgradeableProxy} contract, although it provides only an internal upgrade interface. For an upgrade interface exposed externally to an admin, we provide {TransparentUpgradeableProxy}. Both of these contracts use the storage slots specified in https://eips.ethereum.org/EIPS/eip-1967[EIP1967] to avoid clashes with the storage of the implementation contract behind the proxy.

CAUTION: Using upgradeable proxies correctly and securely is a difficult task that requires deep knowledge of the proxy pattern, Solidity, and the EVM. Unless you want a lot of low level control, we recommend using the xref:upgrades-plugins::index.adoc[OpenZeppelin Upgrades Plugins] for Truffle and Buidler.

== Core

{{Proxy}}

{{UpgradeableProxy}}

{{TransparentUpgradeableProxy}}

== Utilities

{{Initializable}}

{{ProxyAdmin}}