Skip to content

docs: add T5 network upgrade page + T4 → T5 migration appendices#405

Merged
max-digi merged 19 commits into
mainfrom
docs/t5-network-upgrade
May 15, 2026
Merged

docs: add T5 network upgrade page + T4 → T5 migration appendices#405
max-digi merged 19 commits into
mainfrom
docs/t5-network-upgrade

Conversation

@max-digi
Copy link
Copy Markdown
Contributor

@max-digi max-digi commented May 13, 2026 •
edited
Loading

Adds the public-facing T5 network upgrade page following the structure of the existing T3/T4 pages, plus "Coming with T5" callouts and migration appendices on affected existing pages so users get the heads-up before activation.

What's included

New: src/pages/protocol/upgrades/t5.mdx

  • Timeline (Moderato Jun 3, Presto Jun 9 — activation timestamps marked TBD until activated)
  • Overview of the TIPs in scope
  • Integration changes section calling out behaviors that integrators, indexers, and tooling should pick up before activation. TIP-1034 escrow precompile is internal to MPP and has no external integration impact, so it's noted up-front and not given its own subsection.
  • Compatible SDK releases placeholder
  • Per-TIP feature summaries
  • All TIP links use tips.sh shortlinks

Sidebar: vocs.config.ts

  • T5 entry added above T4 (most-recent-on-top pattern)
  • T4 marked (Active) now that T4 has activated on Moderato

t4.mdx

  • "T4 is not live yet" callout removed (T4 has activated)

T4 → T5 migration appendix on src/pages/protocol/exchange/providing-liquidity.mdx

Following the T2 → T3 migration appendix pattern. The body of the page is unchanged (still describes pre-T5 behavior); appendix at the bottom flags upcoming changes:

  • TIP-1030 (same-tick flip orders): flipTick == tick allowed; downstream code asserting flipTick != tick will stop holding.
  • TIP-1056 (persistent order IDs across flips): same orderId reused across flips, new OrderFlipped event in place of OrderPlaced, nextOrderId no longer advances per flip. Indexer migration guidance included.

Coming with T5 callouts

Added on the affected DEX, FeeAMM, account-keychain, issuance, and tokenlist pages so readers see the heads-up in context. Each callout links to the relevant section of the T5 page.

Tokenlist (src/pages/quickstart/tokenlist.mdx)

  • "Coming with T5" callout describing the upcoming on-chain logoURI field, with a link to the T5 page
  • Migration appendix removed per Jen's review (token issuers don't need to take any action — logoURI is optional)

TIPs covered

  • TIP-1026 — Optional logoURI Field in TIP-20
  • TIP-1030 — Allow Same-Tick Flip Orders
  • TIP-1033 — Multihop FeeAMM Routing
  • TIP-1034 — Enshrined TIP-20 Escrow Channel (MPP-internal, no external integration impact)
  • TIP-1035 — Implicit Approvals List
  • TIP-1045 — Payment Lane Classification
  • TIP-1053 — Witness Digest in Key Authorizations
  • TIP-1056 — Keep Order IDs Across Flips

Release info

  • Node-operator release: v1.8.0 (targeted May 27, 2026)
  • Meta TIP: TIP-1057
  • Activation timestamps: TBD (page will be updated once timestamps are set)

Verification

  • pnpm install && pnpm run check runs clean (3 pre-existing warnings in scripts/lighthouse.ts, unrelated)
  • Anchor slugs #t4--t5-migration confirmed against github-slugger (matches the existing #t2--t3-migration convention)
  • TIP-1026 ABI signatures verified against tempoxyz/tempo tips/tip-1026.md

Review feedback addressed

All inline review comments from @jenpaff have been resolved in the latest commit:

  • Sidebar: T4 marked (Active)
  • t5.mdx: timestamps → TBD; TIP-1047 removed (overview, related docs, feature TIP); channel lifecycle paragraph removed; all TIP links switched to tips.sh; entire Related docs section removed
  • tokenlist.mdx: migration appendix removed (token issuers don't need to act; tooling extension flagged for follow-up with @0xrusowsky)

@vercel
Copy link
Copy Markdown

vercel Bot commented May 13, 2026 •
edited
Loading

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
tempo-docs Ready Ready Preview, Comment May 15, 2026 4:21pm

Request Review

@max-digi max-digi requested a review from jenpaff May 13, 2026 16:57
@max-digi max-digi mentioned this pull request May 13, 2026
Closed
@max-digi @ampcode-com
docs(t5): add T4 → T5 migration appendices to flip orders + tokenlist…
3a4217c 
…; drop TIP-1034 from external integration changes

Amp-Thread-ID: https://ampcode.com/threads/T-019e218f-4b73-7337-a0ca-d3921dc84735
Co-authored-by: Amp <amp@ampcode.com>
@max-digi max-digi changed the title docs: add T5 network upgrade page docs: add T5 network upgrade page + T4 → T5 migration appendices May 13, 2026
@max-digi @ampcode-com
docs(t5): split flip-order + tokenlist into 'Coming with T5' callouts…
3ecf4a3 
… (what changes) + action-items-only migration appendices (what to update)

Amp-Thread-ID: https://ampcode.com/threads/T-019e218f-4b73-7337-a0ca-d3921dc84735
Co-authored-by: Amp <amp@ampcode.com>
@max-digi @ampcode-com
docs(t5): add 'Coming with T5' callouts to canonical specs and develo…
3a06680 
…per guides (DEX, AccountKeychain, TIP-20, FeeAMM)

Amp-Thread-ID: https://ampcode.com/threads/T-019e218f-4b73-7337-a0ca-d3921dc84735
Co-authored-by: Amp <amp@ampcode.com>
jenpaff
jenpaff reviewed May 14, 2026
View reviewed changes
Comment thread vocs.config.ts
jenpaff
jenpaff reviewed May 15, 2026
View reviewed changes
Comment thread src/pages/quickstart/tokenlist.mdx Outdated
jenpaff
jenpaff reviewed May 15, 2026
View reviewed changes
Comment thread src/pages/quickstart/tokenlist.mdx Outdated
jenpaff
jenpaff reviewed May 15, 2026
View reviewed changes
Comment thread src/pages/protocol/upgrades/t5.mdx Outdated
jenpaff
jenpaff reviewed May 15, 2026
View reviewed changes
Comment thread src/pages/protocol/upgrades/t5.mdx Outdated
jenpaff
jenpaff reviewed May 15, 2026
View reviewed changes
Comment thread src/pages/protocol/upgrades/t5.mdx Outdated
jenpaff
jenpaff reviewed May 15, 2026
View reviewed changes
Comment thread src/pages/protocol/upgrades/t5.mdx Outdated
jenpaff
jenpaff reviewed May 15, 2026
View reviewed changes
Comment thread src/pages/protocol/upgrades/t5.mdx Outdated
@max-digi @ampcode-com
Address Jen's PR review comments
97f4e16 
- vocs.config.ts: mark T4 as Active in sidebar
- t4.mdx: remove 'not live yet' callout (T4 activated)
- t5.mdx: timestamps -> TBD; remove TIP-1047 (overview, related-docs,
  feature TIP); remove channel lifecycle paragraph; swap all GitHub
  TIP URLs to tips.sh shortlinks; remove Related docs section
- tokenlist.mdx: remove T4 -> T5 migration appendix; update
  Coming-with-T5 callout to point to T5 page
- create-a-stablecoin.mdx, manage-stablecoin.mdx: re-point dangling
  appendix links to T5 page; switch TIP-1026 link to tips.sh

Amp-Thread-ID: https://ampcode.com/threads/T-019e218f-4b73-7337-a0ca-d3921dc84735
Co-authored-by: Amp <amp@ampcode.com>
0xrusowsky
0xrusowsky reviewed May 15, 2026
View reviewed changes
Comment thread src/pages/protocol/exchange/index.mdx
0xrusowsky
0xrusowsky reviewed May 15, 2026
View reviewed changes
Comment thread src/pages/guide/stablecoin-dex/managing-fee-liquidity.mdx
@max-digi @ampcode-com
Clarify TIP-1034 MPP lib upgrade + add TIP-1033 issuer guidance
41ed35d 
- t5.mdx: add Integration changes subsection for TIP-1034 noting that
  the existing MPP escrow contract still works but MPP libs need new
  versions to use the precompile path; remove the now-inaccurate
  'no external integration impact' line.
- t5.mdx: extend TIP-1033 feature TIP block with issuer-facing
  guidance — pair against a single liquid quote (pathUSD) and let
  multihop routing handle validator payout tokens.
- guide/issuance/use-for-fees.mdx: add Coming with T5 callout above
  Add fee pool liquidity step pointing to the same simplification.

Amp-Thread-ID: https://ampcode.com/threads/T-019e218f-4b73-7337-a0ca-d3921dc84735
Co-authored-by: Amp <amp@ampcode.com>
malleshpai
malleshpai reviewed May 15, 2026
View reviewed changes
Comment thread src/pages/guide/stablecoin-dex/managing-fee-liquidity.mdx Outdated
0xrusowsky
0xrusowsky approved these changes May 15, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

@0xrusowsky 0xrusowsky left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, just some nits

Comment thread src/pages/protocol/upgrades/t5.mdx Outdated
Comment thread src/pages/protocol/upgrades/t5.mdx Outdated
0xrusowsky
0xrusowsky reviewed May 15, 2026
View reviewed changes
Comment thread vocs.config.ts Outdated
malleshpai
malleshpai reviewed May 15, 2026
View reviewed changes
Comment thread src/pages/guide/stablecoin-dex/view-the-orderbook.mdx Outdated
malleshpai
malleshpai approved these changes May 15, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

@malleshpai malleshpai left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

minor suggestions

joshitzko
joshitzko previously requested changes May 15, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

@joshitzko joshitzko left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

TIP-1026 scope LGTM. One change before merge: recommend SVG for logoURI in the Coming with T5 callouts on create-a-stablecoin.mdx and manage-stablecoin.mdx (and optionally the TIP-1026 section of t5.mdx). Non-SVG icons render poorly across wallets and explorers, so this should mirror the tokenlist Icon Requirements.

@joshitzko joshitzko dismissed their stale review May 15, 2026 14:31

Dismissing — will re-review with author directly.

malleshpai
malleshpai reviewed May 15, 2026
View reviewed changes
Comment thread src/pages/protocol/exchange/providing-liquidity.mdx Outdated
max-digi and others added 3 commits May 15, 2026 16:28
@max-digi @malleshpai
Update src/pages/protocol/exchange/providing-liquidity.mdx
e4c07a1 
Co-authored-by: malleshpai <mallesh.pai@gmail.com>
@max-digi @malleshpai
Update src/pages/guide/stablecoin-dex/view-the-orderbook.mdx
5d2f531 
Co-authored-by: malleshpai <mallesh.pai@gmail.com>
@max-digi @malleshpai
Update src/pages/guide/stablecoin-dex/managing-fee-liquidity.mdx
6ea03c1 
Co-authored-by: malleshpai <mallesh.pai@gmail.com>
malleshpai
malleshpai reviewed May 15, 2026
View reviewed changes
Comment thread src/pages/protocol/fees/spec-fee-amm.mdx Outdated
max-digi and others added 3 commits May 15, 2026 16:59
@max-digi @ampcode-com
Address rusowsky's PR review comments
3869ac1 
- exchange/index.mdx: extend Coming-with-T5 callout with TIP-1035
  (Implicit Approvals List) — DEX users no longer need to pre-approve.
- managing-fee-liquidity.mdx: link to FeeAMM explorer view
  (https://explore.tempo.xyz/fee-amm).
- t5.mdx (TIP-1034 integration changes): link the new precompile
  contract address (0x4D50500...0 / ASCII 'MPP').
- t5.mdx (TIP-1033 feature TIP): link to FeeAMM explorer view.
- vocs.config.ts: revert T4 sidebar label to bare 'T4' (mainnet
  activation pending Presto May 18).
- t4.mdx: small status callout clarifying T4 active on Moderato,
  mainnet pending Presto.

Amp-Thread-ID: https://ampcode.com/threads/T-019e218f-4b73-7337-a0ca-d3921dc84735
Co-authored-by: Amp <amp@ampcode.com>
@max-digi
Apply spec-fee-amm Coming-with-T5 callout suggestion (Mallesh)
4a606d4 
Replaces the multihop callout copy with the more accurate two-hop
description from Mallesh's review suggestion (insufficient-direct-pool
condition + explicit route via quote token). Switches the TIP link to
tips.sh for consistency.
@max-digi
Recommend SVG for on-chain logoURI (per Josh)
f52186e 
Adds an SVG-recommendation note to the TIP-1026 'Coming with T5'
callouts on the issuance guides and to the TIP-1026 integration
changes section on the T5 page, mirroring the tokenlist Icon
Requirements. Non-SVG icons render poorly across wallets and
explorers.
@max-digi
Copy link
Copy Markdown
Contributor Author

max-digi commented May 15, 2026

@joshitzko addressed in f52186e — added an SVG recommendation to the TIP-1026 Coming with T5 callouts on create-a-stablecoin.mdx and manage-stablecoin.mdx, plus the TIP-1026 integration-changes section on t5.mdx. Each note links to the tokenlist Icon Requirements. Flagging the rationale (non-SVG icons render poorly in our explorer and other client apps) so it's clear in-line.

@max-digi
Reword logoURI SVG note positively
db44eb6 
Switches the SVG recommendation from 'non-SVG icons render poorly'
to 'use an SVG so it renders crisply at any resolution'.
jenpaff
jenpaff approved these changes May 15, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

@jenpaff jenpaff left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LFG 🚀

@max-digi max-digi merged commit ae48913 into main May 15, 2026
15 checks passed
@max-digi max-digi deleted the docs/t5-network-upgrade branch May 15, 2026 17:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@malleshpai malleshpai malleshpai approved these changes

@0xrusowsky 0xrusowsky 0xrusowsky approved these changes

@jenpaff jenpaff jenpaff approved these changes

@joshitzko joshitzko joshitzko left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@max-digi @jenpaff @malleshpai @joshitzko @0xrusowsky