mudbase 1.1.4

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)  ## Testing Configurations Below are example configurations for testing in different environments:  ### Production ```json {   \"scheme\": \"http\",   \"base_path\": \"\",   \"host\": \"cloud.mudbase.dev\",   \"xApiKey\": \"xApiKey\",   \"bearerToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4NWFjYmUwZTEyOTkzMmZiYjdhMGZjMiIsImVtYWlsIjoibXVkaGF4a3NlcnZpY2VzQGdtYWlsLmNvbSIsImlhdCI6MTc1MDc4MDg5OCwiZXhwIjoxNzUwODY3Mjk4fQ.sfoqzEbCuz5Y8qHkLItzrZZYC823SPT4RbO7Kucqvuc\",   \"userId\": \"685acbe0e129932fbb7a0fc2\",   \"projectId\": \"685ad30be129932fbb7a1047\",   \"collectionId\": \"685ada8fd9416ac02f171abf\",   \"documentId\": \"685ae1210136e73fa1dcaf36\",   \"apikeyId\": \"685ae8a785426b6a4190d5fc\",   \"webhookId\": \"685af3992f9c4c96514247e9\",   \"functionId\": \"685af8b85d73a104065b6a77\",   \"fileId\": \"685af8b85d73a104065b6a77\" } 
+
+The version of the OpenAPI document: 1.1.4
+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 broadcast_non_custodial_transaction_request [BroadcastNonCustodialTransactionRequest] Chain, signed transaction (hex), and fromAddress (must be registered).
+    # @param [Hash] opts the optional parameters
+    # @return [BroadcastNonCustodialTransaction200Response]
+    def broadcast_non_custodial_transaction(broadcast_non_custodial_transaction_request, opts = {})
+      data, _status_code, _headers = broadcast_non_custodial_transaction_with_http_info(broadcast_non_custodial_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 broadcast_non_custodial_transaction_request [BroadcastNonCustodialTransactionRequest] Chain, signed transaction (hex), and fromAddress (must be registered).
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(BroadcastNonCustodialTransaction200Response, Integer, Hash)>] BroadcastNonCustodialTransaction200Response data, response status code and response headers
+    def broadcast_non_custodial_transaction_with_http_info(broadcast_non_custodial_transaction_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.broadcast_non_custodial_transaction ...'
+      end
+      # verify the required parameter 'broadcast_non_custodial_transaction_request' is set
+      if @api_client.config.client_side_validation && broadcast_non_custodial_transaction_request.nil?
+        fail ArgumentError, "Missing the required parameter 'broadcast_non_custodial_transaction_request' when calling WalletApi.broadcast_non_custodial_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(broadcast_non_custodial_transaction_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'BroadcastNonCustodialTransaction200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.broadcast_non_custodial_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#broadcast_non_custodial_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 create_wallet_webhook_request [CreateWalletWebhookRequest] Webhook URL, events array, optional secret and filters (addresses, chains, projectId).
+    # @param [Hash] opts the optional parameters
+    # @return [CreateWalletWebhook201Response]
+    def create_wallet_webhook(create_wallet_webhook_request, opts = {})
+      data, _status_code, _headers = create_wallet_webhook_with_http_info(create_wallet_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 create_wallet_webhook_request [CreateWalletWebhookRequest] Webhook URL, events array, optional secret and filters (addresses, chains, projectId).
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CreateWalletWebhook201Response, Integer, Hash)>] CreateWalletWebhook201Response data, response status code and response headers
+    def create_wallet_webhook_with_http_info(create_wallet_webhook_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.create_wallet_webhook ...'
+      end
+      # verify the required parameter 'create_wallet_webhook_request' is set
+      if @api_client.config.client_side_validation && create_wallet_webhook_request.nil?
+        fail ArgumentError, "Missing the required parameter 'create_wallet_webhook_request' when calling WalletApi.create_wallet_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(create_wallet_webhook_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CreateWalletWebhook201Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.create_wallet_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#create_wallet_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 [DeleteFunction200Response]
+    def delete_non_custodial_address(address_id, opts = {})
+      data, _status_code, _headers = delete_non_custodial_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<(DeleteFunction200Response, Integer, Hash)>] DeleteFunction200Response data, response status code and response headers
+    def delete_non_custodial_address_with_http_info(address_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.delete_non_custodial_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.delete_non_custodial_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] || 'DeleteFunction200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.delete_non_custodial_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#delete_non_custodial_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 [DeleteFunction200Response]
+    def delete_wallet_webhook(webhook_id, opts = {})
+      data, _status_code, _headers = delete_wallet_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<(DeleteFunction200Response, Integer, Hash)>] DeleteFunction200Response data, response status code and response headers
+    def delete_wallet_webhook_with_http_info(webhook_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.delete_wallet_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.delete_wallet_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] || 'DeleteFunction200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.delete_wallet_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#delete_wallet_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 estimate_non_custodial_gas_request [EstimateNonCustodialGasRequest] Chain and optional transaction shape (required for EVM). Returns network fee from blockchain.
+    # @param [Hash] opts the optional parameters
+    # @return [EstimateNonCustodialGas200Response]
+    def estimate_non_custodial_gas(estimate_non_custodial_gas_request, opts = {})
+      data, _status_code, _headers = estimate_non_custodial_gas_with_http_info(estimate_non_custodial_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 estimate_non_custodial_gas_request [EstimateNonCustodialGasRequest] Chain and optional transaction shape (required for EVM). Returns network fee from blockchain.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(EstimateNonCustodialGas200Response, Integer, Hash)>] EstimateNonCustodialGas200Response data, response status code and response headers
+    def estimate_non_custodial_gas_with_http_info(estimate_non_custodial_gas_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.estimate_non_custodial_gas ...'
+      end
+      # verify the required parameter 'estimate_non_custodial_gas_request' is set
+      if @api_client.config.client_side_validation && estimate_non_custodial_gas_request.nil?
+        fail ArgumentError, "Missing the required parameter 'estimate_non_custodial_gas_request' when calling WalletApi.estimate_non_custodial_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(estimate_non_custodial_gas_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EstimateNonCustodialGas200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.estimate_non_custodial_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#estimate_non_custodial_gas\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 get_cancel_params_request [GetCancelParamsRequest] Stuck transaction identifier (txId or txHash) and EVM chain for cancel.
+    # @param [Hash] opts the optional parameters
+    # @return [GetCancelParams200Response]
+    def get_cancel_params(get_cancel_params_request, opts = {})
+      data, _status_code, _headers = get_cancel_params_with_http_info(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 get_cancel_params_request [GetCancelParamsRequest] Stuck transaction identifier (txId or txHash) and EVM chain for cancel.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetCancelParams200Response, Integer, Hash)>] GetCancelParams200Response data, response status code and response headers
+    def get_cancel_params_with_http_info(get_cancel_params_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.get_cancel_params ...'
+      end
+      # verify the required parameter 'get_cancel_params_request' is set
+      if @api_client.config.client_side_validation && get_cancel_params_request.nil?
+        fail ArgumentError, "Missing the required parameter 'get_cancel_params_request' when calling WalletApi.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(get_cancel_params_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetCancelParams200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.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#get_cancel_params\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 get_non_custodial_address(address_id, opts = {})
+      data, _status_code, _headers = get_non_custodial_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 get_non_custodial_address_with_http_info(address_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.get_non_custodial_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.get_non_custodial_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] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.get_non_custodial_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#get_non_custodial_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 [GetNonCustodialBalance200Response]
+    def get_non_custodial_balance(address_id, opts = {})
+      data, _status_code, _headers = get_non_custodial_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<(GetNonCustodialBalance200Response, Integer, Hash)>] GetNonCustodialBalance200Response data, response status code and response headers
+    def get_non_custodial_balance_with_http_info(address_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.get_non_custodial_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.get_non_custodial_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] || 'GetNonCustodialBalance200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.get_non_custodial_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#get_non_custodial_balance\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 [GetNonCustodialTransactionByHash200Response]
+    def get_non_custodial_transaction_by_hash(tx_hash, chain, opts = {})
+      data, _status_code, _headers = get_non_custodial_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<(GetNonCustodialTransactionByHash200Response, Integer, Hash)>] GetNonCustodialTransactionByHash200Response data, response status code and response headers
+    def get_non_custodial_transaction_by_hash_with_http_info(tx_hash, chain, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.get_non_custodial_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.get_non_custodial_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.get_non_custodial_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] || 'GetNonCustodialTransactionByHash200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.get_non_custodial_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#get_non_custodial_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 [GetNonCustodialTransactions200Response]
+    def get_non_custodial_transactions(address_id, opts = {})
+      data, _status_code, _headers = get_non_custodial_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<(GetNonCustodialTransactions200Response, Integer, Hash)>] GetNonCustodialTransactions200Response data, response status code and response headers
+    def get_non_custodial_transactions_with_http_info(address_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.get_non_custodial_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.get_non_custodial_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] || 'GetNonCustodialTransactions200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.get_non_custodial_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#get_non_custodial_transactions\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 get_speed_up_params_request [GetSpeedUpParamsRequest] Stuck transaction identifier (txId or txHash) and EVM chain.
+    # @param [Hash] opts the optional parameters
+    # @return [GetSpeedUpParams200Response]
+    def get_speed_up_params(get_speed_up_params_request, opts = {})
+      data, _status_code, _headers = get_speed_up_params_with_http_info(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 get_speed_up_params_request [GetSpeedUpParamsRequest] Stuck transaction identifier (txId or txHash) and EVM chain.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetSpeedUpParams200Response, Integer, Hash)>] GetSpeedUpParams200Response data, response status code and response headers
+    def get_speed_up_params_with_http_info(get_speed_up_params_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.get_speed_up_params ...'
+      end
+      # verify the required parameter 'get_speed_up_params_request' is set
+      if @api_client.config.client_side_validation && get_speed_up_params_request.nil?
+        fail ArgumentError, "Missing the required parameter 'get_speed_up_params_request' when calling WalletApi.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(get_speed_up_params_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetSpeedUpParams200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.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#get_speed_up_params\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 [GetWalletWebhookLogs200Response]
+    def get_wallet_webhook_logs(webhook_id, opts = {})
+      data, _status_code, _headers = get_wallet_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<(GetWalletWebhookLogs200Response, Integer, Hash)>] GetWalletWebhookLogs200Response data, response status code and response headers
+    def get_wallet_webhook_logs_with_http_info(webhook_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.get_wallet_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.get_wallet_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] || 'GetWalletWebhookLogs200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.get_wallet_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#get_wallet_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 [ListNonCustodialAddresses200Response]
+    def list_non_custodial_addresses(opts = {})
+      data, _status_code, _headers = list_non_custodial_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<(ListNonCustodialAddresses200Response, Integer, Hash)>] ListNonCustodialAddresses200Response data, response status code and response headers
+    def list_non_custodial_addresses_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.list_non_custodial_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] || 'ListNonCustodialAddresses200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.list_non_custodial_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#list_non_custodial_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 [ListWalletWebhooks200Response]
+    def list_wallet_webhooks(opts = {})
+      data, _status_code, _headers = list_wallet_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<(ListWalletWebhooks200Response, Integer, Hash)>] ListWalletWebhooks200Response data, response status code and response headers
+    def list_wallet_webhooks_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.list_wallet_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] || 'ListWalletWebhooks200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.list_wallet_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#list_wallet_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 register_non_custodial_address_request [RegisterNonCustodialAddressRequest] 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 register_non_custodial_address(register_non_custodial_address_request, opts = {})
+      data, _status_code, _headers = register_non_custodial_address_with_http_info(register_non_custodial_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 register_non_custodial_address_request [RegisterNonCustodialAddressRequest] 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 register_non_custodial_address_with_http_info(register_non_custodial_address_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.register_non_custodial_address ...'
+      end
+      # verify the required parameter 'register_non_custodial_address_request' is set
+      if @api_client.config.client_side_validation && register_non_custodial_address_request.nil?
+        fail ArgumentError, "Missing the required parameter 'register_non_custodial_address_request' when calling WalletApi.register_non_custodial_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(register_non_custodial_address_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'NonCustodialAddressResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.register_non_custodial_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#register_non_custodial_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 test_wallet_webhook_request [TestWalletWebhookRequest] 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 [TestWalletWebhook200Response]
+    def test_wallet_webhook(test_wallet_webhook_request, opts = {})
+      data, _status_code, _headers = test_wallet_webhook_with_http_info(test_wallet_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 test_wallet_webhook_request [TestWalletWebhookRequest] 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<(TestWalletWebhook200Response, Integer, Hash)>] TestWalletWebhook200Response data, response status code and response headers
+    def test_wallet_webhook_with_http_info(test_wallet_webhook_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.test_wallet_webhook ...'
+      end
+      # verify the required parameter 'test_wallet_webhook_request' is set
+      if @api_client.config.client_side_validation && test_wallet_webhook_request.nil?
+        fail ArgumentError, "Missing the required parameter 'test_wallet_webhook_request' when calling WalletApi.test_wallet_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(test_wallet_webhook_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TestWalletWebhook200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.test_wallet_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#test_wallet_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 update_wallet_webhook_request [UpdateWalletWebhookRequest] Fields to update (url, events, secret, filters). Omitted fields are left unchanged.
+    # @param [Hash] opts the optional parameters
+    # @return [UpdateWalletWebhook200Response]
+    def update_wallet_webhook(webhook_id, update_wallet_webhook_request, opts = {})
+      data, _status_code, _headers = update_wallet_webhook_with_http_info(webhook_id, update_wallet_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 update_wallet_webhook_request [UpdateWalletWebhookRequest] Fields to update (url, events, secret, filters). Omitted fields are left unchanged.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(UpdateWalletWebhook200Response, Integer, Hash)>] UpdateWalletWebhook200Response data, response status code and response headers
+    def update_wallet_webhook_with_http_info(webhook_id, update_wallet_webhook_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WalletApi.update_wallet_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.update_wallet_webhook"
+      end
+      # verify the required parameter 'update_wallet_webhook_request' is set
+      if @api_client.config.client_side_validation && update_wallet_webhook_request.nil?
+        fail ArgumentError, "Missing the required parameter 'update_wallet_webhook_request' when calling WalletApi.update_wallet_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(update_wallet_webhook_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'UpdateWalletWebhook200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WalletApi.update_wallet_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#update_wallet_webhook\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end