feat: change cryptoNetwork from string to enum, truncate environment postfix

Creates a shared CryptoNetwork enum schema with values: BITCOIN, ETHEREUM,
SOLANA, BASE, SPARK, LIGHTNING. The environment (mainnet/testnet) is now
determined by which API environment the request targets, removing the
_MAINNET/_TESTNET/_DEVNET/_REGTEST suffixes.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: pengying

mintlify/openapi.yaml

@@ -0,0 +1,21 @@
+type: string
+description: |
+  The blockchain network identifier. The environment (mainnet vs testnet) is determined
+  automatically based on whether the request is made against the production or sandbox API.
+
+  | Value | Production | Sandbox |
+  |-------|------------|---------|
+  | BITCOIN | Bitcoin mainnet | Bitcoin testnet |
+  | ETHEREUM | Ethereum mainnet | Ethereum Sepolia |
+  | SOLANA | Solana mainnet | Solana devnet |
+  | BASE | Base mainnet | Base Sepolia |
+  | SPARK | Spark mainnet | Spark testnet |
+  | LIGHTNING | Lightning mainnet | Lightning regtest |
+enum:
+  - BITCOIN
+  - ETHEREUM
+  - SOLANA
+  - BASE
+  - SPARK
+  - LIGHTNING
+example: SOLANA

openapi.yaml

@@ -15,13 +15,7 @@ properties:
     description: The currency code of the asset to withdraw (e.g. USDC).
     example: USDC
   cryptoNetwork:
-    type: string
-    description: >-
-      The blockchain network for the withdrawal. Example values: SOLANA_MAINNET,
-      SOLANA_DEVNET, ETHEREUM_MAINNET, ETHEREUM_TESTNET, BASE_MAINNET,
-      BASE_TESTNET, SPARK_MAINNET, SPARK_TESTNET, LIGHTNING_MAINNET,
-      LIGHTNING_REGTEST.
-    example: SOLANA_MAINNET
+    $ref: ./CryptoNetwork.yaml
   amount:
     type: integer
     description: The amount to withdraw in the smallest unit of the currency.

openapi/components/schemas/crypto/CryptoNetwork.yaml

@@ -41,12 +41,6 @@ allOf:
         $ref: ./BeneficiaryVerifiedData.yaml
         description: Verified beneficiary data returned by the payment rail, if available
       cryptoNetwork:
-        type: string
-        description: >-
-          The blockchain network for this external account, if applicable. Present when the account
-          is a cryptocurrency wallet. Example values: SOLANA_MAINNET, SOLANA_DEVNET,
-          ETHEREUM_MAINNET, ETHEREUM_TESTNET, BASE_MAINNET, BASE_TESTNET,
-          SPARK_MAINNET, SPARK_TESTNET, LIGHTNING_MAINNET, LIGHTNING_REGTEST.
-        example: SOLANA_MAINNET
+        $ref: ../crypto/CryptoNetwork.yaml
       accountInfo:
         $ref: ./ExternalAccountInfoOneOf.yaml

openapi/components/schemas/crypto/EstimateCryptoWithdrawalFeeRequest.yaml

@@ -29,13 +29,6 @@ allOf:
           incoming UMA payments will be deposited into the primary internal account for the customer.
         default: false
       cryptoNetwork:
-        type: string
-        description: >-
-          The blockchain network for this external account. Required when the account is a
-          cryptocurrency wallet. Specifies which network the wallet is on. Example values:
-          SOLANA_MAINNET, SOLANA_DEVNET, ETHEREUM_MAINNET, ETHEREUM_TESTNET,
-          BASE_MAINNET, BASE_TESTNET, SPARK_MAINNET, SPARK_TESTNET, LIGHTNING_MAINNET,
-          LIGHTNING_REGTEST.
-        example: SOLANA_MAINNET
+        $ref: ../crypto/CryptoNetwork.yaml
       accountInfo:
         $ref: ./ExternalAccountInfoOneOf.yaml

openapi/components/schemas/external_accounts/ExternalAccount.yaml

@@ -24,15 +24,12 @@ allOf:
           for the full list of supported fiat and crypto currencies.
         example: USD
       cryptoNetwork:
-        type: string
-        description: >-
-          The crypto network to use for the funding source. Required when `currency` is a
-          stablecoin (e.g. USDC, USDT). Specifies which network the customer will deposit
-          on, so the correct deposit address can be generated. Example values:
-          `SOLANA_MAINNET`, `SOLANA_DEVNET`, `ETHEREUM_MAINNET`, `ETHEREUM_TESTNET`,
-          `BASE_MAINNET`, `BASE_TESTNET`, `SPARK_MAINNET`, `SPARK_TESTNET`,
-          `LIGHTNING_MAINNET`, `LIGHTNING_REGTEST`.
-        example: SOLANA_MAINNET
+        allOf:
+          - $ref: ../crypto/CryptoNetwork.yaml
+          - description: >-
+              The crypto network to use for the funding source. Required when `currency` is a
+              stablecoin (e.g. USDC, USDT). Specifies which network the customer will deposit
+              on, so the correct deposit address can be generated.
     description: >-
       Fund the quote using a real-time funding source (RTP, SEPA Instant, Spark, Stables, etc.).
       This will require manual just-in-time funding using `paymentInstructions` in the response.

openapi/components/schemas/external_accounts/ExternalAccountCreateRequest.yaml

@@ -21,7 +21,7 @@ post:
             value:
               internalAccountId: InternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123
               currency: USDC
-              cryptoNetwork: SOLANA_MAINNET
+              cryptoNetwork: SOLANA
               amount: 1000000
               destinationAddress: 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
   responses: