@arkade-os/sdk 0.4.28 → 0.4.30

package/README.md

@@ -31,8 +31,6 @@ const identity = MnemonicIdentity.fromMnemonic(mnemonic)
 const wallet = await Wallet.create({ identity })  // defaults to mainnet
 ```
 
-To use a different network, pass `arkServerUrl` option.
-
 ### Read-Only Wallets (Watch-Only)
 
 The SDK supports read-only wallets that allow you to query wallet state without exposing private keys. This is useful for:
@@ -541,30 +539,30 @@ const balance = await manager.getRecoverableBalance()
 
 Delegation allows users to outsource virtual output renewal to a third-party delegation service.
 
-Instead of the delegating user renewing virtual outputs by themself, their delegate will automatically settle them before they expire, sending the funds back to the delegator's wallet address (minus a service fee).
+Instead of the delegating user renewing virtual outputs by themselves, their delegate will automatically settle them before they expire, sending the funds back to the user's wallet address (minus a service fee).
 
 This is useful for wallets that cannot be online 24/7.
 
-When a `delegatorProvider` is configured, the wallet address includes an extra tapscript path that authorizes the delegate to co-sign renewals alongside the Arkade server.
+When a `delegateProvider` is configured, the wallet address includes an extra tapscript path that authorizes the delegate to co-sign renewals alongside the Arkade server.
 
 To run a delegation service, you'll need to set up a [Fulmine server](https://github.com/ArkLabsHQ/fulmine) with the [Delegation API](https://github.com/ArkLabsHQ/fulmine?tab=readme-ov-file#-delegate-api) enabled.
 
 #### Setting Up a Wallet with Delegation
 
 ```typescript
-import { Wallet, MnemonicIdentity, RestDelegatorProvider } from '@arkade-os/sdk'
+import { Wallet, MnemonicIdentity, RestDelegateProvider } from '@arkade-os/sdk'
 
 const wallet = await Wallet.create({
   identity: MnemonicIdentity.fromMnemonic('abandon abandon...'),
-  delegatorProvider: new RestDelegatorProvider('http://localhost:7001'),
+  delegateProvider: new RestDelegateProvider('http://localhost:7001'),
 })
 ```
 
-> **Note:** Adding a `delegatorProvider` changes your wallet address because the offchain tapscript includes an additional delegation path. Funds sent to an address without delegation cannot be delegated, and vice versa.
+> **Note:** Adding a `delegateProvider` changes your wallet address because the offchain tapscript includes an additional delegation path. Funds sent to an address without delegation cannot be delegated, and vice versa.
 
 #### Delegating Virtual Outputs
 
-Once the wallet is configured with a delegate, use `wallet.delegatorManager` to delegate your virtual outputs:
+Once the wallet is configured with a delegate, use `wallet.getDelegateManager()` to delegate your virtual outputs:
 
 ```typescript
 // Get spendable virtual outputs (including recoverable)
@@ -572,8 +570,8 @@ const vtxos = await wallet.getVtxos({ withRecoverable: true })
 
 // Delegate all virtual outputs — the delegate will renew them before expiry
 const arkadeAddress = await wallet.getAddress()
-const delegatorManager = await wallet.getDelegatorManager();
-const delegationResult = await delegatorManager.delegate(vtxos, arkadeAddress)
+const delegateManager = await wallet.getDelegateManager();
+const delegationResult = await delegateManager.delegate(vtxos, arkadeAddress)
 
 console.log('Delegated:', delegationResult.delegated.length)
 console.log('Failed:', delegationResult.failed.length)
@@ -588,12 +586,12 @@ You can override this with an explicit date:
 ```typescript
 // Delegate with a specific renewal time
 const delegateAt = new Date(Date.now() + 12 * 60 * 60 * 1000) // 12 hours from now
-await delegatorManager.delegate(vtxos, arkadeAddress, delegateAt)
+await delegateManager.delegate(vtxos, arkadeAddress, delegateAt)
 ```
 
 #### Service Worker Integration
 
-When using a service worker wallet, pass the `delegatorUrl` option. The service worker will automatically delegate virtual outputs after each update:
+When using a service worker wallet, pass the `delegateUrl` option. The service worker will automatically delegate virtual outputs after each update:
 
 ```typescript
 import { ServiceWorkerWallet, MnemonicIdentity } from '@arkade-os/sdk'
@@ -601,7 +599,7 @@ import { ServiceWorkerWallet, MnemonicIdentity } from '@arkade-os/sdk'
 const wallet = await ServiceWorkerWallet.setup({
   serviceWorkerPath: '/service-worker.js',
   identity: MnemonicIdentity.fromMnemonic('abandon abandon...'),
-  delegatorUrl: 'http://localhost:7001',
+  delegateUrl: 'http://localhost:7001',
 })
 ```
 
@@ -610,14 +608,14 @@ const wallet = await ServiceWorkerWallet.setup({
 You can query the delegation service directly to inspect its public key, fee, and payment address:
 
 ```typescript
-import { RestDelegatorProvider } from '@arkade-os/sdk'
+import { RestDelegateProvider } from '@arkade-os/sdk'
 
-const provider = new RestDelegatorProvider('https://delegator.example.com')
+const provider = new RestDelegateProvider('https://delegate.example.com')
 const info = await provider.getDelegateInfo()
 
 console.log('Delegate public key:', info.pubkey)
 console.log('Service fee (sats):', info.fee)
-console.log('Fee address:', info.delegatorAddress)
+console.log('Fee address:', info.delegateAddress)
 ```
 
 ### BIP-322 Message Signing

package/dist/adapters/expo.cjs

@@ -1,19 +1,19 @@
 'use strict';
 
-var chunkFG5ACJJW_cjs = require('../chunk-FG5ACJJW.cjs');
-require('../chunk-ADV27S4N.cjs');
-require('../chunk-5PG7DV7A.cjs');
+var chunkGIGILVVP_cjs = require('../chunk-GIGILVVP.cjs');
+require('../chunk-6FLL2Q36.cjs');
+require('../chunk-WMIPYZSB.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 
 
 Object.defineProperty(exports, "ExpoArkProvider", {
   enumerable: true,
-  get: function () { return chunkFG5ACJJW_cjs.ExpoArkProvider; }
+  get: function () { return chunkGIGILVVP_cjs.ExpoArkProvider; }
 });
 Object.defineProperty(exports, "ExpoIndexerProvider", {
   enumerable: true,
-  get: function () { return chunkFG5ACJJW_cjs.ExpoIndexerProvider; }
+  get: function () { return chunkGIGILVVP_cjs.ExpoIndexerProvider; }
 });
 //# sourceMappingURL=expo.cjs.map
 //# sourceMappingURL=expo.cjs.map

package/dist/adapters/expo.d.cts

@@ -1,5 +1,5 @@
-import { j as RestArkProvider, h as SettlementEvent, T as TxNotification, k as RestIndexerProvider, l as SubscriptionResponse } from '../ark-TZ1gXAXU.cjs';
-export { m as ArkProvider, n as IndexerProvider } from '../ark-TZ1gXAXU.cjs';
+import { j as RestArkProvider, h as SettlementEvent, T as TxNotification, k as RestIndexerProvider, l as SubscriptionResponse } from '../ark-C0TMXvwO.cjs';
+export { m as ArkProvider, n as IndexerProvider } from '../ark-C0TMXvwO.cjs';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';
@@ -19,7 +19,7 @@ import '@scure/btc-signer';
  * ```
  */
 declare class ExpoArkProvider extends RestArkProvider {
-    constructor(serverUrl: string);
+    constructor(serverUrl?: string);
     getEventStream(signal: AbortSignal, topics: string[]): AsyncIterableIterator<SettlementEvent>;
     getTransactionsStream(signal: AbortSignal): AsyncIterableIterator<{
         commitmentTx?: TxNotification;
@@ -41,7 +41,7 @@ declare class ExpoArkProvider extends RestArkProvider {
  * ```
  */
 declare class ExpoIndexerProvider extends RestIndexerProvider {
-    constructor(serverUrl: string);
+    constructor(serverUrl?: string);
     getSubscription(subscriptionId: string, abortSignal: AbortSignal): AsyncIterableIterator<SubscriptionResponse>;
 }
 

package/dist/adapters/expo.d.ts

@@ -1,5 +1,5 @@
-import { j as RestArkProvider, h as SettlementEvent, T as TxNotification, k as RestIndexerProvider, l as SubscriptionResponse } from '../ark-TZ1gXAXU.js';
-export { m as ArkProvider, n as IndexerProvider } from '../ark-TZ1gXAXU.js';
+import { j as RestArkProvider, h as SettlementEvent, T as TxNotification, k as RestIndexerProvider, l as SubscriptionResponse } from '../ark-C0TMXvwO.js';
+export { m as ArkProvider, n as IndexerProvider } from '../ark-C0TMXvwO.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';
@@ -19,7 +19,7 @@ import '@scure/btc-signer';
  * ```
  */
 declare class ExpoArkProvider extends RestArkProvider {
-    constructor(serverUrl: string);
+    constructor(serverUrl?: string);
     getEventStream(signal: AbortSignal, topics: string[]): AsyncIterableIterator<SettlementEvent>;
     getTransactionsStream(signal: AbortSignal): AsyncIterableIterator<{
         commitmentTx?: TxNotification;
@@ -41,7 +41,7 @@ declare class ExpoArkProvider extends RestArkProvider {
  * ```
  */
 declare class ExpoIndexerProvider extends RestIndexerProvider {
-    constructor(serverUrl: string);
+    constructor(serverUrl?: string);
     getSubscription(subscriptionId: string, abortSignal: AbortSignal): AsyncIterableIterator<SubscriptionResponse>;
 }
 

package/dist/adapters/expo.js

@@ -1,6 +1,6 @@
-export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-CFZMTDWI.js';
-import '../chunk-ZBUDLTBO.js';
-import '../chunk-HW3JJ323.js';
+export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-ABWRLTX5.js';
+import '../chunk-6NWNOLL3.js';
+import '../chunk-TU3LVAPX.js';
 import '../chunk-NSBPE2FW.js';
 //# sourceMappingURL=expo.js.map
 //# sourceMappingURL=expo.js.map

package/dist/adapters/indexedDB.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkZLO6NETT_cjs = require('../chunk-ZLO6NETT.cjs');
-require('../chunk-ADV27S4N.cjs');
-require('../chunk-I3DGUUCT.cjs');
-require('../chunk-5PG7DV7A.cjs');
+var chunkXWJFOP5G_cjs = require('../chunk-XWJFOP5G.cjs');
+require('../chunk-6FLL2Q36.cjs');
+require('../chunk-IEO3XDKI.cjs');
+require('../chunk-WMIPYZSB.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 // src/storage/indexedDB.ts
@@ -11,7 +11,7 @@ var IndexedDBStorageAdapter = class {
   dbName;
   version;
   db = null;
-  constructor(dbName, version = chunkZLO6NETT_cjs.DB_VERSION) {
+  constructor(dbName, version = chunkXWJFOP5G_cjs.DB_VERSION) {
     this.dbName = dbName;
     this.version = version;
   }

package/dist/adapters/indexedDB.js

@@ -1,7 +1,7 @@
-import { DB_VERSION } from '../chunk-BQLHADL7.js';
-import '../chunk-ZBUDLTBO.js';
-import '../chunk-T64LAI7L.js';
-import '../chunk-HW3JJ323.js';
+import { DB_VERSION } from '../chunk-6NY27WL6.js';
+import '../chunk-6NWNOLL3.js';
+import '../chunk-YA4G7RFB.js';
+import '../chunk-TU3LVAPX.js';
 import '../chunk-NSBPE2FW.js';
 
 // src/storage/indexedDB.ts

package/dist/{ark-TZ1gXAXU.d.cts → ark-C0TMXvwO.d.cts}

@@ -460,7 +460,7 @@ declare class VtxoScript {
      * @returns Arkade address for this script
      * @see ArkAddress
      */
-    address(prefix: string, serverPubKey: Bytes): ArkAddress;
+    address(prefix: string | undefined, serverPubKey: Bytes): ArkAddress;
     get pkScript(): Bytes;
     /**
      * Build the Taproot onchain address corresponding to this virtual output script.
@@ -469,7 +469,7 @@ declare class VtxoScript {
      * @returns Taproot onchain address
      * @see address
      */
-    onchainAddress(network: typeof NETWORK): string;
+    onchainAddress(network?: typeof NETWORK): string;
     /**
      * Look up a tapleaf script by its hex-encoded tapscript body.
      *
@@ -551,13 +551,13 @@ interface RenewalConfig {
  * // Default behavior: virtual output renewal at 3 days, boarding sweep enabled, polling every minute
  * const wallet = await Wallet.create({
  *   identity: MnemonicIdentity.fromMnemonic('abandon abandon...'),
- *   arkServerUrl: 'https://arkade.computer',
+ *   arkProvider: new RestArkProvider(),
  * });
  *
  * // Custom expiry threshold of 24 hours
  * const wallet = await Wallet.create({
  *   identity: MnemonicIdentity.fromMnemonic('abandon abandon...'),
- *   arkServerUrl: 'https://arkade.computer',
+ *   arkProvider: new RestArkProvider(),
  *   settlementConfig: {
  *     vtxoThreshold: 60 * 60 * 24, // 24 hours in seconds
  *   },
@@ -566,7 +566,7 @@ interface RenewalConfig {
  * // Explicitly disable
  * const wallet = await Wallet.create({
  *   identity: MnemonicIdentity.fromMnemonic('abandon abandon...'),
- *   arkServerUrl: 'https://arkade.computer',
+ *   arkProvider: new RestArkProvider(),
  *   settlementConfig: false,
  * });
  * ```
@@ -608,6 +608,19 @@ interface SettlementConfig {
  * @returns true if virtual output expires within threshold, false otherwise
  */
 declare function isVtxoExpiringSoon(vtxo: ExtendedVirtualCoin, thresholdMs: number): boolean;
+/**
+ * Optional arguments for {@link IVtxoManager.renewVtxos}.
+ */
+interface RenewVtxosOptions {
+    /**
+     * Override the renewal threshold for this call only, in seconds.
+     *
+     * When provided, takes precedence over `SettlementConfig.vtxoThreshold`
+     * and the default (3 days). Useful for renewing only VTXOs that are
+     * more urgently expiring than the globally configured threshold.
+     */
+    thresholdSeconds?: number;
+}
 /**
  * VtxoManager is a unified class for managing virtual output lifecycle operations including
  * recovery of swept/expired virtual outputs and renewal to prevent expiration.
@@ -626,7 +639,7 @@ declare function isVtxoExpiringSoon(vtxo: ExtendedVirtualCoin, thresholdMs: numb
  * ```typescript
  * const wallet = await Wallet.create({
  *   identity,
- *   arkServerUrl: 'https://arkade.computer',
+ *   arkProvider: new RestArkProvider(),
  *   settlementConfig: {
  *      // Seconds before virtual output expiry to trigger renewal
  *      vtxoThreshold: 259_200, // 3 days
@@ -662,7 +675,7 @@ interface IVtxoManager {
         vtxoCount: number;
     }>;
     getExpiringVtxos(thresholdMs?: number): Promise<ExtendedVirtualCoin[]>;
-    renewVtxos(eventCallback?: (event: SettlementEvent) => void): Promise<string>;
+    renewVtxos(eventCallback?: (event: SettlementEvent) => void, options?: RenewVtxosOptions): Promise<string>;
     getExpiredBoardingUtxos(): Promise<ExtendedCoin[]>;
     sweepExpiredBoardingUtxos(): Promise<string>;
     dispose(): Promise<void>;
@@ -763,7 +776,7 @@ declare class VtxoManager implements AsyncDisposable, IVtxoManager {
      * ```typescript
      * const wallet = await Wallet.create({
      *  identity,
-     *  arkServerUrl: 'https://arkade.computer',
+     *  arkProvider: new RestArkProvider(),
      *  settlementConfig: {
      *      vtxoThreshold: 86_400 // 24 hours
      *  },
@@ -784,6 +797,7 @@ declare class VtxoManager implements AsyncDisposable, IVtxoManager {
      * primary way to prevent virtual outputs from expiring.
      *
      * @param eventCallback - Optional callback for settlement events
+     * @param options - Optional per-call overrides; see {@link RenewVtxosOptions}
      * @returns Settlement transaction ID
      * @throws Error if no virtual outputs available to renew
      * @throws Error if total amount is below dust threshold
@@ -799,9 +813,12 @@ declare class VtxoManager implements AsyncDisposable, IVtxoManager {
      * const txid = await manager.renewVtxos((event) => {
      *   console.log('Settlement event:', event.type);
      * });
+     *
+     * // Renew only VTXOs that expire within 6 hours
+     * const txid = await manager.renewVtxos(undefined, { thresholdSeconds: 6 * 60 * 60 });
      * ```
      */
-    renewVtxos(eventCallback?: (event: SettlementEvent) => void): Promise<string>;
+    renewVtxos(eventCallback?: (event: SettlementEvent) => void, options?: RenewVtxosOptions): Promise<string>;
     /**
      * Get boarding inputs whose timelock has expired.
      *
@@ -841,7 +858,7 @@ declare class VtxoManager implements AsyncDisposable, IVtxoManager {
      * ```typescript
      * const wallet = await Wallet.create({
      *   identity,
-     *   arkServerUrl: 'https://arkade.computer',
+     *   arkProvider: new RestArkProvider(),
      *   settlementConfig: {
      *     boardingUtxoSweep: true,
      *   },
@@ -1074,7 +1091,7 @@ declare class EsploraProvider implements OnchainProvider {
     private baseUrl;
     readonly pollingInterval: number;
     readonly forcePolling: boolean;
-    constructor(baseUrl: string, opts?: {
+    constructor(baseUrl?: string, opts?: {
         /** Polling interval in milliseconds. */
         pollingInterval?: number;
         /** Force polling even when websocket transport is available. */
@@ -2288,13 +2305,12 @@ declare namespace Intent {
 interface DelegateInfo {
     /** Delegate public key. */
     pubkey: string;
-    /** Delegate fee amount or expression returned by the delegation service. */
+    /** Delegate fee amount or expression returned by the delegate. */
     fee: string;
-    /**
-     * Address controlled by the delegation service.
-     * Naming is confusing: should be thought of as a "delegate address".
-     */
-    delegatorAddress: string;
+    /** Address for delegate fee collection. Sourced from `delegatorAddress` in Fulmine response, for now. */
+    delegateAddress: string;
+    /** @deprecated alias for @see DelegateInfo.delegateAddress */
+    delegatorAddress?: string;
 }
 /**
  * Optional delegate behavior flags.
@@ -2310,9 +2326,9 @@ interface DelegateOptions {
     rejectReplace?: boolean;
 }
 /**
- * Provider interface for remote delegation services.
+ * Provider interface for remote delegation service.
  */
-interface DelegatorProvider {
+interface DelegateProvider {
     /**
      * Request delegation for a signed register intent and its forfeit transactions.
      *
@@ -2328,21 +2344,23 @@ interface DelegatorProvider {
      */
     getDelegateInfo(): Promise<DelegateInfo>;
 }
+/** @deprecated alias for @see DelegateProvider */
+type DelegatorProvider = DelegateProvider;
 /**
- * REST-based delegation provider implementation.
+ * REST-based delegate provider implementation.
  * @example
  * ```typescript
- * const provider = new RestDelegatorProvider('https://delegator.example.com');
+ * const provider = new RestDelegateProvider('https://delegate.example.com');
  * const info = await provider.getDelegateInfo();
  * await provider.delegate(intent, forfeitTxs);
  * ```
  */
-declare class RestDelegatorProvider implements DelegatorProvider {
+declare class RestDelegateProvider implements DelegateProvider {
     url: string;
     /**
-     * Create a REST delegation provider targeting the given base URL.
+     * Create a REST delegate provider targeting the given base URL.
      *
-     * @param url - Base URL of the delegation service
+     * @param url - Base URL of the remote delegation service.
      */
     constructor(url: string);
     /**
@@ -2362,14 +2380,17 @@ declare class RestDelegatorProvider implements DelegatorProvider {
      */
     getDelegateInfo(): Promise<DelegateInfo>;
 }
+/** @deprecated alias for @see RestDelegateProvider */
+declare const RestDelegatorProvider: typeof RestDelegateProvider;
+type RestDelegatorProvider = RestDelegateProvider;
 
-interface IDelegatorManager {
+interface IDelegateManager {
     /**
      * Delegate virtual outputs to the remote delegation service.
      *
      * Vtxos that are not locked to a delegate-type contract (no tap leaf
-     * matches the delegator's pubkey) are filtered out silently, since they
-     * cannot be co-signed by the delegator.
+     * matches the delegate's pubkey) are filtered out silently, since they
+     * cannot be co-signed by the delegate.
      *
      * @param vtxos - Virtual outputs to delegate
      * @param destination - Arkade address that should receive renewed funds
@@ -2386,12 +2407,14 @@ interface IDelegatorManager {
     /** Fetch delegate metadata such as pubkey, fee, and delegate address. */
     getDelegateInfo(): Promise<DelegateInfo>;
 }
-declare class DelegatorManagerImpl implements IDelegatorManager {
-    readonly delegatorProvider: DelegatorProvider;
+/** @deprecated alias for @see IDelegateManager */
+type IDelegatorManager = IDelegateManager;
+declare class DelegateManagerImpl implements IDelegateManager {
+    readonly delegateProvider: DelegateProvider;
     readonly arkInfoProvider: Pick<ArkProvider, "getInfo">;
     readonly identity: Identity;
-    /** Create a delegator manager from the configured provider, Arkade info source, and wallet identity. */
-    constructor(delegatorProvider: DelegatorProvider, arkInfoProvider: Pick<ArkProvider, "getInfo">, identity: Identity);
+    /** Create a delegate manager from the configured provider, Arkade info source, and wallet identity. */
+    constructor(delegateProvider: DelegateProvider, arkInfoProvider: Pick<ArkProvider, "getInfo">, identity: Identity);
     getDelegateInfo(): Promise<DelegateInfo>;
     delegate(vtxos: ContractVtxo[], destination: string, delegateAt?: Date): Promise<{
         delegated: Outpoint[];
@@ -2401,6 +2424,9 @@ declare class DelegatorManagerImpl implements IDelegatorManager {
         }[];
     }>;
 }
+/** @deprecated alias for @see DelegateManagerImpl */
+declare const DelegatorManagerImpl: typeof DelegateManagerImpl;
+type DelegatorManagerImpl = DelegateManagerImpl;
 
 /**
  * Wallet receive-address strategy.
@@ -2431,11 +2457,11 @@ type WalletMode = "auto" | "static" | "hd" | DescriptorProvider;
  *
  * Supports URL-based and provider-based configuration.
  *
- * URL-based configuration starts from `arkServerUrl` and can optionally override
+ * @deprecated URL-based configuration starts from `arkServerUrl` and can optionally override
  * derived service URLs such as `indexerUrl` and `esploraUrl`.
  *
  * Provider-based configuration supplies concrete provider instances directly,
- * including the ArkProvider, IndexerProvider, OnchainProvider, and DelegatorProvider.
+ * including the ArkProvider, IndexerProvider, OnchainProvider, and DelegateProvider.
  *
  * The wallet will use provided URLs to create default providers if custom provider
  * instances are not supplied. If optional parameters are not provided, the wallet
@@ -2450,11 +2476,24 @@ type WalletMode = "auto" | "static" | "hd" | DescriptorProvider;
  * @see StorageConfig
  */
 interface BaseWalletConfig {
-    /** Base URL of the Arkade server. */
+    /**
+     * Base URL of the Arkade server.
+     *
+     * @deprecated Pass an explicit `arkProvider` instance instead. URL-based
+     * configuration will be removed in a future major version.
+     */
     arkServerUrl?: string;
-    /** Optional override for the indexer URL. */
+    /**
+     * Optional override for the indexer URL.
+     *
+     * @deprecated Pass an explicit `indexerProvider` instance instead.
+     */
     indexerUrl?: string;
-    /** Optional override for the Esplora API URL. */
+    /**
+     * Optional override for the Esplora API URL.
+     *
+     * @deprecated Pass an explicit `onchainProvider` instance instead.
+     */
     esploraUrl?: string;
     /** Optional Arkade server public key used to construct and validate Arkade addresses. */
     arkServerPublicKey?: string;
@@ -2474,7 +2513,9 @@ interface BaseWalletConfig {
     /** Optional onchain provider instance. */
     onchainProvider?: OnchainProvider;
     /** Optional delegation service instance. */
-    delegatorProvider?: DelegatorProvider;
+    delegateProvider?: DelegateProvider;
+    /** @deprecated alias for @see BaseWalletConfig.delegateProvider */
+    delegatorProvider?: DelegateProvider;
 }
 /**
  * Configuration options for readonly wallet initialization.
@@ -2490,19 +2531,12 @@ interface BaseWalletConfig {
  *
  * @example
  * ```typescript
- * // URL-based configuration
- * const wallet = await ReadonlyWallet.create({
- *   identity: ReadonlySingleKey.fromPublicKey(pubkey),
- *   arkServerUrl: 'https://arkade.computer',
- *   esploraUrl: 'https://mempool.space/api'
- * });
- *
  * // Provider-based configuration (e.g., for Expo/React Native)
  * const wallet = await ReadonlyWallet.create({
  *   identity: ReadonlySingleKey.fromPublicKey(pubkey),
- *   arkProvider: new ExpoArkProvider('https://arkade.computer'),
- *   indexerProvider: new ExpoIndexerProvider('https://arkade.computer'),
- *   onchainProvider: new EsploraProvider('https://mempool.space/api')
+ *   arkProvider: new ExpoArkProvider(),
+ *   indexerProvider: new ExpoIndexerProvider(),
+ *   onchainProvider: new EsploraProvider()
  * });
  * ```
  */
@@ -2528,25 +2562,18 @@ interface ReadonlyWalletConfig extends BaseWalletConfig {
  *
  * @example
  * ```typescript
- * // URL-based configuration
- * const wallet = await Wallet.create({
- *   identity: MnemonicIdentity.fromMnemonic('abandon abandon...'),
- *   arkServerUrl: 'https://arkade.computer',
- *   esploraUrl: 'https://mempool.space/api'
- * });
- *
- * // Provider-based configuration (e.g., for Expo/React Native)
+ * // Provider-based configuration
  * const wallet = await Wallet.create({
  *   identity: MnemonicIdentity.fromMnemonic('abandon abandon...'),
- *   arkProvider: new ExpoArkProvider('https://arkade.computer'),
- *   indexerProvider: new ExpoIndexerProvider('https://arkade.computer'),
- *   onchainProvider: new EsploraProvider('https://mempool.space/api')
+ *   arkProvider: new ExpoArkProvider(),
+ *   indexerProvider: new ExpoIndexerProvider(),
+ *   onchainProvider: new EsploraProvider()
  * });
  *
  * // With settlement configuration
  * const wallet = await Wallet.create({
  *   identity: MnemonicIdentity.fromMnemonic('abandon abandon...'),
- *   arkServerUrl: 'https://arkade.computer',
+ *   arkProvider: new RestArkProvider(),
  *   settlementConfig: {
  *     vtxoThreshold: 60 * 60 * 24, // 24 hours in seconds
  *     boardingUtxoSweep: true,
@@ -3131,7 +3158,9 @@ interface IWallet extends IReadonlyWallet {
     /** Asset manager bound to this wallet instance. */
     assetManager: IAssetManager;
     /** @returns Delegation manager, when configured. */
-    getDelegatorManager(): Promise<IDelegatorManager | undefined>;
+    getDelegateManager(): Promise<IDelegateManager | undefined>;
+    /** @deprecated alias for @see IWallet.getDelegateManager */
+    getDelegatorManager(): Promise<IDelegateManager | undefined>;
 }
 /**
  * Readonly wallet interface for Bitcoin transactions with Arkade protocol support.
@@ -3439,7 +3468,7 @@ interface IndexerProvider {
  */
 declare class RestIndexerProvider implements IndexerProvider {
     serverUrl: string;
-    constructor(serverUrl: string);
+    constructor(serverUrl?: string);
     getVtxoTree(batchOutpoint: Outpoint, opts?: PaginationOptions): Promise<{
         vtxoTree: Tx[];
         page?: PageResponse;
@@ -3709,7 +3738,7 @@ interface ArkProvider {
  */
 declare class RestArkProvider implements ArkProvider {
     serverUrl: string;
-    constructor(serverUrl: string);
+    constructor(serverUrl?: string);
     getInfo(): Promise<ArkInfo>;
     submitTx(signedArkTx: string, checkpointTxs: string[]): Promise<{
         arkTxid: string;
@@ -3877,4 +3906,4 @@ declare namespace ProtoTypes {
     export {  };
 }
 
-export { CSVMultisigTapscript as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type BatchFailedEvent as D, type ExtendedVirtualCoin as E, type TreeTxEvent as F, type GetVtxosFilter as G, type TreeSignatureEvent as H, type IWallet as I, type DescriptorProvider as J, type Coin as K, type IReadonlyWallet as L, type ReadonlyIdentity as M, type Network as N, type OnchainProvider as O, type DelegatorProvider as P, type ReadonlyWalletConfig as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type IReadonlyAssetManager as U, VtxoScript as V, type WalletRepository as W, type NetworkName as X, type ArkInfo as Y, ArkAddress as Z, ContractManager as _, type Identity as a, MultisigTapscript as a$, type SettlementConfig as a0, VtxoManager as a1, type SignerSession as a2, type SignedIntent as a3, Intent as a4, type DescriptorSigningRequest as a5, Transaction as a6, type IntentFeeConfig as a7, type OffchainInput as a8, FeeAmount as a9, type AssetMetadata as aA, type BaseWalletConfig as aB, type BatchInfo as aC, type BatchSignableIdentity as aD, CLTVMultisigTapscript as aE, ChainTxType as aF, type CommitmentTx as aG, ConditionCSVMultisigTapscript as aH, ConditionMultisigTapscript as aI, type ContractBalance as aJ, type ContractEventCallback as aK, type ContractHandler as aL, type ContractManagerConfig as aM, type ContractState as aN, type ContractVtxo as aO, ContractWatcher as aP, type DelegateOptions as aQ, DelegatorManagerImpl as aR, type Discoverable as aS, type DiscoveredContract as aT, type DiscoveryDeps as aU, ESPLORA_URL as aV, EsploraProvider as aW, type ExtendedContractVtxo as aX, type HandlerError as aY, IndexerTxType as aZ, type KnownMetadata as a_, type OnchainInput as aa, type FeeOutput as ab, type ContractWatcherConfig as ac, type FeeInfo as ad, type CreateContractParams as ae, type GetContractsFilter as af, type GetSpendablePathsOptions as ag, type GetAllSpendingPathsOptions as ah, type IssuanceParams as ai, type ReissuanceParams as aj, type BurnParams as ak, type ContractWithVtxos as al, type PathSelection as am, type ContractEvent as an, type AssetDetails as ao, type IssuanceResult as ap, type DelegateInfo as aq, type StorageConfig as ar, type IVtxoManager as as, type ExplorerTransaction as at, type EncodedVtxoScript as au, type Status as av, type Outpoint as aw, type ChainTx as ax, type ArkTapscript as ay, type Asset as az, type WalletConfig as b, type Nonces as b0, type Output as b1, type PageResponse as b2, type PaginationOptions as b3, PartialSig as b4, type PathContext as b5, type ProviderClass as b6, RestDelegatorProvider as b7, type ScanContractsOptions as b8, type ScanResult as b9, isSpendable as bA, isSubdust as bB, isVtxoExpiringSoon as bC, networks as bD, type ScheduledSession as ba, SettlementEventType as bb, type SignRequest as bc, type SubscriptionEvent as bd, type SubscriptionHeartbeat as be, type TapLeaves as bf, TapTreeCoder as bg, TapscriptType as bh, type TreeNonces as bi, type TreePartialSigs as bj, type Tx as bk, type TxHistoryRecord as bl, type TxKey as bm, type TxTreeNode as bn, TxType as bo, type VirtualStatus as bp, type Vtxo as bq, type VtxoChain as br, type VtxoType as bs, type WalletMode as bt, decodeTapscript as bu, getSequence as bv, isBatchSignable as bw, isDiscoverable as bx, isExpired as by, isRecoverable as bz, type WalletBalance as c, type ExtendedCoin as d, type IContractManager as e, type IDelegatorManager as f, type SettleParams as g, type SettlementEvent as h, type IAssetManager as i, RestArkProvider as j, RestIndexerProvider as k, type SubscriptionResponse as l, type ArkProvider as m, type IndexerProvider as n, type RelativeTimelock as o, type TapLeafScript as p, type VirtualCoin as q, type Contract as r, type VtxoRepositoryKey as s, type WalletState as t, type ContractFilter as u, type TreeSigningStartedEvent as v, TxTree as w, type TreeNoncesEvent as x, type BatchFinalizationEvent as y, type BatchFinalizedEvent as z };
+export { type SignerSession as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type DescriptorProvider as D, type ExtendedVirtualCoin as E, type IReadonlyWallet as F, type GetVtxosFilter as G, type ReadonlyIdentity as H, type IWallet as I, type DelegateProvider as J, type ReadonlyWalletConfig as K, type IReadonlyAssetManager as L, type NetworkName as M, type Network as N, type OnchainProvider as O, type ArkInfo as P, ArkAddress as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type Coin as U, VtxoScript as V, type WalletRepository as W, ContractManager as X, CSVMultisigTapscript as Y, type SettlementConfig as Z, VtxoManager as _, type Identity as a, type HandlerError as a$, type SignedIntent as a0, Intent as a1, type VtxoRepositoryKey as a2, type WalletState as a3, type ContractFilter as a4, type DescriptorSigningRequest as a5, Transaction as a6, type IntentFeeConfig as a7, type OffchainInput as a8, FeeAmount as a9, type Asset as aA, type AssetMetadata as aB, type BaseWalletConfig as aC, type BatchInfo as aD, type BatchSignableIdentity as aE, CLTVMultisigTapscript as aF, ChainTxType as aG, type CommitmentTx as aH, ConditionCSVMultisigTapscript as aI, ConditionMultisigTapscript as aJ, type ContractBalance as aK, type ContractEventCallback as aL, type ContractHandler as aM, type ContractManagerConfig as aN, type ContractState as aO, type ContractVtxo as aP, ContractWatcher as aQ, DelegateManagerImpl as aR, type DelegateOptions as aS, DelegatorManagerImpl as aT, type DelegatorProvider as aU, type Discoverable as aV, type DiscoveredContract as aW, type DiscoveryDeps as aX, ESPLORA_URL as aY, EsploraProvider as aZ, type ExtendedContractVtxo as a_, type OnchainInput as aa, type FeeOutput as ab, type ContractWatcherConfig as ac, type FeeInfo as ad, type CreateContractParams as ae, type GetContractsFilter as af, type GetSpendablePathsOptions as ag, type GetAllSpendingPathsOptions as ah, type IssuanceParams as ai, type ReissuanceParams as aj, type BurnParams as ak, type RenewVtxosOptions as al, type ContractWithVtxos as am, type PathSelection as an, type ContractEvent as ao, type AssetDetails as ap, type IssuanceResult as aq, type DelegateInfo as ar, type StorageConfig as as, type IVtxoManager as at, type ExplorerTransaction as au, type EncodedVtxoScript as av, type Status as aw, type Outpoint as ax, type ChainTx as ay, type ArkTapscript as az, type WalletConfig as b, type IDelegatorManager as b0, IndexerTxType as b1, type KnownMetadata as b2, MultisigTapscript as b3, type Nonces as b4, type Output as b5, type PageResponse as b6, type PaginationOptions as b7, PartialSig as b8, type PathContext as b9, getSequence as bA, isBatchSignable as bB, isDiscoverable as bC, isExpired as bD, isRecoverable as bE, isSpendable as bF, isSubdust as bG, isVtxoExpiringSoon as bH, networks as bI, type ProviderClass as ba, RestDelegateProvider as bb, RestDelegatorProvider as bc, type ScanContractsOptions as bd, type ScanResult as be, type ScheduledSession as bf, SettlementEventType as bg, type SignRequest as bh, type SubscriptionEvent as bi, type SubscriptionHeartbeat as bj, type TapLeaves as bk, TapTreeCoder as bl, TapscriptType as bm, type TreeNonces as bn, type TreePartialSigs as bo, type Tx as bp, type TxHistoryRecord as bq, type TxKey as br, type TxTreeNode as bs, TxType as bt, type VirtualStatus as bu, type Vtxo as bv, type VtxoChain as bw, type VtxoType as bx, type WalletMode as by, decodeTapscript as bz, type WalletBalance as c, type ExtendedCoin as d, type IContractManager as e, type IDelegateManager as f, type SettleParams as g, type SettlementEvent as h, type IAssetManager as i, RestArkProvider as j, RestIndexerProvider as k, type SubscriptionResponse as l, type ArkProvider as m, type IndexerProvider as n, type RelativeTimelock as o, type TapLeafScript as p, type VirtualCoin as q, type Contract as r, type TreeSigningStartedEvent as s, TxTree as t, type TreeNoncesEvent as u, type BatchFinalizationEvent as v, type BatchFinalizedEvent as w, type BatchFailedEvent as x, type TreeTxEvent as y, type TreeSignatureEvent as z };