Skip to content

docs: update flip orders + tokenlist for T5 (TIP-1030, TIP-1056, TIP-1026)#406

Closed
max-digi wants to merge 1 commit into
mainfrom
docs/t5-followup-flip-orders-and-tokenlist
Closed

docs: update flip orders + tokenlist for T5 (TIP-1030, TIP-1056, TIP-1026)#406
max-digi wants to merge 1 commit into
mainfrom
docs/t5-followup-flip-orders-and-tokenlist

Conversation

@max-digi
Copy link
Copy Markdown
Contributor

Draft — do not merge until T5 is active on Moderato.

Follow-up to #405. Updates the public DEX flip-order docs and the token onboarding guide to reflect T5 behavior. Held as draft so the docs go live alongside the activation rather than ahead of it.

Files changed

src/pages/protocol/exchange/providing-liquidity.mdx

  • Flip Orders section:
    • flipTick == tick is now allowed (TIP-1030); validation rules updated from strictly greater/less to greater-or-equal / less-or-equal, with a note about the pegged-pairs use case
    • orderId description clarifies the same id is reused across every flip (TIP-1056)
    • Walkthrough rewritten: filled flip orders are rewritten in place and emit OrderFlipped (not OrderPlaced) — the orderId does not change
    • New "Tracking flip orders" subsection with explicit before-T5 vs after-T5 indexer guidance and a link to the TIP-1056 compatibility section
  • Order Execution Timeline: updated the flip-order step to describe in-place rewrite + OrderFlipped, with a parenthetical noting the pre-T5 behavior

src/pages/quickstart/tokenlist.mdx

  • "Adding a New Token" now opens with a comparison table covering the two paths (on-chain logoURI vs registry) and recommends doing both
  • New "Setting logoURI on-chain (T5+)" subsection with the verified TIP-1026 ABI: 7-arg createToken overload, setLogoURI, LogoURIUpdated (emitted from token's own address), logoURI() view, plus on-chain validation rules (256-byte cap, scheme allowlist https/http/ipfs/data, empty-string-clears-field)
  • Existing registry steps preserved under a "Registering in the tokenlist" subheading; Token Extensions and Icon Requirements unchanged
  • The #adding-a-new-token anchor is preserved so external links (including the one in t5.mdx from docs: add T5 network upgrade page + T4 → T5 migration appendices #405) keep working

Verification

  • pnpm run check runs clean (3 pre-existing warnings in scripts/lighthouse.ts, unrelated)
  • TIP-1026 ABI signatures verified against tempoxyz/tempo tips/tip-1026.md

Sequencing

Per the T5 rollout plan, this PR will be marked ready for review and merged after T5 activates on Moderato (June 3, 2026 4pm CEST per #405). Until then it sits as a draft.

@vercel
Copy link
Copy Markdown

vercel Bot commented May 13, 2026

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

Project Deployment Actions Updated (UTC)
tempo-docs Error Error May 13, 2026 5:07pm

Request Review

@max-digi max-digi requested a review from jenpaff May 13, 2026 17:06
@max-digi max-digi closed this May 13, 2026
@max-digi max-digi deleted the docs/t5-followup-flip-orders-and-tokenlist branch May 13, 2026 18:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant