Skip to content

WIP: T3 docs update#293

Open
jenpaff wants to merge 12 commits intomainfrom
docs/t3-upgrade-prep
Open

WIP: T3 docs update#293
jenpaff wants to merge 12 commits intomainfrom
docs/t3-upgrade-prep

Conversation

@jenpaff
Copy link
Copy Markdown
Contributor

@jenpaff jenpaff commented Apr 14, 2026

update protocol specs and docs based on t3 network upgrade

@vercel
Copy link
Copy Markdown

vercel bot commented Apr 14, 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 16, 2026 3:54pm

Request Review

jenpaff and others added 2 commits April 15, 2026 13:16
Co-authored-by: Jennifer <5339211+jenpaff@users.noreply.github.com>
Amp-Thread-ID: https://ampcode.com/threads/T-019d90a3-46f3-75bc-baef-765e2f8b971f
Co-authored-by: Amp <amp@ampcode.com>
Co-authored-by: Jennifer <5339211+jenpaff@users.noreply.github.com>
Amp-Thread-ID: https://ampcode.com/threads/T-019d90a3-46f3-75bc-baef-765e2f8b971f
Co-authored-by: Amp <amp@ampcode.com>
Co-authored-by: Jennifer <5339211+jenpaff@users.noreply.github.com>
Amp-Thread-ID: https://ampcode.com/threads/T-019d91af-04a3-70ea-a3f9-19413f47dbc1
Co-authored-by: Amp <amp@ampcode.com>
Co-authored-by: Jennifer <5339211+jenpaff@users.noreply.github.com>
Amp-Thread-ID: https://ampcode.com/threads/T-019d91af-04a3-70ea-a3f9-19413f47dbc1
Co-authored-by: Amp <amp@ampcode.com>
Co-authored-by: Jennifer <5339211+jenpaff@users.noreply.github.com>
Amp-Thread-ID: https://ampcode.com/threads/T-019d91af-04a3-70ea-a3f9-19413f47dbc1
Co-authored-by: Amp <amp@ampcode.com>
@jenpaff jenpaff marked this pull request as ready for review April 16, 2026 09:44
Co-authored-by: Jennifer <5339211+jenpaff@users.noreply.github.com>
Amp-Thread-ID: https://ampcode.com/threads/T-019d95b8-647a-77d9-9591-088166091a60
Co-authored-by: Amp <amp@ampcode.com>
Comment thread src/pages/protocol/transactions/AccountKeychain.mdx Outdated
Co-authored-by: Tanishk Goyal <goyaltanishk02@gmail.com>
Comment on lines +21 to +32
<StaticMermaidDiagram chart={`flowchart LR
subgraph A[Without virtual addresses]
D1[Customer deposit address] --> B1[Separate onchain balance]
B1 --> S1[Sweep transaction]
S1 --> M1[Master wallet]
end

subgraph B[With virtual addresses]
D2[Customer virtual address] --> F2[TIP-20 forwarding]
F2 --> M2[Master wallet]
end
`} />
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

looks kinda ugly (really big and stacked, rather than parallel)

additionally would benefit from explaining the emitted events for full traceability

- you keep one deposit address per customer
- the master wallet receives the balance directly
- no sweep transaction is needed
- no separate TIP-20 balance is created for each deposit address
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

maybe worth pointing out that there is no double transfer, thus no perf/gas overhead (technically u pay 1 extra SLOAD)

Comment on lines +75 to +87
<StaticMermaidDiagram chart={`sequenceDiagram
participant Sender
participant TIP20 as TIP-20
participant Registry as Virtual registry
participant Master as Registered wallet

Sender->>TIP20: transfer(virtualAddress, amount)
TIP20->>Registry: resolve(masterId)
Registry-->>TIP20: master wallet
TIP20->>Master: credit balance
Note over TIP20: emits Transfer(sender → virtual, amount)
Note over TIP20: emits Transfer(virtual → master, amount)
`} />
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

nice, but would be really cool if we could have it as one of the animated diagrams like in mpp


In practice:

- explorers and indexers should understand the two-hop `Transfer` pattern
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

worth mentioning that no extra work is needed, as they are regular transfers

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.

5 participants