mudbase-sdk 1.2.12 → 1.3.7

package/docs/WalletApi.md

@@ -4,29 +4,46 @@ All URIs are relative to *https://cloud.mudbase.dev*
 
 | Method | HTTP request | Description |
 |------------- | ------------- | -------------|
-| [**walletBroadcastTransaction**](WalletApi.md#walletbroadcasttransactionoperation) | **POST** /api/wallet/non-custodial/broadcast | Broadcast a client-signed transaction |
-| [**walletCreateWebhook**](WalletApi.md#walletcreatewebhookoperation) | **POST** /api/wallet/non-custodial/webhooks | Create a wallet webhook |
-| [**walletDeleteAddress**](WalletApi.md#walletdeleteaddress) | **DELETE** /api/wallet/non-custodial/addresses/{addressId} | Delete (soft-delete) a non-custodial address |
-| [**walletDeleteWebhook**](WalletApi.md#walletdeletewebhook) | **DELETE** /api/wallet/non-custodial/webhooks/{webhookId} | Delete a wallet webhook |
-| [**walletEstimateGas**](WalletApi.md#walletestimategasoperation) | **POST** /api/wallet/non-custodial/estimate-gas | Estimate network fee from blockchain (all supported chains; not controlled by Mudbase) |
-| [**walletGetAddress**](WalletApi.md#walletgetaddress) | **GET** /api/wallet/non-custodial/addresses/{addressId} | Get non-custodial address by ID |
-| [**walletGetBalance**](WalletApi.md#walletgetbalance) | **GET** /api/wallet/non-custodial/addresses/{addressId}/balance | Get balance for a non-custodial address |
-| [**walletGetCancelParams**](WalletApi.md#walletgetcancelparamsoperation) | **POST** /api/wallet/non-custodial/cancel | Get replacement tx params for cancel (stuck EVM tx) |
-| [**walletGetSpeedUpParams**](WalletApi.md#walletgetspeedupparamsoperation) | **POST** /api/wallet/non-custodial/speed-up | Get replacement tx params for speed-up (stuck EVM tx) |
-| [**walletGetTransactionByHash**](WalletApi.md#walletgettransactionbyhash) | **GET** /api/wallet/non-custodial/transactions/{txHash} | Get transaction by hash |
-| [**walletGetTransactions**](WalletApi.md#walletgettransactions) | **GET** /api/wallet/non-custodial/addresses/{addressId}/transactions | Get transaction history for a non-custodial address |
-| [**walletGetWebhookLogs**](WalletApi.md#walletgetwebhooklogs) | **GET** /api/wallet/non-custodial/webhooks/{webhookId}/logs | Get webhook delivery logs |
-| [**walletListAddresses**](WalletApi.md#walletlistaddresses) | **GET** /api/wallet/non-custodial/addresses | List registered non-custodial addresses |
-| [**walletListWebhooks**](WalletApi.md#walletlistwebhooks) | **GET** /api/wallet/non-custodial/webhooks | List wallet webhooks |
-| [**walletRegisterAddress**](WalletApi.md#walletregisteraddressoperation) | **POST** /api/wallet/non-custodial/register-address | Register a non-custodial wallet address |
-| [**walletTestWebhook**](WalletApi.md#wallettestwebhookoperation) | **POST** /api/wallet/non-custodial/webhooks/test | Test a webhook delivery (sends a single test payload) |
-| [**walletUpdateWebhook**](WalletApi.md#walletupdatewebhookoperation) | **PUT** /api/wallet/non-custodial/webhooks/{webhookId} | Update a wallet webhook |
-
-
-
-## walletBroadcastTransaction
-
-> WalletBroadcastTransaction200Response walletBroadcastTransaction(walletBroadcastTransactionRequest)
+| [**broadcastNonCustodialTransaction**](WalletApi.md#broadcastnoncustodialtransactionoperation) | **POST** /api/wallet/non-custodial/broadcast | Broadcast a client-signed transaction |
+| [**calculateWalletFee**](WalletApi.md#calculatewalletfee) | **POST** /api/wallet/calculate-fee | Get network fee only (alias for POST /api/wallet/estimate-network-fee) |
+| [**createWallet**](WalletApi.md#createwalletoperation) | **POST** /api/wallet/create | Create new wallet (for testing non-custodial) |
+| [**createWalletWebhook**](WalletApi.md#createwalletwebhookoperation) | **POST** /api/wallet/non-custodial/webhooks | Create a wallet webhook |
+| [**deleteNonCustodialAddress**](WalletApi.md#deletenoncustodialaddress) | **DELETE** /api/wallet/non-custodial/addresses/{addressId} | Delete or deactivate a monitored wallet address |
+| [**deleteWalletWebhook**](WalletApi.md#deletewalletwebhook) | **DELETE** /api/wallet/non-custodial/webhooks/{webhookId} | Delete a wallet webhook |
+| [**estimateNetworkFee**](WalletApi.md#estimatenetworkfeeoperation) | **POST** /api/wallet/estimate-network-fee | Estimate network fee (preferred; reads from fee oracle cache) |
+| [**estimateNonCustodialGas**](WalletApi.md#estimatenoncustodialgasoperation) | **POST** /api/wallet/non-custodial/estimate-gas | Estimate network fee from blockchain (all supported chains; not controlled by Mudbase) |
+| [**generatePrivateKey**](WalletApi.md#generateprivatekeyoperation) | **POST** /api/wallet/generate-key | Generate private key |
+| [**getAllFees**](WalletApi.md#getallfees) | **GET** /api/wallet/fees | Get all chain network fees (fee oracle snapshot) |
+| [**getBalance**](WalletApi.md#getbalance) | **GET** /api/wallet/{walletId}/balance | Get wallet balance |
+| [**getCancelParams**](WalletApi.md#getcancelparamsoperation) | **POST** /api/wallet/non-custodial/cancel | Get replacement tx params for cancel (stuck EVM tx) |
+| [**getNetworkStatus**](WalletApi.md#getnetworkstatus) | **GET** /api/wallet/network-status | Get network status (congestion + fee metric per chain) |
+| [**getNonCustodialAddress**](WalletApi.md#getnoncustodialaddress) | **GET** /api/wallet/non-custodial/addresses/{addressId} | Get non-custodial address by ID |
+| [**getNonCustodialBalance**](WalletApi.md#getnoncustodialbalance) | **GET** /api/wallet/non-custodial/addresses/{addressId}/balance | Get balance for a non-custodial address |
+| [**getNonCustodialTransactionByHash**](WalletApi.md#getnoncustodialtransactionbyhash) | **GET** /api/wallet/non-custodial/transactions/{txHash} | Get transaction by hash |
+| [**getNonCustodialTransactions**](WalletApi.md#getnoncustodialtransactions) | **GET** /api/wallet/non-custodial/addresses/{addressId}/transactions | Get transaction history for a non-custodial address |
+| [**getSpeedUpParams**](WalletApi.md#getspeedupparamsoperation) | **POST** /api/wallet/non-custodial/speed-up | Get replacement tx params for speed-up (stuck EVM tx) |
+| [**getSupportedCurrencies**](WalletApi.md#getsupportedcurrencies) | **GET** /api/wallet/currencies | Get supported currencies and chains |
+| [**getTransaction**](WalletApi.md#gettransaction) | **GET** /api/wallet/transactions/{transactionId} | Get transaction details |
+| [**getTransactionHistory**](WalletApi.md#gettransactionhistory) | **GET** /api/wallet/transactions | Get transaction history (custodial wallets; same monitoring as non-custodial) |
+| [**getUserWallets**](WalletApi.md#getuserwallets) | **GET** /api/wallet | Get user wallets |
+| [**getWalletFeeConfig**](WalletApi.md#getwalletfeeconfig) | **GET** /api/wallet/projects/{projectId}/fee-config | Get project fee configuration (for non-custodial / external users) |
+| [**getWalletPrivateKey**](WalletApi.md#getwalletprivatekey) | **GET** /api/wallet/{walletId}/private-key | Get wallet private key (WARNING: Sensitive data; for testing non-custodial) |
+| [**getWalletWebhookLogs**](WalletApi.md#getwalletwebhooklogs) | **GET** /api/wallet/non-custodial/webhooks/{webhookId}/logs | Get webhook delivery logs |
+| [**listNonCustodialAddresses**](WalletApi.md#listnoncustodialaddresses) | **GET** /api/wallet/non-custodial/addresses | List registered non-custodial addresses |
+| [**listWalletWebhooks**](WalletApi.md#listwalletwebhooks) | **GET** /api/wallet/non-custodial/webhooks | List wallet webhooks |
+| [**registerNonCustodialAddress**](WalletApi.md#registernoncustodialaddressoperation) | **POST** /api/wallet/non-custodial/register-address | Register a non-custodial wallet address |
+| [**testWalletWebhook**](WalletApi.md#testwalletwebhookoperation) | **POST** /api/wallet/non-custodial/webhooks/test | Test a webhook delivery (sends a single test payload) |
+| [**updateNonCustodialAddress**](WalletApi.md#updatenoncustodialaddressoperation) | **PUT** /api/wallet/non-custodial/addresses/{addressId} | Update a monitored wallet address |
+| [**updateWalletFeeConfig**](WalletApi.md#updatewalletfeeconfigoperation) | **PATCH** /api/wallet/projects/{projectId}/fee-config | Update project fee configuration (for non-custodial / external users) |
+| [**updateWalletWebhook**](WalletApi.md#updatewalletwebhookoperation) | **PUT** /api/wallet/non-custodial/webhooks/{webhookId} | Update a wallet webhook |
+| [**validateAddress**](WalletApi.md#validateaddressoperation) | **POST** /api/wallet/validate-address | Validate cryptocurrency address |
+| [**withdraw**](WalletApi.md#withdrawoperation) | **POST** /api/wallet/{walletId}/withdraw | Prepare withdrawal (semi-transaction; broadcast via non-custodial) |
+
+
+
+## broadcastNonCustodialTransaction
+
+> BroadcastNonCustodialTransaction200Response broadcastNonCustodialTransaction(broadcastNonCustodialTransactionRequest)
 
 Broadcast a client-signed transaction
 
@@ -39,23 +56,1114 @@ import {
   Configuration,
   WalletApi,
 } from 'mudbase-sdk';
-import type { WalletBroadcastTransactionOperationRequest } from 'mudbase-sdk';
+import type { BroadcastNonCustodialTransactionOperationRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // BroadcastNonCustodialTransactionRequest
+    broadcastNonCustodialTransactionRequest: {"chain":"ethereum","signedTx":"0x02f87082012a80843b9aca0082520894def456789012345678901234567890123456789094742d35cc6634c0532925a3b844bc9e7595f0beb880de0b6b3a764000080c001a0...","fromAddress":"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"},
+  } satisfies BroadcastNonCustodialTransactionOperationRequest;
+
+  try {
+    const data = await api.broadcastNonCustodialTransaction(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **broadcastNonCustodialTransactionRequest** | [BroadcastNonCustodialTransactionRequest](BroadcastNonCustodialTransactionRequest.md) |  | |
+
+### Return type
+
+[**BroadcastNonCustodialTransaction200Response**](BroadcastNonCustodialTransaction200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Transaction broadcast successfully |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+| **403** | Access denied |  -  |
+| **429** | Rate limit exceeded |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## calculateWalletFee
+
+> CalculateWalletFee200Response calculateWalletFee(estimateNetworkFeeRequest, fresh)
+
+Get network fee only (alias for POST /api/wallet/estimate-network-fee)
+
+Returns **network fee only**, estimated from the blockchain (RPC / fee APIs). No platform fee or project fee. **Same as POST /api/wallet/estimate-network-fee.** Prefer estimate-network-fee for clarity. Supported currencies: BTC, ETH, BNB, LTC, SOL, TRX, USDT, MATIC, AVAX, CELO, DOGE, TON, ADA. For USDT, `network` is required (ETH, BSC, TRX, SOL, POLYGON). Use `?fresh=1` or header `X-Fee-Fresh: true` for a fresh estimate (bypass cache) right before building the transaction for broadcast. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  WalletApi,
+} from 'mudbase-sdk';
+import type { CalculateWalletFeeRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new WalletApi();
+
+  const body = {
+    // EstimateNetworkFeeRequest
+    estimateNetworkFeeRequest: {"currency":"BTC","amount":0.01},
+    // '1' | Bypass cache and fetch current fee (use right before building tx for broadcast) (optional)
+    fresh: fresh_example,
+  } satisfies CalculateWalletFeeRequest;
+
+  try {
+    const data = await api.calculateWalletFee(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **estimateNetworkFeeRequest** | [EstimateNetworkFeeRequest](EstimateNetworkFeeRequest.md) |  | |
+| **fresh** | `1` | Bypass cache and fetch current fee (use right before building tx for broadcast) | [Optional] [Defaults to `undefined`] [Enum: 1] |
+
+### Return type
+
+[**CalculateWalletFee200Response**](CalculateWalletFee200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Network fee only (from blockchain). No platform or project fee. |  -  |
+| **400** | Bad request |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## createWallet
+
+> CreateWallet201Response createWallet(createWalletRequest)
+
+Create new wallet (for testing non-custodial)
+
+Create a custodial wallet. **Custodial is not used in production.** Use this to **test non-custodial flows**: create a wallet, get its private key (GET /api/wallet/{walletId}/private-key), register the same address with POST /api/wallet/non-custodial/register-address, then use estimate-network-fee and POST /api/wallet/non-custodial/broadcast to build and send a signed transaction. Transaction monitoring (pending/confirmed) applies to both custodial and non-custodial WalletTransaction records. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  WalletApi,
+} from 'mudbase-sdk';
+import type { CreateWalletOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // CreateWalletRequest
+    createWalletRequest: {"currency":"CELO","projectId":"6954562e2be74c6233ee53b9","label":"Main Wallet"},
+  } satisfies CreateWalletOperationRequest;
+
+  try {
+    const data = await api.createWallet(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **createWalletRequest** | [CreateWalletRequest](CreateWalletRequest.md) |  | |
+
+### Return type
+
+[**CreateWallet201Response**](CreateWallet201Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **201** | Wallet created successfully |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## createWalletWebhook
+
+> CreateWalletWebhook201Response createWalletWebhook(createWalletWebhookRequest)
+
+Create a wallet webhook
+
+### Example
+
+```ts
+import {
+  Configuration,
+  WalletApi,
+} from 'mudbase-sdk';
+import type { CreateWalletWebhookOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // CreateWalletWebhookRequest
+    createWalletWebhookRequest: {"url":"https://your-app.com/webhooks/wallet","events":["wallet.balance.updated","wallet.transaction.confirmed","wallet.transaction.failed"],"secret":"whsec_abc123xyz789"},
+  } satisfies CreateWalletWebhookOperationRequest;
+
+  try {
+    const data = await api.createWalletWebhook(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **createWalletWebhookRequest** | [CreateWalletWebhookRequest](CreateWalletWebhookRequest.md) |  | |
+
+### Return type
+
+[**CreateWalletWebhook201Response**](CreateWalletWebhook201Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **201** | Webhook created successfully |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+| **429** | Rate limit exceeded |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## deleteNonCustodialAddress
+
+> DeleteFunction200Response deleteNonCustodialAddress(addressId, permanent)
+
+Delete or deactivate a monitored wallet address
+
+**Soft delete (default):** Omit **permanent** or set to false. The address is deactivated (isActive = false); it no longer appears in list or receives monitoring but the record remains for audit. **Permanent delete:** Set query **permanent=true** to remove the address record from the database. Use when you need to fully remove the monitored address. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  WalletApi,
+} from 'mudbase-sdk';
+import type { DeleteNonCustodialAddressRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // string
+    addressId: addressId_example,
+    // boolean | If true, permanently delete the address from the database; if false or omitted, only deactivate (soft delete) (optional)
+    permanent: true,
+  } satisfies DeleteNonCustodialAddressRequest;
+
+  try {
+    const data = await api.deleteNonCustodialAddress(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **addressId** | `string` |  | [Defaults to `undefined`] |
+| **permanent** | `boolean` | If true, permanently delete the address from the database; if false or omitted, only deactivate (soft delete) | [Optional] [Defaults to `false`] |
+
+### Return type
+
+[**DeleteFunction200Response**](DeleteFunction200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Address deactivated or permanently deleted |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Resource not found |  -  |
+| **429** | Rate limit exceeded |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## deleteWalletWebhook
+
+> DeleteFunction200Response deleteWalletWebhook(webhookId)
+
+Delete a wallet webhook
+
+### Example
+
+```ts
+import {
+  Configuration,
+  WalletApi,
+} from 'mudbase-sdk';
+import type { DeleteWalletWebhookRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // string
+    webhookId: webhookId_example,
+  } satisfies DeleteWalletWebhookRequest;
+
+  try {
+    const data = await api.deleteWalletWebhook(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **webhookId** | `string` |  | [Defaults to `undefined`] |
+
+### Return type
+
+[**DeleteFunction200Response**](DeleteFunction200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Webhook deleted successfully |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Resource not found |  -  |
+| **429** | Rate limit exceeded |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## estimateNetworkFee
+
+> EstimateNetworkFee200Response estimateNetworkFee(estimateNetworkFeeRequest, fresh)
+
+Estimate network fee (preferred; reads from fee oracle cache)
+
+Returns **network fee only** from the blockchain. **Preferred endpoint** for network fee. Uses a fee oracle: fees are polled every 15–20s and cached, so responses are fast and RPC load is minimal (same strategy as large wallets). No platform fee. Request/response identical to POST /api/wallet/calculate-fee (which is an alias). See docs/FEE_ARCHITECTURE.md. Supported currencies: BTC, ETH, BNB, LTC, SOL, TRX, USDT, MATIC, AVAX, CELO, DOGE, TON, ADA. For USDT, `network` is required (ETH, BSC, TRX, SOL, POLYGON). **Fresh fee before broadcast:** To avoid stuck transactions, get a fresh estimate right before building/signing: use query `?fresh=1` or header `X-Fee-Fresh: true` to bypass cache. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  WalletApi,
+} from 'mudbase-sdk';
+import type { EstimateNetworkFeeOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new WalletApi();
+
+  const body = {
+    // EstimateNetworkFeeRequest
+    estimateNetworkFeeRequest: {"currency":"BTC","amount":0.01},
+    // '1' | Bypass cache and fetch current fee from RPC/fee API (use right before building tx for broadcast) (optional)
+    fresh: fresh_example,
+  } satisfies EstimateNetworkFeeOperationRequest;
+
+  try {
+    const data = await api.estimateNetworkFee(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **estimateNetworkFeeRequest** | [EstimateNetworkFeeRequest](EstimateNetworkFeeRequest.md) |  | |
+| **fresh** | `1` | Bypass cache and fetch current fee from RPC/fee API (use right before building tx for broadcast) | [Optional] [Defaults to `undefined`] [Enum: 1] |
+
+### Return type
+
+[**EstimateNetworkFee200Response**](EstimateNetworkFee200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Network fee only (from blockchain). No platform or project fee. |  -  |
+| **400** | Bad request |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## estimateNonCustodialGas
+
+> EstimateNonCustodialGas200Response estimateNonCustodialGas(estimateNonCustodialGasRequest)
+
+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. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  WalletApi,
+} from 'mudbase-sdk';
+import type { EstimateNonCustodialGasOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // EstimateNonCustodialGasRequest
+    estimateNonCustodialGasRequest: {"chain":"ethereum","transaction":{"from":"0x742d35Cc6634C0532925a3b844Bc454e4438f44e","to":"0x53d284357ec70cE289D6D64134DfAc8E511c8a3D","value":"1.0"}},
+  } satisfies EstimateNonCustodialGasOperationRequest;
+
+  try {
+    const data = await api.estimateNonCustodialGas(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **estimateNonCustodialGasRequest** | [EstimateNonCustodialGasRequest](EstimateNonCustodialGasRequest.md) |  | |
+
+### Return type
+
+[**EstimateNonCustodialGas200Response**](EstimateNonCustodialGas200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Network fee from blockchain RPC (not from Mudbase logic) |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+| **429** | Rate limit exceeded |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## generatePrivateKey
+
+> GeneratePrivateKey200Response generatePrivateKey(generatePrivateKeyRequest)
+
+Generate private key
+
+### Example
+
+```ts
+import {
+  Configuration,
+  WalletApi,
+} from 'mudbase-sdk';
+import type { GeneratePrivateKeyOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // GeneratePrivateKeyRequest
+    generatePrivateKeyRequest: {"currency":"BTC"},
+  } satisfies GeneratePrivateKeyOperationRequest;
+
+  try {
+    const data = await api.generatePrivateKey(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **generatePrivateKeyRequest** | [GeneratePrivateKeyRequest](GeneratePrivateKeyRequest.md) |  | |
+
+### Return type
+
+[**GeneratePrivateKey200Response**](GeneratePrivateKey200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Private key generated |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getAllFees
+
+> GetAllFees200Response getAllFees()
+
+Get all chain network fees (fee oracle snapshot)
+
+Returns **all chain network fees** in one call. Reads from the fee oracle cache (no RPC during the request). Each chain returns the **full fee object** (networkFee, gasPriceGwei, congestion, estimatedTime, feeTiers for EVM, etc.) for frontend/UX. Use for dashboards or \"current fees\" screens. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  WalletApi,
+} from 'mudbase-sdk';
+import type { GetAllFeesRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new WalletApi();
+
+  try {
+    const data = await api.getAllFees();
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**GetAllFees200Response**](GetAllFees200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Fee oracle snapshot (chain -> full fee object) |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getBalance
+
+> GetBalance200Response getBalance(walletId)
+
+Get wallet balance
+
+### Example
+
+```ts
+import {
+  Configuration,
+  WalletApi,
+} from 'mudbase-sdk';
+import type { GetBalanceRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // string
+    walletId: walletId_example,
+  } satisfies GetBalanceRequest;
+
+  try {
+    const data = await api.getBalance(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **walletId** | `string` |  | [Defaults to `undefined`] |
+
+### Return type
+
+[**GetBalance200Response**](GetBalance200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Wallet balance |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Resource not found |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getCancelParams
+
+> GetCancelParams200Response getCancelParams(getCancelParamsRequest)
+
+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. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  WalletApi,
+} from 'mudbase-sdk';
+import type { GetCancelParamsOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // GetCancelParamsRequest
+    getCancelParamsRequest: {"txHash":"0xabc123...","chain":"ethereum"},
+  } satisfies GetCancelParamsOperationRequest;
+
+  try {
+    const data = await api.getCancelParams(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **getCancelParamsRequest** | [GetCancelParamsRequest](GetCancelParamsRequest.md) |  | |
+
+### Return type
+
+[**GetCancelParams200Response**](GetCancelParams200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Cancel tx params (client signs and broadcasts via /broadcast) |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+| **403** | Access denied |  -  |
+| **404** | Resource not found |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getNetworkStatus
+
+> GetNetworkStatus200Response getNetworkStatus()
+
+Get network status (congestion + fee metric per chain)
+
+Returns **network status** per chain (congestion and main fee metric). Use to show network health before sending transactions. Same data as GET /fees but trimmed to congestion + gasPriceGwei (EVM) or satPerVb (UTXO) and networkFee. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  WalletApi,
+} from 'mudbase-sdk';
+import type { GetNetworkStatusRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new WalletApi();
+
+  try {
+    const data = await api.getNetworkStatus();
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**GetNetworkStatus200Response**](GetNetworkStatus200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Network status per chain |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getNonCustodialAddress
+
+> NonCustodialAddressResponse getNonCustodialAddress(addressId)
+
+Get non-custodial address by ID
+
+### Example
+
+```ts
+import {
+  Configuration,
+  WalletApi,
+} from 'mudbase-sdk';
+import type { GetNonCustodialAddressRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // string
+    addressId: addressId_example,
+  } satisfies GetNonCustodialAddressRequest;
+
+  try {
+    const data = await api.getNonCustodialAddress(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **addressId** | `string` |  | [Defaults to `undefined`] |
+
+### Return type
+
+[**NonCustodialAddressResponse**](NonCustodialAddressResponse.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Address details |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Resource not found |  -  |
+| **429** | Rate limit exceeded |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getNonCustodialBalance
+
+> GetNonCustodialBalance200Response getNonCustodialBalance(addressId)
+
+Get balance for a non-custodial address
+
+### Example
+
+```ts
+import {
+  Configuration,
+  WalletApi,
+} from 'mudbase-sdk';
+import type { GetNonCustodialBalanceRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // string
+    addressId: addressId_example,
+  } satisfies GetNonCustodialBalanceRequest;
+
+  try {
+    const data = await api.getNonCustodialBalance(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **addressId** | `string` |  | [Defaults to `undefined`] |
+
+### Return type
+
+[**GetNonCustodialBalance200Response**](GetNonCustodialBalance200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Balance information |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Resource not found |  -  |
+| **429** | Rate limit exceeded |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getNonCustodialTransactionByHash
+
+> GetNonCustodialTransactionByHash200Response getNonCustodialTransactionByHash(txHash, 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). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  WalletApi,
+} from 'mudbase-sdk';
+import type { GetNonCustodialTransactionByHashRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new WalletApi(config);
 
   const body = {
-    // WalletBroadcastTransactionRequest | Chain, signed transaction (hex), and fromAddress (must be registered).
-    walletBroadcastTransactionRequest: {"chain":"ethereum","signedTx":"0x02f87082012a80843b9aca0082520894def456789012345678901234567890123456789094742d35cc6634c0532925a3b844bc9e7595f0beb880de0b6b3a764000080c001a0...","fromAddress":"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"},
-  } satisfies WalletBroadcastTransactionOperationRequest;
+    // string | Transaction hash (e.g. 0x... for EVM, or block explorer format for UTXO)
+    txHash: txHash_example,
+    // 'ethereum' | 'binance' | 'polygon' | 'celo' | 'bitcoin' | 'litecoin' | 'solana' | 'tron' | 'ripple' | 'cardano' | 'dogecoin' | 'ton' | Chain the transaction belongs to (required for lookup)
+    chain: chain_example,
+  } satisfies GetNonCustodialTransactionByHashRequest;
 
   try {
-    const data = await api.walletBroadcastTransaction(body);
+    const data = await api.getNonCustodialTransactionByHash(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -71,41 +1179,40 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **walletBroadcastTransactionRequest** | [WalletBroadcastTransactionRequest](WalletBroadcastTransactionRequest.md) | Chain, signed transaction (hex), and fromAddress (must be registered). | |
+| **txHash** | `string` | Transaction hash (e.g. 0x... for EVM, or block explorer format for UTXO) | [Defaults to `undefined`] |
+| **chain** | `ethereum`, `binance`, `polygon`, `celo`, `bitcoin`, `litecoin`, `solana`, `tron`, `ripple`, `cardano`, `dogecoin`, `ton` | Chain the transaction belongs to (required for lookup) | [Defaults to `undefined`] [Enum: ethereum, binance, polygon, celo, bitcoin, litecoin, solana, tron, ripple, cardano, dogecoin, ton] |
 
 ### Return type
 
-[**WalletBroadcastTransaction200Response**](WalletBroadcastTransaction200Response.md)
+[**GetNonCustodialTransactionByHash200Response**](GetNonCustodialTransactionByHash200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
-- **Content-Type**: `application/json`
+- **Content-Type**: Not defined
 - **Accept**: `application/json`
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Transaction broadcast successfully |  -  |
-| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \"Validation failed\", \"projectId is required\", \"No file provided\", \"Invalid project ID format\". **details** may contain validation errors when present.  |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
-| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **200** | Transaction details |  -  |
+| **400** | Bad Request - missing or invalid chain (add ?chain=ethereum) |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Resource not found |  -  |
+| **429** | Rate limit exceeded |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## walletCreateWebhook
-
-> WalletCreateWebhook201Response walletCreateWebhook(walletCreateWebhookRequest)
+## getNonCustodialTransactions
 
-Create a wallet webhook
+> GetNonCustodialTransactions200Response getNonCustodialTransactions(addressId, limit, page)
 
-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. 
+Get transaction history for a non-custodial address
 
 ### Example
 
@@ -114,23 +1221,29 @@ import {
   Configuration,
   WalletApi,
 } from 'mudbase-sdk';
-import type { WalletCreateWebhookOperationRequest } from 'mudbase-sdk';
+import type { GetNonCustodialTransactionsRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new WalletApi(config);
 
   const body = {
-    // WalletCreateWebhookRequest | Webhook URL, events array, optional secret and filters (addresses, chains, projectId).
-    walletCreateWebhookRequest: {"url":"https://your-app.com/webhooks/wallet","events":["wallet.balance.updated","wallet.transaction.confirmed","wallet.transaction.failed"],"secret":"whsec_abc123xyz789"},
-  } satisfies WalletCreateWebhookOperationRequest;
+    // string
+    addressId: addressId_example,
+    // number (optional)
+    limit: 56,
+    // number (optional)
+    page: 56,
+  } satisfies GetNonCustodialTransactionsRequest;
 
   try {
-    const data = await api.walletCreateWebhook(body);
+    const data = await api.getNonCustodialTransactions(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -146,40 +1259,42 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **walletCreateWebhookRequest** | [WalletCreateWebhookRequest](WalletCreateWebhookRequest.md) | Webhook URL, events array, optional secret and filters (addresses, chains, projectId). | |
+| **addressId** | `string` |  | [Defaults to `undefined`] |
+| **limit** | `number` |  | [Optional] [Defaults to `50`] |
+| **page** | `number` |  | [Optional] [Defaults to `1`] |
 
 ### Return type
 
-[**WalletCreateWebhook201Response**](WalletCreateWebhook201Response.md)
+[**GetNonCustodialTransactions200Response**](GetNonCustodialTransactions200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
-- **Content-Type**: `application/json`
+- **Content-Type**: Not defined
 - **Accept**: `application/json`
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **201** | Webhook created successfully |  -  |
-| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \"Validation failed\", \"projectId is required\", \"No file provided\", \"Invalid project ID format\". **details** may contain validation errors when present.  |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **200** | Transaction history |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Resource not found |  -  |
+| **429** | Rate limit exceeded |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## walletDeleteAddress
+## getSpeedUpParams
 
-> FunctionsDelete200Response walletDeleteAddress(addressId)
+> GetSpeedUpParams200Response getSpeedUpParams(getSpeedUpParamsRequest)
 
-Delete (soft-delete) a non-custodial address
+Get replacement tx params for speed-up (stuck EVM tx)
 
-Soft-deletes a registered non-custodial address. The address is marked inactive and no longer used for broadcasts or balance/transaction queries. 
+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. 
 
 ### Example
 
@@ -188,23 +1303,25 @@ import {
   Configuration,
   WalletApi,
 } from 'mudbase-sdk';
-import type { WalletDeleteAddressRequest } from 'mudbase-sdk';
+import type { GetSpeedUpParamsOperationRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new WalletApi(config);
 
   const body = {
-    // string | Registered address ID to delete.
-    addressId: addressId_example,
-  } satisfies WalletDeleteAddressRequest;
+    // GetSpeedUpParamsRequest
+    getSpeedUpParamsRequest: {"txHash":"0xabc123...","chain":"ethereum"},
+  } satisfies GetSpeedUpParamsOperationRequest;
 
   try {
-    const data = await api.walletDeleteAddress(body);
+    const data = await api.getSpeedUpParams(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -220,41 +1337,98 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **addressId** | `string` | Registered address ID to delete. | [Defaults to `undefined`] |
+| **getSpeedUpParamsRequest** | [GetSpeedUpParamsRequest](GetSpeedUpParamsRequest.md) |  | |
 
 ### Return type
 
-[**FunctionsDelete200Response**](FunctionsDelete200Response.md)
+[**GetSpeedUpParams200Response**](GetSpeedUpParams200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
-- **Content-Type**: Not defined
+- **Content-Type**: `application/json`
 - **Accept**: `application/json`
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Address deleted successfully |  -  |
-| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \"Validation failed\", \"projectId is required\", \"No file provided\", \"Invalid project ID format\". **details** may contain validation errors when present.  |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **404** | Resource not found. The **error** field contains the exact backend message, e.g. \"File not found\", \"Project not found\", \"User not found\", \"Project not found or access denied\", \"Webhook not found\", \"Organization not found\".  |  -  |
-| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **200** | Replacement tx params (client signs and broadcasts via /broadcast) |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+| **403** | Access denied |  -  |
+| **404** | Resource not found |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## walletDeleteWebhook
+## getSupportedCurrencies
 
-> FunctionsDelete200Response walletDeleteWebhook(webhookId)
+> GetSupportedCurrencies200Response getSupportedCurrencies()
 
-Delete a wallet webhook
+Get supported currencies and chains
+
+Returns the list of **platform-supported cryptocurrencies and chains** for non-custodial wallets, broadcast, and multi-chain use. Custodial wallet is no longer used in production; this endpoint is the source of truth for supported chains and currencies. **Supported:** BTC, LTC, DOGE, ETH, ETC, CELO, SOL, TRX, TON, Polygon (MATIC), Arbitrum, Optimism, Base, BSC/BNB, Avalanche (AVAX), Cardano (ADA), USDT. Each item includes **code** (currency symbol), **name** (display name), **chain** (chain id for API calls). USDT includes **networks** (ETH, BSC, TRX, SOL, POLYGON). Use **chain** with non-custodial endpoints (register-address, broadcast, estimate-gas). Use **code** for display and fee/currency selection. This is a public endpoint - no authentication required. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  WalletApi,
+} from 'mudbase-sdk';
+import type { GetSupportedCurrenciesRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new WalletApi();
+
+  try {
+    const data = await api.getSupportedCurrencies();
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**GetSupportedCurrencies200Response**](GetSupportedCurrencies200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Supported currencies and chains (currencies array and count) |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
-Permanently delete a wallet webhook. Delivery will stop immediately.
+
+## getTransaction
+
+> GetTransaction200Response getTransaction(transactionId)
+
+Get transaction details
 
 ### Example
 
@@ -263,23 +1437,25 @@ import {
   Configuration,
   WalletApi,
 } from 'mudbase-sdk';
-import type { WalletDeleteWebhookRequest } from 'mudbase-sdk';
+import type { GetTransactionRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new WalletApi(config);
 
   const body = {
-    // string | Webhook ID (MongoDB ObjectId) to delete.
-    webhookId: webhookId_example,
-  } satisfies WalletDeleteWebhookRequest;
+    // string
+    transactionId: transactionId_example,
+  } satisfies GetTransactionRequest;
 
   try {
-    const data = await api.walletDeleteWebhook(body);
+    const data = await api.getTransaction(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -295,15 +1471,15 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **webhookId** | `string` | Webhook ID (MongoDB ObjectId) to delete. | [Defaults to `undefined`] |
+| **transactionId** | `string` |  | [Defaults to `undefined`] |
 
 ### Return type
 
-[**FunctionsDelete200Response**](FunctionsDelete200Response.md)
+[**GetTransaction200Response**](GetTransaction200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -314,22 +1490,20 @@ example().catch(console.error);
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Webhook deleted successfully |  -  |
-| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \"Validation failed\", \"projectId is required\", \"No file provided\", \"Invalid project ID format\". **details** may contain validation errors when present.  |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **404** | Webhook not found (exact backend message for webhook endpoints). |  -  |
-| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **200** | Transaction details |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Resource not found |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## walletEstimateGas
+## getTransactionHistory
 
-> WalletEstimateGas200Response walletEstimateGas(walletEstimateGasRequest)
+> GetTransactionHistory200Response getTransactionHistory(walletId, limit, page)
 
-Estimate network fee from blockchain (all supported chains; not controlled by Mudbase)
+Get transaction history (custodial wallets; same monitoring as non-custodial)
 
-**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. 
+Returns transaction history for custodial wallets. Transactions are stored and monitored the same way as non-custodial (WalletTransaction); status updates (pending, broadcast, confirmed, failed) and stuck detection apply to both. 
 
 ### Example
 
@@ -338,23 +1512,29 @@ import {
   Configuration,
   WalletApi,
 } from 'mudbase-sdk';
-import type { WalletEstimateGasOperationRequest } from 'mudbase-sdk';
+import type { GetTransactionHistoryRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new WalletApi(config);
 
   const body = {
-    // WalletEstimateGasRequest | Chain and optional transaction shape (required for EVM). Returns network fee from blockchain.
-    walletEstimateGasRequest: {"chain":"ethereum","transaction":{"from":"0x742d35Cc6634C0532925a3b844Bc454e4438f44e","to":"0x53d284357ec70cE289D6D64134DfAc8E511c8a3D","value":"1.0"}},
-  } satisfies WalletEstimateGasOperationRequest;
+    // string (optional)
+    walletId: walletId_example,
+    // number (optional)
+    limit: 56,
+    // number (optional)
+    page: 56,
+  } satisfies GetTransactionHistoryRequest;
 
   try {
-    const data = await api.walletEstimateGas(body);
+    const data = await api.getTransactionHistory(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -370,40 +1550,38 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **walletEstimateGasRequest** | [WalletEstimateGasRequest](WalletEstimateGasRequest.md) | Chain and optional transaction shape (required for EVM). Returns network fee from blockchain. | |
+| **walletId** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **limit** | `number` |  | [Optional] [Defaults to `20`] |
+| **page** | `number` |  | [Optional] [Defaults to `1`] |
 
 ### Return type
 
-[**WalletEstimateGas200Response**](WalletEstimateGas200Response.md)
+[**GetTransactionHistory200Response**](GetTransactionHistory200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
-- **Content-Type**: `application/json`
+- **Content-Type**: Not defined
 - **Accept**: `application/json`
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Network fee from blockchain RPC (not from Mudbase logic) |  -  |
-| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \"Validation failed\", \"projectId is required\", \"No file provided\", \"Invalid project ID format\". **details** may contain validation errors when present.  |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **200** | Transaction history |  -  |
+| **401** | Authentication required |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## walletGetAddress
+## getUserWallets
 
-> NonCustodialAddressResponse walletGetAddress(addressId)
+> GetUserWallets200Response getUserWallets(projectId, currency)
 
-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). 
+Get user wallets
 
 ### Example
 
@@ -412,23 +1590,27 @@ import {
   Configuration,
   WalletApi,
 } from 'mudbase-sdk';
-import type { WalletGetAddressRequest } from 'mudbase-sdk';
+import type { GetUserWalletsRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new WalletApi(config);
 
   const body = {
-    // string | Registered address ID (MongoDB ObjectId).
-    addressId: addressId_example,
-  } satisfies WalletGetAddressRequest;
+    // string (optional)
+    projectId: projectId_example,
+    // string (optional)
+    currency: currency_example,
+  } satisfies GetUserWalletsRequest;
 
   try {
-    const data = await api.walletGetAddress(body);
+    const data = await api.getUserWallets(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -444,15 +1626,16 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **addressId** | `string` | Registered address ID (MongoDB ObjectId). | [Defaults to `undefined`] |
+| **projectId** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **currency** | `string` |  | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
-[**NonCustodialAddressResponse**](NonCustodialAddressResponse.md)
+[**GetUserWallets200Response**](GetUserWallets200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -463,21 +1646,19 @@ example().catch(console.error);
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Address details |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **404** | Resource not found. The **error** field contains the exact backend message, e.g. \"File not found\", \"Project not found\", \"User not found\", \"Project not found or access denied\", \"Webhook not found\", \"Organization not found\".  |  -  |
-| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **200** | User wallets list (custodial; for testing) |  -  |
+| **401** | Authentication required |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## walletGetBalance
+## getWalletFeeConfig
 
-> WalletGetBalance200Response walletGetBalance(addressId)
+> GetWalletFeeConfig200Response getWalletFeeConfig(projectId)
 
-Get balance for a non-custodial address
+Get project fee configuration (for non-custodial / external users)
 
-Returns native token balance (confirmed, unconfirmed, total, currency) for a registered non-custodial address. Updated periodically from the chain. 
+Get project-level fee settings (enabled flag and fee percentage). **For non-custodial / external users** — e.g. when your app charges a fee on payouts or transfers. Custodial wallet is no longer used in production. Applies to all supported chains/currencies for that project. 
 
 ### Example
 
@@ -486,23 +1667,25 @@ import {
   Configuration,
   WalletApi,
 } from 'mudbase-sdk';
-import type { WalletGetBalanceRequest } from 'mudbase-sdk';
+import type { GetWalletFeeConfigRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new WalletApi(config);
 
   const body = {
-    // string | Registered address ID.
-    addressId: addressId_example,
-  } satisfies WalletGetBalanceRequest;
+    // string | Project ID
+    projectId: projectId_example,
+  } satisfies GetWalletFeeConfigRequest;
 
   try {
-    const data = await api.walletGetBalance(body);
+    const data = await api.getWalletFeeConfig(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -518,15 +1701,15 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **addressId** | `string` | Registered address ID. | [Defaults to `undefined`] |
+| **projectId** | `string` | Project ID | [Defaults to `undefined`] |
 
 ### Return type
 
-[**WalletGetBalance200Response**](WalletGetBalance200Response.md)
+[**GetWalletFeeConfig200Response**](GetWalletFeeConfig200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -537,21 +1720,19 @@ example().catch(console.error);
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Balance information |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **404** | Resource not found. The **error** field contains the exact backend message, e.g. \"File not found\", \"Project not found\", \"User not found\", \"Project not found or access denied\", \"Webhook not found\", \"Organization not found\".  |  -  |
-| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **200** | Fee configuration (applies to all supported currencies/chains for this project) |  -  |
+| **404** | Resource not found |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## walletGetCancelParams
+## getWalletPrivateKey
 
-> WalletGetCancelParams200Response walletGetCancelParams(walletGetCancelParamsRequest)
+> GetWalletPrivateKey200Response getWalletPrivateKey(walletId)
 
-Get replacement tx params for cancel (stuck EVM tx)
+Get wallet private key (WARNING: Sensitive data; for testing non-custodial)
 
-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. 
+Returns the wallet private key. **For testing non-custodial only:** use this key to sign a transaction locally, then register the wallet address via POST /api/wallet/non-custodial/register-address and broadcast the signed tx via POST /api/wallet/non-custodial/broadcast. 
 
 ### Example
 
@@ -560,23 +1741,25 @@ import {
   Configuration,
   WalletApi,
 } from 'mudbase-sdk';
-import type { WalletGetCancelParamsOperationRequest } from 'mudbase-sdk';
+import type { GetWalletPrivateKeyRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new WalletApi(config);
 
   const body = {
-    // WalletGetCancelParamsRequest | Stuck transaction identifier (txId or txHash) and EVM chain for cancel.
-    walletGetCancelParamsRequest: {"txHash":"0xabc123...","chain":"ethereum"},
-  } satisfies WalletGetCancelParamsOperationRequest;
+    // string
+    walletId: walletId_example,
+  } satisfies GetWalletPrivateKeyRequest;
 
   try {
-    const data = await api.walletGetCancelParams(body);
+    const data = await api.getWalletPrivateKey(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -592,41 +1775,38 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **walletGetCancelParamsRequest** | [WalletGetCancelParamsRequest](WalletGetCancelParamsRequest.md) | Stuck transaction identifier (txId or txHash) and EVM chain for cancel. | |
+| **walletId** | `string` |  | [Defaults to `undefined`] |
 
 ### Return type
 
-[**WalletGetCancelParams200Response**](WalletGetCancelParams200Response.md)
+[**GetWalletPrivateKey200Response**](GetWalletPrivateKey200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
-- **Content-Type**: `application/json`
+- **Content-Type**: Not defined
 - **Accept**: `application/json`
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Cancel tx params (client signs and broadcasts via /broadcast) |  -  |
-| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \"Validation failed\", \"projectId is required\", \"No file provided\", \"Invalid project ID format\". **details** may contain validation errors when present.  |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
-| **404** | Resource not found. The **error** field contains the exact backend message, e.g. \"File not found\", \"Project not found\", \"User not found\", \"Project not found or access denied\", \"Webhook not found\", \"Organization not found\".  |  -  |
+| **200** | Private key (shown only once) |  -  |
+| **401** | Authentication required |  -  |
+| **403** | Access denied |  -  |
+| **404** | Resource not found |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## walletGetSpeedUpParams
+## getWalletWebhookLogs
 
-> WalletGetSpeedUpParams200Response walletGetSpeedUpParams(walletGetSpeedUpParamsRequest)
-
-Get replacement tx params for speed-up (stuck EVM tx)
+> GetWalletWebhookLogs200Response getWalletWebhookLogs(webhookId, limit)
 
-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. 
+Get webhook delivery logs
 
 ### Example
 
@@ -635,23 +1815,25 @@ import {
   Configuration,
   WalletApi,
 } from 'mudbase-sdk';
-import type { WalletGetSpeedUpParamsOperationRequest } from 'mudbase-sdk';
+import type { GetWalletWebhookLogsRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new WalletApi(config);
 
   const body = {
-    // WalletGetSpeedUpParamsRequest | Stuck transaction identifier (txId or txHash) and EVM chain.
-    walletGetSpeedUpParamsRequest: {"txHash":"0xabc123...","chain":"ethereum"},
-  } satisfies WalletGetSpeedUpParamsOperationRequest;
+    // string
+    webhookId: webhookId_example,
+    // number (optional)
+    limit: 56,
+  } satisfies GetWalletWebhookLogsRequest;
 
   try {
-    const data = await api.walletGetSpeedUpParams(body);
+    const data = await api.getWalletWebhookLogs(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -667,41 +1849,39 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **walletGetSpeedUpParamsRequest** | [WalletGetSpeedUpParamsRequest](WalletGetSpeedUpParamsRequest.md) | Stuck transaction identifier (txId or txHash) and EVM chain. | |
+| **webhookId** | `string` |  | [Defaults to `undefined`] |
+| **limit** | `number` |  | [Optional] [Defaults to `50`] |
 
 ### Return type
 
-[**WalletGetSpeedUpParams200Response**](WalletGetSpeedUpParams200Response.md)
+[**GetWalletWebhookLogs200Response**](GetWalletWebhookLogs200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth)
 
 ### HTTP request headers
 
-- **Content-Type**: `application/json`
+- **Content-Type**: Not defined
 - **Accept**: `application/json`
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Replacement tx params (client signs and broadcasts via /broadcast) |  -  |
-| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \"Validation failed\", \"projectId is required\", \"No file provided\", \"Invalid project ID format\". **details** may contain validation errors when present.  |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
-| **404** | Resource not found. The **error** field contains the exact backend message, e.g. \"File not found\", \"Project not found\", \"User not found\", \"Project not found or access denied\", \"Webhook not found\", \"Organization not found\".  |  -  |
+| **200** | Webhook delivery logs |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Resource not found |  -  |
+| **429** | Rate limit exceeded |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## walletGetTransactionByHash
+## listNonCustodialAddresses
 
-> WalletGetTransactionByHash200Response walletGetTransactionByHash(txHash, chain)
+> ListNonCustodialAddresses200Response listNonCustodialAddresses(chain, projectId)
 
-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). 
+List registered non-custodial addresses
 
 ### Example
 
@@ -710,25 +1890,27 @@ import {
   Configuration,
   WalletApi,
 } from 'mudbase-sdk';
-import type { WalletGetTransactionByHashRequest } from 'mudbase-sdk';
+import type { ListNonCustodialAddressesRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new WalletApi(config);
 
   const body = {
-    // string | Transaction hash (e.g. 0x... for EVM, or block explorer format for UTXO)
-    txHash: txHash_example,
-    // 'ethereum' | 'binance' | 'polygon' | 'celo' | 'bitcoin' | 'litecoin' | 'solana' | 'tron' | 'ripple' | 'cardano' | 'dogecoin' | 'ton' | Chain the transaction belongs to (required for lookup)
+    // 'ethereum' | 'binance' | 'bsc' | 'polygon' | 'arbitrum' | 'optimism' | 'base' | 'avalanche' | 'celo' | 'bitcoin' | 'litecoin' | 'dogecoin' | 'solana' | 'tron' | 'ripple' | 'cardano' | 'ton' | Filter by chain (optional) (optional)
     chain: chain_example,
-  } satisfies WalletGetTransactionByHashRequest;
+    // string (optional)
+    projectId: projectId_example,
+  } satisfies ListNonCustodialAddressesRequest;
 
   try {
-    const data = await api.walletGetTransactionByHash(body);
+    const data = await api.listNonCustodialAddresses(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -744,16 +1926,16 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **txHash** | `string` | Transaction hash (e.g. 0x... for EVM, or block explorer format for UTXO) | [Defaults to `undefined`] |
-| **chain** | `ethereum`, `binance`, `polygon`, `celo`, `bitcoin`, `litecoin`, `solana`, `tron`, `ripple`, `cardano`, `dogecoin`, `ton` | Chain the transaction belongs to (required for lookup) | [Defaults to `undefined`] [Enum: ethereum, binance, polygon, celo, bitcoin, litecoin, solana, tron, ripple, cardano, dogecoin, ton] |
+| **chain** | `ethereum`, `binance`, `bsc`, `polygon`, `arbitrum`, `optimism`, `base`, `avalanche`, `celo`, `bitcoin`, `litecoin`, `dogecoin`, `solana`, `tron`, `ripple`, `cardano`, `ton` | Filter by chain (optional) | [Optional] [Defaults to `undefined`] [Enum: ethereum, binance, bsc, polygon, arbitrum, optimism, base, avalanche, celo, bitcoin, litecoin, dogecoin, solana, tron, ripple, cardano, ton] |
+| **projectId** | `string` |  | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
-[**WalletGetTransactionByHash200Response**](WalletGetTransactionByHash200Response.md)
+[**ListNonCustodialAddresses200Response**](ListNonCustodialAddresses200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -764,22 +1946,18 @@ example().catch(console.error);
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Transaction details |  -  |
-| **400** | Bad Request - missing or invalid chain (add ?chain=ethereum) |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **404** | Resource not found. The **error** field contains the exact backend message, e.g. \"File not found\", \"Project not found\", \"User not found\", \"Project not found or access denied\", \"Webhook not found\", \"Organization not found\".  |  -  |
-| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **200** | List of registered addresses |  -  |
+| **401** | Authentication required |  -  |
+| **429** | Rate limit exceeded |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## walletGetTransactions
+## listWalletWebhooks
 
-> WalletGetTransactions200Response walletGetTransactions(addressId, limit, page)
+> ListWalletWebhooks200Response listWalletWebhooks(projectId)
 
-Get transaction history for a non-custodial address
-
-Returns paginated transaction history for a registered non-custodial address (incoming/outgoing, status, confirmations, amounts). 
+List wallet webhooks
 
 ### Example
 
@@ -788,27 +1966,25 @@ import {
   Configuration,
   WalletApi,
 } from 'mudbase-sdk';
-import type { WalletGetTransactionsRequest } from 'mudbase-sdk';
+import type { ListWalletWebhooksRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new WalletApi(config);
 
   const body = {
-    // string | Registered address ID.
-    addressId: addressId_example,
-    // number | Number of transactions per page. (optional)
-    limit: 56,
-    // number | Page number (1-based). (optional)
-    page: 56,
-  } satisfies WalletGetTransactionsRequest;
+    // string (optional)
+    projectId: projectId_example,
+  } satisfies ListWalletWebhooksRequest;
 
   try {
-    const data = await api.walletGetTransactions(body);
+    const data = await api.listWalletWebhooks(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -824,17 +2000,15 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **addressId** | `string` | Registered address ID. | [Defaults to `undefined`] |
-| **limit** | `number` | Number of transactions per page. | [Optional] [Defaults to `50`] |
-| **page** | `number` | Page number (1-based). | [Optional] [Defaults to `1`] |
+| **projectId** | `string` |  | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
-[**WalletGetTransactions200Response**](WalletGetTransactions200Response.md)
+[**ListWalletWebhooks200Response**](ListWalletWebhooks200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -845,21 +2019,20 @@ example().catch(console.error);
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Transaction history |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **404** | Resource not found. The **error** field contains the exact backend message, e.g. \"File not found\", \"Project not found\", \"User not found\", \"Project not found or access denied\", \"Webhook not found\", \"Organization not found\".  |  -  |
-| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **200** | List of webhooks |  -  |
+| **401** | Authentication required |  -  |
+| **429** | Rate limit exceeded |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## walletGetWebhookLogs
+## registerNonCustodialAddress
 
-> WalletGetWebhookLogs200Response walletGetWebhookLogs(webhookId, limit)
+> NonCustodialAddressResponse registerNonCustodialAddress(registerNonCustodialAddressRequest)
 
-Get webhook delivery logs
+Register a non-custodial wallet address
 
-List delivery attempts for a wallet webhook (success/failure, payload, response, duration). Paginated by limit.
+Register a public wallet address for monitoring and indexing. All key operations (generation, signing) occur client-side only. 
 
 ### Example
 
@@ -868,27 +2041,25 @@ import {
   Configuration,
   WalletApi,
 } from 'mudbase-sdk';
-import type { WalletGetWebhookLogsRequest } from 'mudbase-sdk';
+import type { RegisterNonCustodialAddressOperationRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // To configure API key authorization: ApiKeyAuth
-    apiKey: "YOUR API KEY",
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new WalletApi(config);
 
   const body = {
-    // string | Webhook ID (MongoDB ObjectId) to get logs for.
-    webhookId: webhookId_example,
-    // number | Maximum number of log entries to return. (optional)
-    limit: 56,
-  } satisfies WalletGetWebhookLogsRequest;
+    // RegisterNonCustodialAddressRequest
+    registerNonCustodialAddressRequest: {"address":"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb","chain":"ethereum","derivationPath":"m/44'/60'/0'/0/5","label":"Main Ethereum Wallet"},
+  } satisfies RegisterNonCustodialAddressOperationRequest;
 
   try {
-    const data = await api.walletGetWebhookLogs(body);
+    const data = await api.registerNonCustodialAddress(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -904,41 +2075,38 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **webhookId** | `string` | Webhook ID (MongoDB ObjectId) to get logs for. | [Defaults to `undefined`] |
-| **limit** | `number` | Maximum number of log entries to return. | [Optional] [Defaults to `50`] |
+| **registerNonCustodialAddressRequest** | [RegisterNonCustodialAddressRequest](RegisterNonCustodialAddressRequest.md) |  | |
 
 ### Return type
 
-[**WalletGetWebhookLogs200Response**](WalletGetWebhookLogs200Response.md)
+[**NonCustodialAddressResponse**](NonCustodialAddressResponse.md)
 
 ### Authorization
 
-[ApiKeyAuth](../README.md#ApiKeyAuth), [BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
-- **Content-Type**: Not defined
+- **Content-Type**: `application/json`
 - **Accept**: `application/json`
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Webhook delivery logs |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **404** | Webhook not found (exact backend message for webhook endpoints). |  -  |
-| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **201** | Address registered successfully |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+| **429** | Rate limit exceeded |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## walletListAddresses
+## testWalletWebhook
 
-> WalletListAddresses200Response walletListAddresses(chain, projectId)
+> TestWalletWebhook200Response testWalletWebhook(testWalletWebhookRequest)
 
-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. 
+Test a webhook delivery (sends a single test payload)
 
 ### Example
 
@@ -947,25 +2115,23 @@ import {
   Configuration,
   WalletApi,
 } from 'mudbase-sdk';
-import type { WalletListAddressesRequest } from 'mudbase-sdk';
+import type { TestWalletWebhookOperationRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new WalletApi(config);
 
   const body = {
-    // 'ethereum' | 'binance' | 'bsc' | 'polygon' | 'arbitrum' | 'optimism' | 'base' | 'avalanche' | 'celo' | 'bitcoin' | 'litecoin' | 'dogecoin' | 'solana' | 'tron' | 'ripple' | 'cardano' | 'ton' | Filter by chain (optional) (optional)
-    chain: chain_example,
-    // string | Filter by project ID (optional). (optional)
-    projectId: projectId_example,
-  } satisfies WalletListAddressesRequest;
+    // TestWalletWebhookRequest
+    testWalletWebhookRequest: {"url":"https://your-app.com/webhooks/test","secret":"whsec_test_abc123","projectId":"685ad30be129932fbb7a1047","event":"wallet.transaction.detected"},
+  } satisfies TestWalletWebhookOperationRequest;
 
   try {
-    const data = await api.walletListAddresses(body);
+    const data = await api.testWalletWebhook(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -981,40 +2147,40 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **chain** | `ethereum`, `binance`, `bsc`, `polygon`, `arbitrum`, `optimism`, `base`, `avalanche`, `celo`, `bitcoin`, `litecoin`, `dogecoin`, `solana`, `tron`, `ripple`, `cardano`, `ton` | Filter by chain (optional) | [Optional] [Defaults to `undefined`] [Enum: ethereum, binance, bsc, polygon, arbitrum, optimism, base, avalanche, celo, bitcoin, litecoin, dogecoin, solana, tron, ripple, cardano, ton] |
-| **projectId** | `string` | Filter by project ID (optional). | [Optional] [Defaults to `undefined`] |
+| **testWalletWebhookRequest** | [TestWalletWebhookRequest](TestWalletWebhookRequest.md) |  | |
 
 ### Return type
 
-[**WalletListAddresses200Response**](WalletListAddresses200Response.md)
+[**TestWalletWebhook200Response**](TestWalletWebhook200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth)
 
 ### HTTP request headers
 
-- **Content-Type**: Not defined
+- **Content-Type**: `application/json`
 - **Accept**: `application/json`
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | List of registered addresses |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **200** | Test result |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+| **429** | Rate limit exceeded |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## walletListWebhooks
+## updateNonCustodialAddress
 
-> WalletListWebhooks200Response walletListWebhooks(projectId)
+> UpdateNonCustodialAddress200Response updateNonCustodialAddress(addressId, updateNonCustodialAddressRequest)
 
-List wallet webhooks
+Update a monitored wallet address
 
-Returns all wallet webhooks for the current context, optionally filtered by projectId. Includes delivery stats and active status. 
+Update metadata for a registered non-custodial address. Only **label** and **derivationPath** can be updated; address and chain are immutable. 
 
 ### Example
 
@@ -1023,23 +2189,27 @@ import {
   Configuration,
   WalletApi,
 } from 'mudbase-sdk';
-import type { WalletListWebhooksRequest } from 'mudbase-sdk';
+import type { UpdateNonCustodialAddressOperationRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new WalletApi(config);
 
   const body = {
-    // string | Filter by project ID (optional). (optional)
-    projectId: projectId_example,
-  } satisfies WalletListWebhooksRequest;
+    // string
+    addressId: addressId_example,
+    // UpdateNonCustodialAddressRequest (optional)
+    updateNonCustodialAddressRequest: {"label":"Main cold wallet","derivationPath":"m/44'/60'/0'/0/1"},
+  } satisfies UpdateNonCustodialAddressOperationRequest;
 
   try {
-    const data = await api.walletListWebhooks(body);
+    const data = await api.updateNonCustodialAddress(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -1055,40 +2225,42 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **projectId** | `string` | Filter by project ID (optional). | [Optional] [Defaults to `undefined`] |
+| **addressId** | `string` |  | [Defaults to `undefined`] |
+| **updateNonCustodialAddressRequest** | [UpdateNonCustodialAddressRequest](UpdateNonCustodialAddressRequest.md) |  | [Optional] |
 
 ### Return type
 
-[**WalletListWebhooks200Response**](WalletListWebhooks200Response.md)
+[**UpdateNonCustodialAddress200Response**](UpdateNonCustodialAddress200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
-- **Content-Type**: Not defined
+- **Content-Type**: `application/json`
 - **Accept**: `application/json`
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | List of webhooks |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
-| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **200** | Address updated successfully |  -  |
+| **400** | Validation error (e.g. label too long, invalid derivation path) |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Resource not found |  -  |
+| **429** | Rate limit exceeded |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## walletRegisterAddress
+## updateWalletFeeConfig
 
-> NonCustodialAddressResponse walletRegisterAddress(walletRegisterAddressRequest)
+> UpdateWalletFeeConfig200Response updateWalletFeeConfig(projectId, updateWalletFeeConfigRequest)
 
-Register a non-custodial wallet address
+Update project fee configuration (for non-custodial / external users)
 
-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. 
+Update project-level fee settings. **For non-custodial / external users** — e.g. fee charged on payouts or transfers. Custodial wallet is no longer used in production. Applies to **all supported currencies** (BTC, ETH, BNB, LTC, SOL, TRX, USDT). **feePercentage** is a decimal: use `0.01` for 1%, `0.005` for 0.5%, etc. (min 0, max 1). 
 
 ### Example
 
@@ -1097,23 +2269,27 @@ import {
   Configuration,
   WalletApi,
 } from 'mudbase-sdk';
-import type { WalletRegisterAddressOperationRequest } from 'mudbase-sdk';
+import type { UpdateWalletFeeConfigOperationRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new WalletApi(config);
 
   const body = {
-    // WalletRegisterAddressRequest | Public address, chain identifier, and optional derivation path and label. projectId scopes the registration to a project.
-    walletRegisterAddressRequest: {"address":"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb","chain":"ethereum","derivationPath":"m/44'/60'/0'/0/5","label":"Main Ethereum Wallet"},
-  } satisfies WalletRegisterAddressOperationRequest;
+    // string | Project ID
+    projectId: projectId_example,
+    // UpdateWalletFeeConfigRequest (optional)
+    updateWalletFeeConfigRequest: {"enabled":true,"feePercentage":0.01},
+  } satisfies UpdateWalletFeeConfigOperationRequest;
 
   try {
-    const data = await api.walletRegisterAddress(body);
+    const data = await api.updateWalletFeeConfig(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -1129,15 +2305,16 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **walletRegisterAddressRequest** | [WalletRegisterAddressRequest](WalletRegisterAddressRequest.md) | Public address, chain identifier, and optional derivation path and label. projectId scopes the registration to a project. | |
+| **projectId** | `string` | Project ID | [Defaults to `undefined`] |
+| **updateWalletFeeConfigRequest** | [UpdateWalletFeeConfigRequest](UpdateWalletFeeConfigRequest.md) |  | [Optional] |
 
 ### Return type
 
-[**NonCustodialAddressResponse**](NonCustodialAddressResponse.md)
+[**UpdateWalletFeeConfig200Response**](UpdateWalletFeeConfig200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -1148,21 +2325,94 @@ example().catch(console.error);
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **201** | Address registered successfully |  -  |
-| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \"Validation failed\", \"projectId is required\", \"No file provided\", \"Invalid project ID format\". **details** may contain validation errors when present.  |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **200** | Fee configuration updated |  -  |
+| **400** | Bad request |  -  |
+| **404** | Resource not found |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## walletTestWebhook
+## updateWalletWebhook
 
-> MultiRoleGetPermissionsMatrix200Response walletTestWebhook(walletTestWebhookRequest)
+> UpdateWalletWebhook200Response updateWalletWebhook(webhookId, updateWalletWebhookRequest)
 
-Test a webhook delivery (sends a single test payload)
+Update a wallet webhook
+
+### Example
+
+```ts
+import {
+  Configuration,
+  WalletApi,
+} from 'mudbase-sdk';
+import type { UpdateWalletWebhookOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // string
+    webhookId: webhookId_example,
+    // UpdateWalletWebhookRequest
+    updateWalletWebhookRequest: {"url":"https://your-app.com/webhooks/updated","events":["wallet.transaction.confirmed","wallet.transaction.detected"],"secret":"whsec_newsecret123","filters":{"addresses":["65a1b2c3d4e5f6789012345a"],"chains":["celo","ethereum"]}},
+  } satisfies UpdateWalletWebhookOperationRequest;
+
+  try {
+    const data = await api.updateWalletWebhook(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
 
-Sends a test payload to the given URL to verify webhook connectivity and signature. Uses the same signing as real deliveries.
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **webhookId** | `string` |  | [Defaults to `undefined`] |
+| **updateWalletWebhookRequest** | [UpdateWalletWebhookRequest](UpdateWalletWebhookRequest.md) |  | |
+
+### Return type
+
+[**UpdateWalletWebhook200Response**](UpdateWalletWebhook200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Webhook updated successfully |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Resource not found |  -  |
+| **429** | Rate limit exceeded |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## validateAddress
+
+> ValidateAddress200Response validateAddress(validateAddressRequest)
+
+Validate cryptocurrency address
 
 ### Example
 
@@ -1171,25 +2421,25 @@ import {
   Configuration,
   WalletApi,
 } from 'mudbase-sdk';
-import type { WalletTestWebhookOperationRequest } from 'mudbase-sdk';
+import type { ValidateAddressOperationRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // To configure API key authorization: ApiKeyAuth
-    apiKey: "YOUR API KEY",
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new WalletApi(config);
 
   const body = {
-    // WalletTestWebhookRequest | URL to send the test POST to; optional secret and projectId for scoping; optional event type to simulate.
-    walletTestWebhookRequest: {"url":"https://your-app.com/webhooks/test","secret":"whsec_test_abc123","projectId":"685ad30be129932fbb7a1047","event":"wallet.transaction.detected"},
-  } satisfies WalletTestWebhookOperationRequest;
+    // ValidateAddressRequest
+    validateAddressRequest: {"currency":"BTC","address":"bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"},
+  } satisfies ValidateAddressOperationRequest;
 
   try {
-    const data = await api.walletTestWebhook(body);
+    const data = await api.validateAddress(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -1205,15 +2455,15 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **walletTestWebhookRequest** | [WalletTestWebhookRequest](WalletTestWebhookRequest.md) | URL to send the test POST to; optional secret and projectId for scoping; optional event type to simulate. | |
+| **validateAddressRequest** | [ValidateAddressRequest](ValidateAddressRequest.md) |  | |
 
 ### Return type
 
-[**MultiRoleGetPermissionsMatrix200Response**](MultiRoleGetPermissionsMatrix200Response.md)
+[**ValidateAddress200Response**](ValidateAddress200Response.md)
 
 ### Authorization
 
-[ApiKeyAuth](../README.md#ApiKeyAuth), [BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -1224,21 +2474,20 @@ example().catch(console.error);
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Test result |  -  |
-| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \"Validation failed\", \"projectId is required\", \"No file provided\", \"Invalid project ID format\". **details** may contain validation errors when present.  |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **200** | Address validation result |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## walletUpdateWebhook
+## withdraw
 
-> WalletUpdateWebhook200Response walletUpdateWebhook(webhookId, walletUpdateWebhookRequest)
+> Withdraw200Response withdraw(walletId, withdrawRequest)
 
-Update a wallet webhook
+Prepare withdrawal (semi-transaction; broadcast via non-custodial)
 
-Update webhook URL, events, secret, or filters. Partially applied; only provided fields are updated.
+**Semi-transaction:** Builds and signs the withdrawal but does **not** broadcast. Returns `signedTx`, `chain`, and `fromAddress` so the client can broadcast via POST /api/wallet/non-custodial/broadcast. The wallet address must be registered for your organization before broadcasting. Supports all platform chains/currencies (EVM, UTXO, Tron, Solana, USDT on ETH/BSC/TRX/SOL/POLYGON). Use for testing the non-custodial flow: create custodial wallet, get private key, register address, then call withdraw to get signed tx and broadcast it manually. 
 
 ### Example
 
@@ -1247,27 +2496,27 @@ import {
   Configuration,
   WalletApi,
 } from 'mudbase-sdk';
-import type { WalletUpdateWebhookOperationRequest } from 'mudbase-sdk';
+import type { WithdrawOperationRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // To configure API key authorization: ApiKeyAuth
-    apiKey: "YOUR API KEY",
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new WalletApi(config);
 
   const body = {
-    // string | Webhook ID (MongoDB ObjectId) to update.
-    webhookId: webhookId_example,
-    // WalletUpdateWebhookRequest | Fields to update (url, events, secret, filters). Omitted fields are left unchanged.
-    walletUpdateWebhookRequest: {"url":"https://your-app.com/webhooks/updated","events":["wallet.transaction.confirmed","wallet.transaction.detected"],"secret":"whsec_newsecret123","filters":{"addresses":["65a1b2c3d4e5f6789012345a"],"chains":["celo","ethereum"]}},
-  } satisfies WalletUpdateWebhookOperationRequest;
+    // string
+    walletId: walletId_example,
+    // WithdrawRequest
+    withdrawRequest: {"toAddress":"bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh","amount":0.1},
+  } satisfies WithdrawOperationRequest;
 
   try {
-    const data = await api.walletUpdateWebhook(body);
+    const data = await api.withdraw(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -1283,16 +2532,16 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **webhookId** | `string` | Webhook ID (MongoDB ObjectId) to update. | [Defaults to `undefined`] |
-| **walletUpdateWebhookRequest** | [WalletUpdateWebhookRequest](WalletUpdateWebhookRequest.md) | Fields to update (url, events, secret, filters). Omitted fields are left unchanged. | |
+| **walletId** | `string` |  | [Defaults to `undefined`] |
+| **withdrawRequest** | [WithdrawRequest](WithdrawRequest.md) |  | |
 
 ### Return type
 
-[**WalletUpdateWebhook200Response**](WalletUpdateWebhook200Response.md)
+[**Withdraw200Response**](Withdraw200Response.md)
 
 ### Authorization
 
-[ApiKeyAuth](../README.md#ApiKeyAuth), [BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -1303,11 +2552,11 @@ example().catch(console.error);
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Webhook updated successfully |  -  |
-| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \"Validation failed\", \"projectId is required\", \"No file provided\", \"Invalid project ID format\". **details** may contain validation errors when present.  |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **404** | Webhook not found (exact backend message for webhook endpoints). |  -  |
-| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **200** | Semi-transaction ready; broadcast via POST /api/wallet/non-custodial/broadcast |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+| **403** | Access denied |  -  |
+| **500** | Internal server error |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)