mudbase 1.0.0

data/lib/mudbase/api/wallet_api.rb

@@ -0,0 +1,1161 @@
+=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 only for fiat (platform subscriptions + org 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) 
+
+The version of the OpenAPI document: 1.1.9
+Contact: support@mudbase.dev
+Generated by: https://openapi-generator.tech
+Generator version: 7.20.0
+
+=end
+
+require 'cgi'
+
+module Mudbase
+  class WalletApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # 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 `binance` or `bsc` 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 [WalletBroadcastTransactionRequest] Chain, signed transaction (hex), and fromAddress (must be registered).
+    # @param [Hash] opts the optional parameters
+    # @return [WalletBroadcastTransaction200Response]
+    def wallet_broadcast_transaction(wallet_broadcast_transaction_request, opts = {})
+      data, _status_code, _headers = wallet_broadcast_transaction_with_http_info(wallet_broadcast_transaction_request, opts)
+      data
+    end
+
+    # 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 `binance` or `bsc` 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 [WalletBroadcastTransactionRequest] Chain, signed transaction (hex), and fromAddress (must be registered).
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(WalletBroadcastTransaction200Response, Integer, Hash)>] WalletBroadcastTransaction200Response data, response status code and response headers
+    def wallet_broadcast_transaction_with_http_info(wallet_broadcast_transaction_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.wallet_broadcast_transaction ...'
+      end
+      # verify the required parameter 'wallet_broadcast_transaction_request' is set
+      if @api_client.config.client_side_validation && wallet_broadcast_transaction_request.nil?
+        fail ArgumentError, "Missing the required parameter 'wallet_broadcast_transaction_request' when calling WalletApi.wallet_broadcast_transaction"
+      end
+      # resource path
+      local_var_path = '/api/wallet/non-custodial/broadcast'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(wallet_broadcast_transaction_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'WalletBroadcastTransaction200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['BearerToken']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.wallet_broadcast_transaction",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WalletApi#wallet_broadcast_transaction\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # 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 [WalletCreateWebhookRequest] Webhook URL, events array, optional secret and filters (addresses, chains, projectId).
+    # @param [Hash] opts the optional parameters
+    # @return [WalletCreateWebhook201Response]
+    def wallet_create_webhook(wallet_create_webhook_request, opts = {})
+      data, _status_code, _headers = wallet_create_webhook_with_http_info(wallet_create_webhook_request, opts)
+      data
+    end
+
+    # 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 [WalletCreateWebhookRequest] Webhook URL, events array, optional secret and filters (addresses, chains, projectId).
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(WalletCreateWebhook201Response, Integer, Hash)>] WalletCreateWebhook201Response data, response status code and response headers
+    def wallet_create_webhook_with_http_info(wallet_create_webhook_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.wallet_create_webhook ...'
+      end
+      # verify the required parameter 'wallet_create_webhook_request' is set
+      if @api_client.config.client_side_validation && wallet_create_webhook_request.nil?
+        fail ArgumentError, "Missing the required parameter 'wallet_create_webhook_request' when calling WalletApi.wallet_create_webhook"
+      end
+      # resource path
+      local_var_path = '/api/wallet/non-custodial/webhooks'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(wallet_create_webhook_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'WalletCreateWebhook201Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['BearerToken']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.wallet_create_webhook",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WalletApi#wallet_create_webhook\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # 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 [String] Registered address ID to delete.
+    # @param [Hash] opts the optional parameters
+    # @return [FunctionsDelete200Response]
+    def wallet_delete_address(address_id, opts = {})
+      data, _status_code, _headers = wallet_delete_address_with_http_info(address_id, opts)
+      data
+    end
+
+    # 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 [String] Registered address ID to delete.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FunctionsDelete200Response, Integer, Hash)>] FunctionsDelete200Response data, response status code and response headers
+    def wallet_delete_address_with_http_info(address_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.wallet_delete_address ...'
+      end
+      # verify the required parameter 'address_id' is set
+      if @api_client.config.client_side_validation && address_id.nil?
+        fail ArgumentError, "Missing the required parameter 'address_id' when calling WalletApi.wallet_delete_address"
+      end
+      # resource path
+      local_var_path = '/api/wallet/non-custodial/addresses/{addressId}'.sub('{' + 'addressId' + '}', CGI.escape(address_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FunctionsDelete200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['BearerToken']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.wallet_delete_address",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WalletApi#wallet_delete_address\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Delete a wallet webhook
+    # Permanently delete a wallet webhook. Delivery will stop immediately.
+    # @param webhook_id [String] Webhook ID (MongoDB ObjectId) to delete.
+    # @param [Hash] opts the optional parameters
+    # @return [FunctionsDelete200Response]
+    def wallet_delete_webhook(webhook_id, opts = {})
+      data, _status_code, _headers = wallet_delete_webhook_with_http_info(webhook_id, opts)
+      data
+    end
+
+    # Delete a wallet webhook
+    # Permanently delete a wallet webhook. Delivery will stop immediately.
+    # @param webhook_id [String] Webhook ID (MongoDB ObjectId) to delete.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FunctionsDelete200Response, Integer, Hash)>] FunctionsDelete200Response data, response status code and response headers
+    def wallet_delete_webhook_with_http_info(webhook_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.wallet_delete_webhook ...'
+      end
+      # verify the required parameter 'webhook_id' is set
+      if @api_client.config.client_side_validation && webhook_id.nil?
+        fail ArgumentError, "Missing the required parameter 'webhook_id' when calling WalletApi.wallet_delete_webhook"
+      end
+      # resource path
+      local_var_path = '/api/wallet/non-custodial/webhooks/{webhookId}'.sub('{' + 'webhookId' + '}', CGI.escape(webhook_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FunctionsDelete200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['BearerToken']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.wallet_delete_webhook",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WalletApi#wallet_delete_webhook\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # 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 `transaction` (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 `chain` is required; `transaction` 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 [WalletEstimateGasRequest] Chain and optional transaction shape (required for EVM). Returns network fee from blockchain.
+    # @param [Hash] opts the optional parameters
+    # @return [WalletEstimateGas200Response]
+    def wallet_estimate_gas(wallet_estimate_gas_request, opts = {})
+      data, _status_code, _headers = wallet_estimate_gas_with_http_info(wallet_estimate_gas_request, opts)
+      data
+    end
+
+    # 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 [WalletEstimateGasRequest] Chain and optional transaction shape (required for EVM). Returns network fee from blockchain.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(WalletEstimateGas200Response, Integer, Hash)>] WalletEstimateGas200Response data, response status code and response headers
+    def wallet_estimate_gas_with_http_info(wallet_estimate_gas_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.wallet_estimate_gas ...'
+      end
+      # verify the required parameter 'wallet_estimate_gas_request' is set
+      if @api_client.config.client_side_validation && wallet_estimate_gas_request.nil?
+        fail ArgumentError, "Missing the required parameter 'wallet_estimate_gas_request' when calling WalletApi.wallet_estimate_gas"
+      end
+      # resource path
+      local_var_path = '/api/wallet/non-custodial/estimate-gas'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(wallet_estimate_gas_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'WalletEstimateGas200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['BearerToken']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.wallet_estimate_gas",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WalletApi#wallet_estimate_gas\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # 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 [String] Registered address ID (MongoDB ObjectId).
+    # @param [Hash] opts the optional parameters
+    # @return [NonCustodialAddressResponse]
+    def wallet_get_address(address_id, opts = {})
+      data, _status_code, _headers = wallet_get_address_with_http_info(address_id, opts)
+      data
+    end
+
+    # 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 [String] Registered address ID (MongoDB ObjectId).
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(NonCustodialAddressResponse, Integer, Hash)>] NonCustodialAddressResponse data, response status code and response headers
+    def wallet_get_address_with_http_info(address_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.wallet_get_address ...'
+      end
+      # verify the required parameter 'address_id' is set
+      if @api_client.config.client_side_validation && address_id.nil?
+        fail ArgumentError, "Missing the required parameter 'address_id' when calling WalletApi.wallet_get_address"
+      end
+      # resource path
+      local_var_path = '/api/wallet/non-custodial/addresses/{addressId}'.sub('{' + 'addressId' + '}', CGI.escape(address_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'NonCustodialAddressResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['BearerToken']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.wallet_get_address",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WalletApi#wallet_get_address\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # 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 [String] Registered address ID.
+    # @param [Hash] opts the optional parameters
+    # @return [WalletGetBalance200Response]
+    def wallet_get_balance(address_id, opts = {})
+      data, _status_code, _headers = wallet_get_balance_with_http_info(address_id, opts)
+      data
+    end
+
+    # 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 [String] Registered address ID.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(WalletGetBalance200Response, Integer, Hash)>] WalletGetBalance200Response data, response status code and response headers
+    def wallet_get_balance_with_http_info(address_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.wallet_get_balance ...'
+      end
+      # verify the required parameter 'address_id' is set
+      if @api_client.config.client_side_validation && address_id.nil?
+        fail ArgumentError, "Missing the required parameter 'address_id' when calling WalletApi.wallet_get_balance"
+      end
+      # resource path
+      local_var_path = '/api/wallet/non-custodial/addresses/{addressId}/balance'.sub('{' + 'addressId' + '}', CGI.escape(address_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'WalletGetBalance200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['BearerToken']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.wallet_get_balance",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WalletApi#wallet_get_balance\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get replacement tx params for cancel (stuck EVM tx)
+    # Returns **replacement transaction params** to cancel a stuck EVM transaction (same nonce, to=self, value=0, data=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 [WalletGetCancelParamsRequest] Stuck transaction identifier (txId or txHash) and EVM chain for cancel.
+    # @param [Hash] opts the optional parameters
+    # @return [WalletGetCancelParams200Response]
+    def wallet_get_cancel_params(wallet_get_cancel_params_request, opts = {})
+      data, _status_code, _headers = wallet_get_cancel_params_with_http_info(wallet_get_cancel_params_request, opts)
+      data
+    end
+
+    # 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 [WalletGetCancelParamsRequest] Stuck transaction identifier (txId or txHash) and EVM chain for cancel.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(WalletGetCancelParams200Response, Integer, Hash)>] WalletGetCancelParams200Response data, response status code and response headers
+    def wallet_get_cancel_params_with_http_info(wallet_get_cancel_params_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.wallet_get_cancel_params ...'
+      end
+      # verify the required parameter 'wallet_get_cancel_params_request' is set
+      if @api_client.config.client_side_validation && wallet_get_cancel_params_request.nil?
+        fail ArgumentError, "Missing the required parameter 'wallet_get_cancel_params_request' when calling WalletApi.wallet_get_cancel_params"
+      end
+      # resource path
+      local_var_path = '/api/wallet/non-custodial/cancel'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(wallet_get_cancel_params_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'WalletGetCancelParams200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['BearerToken']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.wallet_get_cancel_params",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WalletApi#wallet_get_cancel_params\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # 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 >5 min (stuck). EVM chains only. 
+    # @param wallet_get_speed_up_params_request [WalletGetSpeedUpParamsRequest] Stuck transaction identifier (txId or txHash) and EVM chain.
+    # @param [Hash] opts the optional parameters
+    # @return [WalletGetSpeedUpParams200Response]
+    def wallet_get_speed_up_params(wallet_get_speed_up_params_request, opts = {})
+      data, _status_code, _headers = wallet_get_speed_up_params_with_http_info(wallet_get_speed_up_params_request, opts)
+      data
+    end
+
+    # 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 [WalletGetSpeedUpParamsRequest] Stuck transaction identifier (txId or txHash) and EVM chain.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(WalletGetSpeedUpParams200Response, Integer, Hash)>] WalletGetSpeedUpParams200Response data, response status code and response headers
+    def wallet_get_speed_up_params_with_http_info(wallet_get_speed_up_params_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.wallet_get_speed_up_params ...'
+      end
+      # verify the required parameter 'wallet_get_speed_up_params_request' is set
+      if @api_client.config.client_side_validation && wallet_get_speed_up_params_request.nil?
+        fail ArgumentError, "Missing the required parameter 'wallet_get_speed_up_params_request' when calling WalletApi.wallet_get_speed_up_params"
+      end
+      # resource path
+      local_var_path = '/api/wallet/non-custodial/speed-up'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(wallet_get_speed_up_params_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'WalletGetSpeedUpParams200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['BearerToken']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.wallet_get_speed_up_params",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WalletApi#wallet_get_speed_up_params\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # 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 [String] Transaction hash (e.g. 0x... for EVM, or block explorer format for UTXO)
+    # @param chain [String] Chain the transaction belongs to (required for lookup)
+    # @param [Hash] opts the optional parameters
+    # @return [WalletGetTransactionByHash200Response]
+    def wallet_get_transaction_by_hash(tx_hash, chain, opts = {})
+      data, _status_code, _headers = wallet_get_transaction_by_hash_with_http_info(tx_hash, chain, opts)
+      data
+    end
+
+    # 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 [String] Transaction hash (e.g. 0x... for EVM, or block explorer format for UTXO)
+    # @param chain [String] Chain the transaction belongs to (required for lookup)
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(WalletGetTransactionByHash200Response, Integer, Hash)>] WalletGetTransactionByHash200Response data, response status code and response headers
+    def wallet_get_transaction_by_hash_with_http_info(tx_hash, chain, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.wallet_get_transaction_by_hash ...'
+      end
+      # verify the required parameter 'tx_hash' is set
+      if @api_client.config.client_side_validation && tx_hash.nil?
+        fail ArgumentError, "Missing the required parameter 'tx_hash' when calling WalletApi.wallet_get_transaction_by_hash"
+      end
+      # verify the required parameter 'chain' is set
+      if @api_client.config.client_side_validation && chain.nil?
+        fail ArgumentError, "Missing the required parameter 'chain' when calling WalletApi.wallet_get_transaction_by_hash"
+      end
+      # verify enum value
+      allowable_values = ["ethereum", "binance", "polygon", "celo", "bitcoin", "litecoin", "solana", "tron", "ripple", "cardano", "dogecoin", "ton"]
+      if @api_client.config.client_side_validation && !allowable_values.include?(chain)
+        fail ArgumentError, "invalid value for \"chain\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/wallet/non-custodial/transactions/{txHash}'.sub('{' + 'txHash' + '}', CGI.escape(tx_hash.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'chain'] = chain
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'WalletGetTransactionByHash200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['BearerToken']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.wallet_get_transaction_by_hash",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WalletApi#wallet_get_transaction_by_hash\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # 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 [String] Registered address ID.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Number of transactions per page. (default to 50)
+    # @option opts [Integer] :page Page number (1-based). (default to 1)
+    # @return [WalletGetTransactions200Response]
+    def wallet_get_transactions(address_id, opts = {})
+      data, _status_code, _headers = wallet_get_transactions_with_http_info(address_id, opts)
+      data
+    end
+
+    # 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 [String] Registered address ID.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Number of transactions per page. (default to 50)
+    # @option opts [Integer] :page Page number (1-based). (default to 1)
+    # @return [Array<(WalletGetTransactions200Response, Integer, Hash)>] WalletGetTransactions200Response data, response status code and response headers
+    def wallet_get_transactions_with_http_info(address_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.wallet_get_transactions ...'
+      end
+      # verify the required parameter 'address_id' is set
+      if @api_client.config.client_side_validation && address_id.nil?
+        fail ArgumentError, "Missing the required parameter 'address_id' when calling WalletApi.wallet_get_transactions"
+      end
+      # resource path
+      local_var_path = '/api/wallet/non-custodial/addresses/{addressId}/transactions'.sub('{' + 'addressId' + '}', CGI.escape(address_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'WalletGetTransactions200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['BearerToken']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.wallet_get_transactions",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WalletApi#wallet_get_transactions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get webhook delivery logs
+    # List delivery attempts for a wallet webhook (success/failure, payload, response, duration). Paginated by limit.
+    # @param webhook_id [String] Webhook ID (MongoDB ObjectId) to get logs for.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Maximum number of log entries to return. (default to 50)
+    # @return [WalletGetWebhookLogs200Response]
+    def wallet_get_webhook_logs(webhook_id, opts = {})
+      data, _status_code, _headers = wallet_get_webhook_logs_with_http_info(webhook_id, opts)
+      data
+    end
+
+    # Get webhook delivery logs
+    # List delivery attempts for a wallet webhook (success/failure, payload, response, duration). Paginated by limit.
+    # @param webhook_id [String] Webhook ID (MongoDB ObjectId) to get logs for.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Maximum number of log entries to return. (default to 50)
+    # @return [Array<(WalletGetWebhookLogs200Response, Integer, Hash)>] WalletGetWebhookLogs200Response data, response status code and response headers
+    def wallet_get_webhook_logs_with_http_info(webhook_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.wallet_get_webhook_logs ...'
+      end
+      # verify the required parameter 'webhook_id' is set
+      if @api_client.config.client_side_validation && webhook_id.nil?
+        fail ArgumentError, "Missing the required parameter 'webhook_id' when calling WalletApi.wallet_get_webhook_logs"
+      end
+      # resource path
+      local_var_path = '/api/wallet/non-custodial/webhooks/{webhookId}/logs'.sub('{' + 'webhookId' + '}', CGI.escape(webhook_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'WalletGetWebhookLogs200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerToken']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.wallet_get_webhook_logs",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WalletApi#wallet_get_webhook_logs\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # 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]
+    def wallet_list_addresses(opts = {})
+      data, _status_code, _headers = wallet_list_addresses_with_http_info(opts)
+      data
+    end
+
+    # 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 [Array<(WalletListAddresses200Response, Integer, Hash)>] WalletListAddresses200Response data, response status code and response headers
+    def wallet_list_addresses_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.wallet_list_addresses ...'
+      end
+      allowable_values = ["ethereum", "binance", "bsc", "polygon", "arbitrum", "optimism", "base", "avalanche", "celo", "bitcoin", "litecoin", "dogecoin", "solana", "tron", "ripple", "cardano", "ton"]
+      if @api_client.config.client_side_validation && opts[:'chain'] && !allowable_values.include?(opts[:'chain'])
+        fail ArgumentError, "invalid value for \"chain\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/wallet/non-custodial/addresses'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'chain'] = opts[:'chain'] if !opts[:'chain'].nil?
+      query_params[:'projectId'] = opts[:'project_id'] if !opts[:'project_id'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'WalletListAddresses200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['BearerToken']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.wallet_list_addresses",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WalletApi#wallet_list_addresses\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # 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]
+    def wallet_list_webhooks(opts = {})
+      data, _status_code, _headers = wallet_list_webhooks_with_http_info(opts)
+      data
+    end
+
+    # 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 [Array<(WalletListWebhooks200Response, Integer, Hash)>] WalletListWebhooks200Response data, response status code and response headers
+    def wallet_list_webhooks_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.wallet_list_webhooks ...'
+      end
+      # resource path
+      local_var_path = '/api/wallet/non-custodial/webhooks'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'projectId'] = opts[:'project_id'] if !opts[:'project_id'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'WalletListWebhooks200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['BearerToken']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.wallet_list_webhooks",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WalletApi#wallet_list_webhooks\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # 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 [WalletRegisterAddressRequest] Public address, chain identifier, and optional derivation path and label. projectId scopes the registration to a project.
+    # @param [Hash] opts the optional parameters
+    # @return [NonCustodialAddressResponse]
+    def wallet_register_address(wallet_register_address_request, opts = {})
+      data, _status_code, _headers = wallet_register_address_with_http_info(wallet_register_address_request, opts)
+      data
+    end
+
+    # 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 [WalletRegisterAddressRequest] Public address, chain identifier, and optional derivation path and label. projectId scopes the registration to a project.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(NonCustodialAddressResponse, Integer, Hash)>] NonCustodialAddressResponse data, response status code and response headers
+    def wallet_register_address_with_http_info(wallet_register_address_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.wallet_register_address ...'
+      end
+      # verify the required parameter 'wallet_register_address_request' is set
+      if @api_client.config.client_side_validation && wallet_register_address_request.nil?
+        fail ArgumentError, "Missing the required parameter 'wallet_register_address_request' when calling WalletApi.wallet_register_address"
+      end
+      # resource path
+      local_var_path = '/api/wallet/non-custodial/register-address'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(wallet_register_address_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'NonCustodialAddressResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['BearerToken']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.wallet_register_address",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WalletApi#wallet_register_address\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # 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 [WalletTestWebhookRequest] URL to send the test POST to; optional secret and projectId for scoping; optional event type to simulate.
+    # @param [Hash] opts the optional parameters
+    # @return [WalletTestWebhook200Response]
+    def wallet_test_webhook(wallet_test_webhook_request, opts = {})
+      data, _status_code, _headers = wallet_test_webhook_with_http_info(wallet_test_webhook_request, opts)
+      data
+    end
+
+    # 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 [WalletTestWebhookRequest] URL to send the test POST to; optional secret and projectId for scoping; optional event type to simulate.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(WalletTestWebhook200Response, Integer, Hash)>] WalletTestWebhook200Response data, response status code and response headers
+    def wallet_test_webhook_with_http_info(wallet_test_webhook_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.wallet_test_webhook ...'
+      end
+      # verify the required parameter 'wallet_test_webhook_request' is set
+      if @api_client.config.client_side_validation && wallet_test_webhook_request.nil?
+        fail ArgumentError, "Missing the required parameter 'wallet_test_webhook_request' when calling WalletApi.wallet_test_webhook"
+      end
+      # resource path
+      local_var_path = '/api/wallet/non-custodial/webhooks/test'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(wallet_test_webhook_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'WalletTestWebhook200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerToken']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.wallet_test_webhook",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WalletApi#wallet_test_webhook\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Update a wallet webhook
+    # Update webhook URL, events, secret, or filters. Partially applied; only provided fields are updated.
+    # @param webhook_id [String] Webhook ID (MongoDB ObjectId) to update.
+    # @param wallet_update_webhook_request [WalletUpdateWebhookRequest] Fields to update (url, events, secret, filters). Omitted fields are left unchanged.
+    # @param [Hash] opts the optional parameters
+    # @return [WalletUpdateWebhook200Response]
+    def wallet_update_webhook(webhook_id, wallet_update_webhook_request, opts = {})
+      data, _status_code, _headers = wallet_update_webhook_with_http_info(webhook_id, wallet_update_webhook_request, opts)
+      data
+    end
+
+    # Update a wallet webhook
+    # Update webhook URL, events, secret, or filters. Partially applied; only provided fields are updated.
+    # @param webhook_id [String] Webhook ID (MongoDB ObjectId) to update.
+    # @param wallet_update_webhook_request [WalletUpdateWebhookRequest] Fields to update (url, events, secret, filters). Omitted fields are left unchanged.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(WalletUpdateWebhook200Response, Integer, Hash)>] WalletUpdateWebhook200Response data, response status code and response headers
+    def wallet_update_webhook_with_http_info(webhook_id, wallet_update_webhook_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.wallet_update_webhook ...'
+      end
+      # verify the required parameter 'webhook_id' is set
+      if @api_client.config.client_side_validation && webhook_id.nil?
+        fail ArgumentError, "Missing the required parameter 'webhook_id' when calling WalletApi.wallet_update_webhook"
+      end
+      # verify the required parameter 'wallet_update_webhook_request' is set
+      if @api_client.config.client_side_validation && wallet_update_webhook_request.nil?
+        fail ArgumentError, "Missing the required parameter 'wallet_update_webhook_request' when calling WalletApi.wallet_update_webhook"
+      end
+      # resource path
+      local_var_path = '/api/wallet/non-custodial/webhooks/{webhookId}'.sub('{' + 'webhookId' + '}', CGI.escape(webhook_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(wallet_update_webhook_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'WalletUpdateWebhook200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerToken']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.wallet_update_webhook",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PUT, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WalletApi#wallet_update_webhook\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end