Skip to content
Merged
17 changes: 8 additions & 9 deletions src/pages/docs/guide/node/network-upgrades.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,8 @@ For detailed release notes and binaries, see the [Changelog](/docs/changelog).

| Release | Date | Network | Description | Priority |
|---------|------|---------|-------------|----------|
| v1.10.0 (planned) | Planned: Jun 25, 2026 | Testnet + Mainnet | Required for T7; expected to include gas credits for expiring work, dynamic base fee behavior, and removal of TIP-20 rewards. Release notes and binaries will be linked once published. | <Badge variant="red">Required</Badge> |
| v1.9.1 (planned) | Planned: Jun 18, 2026 | Testnet + Mainnet | Planned patch release. Release notes and binaries will be linked once the draft is published. | TBD |
| v1.10.0 (planned) | Planned: Jun 29, 2026 | Testnet + Mainnet | Required for T7; includes storage credits for DEX order storage and TIP-20 channel storage, dynamic base fee behavior, and TIP-20 rewards deprecation. Release notes and binaries will be linked once published. | <Badge variant="red">Required</Badge> |
| [v1.9.1](https://github.com/tempoxyz/tempo/releases/tag/v1.9.1) | Jun 19, 2026 | Testnet + Mainnet | Patch release with follow-mode stability fixes, payload-builder latency fixes, Reth/Rust dependency updates, and transaction-pool/RPC improvements. | <Badge variant="yellow">Recommended</Badge> |
| [v1.9.0](https://github.com/tempoxyz/tempo/releases/tag/v1.9.0) | Jun 15, 2026 | Testnet + Mainnet | Required for T6; adds account-level receive policies for safer TIP-20 deposits and admin access keys for smoother passkey, device, and delegated-key management. Operators were required to run this release before the T6 activation timestamp on each network. | <Badge variant="red">Required</Badge> |
| [v1.8.2](https://github.com/tempoxyz/tempo/releases/tag/v1.8.2) | Jun 8, 2026 | Testnet + Mainnet | High-priority patch release that fixes a `--minimal` node issue when requesting historical blocks through the commonware marshal interface. | <Badge variant="yellow">Recommended</Badge> |
| [v1.8.1](https://github.com/tempoxyz/tempo/releases/tag/v1.8.1) | Jun 1, 2026 | Testnet + Mainnet | Required for T5; reverts builder prewarming and execution cache sharing defaults from v1.8.0 to avoid stale-state validation errors while retaining T5 compatibility. | <Badge variant="red">Required</Badge> |
Expand All @@ -39,16 +39,15 @@ For detailed release notes and binaries, see the [Changelog](/docs/changelog).

| | |
|---|---|
| **Scope** | Lower fees for work that is expected to expire; lower the base fee when gas is below the target threshold; remove TIP-20 rewards |
| **TIPs** | [TIP-1060: Gas Credits Primitive](https://tips.sh/1060), [TIP-1064: Gas Credits for DEX](https://tips.sh/1064), [TIP-1066: Gas Credits for MPP](https://tips.sh/1066), [TIP-1067: Dynamic Base Fee](https://tips.sh/1067-1), [TIP-1075: Remove TIP-20 Rewards](https://github.com/tempoxyz/tempo/pull/5380) |
| **Scope** | Storage credits for DEX order storage and TIP-20 channel storage; lower the base fee when gas is below the target threshold; deprecate new TIP-20 rewards |
| **TIPs** | [TIP-1060: Storage Credits](https://tips.sh/1060), [TIP-1064: StablecoinDEX Order Storage Credits](https://tips.sh/1064), [TIP-1066: TIP-20 Channel Storage Credits](https://tips.sh/1066), [TIP-1067: Dynamic Base Fee](https://tips.sh/1067-1), [TIP-1075: Deprecate TIP-20 Rewards](https://github.com/tempoxyz/tempo/pull/5380) |
| **Details** | [T7 network upgrade](/docs/protocol/upgrades/t7) |
| **Release** | v1.10.0 (planned) |
| **Release date** | Planned: June 25, 2026 |
| **Testnet** | Planned: June 30, 2026 |
| **Mainnet** | Planned: July 6, 2026 |
| **Release** | v1.10.0 (planned for June 29, 2026) |
| **Testnet** | Planned: July 2, 2026 |
| **Mainnet** | Planned: July 9, 2026 |
| **Priority** | <Badge variant="red">Required</Badge> |

T7 is planned for v1.10.0, with release publication planned for June 25, 2026. Release notes, binaries, and detailed node operator guidance will be linked when v1.10.0 is available.
T7 is planned for v1.10.0, with release publication planned for June 29, 2026. Release notes, binaries, and detailed node operator guidance will be linked when v1.10.0 is available.

---

Expand Down
76 changes: 60 additions & 16 deletions src/pages/docs/protocol/upgrades/t7.mdx
Original file line number Diff line number Diff line change
@@ -1,46 +1,90 @@
---
title: T7 Network Upgrade
description: Planned overview for the T7 network upgrade, including gas credits, dynamic base fee behavior, and removal of TIP-20 rewards.
description: Partner-focused overview and rollout dates for the T7 network upgrade, including storage credits, dynamic base fee behavior, and TIP-20 rewards deprecation.
---

# T7 Network Upgrade

T7 is a planned network upgrade focused on lowering fees for work that is expected to expire, lowering the base fee when gas usage is below the target threshold, and removing TIP-20 rewards.
T7 gives partners a clearer fee model for high-volume payment and exchange flows. It adds storage credits for reusable DEX order and TIP-20 channel state, makes the base fee move down when network usage is below the target threshold, and deprecates new TIP-20 rewards.

:::info[T7 status]
T7 is planned for v1.10.0, with release publication planned for June 25, 2026. The scope and rollout dates may change before activation.
T7 is planned for v1.10.0. Release publication is planned for June 29, 2026, testnet rollout is planned for July 2, 2026, and mainnet rollout is planned for July 9, 2026.
:::

## Timeline

| Milestone | Date |
|-----------|------|
| Release | Planned: June 25, 2026 |
| Testnet | Planned: June 30, 2026 |
| Mainnet | Planned: July 6, 2026 |
| Release publication | June 29, 2026 |
| Testnet rollout | July 2, 2026 |
| Mainnet rollout | July 9, 2026 |

Node operator upgrade guidance will be linked when v1.10.0 is available.
Node operator upgrade guidance will be linked when v1.10.0 is available. Operators should be ready to run the T7-compatible release before the activation timestamp on each network.

## Planned scope
## Overview

### Lower fees for things we know will expire
T7 focuses on three partner needs:

T7 plans to introduce gas credits for protocol surfaces where temporary work is expected to expire.
- **Lower fees for reusable protocol state.** Storage credits reduce fees when previously freed protocol storage can be reused, including DEX order storage and TIP-20 channel storage.
- **A more responsive base fee.** Dynamic base fee behavior lowers the base fee when gas usage is below the target threshold.
- **A simpler TIP-20 rewards model.** Deprecating new TIP-20 rewards simplifies reward-related accounting and user-facing balances.

These changes are designed to make costs easier to reason about for partners building high-throughput payment, liquidity, and exchange experiences. Storage credits and dynamic base fee behavior affect fee calculations, while existing TIP-20 transfer behavior and claims for already-accrued rewards continue to work.

## Features

### Storage credits for reusable protocol state

Storage credits lower fees for protocol surfaces where deleted storage can later be reused. This helps reduce the cost of flows where the network can account for reusable state separately from net-new long-lived state.

| TIP | Scope |
|-----|-------|
| [TIP-1060: Gas Credits Primitive](https://tips.sh/1060) | Core gas credits primitive |
| [TIP-1064: Gas Credits for DEX](https://tips.sh/1064) | Gas credits for DEX flows |
| [TIP-1066: Gas Credits for MPP](https://tips.sh/1066) | Gas credits for MPP flows; stretch goal |
| [TIP-1060: Storage Credits](https://tips.sh/1060) | Core storage credits primitive |
| [TIP-1064: StablecoinDEX Order Storage Credits](https://tips.sh/1064) | Storage credits for DEX order storage |
| [TIP-1066: TIP-20 Channel Storage Credits](https://tips.sh/1066) | Storage credits for TIP-20 channel state |

### Dynamic base fee

### Lowering the base fee when gas is below certain threshold
Dynamic base fee behavior lets the base fee move down when gas usage is below the target threshold. This gives wallets, apps, and infrastructure a fee model that can respond to lower network usage instead of assuming a fixed base fee.

| TIP | Scope |
|-----|-------|
| [TIP-1067: Dynamic Base Fee](https://tips.sh/1067-1) | Dynamic base fee behavior |

### Remove TIP-20 Rewards
### Deprecate TIP-20 rewards

T7 deprecates new TIP-20 reward opt-ins and reward distributions so partners do not need to model new reward accrual after the upgrade. Already-accrued rewards remain claimable, so historical rewards data should remain separate from post-T7 payment and balance reporting.

| TIP | Scope |
|-----|-------|
| [TIP-1075: Remove TIP-20 Rewards](https://github.com/tempoxyz/tempo/pull/5380) | Remove TIP-20 rewards |
| [TIP-1075: Deprecate TIP-20 Rewards](https://github.com/tempoxyz/tempo/pull/5380) | Deprecate new TIP-20 rewards and preserve claims for already-accrued rewards |

## Compatible releases

The following release is planned to support the T7 feature set:

| Ecosystem | T7-compatible releases |
|-----------|------------------------|
| Node operators | `v1.10.0` (planned for June 29, 2026) |

Release notes, binaries, and package versions will be linked when v1.10.0 is available.

## What operators and integrators should know

T7 changes fee and reward behavior. Node operators, integrators, indexers, wallets, and partner infrastructure should review the notes below before testnet and mainnet rollout.

### For storage credits

Partners using DEX or TIP-20 channel flows should review fee assumptions once the T7-compatible release is available.

- Storage credits are included for the core primitive, DEX order storage, and TIP-20 channel storage.
- Wallets and apps that estimate fees should validate their fee displays against T7 behavior on testnet.
- Indexers and analytics systems should keep pre-T7 fee assumptions separate from post-T7 fee data.

### For TIP-20 rewards deprecation

Apps that show TIP-20 reward information should stop presenting new rewards as accruing from post-T7 reward distributions.

- Wallets and dashboards should separate already-accrued rewards from post-T7 balances.
- Accounting and reporting systems should check whether any reward-specific assumptions remain.
- Partner support teams should be ready to explain that TIP-20 transfers and claims for already-accrued rewards continue to work, while new reward opt-ins and distributions are deprecated.
Loading