mudbase 1.1.4

data/docs/WalletApi.md

@@ -0,0 +1,1232 @@
+# Mudbase::WalletApi
+
+All URIs are relative to *https://cloud.mudbase.dev*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**broadcast_non_custodial_transaction**](WalletApi.md#broadcast_non_custodial_transaction) | **POST** /api/wallet/non-custodial/broadcast | Broadcast a client-signed transaction |
+| [**create_wallet_webhook**](WalletApi.md#create_wallet_webhook) | **POST** /api/wallet/non-custodial/webhooks | Create a wallet webhook |
+| [**delete_non_custodial_address**](WalletApi.md#delete_non_custodial_address) | **DELETE** /api/wallet/non-custodial/addresses/{addressId} | Delete (soft-delete) a non-custodial address |
+| [**delete_wallet_webhook**](WalletApi.md#delete_wallet_webhook) | **DELETE** /api/wallet/non-custodial/webhooks/{webhookId} | Delete a wallet webhook |
+| [**estimate_non_custodial_gas**](WalletApi.md#estimate_non_custodial_gas) | **POST** /api/wallet/non-custodial/estimate-gas | Estimate network fee from blockchain (all supported chains; not controlled by Mudbase) |
+| [**get_cancel_params**](WalletApi.md#get_cancel_params) | **POST** /api/wallet/non-custodial/cancel | Get replacement tx params for cancel (stuck EVM tx) |
+| [**get_non_custodial_address**](WalletApi.md#get_non_custodial_address) | **GET** /api/wallet/non-custodial/addresses/{addressId} | Get non-custodial address by ID |
+| [**get_non_custodial_balance**](WalletApi.md#get_non_custodial_balance) | **GET** /api/wallet/non-custodial/addresses/{addressId}/balance | Get balance for a non-custodial address |
+| [**get_non_custodial_transaction_by_hash**](WalletApi.md#get_non_custodial_transaction_by_hash) | **GET** /api/wallet/non-custodial/transactions/{txHash} | Get transaction by hash |
+| [**get_non_custodial_transactions**](WalletApi.md#get_non_custodial_transactions) | **GET** /api/wallet/non-custodial/addresses/{addressId}/transactions | Get transaction history for a non-custodial address |
+| [**get_speed_up_params**](WalletApi.md#get_speed_up_params) | **POST** /api/wallet/non-custodial/speed-up | Get replacement tx params for speed-up (stuck EVM tx) |
+| [**get_wallet_webhook_logs**](WalletApi.md#get_wallet_webhook_logs) | **GET** /api/wallet/non-custodial/webhooks/{webhookId}/logs | Get webhook delivery logs |
+| [**list_non_custodial_addresses**](WalletApi.md#list_non_custodial_addresses) | **GET** /api/wallet/non-custodial/addresses | List registered non-custodial addresses |
+| [**list_wallet_webhooks**](WalletApi.md#list_wallet_webhooks) | **GET** /api/wallet/non-custodial/webhooks | List wallet webhooks |
+| [**register_non_custodial_address**](WalletApi.md#register_non_custodial_address) | **POST** /api/wallet/non-custodial/register-address | Register a non-custodial wallet address |
+| [**test_wallet_webhook**](WalletApi.md#test_wallet_webhook) | **POST** /api/wallet/non-custodial/webhooks/test | Test a webhook delivery (sends a single test payload) |
+| [**update_wallet_webhook**](WalletApi.md#update_wallet_webhook) | **PUT** /api/wallet/non-custodial/webhooks/{webhookId} | Update a wallet webhook |
+
+
+## broadcast_non_custodial_transaction
+
+> <BroadcastNonCustodialTransaction200Response> broadcast_non_custodial_transaction(broadcast_non_custodial_transaction_request)
+
+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. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::WalletApi.new
+broadcast_non_custodial_transaction_request = Mudbase::BroadcastNonCustodialTransactionRequest.new({chain: 'ethereum', signed_tx: '0x02f8...', from_address: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'}) # BroadcastNonCustodialTransactionRequest | Chain, signed transaction (hex), and fromAddress (must be registered).
+
+begin
+  # Broadcast a client-signed transaction
+  result = api_instance.broadcast_non_custodial_transaction(broadcast_non_custodial_transaction_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->broadcast_non_custodial_transaction: #{e}"
+end
+```
+
+#### Using the broadcast_non_custodial_transaction_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<BroadcastNonCustodialTransaction200Response>, Integer, Hash)> broadcast_non_custodial_transaction_with_http_info(broadcast_non_custodial_transaction_request)
+
+```ruby
+begin
+  # Broadcast a client-signed transaction
+  data, status_code, headers = api_instance.broadcast_non_custodial_transaction_with_http_info(broadcast_non_custodial_transaction_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <BroadcastNonCustodialTransaction200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->broadcast_non_custodial_transaction_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **broadcast_non_custodial_transaction_request** | [**BroadcastNonCustodialTransactionRequest**](BroadcastNonCustodialTransactionRequest.md) | Chain, signed transaction (hex), and fromAddress (must be registered). |  |
+
+### Return type
+
+[**BroadcastNonCustodialTransaction200Response**](BroadcastNonCustodialTransaction200Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## create_wallet_webhook
+
+> <CreateWalletWebhook201Response> create_wallet_webhook(create_wallet_webhook_request)
+
+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. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::WalletApi.new
+create_wallet_webhook_request = Mudbase::CreateWalletWebhookRequest.new({url: 'https://your-app.com/webhooks/wallet', events: ["wallet.balance.updated", "wallet.transaction.confirmed"]}) # CreateWalletWebhookRequest | Webhook URL, events array, optional secret and filters (addresses, chains, projectId).
+
+begin
+  # Create a wallet webhook
+  result = api_instance.create_wallet_webhook(create_wallet_webhook_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->create_wallet_webhook: #{e}"
+end
+```
+
+#### Using the create_wallet_webhook_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<CreateWalletWebhook201Response>, Integer, Hash)> create_wallet_webhook_with_http_info(create_wallet_webhook_request)
+
+```ruby
+begin
+  # Create a wallet webhook
+  data, status_code, headers = api_instance.create_wallet_webhook_with_http_info(create_wallet_webhook_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <CreateWalletWebhook201Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->create_wallet_webhook_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **create_wallet_webhook_request** | [**CreateWalletWebhookRequest**](CreateWalletWebhookRequest.md) | Webhook URL, events array, optional secret and filters (addresses, chains, projectId). |  |
+
+### Return type
+
+[**CreateWalletWebhook201Response**](CreateWalletWebhook201Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## delete_non_custodial_address
+
+> <DeleteFunction200Response> delete_non_custodial_address(address_id)
+
+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. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::WalletApi.new
+address_id = 'address_id_example' # String | Registered address ID to delete.
+
+begin
+  # Delete (soft-delete) a non-custodial address
+  result = api_instance.delete_non_custodial_address(address_id)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->delete_non_custodial_address: #{e}"
+end
+```
+
+#### Using the delete_non_custodial_address_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<DeleteFunction200Response>, Integer, Hash)> delete_non_custodial_address_with_http_info(address_id)
+
+```ruby
+begin
+  # Delete (soft-delete) a non-custodial address
+  data, status_code, headers = api_instance.delete_non_custodial_address_with_http_info(address_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <DeleteFunction200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->delete_non_custodial_address_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **address_id** | **String** | Registered address ID to delete. |  |
+
+### Return type
+
+[**DeleteFunction200Response**](DeleteFunction200Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## delete_wallet_webhook
+
+> <DeleteFunction200Response> delete_wallet_webhook(webhook_id)
+
+Delete a wallet webhook
+
+Permanently delete a wallet webhook. Delivery will stop immediately.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::WalletApi.new
+webhook_id = 'webhook_id_example' # String | Webhook ID (MongoDB ObjectId) to delete.
+
+begin
+  # Delete a wallet webhook
+  result = api_instance.delete_wallet_webhook(webhook_id)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->delete_wallet_webhook: #{e}"
+end
+```
+
+#### Using the delete_wallet_webhook_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<DeleteFunction200Response>, Integer, Hash)> delete_wallet_webhook_with_http_info(webhook_id)
+
+```ruby
+begin
+  # Delete a wallet webhook
+  data, status_code, headers = api_instance.delete_wallet_webhook_with_http_info(webhook_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <DeleteFunction200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->delete_wallet_webhook_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **webhook_id** | **String** | Webhook ID (MongoDB ObjectId) to delete. |  |
+
+### Return type
+
+[**DeleteFunction200Response**](DeleteFunction200Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## estimate_non_custodial_gas
+
+> <EstimateNonCustodialGas200Response> estimate_non_custodial_gas(estimate_non_custodial_gas_request)
+
+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. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::WalletApi.new
+estimate_non_custodial_gas_request = Mudbase::EstimateNonCustodialGasRequest.new({chain: 'ethereum'}) # EstimateNonCustodialGasRequest | Chain and optional transaction shape (required for EVM). Returns network fee from blockchain.
+
+begin
+  # Estimate network fee from blockchain (all supported chains; not controlled by Mudbase)
+  result = api_instance.estimate_non_custodial_gas(estimate_non_custodial_gas_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->estimate_non_custodial_gas: #{e}"
+end
+```
+
+#### Using the estimate_non_custodial_gas_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<EstimateNonCustodialGas200Response>, Integer, Hash)> estimate_non_custodial_gas_with_http_info(estimate_non_custodial_gas_request)
+
+```ruby
+begin
+  # Estimate network fee from blockchain (all supported chains; not controlled by Mudbase)
+  data, status_code, headers = api_instance.estimate_non_custodial_gas_with_http_info(estimate_non_custodial_gas_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <EstimateNonCustodialGas200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->estimate_non_custodial_gas_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **estimate_non_custodial_gas_request** | [**EstimateNonCustodialGasRequest**](EstimateNonCustodialGasRequest.md) | Chain and optional transaction shape (required for EVM). Returns network fee from blockchain. |  |
+
+### Return type
+
+[**EstimateNonCustodialGas200Response**](EstimateNonCustodialGas200Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## get_cancel_params
+
+> <GetCancelParams200Response> get_cancel_params(get_cancel_params_request)
+
+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. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::WalletApi.new
+get_cancel_params_request = Mudbase::GetCancelParamsRequest.new({chain: 'ethereum'}) # GetCancelParamsRequest | Stuck transaction identifier (txId or txHash) and EVM chain for cancel.
+
+begin
+  # Get replacement tx params for cancel (stuck EVM tx)
+  result = api_instance.get_cancel_params(get_cancel_params_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->get_cancel_params: #{e}"
+end
+```
+
+#### Using the get_cancel_params_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetCancelParams200Response>, Integer, Hash)> get_cancel_params_with_http_info(get_cancel_params_request)
+
+```ruby
+begin
+  # Get replacement tx params for cancel (stuck EVM tx)
+  data, status_code, headers = api_instance.get_cancel_params_with_http_info(get_cancel_params_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetCancelParams200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->get_cancel_params_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **get_cancel_params_request** | [**GetCancelParamsRequest**](GetCancelParamsRequest.md) | Stuck transaction identifier (txId or txHash) and EVM chain for cancel. |  |
+
+### Return type
+
+[**GetCancelParams200Response**](GetCancelParams200Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## get_non_custodial_address
+
+> <NonCustodialAddressResponse> get_non_custodial_address(address_id)
+
+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). 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::WalletApi.new
+address_id = 'address_id_example' # String | Registered address ID (MongoDB ObjectId).
+
+begin
+  # Get non-custodial address by ID
+  result = api_instance.get_non_custodial_address(address_id)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->get_non_custodial_address: #{e}"
+end
+```
+
+#### Using the get_non_custodial_address_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<NonCustodialAddressResponse>, Integer, Hash)> get_non_custodial_address_with_http_info(address_id)
+
+```ruby
+begin
+  # Get non-custodial address by ID
+  data, status_code, headers = api_instance.get_non_custodial_address_with_http_info(address_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <NonCustodialAddressResponse>
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->get_non_custodial_address_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **address_id** | **String** | Registered address ID (MongoDB ObjectId). |  |
+
+### Return type
+
+[**NonCustodialAddressResponse**](NonCustodialAddressResponse.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_non_custodial_balance
+
+> <GetNonCustodialBalance200Response> get_non_custodial_balance(address_id)
+
+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. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::WalletApi.new
+address_id = 'address_id_example' # String | Registered address ID.
+
+begin
+  # Get balance for a non-custodial address
+  result = api_instance.get_non_custodial_balance(address_id)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->get_non_custodial_balance: #{e}"
+end
+```
+
+#### Using the get_non_custodial_balance_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetNonCustodialBalance200Response>, Integer, Hash)> get_non_custodial_balance_with_http_info(address_id)
+
+```ruby
+begin
+  # Get balance for a non-custodial address
+  data, status_code, headers = api_instance.get_non_custodial_balance_with_http_info(address_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetNonCustodialBalance200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->get_non_custodial_balance_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **address_id** | **String** | Registered address ID. |  |
+
+### Return type
+
+[**GetNonCustodialBalance200Response**](GetNonCustodialBalance200Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_non_custodial_transaction_by_hash
+
+> <GetNonCustodialTransactionByHash200Response> get_non_custodial_transaction_by_hash(tx_hash, chain)
+
+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). 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::WalletApi.new
+tx_hash = 'tx_hash_example' # String | Transaction hash (e.g. 0x... for EVM, or block explorer format for UTXO)
+chain = 'ethereum' # String | Chain the transaction belongs to (required for lookup)
+
+begin
+  # Get transaction by hash
+  result = api_instance.get_non_custodial_transaction_by_hash(tx_hash, chain)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->get_non_custodial_transaction_by_hash: #{e}"
+end
+```
+
+#### Using the get_non_custodial_transaction_by_hash_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetNonCustodialTransactionByHash200Response>, Integer, Hash)> get_non_custodial_transaction_by_hash_with_http_info(tx_hash, chain)
+
+```ruby
+begin
+  # Get transaction by hash
+  data, status_code, headers = api_instance.get_non_custodial_transaction_by_hash_with_http_info(tx_hash, chain)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetNonCustodialTransactionByHash200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->get_non_custodial_transaction_by_hash_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **tx_hash** | **String** | Transaction hash (e.g. 0x... for EVM, or block explorer format for UTXO) |  |
+| **chain** | **String** | Chain the transaction belongs to (required for lookup) |  |
+
+### Return type
+
+[**GetNonCustodialTransactionByHash200Response**](GetNonCustodialTransactionByHash200Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_non_custodial_transactions
+
+> <GetNonCustodialTransactions200Response> get_non_custodial_transactions(address_id, opts)
+
+Get transaction history for a non-custodial address
+
+Returns paginated transaction history for a registered non-custodial address (incoming/outgoing, status, confirmations, amounts). 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::WalletApi.new
+address_id = 'address_id_example' # String | Registered address ID.
+opts = {
+  limit: 56, # Integer | Number of transactions per page.
+  page: 56 # Integer | Page number (1-based).
+}
+
+begin
+  # Get transaction history for a non-custodial address
+  result = api_instance.get_non_custodial_transactions(address_id, opts)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->get_non_custodial_transactions: #{e}"
+end
+```
+
+#### Using the get_non_custodial_transactions_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetNonCustodialTransactions200Response>, Integer, Hash)> get_non_custodial_transactions_with_http_info(address_id, opts)
+
+```ruby
+begin
+  # Get transaction history for a non-custodial address
+  data, status_code, headers = api_instance.get_non_custodial_transactions_with_http_info(address_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetNonCustodialTransactions200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->get_non_custodial_transactions_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **address_id** | **String** | Registered address ID. |  |
+| **limit** | **Integer** | Number of transactions per page. | [optional][default to 50] |
+| **page** | **Integer** | Page number (1-based). | [optional][default to 1] |
+
+### Return type
+
+[**GetNonCustodialTransactions200Response**](GetNonCustodialTransactions200Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_speed_up_params
+
+> <GetSpeedUpParams200Response> get_speed_up_params(get_speed_up_params_request)
+
+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. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::WalletApi.new
+get_speed_up_params_request = Mudbase::GetSpeedUpParamsRequest.new({chain: 'ethereum'}) # GetSpeedUpParamsRequest | Stuck transaction identifier (txId or txHash) and EVM chain.
+
+begin
+  # Get replacement tx params for speed-up (stuck EVM tx)
+  result = api_instance.get_speed_up_params(get_speed_up_params_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->get_speed_up_params: #{e}"
+end
+```
+
+#### Using the get_speed_up_params_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetSpeedUpParams200Response>, Integer, Hash)> get_speed_up_params_with_http_info(get_speed_up_params_request)
+
+```ruby
+begin
+  # Get replacement tx params for speed-up (stuck EVM tx)
+  data, status_code, headers = api_instance.get_speed_up_params_with_http_info(get_speed_up_params_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetSpeedUpParams200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->get_speed_up_params_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **get_speed_up_params_request** | [**GetSpeedUpParamsRequest**](GetSpeedUpParamsRequest.md) | Stuck transaction identifier (txId or txHash) and EVM chain. |  |
+
+### Return type
+
+[**GetSpeedUpParams200Response**](GetSpeedUpParams200Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## get_wallet_webhook_logs
+
+> <GetWalletWebhookLogs200Response> get_wallet_webhook_logs(webhook_id, opts)
+
+Get webhook delivery logs
+
+List delivery attempts for a wallet webhook (success/failure, payload, response, duration). Paginated by limit.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure API key authorization: ApiKeyAuth
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::WalletApi.new
+webhook_id = 'webhook_id_example' # String | Webhook ID (MongoDB ObjectId) to get logs for.
+opts = {
+  limit: 56 # Integer | Maximum number of log entries to return.
+}
+
+begin
+  # Get webhook delivery logs
+  result = api_instance.get_wallet_webhook_logs(webhook_id, opts)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->get_wallet_webhook_logs: #{e}"
+end
+```
+
+#### Using the get_wallet_webhook_logs_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetWalletWebhookLogs200Response>, Integer, Hash)> get_wallet_webhook_logs_with_http_info(webhook_id, opts)
+
+```ruby
+begin
+  # Get webhook delivery logs
+  data, status_code, headers = api_instance.get_wallet_webhook_logs_with_http_info(webhook_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetWalletWebhookLogs200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->get_wallet_webhook_logs_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **webhook_id** | **String** | Webhook ID (MongoDB ObjectId) to get logs for. |  |
+| **limit** | **Integer** | Maximum number of log entries to return. | [optional][default to 50] |
+
+### Return type
+
+[**GetWalletWebhookLogs200Response**](GetWalletWebhookLogs200Response.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_non_custodial_addresses
+
+> <ListNonCustodialAddresses200Response> list_non_custodial_addresses(opts)
+
+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. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::WalletApi.new
+opts = {
+  chain: 'ethereum', # String | Filter by chain (optional)
+  project_id: 'project_id_example' # String | Filter by project ID (optional).
+}
+
+begin
+  # List registered non-custodial addresses
+  result = api_instance.list_non_custodial_addresses(opts)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->list_non_custodial_addresses: #{e}"
+end
+```
+
+#### Using the list_non_custodial_addresses_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListNonCustodialAddresses200Response>, Integer, Hash)> list_non_custodial_addresses_with_http_info(opts)
+
+```ruby
+begin
+  # List registered non-custodial addresses
+  data, status_code, headers = api_instance.list_non_custodial_addresses_with_http_info(opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListNonCustodialAddresses200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->list_non_custodial_addresses_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **chain** | **String** | Filter by chain (optional) | [optional] |
+| **project_id** | **String** | Filter by project ID (optional). | [optional] |
+
+### Return type
+
+[**ListNonCustodialAddresses200Response**](ListNonCustodialAddresses200Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_wallet_webhooks
+
+> <ListWalletWebhooks200Response> list_wallet_webhooks(opts)
+
+List wallet webhooks
+
+Returns all wallet webhooks for the current context, optionally filtered by projectId. Includes delivery stats and active status. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::WalletApi.new
+opts = {
+  project_id: 'project_id_example' # String | Filter by project ID (optional).
+}
+
+begin
+  # List wallet webhooks
+  result = api_instance.list_wallet_webhooks(opts)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->list_wallet_webhooks: #{e}"
+end
+```
+
+#### Using the list_wallet_webhooks_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListWalletWebhooks200Response>, Integer, Hash)> list_wallet_webhooks_with_http_info(opts)
+
+```ruby
+begin
+  # List wallet webhooks
+  data, status_code, headers = api_instance.list_wallet_webhooks_with_http_info(opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListWalletWebhooks200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->list_wallet_webhooks_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** | Filter by project ID (optional). | [optional] |
+
+### Return type
+
+[**ListWalletWebhooks200Response**](ListWalletWebhooks200Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## register_non_custodial_address
+
+> <NonCustodialAddressResponse> register_non_custodial_address(register_non_custodial_address_request)
+
+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. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::WalletApi.new
+register_non_custodial_address_request = Mudbase::RegisterNonCustodialAddressRequest.new({address: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb', chain: 'ethereum'}) # RegisterNonCustodialAddressRequest | Public address, chain identifier, and optional derivation path and label. projectId scopes the registration to a project.
+
+begin
+  # Register a non-custodial wallet address
+  result = api_instance.register_non_custodial_address(register_non_custodial_address_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->register_non_custodial_address: #{e}"
+end
+```
+
+#### Using the register_non_custodial_address_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<NonCustodialAddressResponse>, Integer, Hash)> register_non_custodial_address_with_http_info(register_non_custodial_address_request)
+
+```ruby
+begin
+  # Register a non-custodial wallet address
+  data, status_code, headers = api_instance.register_non_custodial_address_with_http_info(register_non_custodial_address_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <NonCustodialAddressResponse>
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->register_non_custodial_address_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **register_non_custodial_address_request** | [**RegisterNonCustodialAddressRequest**](RegisterNonCustodialAddressRequest.md) | Public address, chain identifier, and optional derivation path and label. projectId scopes the registration to a project. |  |
+
+### Return type
+
+[**NonCustodialAddressResponse**](NonCustodialAddressResponse.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## test_wallet_webhook
+
+> <TestWalletWebhook200Response> test_wallet_webhook(test_wallet_webhook_request)
+
+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.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure API key authorization: ApiKeyAuth
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::WalletApi.new
+test_wallet_webhook_request = Mudbase::TestWalletWebhookRequest.new({url: 'url_example'}) # TestWalletWebhookRequest | URL to send the test POST to; optional secret and projectId for scoping; optional event type to simulate.
+
+begin
+  # Test a webhook delivery (sends a single test payload)
+  result = api_instance.test_wallet_webhook(test_wallet_webhook_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->test_wallet_webhook: #{e}"
+end
+```
+
+#### Using the test_wallet_webhook_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<TestWalletWebhook200Response>, Integer, Hash)> test_wallet_webhook_with_http_info(test_wallet_webhook_request)
+
+```ruby
+begin
+  # Test a webhook delivery (sends a single test payload)
+  data, status_code, headers = api_instance.test_wallet_webhook_with_http_info(test_wallet_webhook_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <TestWalletWebhook200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->test_wallet_webhook_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **test_wallet_webhook_request** | [**TestWalletWebhookRequest**](TestWalletWebhookRequest.md) | URL to send the test POST to; optional secret and projectId for scoping; optional event type to simulate. |  |
+
+### Return type
+
+[**TestWalletWebhook200Response**](TestWalletWebhook200Response.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## update_wallet_webhook
+
+> <UpdateWalletWebhook200Response> update_wallet_webhook(webhook_id, update_wallet_webhook_request)
+
+Update a wallet webhook
+
+Update webhook URL, events, secret, or filters. Partially applied; only provided fields are updated.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure API key authorization: ApiKeyAuth
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::WalletApi.new
+webhook_id = 'webhook_id_example' # String | Webhook ID (MongoDB ObjectId) to update.
+update_wallet_webhook_request = Mudbase::UpdateWalletWebhookRequest.new # UpdateWalletWebhookRequest | Fields to update (url, events, secret, filters). Omitted fields are left unchanged.
+
+begin
+  # Update a wallet webhook
+  result = api_instance.update_wallet_webhook(webhook_id, update_wallet_webhook_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->update_wallet_webhook: #{e}"
+end
+```
+
+#### Using the update_wallet_webhook_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<UpdateWalletWebhook200Response>, Integer, Hash)> update_wallet_webhook_with_http_info(webhook_id, update_wallet_webhook_request)
+
+```ruby
+begin
+  # Update a wallet webhook
+  data, status_code, headers = api_instance.update_wallet_webhook_with_http_info(webhook_id, update_wallet_webhook_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <UpdateWalletWebhook200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling WalletApi->update_wallet_webhook_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **webhook_id** | **String** | Webhook ID (MongoDB ObjectId) to update. |  |
+| **update_wallet_webhook_request** | [**UpdateWalletWebhookRequest**](UpdateWalletWebhookRequest.md) | Fields to update (url, events, secret, filters). Omitted fields are left unchanged. |  |
+
+### Return type
+
+[**UpdateWalletWebhook200Response**](UpdateWalletWebhook200Response.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+