Skip to content

Add web tool methodology pages#662

Draft
juandolealt wants to merge 1 commit into
mainfrom
juan/web-tools-methodology
Draft

Add web tool methodology pages#662
juandolealt wants to merge 1 commit into
mainfrom
juan/web-tools-methodology

Conversation

@juandolealt

Copy link
Copy Markdown
Member

Adds three methodology pages under Tools & SDKs that back the tempo.xyz /tools calculators shipping in tempoxyz/tempo-web#421:

  • /developers/docs/tools/fee-estimator — fee formula (ceil(base_fee × gas_used ÷ 10^12) microdollars), unit table, TIP-1010 base fee provenance with the live eth_gasPrice refresh, gas figures per operation (documented vs. estimated), exclusions, and the full /api/fee-estimate JSON contract (parameters, response fields, caching, CORS).
  • /developers/docs/tools/cross-border-cost — corridor math from the World Bank Remittance Prices Worldwide Q3 2025 dataset (simple means on a $200-equivalent send, reproducing the published 6.36% global average), per-row formulas, the eight corridors with exact figures, stated assumptions, refresh cadence, and the verbatim CC BY 4.0 attribution.
  • /developers/docs/tools/settlement-time — arrival engine rules (cutoffs, business days, holiday handling, virtual ET clock with the CET ≈ ET + 6 caveat), float cost formula (SOFR 3.66% as of July 1, 2026), the complete eight-rail reference with per-rail sources, and the 2026–2027 Federal Reserve holiday and TARGET closing-day calendars.

Also adds a Web tool methodologies sidebar group in vocs.config.ts and three cards on the Tools & SDKs overview page.

Merge ordering

The web tool pages in tempoxyz/tempo-web#421 link to /developers/docs/tools/<slug>, so this PR should merge before or together with the web PR to avoid dead links from the live tools. Conversely, the https://tempo.xyz/tools/... links on these pages (and their .md mirrors) return 404 until #421 deploys, so the lychee external-link check may flag them until then.

Live URLs once both PRs deploy:

Validation

  • pnpm check (Biome): clean, no fixes needed in changed files
  • pnpm check:types (tsgo): clean
  • pnpm build (includes checkDeadlinks): clean, 427 files generated, all three pages emitted under dist/public/docs/tools/
  • AGENTS.md generic-H2 scan on changed MDX: no matches
  • Protocol claims (fee formula, ~50,000 gas, 94% payment lane allocation, ~600 ms blocks, sub-second finality) cross-checked against src/pages/docs/protocol/fees/spec-fee.mdx, fees/index.mdx, and blockspace/consensus.mdx; a callout notes the T7 dynamic base fee.

🤖 Generated with Claude Code

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 9, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
tempo-docs Ready Ready Preview, Comment Jul 9, 2026 2:14pm

Request Review

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