Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,248 @@
# Ironwood Migration: Securing the Future of Zcash

## Introduction

Blockchain networks are constantly evolving. As new technologies emerge and vulnerabilities are discovered, decentralized systems must adapt to remain secure, reliable, and trustworthy. Network upgrades are a fundamental part of this process, allowing protocols to improve without compromising their core principles.

Zcash has a long history of implementing carefully coordinated network upgrades to strengthen privacy, scalability, and security. The Ironwood migration (Network Upgrade 6.3) represents one of the most significant upgrades in the project's history because it directly addresses the integrity and verifiability of Zcash's circulating supply while preserving the privacy guarantees that users expect.

Ironwood is more than a routine software update. It is a coordinated effort involving developers, node operators, wallet providers, exchanges, and infrastructure teams across the Zcash ecosystem. Its successful deployment demonstrates the resilience of decentralized communities and their ability to respond transparently to complex technical challenges.

---

## What is Ironwood?

Ironwood is the codename for Zcash's Network Upgrade 6.3 (NU6.3), introducing a new shielded pool designed to restore publicly verifiable assurances about Zcash's circulating supply while maintaining the network's privacy properties.

### Background and Motivation

In May 2026, developers discovered a critical vulnerability affecting Orchard, Zcash's primary shielded pool. While there is no evidence that the issue was exploited, Orchard's privacy-preserving design made it impossible for users to independently verify whether counterfeit ZEC had ever been created. An emergency network upgrade mitigated the immediate risk, but the incident highlighted an important principle:

> "Users should not have to trust anyone not developers, organizations, or auditors when it comes to the integrity of a cryptocurrency's supply."

Ironwood was proposed to strengthen these assurances. The upgrade introduces a new shielded pool built upon Orchard's technology, alongside additional independent audits, improved accounting mechanisms, and ongoing formal verification efforts for critical components.

### Ironwood in the Zcash Roadmap

Ironwood fits into Zcash's broader strategy of continuous protocol improvement. It arrives alongside ecosystem-wide modernization efforts, including the transition away from the legacy `zcashd` software toward the new Z3 stack:

- **Zebra** — Node implementation
- **Zaino** — Data services
- **Zallet** — Wallet infrastructure

Together, these initiatives aim to improve maintainability, performance, and long-term sustainability across the network.

---

## Why the Ironwood Migration Matters

Ironwood addresses several critical challenges, including:

### Addressing Supply Integrity

Cryptocurrencies derive value from predictable and enforceable monetary policies. Zcash's fixed maximum supply of **21 million ZEC** is a foundational property of the network.

Ironwood is designed to strengthen independent assurances around that fixed supply while preserving the network's privacy guarantees.

A key component of Ironwood is the introduction of an accounting checkpoint, commonly referred to as a **"turnstile."** As funds move from Orchard into Ironwood, the ecosystem can observe whether the amount exiting Orchard is consistent with the amount entering the new pool. This mechanism strengthens confidence in Zcash's monetary integrity without revealing transaction details.

### Improving Network Resilience

The migration demonstrates that Zcash can:

- Detect vulnerabilities responsibly.
- Coordinate emergency responses.
- Implement long-term solutions.
- Preserve privacy while improving transparency.

This ability to adapt is essential for any decentralized system seeking longevity.

### Strengthening Ecosystem Coordination

Ironwood has brought together multiple organizations across the ecosystem, including:

- Zcash Foundation
- Shielded Labs
- ZODL
- Project Tachyon
- Valar Group

The upgrade highlights the collaborative nature of Zcash governance and development.

---

## Strengthening Trust in Zcash

Trust in blockchain systems should be rooted in verifiability rather than assumptions. Ironwood advances this principle in several ways.

### Security Improvements

Ironwood introduces:

- A new shielded pool based on Orchard's technology.
- Additional independent audits.
- Ongoing formal verification efforts for critical cryptographic components.
- Consensus rule updates designed to prevent recurrence of the Orchard vulnerability class.

> Formal verification uses mathematical techniques to prove that software behaves as intended, providing stronger assurances than traditional testing alone.

### Reliability Enhancements

By restricting new transfers into the Orchard pool and directing future shielded activity toward Ironwood, the network reduces complexity and improves operational confidence for ecosystem participants.

Existing Orchard funds remain accessible and are expected to migrate over time through the ecosystem's transition process.

### Privacy and Protocol Integrity

Importantly, Ironwood does **not** require users to sacrifice privacy.

Zcash continues to use zero-knowledge proofs (zk-SNARKs), enabling transactions to remain private while preserving the ability to verify that the system obeys its monetary rules.

Ironwood demonstrates that privacy and accountability can coexist.

### Community Confidence

Every successful network upgrade reinforces confidence in the ecosystem. Ironwood signals that:

- Security issues are taken seriously.
- Development remains active.
- Infrastructure providers are aligned.
- The network can evolve responsibly.

For users and contributors alike, this confidence is essential for long-term adoption.

---

## Impact on the Ecosystem

Ironwood affects nearly every participant in the Zcash ecosystem.

### Wallet Users

Most users will experience the migration through wallet updates. Depending on their wallet provider's implementation, users may be offered automated migration tools or prompted to move assets into the new shielded pool.

For many users, the transition will be seamless.

### Node Operators

Node operators must ensure they are running Ironwood-compatible software before activation. Nodes that are not upgraded risk falling out of consensus with the network.

### Exchanges

Exchanges are responsible for:

- Updating infrastructure.
- Testing deposits and withdrawals.
- Monitoring activation timelines.
- Coordinating maintenance windows if necessary.

Exchange readiness is a key component of a successful migration.

### Infrastructure Providers

Service providers including block explorers, APIs, and hosted node operators must update their systems to support Ironwood and the broader Z3 software ecosystem.

### Developers

Application developers should:

- Test against Ironwood-compatible environments.
- Review updated APIs.
- Validate transaction handling.
- Ensure compatibility with new consensus rules.

Ironwood also presents opportunities for contributors interested in protocol engineering, wallet development, and ecosystem tooling.

---

## Migration Process

### What to Expect

The migration follows the standard Zcash network upgrade process:

1. Development and implementation.
2. Testnet deployment.
3. Ecosystem testing.
4. Mainnet activation.
5. Post-activation monitoring.

Ironwood was activated on testnet before mainnet deployment, allowing teams to identify and resolve compatibility issues in advance.

### Required Actions

| Participant | Action Required |
|------------|----------------|
| Wallet Users | Update wallet software if prompted. |
| Node Operators | Upgrade to Ironwood-compatible releases. |
| Exchanges | Complete infrastructure testing and migration. |
| Developers | Test applications against NU6.3. |
| Infrastructure Providers | Verify compatibility with the Z3 ecosystem. |

### Best Practices

#### Before Migration

- Back up wallet data.
- Review official announcements.
- Verify software versions.
- Test systems in staging environments.

#### During Migration

- Monitor network status.
- Follow guidance from official Zcash channels.
- Pause non-essential maintenance activities.

#### After Migration

- Confirm successful synchronization.
- Verify transaction functionality.
- Monitor logs and network performance.
- Report unexpected issues promptly.

---

## Frequently Asked Questions

### Is Ironwood a hard fork?

Yes. Like previous Zcash network upgrades, Ironwood introduces new consensus rules that require ecosystem participants to upgrade their software.

### Will users lose their funds?

No. There is no indication that users will lose funds as a result of the migration. Users should simply ensure they are using supported wallet software and follow any instructions provided by their wallet provider.

### Does Ironwood reduce privacy?

No. Ironwood maintains Zcash's privacy guarantees while improving confidence in the network's monetary integrity.

### Why was a new shielded pool necessary?

The new pool strengthens assurances around Zcash's monetary integrity through improved accounting mechanisms, additional audits, and ongoing formal verification efforts.

### Do I need to move my ZEC immediately?

Most users should follow instructions from their wallet provider. In many cases, the migration experience will be largely automated.

### Where can I learn more?

Useful resources include:

- Zcash Documentation
- Zcash Community Forum
- Zcash Foundation
- Shielded Labs
- *Ironwood: Verifying the Soundness of Zcash's Circulating Supply*

---

## Conclusion

Ironwood is one of the most consequential upgrades in Zcash's history. It demonstrates how privacy-focused networks can respond to challenges without compromising their core values.

By introducing a new shielded pool, strengthening supply assurances, supporting ongoing formal verification efforts, and coordinating ecosystem-wide migration efforts, Ironwood reinforces the principles that have guided Zcash since its inception: **privacy, security, and decentralization**.

Most importantly, Ironwood strengthens trust not by asking users to believe that everything is fine, but by giving them the tools to verify it themselves.

As Zcash continues to evolve, Ironwood will stand as an example of how decentralized communities can transform a difficult moment into an opportunity to build a stronger and more resilient future.