Join our Newsletter — 33% off our NHI Course
Home› Glossary› Architecture & Implementation› Proxy Contract
Architecture & Implementation

Proxy Contract

← Back to Glossary
By NHI Mgmt Group Updated October 29, 2026 Domain: Architecture & Implementation

Proxy contract is a smart contract that forwards calls to another contract while keeping a separate address and often separate storage. It is used to upgrade contract logic or share behaviour without moving user-facing state, so the proxy and implementation must be managed carefully to avoid storage collisions and control weaknesses.

What a proxy contract is

A proxy contract is a forwarding layer, not the business logic itself. It sits at a stable address, relays calls to an implementation contract, and often preserves user-facing state so the logic can be upgraded without forcing users to move funds or re-register.

Why proxy contracts are used

Proxy patterns exist to separate interface continuity from logic evolution. Teams use them when they need to patch bugs, add features, or replace modules while keeping the same on-chain entry point, which is especially useful when external integrations already depend on that address.

That convenience comes with design trade-offs. The proxy and implementation must agree on storage layout, initialisation rules, and upgrade authority, because the proxy is only safe if the delegated logic behaves exactly as expected when executed against the proxy’s storage.

How proxy contracts work

Most proxy systems rely on delegated execution: the proxy receives the call, forwards it to the implementation, and then the implementation reads and writes the proxy’s storage context. The result is that the user experiences one contract address, while the code behind it can change over time.

This model preserves continuity, but it also means the apparent separation between “address” and “logic” is subtle. A change in implementation can alter funds handling, access checks, event emission, or upgrade routines without changing the outward address that users and integrators see.

Security implications of upgradeable contract design

The main security concern is that upgradeability expands the trusted control surface. If upgrade keys, admin functions, or initialisation steps are weakly governed, an attacker or insider can redirect calls to malicious logic, corrupt stored data, or block normal operation.

Storage collisions are another core hazard: if the new implementation assumes a different storage layout, values can be overwritten or misread, producing loss of control, broken accounting, or unintended privilege changes. For that reason, proxy designs must be treated as a governance and state-integrity problem, not just a coding pattern.

Risk and Threat Considerations

Proxy contracts concentrate risk in the upgrade path and the shared storage boundary. A flaw in the proxy pattern can turn a routine code upgrade into a full compromise of state, permissions, or asset movement, especially when the implementation address or upgrade authority is poorly protected.

Failure mechanism: An attacker exploits weak upgrade controls, initialisation mistakes, or storage-layout mismatch to alter contract behaviour while preserving the same user-facing address.

Impact: The result can be malicious code execution through the proxy, incorrect state reads or writes, broken access control, loss of funds, or an unrecoverable contract migration problem.

Standards & Framework Alignment

This section maps relevant standards and security frameworks to the operational risks and controls described in this guidance.

NIST SP 800-53 Rev 5 and CIS Controls v8 set the governance and control requirements practitioners need to meet.

FrameworkControl / ReferenceRelevance
NIST SP 800-53 Rev 5AC-6 — Least PrivilegeProxy upgrade authority is a privileged access path that needs tight limitation.
CM-3 — Configuration Change ControlProxy upgrades are controlled code and state changes that must be reviewed and authorised.
SI-7 — Software, Firmware, and Information IntegrityProxy integrity depends on preventing unauthorised or altered implementation code.
Recommendation — Restrict upgrade and admin permissions to the smallest necessary set of trusted operators. Require formal approval and testing before changing proxy or implementation logic. Verify deployed implementation integrity before and after every upgrade.
CIS Controls v8CIS-4 — Secure Configuration of Enterprise Assets and SoftwareProxy deployments depend on hardened, consistently configured contract and key-management settings.
CIS-5 — Account ManagementProxy administration relies on tightly managed accounts that can change logic or ownership.
Recommendation — Harden proxy deployment settings and preserve a known-good configuration baseline. Limit and review accounts that can initialise, own, or upgrade proxy contracts.

Practitioner Guidance

Governance implication: Treat proxy administration as a high-value control point. Separate upgrade authority from routine application operation, document the storage layout contract between versions, and make initialisation steps explicit so the implementation cannot be safely deployed in an uninitialised or ambiguous state.

What to watch for: Review any proxy-based deployment for unexpected delegatecall behaviour, hidden admin functions, and implementation changes that alter state variables, ownership logic, or upgrade slots. In practice, the safest proxy is the one whose upgrade and storage assumptions are boring, explicit, and tightly controlled.

Free weekly newsletter

Subscribe to the NHI & AI Identity Journal

The latest on NHI and Agentic AI security – articles, research, breaches, news and events every week.

Bonus 33% off our NHI Course when you subscribe.

NHIMG Editorial Note
Reviewed and updated by the NHIMG editorial team on October 29, 2026.
NHI Mgmt Group — the #1 independent authority on Non-Human Identity, IAM, and Agentic AI security. nhimg.org