npm - mudbase-sdk - Versions diffs - 1.3.9 → 1.3.11 - Mend

mudbase-sdk 1.3.9 → 1.3.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3591) hide show

package/docs/WalletApi.md DELETED Viewed

@@ -1,2562 +0,0 @@
-# WalletApi
-All URIs are relative to *https://cloud.mudbase.dev*
-| Method | HTTP request | Description |
-|------------- | ------------- | -------------|
-| [**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
-Broadcast a transaction that has been signed client-side. The transaction must be fully signed before sending. The fromAddress must be registered and belong to your organization (POST /api/wallet/non-custodial/register-address). **Supported chains:** EVM (ethereum, polygon, arbitrum, optimism, base, bsc, binance, avalanche, celo), UTXO (bitcoin, litecoin, dogecoin), and chain-specific (tron, solana, ton, cardano). Use &#x60;binance&#x60; or &#x60;bsc&#x60; for BNB Smart Chain. **Testing with custodial:** You can create a wallet via POST /api/wallet/create, get its private key via GET /api/wallet/{walletId}/private-key, register that address with POST /api/wallet/non-custodial/register-address, then build a signed tx (using POST /api/wallet/estimate-network-fee or estimate-gas for fees) and broadcast it here to test the non-custodial flow end-to-end.
-### Example
-```ts
-import {
-  Configuration,
-  WalletApi,
-} 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: 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, &#x60;network&#x60; is required (ETH, BSC, TRX, SOL, POLYGON). Use &#x60;?fresh&#x3D;1&#x60; or header &#x60;X-Fee-Fresh: true&#x60; for a fresh estimate (bypass cache) right before building the transaction for broadcast.
-### 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 &#x3D; false); it no longer appears in list or receives monitoring but the record remains for audit. **Permanent delete:** Set query **permanent&#x3D;true** to remove the address record from the database. Use when you need to fully remove the monitored address.
-### 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, &#x60;network&#x60; is required (ETH, BSC, TRX, SOL, POLYGON). **Fresh fee before broadcast:** To avoid stuck transactions, get a fresh estimate right before building/signing: use query &#x60;?fresh&#x3D;1&#x60; or header &#x60;X-Fee-Fresh: true&#x60; to bypass cache.
-### 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 &#x60;transaction&#x60; (from, and to/value or tokenAddress/amount). Response includes gasLimit, gasPrice, networkFee, estimatedTime, currency. **Non-EVM chains:** bitcoin, litecoin, dogecoin, solana, tron, ton, cardano — only &#x60;chain&#x60; is required; &#x60;transaction&#x60; is optional/ignored. Returns networkFee, estimatedTime, currency (and e.g. satPerVb for UTXO). See docs/FEE_ARCHITECTURE.md. Results cached 15s.
-### 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 \&quot;current fees\&quot; 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 -&gt; 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&#x3D;self, value&#x3D;0, data&#x3D;0x, higher gas). Client signs and broadcasts via POST /api/wallet/non-custodial/broadcast. Address must be registered for your organization. EVM chains only.
-### 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 = {
-    // 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.getNonCustodialTransactionByHash(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-// Run the test
-example().catch(console.error);
-```
-### Parameters
-| 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] |
-### Return type
-[**GetNonCustodialTransactionByHash200Response**](GetNonCustodialTransactionByHash200Response.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** | Transaction details |  -  |
-| **400** | Bad Request - missing or invalid chain (add ?chain&#x3D;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)
-## getNonCustodialTransactions
-> GetNonCustodialTransactions200Response getNonCustodialTransactions(addressId, limit, page)
-Get transaction history for a non-custodial address
-### Example
-```ts
-import {
-  Configuration,
-  WalletApi,
-} 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: 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,
-    // number (optional)
-    limit: 56,
-    // number (optional)
-    page: 56,
-  } satisfies GetNonCustodialTransactionsRequest;
-  try {
-    const data = await api.getNonCustodialTransactions(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`] |
-| **limit** | `number` |  | [Optional] [Defaults to `50`] |
-| **page** | `number` |  | [Optional] [Defaults to `1`] |
-### Return type
-[**GetNonCustodialTransactions200Response**](GetNonCustodialTransactions200Response.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** | 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)
-## getSpeedUpParams
-> GetSpeedUpParams200Response getSpeedUpParams(getSpeedUpParamsRequest)
-Get replacement tx params for speed-up (stuck EVM tx)
-Returns **replacement transaction params** for a stuck EVM transaction (same nonce, same to/value/data, higher gas). Client signs the replacement and broadcasts via POST /api/wallet/non-custodial/broadcast. Address must be registered for your organization. Use when a tx has been pending &gt;5 min (stuck). EVM chains only.
-### Example
-```ts
-import {
-  Configuration,
-  WalletApi,
-} 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: OrgBearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-    // Configure HTTP bearer authorization: ProjectBearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-  });
-  const api = new WalletApi(config);
-  const body = {
-    // GetSpeedUpParamsRequest
-    getSpeedUpParamsRequest: {"txHash":"0xabc123...","chain":"ethereum"},
-  } satisfies GetSpeedUpParamsOperationRequest;
-  try {
-    const data = await api.getSpeedUpParams(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-// Run the test
-example().catch(console.error);
-```
-### Parameters
-| Name | Type | Description  | Notes |
-|------------- | ------------- | ------------- | -------------|
-| **getSpeedUpParamsRequest** | [GetSpeedUpParamsRequest](GetSpeedUpParamsRequest.md) |  | |
-### Return type
-[**GetSpeedUpParams200Response**](GetSpeedUpParams200Response.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** | 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)
-## getSupportedCurrencies
-> GetSupportedCurrencies200Response getSupportedCurrencies()
-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)
-## getTransaction
-> GetTransaction200Response getTransaction(transactionId)
-Get transaction details
-### Example
-```ts
-import {
-  Configuration,
-  WalletApi,
-} 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: OrgBearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-    // Configure HTTP bearer authorization: ProjectBearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-  });
-  const api = new WalletApi(config);
-  const body = {
-    // string
-    transactionId: transactionId_example,
-  } satisfies GetTransactionRequest;
-  try {
-    const data = await api.getTransaction(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-// Run the test
-example().catch(console.error);
-```
-### Parameters
-| Name | Type | Description  | Notes |
-|------------- | ------------- | ------------- | -------------|
-| **transactionId** | `string` |  | [Defaults to `undefined`] |
-### Return type
-[**GetTransaction200Response**](GetTransaction200Response.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** | 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)
-## getTransactionHistory
-> GetTransactionHistory200Response getTransactionHistory(walletId, limit, page)
-Get transaction history (custodial wallets; same monitoring as non-custodial)
-Returns transaction history for custodial wallets. Transactions are stored and monitored the same way as non-custodial (WalletTransaction); status updates (pending, broadcast, confirmed, failed) and stuck detection apply to both.
-### Example
-```ts
-import {
-  Configuration,
-  WalletApi,
-} 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: OrgBearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-    // Configure HTTP bearer authorization: ProjectBearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-  });
-  const api = new WalletApi(config);
-  const body = {
-    // string (optional)
-    walletId: walletId_example,
-    // number (optional)
-    limit: 56,
-    // number (optional)
-    page: 56,
-  } satisfies GetTransactionHistoryRequest;
-  try {
-    const data = await api.getTransactionHistory(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-// Run the test
-example().catch(console.error);
-```
-### Parameters
-| Name | Type | Description  | Notes |
-|------------- | ------------- | ------------- | -------------|
-| **walletId** | `string` |  | [Optional] [Defaults to `undefined`] |
-| **limit** | `number` |  | [Optional] [Defaults to `20`] |
-| **page** | `number` |  | [Optional] [Defaults to `1`] |
-### Return type
-[**GetTransactionHistory200Response**](GetTransactionHistory200Response.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** | 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)
-## getUserWallets
-> GetUserWallets200Response getUserWallets(projectId, currency)
-Get user wallets
-### Example
-```ts
-import {
-  Configuration,
-  WalletApi,
-} 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: OrgBearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-    // Configure HTTP bearer authorization: ProjectBearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-  });
-  const api = new WalletApi(config);
-  const body = {
-    // string (optional)
-    projectId: projectId_example,
-    // string (optional)
-    currency: currency_example,
-  } satisfies GetUserWalletsRequest;
-  try {
-    const data = await api.getUserWallets(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-// Run the test
-example().catch(console.error);
-```
-### Parameters
-| Name | Type | Description  | Notes |
-|------------- | ------------- | ------------- | -------------|
-| **projectId** | `string` |  | [Optional] [Defaults to `undefined`] |
-| **currency** | `string` |  | [Optional] [Defaults to `undefined`] |
-### Return type
-[**GetUserWallets200Response**](GetUserWallets200Response.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** | 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)
-## getWalletFeeConfig
-> GetWalletFeeConfig200Response getWalletFeeConfig(projectId)
-Get project fee configuration (for non-custodial / external users)
-Get project-level fee settings (enabled flag and fee percentage). **For non-custodial / external users** — e.g. when your app charges a fee on payouts or transfers. Custodial wallet is no longer used in production. Applies to all supported chains/currencies for that project.
-### Example
-```ts
-import {
-  Configuration,
-  WalletApi,
-} 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: OrgBearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-    // Configure HTTP bearer authorization: ProjectBearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-  });
-  const api = new WalletApi(config);
-  const body = {
-    // string | Project ID
-    projectId: projectId_example,
-  } satisfies GetWalletFeeConfigRequest;
-  try {
-    const data = await api.getWalletFeeConfig(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-// Run the test
-example().catch(console.error);
-```
-### Parameters
-| Name | Type | Description  | Notes |
-|------------- | ------------- | ------------- | -------------|
-| **projectId** | `string` | Project ID | [Defaults to `undefined`] |
-### Return type
-[**GetWalletFeeConfig200Response**](GetWalletFeeConfig200Response.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** | 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)
-## getWalletPrivateKey
-> GetWalletPrivateKey200Response getWalletPrivateKey(walletId)
-Get wallet private key (WARNING: Sensitive data; for testing non-custodial)
-Returns the wallet private key. **For testing non-custodial only:** use this key to sign a transaction locally, then register the wallet address via POST /api/wallet/non-custodial/register-address and broadcast the signed tx via POST /api/wallet/non-custodial/broadcast.
-### Example
-```ts
-import {
-  Configuration,
-  WalletApi,
-} 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: 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 GetWalletPrivateKeyRequest;
-  try {
-    const data = await api.getWalletPrivateKey(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
-[**GetWalletPrivateKey200Response**](GetWalletPrivateKey200Response.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** | 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)
-## getWalletWebhookLogs
-> GetWalletWebhookLogs200Response getWalletWebhookLogs(webhookId, limit)
-Get webhook delivery logs
-### Example
-```ts
-import {
-  Configuration,
-  WalletApi,
-} 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: OrgBearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-  });
-  const api = new WalletApi(config);
-  const body = {
-    // string
-    webhookId: webhookId_example,
-    // number (optional)
-    limit: 56,
-  } satisfies GetWalletWebhookLogsRequest;
-  try {
-    const data = await api.getWalletWebhookLogs(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`] |
-| **limit** | `number` |  | [Optional] [Defaults to `50`] |
-### Return type
-[**GetWalletWebhookLogs200Response**](GetWalletWebhookLogs200Response.md)
-### Authorization
-[OrgBearerAuth](../README.md#OrgBearerAuth)
-### HTTP request headers
-- **Content-Type**: Not defined
-- **Accept**: `application/json`
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-| **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)
-## listNonCustodialAddresses
-> ListNonCustodialAddresses200Response listNonCustodialAddresses(chain, projectId)
-List registered non-custodial addresses
-### Example
-```ts
-import {
-  Configuration,
-  WalletApi,
-} 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: OrgBearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-    // Configure HTTP bearer authorization: ProjectBearerAuth
-    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 (optional)
-    projectId: projectId_example,
-  } satisfies ListNonCustodialAddressesRequest;
-  try {
-    const data = await api.listNonCustodialAddresses(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-// Run the test
-example().catch(console.error);
-```
-### Parameters
-| 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` |  | [Optional] [Defaults to `undefined`] |
-### Return type
-[**ListNonCustodialAddresses200Response**](ListNonCustodialAddresses200Response.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** | 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)
-## listWalletWebhooks
-> ListWalletWebhooks200Response listWalletWebhooks(projectId)
-List wallet webhooks
-### Example
-```ts
-import {
-  Configuration,
-  WalletApi,
-} 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: OrgBearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-    // Configure HTTP bearer authorization: ProjectBearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-  });
-  const api = new WalletApi(config);
-  const body = {
-    // string (optional)
-    projectId: projectId_example,
-  } satisfies ListWalletWebhooksRequest;
-  try {
-    const data = await api.listWalletWebhooks(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-// Run the test
-example().catch(console.error);
-```
-### Parameters
-| Name | Type | Description  | Notes |
-|------------- | ------------- | ------------- | -------------|
-| **projectId** | `string` |  | [Optional] [Defaults to `undefined`] |
-### Return type
-[**ListWalletWebhooks200Response**](ListWalletWebhooks200Response.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** | 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)
-## registerNonCustodialAddress
-> NonCustodialAddressResponse registerNonCustodialAddress(registerNonCustodialAddressRequest)
-Register a non-custodial wallet address
-Register a public wallet address for monitoring and indexing. All key operations (generation, signing) occur client-side only.
-### Example
-```ts
-import {
-  Configuration,
-  WalletApi,
-} from 'mudbase-sdk';
-import type { RegisterNonCustodialAddressOperationRequest } 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 = {
-    // RegisterNonCustodialAddressRequest
-    registerNonCustodialAddressRequest: {"address":"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb","chain":"ethereum","derivationPath":"m/44'/60'/0'/0/5","label":"Main Ethereum Wallet"},
-  } satisfies RegisterNonCustodialAddressOperationRequest;
-  try {
-    const data = await api.registerNonCustodialAddress(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-// Run the test
-example().catch(console.error);
-```
-### Parameters
-| Name | Type | Description  | Notes |
-|------------- | ------------- | ------------- | -------------|
-| **registerNonCustodialAddressRequest** | [RegisterNonCustodialAddressRequest](RegisterNonCustodialAddressRequest.md) |  | |
-### Return type
-[**NonCustodialAddressResponse**](NonCustodialAddressResponse.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** | 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)
-## testWalletWebhook
-> TestWalletWebhook200Response testWalletWebhook(testWalletWebhookRequest)
-Test a webhook delivery (sends a single test payload)
-### Example
-```ts
-import {
-  Configuration,
-  WalletApi,
-} 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: OrgBearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-  });
-  const api = new WalletApi(config);
-  const body = {
-    // 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.testWalletWebhook(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-// Run the test
-example().catch(console.error);
-```
-### Parameters
-| Name | Type | Description  | Notes |
-|------------- | ------------- | ------------- | -------------|
-| **testWalletWebhookRequest** | [TestWalletWebhookRequest](TestWalletWebhookRequest.md) |  | |
-### Return type
-[**TestWalletWebhook200Response**](TestWalletWebhook200Response.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** | 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)
-## updateNonCustodialAddress
-> UpdateNonCustodialAddress200Response updateNonCustodialAddress(addressId, updateNonCustodialAddressRequest)
-Update a monitored wallet address
-Update metadata for a registered non-custodial address. Only **label** and **derivationPath** can be updated; address and chain are immutable.
-### Example
-```ts
-import {
-  Configuration,
-  WalletApi,
-} 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: 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,
-    // UpdateNonCustodialAddressRequest (optional)
-    updateNonCustodialAddressRequest: {"label":"Main cold wallet","derivationPath":"m/44'/60'/0'/0/1"},
-  } satisfies UpdateNonCustodialAddressOperationRequest;
-  try {
-    const data = await api.updateNonCustodialAddress(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`] |
-| **updateNonCustodialAddressRequest** | [UpdateNonCustodialAddressRequest](UpdateNonCustodialAddressRequest.md) |  | [Optional] |
-### Return type
-[**UpdateNonCustodialAddress200Response**](UpdateNonCustodialAddress200Response.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** | 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)
-## updateWalletFeeConfig
-> UpdateWalletFeeConfig200Response updateWalletFeeConfig(projectId, updateWalletFeeConfigRequest)
-Update project fee configuration (for non-custodial / external users)
-Update project-level fee settings. **For non-custodial / external users** — e.g. fee charged on payouts or transfers. Custodial wallet is no longer used in production. Applies to **all supported currencies** (BTC, ETH, BNB, LTC, SOL, TRX, USDT). **feePercentage** is a decimal: use &#x60;0.01&#x60; for 1%, &#x60;0.005&#x60; for 0.5%, etc. (min 0, max 1).
-### Example
-```ts
-import {
-  Configuration,
-  WalletApi,
-} 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: OrgBearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-    // Configure HTTP bearer authorization: ProjectBearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-  });
-  const api = new WalletApi(config);
-  const body = {
-    // string | Project ID
-    projectId: projectId_example,
-    // UpdateWalletFeeConfigRequest (optional)
-    updateWalletFeeConfigRequest: {"enabled":true,"feePercentage":0.01},
-  } satisfies UpdateWalletFeeConfigOperationRequest;
-  try {
-    const data = await api.updateWalletFeeConfig(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-// Run the test
-example().catch(console.error);
-```
-### Parameters
-| Name | Type | Description  | Notes |
-|------------- | ------------- | ------------- | -------------|
-| **projectId** | `string` | Project ID | [Defaults to `undefined`] |
-| **updateWalletFeeConfigRequest** | [UpdateWalletFeeConfigRequest](UpdateWalletFeeConfigRequest.md) |  | [Optional] |
-### Return type
-[**UpdateWalletFeeConfig200Response**](UpdateWalletFeeConfig200Response.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** | 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)
-## updateWalletWebhook
-> UpdateWalletWebhook200Response updateWalletWebhook(webhookId, updateWalletWebhookRequest)
-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
-| 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
-```ts
-import {
-  Configuration,
-  WalletApi,
-} from 'mudbase-sdk';
-import type { ValidateAddressOperationRequest } 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 = {
-    // ValidateAddressRequest
-    validateAddressRequest: {"currency":"BTC","address":"bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"},
-  } satisfies ValidateAddressOperationRequest;
-  try {
-    const data = await api.validateAddress(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-// Run the test
-example().catch(console.error);
-```
-### Parameters
-| Name | Type | Description  | Notes |
-|------------- | ------------- | ------------- | -------------|
-| **validateAddressRequest** | [ValidateAddressRequest](ValidateAddressRequest.md) |  | |
-### Return type
-[**ValidateAddress200Response**](ValidateAddress200Response.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** | 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)
-## withdraw
-> Withdraw200Response withdraw(walletId, withdrawRequest)
-Prepare withdrawal (semi-transaction; broadcast via non-custodial)
-**Semi-transaction:** Builds and signs the withdrawal but does **not** broadcast. Returns &#x60;signedTx&#x60;, &#x60;chain&#x60;, and &#x60;fromAddress&#x60; so the client can broadcast via POST /api/wallet/non-custodial/broadcast. The wallet address must be registered for your organization before broadcasting. Supports all platform chains/currencies (EVM, UTXO, Tron, Solana, USDT on ETH/BSC/TRX/SOL/POLYGON). Use for testing the non-custodial flow: create custodial wallet, get private key, register address, then call withdraw to get signed tx and broadcast it manually.
-### Example
-```ts
-import {
-  Configuration,
-  WalletApi,
-} from 'mudbase-sdk';
-import type { WithdrawOperationRequest } 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,
-    // WithdrawRequest
-    withdrawRequest: {"toAddress":"bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh","amount":0.1},
-  } satisfies WithdrawOperationRequest;
-  try {
-    const data = await api.withdraw(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`] |
-| **withdrawRequest** | [WithdrawRequest](WithdrawRequest.md) |  | |
-### Return type
-[**Withdraw200Response**](Withdraw200Response.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** | 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)