Skip to content

docs: add Ethereum to supported-chain table and capabilities list - #777

Merged
shreyav merged 2 commits into
mainfrom
claude/docs-ethereum-l1-external-account
Jul 30, 2026
Merged

docs: add Ethereum to supported-chain table and capabilities list#777
shreyav merged 2 commits into
mainfrom
claude/docs-ethereum-l1-external-account

Conversation

@shreyav

@shreyav shreyav commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds Ethereum to the two places that already enumerate supported chains and were missing it. Docs-only, 2 files, +2/-1.

Page Change
mintlify/snippets/sending/cross-currency.mdx Ethereum | USDC, USDT row in the supported blockchains table
mintlify/platform-overview/introduction/platform-capabilities.mdx Ethereum added to the self-custody wallet list

Both generated bundles (openapi.yaml, mintlify/openapi.yaml) are byte-identical to main.

Why only these two

An earlier revision of this PR also added an Ethereum L1 example to snippets/external-accounts.mdx and an Ethereum funding accordion to snippets/internal-accounts.mdx. Both were dropped in bbfeb06.

The two remaining changes fix incomplete enumerations. The blockchains table already had Base, Tron, Polygon, Lightning and Spark rows; the capabilities list already read "Spark, Solana, Tron, Base, Polygon, etc." Ethereum was supported and simply absent from both, so adding it makes them correct.

The two dropped changes were a different case. Neither of those pages documents any wallet type other than Spark — BASE_WALLET, POLYGON_WALLET, PLASMA_WALLET, SOLANA_WALLET and TRON_WALLET appear nowhere in external-accounts.mdx. Adding an Ethereum-only example there would read as a curated list of the two chains Grid supports, rather than two entries from a set of seven. That's arguably worse than the current silence.

Follow-up this leaves open

external-accounts.mdx documents 1 of 7 wallet external-account types. Base, Polygon, Plasma, Solana, Tron and Ethereum are all undocumented there, and none of their schemas carry x-internal, deprecated, or a beta marker — the omission looks incidental, not deliberate. They should be written up as one set, with per-chain asset support derived from each Payment<Chain>WalletInfo.yaml enum rather than assumed (they differ: Ethereum is [USDC, USDT], Base and Polygon are USDC-only).

Separately, and outside the scope of a docs PR: components/grid-visualizer/src/data/crypto.ts lists ETHEREUM_WALLET only under USDT and omits it from USDC, which contradicts PaymentEthereumWalletInfo.yaml declaring enum: [USDC, USDT].

Verification

  • All changed MDX compiles cleanly against the @mdx-js/mdx compiler bundled with mintlify@4.2.284; mintlify broken-links reports no broken links in the touched files.
  • make lint fails on main as wellnpx spectral lint errors with spectral: not found because npm resolves a stub spectral@0.0.0 instead of @stoplight/spectral-cli. Pre-existing and reproducible on a clean checkout; distinct from the separately-broken lint-markdown. The step that does run, @redocly/cli lint, passes with 50 pre-existing warnings.
  • Not verified: no visual render check. The Mintlify preview deploy is worth a look at the table row.

Supersedes the documentation portion of #288, whose Grid Visualizer changes already landed on main via later syncs.

Ethereum L1 (ETHEREUM_WALLET) is fully supported in the API and present in
the OpenAPI schemas, the generated bundle, and the Grid Visualizer, but was
absent from every hand-written docs page.

Adds Ethereum L1 coverage to the pages that enumerate supported wallets or
chains, matching each page's existing pattern:

- snippets/external-accounts.mdx: Ethereum L1 wallet creation example in the
  Cryptocurrency tab
- snippets/internal-accounts.mdx: "Ethereum Stablecoin Funding" accordion
  alongside the other per-chain funding examples
- snippets/sending/cross-currency.mdx: Ethereum row in the supported
  blockchains table
- platform-overview/introduction/platform-capabilities.mdx: Ethereum in the
  self-custody wallet list

Asset support (USDC and USDT) is taken from
openapi/components/schemas/common/PaymentEthereumWalletInfo.yaml.

Docs-only; no OpenAPI source or generated bundle changes.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MMnjJ8yWJsui7jLqqrDrL4
@vercel

vercel Bot commented Jul 30, 2026

Copy link
Copy Markdown

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

2 Skipped Deployments
Project Deployment Actions Updated (UTC)
grid-flow-builder Ignored Ignored Preview Jul 30, 2026 9:52pm
grid-wallet-demo Ignored Ignored Preview Jul 30, 2026 9:52pm

Request Review

@mintlify

mintlify Bot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Grid 🟢 Ready View Preview Jul 30, 2026, 8:26 PM

@greptile-apps

greptile-apps Bot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

Documents Ethereum L1 wallet support across Grid’s developer documentation.

  • Adds an ETHEREUM_WALLET external-account creation example for USDC and USDT.
  • Adds Ethereum funding instructions for internal accounts.
  • Lists Ethereum as a supported USDC and USDT network for cross-currency funding.
  • Adds Ethereum to the platform’s self-custody wallet capabilities.

Confidence Score: 5/5

The documentation-only PR appears safe to merge with no actionable defects identified.

The new Ethereum account and funding documentation agrees with the repository’s wallet schemas, supported USDC/USDT asset combinations, and established Mintlify patterns.

Important Files Changed

Filename Overview
mintlify/platform-overview/introduction/platform-capabilities.mdx Adds Ethereum to the self-custody network list consistently with the surrounding network terminology.
mintlify/snippets/external-accounts.mdx Adds a schema-consistent Ethereum L1 external-account example and an appropriate wrong-network warning.
mintlify/snippets/internal-accounts.mdx Documents Ethereum funding instructions using the supported ETHEREUM_WALLET account type and USDC/USDT assets.
mintlify/snippets/sending/cross-currency.mdx Adds Ethereum’s supported stablecoins to the existing blockchain funding matrix.

Reviews (1): Last reviewed commit: "docs: document Ethereum L1 external acco..." | Re-trigger Greptile

Keeps the two changes that complete existing lists and drops the two
that added Ethereum-specific example content.

The blockchains table already had Base, Tron, Polygon, Lightning and
Spark rows, and the self-custody wallet list already read "Spark,
Solana, Tron, Base, Polygon, etc." - Ethereum was simply missing from
both. Adding it makes those enumerations correct.

The external-accounts and internal-accounts pages are a different
case. Neither documents any wallet type except Spark, so an
Ethereum-only example there reads as a curated list of the two
supported chains rather than as two entries from a set of seven.
Base, Polygon, Plasma, Solana and Tron are all equally undocumented;
they should be written up together or not at all.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MMnjJ8yWJsui7jLqqrDrL4
@shreyav shreyav changed the title docs: document Ethereum L1 external accounts and funding docs: add Ethereum to supported-chain table and capabilities list Jul 30, 2026
@shreyav
shreyav merged commit 5c1448f into main Jul 30, 2026
8 checks passed
@shreyav
shreyav deleted the claude/docs-ethereum-l1-external-account branch July 30, 2026 22:25
shreyav added a commit that referenced this pull request Aug 4, 2026
## Summary

`PaymentEthereumWalletInfo.yaml` declares `enum: [USDC, USDT]`, but
`crypto.ts` listed `ETHEREUM_WALLET` only under USDT. USDC-on-Ethereum
is supported by the API and simply could not be selected in the
visualizer, so that flow could not be built or code-generated.

One line. Ethereum is the only chain carrying both assets — Base and
Polygon are USDC-only per their own `Payment<Chain>WalletInfo.yaml`
enums — so this is the single missing entry, not the first of a batch.

| Chain | Schema enum | In `crypto.ts` before |
|---|---|---|
| Ethereum | `USDC`, `USDT` | USDT only ❌ |
| Base | `USDC` | USDC ✅ |
| Polygon | `USDC` | USDC ✅ |

## ⚠️ Missing network icon — please read

`NetworkDropdown` renders `/networks/${network.toLowerCase()}.svg` with
no error handling, and **`public/networks/ethereum.svg` does not
exist**. The new row will render without an icon.

This gap is pre-existing, not introduced here — `tron.svg` and
`plasma.svg` are missing too, so USDT's dropdown already shows three
iconless rows. But USDC's dropdown currently has all three of its icons
(`solana`, `polygon`, `base`), so this change does put the first broken
one there.

I did not add the asset: an Ethereum mark is brand artwork, and
inventing one that doesn't match the existing set is worse than leaving
the gap visible. Someone should drop in `ethereum.svg` — and `tron.svg`
/ `plasma.svg` while they're at it, since those are already broken
today.

If the missing icon is a blocker, holding this until the asset lands is
reasonable. The data being wrong is the more serious problem, so I'd
merge and follow up.

## Verification

- Strict typecheck of `crypto.ts` — clean
- Cross-checked all three EVM chains against their
`Payment<Chain>WalletInfo.yaml` enums, not just Ethereum
- **Not verified:** no build or render check — `npm ci` fails here
because `@central-icons-react` requires `CENTRAL_LICENSE_KEY`. The
Vercel preview is the real check; worth confirming the USDC dropdown now
offers Ethereum and seeing how the iconless row actually looks.

## Context

Found while triaging the stale docs-sync PRs. This is the one
genuinely-unlanded, non-documentation item from #288, whose other
changes are already on `main` (`ETHEREUM_WALLET` in `account-types.ts`,
the `businessType: FINTECH` → `FINANCE_AND_INSURANCE` fix) or superseded
(currency entries via #791, the supported-chain table via #777).

---
_Generated by [Claude
Code](https://claude.ai/code/session_01MMnjJ8yWJsui7jLqqrDrL4)_

Co-authored-by: Claude <noreply@anthropic.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.

3 participants