@arkade-os/sdk 0.4.28 → 0.4.29

package/dist/{chunk-BQLHADL7.js → chunk-BVP2U66Q.js}

@@ -1,7 +1,7 @@
-import { craftToSpendTx, Transaction, OP_RETURN_EMPTY_PKSCRIPT, Intent, getArkPsbtFields, CosignerPublicKey, setArkPsbtField, VtxoTaprootTree, maybeArkError, isEventSourceError, RestArkProvider, RestIndexerProvider, ArkError, BufferReader, Packet, AssetInput, AssetOutput, AssetId, AssetGroup, AssetRef, Metadata } from './chunk-ZBUDLTBO.js';
-import { isMainnetDescriptor, descriptorIsOurs, contractHandlers, DelegateVtxo, DefaultVtxo, WALLET_RECEIVE_SOURCE, deriveDescriptorLeafPubKey } from './chunk-T64LAI7L.js';
-import { VtxoScript, timelockToSequence, DEFAULT_ARKADE_HRP, decodeTapscript, scriptFromTapLeafScript, CLTVMultisigTapscript, ArkAddress, getSequence, CSVMultisigTapscript, isRecoverable, MultisigTapscript, isSpendable, isExpired, isSubdust, DEFAULT_NETWORK_NAME, DEFAULT_ARKADE_SERVER_URL } from './chunk-HW3JJ323.js';
-import { TEST_NETWORK, sha256, hash160, sha256x2, concatBytes, randomPrivateKeyBytes, pubECDSA, pubSchnorr, NETWORK, equalBytes as equalBytes$1 } from '@scure/btc-signer/utils.js';
+import { craftToSpendTx, Transaction, OP_RETURN_EMPTY_PKSCRIPT, Intent, getArkPsbtFields, CosignerPublicKey, setArkPsbtField, VtxoTaprootTree, maybeArkError, AssetRef, AssetId, AssetOutput, AssetGroup, AssetInput, Packet, Metadata, isEventSourceError, RestArkProvider, RestIndexerProvider, ArkError, BufferReader } from './chunk-6NWNOLL3.js';
+import { isMainnetDescriptor, descriptorIsOurs, contractHandlers, DelegateVtxo, DefaultVtxo, WALLET_RECEIVE_SOURCE, deriveDescriptorLeafPubKey } from './chunk-YA4G7RFB.js';
+import { VtxoScript, timelockToSequence, DEFAULT_NETWORK, DEFAULT_NETWORK_NAME, decodeTapscript, scriptFromTapLeafScript, CLTVMultisigTapscript, ArkAddress, getSequence, CSVMultisigTapscript, getNetwork, MultisigTapscript, networks as networks$1, DEFAULT_ARKADE_SERVER_URL } from './chunk-TU3LVAPX.js';
+import { sha256, hash160, sha256x2, concatBytes, randomPrivateKeyBytes, pubECDSA, pubSchnorr, equalBytes as equalBytes$1 } from '@scure/btc-signer/utils.js';
 import { SigHash, Script, p2tr, RawWitness, Address, OutScript, p2wpkh, TaprootControlBlock, DEFAULT_SEQUENCE, Transaction as Transaction$2 } from '@scure/btc-signer';
 import { hex, base58, base64 } from '@scure/base';
 import * as musig2 from '@scure/btc-signer/musig2.js';
@@ -938,12 +938,12 @@ async function getActiveServiceWorker(path) {
   return serviceWorker;
 }
 
-// src/providers/delegator.ts
-var RestDelegatorProvider = class {
+// src/providers/delegate.ts
+var RestDelegateProvider = class {
   /**
-   * 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) {
     this.url = url;
@@ -994,35 +994,13 @@ var RestDelegatorProvider = class {
     if (!isDelegateInfo(data)) {
       throw new Error("Invalid delegate info");
     }
-    return data;
+    const delegateAddress = typeof data.delegateAddress === "string" && data.delegateAddress !== "" ? data.delegateAddress : typeof data.delegatorAddress === "string" && data.delegatorAddress !== "" ? data.delegatorAddress : "";
+    return { ...data, delegateAddress };
   }
 };
+var RestDelegatorProvider = RestDelegateProvider;
 function isDelegateInfo(data) {
-  return !!data && typeof data === "object" && "pubkey" in data && "fee" in data && "delegatorAddress" in data && typeof data.pubkey === "string" && typeof data.fee === "string" && typeof data.delegatorAddress === "string" && data.pubkey !== "" && data.fee !== "" && data.delegatorAddress !== "";
-}
-var getNetwork = (network) => {
-  return networks2[network];
-};
-var networks2 = {
-  bitcoin: withArkPrefix(NETWORK, "ark"),
-  testnet: withArkPrefix(TEST_NETWORK, "tark"),
-  signet: withArkPrefix(TEST_NETWORK, "tark"),
-  mutinynet: withArkPrefix(TEST_NETWORK, "tark"),
-  regtest: withArkPrefix(
-    {
-      ...TEST_NETWORK,
-      bech32: "bcrt",
-      pubKeyHash: 111,
-      scriptHash: 196
-    },
-    "tark"
-  )
-};
-function withArkPrefix(network, prefix) {
-  return {
-    ...network,
-    hrp: prefix
-  };
+  return !!data && typeof data === "object" && "pubkey" in data && "fee" in data && typeof data.pubkey === "string" && typeof data.fee === "string" && data.pubkey !== "" && data.fee !== "" && (typeof data.delegateAddress === "string" && data.delegateAddress !== "" || typeof data.delegatorAddress === "string" && data.delegatorAddress !== "");
 }
 
 // src/providers/onchain.ts
@@ -1034,7 +1012,7 @@ var ESPLORA_URL = {
   regtest: "http://localhost:3000"
 };
 var EsploraProvider = class {
-  constructor(baseUrl, opts) {
+  constructor(baseUrl = ESPLORA_URL[DEFAULT_NETWORK_NAME], opts) {
     this.baseUrl = baseUrl;
     this.pollingInterval = opts?.pollingInterval ?? 15e3;
     this.forcePolling = opts?.forcePolling ?? false;
@@ -1695,6 +1673,30 @@ function validateAssetGroupOutput(packet, outputIndex, assetId, expectedAmount)
   }
 }
 
+// src/wallet/index.ts
+var TxType = /* @__PURE__ */ ((TxType2) => {
+  TxType2["TxSent"] = "SENT";
+  TxType2["TxReceived"] = "RECEIVED";
+  return TxType2;
+})(TxType || {});
+function isSpendable(vtxo) {
+  return !vtxo.isSpent;
+}
+function isRecoverable(vtxo) {
+  return vtxo.virtualStatus.state === "swept" && isSpendable(vtxo);
+}
+function isExpired(vtxo) {
+  if (vtxo.virtualStatus.state === "swept") return true;
+  const expiry = vtxo.virtualStatus.batchExpiry;
+  if (!expiry) return false;
+  const expireAt = new Date(expiry);
+  if (expireAt.getFullYear() < 2025) return false;
+  return expiry <= Date.now();
+}
+function isSubdust(vtxo, dust) {
+  return vtxo.value < dust;
+}
+
 // src/wallet/asset.ts
 function createAssetPacket(assetInputs, receivers, changeReceiver) {
   const inputsByAssetId = /* @__PURE__ */ new Map();
@@ -2241,6 +2243,77 @@ function parseProgram(text, env) {
   }
   return { program, text };
 }
+var DUST_AMOUNT = 546;
+var FALLBACK_WALLET_DUST_AMOUNT = 330n;
+function getDustAmount(wallet) {
+  return "dustAmount" in wallet ? wallet.dustAmount : FALLBACK_WALLET_DUST_AMOUNT;
+}
+function extendCoin(wallet, utxo) {
+  return {
+    ...utxo,
+    forfeitTapLeafScript: wallet.boardingTapscript.forfeit(),
+    intentTapLeafScript: wallet.boardingTapscript.forfeit(),
+    tapTree: wallet.boardingTapscript.encode()
+  };
+}
+function extendVtxoFromContract(vtxo, contract) {
+  const handler = contractHandlers.get(contract.type);
+  if (!handler) {
+    throw new Error(`No handler for contract type '${contract.type}'`);
+  }
+  const script = handler.createScript(contract.params);
+  return {
+    ...vtxo,
+    forfeitTapLeafScript: script.forfeit(),
+    intentTapLeafScript: script.forfeit(),
+    tapTree: script.encode()
+  };
+}
+function extendVirtualCoinForContract(vtxo, contractOrMap) {
+  const contract = resolveContract(vtxo, contractOrMap);
+  if (!contract) {
+    throw new Error(
+      "extendVirtualCoinForContract: no contract matched vtxo.script \u2014 callers must resolve the owning contract before annotating"
+    );
+  }
+  return extendVtxoFromContract(vtxo, contract);
+}
+function isContractMap(value) {
+  return typeof value.get === "function";
+}
+function resolveContract(vtxo, contractOrMap) {
+  if (!contractOrMap) return void 0;
+  if (isContractMap(contractOrMap)) {
+    return contractOrMap.get(vtxo.script);
+  }
+  return contractOrMap;
+}
+function getRandomId() {
+  const randomValue = crypto.getRandomValues(new Uint8Array(16));
+  return hex.encode(randomValue);
+}
+function validateRecipients(recipients, dustAmount) {
+  const validatedRecipients = [];
+  for (const recipient of recipients) {
+    let address;
+    try {
+      address = ArkAddress.decode(recipient.address);
+    } catch (e) {
+      throw new Error(`Invalid Arkade address: ${recipient.address}`);
+    }
+    const amount = recipient.amount || dustAmount;
+    if (amount <= 0) {
+      throw new Error("Amount must be positive");
+    }
+    validatedRecipients.push({
+      address: recipient.address,
+      assets: recipient.assets ?? [],
+      amount,
+      script: amount < dustAmount ? address.subdustPkScript : address.pkScript
+    });
+  }
+  return validatedRecipients;
+}
 
 // src/wallet/vtxo-manager.ts
 function isSweepCapable(wallet) {
@@ -2265,7 +2338,7 @@ async function runWithCrossInstanceLock(name, fn) {
     await fn();
   });
 }
-var DEFAULT_THRESHOLD_SECONDS = 3 * 24 * 60 * 60;
+var DEFAULT_THRESHOLD_SECONDS = 259200;
 var DEFAULT_THRESHOLD_MS = DEFAULT_THRESHOLD_SECONDS * 1e3;
 var DEFAULT_RENEWAL_CONFIG = {
   thresholdMs: DEFAULT_THRESHOLD_MS
@@ -2276,9 +2349,6 @@ var DEFAULT_SETTLEMENT_CONFIG = {
   boardingUtxoSweep: true,
   pollIntervalMs: 6e4
 };
-function getDustAmount(wallet) {
-  return "dustAmount" in wallet ? wallet.dustAmount : 330n;
-}
 function getRecoverableVtxos(vtxos, dustAmount) {
   return vtxos.filter((vtxo) => {
     if (isRecoverable(vtxo)) {
@@ -2494,7 +2564,7 @@ var VtxoManager = class _VtxoManager {
    * ```typescript
    * const wallet = await Wallet.create({
    *  identity,
-   *  arkServerUrl: 'https://arkade.computer',
+   *  arkProvider: new RestArkProvider(),
    *  settlementConfig: {
    *      vtxoThreshold: 86_400 // 24 hours
    *  },
@@ -2638,7 +2708,7 @@ var VtxoManager = class _VtxoManager {
    * ```typescript
    * const wallet = await Wallet.create({
    *   identity,
-   *   arkServerUrl: 'https://arkade.computer',
+   *   arkProvider: new RestArkProvider(),
    *   settlementConfig: {
    *     boardingUtxoSweep: true,
    *   },
@@ -2757,8 +2827,8 @@ var VtxoManager = class _VtxoManager {
       this.startBoardingUtxoPoll();
     }, 1e3);
     try {
-      const [delegatorManager, contractManager, destination] = await Promise.all([
-        this.wallet.getDelegatorManager(),
+      const [delegateManager, contractManager, destination] = await Promise.all([
+        this.wallet.getDelegateManager(),
         this.wallet.getContractManager(),
         this.wallet.getAddress()
       ]);
@@ -2788,8 +2858,8 @@ var VtxoManager = class _VtxoManager {
             console.error("Error renewing VTXOs:", e);
           });
         }
-        if (delegatorManager) {
-          delegatorManager.delegate(event.vtxos, destination).catch((e) => {
+        if (delegateManager) {
+          delegateManager.delegate(event.vtxos, destination).catch((e) => {
             console.error("Error delegating VTXOs:", e);
           });
         }
@@ -3230,73 +3300,6 @@ function readUInt32BE(array, offset) {
 function noteTapscript(preimageHash) {
   return Script.encode(["SHA256", preimageHash, "EQUAL"]);
 }
-var DUST_AMOUNT = 546;
-function extendCoin(wallet, utxo) {
-  return {
-    ...utxo,
-    forfeitTapLeafScript: wallet.boardingTapscript.forfeit(),
-    intentTapLeafScript: wallet.boardingTapscript.forfeit(),
-    tapTree: wallet.boardingTapscript.encode()
-  };
-}
-function extendVtxoFromContract(vtxo, contract) {
-  const handler = contractHandlers.get(contract.type);
-  if (!handler) {
-    throw new Error(`No handler for contract type '${contract.type}'`);
-  }
-  const script = handler.createScript(contract.params);
-  return {
-    ...vtxo,
-    forfeitTapLeafScript: script.forfeit(),
-    intentTapLeafScript: script.forfeit(),
-    tapTree: script.encode()
-  };
-}
-function extendVirtualCoinForContract(vtxo, contractOrMap) {
-  const contract = resolveContract(vtxo, contractOrMap);
-  if (!contract) {
-    throw new Error(
-      "extendVirtualCoinForContract: no contract matched vtxo.script \u2014 callers must resolve the owning contract before annotating"
-    );
-  }
-  return extendVtxoFromContract(vtxo, contract);
-}
-function isContractMap(value) {
-  return typeof value.get === "function";
-}
-function resolveContract(vtxo, contractOrMap) {
-  if (!contractOrMap) return void 0;
-  if (isContractMap(contractOrMap)) {
-    return contractOrMap.get(vtxo.script);
-  }
-  return contractOrMap;
-}
-function getRandomId() {
-  const randomValue = crypto.getRandomValues(new Uint8Array(16));
-  return hex.encode(randomValue);
-}
-function validateRecipients(recipients, dustAmount) {
-  const validatedRecipients = [];
-  for (const recipient of recipients) {
-    let address;
-    try {
-      address = ArkAddress.decode(recipient.address);
-    } catch (e) {
-      throw new Error(`Invalid Arkade address: ${recipient.address}`);
-    }
-    const amount = recipient.amount || dustAmount;
-    if (amount <= 0) {
-      throw new Error("Amount must be positive");
-    }
-    validatedRecipients.push({
-      address: recipient.address,
-      assets: recipient.assets ?? [],
-      amount,
-      script: amount < dustAmount ? address.subdustPkScript : address.pkScript
-    });
-  }
-  return validatedRecipients;
-}
 var TxTree = class {
   constructor(root, children = /* @__PURE__ */ new Map()) {
     this.root = root;
@@ -4070,15 +4073,15 @@ function castMetadata(metadata) {
   }
   return md;
 }
-var DelegatorManagerImpl = class {
-  /** Create a delegator manager from the configured provider, Arkade info source, and wallet identity. */
-  constructor(delegatorProvider, arkInfoProvider, identity) {
-    this.delegatorProvider = delegatorProvider;
+var DelegateManagerImpl = class {
+  /** Create a delegate manager from the configured provider, Arkade info source, and wallet identity. */
+  constructor(delegateProvider, arkInfoProvider, identity) {
+    this.delegateProvider = delegateProvider;
     this.arkInfoProvider = arkInfoProvider;
     this.identity = identity;
   }
   async getDelegateInfo() {
-    return this.delegatorProvider.getDelegateInfo();
+    return this.delegateProvider.getDelegateInfo();
   }
   async delegate(vtxos, destination, delegateAt) {
     if (vtxos.length === 0) {
@@ -4086,7 +4089,7 @@ var DelegatorManagerImpl = class {
     }
     const destinationScript = ArkAddress.decode(destination).pkScript;
     const arkInfo = await this.arkInfoProvider.getInfo();
-    const delegateInfo = await this.delegatorProvider.getDelegateInfo();
+    const delegateInfo = await this.delegateProvider.getDelegateInfo();
     const eligible = vtxos.filter(
       (v) => isAnnotated(v) && findDelegateTapLeaf(v, delegateInfo.pubkey) !== void 0
     );
@@ -4097,7 +4100,7 @@ var DelegatorManagerImpl = class {
       try {
         await delegate(
           this.identity,
-          this.delegatorProvider,
+          this.delegateProvider,
           arkInfo,
           delegateInfo,
           eligible,
@@ -4128,7 +4131,7 @@ var DelegatorManagerImpl = class {
       try {
         await delegate(
           this.identity,
-          this.delegatorProvider,
+          this.delegateProvider,
           arkInfo,
           delegateInfo,
           recoverableVtxos,
@@ -4153,7 +4156,7 @@ var DelegatorManagerImpl = class {
       groupsList.map(
         async ([, vtxosGroup]) => delegate(
           this.identity,
-          this.delegatorProvider,
+          this.delegateProvider,
           arkInfo,
           delegateInfo,
           vtxosGroup,
@@ -4174,12 +4177,13 @@ var DelegatorManagerImpl = class {
     return { delegated, failed };
   }
 };
-async function delegate(identity, delegatorProvider, arkInfo, delegateInfo, vtxos, destinationScript, delegateAt) {
+var DelegatorManagerImpl = DelegateManagerImpl;
+async function delegate(identity, delegateProvider, arkInfo, delegateInfo, vtxos, destinationScript, delegateAt) {
   if (vtxos.length === 0) {
     throw new Error("unable to delegate: no vtxos provided");
   }
-  if (!delegatorProvider) {
-    throw new Error("unable to delegate: delegator provider not configured");
+  if (!delegateProvider) {
+    throw new Error("unable to delegate: delegate provider not configured");
   }
   if (!delegateAt) {
     const expiryTimestamp = vtxos.filter((coin) => !isRecoverable(coin) && coin.virtualStatus.batchExpiry).reduce(
@@ -4225,13 +4229,14 @@ async function delegate(identity, delegatorProvider, arkInfo, delegateInfo, vtxo
     }
     amount += BigInt(coin.value) - BigInt(inputFee.value);
   }
-  const { delegatorAddress, pubkey, fee } = delegateInfo;
+  const { pubkey, fee } = delegateInfo;
+  const delegateAddress = delegateInfo.delegateAddress;
   const outputs = [];
-  const delegatorFee = BigInt(Number(fee));
-  if (delegatorFee > 0n) {
+  const delegateFee = BigInt(Number(fee));
+  if (delegateFee > 0n) {
     outputs.push({
-      script: ArkAddress.decode(delegatorAddress).pkScript,
-      amount: delegatorFee
+      script: ArkAddress.decode(delegateAddress).pkScript,
+      amount: delegateFee
     });
   }
   const outputFee = outputs.reduce((fee2, output) => {
@@ -4245,7 +4250,7 @@ async function delegate(identity, delegatorProvider, arkInfo, delegateInfo, vtxo
     throw new Error("Amount is below dust limit, cannot delegate");
   }
   amount -= BigInt(outputFee);
-  amount -= delegatorFee;
+  amount -= delegateFee;
   if (amount <= dust) {
     throw new Error("Amount is below dust limit, cannot delegate");
   }
@@ -4277,7 +4282,7 @@ async function delegate(identity, delegatorProvider, arkInfo, delegateInfo, vtxo
       return base64.encode(forfeit.toPSBT());
     })
   );
-  await delegatorProvider.delegate(registerIntent, forfeits);
+  await delegateProvider.delegate(registerIntent, forfeits);
 }
 async function makeDelegateForfeitTx(input, connectorAmount, delegatePubkey, forfeitOutputScript, identity) {
   const delegateTapLeaf = findDelegateTapLeaf(input, delegatePubkey);
@@ -7722,7 +7727,7 @@ function hasToReadonly(identity) {
   return typeof identity === "object" && identity !== null && "toReadonly" in identity && typeof identity.toReadonly === "function";
 }
 var ReadonlyWallet = class _ReadonlyWallet {
-  constructor(identity, network, onchainProvider, indexerProvider, arkServerPublicKey, offchainTapscript, boardingTapscript, dustAmount, walletRepository, contractRepository, delegatorProvider, watcherConfig, walletContractTimelocks) {
+  constructor(identity, network, onchainProvider, indexerProvider, arkServerPublicKey, offchainTapscript, boardingTapscript, dustAmount, walletRepository, contractRepository, delegateProvider, watcherConfig, walletContractTimelocks) {
     this.identity = identity;
     this.network = network;
     this.onchainProvider = onchainProvider;
@@ -7732,7 +7737,7 @@ var ReadonlyWallet = class _ReadonlyWallet {
     this.dustAmount = dustAmount;
     this.walletRepository = walletRepository;
     this.contractRepository = contractRepository;
-    this.delegatorProvider = delegatorProvider;
+    this.delegateProvider = delegateProvider;
     if ("descriptor" in identity) {
       const descriptor = identity.descriptor;
       const identityIsMainnet = !descriptor.includes("tpub");
@@ -7786,7 +7791,7 @@ var ReadonlyWallet = class _ReadonlyWallet {
    */
   static async setupWalletConfig(config, pubKey) {
     const arkadeServerUrl = getArkadeServerUrl(config);
-    const arkProvider = config.arkProvider ?? new RestArkProvider(arkadeServerUrl);
+    const arkProvider = config.arkProvider || new RestArkProvider(arkadeServerUrl);
     let indexerProvider = config.indexerProvider;
     if (!indexerProvider) {
       let indexerUrl = config.indexerUrl;
@@ -7847,7 +7852,7 @@ var ReadonlyWallet = class _ReadonlyWallet {
       type: info.boardingExitDelay < 512n ? "blocks" : "seconds"
     };
     const serverPubKey = hex.decode(info.signerPubkey).slice(1);
-    const delegatePubKey = config.delegatorProvider ? await config.delegatorProvider.getDelegateInfo().then((info2) => hex.decode(info2.pubkey).slice(1)) : void 0;
+    const delegatePubKey = config.delegateProvider ? await config.delegateProvider.getDelegateInfo().then((info2) => hex.decode(info2.pubkey).slice(1)) : config.delegatorProvider ? await config.delegatorProvider.getDelegateInfo().then((info2) => hex.decode(info2.pubkey).slice(1)) : void 0;
     const offchainOptions = {
       pubKey,
       serverPubKey,
@@ -7873,7 +7878,9 @@ var ReadonlyWallet = class _ReadonlyWallet {
       walletRepository,
       contractRepository,
       info,
-      delegatorProvider: config.delegatorProvider,
+      delegateProvider: config.delegateProvider || config.delegatorProvider,
+      /** @deprecated alias for `delegateProvider` */
+      delegatorProvider: config.delegateProvider || config.delegatorProvider,
       walletContractTimelocks
     };
   }
@@ -7900,7 +7907,7 @@ var ReadonlyWallet = class _ReadonlyWallet {
       setup.dustAmount,
       setup.walletRepository,
       setup.contractRepository,
-      setup.delegatorProvider,
+      setup.delegateProvider || setup.delegatorProvider,
       config.watcherConfig,
       setup.walletContractTimelocks
     );
@@ -8315,7 +8322,7 @@ var ReadonlyWallet = class _ReadonlyWallet {
   }
 };
 var Wallet2 = class _Wallet extends ReadonlyWallet {
-  constructor(identity, network, onchainProvider, arkProvider, indexerProvider, arkServerPublicKey, offchainTapscript, boardingTapscript, serverUnrollScript, forfeitOutputScript, forfeitPubkey, dustAmount, walletRepository, contractRepository, renewalConfig, delegatorProvider, watcherConfig, settlementConfig, walletContractTimelocks, receiveRotator, descriptorProvider) {
+  constructor(identity, network, onchainProvider, arkProvider, indexerProvider, arkServerPublicKey, offchainTapscript, boardingTapscript, serverUnrollScript, forfeitOutputScript, forfeitPubkey, dustAmount, walletRepository, contractRepository, renewalConfig, delegateProvider, watcherConfig, settlementConfig, walletContractTimelocks, receiveRotator, descriptorProvider) {
     super(
       identity,
       network,
@@ -8327,7 +8334,7 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
       dustAmount,
       walletRepository,
       contractRepository,
-      delegatorProvider,
+      delegateProvider,
       watcherConfig,
       walletContractTimelocks
     );
@@ -8352,7 +8359,7 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
     } else {
       this.settlementConfig = { ...DEFAULT_SETTLEMENT_CONFIG };
     }
-    this._delegatorManager = delegatorProvider ? new DelegatorManagerImpl(delegatorProvider, arkProvider, identity) : void 0;
+    this._delegateManager = delegateProvider ? new DelegateManagerImpl(delegateProvider, arkProvider, identity) : void 0;
     this._receiveRotator = receiveRotator;
     this._descriptorProvider = descriptorProvider;
     this._signerRouter = new InputSignerRouter({
@@ -8365,7 +8372,7 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
   static MIN_FEE_RATE = 1;
   // sats/vbyte
   identity;
-  _delegatorManager;
+  _delegateManager;
   _vtxoManager;
   _vtxoManagerInitializing;
   _walletAssetManager;
@@ -8574,7 +8581,7 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
    * ```typescript
    * const wallet = await Wallet.create({
    *   identity,
-   *   arkServerUrl: 'https://arkade.computer',
+   *   arkProvider: new RestArkProvider(),
    * });
    * ```
    */
@@ -8611,7 +8618,7 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
       setup.walletRepository,
       setup.contractRepository,
       config.renewalConfig,
-      config.delegatorProvider,
+      config.delegateProvider || config.delegatorProvider,
       config.watcherConfig,
       config.settlementConfig,
       setup.walletContractTimelocks,
@@ -8651,14 +8658,18 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
       this.dustAmount,
       this.walletRepository,
       this.contractRepository,
-      this.delegatorProvider,
+      this.delegateProvider,
       this.watcherConfig,
       this.walletContractTimelocks
     );
   }
-  /** Returns the delegator manager when delegation support is configured. */
+  /** Returns the delegate manager when delegation support is configured. */
+  async getDelegateManager() {
+    return this._delegateManager;
+  }
+  /** @deprecated alias for @see Wallet.getDelegateManager */
   async getDelegatorManager() {
-    return this._delegatorManager;
+    return this.getDelegateManager();
   }
   /**
    * Send bitcoin to an Arkade address.
@@ -9914,7 +9925,7 @@ var MessageBus = class {
       walletRepository: this.walletRepository,
       contractRepository: this.contractRepository
     };
-    const delegatorProvider = config.delegatorUrl ? new RestDelegatorProvider(config.delegatorUrl) : void 0;
+    const delegateProvider = config.delegateUrl ? new RestDelegateProvider(config.delegateUrl) : config.delegatorUrl ? new RestDelegateProvider(config.delegatorUrl) : void 0;
     const serialized = normalizeSerializedIdentity(config.wallet);
     if (isSigningSerialized(serialized)) {
       const identity2 = hydrateIdentity(serialized);
@@ -9925,7 +9936,7 @@ var MessageBus = class {
         indexerUrl: config.indexerUrl,
         esploraUrl: config.esploraUrl,
         storage,
-        delegatorProvider,
+        delegateProvider,
         settlementConfig: config.settlementConfig,
         walletMode: config.walletMode,
         watcherConfig: config.watcherConfig
@@ -9940,7 +9951,7 @@ var MessageBus = class {
       indexerUrl: config.indexerUrl,
       esploraUrl: config.esploraUrl,
       storage,
-      delegatorProvider,
+      delegateProvider,
       watcherConfig: config.watcherConfig
     });
     return { readonlyWallet, arkProvider };
@@ -10219,6 +10230,18 @@ var MessageBus = class {
 function toError(value) {
   return value instanceof Error ? value : new Error(String(value));
 }
+var DustChangeError = class extends Error {
+  change;
+  dustAmount;
+  constructor(change, dustAmount) {
+    super(
+      `change ${change} sats is below dust threshold ${dustAmount}; consider exiting the full balance`
+    );
+    this.name = "DustChangeError";
+    this.change = change;
+    this.dustAmount = dustAmount;
+  }
+};
 var Ramps = class {
   /**
    * Create convenience wrappers for onboarding and offboarding flows.
@@ -10356,6 +10379,10 @@ var Ramps = class {
       }
       change = totalAmount - amount;
     }
+    const dustAmount = getDustAmount(this.wallet);
+    if (change > 0n && change < dustAmount) {
+      throw new DustChangeError(change, dustAmount);
+    }
     amount = amount ?? totalAmount;
     const networkNames = [
       "bitcoin",
@@ -10367,7 +10394,7 @@ var Ramps = class {
     let destinationScript;
     for (const networkName of networkNames) {
       try {
-        const network = networks2[networkName];
+        const network = networks$1[networkName];
         const addr = Address(network).decode(destinationAddress);
         destinationScript = OutScript.encode(addr);
         break;
@@ -10418,18 +10445,47 @@ var WalletNotInitializedError = class extends Error {
     this.name = "WalletNotInitializedError";
   }
 };
+function isSerializedAggregateError(value) {
+  if (!value || typeof value !== "object") return false;
+  const v = value;
+  return v.name === "AggregateError" && typeof v.message === "string" && Array.isArray(v.errors) && v.errors.every((e) => e && typeof e.name === "string" && typeof e.message === "string");
+}
+function serializeAggregateError(error) {
+  const errors = [];
+  for (const child of error.errors ?? []) {
+    if (child instanceof Error) {
+      errors.push({ name: child.name, message: child.message });
+    } else {
+      errors.push({ name: "Error", message: String(child) });
+    }
+  }
+  return {
+    name: "AggregateError",
+    message: error.message,
+    errors
+  };
+}
+function deserializeAggregateError(payload) {
+  const errs = payload.errors.map((e) => {
+    const err = new Error(e.message);
+    err.name = e.name;
+    return err;
+  });
+  return new AggregateError(errs, payload.message);
+}
 var ReadonlyWalletError = class extends Error {
   constructor() {
     super("Read-only wallet: operation requires signing");
     this.name = "ReadonlyWalletError";
   }
 };
-var DelegatorNotConfiguredError = class extends Error {
+var DelegateNotConfiguredError = class extends Error {
   constructor() {
-    super("Delegator not configured");
-    this.name = "DelegatorNotConfiguredError";
+    super("Delegate not configured");
+    this.name = "DelegateNotConfiguredError";
   }
 };
+var DelegatorNotConfiguredError = DelegateNotConfiguredError;
 var DEFAULT_MESSAGE_TAG = "WALLET_UPDATER";
 var WalletMessageHandler = class {
   messageTag;
@@ -10512,7 +10568,10 @@ var WalletMessageHandler = class {
   // page-side PING / MESSAGE_BUS_NOT_INITIALIZED path triggered by concurrent
   // short requests (GET_STATUS, GET_BALANCE, ...).
   isLongRunning(message) {
-    return message.type === "SETTLE" || message.type === "RECOVER_VTXOS" || message.type === "RENEW_VTXOS";
+    return message.type === "SETTLE" || message.type === "RECOVER_VTXOS" || message.type === "RENEW_VTXOS" || // HD restore walks the index range with one indexer round-trip per
+    // step until it hits gapLimit consecutive unused indices. The bus
+    // deadline must not race the scan; liveness stays covered by PING.
+    message.type === "RESTORE_WALLET";
   }
   async handleMessage(message) {
     const id = message.id;
@@ -10781,11 +10840,11 @@ var WalletMessageHandler = class {
         }
         case "GET_DELEGATE_INFO": {
           const wallet = this.requireWallet();
-          const delegatorManager = await wallet.getDelegatorManager();
-          if (!delegatorManager) {
-            throw new DelegatorNotConfiguredError();
+          const delegateManager = await wallet.getDelegateManager();
+          if (!delegateManager) {
+            throw new DelegateNotConfiguredError();
           }
-          const info = await delegatorManager.getDelegateInfo();
+          const info = await delegateManager.getDelegateInfo();
           return this.tagged({
             id,
             type: "DELEGATE_INFO",
@@ -10875,6 +10934,24 @@ var WalletMessageHandler = class {
             payload: { txid }
           });
         }
+        case "RESTORE_WALLET": {
+          const wallet = this.requireWallet();
+          try {
+            await wallet.restore(message.payload);
+          } catch (error) {
+            if (error instanceof AggregateError) {
+              return this.tagged({
+                id,
+                error: serializeAggregateError(error)
+              });
+            }
+            throw error;
+          }
+          return this.tagged({
+            id,
+            type: "RESTORE_WALLET_SUCCESS"
+          });
+        }
         default:
           console.error("Unknown message type", message);
           throw new Error("Unknown message");
@@ -11129,15 +11206,15 @@ var WalletMessageHandler = class {
   }
   async handleDelegate(message) {
     const wallet = this.requireWallet();
-    const delegatorManager = await wallet.getDelegatorManager();
-    if (!delegatorManager) {
-      throw new DelegatorNotConfiguredError();
+    const delegateManager = await wallet.getDelegateManager();
+    if (!delegateManager) {
+      throw new DelegateNotConfiguredError();
     }
     const { vtxoOutpoints, destination, delegateAt } = message.payload;
     const allVtxos = await wallet.getVtxos();
     const outpointSet = new Set(vtxoOutpoints.map((o) => `${o.txid}:${o.vout}`));
     const filtered = allVtxos.filter((v) => outpointSet.has(`${v.txid}:${v.vout}`)).map((v) => ({ ...v, contractScript: v.script }));
-    const result = await delegatorManager.delegate(
+    const result = await delegateManager.delegate(
       filtered,
       destination,
       delegateAt !== void 0 ? new Date(delegateAt) : void 0
@@ -11344,6 +11421,10 @@ var DEFAULT_MESSAGE_TIMEOUTS = {
   RECOVER_VTXOS: 5e4,
   RENEW_VTXOS: 5e4,
   SWEEP_EXPIRED_BOARDING_UTXOS: 5e4,
+  // RESTORE_WALLET is a streaming/long-running path (sendMessageWithEvents)
+  // like SETTLE; the value here is kept for type completeness and is never
+  // enforced as an inactivity deadline.
+  RESTORE_WALLET: 5e4,
   // Misc writes
   INIT_WALLET: 3e4,
   CLEAR: 1e4,
@@ -11485,6 +11566,8 @@ var ServiceWorkerReadonlyWallet = class _ServiceWorkerReadonlyWallet {
   // these immediately after construction.
   arkServerUrl;
   arkServerPublicKey;
+  delegateUrl;
+  /** @deprecated alias for @see ServiceWorkerReadonlyWallet.delegateUrl */
   delegatorUrl;
   indexerUrl;
   esploraUrl;
@@ -11523,7 +11606,11 @@ var ServiceWorkerReadonlyWallet = class _ServiceWorkerReadonlyWallet {
       key: { publicKey },
       arkServerUrl: getArkadeServerUrl(options),
       arkServerPublicKey: options.arkServerPublicKey,
-      delegatorUrl: options.delegatorUrl
+      delegateUrl: options.delegateUrl || options.delegatorUrl,
+      // Keep the deprecated field populated so pre-#519 service workers
+      // (which only read delegatorUrl) keep delegating until they activate
+      // a newer version.
+      delegatorUrl: options.delegateUrl || options.delegatorUrl
     };
     const messageTimeouts = options.messageTimeouts ? {
       ...DEFAULT_MESSAGE_TIMEOUTS,
@@ -11535,7 +11622,11 @@ var ServiceWorkerReadonlyWallet = class _ServiceWorkerReadonlyWallet {
         url: getArkadeServerUrl(options),
         publicKey: options.arkServerPublicKey
       },
-      delegatorUrl: options.delegatorUrl,
+      delegateUrl: options.delegateUrl || options.delegatorUrl,
+      // Keep the deprecated field populated so pre-#519 service workers
+      // (which only read delegatorUrl) keep delegating until they activate
+      // a newer version.
+      delegatorUrl: options.delegateUrl || options.delegatorUrl,
       indexerUrl: options.indexerUrl,
       esploraUrl: options.esploraUrl,
       watcherConfig: options.watcherConfig,
@@ -11757,7 +11848,11 @@ var ServiceWorkerReadonlyWallet = class _ServiceWorkerReadonlyWallet {
         url: this.arkServerUrl,
         publicKey: this.arkServerPublicKey
       },
-      delegatorUrl: this.delegatorUrl,
+      delegateUrl: this.delegateUrl || this.delegatorUrl,
+      // Keep the deprecated field populated so pre-#519 service workers
+      // (which only read delegatorUrl) keep delegating until they activate
+      // a newer version.
+      delegatorUrl: this.delegateUrl || this.delegatorUrl,
       indexerUrl: this.indexerUrl,
       esploraUrl: this.esploraUrl,
       watcherConfig: this.watcherConfig,
@@ -12126,7 +12221,7 @@ var ServiceWorkerReadonlyWallet = class _ServiceWorkerReadonlyWallet {
   }
 };
 var ServiceWorkerWallet = class _ServiceWorkerWallet extends ServiceWorkerReadonlyWallet {
-  constructor(serviceWorker, identity, walletRepository, contractRepository, messageTag, hasDelegator) {
+  constructor(serviceWorker, identity, walletRepository, contractRepository, messageTag, hasDelegate) {
     super(serviceWorker, identity, walletRepository, contractRepository, messageTag);
     this.serviceWorker = serviceWorker;
     this.identity = identity;
@@ -12136,13 +12231,13 @@ var ServiceWorkerWallet = class _ServiceWorkerWallet extends ServiceWorkerReadon
       (msg) => this.sendMessage(msg),
       messageTag
     );
-    this.hasDelegator = hasDelegator;
+    this.hasDelegate = hasDelegate;
   }
   walletRepository;
   contractRepository;
   identity;
   _assetManager;
-  hasDelegator;
+  hasDelegate;
   get assetManager() {
     return this._assetManager;
   }
@@ -12166,14 +12261,18 @@ var ServiceWorkerWallet = class _ServiceWorkerWallet extends ServiceWorkerReadon
       walletRepository,
       contractRepository,
       messageTag,
-      !!options.delegatorUrl
+      !!(options.delegateUrl || options.delegatorUrl)
     );
     const legacyPrivateKey = serializedWallet.type === "single-key" ? serializedWallet.privateKey : null;
     const initWalletPayload = {
       key: legacyPrivateKey ? { privateKey: legacyPrivateKey } : {},
       arkServerUrl: getArkadeServerUrl(options),
       arkServerPublicKey: options.arkServerPublicKey,
-      delegatorUrl: options.delegatorUrl
+      delegateUrl: options.delegateUrl || options.delegatorUrl,
+      // Keep the deprecated field populated so pre-#519 service workers
+      // (which only read delegatorUrl) keep delegating until they activate
+      // a newer version.
+      delegatorUrl: options.delegateUrl || options.delegatorUrl
     };
     const messageTimeouts = options.messageTimeouts ? {
       ...DEFAULT_MESSAGE_TIMEOUTS,
@@ -12185,7 +12284,11 @@ var ServiceWorkerWallet = class _ServiceWorkerWallet extends ServiceWorkerReadon
         url: getArkadeServerUrl(options),
         publicKey: options.arkServerPublicKey
       },
-      delegatorUrl: options.delegatorUrl,
+      delegateUrl: options.delegateUrl || options.delegatorUrl,
+      // Keep the deprecated field populated so pre-#519 service workers
+      // (which only read delegatorUrl) keep delegating until they activate
+      // a newer version.
+      delegatorUrl: options.delegateUrl || options.delegatorUrl,
       indexerUrl: options.indexerUrl,
       esploraUrl: options.esploraUrl,
       settlementConfig: options.settlementConfig,
@@ -12266,6 +12369,38 @@ var ServiceWorkerWallet = class _ServiceWorkerWallet extends ServiceWorkerReadon
       throw new Error(`Settlement failed: ${error}`);
     }
   }
+  /**
+   * Explicitly recover this wallet's contracts and balance on a fresh repo.
+   * Mirrors {@link Wallet.restore} but drives the scan inside the service
+   * worker — the materialize() callback used by `scanContracts` cannot
+   * cross the postMessage boundary, so the entire flow runs worker-side
+   * and only the gapLimit / outcome cross the wire.
+   *
+   * Uses the streaming send path so the bus deadline does not race a
+   * long indexer-bound scan. AggregateError thrown by the worker is
+   * reconstructed here so callers can inspect `.errors`.
+   */
+  async restore(opts) {
+    const message = {
+      id: getRandomId(),
+      tag: this.messageTag,
+      type: "RESTORE_WALLET",
+      payload: opts ?? {}
+    };
+    try {
+      await this.sendMessageWithEvents(
+        message,
+        () => {
+        },
+        (resp) => resp.type === "RESTORE_WALLET_SUCCESS"
+      );
+    } catch (error) {
+      if (isSerializedAggregateError(error)) {
+        throw deserializeAggregateError(error);
+      }
+      throw error;
+    }
+  }
   async send(...recipients) {
     const message = {
       tag: this.messageTag,
@@ -12280,8 +12415,8 @@ var ServiceWorkerWallet = class _ServiceWorkerWallet extends ServiceWorkerReadon
       throw new Error(`Send failed: ${error}`);
     }
   }
-  async getDelegatorManager() {
-    if (!this.hasDelegator) {
+  async getDelegateManager() {
+    if (!this.hasDelegate) {
       return void 0;
     }
     const wallet = this;
@@ -12331,6 +12466,10 @@ var ServiceWorkerWallet = class _ServiceWorkerWallet extends ServiceWorkerReadon
     };
     return manager;
   }
+  /** @deprecated alias for @see ServiceWorkerWallet.getDelegateManager */
+  async getDelegatorManager() {
+    return await this.getDelegateManager();
+  }
   async getVtxoManager() {
     const wallet = this;
     const messageTag = this.messageTag;
@@ -12454,7 +12593,6 @@ var OnchainWallet = class _OnchainWallet {
    * @param networkName - Bitcoin network name, @see NetworkName
    * @param provider - Optional onchain provider override, @see OnchainProvider
    * @returns Configured onchain wallet
-   * @defaultValue `provider = new EsploraProvider('https://mempool.space/api')`
    * @throws Error if the configured identity cannot produce a valid x-only public key
    */
   static async create(identity, networkName = DEFAULT_NETWORK_NAME, provider) {
@@ -13780,7 +13918,7 @@ function contractFromArkContract(encoded, options = {}) {
     metadata: options.metadata
   };
 }
-function contractFromArkContractWithAddress(encoded, serverPubKey, addressPrefix = DEFAULT_ARKADE_HRP, options = {}) {
+function contractFromArkContractWithAddress(encoded, serverPubKey, addressPrefix = DEFAULT_NETWORK.hrp, options = {}) {
   const parsed = decodeArkContract(encoded);
   const handler = contractHandlers.getOrThrow(parsed.type);
   const params = parsed.data;
@@ -13800,6 +13938,6 @@ function isArkContract(str) {
   return str.startsWith(ARKCONTRACT_PREFIX + "=");
 }
 
-export { ArkNote, BIP322, Batch, ContractManager, ContractRepositoryImpl, ContractWatcher, DB_VERSION, DEFAULT_MESSAGE_TIMEOUTS, DelegatorManagerImpl, DelegatorNotConfiguredError, DescriptorSigningProviderMissingError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, ESPLORA_URL, ElectrumOnchainProvider, EsploraProvider, Estimator, HDDescriptorProvider, InMemoryContractRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBWalletRepository, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusNotInitializedError, MissingSigningDescriptorError, MnemonicIdentity, OnchainWallet, P2A, Ramps, ReadonlyDescriptorIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, RestDelegatorProvider, SeedIdentity, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, SingleKey, TxTree, TxWeightEstimator, Unroll, VtxoManager, Wallet2 as Wallet, WalletMessageHandler, WalletNotInitializedError, WalletRepositoryImpl, WsElectrumChainSource, buildForfeitTx, buildOffchainTx, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, decodeArkContract, deserializeAssets, deserializeUtxo, deserializeVtxo, encodeArkContract, extendVirtualCoinForContract, getMigrationStatus, getRandomId, hasBoardingTxExpired, isArkContract, isBatchSignable, isDiscoverable, isValidArkAddress, isVtxoExpiringSoon, isVtxoForScript, migrateWalletRepository, networks2 as networks, openDatabase, requiresMigration, rollbackMigration, saveVtxosForContract, scriptFromArkAddress, serializeAssets, serializeUtxo, serializeVtxo, setupServiceWorker, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, waitForIncomingFunds, warnAndFilterVtxosForScript };
-//# sourceMappingURL=chunk-BQLHADL7.js.map
-//# sourceMappingURL=chunk-BQLHADL7.js.map
+export { ArkNote, AssetManager, BIP322, Batch, ContractManager, ContractRepositoryImpl, ContractWatcher, DB_VERSION, DEFAULT_MESSAGE_TIMEOUTS, DelegateManagerImpl, DelegateNotConfiguredError, DelegatorManagerImpl, DelegatorNotConfiguredError, DescriptorSigningProviderMissingError, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, ESPLORA_URL, ElectrumOnchainProvider, EsploraProvider, Estimator, HDDescriptorProvider, InMemoryContractRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBWalletRepository, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusNotInitializedError, MissingSigningDescriptorError, MnemonicIdentity, OnchainWallet, P2A, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, RestDelegateProvider, RestDelegatorProvider, SeedIdentity, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, SingleKey, TxTree, TxType, TxWeightEstimator, Unroll, VtxoManager, Wallet2 as Wallet, WalletMessageHandler, WalletNotInitializedError, WalletRepositoryImpl, WsElectrumChainSource, buildForfeitTx, buildOffchainTx, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, decodeArkContract, deserializeAssets, deserializeUtxo, deserializeVtxo, encodeArkContract, extendVirtualCoinForContract, getMigrationStatus, getRandomId, hasBoardingTxExpired, isArkContract, isBatchSignable, isDiscoverable, isExpired, isRecoverable, isSpendable, isSubdust, isValidArkAddress, isVtxoExpiringSoon, isVtxoForScript, migrateWalletRepository, openDatabase, requiresMigration, rollbackMigration, saveVtxosForContract, scriptFromArkAddress, serializeAssets, serializeUtxo, serializeVtxo, setupServiceWorker, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, waitForIncomingFunds, warnAndFilterVtxosForScript };
+//# sourceMappingURL=chunk-BVP2U66Q.js.map
+//# sourceMappingURL=chunk-BVP2U66Q.js.map