mudbase-sdk 1.0.0

package/docs/WalletApi.md

@@ -0,0 +1,1313 @@
+# 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 |
+| [**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 (soft-delete) a non-custodial address |
+| [**deleteWalletWebhook**](WalletApi.md#deletewalletwebhook) | **DELETE** /api/wallet/non-custodial/webhooks/{webhookId} | Delete a wallet webhook |
+| [**estimateNonCustodialGas**](WalletApi.md#estimatenoncustodialgasoperation) | **POST** /api/wallet/non-custodial/estimate-gas | Estimate network fee from blockchain (all supported chains; not controlled by Mudbase) |
+| [**getCancelParams**](WalletApi.md#getcancelparamsoperation) | **POST** /api/wallet/non-custodial/cancel | Get replacement tx params for cancel (stuck EVM tx) |
+| [**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) |
+| [**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) |
+| [**updateWalletWebhook**](WalletApi.md#updatewalletwebhookoperation) | **PUT** /api/wallet/non-custodial/webhooks/{webhookId} | Update a wallet webhook |
+
+
+
+## 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 `binance` or `bsc` for BNB Smart Chain. **Testing with custodial:** You can create a wallet via POST /api/wallet/create, get its private key via GET /api/wallet/{walletId}/private-key, register that address with POST /api/wallet/non-custodial/register-address, then build a signed tx (using POST /api/wallet/estimate-network-fee or estimate-gas for fees) and broadcast it here to test the non-custodial flow end-to-end. 
+
+### 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: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // BroadcastNonCustodialTransactionRequest | Chain, signed transaction (hex), and fromAddress (must be registered).
+    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) | Chain, signed transaction (hex), and fromAddress (must be registered). | |
+
+### Return type
+
+[**BroadcastNonCustodialTransaction200Response**](BroadcastNonCustodialTransaction200Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Transaction broadcast successfully |  -  |
+| **400** | Bad request |  -  |
+| **403** | Access denied |  -  |
+| **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)
+
+
+## createWalletWebhook
+
+> CreateWalletWebhook201Response createWalletWebhook(createWalletWebhookRequest)
+
+Create a wallet webhook
+
+Register a webhook URL to receive wallet events (balance updates, transaction confirmed/failed/detected/broadcast, token balance, address created/deactivated). Optional filters by addresses and chains. 
+
+### 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: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // CreateWalletWebhookRequest | Webhook URL, events array, optional secret and filters (addresses, chains, projectId).
+    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) | Webhook URL, events array, optional secret and filters (addresses, chains, projectId). | |
+
+### Return type
+
+[**CreateWalletWebhook201Response**](CreateWalletWebhook201Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### 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)
+
+Delete (soft-delete) a non-custodial address
+
+Soft-deletes a registered non-custodial address. The address is marked inactive and no longer used for broadcasts or balance/transaction queries. 
+
+### 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: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // string | Registered address ID to delete.
+    addressId: addressId_example,
+  } 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` | Registered address ID to delete. | [Defaults to `undefined`] |
+
+### Return type
+
+[**DeleteFunction200Response**](DeleteFunction200Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Address deleted successfully |  -  |
+| **400** | Bad request |  -  |
+| **404** | Resource not found |  -  |
+| **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)
+
+
+## deleteWalletWebhook
+
+> DeleteFunction200Response deleteWalletWebhook(webhookId)
+
+Delete a wallet webhook
+
+Permanently delete a wallet webhook. Delivery will stop immediately.
+
+### 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: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // string | Webhook ID (MongoDB ObjectId) to delete.
+    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` | Webhook ID (MongoDB ObjectId) to delete. | [Defaults to `undefined`] |
+
+### Return type
+
+[**DeleteFunction200Response**](DeleteFunction200Response.md)
+
+### Authorization
+
+[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 |  -  |
+| **400** | Bad request |  -  |
+| **404** | Resource not found |  -  |
+| **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)
+
+
+## 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: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // EstimateNonCustodialGasRequest | Chain and optional transaction shape (required for EVM). Returns network fee from blockchain.
+    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) | Chain and optional transaction shape (required for EVM). Returns network fee from blockchain. | |
+
+### Return type
+
+[**EstimateNonCustodialGas200Response**](EstimateNonCustodialGas200Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### 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)
+
+
+## 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: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // GetCancelParamsRequest | Stuck transaction identifier (txId or txHash) and EVM chain for cancel.
+    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) | Stuck transaction identifier (txId or txHash) and EVM chain for cancel. | |
+
+### Return type
+
+[**GetCancelParams200Response**](GetCancelParams200Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Cancel tx params (client signs and broadcasts via /broadcast) |  -  |
+| **400** | Bad request |  -  |
+| **403** | Access denied |  -  |
+| **404** | Resource not found |  -  |
+| **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)
+
+
+## getNonCustodialAddress
+
+> NonCustodialAddressResponse getNonCustodialAddress(addressId)
+
+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). 
+
+### 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: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // string | Registered address ID (MongoDB ObjectId).
+    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` | Registered address ID (MongoDB ObjectId). | [Defaults to `undefined`] |
+
+### Return type
+
+[**NonCustodialAddressResponse**](NonCustodialAddressResponse.md)
+
+### Authorization
+
+[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 |  -  |
+| **404** | Resource not found |  -  |
+| **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)
+
+
+## getNonCustodialBalance
+
+> GetNonCustodialBalance200Response getNonCustodialBalance(addressId)
+
+Get balance for a non-custodial address
+
+Returns native token balance (confirmed, unconfirmed, total, currency) for a registered non-custodial address. Updated periodically from the chain. 
+
+### 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: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // string | Registered address ID.
+    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` | Registered address ID. | [Defaults to `undefined`] |
+
+### Return type
+
+[**GetNonCustodialBalance200Response**](GetNonCustodialBalance200Response.md)
+
+### Authorization
+
+[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 |  -  |
+| **404** | Resource not found |  -  |
+| **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)
+
+
+## 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: 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
+
+[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=ethereum) |  -  |
+| **404** | Resource not found |  -  |
+| **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)
+
+
+## getNonCustodialTransactions
+
+> GetNonCustodialTransactions200Response getNonCustodialTransactions(addressId, limit, page)
+
+Get transaction history for a non-custodial address
+
+Returns paginated transaction history for a registered non-custodial address (incoming/outgoing, status, confirmations, amounts). 
+
+### 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: 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 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` | 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`] |
+
+### Return type
+
+[**GetNonCustodialTransactions200Response**](GetNonCustodialTransactions200Response.md)
+
+### Authorization
+
+[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 |  -  |
+| **404** | Resource not found |  -  |
+| **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)
+
+
+## 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 >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: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // GetSpeedUpParamsRequest | Stuck transaction identifier (txId or txHash) and EVM chain.
+    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) | Stuck transaction identifier (txId or txHash) and EVM chain. | |
+
+### Return type
+
+[**GetSpeedUpParams200Response**](GetSpeedUpParams200Response.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Replacement tx params (client signs and broadcasts via /broadcast) |  -  |
+| **400** | Bad request |  -  |
+| **403** | Access denied |  -  |
+| **404** | Resource not found |  -  |
+| **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)
+
+
+## getWalletWebhookLogs
+
+> GetWalletWebhookLogs200Response getWalletWebhookLogs(webhookId, limit)
+
+Get webhook delivery logs
+
+List delivery attempts for a wallet webhook (success/failure, payload, response, duration). Paginated by limit.
+
+### 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({ 
+    // To configure API key authorization: ApiKeyAuth
+    apiKey: "YOUR API KEY",
+    // 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 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` | Webhook ID (MongoDB ObjectId) to get logs for. | [Defaults to `undefined`] |
+| **limit** | `number` | Maximum number of log entries to return. | [Optional] [Defaults to `50`] |
+
+### Return type
+
+[**GetWalletWebhookLogs200Response**](GetWalletWebhookLogs200Response.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### 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
+
+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. 
+
+### 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: 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 | Filter by project ID (optional). (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` | Filter by project ID (optional). | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**ListNonCustodialAddresses200Response**](ListNonCustodialAddresses200Response.md)
+
+### Authorization
+
+[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
+
+Returns all wallet webhooks for the current context, optionally filtered by projectId. Includes delivery stats and active status. 
+
+### 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: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // string | Filter by project ID (optional). (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` | Filter by project ID (optional). | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**ListWalletWebhooks200Response**](ListWalletWebhooks200Response.md)
+
+### Authorization
+
+[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 |  -  |
+| **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)
+
+
+## registerNonCustodialAddress
+
+> NonCustodialAddressResponse registerNonCustodialAddress(registerNonCustodialAddressRequest)
+
+Register a non-custodial wallet address
+
+Register a public wallet address for balance monitoring, transaction indexing, and webhook notifications. Keys are never sent to the server; generation and signing happen client-side only. Supports EVM, UTXO, Solana, Tron, TON, Cardano, and other chains. Optionally provide derivation path and label for multi-address tracking. 
+
+### 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: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // RegisterNonCustodialAddressRequest | Public address, chain identifier, and optional derivation path and label. projectId scopes the registration to a project.
+    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) | Public address, chain identifier, and optional derivation path and label. projectId scopes the registration to a project. | |
+
+### Return type
+
+[**NonCustodialAddressResponse**](NonCustodialAddressResponse.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### 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)
+
+Sends a test payload to the given URL to verify webhook connectivity and signature. Uses the same signing as real deliveries.
+
+### 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({ 
+    // To configure API key authorization: ApiKeyAuth
+    apiKey: "YOUR API KEY",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new WalletApi(config);
+
+  const body = {
+    // TestWalletWebhookRequest | URL to send the test POST to; optional secret and projectId for scoping; optional event type to simulate.
+    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) | URL to send the test POST to; optional secret and projectId for scoping; optional event type to simulate. | |
+
+### Return type
+
+[**TestWalletWebhook200Response**](TestWalletWebhook200Response.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### 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)
+
+
+## updateWalletWebhook
+
+> UpdateWalletWebhook200Response updateWalletWebhook(webhookId, updateWalletWebhookRequest)
+
+Update a wallet webhook
+
+Update webhook URL, events, secret, or filters. Partially applied; only provided fields are updated.
+
+### 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({ 
+    // To configure API key authorization: ApiKeyAuth
+    apiKey: "YOUR API KEY",
+    // 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,
+    // UpdateWalletWebhookRequest | Fields to update (url, events, secret, filters). Omitted fields are left unchanged.
+    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` | Webhook ID (MongoDB ObjectId) to update. | [Defaults to `undefined`] |
+| **updateWalletWebhookRequest** | [UpdateWalletWebhookRequest](UpdateWalletWebhookRequest.md) | Fields to update (url, events, secret, filters). Omitted fields are left unchanged. | |
+
+### Return type
+
+[**UpdateWalletWebhook200Response**](UpdateWalletWebhook200Response.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### 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)
+