docs: add TIP-1023 address format page and convert docs to tempo1 addresses#123
Open
docs: add TIP-1023 address format page and convert docs to tempo1 addresses#123
Conversation
…resses Adds documentation for the Tempo Address Format (TIP-1023) with an interactive bech32m converter tool, and migrates user-facing 0x addresses throughout the docs to the new tempo1 bech32m format. - Add bech32m encode/decode/validate library (src/lib/bech32m.ts) - Add interactive AddressConverter component with conversion and substitution error detection demo - Add dedicated /protocol/addresses page with converter, format overview, and links to TIP-1023 spec - Convert address tables (predeployed contracts, faucet, token lists) to tempo1 format - Convert deployment addresses in protocol specs (DEX, FeeManager, TIP20Factory, TIP403Registry, AccountKeychain) to tempo1 - Convert token address references in guides and SDK examples to tempo1 - Update sidebar to include Address Format page Code examples using Solidity/Rust/Go and low-level protocol byte values are intentionally left as 0x since the EVM operates on hex addresses. Companion to tempoxyz/tempo#2925 Made-with: Cursor
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Add a dedicated step for displaying and accepting tempo1 addresses, with code examples for encode/decode and a link to display recommendations. Also adds it to the pre-launch checklist and learning resources. Made-with: Cursor
Replace the string-comparison-based substitution demo with actual BCH error correction that recovers corrupted addresses with no knowledge of the original: - Add correctTempoAddress() to bech32m.ts that performs brute-force BCH decoding: 1-error search (1,280 candidates) then 2-error search (~800K candidates) - Redesign Error Correction tab to show recovered address, error positions, and corrected characters - Presets for 1, 2, 3, and 5 errors demonstrate the boundary between correctable (1-2) and detection-only (3+) - Update addresses.mdx to document correction capabilities Made-with: Cursor
Port Pieter Wuille's algebraic GF(1024) syndrome decoder from sipa/bech32. Error positions are now found via syndrome computation + GF(1024) log/exp tables, then values are corrected by targeted search at known positions only. Performance: 1-error 0.8ms (was ~50ms), 2-error 6ms (was ~3s), 3+ errors detected instantly (was ~3s scanning before giving up). Made-with: Cursor
The markdown code fence gave the example a Vocs-generated copy button that copied the address with spaces, contradicting the text saying copy must use the canonical form. Switch to a plain <p> so there is no copy affordance on the display-only example. Made-with: Cursor
Made-with: Cursor
- Replace non-null assertions with optional chaining / nullish coalescing - Add htmlFor/id associations for label+input pairs - Use span for output label (no associated input) - Auto-format per Biome rules Made-with: Cursor
jxom
reviewed
Mar 4, 2026
Comment on lines
+81
to
+103
| ## JavaScript / TypeScript Usage | ||
|
|
||
| The `src/lib/bech32m.ts` module provides encode, decode, and validate functions: | ||
|
|
||
| ```typescript | ||
| import { | ||
| encodeTempoAddress, | ||
| decodeTempoAddress, | ||
| validateTempoAddress, | ||
| } from './lib/bech32m' | ||
|
|
||
| // 0x → tempo1 | ||
| const tempo = encodeTempoAddress('0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28') | ||
| // → "tempo1qp6z6dwvvc6vq5efyk3ms39une6etu4a9qtj2kk0" | ||
|
|
||
| // tempo1 → 0x | ||
| const hex = decodeTempoAddress('tempo1qp6z6dwvvc6vq5efyk3ms39une6etu4a9qtj2kk0') | ||
| // → "0x742d35cc6634c0532925a3b844bc9e7595f2bd28" | ||
|
|
||
| // Validate without throwing | ||
| const result = validateTempoAddress('tempo1qp6z6dwvvc6vq5efyk3ms39une6etu4a9qtj2kkq') | ||
| // → { valid: false, error: "Invalid checksum — address is corrupted" } | ||
| ``` |
Member
There was a problem hiding this comment.
Let's direct users to Viem: https://viem.sh/tempo/utilities/TempoAddress.parse
onbjerg
reviewed
Mar 5, 2026
| Tempo features an enshrined decentralized exchange (DEX) designed specifically for trading between stablecoins of the same underlying asset (e.g., USDC to USDT). The exchange provides optimal pricing for cross-stablecoin payments while minimizing chain load from excessive market activity. | ||
|
|
||
| The exchange operates as a singleton precompiled contract at address `0xdec0000000000000000000000000000000000000`. It maintains an orderbook with separate queues for each price tick, using price-time priority for order matching. | ||
| The exchange operates as a singleton precompiled contract at address `tempo1qr0vqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqvml629`. It maintains an orderbook with separate queues for each price tick, using price-time priority for order matching. |
Member
There was a problem hiding this comment.
changing the precompiles to this format (across all pages) adds a lot of friction for anyone calling this in solidity, i'm not sure if exempting precompiles makes sense?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
/protocol/addresses) with an interactive bech32m converter tool that lets users convert between0xandtempo1addresses and demonstrates substitution error detectionsrc/lib/bech32m.ts) withencodeTempoAddress,decodeTempoAddress, andvalidateTempoAddressexports0xaddresses across 20 docs pages to the newtempo1bech32m format, including address tables (predeployed contracts, faucet, token lists), protocol spec deployment addresses (DEX, FeeManager, TIP20Factory, TIP403Registry, AccountKeychain), guide prose references, and SDK examplesCode examples in Solidity, Rust, Go, and CLI commands remain as
0xsince the EVM operates on hex addresses at the protocol level.Companion to tempoxyz/tempo#2925 (TIP-1023 specification).
Test plan
vite buildsucceeds/protocol/addressespage renders with working converter (Convert + Error Detection tabs)/protocol/tipsindex auto-discovers TIP-1023 once docs: add TIP-1023 Tempo Address Format tempo#2925 merges0xformatMade with Cursor