Skip to content

T3 docs cleanup: make T3 canonical, consolidate T2 deltas into migration appendix#350

Open
max-digi wants to merge 7 commits intomainfrom
mmp/remove-t3-upcoming-banner
Open

T3 docs cleanup: make T3 canonical, consolidate T2 deltas into migration appendix#350
max-digi wants to merge 7 commits intomainfrom
mmp/remove-t3-upcoming-banner

Conversation

@max-digi
Copy link
Copy Markdown
Contributor

@max-digi max-digi commented Apr 27, 2026

T3 activated on mainnet on Apr 27, 2026 (16:00 CEST). This PR makes T3 the canonical baseline across the protocol specs and the Foundry SDK page, and consolidates T2-era deltas into a single ## T2 → T3 migration appendix at the bottom of each affected page. The appendix is kept for an integrator cooldown period and will be removed in a future docs revision.

Changes

Banners removed (the original screenshot ask)

  • :::info[T3 will change this spec/precompile] banners removed from tip20/spec.mdx, tip20-rewards/spec.mdx, tip403/spec.mdx, transactions/AccountKeychain.mdx, transactions/spec-tempo-transaction.mdx.
  • :::info[T3 examples] banners removed from guide/tempo-transaction/index.mdx and protocol/transactions/index.mdx — T3 is now the baseline shape.

Specs rewritten as T3-canonical with consolidated migration appendix

  • transactions/AccountKeychain.mdx — full rewrite. Was 21 inline #### T2 -> T3 changes subsections plus a top-of-page ## Account keychain post-T3 block and a separate ### T2 interface section. Now reads as a single post-T3 specification, with all T2 deltas, the legacy authorizeKey selector/encoding, and the legacy interface listed under ## T2 → T3 migration at the bottom.
  • tip20/spec.mdx — added a ## Virtual Address Recipients section describing TIP-1022 resolution as canonical TIP-20 behavior. T3 deltas summarized in ## T2 → T3 migration.
  • tip20-rewards/spec.mdx — virtual-address rejection in setRewardRecipient(...) is now part of the Opt-In Model section.
  • tip403/spec.mdx — virtual-address rejection on policy-config functions and resolution behavior on TIP-20 policy checks are now in Usage with TIP-20 Tokens.
  • transactions/spec-tempo-transaction.mdxKeyAuthorization struct now includes allowed_calls, TokenLimit includes period, plus new CallScope and SelectorRule structs. RLP encoding, authorization hierarchy, spending-limit enforcement (with recurring rollover), call-scope enforcement, contract-creation restriction, the KeyAuthorization example, the precompile querying example, and the intrinsic-gas pseudocode are all updated to T3.

SDK docs

  • sdk/foundry/index.mdx — applies the same T3-canonical pattern as the protocol specs above (originally split out as docs(sdk/foundry): make T3 canonical, consolidate T2 deltas into migration appendix #363, now folded in here). Removes the two inline #### T2 -> T3 changes headings, drops Post-T3 / pre-T3 future-tense framing in the forge create note, the access-key CREATE restriction, the cast keychain intro, and a code comment, and consolidates the legacy authorizeKey(...) ABI migration note + the full Check your authorizeKey(...) migration with cast section into a ## T2 → T3 migration appendix at the bottom.

RPC docs

  • protocol/rpc/index.mdxtempo_forkSchedule example response updated to live mainnet values (T3 active, forkId: 0xd2087b77, activationTime: 1777298400, active: "T3"), pulled from https://rpc.tempo.xyz.

Affected pages (preview)

Out of scope (kept for a future PR)

  • The ## T2 → T3 migration appendices on each spec/page are deliberately left in. They should be deleted in a follow-up once the cooldown period is over. Removability is straightforward: each appendix is the trailing section of its file with no incoming anchors, so a single sed loop can drop or replace them in one shot.
  • TIP frontmatter (protocolVersion: T3) on TIP-1011/1016/1020/1022 and the /protocol/upgrades/t3 page itself are historical metadata; left as-is.
  • sdk/typescript/index.mdx still has one "pre-T3 / post-T3" sentence describing the Accounts SDK status — it's factual rather than future-tense, but worth a follow-up to mirror the same canonicalization pass.

T3 activated on mainnet today (Apr 27, 2026, 16:00 CEST), so the
'T3 will change this spec/precompile' callouts at the top of these
spec pages are no longer accurate.

Amp-Thread-ID: https://ampcode.com/threads/T-019dd0dc-6a9c-7239-90cf-3737ae460bfa
Co-authored-by: Amp <amp@ampcode.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 27, 2026

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

Project Deployment Actions Updated (UTC)
tempo-docs Ready Ready Preview, Comment Apr 30, 2026 3:48pm

Request Review

…rs, update RPC example

- Rename '## Upcoming changes' -> '## T3 changes' in TIP-20, TIP-403,
  TIP-20 rewards, and Tempo Transaction specs; reframe intros and
  applicable bullets in past/present tense now that T3 is live.
- Remove ':::info[T3 examples]' banners from the Tempo Transaction
  guide and the protocol transactions index — T3 is now the baseline.
- Update the tempo_forkSchedule example response in the RPC docs to
  reflect mainnet (T3 active, real fork IDs and activation time).

Amp-Thread-ID: https://ampcode.com/threads/T-019dd0dc-6a9c-7239-90cf-3737ae460bfa
Co-authored-by: Amp <amp@ampcode.com>
@max-digi max-digi changed the title Remove 'T3 will change this spec' banners Retire T3 'upcoming' framing across docs Apr 27, 2026
@max-digi max-digi requested a review from jenpaff April 28, 2026 03:25
…ndix

For each protocol spec, fold the T3 deltas into the body so the spec
reads as post-T3 baseline, and consolidate T2 -> T3 migration content
into a single `## T2 → T3 migration` appendix at the bottom of the
page. The appendix is kept for an integrator cooldown period and will
be removed in a future docs revision.

Specs updated:
- AccountKeychain.mdx (full rewrite — was 21 inline T2 -> T3 subsections)
- tip20/spec.mdx (added Virtual Address Recipients section)
- tip20-rewards/spec.mdx (folded virtual-address rejection into Opt-In Model)
- tip403/spec.mdx (folded virtual-address handling into Usage with TIP-20 Tokens)
- spec-tempo-transaction.mdx (updated KeyAuthorization, TokenLimit,
  authorization hierarchy, spending-limit, call-scope, contract-creation,
  RLP encoding, examples, and intrinsic-gas pseudocode)

Amp-Thread-ID: https://ampcode.com/threads/T-019dd0dc-6a9c-7239-90cf-3737ae460bfa
Co-authored-by: Amp <amp@ampcode.com>
@max-digi max-digi changed the title Retire T3 'upcoming' framing across docs T3 docs cleanup: make T3 canonical, consolidate T2 deltas into migration appendix Apr 28, 2026
@max-digi max-digi requested a review from tmm April 29, 2026 14:48
Same treatment as the protocol specs in this PR: remove the two inline
'#### T2 -> T3 changes' sections, reword surrounding prose as
T3-canonical (drop 'Post-T3 / pre-T3' future-tense framing in the
forge-create note, the access-key CREATE restriction, the cast keychain
intro, and a code comment), and consolidate the legacy authorizeKey ABI
+ selector-check material into a '## T2 → T3 migration' appendix at
the bottom with the same :::info[Migration appendix] callout used on
the spec pages.

Amp-Thread-ID: https://ampcode.com/threads/T-019dd9ac-1e55-70ed-89d6-0764dccdf9e8
Co-authored-by: Amp <amp@ampcode.com>
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.

4 participants