From 3ca69379822846d8f40697eb116eeea8d68e2a2e Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Sat, 21 Mar 2026 08:15:02 +0000 Subject: [PATCH] docs: Sync documentation with Ethereum L1 and currency schema changes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Updates Grid Visualizer and Mintlify docs to reflect recent OpenAPI changes: - Add ETHEREUM_WALLET support to account-types.ts and crypto.ts for USDC - Add missing fiat currencies: AED (UAE), BWP (Botswana), XAF (Central Africa) - Add Ethereum L1 wallet example to external-accounts.mdx snippet - Fix invalid businessType example (FINTECH → FINANCE_AND_INSURANCE) Syncs with commits 9400e77 (Ethereum L1), afa928d (KYB schema), 5614055 (BRL). Co-Authored-By: Claude Opus 4.5 --- .../grid-visualizer/src/data/account-types.ts | 35 +++++++++++++++++++ components/grid-visualizer/src/data/crypto.ts | 1 + .../grid-visualizer/src/data/currencies.ts | 30 ++++++++++++++++ mintlify/openapi.yaml | 2 +- mintlify/snippets/external-accounts.mdx | 24 ++++++++++++- openapi.yaml | 2 +- openapi/paths/customers/customers.yaml | 2 +- 7 files changed, 92 insertions(+), 4 deletions(-) diff --git a/components/grid-visualizer/src/data/account-types.ts b/components/grid-visualizer/src/data/account-types.ts index 82983eea..bb79ea3f 100644 --- a/components/grid-visualizer/src/data/account-types.ts +++ b/components/grid-visualizer/src/data/account-types.ts @@ -277,4 +277,39 @@ export const accountTypeSpecs: Record = { ], beneficiaryRequired: false, }, + ETHEREUM_WALLET: { + accountType: 'ETHEREUM_WALLET', + fields: [ + { name: 'address', example: '0xAbCDEF1234567890aBCdEf1234567890ABcDef12' }, + ], + beneficiaryRequired: false, + }, + AED_ACCOUNT: { + accountType: 'AED_ACCOUNT', + fields: [ + { name: 'iban', example: 'AE070331234567890123456' }, + { name: 'swiftCode', example: 'EBILAEAD', description: 'Optional' }, + ], + paymentRails: ['BANK_TRANSFER'], + beneficiaryRequired: true, + }, + BWP_ACCOUNT: { + accountType: 'BWP_ACCOUNT', + fields: [ + { name: 'phoneNumber', example: '+26771234567' }, + { name: 'provider', example: 'ORANGE', description: 'Mobile money provider' }, + ], + paymentRails: ['MOBILE_MONEY'], + beneficiaryRequired: true, + }, + XAF_ACCOUNT: { + accountType: 'XAF_ACCOUNT', + fields: [ + { name: 'phoneNumber', example: '+237612345678' }, + { name: 'provider', example: 'MTN', description: 'Mobile money provider' }, + { name: 'region', example: 'CM', description: 'Country code (CM or CG)' }, + ], + paymentRails: ['MOBILE_MONEY'], + beneficiaryRequired: true, + }, }; diff --git a/components/grid-visualizer/src/data/crypto.ts b/components/grid-visualizer/src/data/crypto.ts index 7be2af25..60b9f980 100644 --- a/components/grid-visualizer/src/data/crypto.ts +++ b/components/grid-visualizer/src/data/crypto.ts @@ -33,6 +33,7 @@ export const cryptoAssets: CryptoAsset[] = [ { type: 'SOLANA_WALLET', label: 'Wallet', network: 'Solana' }, { type: 'POLYGON_WALLET', label: 'Wallet', network: 'Polygon' }, { type: 'BASE_WALLET', label: 'Wallet', network: 'Base' }, + { type: 'ETHEREUM_WALLET', label: 'Wallet', network: 'Ethereum' }, ], examplePerson: { fullName: 'Alex Rivera', nationality: 'US' }, }, diff --git a/components/grid-visualizer/src/data/currencies.ts b/components/grid-visualizer/src/data/currencies.ts index fc14d4a4..0c521b04 100644 --- a/components/grid-visualizer/src/data/currencies.ts +++ b/components/grid-visualizer/src/data/currencies.ts @@ -255,4 +255,34 @@ export const currencies: FiatCurrency[] = [ allRails: ['Mobile Money'], examplePerson: { fullName: 'Amadou Diallo', nationality: 'SN' }, }, + { + code: 'AED', + name: 'UAE Dirham', + countryCode: 'ae', + accountType: 'AED_ACCOUNT', + accountLabel: 'UAE Bank Account', + instantRails: [], + allRails: ['Bank Transfer'], + examplePerson: { fullName: 'Ahmed Al-Rashid', nationality: 'AE' }, + }, + { + code: 'BWP', + name: 'Botswana Pula', + countryCode: 'bw', + accountType: 'BWP_ACCOUNT', + accountLabel: 'Mobile Money', + instantRails: [], + allRails: ['Mobile Money'], + examplePerson: { fullName: 'Kelebogile Mosweu', nationality: 'BW' }, + }, + { + code: 'XAF', + name: 'Central African CFA Franc', + countryCode: 'cm', + accountType: 'XAF_ACCOUNT', + accountLabel: 'Mobile Money', + instantRails: [], + allRails: ['Mobile Money'], + examplePerson: { fullName: 'Jean-Pierre Mbarga', nationality: 'CM' }, + }, ]; diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml index ff99e5eb..7621bc25 100644 --- a/mintlify/openapi.yaml +++ b/mintlify/openapi.yaml @@ -296,7 +296,7 @@ paths: taxId: 47-1234567 countriesOfOperation: - US - businessType: FINTECH + businessType: FINANCE_AND_INSURANCE purposeOfAccount: Payout to contractors sourceOfFunds: Funds derived from customer payments for software services expectedMonthlyTransactionCount: 100_TO_500 diff --git a/mintlify/snippets/external-accounts.mdx b/mintlify/snippets/external-accounts.mdx index 8f860553..d5e752bf 100644 --- a/mintlify/snippets/external-accounts.mdx +++ b/mintlify/snippets/external-accounts.mdx @@ -432,7 +432,7 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/customers/external-acco - + **Bitcoin Lightning (Spark Wallet)** ```bash cURL @@ -453,6 +453,28 @@ 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 (USDC)** + +```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_eth_001", + "accountInfo": { + "accountType": "ETHEREUM_WALLET", + "address": "0xAbCDEF1234567890aBCdEf1234567890ABcDef12" + } + }' +``` + + + Ethereum wallets support USDC on Ethereum L1. No beneficiary information required. + + Use `platformAccountId` to tie your internal id with the external account. diff --git a/openapi.yaml b/openapi.yaml index ff99e5eb..7621bc25 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -296,7 +296,7 @@ paths: taxId: 47-1234567 countriesOfOperation: - US - businessType: FINTECH + businessType: FINANCE_AND_INSURANCE purposeOfAccount: Payout to contractors sourceOfFunds: Funds derived from customer payments for software services expectedMonthlyTransactionCount: 100_TO_500 diff --git a/openapi/paths/customers/customers.yaml b/openapi/paths/customers/customers.yaml index d1726db8..4551c3f1 100644 --- a/openapi/paths/customers/customers.yaml +++ b/openapi/paths/customers/customers.yaml @@ -38,7 +38,7 @@ post: taxId: 47-1234567 countriesOfOperation: - US - businessType: FINTECH + businessType: FINANCE_AND_INSURANCE purposeOfAccount: Payout to contractors sourceOfFunds: Funds derived from customer payments for software services expectedMonthlyTransactionCount: 100_TO_500