mudbase 1.2.12 → 1.3.0

data/spec/api/wallet_api_spec.rb

@@ -1,9 +1,9 @@
 =begin
 #MUDBASESDK
 
-#MUDBASE is a scalable, real-time, and secure Backend-as-a-Service (BaaS) platform  designed for modern applications. Built with custom logic, it offers fine-grained  control, extensibility, and enterprise-grade security.  ## Features - 🔐 Multi-provider authentication (30+ OAuth providers) - 📊 Real-time database with collections - 📁 File storage and management - 🔑 API key management with permissions - 🔗 Webhook system with retry logic - ⚡ Serverless functions - 💬 Multi-channel messaging (Push, Email, SMS) - 📈 Usage analytics and monitoring - 🌐 Real-time WebSocket events - 🔍 Full-text search capabilities - 💳 Billing: Flutterwave for fiat (platform subscriptions and payment processing with 7% + $0.50 split); crypto payment processor for multi-chain checkout - 📡 Block-based multi-chain wallet monitoring (ETH/UTXO scanners, GetBlock, scanner metrics API) 
+#MUDBASE is a scalable, real-time, and secure Backend-as-a-Service (BaaS) platform  designed for modern applications. Built with custom logic, it offers fine-grained  control, extensibility, and enterprise-grade security.  ## Features - 🔐 Multi-provider authentication (30+ OAuth providers) - 📊 Real-time database with collections - 📁 File storage and management - 🔑 API key management with permissions - 🔗 Webhook system with retry logic - ⚡ Serverless functions - 💬 Multi-channel messaging (Push, Email, SMS) - 📈 Usage analytics and monitoring - 🌐 Real-time WebSocket events - 🔍 Full-text search capabilities - 💳 Billing: fiat only for project subscriptions and org BaaS checkout (platform fee split). On-chain billing is not exposed on these APIs (optional `crypto-payment-module/` in repo, not mounted by default). - 📡 Block-based multi-chain wallet monitoring (ETH/UTXO scanners, GetBlock, scanner metrics API) - 🏢 Enterprise / Phase 4: custom domains on Growth, Scale, and Enterprise (TXT DNS at `_mudbase-verify.<hostname>`); `settings.customDomainAddon` is optional (billing/legacy); dedicated DB migration script, periodic DNS recheck job, optional `infrastructureEnvironments[]` and edge/metering fields on `dedicated`. 
 
-The version of the OpenAPI document: 1.2.12
+The version of the OpenAPI document: 1.3.0
 Contact: support@mudbase.dev
 Generated by: https://openapi-generator.tech
 Generator version: 7.20.0
@@ -32,211 +32,406 @@ describe 'WalletApi' do
     end
   end
 
-  # unit tests for wallet_broadcast_transaction
+  # unit tests for broadcast_non_custodial_transaction
   # Broadcast a client-signed transaction
   # Broadcast a transaction that has been signed client-side. The transaction must be fully signed before sending. The fromAddress must be registered and belong to your organization (POST /api/wallet/non-custodial/register-address). **Supported chains:** EVM (ethereum, polygon, arbitrum, optimism, base, bsc, binance, avalanche, celo), UTXO (bitcoin, litecoin, dogecoin), and chain-specific (tron, solana, ton, cardano). Use &#x60;binance&#x60; or &#x60;bsc&#x60; for BNB Smart Chain. **Testing with custodial:** You can create a wallet via POST /api/wallet/create, get its private key via GET /api/wallet/{walletId}/private-key, register that address with POST /api/wallet/non-custodial/register-address, then build a signed tx (using POST /api/wallet/estimate-network-fee or estimate-gas for fees) and broadcast it here to test the non-custodial flow end-to-end. 
-  # @param wallet_broadcast_transaction_request Chain, signed transaction (hex), and fromAddress (must be registered).
+  # @param broadcast_non_custodial_transaction_request 
   # @param [Hash] opts the optional parameters
-  # @return [WalletBroadcastTransaction200Response]
-  describe 'wallet_broadcast_transaction test' do
+  # @return [BroadcastNonCustodialTransaction200Response]
+  describe 'broadcast_non_custodial_transaction test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for wallet_create_webhook
+  # unit tests for calculate_wallet_fee
+  # Get network fee only (alias for POST /api/wallet/estimate-network-fee)
+  # Returns **network fee only**, estimated from the blockchain (RPC / fee APIs). No platform fee or project fee. **Same as POST /api/wallet/estimate-network-fee.** Prefer estimate-network-fee for clarity. Supported currencies: BTC, ETH, BNB, LTC, SOL, TRX, USDT, MATIC, AVAX, CELO, DOGE, TON, ADA. For USDT, &#x60;network&#x60; is required (ETH, BSC, TRX, SOL, POLYGON). Use &#x60;?fresh&#x3D;1&#x60; or header &#x60;X-Fee-Fresh: true&#x60; for a fresh estimate (bypass cache) right before building the transaction for broadcast. 
+  # @param estimate_network_fee_request 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :fresh Bypass cache and fetch current fee (use right before building tx for broadcast)
+  # @return [CalculateWalletFee200Response]
+  describe 'calculate_wallet_fee test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for create_wallet
+  # Create new wallet (for testing non-custodial)
+  # Create a custodial wallet. **Custodial is not used in production.** Use this to **test non-custodial flows**: create a wallet, get its private key (GET /api/wallet/{walletId}/private-key), register the same address with POST /api/wallet/non-custodial/register-address, then use estimate-network-fee and POST /api/wallet/non-custodial/broadcast to build and send a signed transaction. Transaction monitoring (pending/confirmed) applies to both custodial and non-custodial WalletTransaction records. 
+  # @param create_wallet_request 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateWallet201Response]
+  describe 'create_wallet test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for create_wallet_webhook
   # Create a wallet webhook
-  # Register a webhook URL to receive wallet events (balance updates, transaction confirmed/failed/detected/broadcast, token balance, address created/deactivated). Optional filters by addresses and chains. 
-  # @param wallet_create_webhook_request Webhook URL, events array, optional secret and filters (addresses, chains, projectId).
+  # @param create_wallet_webhook_request 
   # @param [Hash] opts the optional parameters
-  # @return [WalletCreateWebhook201Response]
-  describe 'wallet_create_webhook test' do
+  # @return [CreateWalletWebhook201Response]
+  describe 'create_wallet_webhook test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for wallet_delete_address
-  # Delete (soft-delete) a non-custodial address
-  # Soft-deletes a registered non-custodial address. The address is marked inactive and no longer used for broadcasts or balance/transaction queries. 
-  # @param address_id Registered address ID to delete.
+  # unit tests for delete_non_custodial_address
+  # Delete or deactivate a monitored wallet address
+  # **Soft delete (default):** Omit **permanent** or set to false. The address is deactivated (isActive &#x3D; false); it no longer appears in list or receives monitoring but the record remains for audit. **Permanent delete:** Set query **permanent&#x3D;true** to remove the address record from the database. Use when you need to fully remove the monitored address. 
+  # @param address_id 
   # @param [Hash] opts the optional parameters
-  # @return [FunctionsDelete200Response]
-  describe 'wallet_delete_address test' do
+  # @option opts [Boolean] :permanent If true, permanently delete the address from the database; if false or omitted, only deactivate (soft delete)
+  # @return [DeleteFunction200Response]
+  describe 'delete_non_custodial_address test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for wallet_delete_webhook
+  # unit tests for delete_wallet_webhook
   # Delete a wallet webhook
-  # Permanently delete a wallet webhook. Delivery will stop immediately.
-  # @param webhook_id Webhook ID (MongoDB ObjectId) to delete.
+  # @param webhook_id 
+  # @param [Hash] opts the optional parameters
+  # @return [DeleteFunction200Response]
+  describe 'delete_wallet_webhook test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for estimate_network_fee
+  # Estimate network fee (preferred; reads from fee oracle cache)
+  # Returns **network fee only** from the blockchain. **Preferred endpoint** for network fee. Uses a fee oracle: fees are polled every 15–20s and cached, so responses are fast and RPC load is minimal (same strategy as large wallets). No platform fee. Request/response identical to POST /api/wallet/calculate-fee (which is an alias). See docs/FEE_ARCHITECTURE.md. Supported currencies: BTC, ETH, BNB, LTC, SOL, TRX, USDT, MATIC, AVAX, CELO, DOGE, TON, ADA. For USDT, &#x60;network&#x60; is required (ETH, BSC, TRX, SOL, POLYGON). **Fresh fee before broadcast:** To avoid stuck transactions, get a fresh estimate right before building/signing: use query &#x60;?fresh&#x3D;1&#x60; or header &#x60;X-Fee-Fresh: true&#x60; to bypass cache. 
+  # @param estimate_network_fee_request 
   # @param [Hash] opts the optional parameters
-  # @return [FunctionsDelete200Response]
-  describe 'wallet_delete_webhook test' do
+  # @option opts [String] :fresh Bypass cache and fetch current fee from RPC/fee API (use right before building tx for broadcast)
+  # @return [EstimateNetworkFee200Response]
+  describe 'estimate_network_fee test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for wallet_estimate_gas
+  # unit tests for estimate_non_custodial_gas
   # Estimate network fee from blockchain (all supported chains; not controlled by Mudbase)
   # **Network fee (from blockchain only).** Returns network fee **estimated directly from the blockchain** via RPC or fee APIs. **Not controlled by Mudbase.** Both POST /api/wallet/estimate-network-fee (or calculate-fee) and this endpoint return network fee only; use either for gas/fee display. This endpoint is chain-oriented and supports full transaction shape for EVM. **EVM chains:** ethereum, polygon, arbitrum, optimism, base, bsc, binance, avalanche, celo — require &#x60;transaction&#x60; (from, and to/value or tokenAddress/amount). Response includes gasLimit, gasPrice, networkFee, estimatedTime, currency. **Non-EVM chains:** bitcoin, litecoin, dogecoin, solana, tron, ton, cardano — only &#x60;chain&#x60; is required; &#x60;transaction&#x60; is optional/ignored. Returns networkFee, estimatedTime, currency (and e.g. satPerVb for UTXO). See docs/FEE_ARCHITECTURE.md. Results cached 15s. 
-  # @param wallet_estimate_gas_request Chain and optional transaction shape (required for EVM). Returns network fee from blockchain.
+  # @param estimate_non_custodial_gas_request 
   # @param [Hash] opts the optional parameters
-  # @return [WalletEstimateGas200Response]
-  describe 'wallet_estimate_gas test' do
+  # @return [EstimateNonCustodialGas200Response]
+  describe 'estimate_non_custodial_gas test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for wallet_get_address
-  # Get non-custodial address by ID
-  # Returns metadata and status for a single registered non-custodial address (ID, address, chain, label, org, project, derivationPath, isActive, timestamps). 
-  # @param address_id Registered address ID (MongoDB ObjectId).
+  # unit tests for generate_private_key
+  # Generate private key
+  # @param generate_private_key_request 
   # @param [Hash] opts the optional parameters
-  # @return [NonCustodialAddressResponse]
-  describe 'wallet_get_address test' do
+  # @return [GeneratePrivateKey200Response]
+  describe 'generate_private_key test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for wallet_get_balance
-  # Get balance for a non-custodial address
-  # Returns native token balance (confirmed, unconfirmed, total, currency) for a registered non-custodial address. Updated periodically from the chain. 
-  # @param address_id Registered address ID.
+  # unit tests for get_all_fees
+  # Get all chain network fees (fee oracle snapshot)
+  # Returns **all chain network fees** in one call. Reads from the fee oracle cache (no RPC during the request). Each chain returns the **full fee object** (networkFee, gasPriceGwei, congestion, estimatedTime, feeTiers for EVM, etc.) for frontend/UX. Use for dashboards or \&quot;current fees\&quot; screens. 
   # @param [Hash] opts the optional parameters
-  # @return [WalletGetBalance200Response]
-  describe 'wallet_get_balance test' do
+  # @return [GetAllFees200Response]
+  describe 'get_all_fees test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for wallet_get_cancel_params
+  # unit tests for get_balance
+  # Get wallet balance
+  # @param wallet_id 
+  # @param [Hash] opts the optional parameters
+  # @return [GetBalance200Response]
+  describe 'get_balance test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for get_cancel_params
   # Get replacement tx params for cancel (stuck EVM tx)
   # Returns **replacement transaction params** to cancel a stuck EVM transaction (same nonce, to&#x3D;self, value&#x3D;0, data&#x3D;0x, higher gas). Client signs and broadcasts via POST /api/wallet/non-custodial/broadcast. Address must be registered for your organization. EVM chains only. 
-  # @param wallet_get_cancel_params_request Stuck transaction identifier (txId or txHash) and EVM chain for cancel.
+  # @param get_cancel_params_request 
   # @param [Hash] opts the optional parameters
-  # @return [WalletGetCancelParams200Response]
-  describe 'wallet_get_cancel_params test' do
+  # @return [GetCancelParams200Response]
+  describe 'get_cancel_params test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for wallet_get_speed_up_params
-  # Get replacement tx params for speed-up (stuck EVM tx)
-  # Returns **replacement transaction params** for a stuck EVM transaction (same nonce, same to/value/data, higher gas). Client signs the replacement and broadcasts via POST /api/wallet/non-custodial/broadcast. Address must be registered for your organization. Use when a tx has been pending &gt;5 min (stuck). EVM chains only. 
-  # @param wallet_get_speed_up_params_request Stuck transaction identifier (txId or txHash) and EVM chain.
+  # unit tests for get_network_status
+  # Get network status (congestion + fee metric per chain)
+  # Returns **network status** per chain (congestion and main fee metric). Use to show network health before sending transactions. Same data as GET /fees but trimmed to congestion + gasPriceGwei (EVM) or satPerVb (UTXO) and networkFee. 
+  # @param [Hash] opts the optional parameters
+  # @return [GetNetworkStatus200Response]
+  describe 'get_network_status test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for get_non_custodial_address
+  # Get non-custodial address by ID
+  # @param address_id 
+  # @param [Hash] opts the optional parameters
+  # @return [NonCustodialAddressResponse]
+  describe 'get_non_custodial_address test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for get_non_custodial_balance
+  # Get balance for a non-custodial address
+  # @param address_id 
   # @param [Hash] opts the optional parameters
-  # @return [WalletGetSpeedUpParams200Response]
-  describe 'wallet_get_speed_up_params test' do
+  # @return [GetNonCustodialBalance200Response]
+  describe 'get_non_custodial_balance test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for wallet_get_transaction_by_hash
+  # unit tests for get_non_custodial_transaction_by_hash
   # Get transaction by hash
   # Returns a transaction by its hash. The **chain** query parameter is required because the same hash format can exist on different chains (e.g. 0x-style on EVM chains). 
   # @param tx_hash Transaction hash (e.g. 0x... for EVM, or block explorer format for UTXO)
   # @param chain Chain the transaction belongs to (required for lookup)
   # @param [Hash] opts the optional parameters
-  # @return [WalletGetTransactionByHash200Response]
-  describe 'wallet_get_transaction_by_hash test' do
+  # @return [GetNonCustodialTransactionByHash200Response]
+  describe 'get_non_custodial_transaction_by_hash test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for wallet_get_transactions
+  # unit tests for get_non_custodial_transactions
   # Get transaction history for a non-custodial address
-  # Returns paginated transaction history for a registered non-custodial address (incoming/outgoing, status, confirmations, amounts). 
-  # @param address_id Registered address ID.
+  # @param address_id 
+  # @param [Hash] opts the optional parameters
+  # @option opts [Integer] :limit 
+  # @option opts [Integer] :page 
+  # @return [GetNonCustodialTransactions200Response]
+  describe 'get_non_custodial_transactions test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for get_speed_up_params
+  # Get replacement tx params for speed-up (stuck EVM tx)
+  # Returns **replacement transaction params** for a stuck EVM transaction (same nonce, same to/value/data, higher gas). Client signs the replacement and broadcasts via POST /api/wallet/non-custodial/broadcast. Address must be registered for your organization. Use when a tx has been pending &gt;5 min (stuck). EVM chains only. 
+  # @param get_speed_up_params_request 
+  # @param [Hash] opts the optional parameters
+  # @return [GetSpeedUpParams200Response]
+  describe 'get_speed_up_params test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for get_supported_currencies
+  # Get supported currencies and chains
+  # Returns the list of **platform-supported cryptocurrencies and chains** for non-custodial wallets, broadcast, and multi-chain use. Custodial wallet is no longer used in production; this endpoint is the source of truth for supported chains and currencies. **Supported:** BTC, LTC, DOGE, ETH, ETC, CELO, SOL, TRX, TON, Polygon (MATIC), Arbitrum, Optimism, Base, BSC/BNB, Avalanche (AVAX), Cardano (ADA), USDT. Each item includes **code** (currency symbol), **name** (display name), **chain** (chain id for API calls). USDT includes **networks** (ETH, BSC, TRX, SOL, POLYGON). Use **chain** with non-custodial endpoints (register-address, broadcast, estimate-gas). Use **code** for display and fee/currency selection. This is a public endpoint - no authentication required. 
+  # @param [Hash] opts the optional parameters
+  # @return [GetSupportedCurrencies200Response]
+  describe 'get_supported_currencies test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for get_transaction
+  # Get transaction details
+  # @param transaction_id 
+  # @param [Hash] opts the optional parameters
+  # @return [GetTransaction200Response]
+  describe 'get_transaction test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for get_transaction_history
+  # Get transaction history (custodial wallets; same monitoring as non-custodial)
+  # Returns transaction history for custodial wallets. Transactions are stored and monitored the same way as non-custodial (WalletTransaction); status updates (pending, broadcast, confirmed, failed) and stuck detection apply to both. 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :wallet_id 
+  # @option opts [Integer] :limit 
+  # @option opts [Integer] :page 
+  # @return [GetTransactionHistory200Response]
+  describe 'get_transaction_history test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for get_user_wallets
+  # Get user wallets
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :project_id 
+  # @option opts [String] :currency 
+  # @return [GetUserWallets200Response]
+  describe 'get_user_wallets test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for get_wallet_fee_config
+  # Get project fee configuration (for non-custodial / external users)
+  # Get project-level fee settings (enabled flag and fee percentage). **For non-custodial / external users** — e.g. when your app charges a fee on payouts or transfers. Custodial wallet is no longer used in production. Applies to all supported chains/currencies for that project. 
+  # @param project_id Project ID
+  # @param [Hash] opts the optional parameters
+  # @return [GetWalletFeeConfig200Response]
+  describe 'get_wallet_fee_config test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for get_wallet_private_key
+  # Get wallet private key (WARNING: Sensitive data; for testing non-custodial)
+  # Returns the wallet private key. **For testing non-custodial only:** use this key to sign a transaction locally, then register the wallet address via POST /api/wallet/non-custodial/register-address and broadcast the signed tx via POST /api/wallet/non-custodial/broadcast. 
+  # @param wallet_id 
   # @param [Hash] opts the optional parameters
-  # @option opts [Integer] :limit Number of transactions per page.
-  # @option opts [Integer] :page Page number (1-based).
-  # @return [WalletGetTransactions200Response]
-  describe 'wallet_get_transactions test' do
+  # @return [GetWalletPrivateKey200Response]
+  describe 'get_wallet_private_key test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for wallet_get_webhook_logs
+  # unit tests for get_wallet_webhook_logs
   # Get webhook delivery logs
-  # List delivery attempts for a wallet webhook (success/failure, payload, response, duration). Paginated by limit.
-  # @param webhook_id Webhook ID (MongoDB ObjectId) to get logs for.
+  # @param webhook_id 
   # @param [Hash] opts the optional parameters
-  # @option opts [Integer] :limit Maximum number of log entries to return.
-  # @return [WalletGetWebhookLogs200Response]
-  describe 'wallet_get_webhook_logs test' do
+  # @option opts [Integer] :limit 
+  # @return [GetWalletWebhookLogs200Response]
+  describe 'get_wallet_webhook_logs test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for wallet_list_addresses
+  # unit tests for list_non_custodial_addresses
   # List registered non-custodial addresses
-  # Returns all non-custodial addresses registered for the current project/organization. Optional filters by chain and projectId. Addresses must be registered via POST /api/wallet/non-custodial/register-address before use. 
   # @param [Hash] opts the optional parameters
   # @option opts [String] :chain Filter by chain (optional)
-  # @option opts [String] :project_id Filter by project ID (optional).
-  # @return [WalletListAddresses200Response]
-  describe 'wallet_list_addresses test' do
+  # @option opts [String] :project_id 
+  # @return [ListNonCustodialAddresses200Response]
+  describe 'list_non_custodial_addresses test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for wallet_list_webhooks
+  # unit tests for list_wallet_webhooks
   # List wallet webhooks
-  # Returns all wallet webhooks for the current context, optionally filtered by projectId. Includes delivery stats and active status. 
   # @param [Hash] opts the optional parameters
-  # @option opts [String] :project_id Filter by project ID (optional).
-  # @return [WalletListWebhooks200Response]
-  describe 'wallet_list_webhooks test' do
+  # @option opts [String] :project_id 
+  # @return [ListWalletWebhooks200Response]
+  describe 'list_wallet_webhooks test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for wallet_register_address
+  # unit tests for register_non_custodial_address
   # Register a non-custodial wallet address
-  # Register a public wallet address for balance monitoring, transaction indexing, and webhook notifications. Keys are never sent to the server; generation and signing happen client-side only. Supports EVM, UTXO, Solana, Tron, TON, Cardano, and other chains. Optionally provide derivation path and label for multi-address tracking. 
-  # @param wallet_register_address_request Public address, chain identifier, and optional derivation path and label. projectId scopes the registration to a project.
+  # Register a public wallet address for monitoring and indexing. All key operations (generation, signing) occur client-side only. 
+  # @param register_non_custodial_address_request 
   # @param [Hash] opts the optional parameters
   # @return [NonCustodialAddressResponse]
-  describe 'wallet_register_address test' do
+  describe 'register_non_custodial_address test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for wallet_test_webhook
+  # unit tests for test_wallet_webhook
   # Test a webhook delivery (sends a single test payload)
-  # Sends a test payload to the given URL to verify webhook connectivity and signature. Uses the same signing as real deliveries.
-  # @param wallet_test_webhook_request URL to send the test POST to; optional secret and projectId for scoping; optional event type to simulate.
+  # @param test_wallet_webhook_request 
+  # @param [Hash] opts the optional parameters
+  # @return [TestWalletWebhook200Response]
+  describe 'test_wallet_webhook test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for update_non_custodial_address
+  # Update a monitored wallet address
+  # Update metadata for a registered non-custodial address. Only **label** and **derivationPath** can be updated; address and chain are immutable. 
+  # @param address_id 
+  # @param [Hash] opts the optional parameters
+  # @option opts [UpdateNonCustodialAddressRequest] :update_non_custodial_address_request 
+  # @return [UpdateNonCustodialAddress200Response]
+  describe 'update_non_custodial_address test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for update_wallet_fee_config
+  # Update project fee configuration (for non-custodial / external users)
+  # Update project-level fee settings. **For non-custodial / external users** — e.g. fee charged on payouts or transfers. Custodial wallet is no longer used in production. Applies to **all supported currencies** (BTC, ETH, BNB, LTC, SOL, TRX, USDT). **feePercentage** is a decimal: use &#x60;0.01&#x60; for 1%, &#x60;0.005&#x60; for 0.5%, etc. (min 0, max 1). 
+  # @param project_id Project ID
   # @param [Hash] opts the optional parameters
-  # @return [MultiRoleGetPermissionsMatrix200Response]
-  describe 'wallet_test_webhook test' do
+  # @option opts [UpdateWalletFeeConfigRequest] :update_wallet_fee_config_request 
+  # @return [UpdateWalletFeeConfig200Response]
+  describe 'update_wallet_fee_config test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for wallet_update_webhook
+  # unit tests for update_wallet_webhook
   # Update a wallet webhook
-  # Update webhook URL, events, secret, or filters. Partially applied; only provided fields are updated.
-  # @param webhook_id Webhook ID (MongoDB ObjectId) to update.
-  # @param wallet_update_webhook_request Fields to update (url, events, secret, filters). Omitted fields are left unchanged.
+  # @param webhook_id 
+  # @param update_wallet_webhook_request 
+  # @param [Hash] opts the optional parameters
+  # @return [UpdateWalletWebhook200Response]
+  describe 'update_wallet_webhook test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for validate_address
+  # Validate cryptocurrency address
+  # @param validate_address_request 
+  # @param [Hash] opts the optional parameters
+  # @return [ValidateAddress200Response]
+  describe 'validate_address test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for withdraw
+  # Prepare withdrawal (semi-transaction; broadcast via non-custodial)
+  # **Semi-transaction:** Builds and signs the withdrawal but does **not** broadcast. Returns &#x60;signedTx&#x60;, &#x60;chain&#x60;, and &#x60;fromAddress&#x60; so the client can broadcast via POST /api/wallet/non-custodial/broadcast. The wallet address must be registered for your organization before broadcasting. Supports all platform chains/currencies (EVM, UTXO, Tron, Solana, USDT on ETH/BSC/TRX/SOL/POLYGON). Use for testing the non-custodial flow: create custodial wallet, get private key, register address, then call withdraw to get signed tx and broadcast it manually. 
+  # @param wallet_id 
+  # @param withdraw_request 
   # @param [Hash] opts the optional parameters
-  # @return [WalletUpdateWebhook200Response]
-  describe 'wallet_update_webhook test' do
+  # @return [Withdraw200Response]
+  describe 'withdraw test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end