From 92998161d6ec82c5ccdd575412dd36e3b4de762d Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 30 Jul 2026 20:24:18 +0000 Subject: [PATCH 1/2] docs: document Ethereum L1 external accounts and funding 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 Claude-Session: https://claude.ai/code/session_01MMnjJ8yWJsui7jLqqrDrL4 --- .../introduction/platform-capabilities.mdx | 2 +- mintlify/snippets/external-accounts.mdx | 24 +++++++++++++++++++ mintlify/snippets/internal-accounts.mdx | 16 +++++++++++++ mintlify/snippets/sending/cross-currency.mdx | 1 + 4 files changed, 42 insertions(+), 1 deletion(-) diff --git a/mintlify/platform-overview/introduction/platform-capabilities.mdx b/mintlify/platform-overview/introduction/platform-capabilities.mdx index dcc8ce94a..422908e73 100644 --- a/mintlify/platform-overview/introduction/platform-capabilities.mdx +++ b/mintlify/platform-overview/introduction/platform-capabilities.mdx @@ -47,7 +47,7 @@ Convert fiat currency to Bitcoin or stablecoins with instant delivery to self-cu - On-ramp: Bank account → Crypto - Support for BTC, USDC, USDT, and more - Lightning Network for instant Bitcoin delivery -- Self-custody wallet support (Spark, Solana, Tron, Base, Polygon, etc.) +- Self-custody wallet support (Spark, Solana, Tron, Base, Polygon, Ethereum, etc.) - Just-in-time funding with payment instructions **Common Use Cases:** diff --git a/mintlify/snippets/external-accounts.mdx b/mintlify/snippets/external-accounts.mdx index 461760d5e..a0c546fec 100644 --- a/mintlify/snippets/external-accounts.mdx +++ b/mintlify/snippets/external-accounts.mdx @@ -851,6 +851,30 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/customers/external-acco Spark wallets don't require beneficiary information as they are self-custody wallets. + +**Ethereum L1 Wallet** + +Use an Ethereum L1 wallet to pay out stablecoins on Ethereum mainnet. Provide the wallet's `0x` address and set `currency` to the stablecoin the account holds — Ethereum L1 supports `USDC` and `USDT`. + +```bash cURL +curl -X POST 'https://api.lightspark.com/grid/2025-10-13/customers/external-accounts' \ + -H 'Authorization: Basic $GRID_CLIENT_ID:$GRID_CLIENT_SECRET' \ + -H 'Content-Type: application/json' \ + -d '{ + "currency": "USDC", + "platformAccountId": "usdc_ethereum_001", + "accountInfo": { + "accountType": "ETHEREUM_WALLET", + "address": "0xAbCDEF1234567890aBCdEf1234567890ABcDef12" + } + }' +``` + + + Ethereum L1 wallets are self-custody, so they don't require beneficiary information. Send only + Ethereum mainnet assets to this address — an Ethereum L1 address looks identical to an address on + other EVM networks such as Base or Polygon, but funds sent on the wrong network are unrecoverable. + Use `platformAccountId` to tie your internal id with the external account. diff --git a/mintlify/snippets/internal-accounts.mdx b/mintlify/snippets/internal-accounts.mdx index a2fc07a9f..09261ec9a 100644 --- a/mintlify/snippets/internal-accounts.mdx +++ b/mintlify/snippets/internal-accounts.mdx @@ -252,6 +252,22 @@ Each internal account includes `fundingPaymentInstructions` that tell your custo } ``` + + + For Ethereum L1 wallet accounts, using an Ethereum wallet as the funding source: + + ```json + { + "accountOrWalletInfo": { + "accountType": "ETHEREUM_WALLET", + "assetType": "USDC", + "address": "0xAbCDEF1234567890aBCdEf1234567890ABcDef12" + } + } + ``` + + Ethereum L1 accepts both `USDC` and `USDT` as `assetType`. + ## Checking account balances diff --git a/mintlify/snippets/sending/cross-currency.mdx b/mintlify/snippets/sending/cross-currency.mdx index efdcf7c27..74ebeb2ef 100644 --- a/mintlify/snippets/sending/cross-currency.mdx +++ b/mintlify/snippets/sending/cross-currency.mdx @@ -182,6 +182,7 @@ Cross-currency transfers support funding via USDC and BTC on popular blockchains | Base | USDC | | Tron | USDT | | Polygon | USDC | +| Ethereum | USDC, USDT | | Lightning | BTC | | Spark | BTC | From bbfeb06d637f102cbe1766e0d14d866ebd8b877c Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 30 Jul 2026 21:52:39 +0000 Subject: [PATCH 2/2] Narrow to the enumerations: drop Ethereum-only examples 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 Claude-Session: https://claude.ai/code/session_01MMnjJ8yWJsui7jLqqrDrL4 --- mintlify/snippets/external-accounts.mdx | 24 ------------------------ mintlify/snippets/internal-accounts.mdx | 16 ---------------- 2 files changed, 40 deletions(-) diff --git a/mintlify/snippets/external-accounts.mdx b/mintlify/snippets/external-accounts.mdx index a0c546fec..461760d5e 100644 --- a/mintlify/snippets/external-accounts.mdx +++ b/mintlify/snippets/external-accounts.mdx @@ -851,30 +851,6 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/customers/external-acco Spark wallets don't require beneficiary information as they are self-custody wallets. - -**Ethereum L1 Wallet** - -Use an Ethereum L1 wallet to pay out stablecoins on Ethereum mainnet. Provide the wallet's `0x` address and set `currency` to the stablecoin the account holds — Ethereum L1 supports `USDC` and `USDT`. - -```bash cURL -curl -X POST 'https://api.lightspark.com/grid/2025-10-13/customers/external-accounts' \ - -H 'Authorization: Basic $GRID_CLIENT_ID:$GRID_CLIENT_SECRET' \ - -H 'Content-Type: application/json' \ - -d '{ - "currency": "USDC", - "platformAccountId": "usdc_ethereum_001", - "accountInfo": { - "accountType": "ETHEREUM_WALLET", - "address": "0xAbCDEF1234567890aBCdEf1234567890ABcDef12" - } - }' -``` - - - Ethereum L1 wallets are self-custody, so they don't require beneficiary information. Send only - Ethereum mainnet assets to this address — an Ethereum L1 address looks identical to an address on - other EVM networks such as Base or Polygon, but funds sent on the wrong network are unrecoverable. - Use `platformAccountId` to tie your internal id with the external account. diff --git a/mintlify/snippets/internal-accounts.mdx b/mintlify/snippets/internal-accounts.mdx index 09261ec9a..a2fc07a9f 100644 --- a/mintlify/snippets/internal-accounts.mdx +++ b/mintlify/snippets/internal-accounts.mdx @@ -252,22 +252,6 @@ Each internal account includes `fundingPaymentInstructions` that tell your custo } ``` - - - For Ethereum L1 wallet accounts, using an Ethereum wallet as the funding source: - - ```json - { - "accountOrWalletInfo": { - "accountType": "ETHEREUM_WALLET", - "assetType": "USDC", - "address": "0xAbCDEF1234567890aBCdEf1234567890ABcDef12" - } - } - ``` - - Ethereum L1 accepts both `USDC` and `USDT` as `assetType`. - ## Checking account balances