Add Ethereum L1 external accounts and payment instructions

[jklein24]

No description provided.

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
grid-flow-builder	Ready	Preview, Comment	Mar 20, 2026 11:16pm

[jklein24]

• Add Ethereum L1 external accounts and payment instructions #286 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

✱ Stainless preview builds

This PR will update the grid SDKs with the following commit messages.

kotlin

feat(api): add ethereum wallet to external accounts and payment instructions

openapi

feat(api): add Ethereum wallet types, remove Lightning account mapping

python

feat(api): add Ethereum wallet type to customers and payment instructions

typescript

feat(api): add Ethereum wallet type to external-accounts and quotes

✅ grid-openapi studio · code

Your SDK build had at least one "note" diagnostic.
generate ✅

⚠️ grid-python studio · code

Your SDK build had a failure in the lint CI job, which is a regression from the base state.
generate ✅ → build ✅ → lint ❗ → test ✅

pip install https://pkg.stainless.com/s/grid-python/c7991492473e7d8c232007fcbc1629f33937c5ae/grid-0.0.1-py3-none-any.whl

✅ grid-kotlin studio · code

Your SDK build had at least one "note" diagnostic.
generate ✅ → build ✅ → lint ✅ → test ✅

⚠️ grid-typescript studio · code

Your SDK build had a failure in the lint CI job, which is a regression from the base state.
generate ✅ → build ✅ → lint ❗ → test ✅

npm install https://pkg.stainless.com/s/grid-typescript/edbd0fcdedbcd982320b3f6a7c9653475c7accc6/dist.tar.gz

---

This comment is auto-generated by GitHub Actions and is automatically kept up to date as you push.
If you push custom code to the preview branch, re-run this workflow to update the comment.
Last updated: 2026-03-21 00:25:41 UTC

[greptile-apps]

Greptile Summary

This PR adds Ethereum L1 mainnet as a new payment rail, introducing ETHEREUM_WALLET as a valid value in both PaymentAccountType and ExternalAccountType. It also incidentally removes an erroneous LIGHTNING_ACCOUNT discriminator mapping key (the correct enum value has always been LIGHTNING, which is preserved).

Key changes:

• New EthereumWalletInfo base schema (openapi/components/schemas/common/EthereumWalletInfo.yaml) reused by both payment instructions and external accounts — avoids duplication, consistent with how BaseWalletInfo is shared.
• New PaymentEthereumWalletInfo schema composing BasePaymentAccountInfo + EthereumWalletInfo with an optional USDC assetType field — mirrors the structure of PaymentBaseWalletInfo and PaymentPolygonWalletInfo.
• New EthereumWalletExternalAccountInfo schema composing BaseExternalAccountInfo + EthereumWalletInfo — mirrors BaseWalletExternalAccountInfo.
• Both PaymentInstructions and ExternalAccountInfoOneOf discriminators updated with the new ETHEREUM_WALLET mapping.
• Bundled files (openapi.yaml and mintlify/openapi.yaml) are in sync with the source changes.
• All issues flagged in the previous review round (wrong title, missing trailing newline, bundled file out of sync) have been addressed.

Confidence Score: 5/5

• This PR is safe to merge — all changes are additive OpenAPI schema additions following well-established patterns in the repo.
• All new schemas are structurally consistent with their analogues (BaseWalletInfo, PaymentBaseWalletInfo, BaseWalletExternalAccountInfo). The discriminator mappings are correctly updated in both source and bundled files. Previous review issues (title, trailing newline, stale bundle) have all been resolved. The removal of the LIGHTNING_ACCOUNT stale mapping entry is a correct cleanup.
• No files require special attention.

Important Files Changed

Filename	Overview
openapi/components/schemas/common/EthereumWalletInfo.yaml	New base schema for Ethereum L1 wallet address, following the same structure as BaseWalletInfo.yaml. Required fields (address, accountType) are correctly declared. Trailing newline is present.
openapi/components/schemas/common/PaymentEthereumWalletInfo.yaml	New payment instruction schema composing BasePaymentAccountInfo and EthereumWalletInfo, with an optional assetType field limited to USDC. Title is correctly set to Ethereum Wallet, consistent with other Payment*WalletInfo schemas.
openapi/components/schemas/external_accounts/EthereumWalletExternalAccountInfo.yaml	New external account schema composing BaseExternalAccountInfo and EthereumWalletInfo. Follows the same pattern as BaseWalletExternalAccountInfo.yaml. Trailing newline is present.
openapi/components/schemas/external_accounts/ExternalAccountInfoOneOf.yaml	Adds EthereumWalletExternalAccountInfo to the oneOf list and discriminator mapping. Also removes the erroneous LIGHTNING_ACCOUNT discriminator key (the correct enum value is LIGHTNING, which remains intact at line 64).
openapi/components/schemas/common/PaymentInstructions.yaml	Correctly adds PaymentEthereumWalletInfo to both the oneOf list and discriminator mapping. No ordering or structural issues.
openapi.yaml	Bundled file correctly reflects all source changes: new EthereumWalletInfo and PaymentEthereumWalletInfo schemas with correct titles, updated PaymentInstructions and ExternalAccountInfoOneOf discriminator mappings, and removal of the erroneous LIGHTNING_ACCOUNT mapping key.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[API Client] -->|accountType: ETHEREUM_WALLET| B{Discriminator}

    B -->|PaymentInstructions| C[PaymentEthereumWalletInfo]
    B -->|ExternalAccount| D[EthereumWalletExternalAccountInfo]

    C --> E[BasePaymentAccountInfo\ncurrency, amount, etc.]
    C --> F[EthereumWalletInfo\naddress, accountType]
    C --> G[assetType: USDC]

    D --> H[BaseExternalAccountInfo\nid, accountType, etc.]
    D --> F

    style F fill:#f0f4ff,stroke:#4a6fa5
    style C fill:#e8f5e9,stroke:#2e7d32
    style D fill:#fff3e0,stroke:#e65100

Loading

_{Last reviewed commit: "Re-build"}

[jklein24]

@greptile please re-review and re-score

[jklein24]

Merge activity

• Mar 21, 12:19 AM UTC: @jklein24 merged this pull request with Graphite.