@arkade-os/sdk 0.4.69 → 0.4.71

package/dist/{chunk-TA7XLEP2.js → chunk-E5JNYFOF.js}

@@ -1,6 +1,6 @@
-import { AssetId, AssetGroup, AssetInput, AssetOutput, Metadata, Packet, BufferReader, BufferWriter, AssetRef, RestIndexerProvider } from './chunk-YG7T6LI3.js';
-import { witnessRefToBytes, validateProgram, toASM, stringifyArtifact, serializeArkadeContractParams, resolveAsm, parseArtifact, getOpcodeValue, getOpcodeName, fromASM, deserializeArkadeContractParams, computeArkadeScriptPublicKey, bytesToASM, asmToBytes, arkadeWitnessHash, arkadeScriptHash, SUPPORTED_PROGRAM_VERSION, OPCODE_VALUES, OPCODE_NAMES, bignum_exports, ArkadeScript, ArkadeProgramScript, ARKADE_OPS, ARKADE_OPCODE_VALUES, ARKADE_OPCODE_NAMES, ARKADE_OPCODES, ARKADE_OP, toXOnly, inputName, contractHandlers, isMainnetDescriptor, descriptorIsOurs, deriveDescriptorLeafPubKey, deriveDescriptorLeafCompressedPubKey, parseHDDescriptor, identityDescriptor, DefaultVtxo, speculativeReceiveMetadata, DelegateVtxo, WALLET_RECEIVE_SOURCE, BoardingContractHandler } from './chunk-2PPL3O7Z.js';
-import { VtxoScript, Transaction, isRecoverable, CSVMultisigTapscript, DEFAULT_NETWORK, resolveEmulatorPubkey, hasTerminalSpend, getNormalizedVtxos, setArkPsbtField, PrevArkTxField, ConditionWitness, craftToSpendTx, ArkAddress, isVirtualCoin, getArkPsbtFields, CosignerPublicKey, ServerResponseMismatchError, OP_RETURN_EMPTY_PKSCRIPT, canSweepOnchain, sequenceToTimelock, decodeTapscript, scriptFromTapLeafScript, CLTVMultisigTapscript, VtxoTaprootTree, timelockToSequence, assertAllowedSighashTypes, baseFetch, Intent, rateGate, DEFAULT_NETWORK_NAME, formatSighash, normalizeVtxo, getSequence, toBatchExpiry, maybeArkError, isArkError, ArkErrorName, toOffchainInputFeeParams, canRecoverOnchain, getNetwork, MultisigTapscript, isEventSourceError, isEventSourceUnavailableError, isRetryableProviderError, getAllNormalizedVtxos, DEFAULT_PAGE_SIZE, RestArkProvider, toVirtualStatus, ArkError, TapTreeCoder, resolveTimeHeight, canSpendOffchain, parseLegacyExpiry, isExpired, PrevoutTxField, DEFAULT_ARKADE_SERVER_URL, ProviderUnavailableError, networks as networks$1, isPastExpiry, fetchVtxoCreatedAtByTxid } from './chunk-L5SCQYHF.js';
+import { AssetId, AssetGroup, AssetInput, AssetOutput, Metadata, Packet, BufferReader, BufferWriter, AssetRef, RestIndexerProvider } from './chunk-ZT3EM4CE.js';
+import { witnessRefToBytes, validateProgram, toASM, stringifyArtifact, serializeArkadeContractParams, resolveAsm, parseArtifact, getOpcodeValue, getOpcodeName, fromASM, deserializeArkadeContractParams, computeArkadeScriptPublicKey, bytesToASM, asmToBytes, arkadeWitnessHash, arkadeScriptHash, SUPPORTED_PROGRAM_VERSION, OPCODE_VALUES, OPCODE_NAMES, bignum_exports, ArkadeScript, ArkadeProgramScript, ARKADE_OPS, ARKADE_OPCODE_VALUES, ARKADE_OPCODE_NAMES, ARKADE_OPCODES, ARKADE_OP, toXOnly, inputName, contractHandlers, isMainnetDescriptor, descriptorIsOurs, deriveDescriptorLeafPubKey, deriveDescriptorLeafCompressedPubKey, parseHDDescriptor, identityDescriptor, DefaultVtxo, speculativeReceiveMetadata, DelegateVtxo, WALLET_RECEIVE_SOURCE, BoardingContractHandler } from './chunk-ALZ2CZ3T.js';
+import { VtxoScript, Transaction, isRecoverable, CSVMultisigTapscript, DEFAULT_NETWORK, resolveEmulatorPubkey, hasTerminalSpend, getNormalizedVtxos, setArkPsbtField, PrevArkTxField, ConditionWitness, craftToSpendTx, ArkAddress, isVirtualCoin, getArkPsbtFields, CosignerPublicKey, ServerResponseMismatchError, OP_RETURN_EMPTY_PKSCRIPT, canSweepOnchain, sequenceToTimelock, decodeTapscript, scriptFromTapLeafScript, CLTVMultisigTapscript, VtxoTaprootTree, timelockToSequence, assertAllowedSighashTypes, baseFetch, Intent, rateGate, DEFAULT_NETWORK_NAME, formatSighash, normalizeVtxo, getSequence, toBatchExpiry, maybeArkError, isArkError, ArkErrorName, toOffchainInputFeeParams, canRecoverOnchain, getNetwork, MultisigTapscript, isEventSourceError, isEventSourceUnavailableError, getAllNormalizedVtxos, isPastExpiry, isRetryableProviderError, DEFAULT_PAGE_SIZE, RestArkProvider, toVirtualStatus, ArkError, TapTreeCoder, resolveTimeHeight, canSpendOffchain, parseLegacyExpiry, isExpired, PrevoutTxField, DEFAULT_ARKADE_SERVER_URL, ProviderUnavailableError, networks as networks$1, fetchVtxoCreatedAtByTxid } from './chunk-2ZX4Z2IP.js';
 import { __export } from './chunk-NSBPE2FW.js';
 import { sha256 as sha256$1, equalBytes, hash160, sha256x2, concatBytes, randomPrivateKeyBytes, pubECDSA, pubSchnorr } from '@scure/btc-signer/utils.js';
 import { SigHash, Script, OP, OutScript, Address, RawWitness, p2tr, p2wpkh, TaprootControlBlock, DEFAULT_SEQUENCE, Transaction as Transaction$2 } from '@scure/btc-signer';
@@ -2016,7 +2016,10 @@ var EsploraProvider = class {
     return { subscribers, teardown, started };
   }
   async getChainTip() {
-    const tipBlocks = await baseFetch(`${this.baseUrl}/blocks`);
+    let tipBlocks = await baseFetch(`${this.baseUrl}/blocks`);
+    if (tipBlocks.status === 404) {
+      tipBlocks = await baseFetch(`${this.baseUrl}/v1/blocks`);
+    }
     if (!tipBlocks.ok) {
       throw new Error(`Failed to get chain tip: ${tipBlocks.statusText}`);
     }
@@ -3615,6 +3618,26 @@ function claimWithPreimageIdentity(identity, preimage) {
     }
   };
 }
+
+// src/contracts/types.ts
+function watchStateOf(contract) {
+  return contract.watch ?? "watched";
+}
+function isWatchedContract(contract) {
+  return watchStateOf(contract) !== "retained";
+}
+function hasCandidates(handler) {
+  return !!handler && typeof handler.candidatesAt === "function";
+}
+function isDiscoverable(handler) {
+  return !!handler && typeof handler.discoverAt === "function";
+}
+function isTapscriptDeriving(handler) {
+  return !!handler && typeof handler.deriveTapscripts === "function";
+}
+function isContractVtxoEvent(event) {
+  return "contract" in event && event.contract !== void 0;
+}
 var AmountVariableName = "amount";
 var ExpiryVariableName = "expiry";
 var BirthVariableName = "birth";
@@ -3770,23 +3793,6 @@ function parseProgram(text, env) {
   }
   return { program, text };
 }
-
-// src/contracts/types.ts
-function watchStateOf(contract) {
-  return contract.watch ?? "watched";
-}
-function isWatchedContract(contract) {
-  return watchStateOf(contract) !== "retained";
-}
-function hasCandidates(handler) {
-  return !!handler && typeof handler.candidatesAt === "function";
-}
-function isDiscoverable(handler) {
-  return !!handler && typeof handler.discoverAt === "function";
-}
-function isTapscriptDeriving(handler) {
-  return !!handler && typeof handler.deriveTapscripts === "function";
-}
 var DUST_AMOUNT = 546;
 var FALLBACK_WALLET_DUST_AMOUNT = 330n;
 function getDustAmount(wallet) {
@@ -5336,7 +5342,7 @@ var VtxoManager = class _VtxoManager {
         this.wallet.getAddress()
       ]);
       const stopWatching = contractManager.onContractEvent((event) => {
-        if (event.type !== "vtxo_received") {
+        if (event.type !== "vtxo_received" || !isContractVtxoEvent(event)) {
           return;
         }
         const msSinceLastRenewal = Date.now() - this.lastRenewalTimestamp;
@@ -8708,6 +8714,8 @@ var DEFAULT_CONTRACT_WATCHER_CONFIG = {
 var ContractWatcher = class {
   config;
   contracts = /* @__PURE__ */ new Map();
+  /** In-memory and process-lifetime; never persisted. */
+  watchedScripts = /* @__PURE__ */ new Map();
   subscriptionId;
   abortController;
   isWatching = false;
@@ -8828,6 +8836,47 @@ var ContractWatcher = class {
   getWatchedContracts() {
     return this.getAllContracts().filter(isWatchedContract);
   }
+  /**
+   * Every script the subscription must carry. Wider than
+   * {@link getWatchedContracts}, which stays the sync scope.
+   */
+  getSubscribedScripts() {
+    const scripts = new Set(this.getWatchedContracts().map((c) => c.script));
+    for (const script of this.watchedScripts.keys()) {
+      scripts.add(script);
+    }
+    return Array.from(scripts);
+  }
+  /** @see IContractManager.watchScript for the delivery and filter contract. */
+  async addWatchedScript(script, options) {
+    const existing = this.watchedScripts.get(script);
+    if (existing) {
+      if (options?.label !== void 0) existing.label = options.label;
+      return;
+    }
+    this.watchedScripts.set(script, {
+      label: options?.label,
+      lastKnownVtxos: /* @__PURE__ */ new Map()
+    });
+    if (this.isWatching) {
+      await this.pollWatchedScripts([script]);
+      await this.tryUpdateSubscription();
+    }
+  }
+  /** Stop watching a script added by {@link addWatchedScript}. */
+  async removeWatchedScript(script) {
+    if (!this.watchedScripts.delete(script)) return;
+    if (this.isWatching) {
+      await this.tryUpdateSubscription();
+    }
+  }
+  /** Every script registered via {@link addWatchedScript}. */
+  getWatchedScripts() {
+    return Array.from(this.watchedScripts.entries()).map(([script, state]) => ({
+      script,
+      label: state.label
+    }));
+  }
   /**
    * Get virtual outputs for contracts, grouped by contract script.
    * @see WalletRepository for `repo`
@@ -9019,8 +9068,72 @@ var ContractWatcher = class {
   }
   async pollAllContracts() {
     const scripts = this.getWatchedContracts().map((c) => c.script);
+    if (scripts.length > 0) {
+      await this.pollContracts(scripts);
+    }
+    await this.pollWatchedScripts(Array.from(this.watchedScripts.keys()));
+  }
+  /**
+   * Poll watch-only scripts against the indexer and emit the delta.
+   *
+   * Separate from {@link pollContracts} because that one diffs the wallet
+   * repository, which is permanently empty for a script this wallet does not
+   * own — reusing it would report every live output as spent on every tick.
+   * Not a second poll loop: same timer and callers, different source.
+   */
+  async pollWatchedScripts(candidates) {
+    if (!this.eventCallback) return;
+    const scripts = candidates.filter((s) => {
+      const state = this.contracts.get(s);
+      return this.watchedScripts.has(s) && (state === void 0 || !isWatchedContract(state.contract));
+    });
     if (scripts.length === 0) return;
-    await this.pollContracts(scripts);
+    const now = Date.now();
+    let current;
+    try {
+      current = await getAllNormalizedVtxos(this.config.indexerProvider, scripts, {
+        spendableOnly: true
+      });
+    } catch (error) {
+      console.error("ContractWatcher watch-only poll failed:", error);
+      return;
+    }
+    const byScript = /* @__PURE__ */ new Map();
+    for (const vtxo of current) {
+      let bucket = byScript.get(vtxo.script);
+      if (!bucket) {
+        bucket = [];
+        byScript.set(vtxo.script, bucket);
+      }
+      bucket.push(vtxo);
+    }
+    for (const script of scripts) {
+      const state = this.watchedScripts.get(script);
+      if (!state) continue;
+      const currentVtxos = byScript.get(script) || [];
+      const currentKeys = new Set(currentVtxos.map((v) => `${v.txid}:${v.vout}`));
+      const newVtxos = [];
+      for (const vtxo of currentVtxos) {
+        const key = `${vtxo.txid}:${vtxo.vout}`;
+        if (!state.lastKnownVtxos.has(key)) {
+          newVtxos.push(vtxo);
+          state.lastKnownVtxos.set(key, vtxo);
+        }
+      }
+      const spentVtxos = [];
+      for (const [key, vtxo] of state.lastKnownVtxos) {
+        if (!currentKeys.has(key)) {
+          spentVtxos.push(vtxo);
+          state.lastKnownVtxos.delete(key);
+        }
+      }
+      if (newVtxos.length > 0) {
+        this.emitWatchedScriptEvent(script, newVtxos, "vtxo_received", now);
+      }
+      if (spentVtxos.length > 0) {
+        this.emitWatchedScriptEvent(script, spentVtxos, "vtxo_spent", now);
+      }
+    }
   }
   /**
    * Poll specific contracts and emit events for changes.
@@ -9121,10 +9234,10 @@ var ContractWatcher = class {
   /**
    * Update the subscription with scripts that should be watched.
    *
-   * @see getWatchedContracts
+   * @see getSubscribedScripts
    */
   async updateSubscription() {
-    const scriptsToWatch = this.getWatchedContracts().map((c) => c.script);
+    const scriptsToWatch = this.getSubscribedScripts();
     if (scriptsToWatch.length === 0) {
       if (this.subscriptionId) {
         try {
@@ -9208,16 +9321,26 @@ var ContractWatcher = class {
    */
   processSubscriptionVtxos(vtxos, eventType, timestamp) {
     const byContract = /* @__PURE__ */ new Map();
+    const byWatchedScript = /* @__PURE__ */ new Map();
     let unknownScript = 0;
+    const now = { timestamp: /* @__PURE__ */ new Date() };
     for (const vtxo of vtxos) {
-      if (!this.contracts.has(vtxo.script)) {
+      const state = this.contracts.get(vtxo.script);
+      const watchOnly = this.watchedScripts.has(vtxo.script);
+      const preferContract = state !== void 0 && (!watchOnly || isWatchedContract(state.contract));
+      const target = preferContract ? byContract : watchOnly ? byWatchedScript : void 0;
+      if (!target) {
         unknownScript++;
         continue;
       }
-      let bucket = byContract.get(vtxo.script);
+      if (target === byWatchedScript && eventType === "vtxo_received") {
+        const n = normalizeVtxo(vtxo);
+        if (hasTerminalSpend(n) || n.isSwept || isPastExpiry(n, now)) continue;
+      }
+      let bucket = target.get(vtxo.script);
       if (!bucket) {
         bucket = [];
-        byContract.set(vtxo.script, bucket);
+        target.set(vtxo.script, bucket);
       }
       bucket.push(vtxo);
     }
@@ -9240,6 +9363,29 @@ var ContractWatcher = class {
       }
       this.emitVtxoEvent(contractScript, bucketVtxos, eventType, timestamp);
     }
+    for (const [script, bucketVtxos] of byWatchedScript) {
+      const state = this.watchedScripts.get(script);
+      if (state) {
+        for (const vtxo of bucketVtxos) {
+          const key = `${vtxo.txid}:${vtxo.vout}`;
+          if (eventType === "vtxo_received") {
+            state.lastKnownVtxos.set(key, vtxo);
+          } else {
+            state.lastKnownVtxos.delete(key);
+          }
+        }
+      }
+      this.emitWatchedScriptEvent(script, bucketVtxos, eventType, timestamp);
+    }
+  }
+  /** As {@link emitVtxoEvent}, less the `contract` and the annotation. */
+  emitWatchedScriptEvent(script, vtxos, eventType, timestamp) {
+    if (!this.eventCallback) return;
+    if (eventType === "vtxo_received") {
+      this.eventCallback({ type: "vtxo_received", contractScript: script, vtxos, timestamp });
+      return;
+    }
+    this.eventCallback({ type: "vtxo_spent", contractScript: script, vtxos, timestamp });
   }
   /**
    * Emit a virtual output event for a contract.
@@ -10395,6 +10541,18 @@ var ContractManager = class _ContractManager {
   async isWatching() {
     return this.watcher.isCurrentlyWatching();
   }
+  /** @see IContractManager.watchScript */
+  async watchScript(script, options) {
+    await this.watcher.addWatchedScript(script, options);
+  }
+  /** @see IContractManager.unwatchScript */
+  async unwatchScript(script) {
+    await this.watcher.removeWatchedScript(script);
+  }
+  /** @see IContractManager.getWatchedScripts */
+  async getWatchedScripts() {
+    return this.watcher.getWatchedScripts();
+  }
   /**
    * Emit an event to all registered callbacks.
    */
@@ -10415,11 +10573,15 @@ var ContractManager = class _ContractManager {
     try {
       switch (event.type) {
         // Delta-sync only the changed virtual outputs for this contract.
+        // The guard below is the ownership boundary: a watch-only script
+        // reports these same types, so it must precede `syncContracts`.
         case "vtxo_received":
+          if (!isContractVtxoEvent(event)) break;
           await this.syncContracts({ contracts: [event.contract] });
           this.markSyncOnline();
           break;
         case "vtxo_spent":
+          if (!isContractVtxoEvent(event)) break;
           await this.syncContracts({ contracts: [event.contract] });
           this.markSyncOnline();
           if (this.config.onVtxosSpent) {
@@ -13346,7 +13508,7 @@ var ReadonlyWallet = class _ReadonlyWallet {
       const cm = await this.getContractManager();
       let annotationQueue = Promise.resolve();
       indexerStopFunc = cm.onContractEvent((event) => {
-        if (event.type !== "vtxo_received" && event.type !== "vtxo_spent") {
+        if (!isContractVtxoEvent(event)) {
           return;
         }
         if (event.contract.type !== "default" && event.contract.type !== "delegate") {
@@ -17418,6 +17580,9 @@ var DelegateNotConfiguredError = class extends Error {
 };
 var DelegatorNotConfiguredError = DelegateNotConfiguredError;
 var DEFAULT_MESSAGE_TAG = "WALLET_UPDATER";
+function unsupportedByManager(method) {
+  return new Error(`Contract manager does not support ${method}`);
+}
 var serializeMigrationVtxoRef = (ref) => ({
   txid: ref.txid,
   vout: ref.vout,
@@ -17802,6 +17967,39 @@ var WalletMessageHandler = class {
             payload: { contracts }
           });
         }
+        case "WATCH_SCRIPT": {
+          const manager = await this.readonlyWallet.getContractManager();
+          if (!manager.watchScript) throw unsupportedByManager("watchScript");
+          await manager.watchScript(message.payload.script, {
+            label: message.payload.label
+          });
+          return this.tagged({
+            id,
+            type: "SCRIPT_WATCHED",
+            payload: { script: message.payload.script }
+          });
+        }
+        case "UNWATCH_SCRIPT": {
+          const manager = await this.readonlyWallet.getContractManager();
+          if (!manager.unwatchScript) throw unsupportedByManager("unwatchScript");
+          await manager.unwatchScript(message.payload.script);
+          return this.tagged({
+            id,
+            type: "SCRIPT_UNWATCHED",
+            payload: { script: message.payload.script }
+          });
+        }
+        case "GET_WATCHED_SCRIPTS": {
+          const manager = await this.readonlyWallet.getContractManager();
+          if (!manager.getWatchedScripts) {
+            throw unsupportedByManager("getWatchedScripts");
+          }
+          return this.tagged({
+            id,
+            type: "WATCHED_SCRIPTS",
+            payload: { scripts: await manager.getWatchedScripts() }
+          });
+        }
         case "ANNOTATE_VTXOS": {
           const manager = await this.readonlyWallet.getContractManager();
           const annotated = await manager.annotateVtxos(message.payload.vtxos);
@@ -18605,6 +18803,7 @@ var DEFAULT_MESSAGE_TIMEOUTS = {
   GET_TRANSACTION_HISTORY: 2e4,
   GET_CONTRACTS: 2e4,
   GET_CONTRACTS_WITH_VTXOS: 2e4,
+  GET_WATCHED_SCRIPTS: 1e4,
   ANNOTATE_VTXOS: 2e4,
   GET_SPENDABLE_PATHS: 2e4,
   GET_ALL_SPENDING_PATHS: 2e4,
@@ -18641,6 +18840,10 @@ var DEFAULT_MESSAGE_TIMEOUTS = {
   SIGN_TRANSACTION: 3e4,
   CREATE_CONTRACT: 3e4,
   UPDATE_CONTRACT: 3e4,
+  // Registering a watch is an in-memory map write plus one subscription
+  // update — no indexer round trip on the request path.
+  WATCH_SCRIPT: 1e4,
+  UNWATCH_SCRIPT: 1e4,
   DELETE_CONTRACT: 1e4,
   REFRESH_VTXOS: 3e4,
   REFRESH_OUTPOINTS: 3e4
@@ -18661,6 +18864,7 @@ var DEDUPABLE_REQUEST_TYPES = /* @__PURE__ */ new Set([
   "GET_SPENDABLE_VTXOS",
   "GET_CONTRACTS",
   "GET_CONTRACTS_WITH_VTXOS",
+  "GET_WATCHED_SCRIPTS",
   "ANNOTATE_VTXOS",
   "GET_SPENDABLE_PATHS",
   "GET_ALL_SPENDING_PATHS",
@@ -19369,6 +19573,46 @@ var ServiceWorkerReadonlyWallet = class _ServiceWorkerReadonlyWallet {
           throw new Error("Failed to get contracts with vtxos");
         }
       },
+      async watchScript(script, options) {
+        const message = {
+          type: "WATCH_SCRIPT",
+          id: getRandomId(),
+          tag: messageTag,
+          payload: { script, label: options?.label }
+        };
+        try {
+          await sendContractMessage(message);
+        } catch (e) {
+          throw new Error("Failed to watch script");
+        }
+      },
+      async unwatchScript(script) {
+        const message = {
+          type: "UNWATCH_SCRIPT",
+          id: getRandomId(),
+          tag: messageTag,
+          payload: { script }
+        };
+        try {
+          await sendContractMessage(message);
+        } catch (e) {
+          throw new Error("Failed to unwatch script");
+        }
+      },
+      async getWatchedScripts() {
+        const message = {
+          type: "GET_WATCHED_SCRIPTS",
+          id: getRandomId(),
+          tag: messageTag,
+          payload: {}
+        };
+        try {
+          const response = await sendContractMessage(message);
+          return response.payload.scripts;
+        } catch (e) {
+          throw new Error("Failed to get watched scripts");
+        }
+      },
       getSyncState() {
         return syncState;
       },
@@ -23620,6 +23864,33 @@ function tryResolveSendAmount(raw, amount) {
   const amt = amount ?? BIP21.amountSats(raw);
   return amt !== void 0 && Number.isInteger(amt) && amt > 0 ? amt : void 0;
 }
+function assetsOf(req) {
+  return req.assets ?? [];
+}
+function assertNoAssets(railId, req) {
+  const assets = assetsOf(req);
+  if (assets.length > 0) {
+    throw new Error(
+      `${railId}: cannot deliver ${assets.map((a) => a.assetId).join(", ")} \u2014 this rail moves BTC only`
+    );
+  }
+}
+function resolveAssetAmount(railId, req) {
+  const assets = assetsOf(req);
+  if (assets.length !== 1) {
+    throw new Error(`${railId}: expected exactly one asset to pay, got ${assets.length}`);
+  }
+  const [asset] = assets;
+  if (typeof asset.amount !== "bigint" || asset.amount <= 0n) {
+    throw new Error(
+      `${railId}: invalid amount ${String(asset.amount)} of ${asset.assetId} (expected a positive bigint of atomic units)`
+    );
+  }
+  if (typeof asset.assetId !== "string" || asset.assetId.length === 0) {
+    throw new Error(`${railId}: an asset amount must name an asset`);
+  }
+  return asset;
+}
 
 // src/payment/handle.ts
 function makeHandle(id, run) {
@@ -23742,8 +24013,10 @@ function arkRail() {
   return {
     id: "ark",
     match: (req) => arkTarget(req.raw) !== void 0,
+    available: (req) => assetsOf(req).length === 0,
     quote: async (req, ctx) => {
       const address = arkTarget(req.raw);
+      assertNoAssets("ark", req);
       const amt = resolveSendAmount("ark", req.raw, req.amount);
       return {
         railId: "ark",
@@ -23760,6 +24033,41 @@ function arkRail() {
     }
   };
 }
+
+// src/payment/rails/arkAsset.ts
+var ASSET_CARRIER_SATS = 330;
+function arkAssetRail() {
+  return {
+    id: "ark-asset",
+    match: (req) => arkTarget(req.raw) !== void 0,
+    // A malformed asset is `quote()`'s to name, not this rail's to drop.
+    available: (req) => assetsOf(req).length > 0,
+    quote: async (req, ctx) => {
+      const address = arkTarget(req.raw);
+      const asset = resolveAssetAmount("ark-asset", req);
+      if (req.amount !== void 0) assertSendableAmount("ark-asset", req.amount);
+      const carrier = tryResolveSendAmount(req.raw, req.amount) ?? ASSET_CARRIER_SATS;
+      return {
+        railId: "ark-asset",
+        amount: carrier,
+        fee: 0,
+        total: carrier,
+        assets: { delivered: asset, spent: asset },
+        send: async () => makeHandle("ark-asset", async (emit) => {
+          const txid = await ctx.wallet.send({
+            address,
+            amount: carrier,
+            assets: [asset]
+          });
+          const result = { railId: "ark-asset", txid };
+          emit({ status: "settled", result });
+          return result;
+        })
+      };
+    }
+  };
+}
+var walletFeeSource = (wallet) => async () => (await wallet.arkProvider.getInfo()).fees;
 var GROSS_UP_MAX_ROUNDS = 8;
 function grossUpOffboard(net, feeInfo, script) {
   const estimator = new Estimator(feeInfo?.intentFee ?? {});
@@ -23772,14 +24080,20 @@ function grossUpOffboard(net, feeInfo, script) {
   }
   return { gross, fee: gross - net };
 }
-function onchainRail() {
+function onchainRail(deps) {
+  if (typeof deps?.feeInfo !== "function") {
+    throw new Error("onchain rail: a feeInfo source is required");
+  }
   return {
     id: "onchain",
     match: (req) => btcTarget(req.raw) !== void 0,
+    // BTC only: an Arkade asset has no L1 representation to offboard to.
+    available: (req) => assetsOf(req).length === 0,
     quote: async (req, ctx) => {
+      assertNoAssets("onchain", req);
       const address = btcTarget(req.raw);
       const amt = resolveSendAmount("onchain", req.raw, req.amount);
-      const { fees } = await ctx.wallet.arkProvider.getInfo();
+      const fees = await deps.feeInfo();
       const script = hex.encode(offboardDestinationScript(address));
       const { gross, fee } = grossUpOffboard(amt, fees, script);
       return {
@@ -23806,8 +24120,8 @@ function onchainRail() {
 function createDefaultPaymentRouter(wallet) {
   return new PaymentRouter({
     wallet,
-    prefs: { priority: ["ark", "lightning", "onchain"] }
-  }).use(arkRail()).use(onchainRail());
+    prefs: { priority: ["ark", "ark-asset", "lightning", "onchain"] }
+  }).use(arkRail()).use(arkAssetRail()).use(onchainRail({ feeInfo: walletFeeSource(wallet) }));
 }
 /*! Bundled license information:
 
@@ -23815,6 +24129,6 @@ function createDefaultPaymentRouter(wallet) {
   (*! noble-hashes - MIT License (c) 2022 Paul Miller (paulmillr.com) *)
 */
 
-export { ARKADE_MAGIC, ARKADE_SALTED_PREIMAGE_TAG, ARKADE_SWAP_PREIMAGE_TAG, AbortError, ActivityRegistry, AmbiguousRouteError, ArkNote, ArkadeCash, ArkadeCashCreateError, AssetManager, BIP21, BIP21Error, BIP322, BLOCKED_UPGRADE_TIMEOUT_MS, Batch, CachingArkProvider, ChainedTxType, ConnectionDisposedError, ContractManager, ContractRepositoryImpl, ContractWatcher, DB_VERSION, DEFAULT_MESSAGE_TIMEOUTS, DEFAULT_MIN_BATCH_EXPIRY_SECONDS, DEFAULT_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, DatabaseUpgradeBlockedError, DelegateManagerImpl, DelegateNotConfiguredError, DelegatorManagerImpl, DelegatorNotConfiguredError, DescriptorIdentity, DescriptorSigningProviderMissingError, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, ESPLORA_URL, ElectrumOnchainProvider, EmulatorPacket, EsploraProvider, Estimator, Extension, ExtensionNotFoundError, ForeignDescriptorError, HDDescriptorProvider, INTENT_TERMINAL_STATES, InMemoryContractRepository, InMemoryIntentRepository, InMemoryVirtualTxRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBIntentRepository, IndexedDBVirtualTxRepository, IndexedDBWalletRepository, MAX_USED_SIGNING_DESCRIPTORS_LOOK_AHEAD, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MUTINYNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, MissingSigningDescriptorError, MnemonicIdentity, OnchainWallet, P2A, PaymentRouter, PrevTxUnavailableError, REGTEST_MIN_BATCH_EXPIRY_SECONDS, REGTEST_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, RestDelegateProvider, RestDelegatorProvider, RestEmulatorProvider, SIGNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, SeedIdentity, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, SingleKey, TxTree, TxType, TxWeightEstimator, UnannotatableInputError, UnilateralExit, UnknownPacket, Unroll, VtxoManager, Wallet2 as Wallet, WalletCannotAllocateAddressError, WalletCannotSignError, WalletMessageHandler, WalletNotInitializedError, WalletRepositoryImpl, WsElectrumChainSource, adoptContractDescriptor, arkRail, arkTarget, arkade_exports, assertFinalCommitmentMatchesValidated, assertIntentIdUnique, assertSendableAmount, assertSubmittedArkTxid, assertValidBatchExpiry, assertValidServerUnrollScript, assetMintResolver, attachPrevArkTxs, attachPrevoutTxs, awaitTransaction, boardingResolver, btcTarget, buildForfeitTx, buildOffchainTx, buildPreimageMessage, buildSaltedPreimageMessage, claimWithPreimageIdentity, classifyAgainstSignerSet, classifyContractSigner, closeDatabase, collabExitResolver, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, contractPreimage, contractSigner, createAssetPacket, createDefaultActivityRegistry, createDefaultPaymentRouter, createExitChainResolver, createManagedConnection, decodeArkContract, defaultBatchExpiryPolicy, defaultCheckpointExitDelayPolicy, deleteByIndex, deserializeAssets, deserializeExitPackage, deserializeUtxo, deserializeVtxo, encodeArkContract, exitObserverFor, extendVirtualCoinForContract, extractArkProviderUrl, gateExclusion, gatedContracts, getAllByIndexValues, getMigrationStatus, getRandomId, hasBoardingTxExpired, hasCandidates, intentMatchesFilter, intentPageBounds, invoiceTarget, isAddressAllocationCapable, isArkContract, isBatchSignable, isBtcAddress, isContractGenericallySpendable, isCooperativelyMigratable, isDeterministicSigner, isDiscoverable, isHDAllocationCapable, isHDDeterministicSignCapable, isHDWalletCapable, isLightningInvoice, isLnurl, isMessageBusInitializingError, isMessageBusNotInitializedError, isPerArtifactDescriptor, isSigningIdentity, isSubdust, isTerminalIntentState, isValidArkAddress, isVtxoExpiringSoon, isVtxoForScript, isWatchedContract, logExcludedVtxos, makeHandle, matchServerCheckpoints, mergeChainedTxType, migrateWalletRepository, notifyExitObserved, onchainRail, openDatabase, outpointExclusion, outpointReasons, promisifyRequest, provisionClaimSecret, provisionRefundKey, requiresMigration, resolveBatchExpiryPolicy, resolveCheckpointExitDelayPolicy, resolveDescriptorSigner, resolvePrevTxs, resolveSendAmount, rollbackMigration, saveVtxosForContract, scriptFromArkAddress, selectCoinsWithAsset, selectVirtualCoins, serializeAssets, serializeExitPackage, serializeUtxo, serializeVtxo, setupServiceWorker, signAndSubmitOffchainTx, signerSetFromInfo, signingDescriptorIndex, strictSigningDescriptorIndex, toXOnlySignerHex, tryResolveSendAmount, validateBatchRecipients, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, waitForIncomingFunds, warnAndFilterVtxosForScript, withPrevTxs };
-//# sourceMappingURL=chunk-TA7XLEP2.js.map
-//# sourceMappingURL=chunk-TA7XLEP2.js.map
+export { ARKADE_MAGIC, ARKADE_SALTED_PREIMAGE_TAG, ARKADE_SWAP_PREIMAGE_TAG, ASSET_CARRIER_SATS, AbortError, ActivityRegistry, AmbiguousRouteError, ArkNote, ArkadeCash, ArkadeCashCreateError, AssetManager, BIP21, BIP21Error, BIP322, BLOCKED_UPGRADE_TIMEOUT_MS, Batch, CachingArkProvider, ChainedTxType, ConnectionDisposedError, ContractManager, ContractRepositoryImpl, ContractWatcher, DB_VERSION, DEFAULT_MESSAGE_TIMEOUTS, DEFAULT_MIN_BATCH_EXPIRY_SECONDS, DEFAULT_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, DatabaseUpgradeBlockedError, DelegateManagerImpl, DelegateNotConfiguredError, DelegatorManagerImpl, DelegatorNotConfiguredError, DescriptorIdentity, DescriptorSigningProviderMissingError, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, ESPLORA_URL, ElectrumOnchainProvider, EmulatorPacket, EsploraProvider, Estimator, Extension, ExtensionNotFoundError, ForeignDescriptorError, HDDescriptorProvider, INTENT_TERMINAL_STATES, InMemoryContractRepository, InMemoryIntentRepository, InMemoryVirtualTxRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBIntentRepository, IndexedDBVirtualTxRepository, IndexedDBWalletRepository, MAX_USED_SIGNING_DESCRIPTORS_LOOK_AHEAD, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MUTINYNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, MissingSigningDescriptorError, MnemonicIdentity, OnchainWallet, P2A, PaymentRouter, PrevTxUnavailableError, REGTEST_MIN_BATCH_EXPIRY_SECONDS, REGTEST_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, RestDelegateProvider, RestDelegatorProvider, RestEmulatorProvider, SIGNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, SeedIdentity, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, SingleKey, TxTree, TxType, TxWeightEstimator, UnannotatableInputError, UnilateralExit, UnknownPacket, Unroll, VtxoManager, Wallet2 as Wallet, WalletCannotAllocateAddressError, WalletCannotSignError, WalletMessageHandler, WalletNotInitializedError, WalletRepositoryImpl, WsElectrumChainSource, adoptContractDescriptor, arkAssetRail, arkRail, arkTarget, arkade_exports, assertFinalCommitmentMatchesValidated, assertIntentIdUnique, assertNoAssets, assertSendableAmount, assertSubmittedArkTxid, assertValidBatchExpiry, assertValidServerUnrollScript, assetMintResolver, assetsOf, attachPrevArkTxs, attachPrevoutTxs, awaitTransaction, boardingResolver, btcTarget, buildForfeitTx, buildOffchainTx, buildPreimageMessage, buildSaltedPreimageMessage, claimWithPreimageIdentity, classifyAgainstSignerSet, classifyContractSigner, closeDatabase, collabExitResolver, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, contractPreimage, contractSigner, createAssetPacket, createDefaultActivityRegistry, createDefaultPaymentRouter, createExitChainResolver, createManagedConnection, decodeArkContract, defaultBatchExpiryPolicy, defaultCheckpointExitDelayPolicy, deleteByIndex, deserializeAssets, deserializeExitPackage, deserializeUtxo, deserializeVtxo, encodeArkContract, exitObserverFor, extendVirtualCoinForContract, extractArkProviderUrl, gateExclusion, gatedContracts, getAllByIndexValues, getMigrationStatus, getRandomId, hasBoardingTxExpired, hasCandidates, intentMatchesFilter, intentPageBounds, invoiceTarget, isAddressAllocationCapable, isArkContract, isBatchSignable, isBtcAddress, isContractGenericallySpendable, isContractVtxoEvent, isCooperativelyMigratable, isDeterministicSigner, isDiscoverable, isHDAllocationCapable, isHDDeterministicSignCapable, isHDWalletCapable, isLightningInvoice, isLnurl, isMessageBusInitializingError, isMessageBusNotInitializedError, isPerArtifactDescriptor, isSigningIdentity, isSubdust, isTerminalIntentState, isValidArkAddress, isVtxoExpiringSoon, isVtxoForScript, isWatchedContract, logExcludedVtxos, makeHandle, matchServerCheckpoints, mergeChainedTxType, migrateWalletRepository, notifyExitObserved, onchainRail, openDatabase, outpointExclusion, outpointReasons, promisifyRequest, provisionClaimSecret, provisionRefundKey, requiresMigration, resolveAssetAmount, resolveBatchExpiryPolicy, resolveCheckpointExitDelayPolicy, resolveDescriptorSigner, resolvePrevTxs, resolveSendAmount, rollbackMigration, saveVtxosForContract, scriptFromArkAddress, selectCoinsWithAsset, selectVirtualCoins, serializeAssets, serializeExitPackage, serializeUtxo, serializeVtxo, setupServiceWorker, signAndSubmitOffchainTx, signerSetFromInfo, signingDescriptorIndex, strictSigningDescriptorIndex, toXOnlySignerHex, tryResolveSendAmount, validateBatchRecipients, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, waitForIncomingFunds, walletFeeSource, warnAndFilterVtxosForScript, withPrevTxs };
+//# sourceMappingURL=chunk-E5JNYFOF.js.map
+//# sourceMappingURL=chunk-E5JNYFOF.js.map