Skip to content

docs: add Querying Tempo page#391

Open
max-digi wants to merge 6 commits intomainfrom
mmp/docs-querying-tempo
Open

docs: add Querying Tempo page#391
max-digi wants to merge 6 commits intomainfrom
mmp/docs-querying-tempo

Conversation

@max-digi
Copy link
Copy Markdown
Contributor

@max-digi max-digi commented May 7, 2026

Adds a new "Querying Tempo" page under Integrate Tempo for analysts, data engineers, and indexers writing queries against Tempo data.

It covers the EVM/data-layer differences that silently produce wrong numbers if you carry over Ethereum assumptions:

  1. Fees are denominated in USD (attodollars), not ETH/wei
  2. TIP-20 tokens use 6 decimals, not 18
  3. tx.value is always 0 — use Transfer events for volume
  4. Use COALESCE(fee_payer, from) for sponsored-tx attribution
  5. Exclude system transactions (from = 0x0…0) when measuring user activity
  6. Derive supply from Transfer events, not Mint events

Also includes key precompile addresses (FeeManager, DEX, TIP-20 Factory, PathUSD) and mainnet/Moderato network details.

Placement

Sidebar entry added to Integrate Tempo between Wallet Developers and Contract Verification.

Preview

/quickstart/querying-tempo

Adds a new page under Integrate Tempo covering data-layer differences
analysts and indexers need to know when querying Tempo: USD-denominated
fees, TIP-20 6 decimals, Transfer events vs tx.value, fee_payer
attribution, system transactions, and supply derivation. Also includes
key precompile addresses and network details.

Amp-Thread-ID: https://ampcode.com/threads/T-019e0366-1385-70ac-8cf3-1738206b7d0e
Co-authored-by: Amp <amp@ampcode.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented May 7, 2026

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

Project Deployment Actions Updated (UTC)
tempo-docs Ready Ready Preview, Comment May 7, 2026 6:17pm

Request Review

max-digi and others added 3 commits May 7, 2026 19:00
…lyQuery

Address PR feedback: replace static SQL examples for the Transfer-based sections (volume, supply) with the existing <IndexSupplyQuery> component so readers can edit and run them against Tempo mainnet via Index Supply.

Gas-fee, fee_payer attribution, and system-tx examples remain static blocks because they reference Tempo-specific columns (effective_gas_price, fee_payer) not exposed in IndexSupply's standard schema.

Amp-Thread-ID: https://ampcode.com/threads/T-019e0366-1385-70ac-8cf3-1738206b7d0e
Co-authored-by: Amp <amp@ampcode.com>
Upstream TIPs occasionally include GitHub handles like @0xrusowsky in the authors field. The leading @ is a YAML reserved character and breaks the build. Quote the value defensively when it begins with any YAML reserved char.

Amp-Thread-ID: https://ampcode.com/threads/T-019e0366-1385-70ac-8cf3-1738206b7d0e
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.

2 participants