@arkade-os/sdk 0.4.75 → 0.4.77

package/dist/{chunk-FTLPTF3R.js → chunk-MLOZHTBN.js}

@@ -1,6 +1,6 @@
-import { AssetId, AssetGroup, AssetInput, AssetOutput, Metadata, Packet, BufferReader, BufferWriter, AssetRef, RestIndexerProvider } from './chunk-PS564TAU.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-4GLSOP6L.js';
-import { VtxoScript, Transaction, isRecoverable, CSVMultisigTapscript, networks, getNetwork, 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, MultisigTapscript, isEventSourceError, isEventSourceUnavailableError, getAllNormalizedVtxos, isPastExpiry, isRetryableProviderError, DEFAULT_PAGE_SIZE, RestArkProvider, toVirtualStatus, ArkError, TapTreeCoder, resolveTimeHeight, canSpendOffchain, parseLegacyExpiry, isExpired, PrevoutTxField, fetchVtxoCreatedAtByTxid, DEFAULT_ARKADE_SERVER_URL, ProviderUnavailableError } from './chunk-UKFA7NVE.js';
+import { AssetId, AssetGroup, AssetInput, AssetOutput, Metadata, Packet, BufferReader, BufferWriter, AssetRef, RestIndexerProvider } from './chunk-HKOFYHZP.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-ACPANSOX.js';
+import { VtxoScript, Transaction, isRecoverable, CSVMultisigTapscript, networks, getNetwork, DEFAULT_NETWORK, resolveEmulatorPubkey, isVtxoSpent, 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, MultisigTapscript, isEventSourceError, isEventSourceUnavailableError, getAllNormalizedVtxos, isPastExpiry, isRetryableProviderError, DEFAULT_PAGE_SIZE, RestArkProvider, toVirtualStatus, ArkError, TapTreeCoder, resolveTimeHeight, canSpendOffchain, parseLegacyExpiry, isExpired, PrevoutTxField, fetchVtxoCreatedAtByTxid, DEFAULT_ARKADE_SERVER_URL, ProviderUnavailableError } from './chunk-52OA3UIC.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';
@@ -1334,7 +1334,7 @@ async function provisionClaimSecret(wallet, opts = {}) {
   const descriptor = await provisionDescriptor(wallet);
   const signer = await contractSigner(wallet, descriptor);
   const pubkey = await signer.xOnlyPublicKey();
-  const claim = async () => {
+  const claim2 = async () => {
     if (opts.preimage) return { preimage: opts.preimage, mustPersistPreimage: true };
     if (isPerArtifactDescriptor(descriptor)) {
       return {
@@ -1356,7 +1356,7 @@ async function provisionClaimSecret(wallet, opts = {}) {
       return { preimage: randomBytes(32), mustPersistPreimage: true };
     }
   };
-  const { preimage, preimageSalt, mustPersistPreimage } = await claim();
+  const { preimage, preimageSalt, mustPersistPreimage } = await claim2();
   return {
     descriptor,
     pubkey,
@@ -3918,7 +3918,7 @@ function parseProgram(text, env) {
 var DUST_AMOUNT = 546;
 var FALLBACK_WALLET_DUST_AMOUNT = 330n;
 function getDustAmount(wallet) {
-  return "dustAmount" in wallet ? wallet.dustAmount : FALLBACK_WALLET_DUST_AMOUNT;
+  return wallet && "dustAmount" in wallet ? wallet.dustAmount : FALLBACK_WALLET_DUST_AMOUNT;
 }
 function extendCoinWithTapscript(boardingTapscript, utxo) {
   return {
@@ -4128,7 +4128,7 @@ function selectPendingRecoveryOutpoints(contractsWithVtxos, signerSet, nowSecond
       continue;
     }
     for (const v of vtxos) {
-      if (!hasTerminalSpend(v) && !v.isSwept && !v.isUnrolled) {
+      if (!isVtxoSpent(v) && !v.isSwept && !v.isUnrolled) {
         out.add(`${v.txid}:${v.vout}`);
       }
     }
@@ -4655,7 +4655,10 @@ var VtxoManager = class _VtxoManager {
     if (this.settlementConfig === false && thresholdMs === void 0) {
       return [];
     }
-    const vtxos = await this.wallet.getSpendableVtxos({ withRecoverable: true });
+    const vtxos = await this.wallet.getSpendableVtxos({
+      withRecoverable: true,
+      genericallySpendableOnly: true
+    });
     let threshold;
     if (thresholdMs !== void 0) {
       threshold = thresholdMs;
@@ -5152,8 +5155,8 @@ var VtxoManager = class _VtxoManager {
       const cls = classifyAgainstSignerSet(serverPubKey, signerSet, nowSeconds);
       if (cls.status === "CURRENT") continue;
       const live = vtxos.filter((v) => !v.isUnrolled);
-      const recoverable = live.filter((v) => v.isSwept && !hasTerminalSpend(v));
-      const spendable = live.filter((v) => !hasTerminalSpend(v) && !v.isSwept);
+      const recoverable = live.filter((v) => v.isSwept && !isVtxoSpent(v));
+      const spendable = live.filter((v) => !isVtxoSpent(v) && !v.isSwept);
       const value = spendable.reduce((sum, v) => sum + v.value, 0);
       let recoverableCount = 0;
       let recoverableValue = 0;
@@ -7319,7 +7322,8 @@ var AssetManager = class extends ReadonlyAssetManager {
     }
     const metadata = castMetadata(params.metadata);
     const virtualCoins = await this.wallet.getSpendableVtxos({
-      withRecoverable: false
+      withRecoverable: false,
+      genericallySpendableOnly: true
     });
     const controlAssetRef = params.controlAssetId ? AssetRef.fromId(AssetId.fromString(params.controlAssetId)) : null;
     const coinSelection = selectVirtualCoins(virtualCoins, Number(this.wallet.dustAmount));
@@ -7408,7 +7412,8 @@ var AssetManager = class extends ReadonlyAssetManager {
       throw new Error(`Asset ${params.assetId} is not reissuable`);
     }
     const virtualCoins = await this.wallet.getSpendableVtxos({
-      withRecoverable: false
+      withRecoverable: false,
+      genericallySpendableOnly: true
     });
     const assetChanges = /* @__PURE__ */ new Map();
     const { selected: controlCoins } = selectCoinsWithAsset(virtualCoins, controlAssetId, 1n);
@@ -7514,7 +7519,8 @@ var AssetManager = class extends ReadonlyAssetManager {
       throw new Error(`Burn amount must be greater than 0, got ${params.amount}`);
     }
     const virtualCoins = await this.wallet.getSpendableVtxos({
-      withRecoverable: false
+      withRecoverable: false,
+      genericallySpendableOnly: true
     });
     const assetChanges = /* @__PURE__ */ new Map();
     const { selected: assetCoins } = selectCoinsWithAsset(
@@ -8203,7 +8209,7 @@ var STORE_INTENTS = "intents";
 var STORE_VIRTUAL_TXS = "virtualTxs";
 var STORE_VTXO_BRANCHES = "vtxoBranches";
 var LEGACY_STORE_CONTRACT_COLLECTIONS = "contractsCollections";
-var DB_VERSION = 3;
+var DB_VERSION = 4;
 var INTENT_DB_VERSION = 5;
 function initDatabase(db, oldVersion, transaction) {
   if (!db.objectStoreNames.contains(STORE_VTXOS)) {
@@ -8266,6 +8272,7 @@ function initDatabase(db, oldVersion, transaction) {
         unique: false
       });
     }
+    vtxosStore.createIndex("scriptUnspent", ["script", "unspent"], { unique: false });
   }
   if (!db.objectStoreNames.contains(STORE_UTXOS)) {
     const utxosStore = db.createObjectStore(STORE_UTXOS, {
@@ -8348,14 +8355,18 @@ function initDatabase(db, oldVersion, transaction) {
       keyPath: "key"
     });
   }
-  if (oldVersion >= 1 && oldVersion < 3 && transaction) {
+  if (oldVersion >= 1 && oldVersion < 4 && transaction) {
     const vtxosStore = transaction.objectStore(STORE_VTXOS);
     if (!vtxosStore.indexNames.contains("script")) {
       vtxosStore.createIndex("script", "script", { unique: false });
     }
-    backfillVtxoScripts(transaction);
+    if (!vtxosStore.indexNames.contains("scriptUnspent")) {
+      vtxosStore.createIndex("scriptUnspent", ["script", "unspent"], { unique: false });
+    }
+    backfillVtxoIndexFields(transaction);
   }
 }
+var unspentFlag = (vtxo) => isVtxoSpent(vtxo) ? {} : { unspent: 1 };
 function initDatabaseWithIntents(db, oldVersion, transaction) {
   initDatabase(db, oldVersion, transaction);
   if (!db.objectStoreNames.contains(STORE_INTENTS)) {
@@ -8405,19 +8416,28 @@ function dedupeIntentIds(store, onComplete) {
     cursor.continue();
   };
 }
-function backfillVtxoScripts(transaction) {
+function backfillVtxoIndexFields(transaction) {
   const store = transaction.objectStore(STORE_VTXOS);
-  const cursorRequest = store.openCursor();
-  cursorRequest.onsuccess = () => {
-    const cursor = cursorRequest.result;
-    if (!cursor) return;
-    const value = cursor.value;
-    if (!value.script) {
-      value.script = scriptFromArkAddress(value.address);
-      cursor.update(value);
-    }
-    cursor.continue();
+  const pageSize = 1e3;
+  const readPage = (after) => {
+    const request = store.getAll(after && IDBKeyRange.lowerBound(after, true), pageSize);
+    request.onsuccess = () => {
+      const rows = request.result;
+      for (const value of rows) {
+        const next = {
+          ...value,
+          script: value.script || scriptFromArkAddress(value.address),
+          ...unspentFlag(value)
+        };
+        if (next.script !== value.script || next.unspent !== value.unspent) {
+          store.put(next);
+        }
+      }
+      const last = rows.at(-1);
+      if (rows.length === pageSize && last) readPage([last.address, last.txid, last.vout]);
+    };
   };
+  readPage();
 }
 
 // src/worker/browser/utils.ts
@@ -8776,15 +8796,21 @@ var InMemoryWalletRepository = class {
     this.vtxosByAddress.delete(address);
   }
   async getVtxosForScript(script) {
-    const allMatches = [];
+    return this.getVtxosForScripts([script]);
+  }
+  async getVtxosForScripts(scripts, options) {
+    if (scripts.length === 0) return [];
+    const selected = new Set(scripts);
+    const byOutpoint = /* @__PURE__ */ new Map();
     for (const bucket of this.vtxosByAddress.values()) {
       for (const vtxo of bucket) {
-        if (isVtxoForScript(vtxo, script)) {
-          allMatches.push(vtxo);
+        if (vtxo.script && selected.has(vtxo.script)) {
+          byOutpoint.set(`${vtxo.script}:${vtxo.txid}:${vtxo.vout}`, vtxo);
         }
       }
     }
-    return mergeByKey([], allMatches, (item) => `${item.txid}:${item.vout}`);
+    const rows = [...byOutpoint.values()];
+    return options?.unspentOnly ? rows.filter((vtxo) => !isVtxoSpent(vtxo)) : rows;
   }
   async saveVtxosForScript(key, vtxos) {
     if (!key.address) {
@@ -9565,7 +9591,7 @@ var ContractWatcher = class {
       }
       if (target === byWatchedScript && eventType === "vtxo_received") {
         const n = normalizeVtxo(vtxo);
-        if (hasTerminalSpend(n) || n.isSwept || isPastExpiry(n, now)) continue;
+        if (isVtxoSpent(n) || n.isSwept || isPastExpiry(n, now)) continue;
       }
       let bucket = target.get(vtxo.script);
       if (!bucket) {
@@ -9664,7 +9690,7 @@ var NON_TERMINAL_INTENT_STATES = ALL_INTENT_STATES.filter(
   (s) => !isTerminalIntentState(s)
 );
 function isConsumed(vtxo) {
-  return vtxo !== void 0 && hasTerminalSpend(vtxo);
+  return vtxo !== void 0 && isVtxoSpent(vtxo);
 }
 async function classifyIntent(intent, vtxosByOutpoint, now) {
   if (isTerminalIntentState(intent.state)) return void 0;
@@ -9754,7 +9780,8 @@ function areCoalescibleContractTypes(a, b) {
 function toWatchOnlyContract(params) {
   return { ...params, state: params.state ?? "active", createdAt: Date.now() };
 }
-function annotatableIn(scriptToContract, vtxos) {
+var TAPSCRIPT_MEMO_MAX_ENTRIES = 1024;
+function annotatableIn(scriptToContract, vtxos, memo) {
   const scripts = /* @__PURE__ */ new Set();
   const cache = /* @__PURE__ */ new Map();
   const failures = /* @__PURE__ */ new Map();
@@ -9762,7 +9789,25 @@ function annotatableIn(scriptToContract, vtxos) {
     const contract = scriptToContract.get(script);
     if (!contract) continue;
     try {
-      cache.set(script, deriveContractTapscripts(contract));
+      const key = `${contract.type}\0${script}\0${JSON.stringify(contract.params)}`;
+      const handler = contractHandlers.get(contract.type);
+      const hit = memo?.get(script);
+      let tapscripts;
+      if (hit && hit.key === key && hit.handler === handler) {
+        tapscripts = hit.tapscripts;
+        memo.delete(script);
+        memo.set(script, hit);
+      } else {
+        memo?.delete(script);
+        tapscripts = deriveContractTapscripts(contract);
+        if (handler && memo) {
+          memo.set(script, { key, handler, tapscripts });
+          if (memo.size > TAPSCRIPT_MEMO_MAX_ENTRIES) {
+            memo.delete(memo.keys().next().value);
+          }
+        }
+      }
+      cache.set(script, tapscripts);
       scripts.add(script);
     } catch (err) {
       failures.set(
@@ -9780,6 +9825,8 @@ var CHAIN_TIP_TIMEOUT_MS = 5e3;
 var ContractManager = class _ContractManager {
   config;
   watcher;
+  /** Per-sync tapscript caches start empty; this outlives them. Consumers only ever see clones. */
+  tapscriptMemo = /* @__PURE__ */ new Map();
   initialized = false;
   eventCallbacks = /* @__PURE__ */ new Set();
   stopWatcherFn;
@@ -10462,9 +10509,15 @@ var ContractManager = class _ContractManager {
     const dbFilter = this.buildContractsDbFilter(filter ?? {});
     return await this.config.contractRepository.getContracts(dbFilter);
   }
-  async getContractsWithVtxos(filter, pageSize) {
+  async getContractsWithVtxos(filter, pageSize, options) {
+    if (options?.maxSyncAgeMs !== void 0 && (!Number.isSafeInteger(options.maxSyncAgeMs) || options.maxSyncAgeMs < 0)) {
+      throw new Error("maxSyncAgeMs must be a non-negative safe integer");
+    }
     const contracts = await this.getContracts(filter);
-    if (this.syncedWithin(contracts, this.config.vtxoSyncMaxAgeMs ?? 0)) {
+    if (this.syncedWithin(
+      contracts,
+      options?.maxSyncAgeMs ?? (options?.requireSynced ? 0 : this.config.vtxoSyncMaxAgeMs ?? 0)
+    )) {
       await this.demoteFundedAwaitingContracts(contracts);
     } else {
       try {
@@ -10473,12 +10526,23 @@ var ContractManager = class _ContractManager {
       } catch (err) {
         if (!isRetryableProviderError(err)) throw err;
         this.markSyncDegraded(err);
+        if (options?.requireSynced) {
+          throw new Error("Spendable VTXO read requires an online contract sync", {
+            cause: err
+          });
+        }
       }
     }
-    const vtxos = await this.getVtxosForContracts(contracts);
+    const vtxos = await this.getVtxosForContracts(contracts, options);
+    const vtxosByScript = /* @__PURE__ */ new Map();
+    for (const vtxo of vtxos) {
+      const group = vtxosByScript.get(vtxo.contractScript) ?? [];
+      group.push(vtxo);
+      vtxosByScript.set(vtxo.contractScript, group);
+    }
     return contracts.map((contract) => ({
       contract,
-      vtxos: vtxos.filter((vtxo) => vtxo.contractScript === contract.script)
+      vtxos: vtxosByScript.get(contract.script)?.slice() ?? []
     }));
   }
   async annotateVtxos(vtxos, tapscripts) {
@@ -10504,7 +10568,8 @@ var ContractManager = class _ContractManager {
     });
     const { scripts, failures } = annotatableIn(
       new Map(contracts.map((contract) => [contract.script, contract])),
-      vtxos
+      vtxos,
+      this.tapscriptMemo
     );
     const orphans = vtxos.filter(
       (vtxo) => !scripts.has(vtxo.script) && !failures.has(vtxo.script)
@@ -10655,6 +10720,7 @@ var ContractManager = class _ContractManager {
    */
   async deleteContract(script) {
     await this.config.contractRepository.deleteContract(script);
+    this.tapscriptMemo.delete(script);
     await this.watcher.removeContract(script);
   }
   /**
@@ -10906,20 +10972,28 @@ var ContractManager = class _ContractManager {
     }
     this.emitEvent(event);
   }
-  async getVtxosForContracts(contracts) {
-    const res = await Promise.all(
-      contracts.map(
-        (contract) => getVtxosForContract(this.config.walletRepository, contract).then(
-          (vtxos) => vtxos.map(
-            (vtxo) => ({
-              ...vtxo,
-              contractScript: contract.script
-            })
+  async getVtxosForContracts(contracts, options) {
+    if (contracts.length === 0) return [];
+    let rows;
+    if (this.config.walletRepository.getVtxosForScripts) {
+      const byScript = new Set(contracts.map((contract) => contract.script));
+      rows = (await this.config.walletRepository.getVtxosForScripts([...byScript], options)).filter((vtxo) => vtxo.script !== void 0 && byScript.has(vtxo.script)).map((vtxo) => ({ ...normalizeVtxo(vtxo), contractScript: vtxo.script }));
+    } else {
+      const res = await Promise.all(
+        contracts.map(
+          (contract) => getVtxosForContract(this.config.walletRepository, contract).then(
+            (vtxos) => vtxos.map(
+              (vtxo) => ({
+                ...vtxo,
+                contractScript: contract.script
+              })
+            )
           )
         )
-      )
-    );
-    return res.flat();
+      );
+      rows = res.flat();
+    }
+    return options?.unspentOnly ? rows.filter((vtxo) => !isVtxoSpent(vtxo)) : rows;
   }
   /**
    * Sync virtual outputs for the given contracts against the indexer.
@@ -11000,7 +11074,11 @@ var ContractManager = class _ContractManager {
     for (const [script, contract] of await this.promoteLookAheadHits(vtxos)) {
       scriptToContract.set(script, contract);
     }
-    const { scripts: annotatable, cache, failures } = annotatableIn(scriptToContract, vtxos);
+    const {
+      scripts: annotatable,
+      cache,
+      failures
+    } = annotatableIn(scriptToContract, vtxos, this.tapscriptMemo);
     this.recordAnnotationFailures(annotatable, failures);
     const owned = vtxos.filter((v) => annotatable.has(v.script));
     const annotated = await this.annotateVtxos(owned, cache);
@@ -11100,7 +11178,11 @@ var ContractManager = class _ContractManager {
     for (const [script, contract] of promoted) {
       scriptToContract.set(script, contract);
     }
-    const { scripts: annotatable, cache, failures } = annotatableIn(scriptToContract, vtxos);
+    const {
+      scripts: annotatable,
+      cache,
+      failures
+    } = annotatableIn(scriptToContract, vtxos, this.tapscriptMemo);
     this.recordAnnotationFailures(annotatable, failures);
     const owned = vtxos.filter((v) => annotatable.has(v.script));
     const annotated = await this.annotateVtxos(owned, cache);
@@ -11412,7 +11494,7 @@ var IndexedDBWalletRepository = class {
       const store = transaction.objectStore(STORE_VTXOS);
       for (const vtxo of vtxos) {
         const serialized = serializeVtxo(vtxo);
-        store.put({ address, ...serialized });
+        store.put({ address, ...serialized, ...unspentFlag(vtxo) });
       }
       await awaitTransaction(transaction);
     } catch (error) {
@@ -11432,31 +11514,52 @@ var IndexedDBWalletRepository = class {
     }
   }
   async getVtxosForScript(script) {
+    return this.getVtxosForScripts([script]);
+  }
+  async getVtxosForScripts(scripts, options) {
+    const unique = [...new Set(scripts)];
+    if (unique.length === 0) return [];
     try {
       const db = await this.getDB();
-      const store = db.transaction([STORE_VTXOS], "readonly").objectStore(STORE_VTXOS);
-      const results = await promisifyRequest(
-        store.index("script").getAll(script)
-      );
-      const matching = (results || []).filter((r) => r.script === script);
+      const rows = options?.unspentOnly ? await getAllByIndexValues(
+        this.vtxoStore(db),
+        "scriptUnspent",
+        unique.map((script) => [script, 1])
+      ) : await getAllByIndexValues(this.vtxoStore(db), "script", unique);
+      const selected = new Set(unique);
       const byOutpoint = /* @__PURE__ */ new Map();
-      for (const row of matching) {
-        const outpoint = `${row.txid}:${row.vout}`;
-        const existing = byOutpoint.get(outpoint);
-        if (!existing) {
-          byOutpoint.set(outpoint, row);
+      for (const row of rows) {
+        if (!selected.has(row.script)) continue;
+        const key = `${row.script}:${row.txid}:${row.vout}`;
+        const existing = byOutpoint.get(key);
+        if (!existing || shouldReplaceVtxo(existing, row)) byOutpoint.set(key, row);
+      }
+      if (options?.unspentOnly && byOutpoint.size > 0) {
+        const txids = [...new Set([...byOutpoint.values()].map((row) => row.txid))];
+        const store = this.vtxoStore(db);
+        for (const row of await getAllByIndexValues(store, "txid", txids)) {
+          const key = `${row.script}:${row.txid}:${row.vout}`;
+          const existing = byOutpoint.get(key);
+          if (existing && shouldReplaceVtxo(existing, row)) byOutpoint.set(key, row);
+        }
+      }
+      const result = [];
+      for (const row of byOutpoint.values()) {
+        if (options?.unspentOnly && (row.isSpent || row.spentBy || row.settledBy)) {
           continue;
         }
-        if (shouldReplaceVtxo(existing, row)) {
-          byOutpoint.set(outpoint, row);
-        }
+        const vtxo = deserializeVtxoWithBackfill(row);
+        if (!options?.unspentOnly || !isVtxoSpent(vtxo)) result.push(vtxo);
       }
-      return Array.from(byOutpoint.values()).map(deserializeVtxoWithBackfill);
+      return result;
     } catch (error) {
-      console.error(`Failed to get VTXOs for script ${script}:`, error);
+      console.error("Failed to get VTXOs for scripts:", error);
       throw error;
     }
   }
+  vtxoStore(db) {
+    return db.transaction([STORE_VTXOS], "readonly").objectStore(STORE_VTXOS);
+  }
   async saveVtxosForScript(key, vtxos) {
     if (!key.address) {
       throw new Error("IndexedDBWalletRepository requires an address");
@@ -11587,7 +11690,7 @@ var IndexedDBWalletRepository = class {
     return this.connection.get();
   }
 };
-function deserializeVtxoWithBackfill(o) {
+function deserializeVtxoWithBackfill({ unspent: _unspent, ...o }) {
   if (!o.script) {
     o = { ...o, script: scriptFromArkAddress(o.address) };
   }
@@ -12507,7 +12610,7 @@ async function resolveDescriptorProvider(config, walletRepository) {
 
 // src/wallet/balance.ts
 function computeOffchainBalance(vtxos, caps) {
-  const { now, isPendingRecovery, isGenericallySpendable, isUnlocked } = caps;
+  const { now, isPendingRecovery, isGenericallySpendable, isUnlocked, dustCarrier } = caps;
   let settled = 0;
   let preconfirmed = 0;
   let available = 0;
@@ -12524,7 +12627,7 @@ function computeOffchainBalance(vtxos, caps) {
     }
   };
   for (const vtxo of vtxos) {
-    if (hasTerminalSpend(vtxo)) continue;
+    if (isVtxoSpent(vtxo)) continue;
     addAssets(owned, vtxo);
     if (vtxo.isUnrolled) {
       unrolled += vtxo.value;
@@ -12553,6 +12656,9 @@ function computeOffchainBalance(vtxos, caps) {
       addAssets(spendable, vtxo);
     }
   }
+  if (available > 0 && spendable.size > 0) {
+    available = Math.max(0, available - Number(dustCarrier));
+  }
   const toAssets = (from) => Array.from(from.entries()).map(([assetId, amount]) => ({ assetId, amount }));
   return {
     settled,
@@ -12793,7 +12899,7 @@ function filterSnapshotVtxos(snapshot, filter, pendingSpendOutpoints) {
     if (vtxo.isUnrolled) {
       return !!f.withUnrolled;
     }
-    if (hasTerminalSpend(vtxo)) {
+    if (isVtxoSpent(vtxo)) {
       return false;
     }
     if (!f.withRecoverable && canRecoverOnchain(vtxo, now)) {
@@ -13361,7 +13467,9 @@ var ReadonlyWallet = class _ReadonlyWallet {
   }
   /** @inheritdoc */
   async getSpendableVtxos(filter) {
-    const snapshot = await this.contractSnapshot();
+    const snapshot = await this.contractSnapshot(filter, {
+      unspentOnly: !filter?.withUnrolled
+    });
     const vtxos = filterSnapshotVtxos(snapshot, filter, this._pendingSpendOutpoints);
     const { gated, pendingRecovery } = this.spendabilityView(snapshot);
     const selectable = vtxos.filter(
@@ -13379,7 +13487,7 @@ var ReadonlyWallet = class _ReadonlyWallet {
     if (!filter?.withUnrolled) {
       logExcludedVtxos(
         "getSpendableVtxos",
-        snapshot.flatMap((contract) => contract.vtxos).filter((vtxo) => vtxo.isUnrolled && !hasTerminalSpend(vtxo)),
+        snapshot.flatMap((contract) => contract.vtxos).filter((vtxo) => vtxo.isUnrolled && !isVtxoSpent(vtxo)),
         [() => UNROLLED_REASON]
       );
     }
@@ -13453,9 +13561,25 @@ var ReadonlyWallet = class _ReadonlyWallet {
    * otherwise the gate and the pending-recovery set answer about two different
    * points in time, and each read costs another sync.
    */
-  async contractSnapshot() {
+  async contractSnapshot(filter, options) {
     const contractManager = await this.getContractManager();
-    return contractManager.getContractsWithVtxos();
+    const scope = filter?.watchedOnly ? { watch: ["watched", "awaiting-funds"] } : void 0;
+    let query = scope;
+    if (filter?.genericallySpendableOnly) {
+      const scripts = (await contractManager.getContracts(scope)).filter(isContractGenericallySpendable).map((contract) => contract.script);
+      if (scripts.length === 0) {
+        if (filter.requireSynced) {
+          throw new Error("No generically spendable contracts to sync");
+        }
+        return [];
+      }
+      query = { ...scope, script: scripts };
+    }
+    return contractManager.getContractsWithVtxos(query, void 0, {
+      maxSyncAgeMs: filter?.maxSyncAgeMs,
+      unspentOnly: options?.unspentOnly,
+      requireSynced: filter?.requireSynced
+    });
   }
   /**
    * The two exclusion sets the gate is made of, derived from one snapshot so
@@ -13479,7 +13603,8 @@ var ReadonlyWallet = class _ReadonlyWallet {
       now: { timestamp: /* @__PURE__ */ new Date() },
       isPendingRecovery: (vtxo) => pendingRecovery.has(`${vtxo.txid}:${vtxo.vout}`),
       isGenericallySpendable: (vtxo) => !isGatedVtxo(vtxo, gated),
-      isUnlocked: (vtxo) => unlocked.has(`${vtxo.txid}:${vtxo.vout}`)
+      isUnlocked: (vtxo) => unlocked.has(`${vtxo.txid}:${vtxo.vout}`),
+      dustCarrier: getDustAmount(this)
     };
   }
   /**
@@ -15283,7 +15408,10 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
         filteredBoardingUtxos.push(utxo);
         amount += utxo.value - inputFee.satoshis;
       }
-      const vtxos = await this.getSpendableVtxos({ withRecoverable: true });
+      const vtxos = await this.getSpendableVtxos({
+        withRecoverable: true,
+        genericallySpendableOnly: true
+      });
       const filteredVtxos = [];
       for (const vtxo of byValueDescending(vtxos)) {
         if (filteredVtxos.length >= MAX_VTXOS_PER_SETTLEMENT) {
@@ -16196,7 +16324,7 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
     const spendable = [];
     const unclaimed = [];
     for (const vtxo of vtxos) {
-      if (hasTerminalSpend(vtxo)) {
+      if (isVtxoSpent(vtxo)) {
         unclaimed.push(cashReport(vtxo, "already-spent"));
       } else if (vtxo.isUnrolled) {
         unclaimed.push(cashReport(vtxo, "exited"));
@@ -16387,7 +16515,8 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
     let virtualCoins = [];
     if (!selectedVtxos) {
       virtualCoins = await this.getSpendableVtxos({
-        withRecoverable: false
+        withRecoverable: false,
+        genericallySpendableOnly: true
       });
     }
     const assetChanges = /* @__PURE__ */ new Map();
@@ -16419,6 +16548,15 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
         }
       }
     } else {
+      const coinsByAsset = /* @__PURE__ */ new Map();
+      for (const coin of virtualCoins) {
+        for (const assetId of new Set(coin.assets?.map((asset) => asset.assetId))) {
+          const coins = coinsByAsset.get(assetId) ?? [];
+          coins.push(coin);
+          coinsByAsset.set(assetId, coins);
+        }
+      }
+      const selectedOutpoints2 = /* @__PURE__ */ new Set();
       for (const recipient of recipients) {
         if (!recipient.assets) {
           continue;
@@ -16437,8 +16575,8 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
             amountToSelect -= existingChange;
             assetChanges.delete(receiverAsset.assetId);
           }
-          const availableCoins = virtualCoins.filter(
-            (c) => !selectedCoins.find((sc) => sc.txid === c.txid && sc.vout === c.vout)
+          const availableCoins = (coinsByAsset.get(receiverAsset.assetId) ?? []).filter(
+            (coin) => !selectedOutpoints2.has(vtxoOutpoint(coin))
           );
           const { selected, totalAssetAmount } = selectCoinsWithAsset(
             availableCoins,
@@ -16447,6 +16585,7 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
           );
           for (const coin of selected) {
             selectedCoins.push(coin);
+            selectedOutpoints2.add(vtxoOutpoint(coin));
             btcAmountToSelect -= coin.value;
             if (coin.assets) {
               for (const a of coin.assets) {
@@ -16467,7 +16606,7 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
       }
       if (btcAmountToSelect > 0) {
         const availableCoins = virtualCoins.filter(
-          (c) => !selectedCoins.find((sc) => sc.txid === c.txid && sc.vout === c.vout)
+          (coin) => !selectedOutpoints2.has(vtxoOutpoint(coin))
         );
         const { inputs: btcCoins } = selectVirtualCoins(availableCoins, btcAmountToSelect);
         for (const coin of btcCoins) {
@@ -16479,6 +16618,7 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
           }
         }
         selectedCoins = [...selectedCoins, ...btcCoins];
+        for (const coin of btcCoins) selectedOutpoints2.add(vtxoOutpoint(coin));
       }
     }
     let totalBtcSelected = selectedCoins.reduce((sum, c) => sum + c.value, 0);
@@ -16495,19 +16635,58 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
         `send({ selectedVtxos }): inputs total ${totalBtcSelected} sats, outputs need ${totalBtcOutput}`
       );
     }
-    if (assetChanges.size > 0 && changeAmount < Number(this.dustAmount)) {
-      if (selectedVtxos) {
-        throw new Error(
-          `send({ selectedVtxos }): ${changeAmount} sats of change cannot carry ${assetChanges.size} asset change(s), needs ${this.dustAmount}`
-        );
-      }
-      const availableCoins = virtualCoins.filter(
-        (c) => !selectedCoins.find((sc) => sc.txid === c.txid && sc.vout === c.vout)
+    if (selectedVtxos && assetChanges.size > 0 && changeAmount < Number(this.dustAmount)) {
+      throw new Error(
+        `send({ selectedVtxos }): ${changeAmount} sats of change cannot carry ${assetChanges.size} asset change(s), needs ${this.dustAmount}`
+      );
+    }
+    const vtxoMinAmount = changeAmount > 0 || assetChanges.size > 0 ? (await this.arkProvider.getInfo()).vtxoMinAmount ?? 0n : 0n;
+    if (selectedVtxos && changeAmount > 0 && BigInt(changeAmount) < vtxoMinAmount) {
+      throw new Error(
+        `send({ selectedVtxos }): ${changeAmount} sats of change is below the operator minimum of ${vtxoMinAmount} sats`
       );
-      const { inputs: extraCoins } = selectVirtualCoins(
-        availableCoins,
-        Number(this.dustAmount) - changeAmount
+    }
+    const selectedOutpoints = new Set(selectedCoins.map(vtxoOutpoint));
+    while (!selectedVtxos && (changeAmount > 0 && BigInt(changeAmount) < vtxoMinAmount || assetChanges.size > 0 && BigInt(changeAmount) < this.dustAmount)) {
+      const minimumChange = assetChanges.size > 0 && this.dustAmount > vtxoMinAmount ? this.dustAmount : vtxoMinAmount;
+      const availableCoins = virtualCoins.filter(
+        (coin) => !selectedOutpoints.has(vtxoOutpoint(coin))
       );
+      let extraCoins;
+      try {
+        ({ inputs: extraCoins } = selectVirtualCoins(
+          availableCoins,
+          Number(minimumChange) - changeAmount
+        ));
+      } catch (error) {
+        if (!(error instanceof Error) || error.message !== "Insufficient funds") {
+          throw error;
+        }
+        if (recipients.every((r) => r.assets.length === 0)) {
+          const plainCoins = virtualCoins.filter((coin) => !coin.assets?.length);
+          const exact = plainCoins.find((coin) => coin.value === totalBtcOutput);
+          let exactCoins = exact ? [exact] : void 0;
+          if (!exactCoins) {
+            const byAmount = /* @__PURE__ */ new Map();
+            for (const coin of plainCoins) {
+              const partner = byAmount.get(totalBtcOutput - coin.value);
+              if (partner) {
+                exactCoins = [partner, coin];
+                break;
+              }
+              byAmount.set(coin.value, coin);
+            }
+          }
+          if (exactCoins) {
+            selectedCoins = exactCoins;
+            assetChanges.clear();
+            totalBtcSelected = totalBtcOutput;
+            changeAmount = 0;
+            break;
+          }
+        }
+        throw new Error(`Cannot form minimum change amount of ${minimumChange} sats`);
+      }
       for (const coin of extraCoins) {
         if (coin.assets) {
           for (const asset of coin.assets) {
@@ -16517,6 +16696,7 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
         }
       }
       selectedCoins = [...selectedCoins, ...extraCoins];
+      for (const coin of extraCoins) selectedOutpoints.add(vtxoOutpoint(coin));
       totalBtcSelected += extraCoins.reduce((sum, c) => sum + c.value, 0);
       changeAmount = totalBtcSelected - totalBtcOutput;
     }
@@ -17903,7 +18083,8 @@ var Ramps = class {
     if (vtxos) reportUngatedInputs(this.wallet, vtxos);
     const spendable = vtxos ?? await this.wallet.getSpendableVtxos({
       withRecoverable: true,
-      withUnrolled: false
+      withUnrolled: false,
+      genericallySpendableOnly: true
     });
     const estimator = new Estimator(feeInfo?.intentFee ?? {});
     const { inputs, subtotal } = filterOffboardInputs(spendable, feeInfo, named);
@@ -17945,7 +18126,8 @@ var Ramps = class {
     if (vtxos) reportUngatedInputs(this.wallet, vtxos);
     const spendable = vtxos ?? await this.wallet.getSpendableVtxos({
       withRecoverable: true,
-      withUnrolled: false
+      withUnrolled: false,
+      genericallySpendableOnly: true
     });
     const estimator = new Estimator(feeInfo?.intentFee ?? {});
     const { inputs, subtotal } = filterOffboardInputs(spendable, feeInfo, named);
@@ -18332,7 +18514,7 @@ var WalletMessageHandler = class {
           return this.tagged({
             id,
             type: "SPENDABLE_VTXOS",
-            payload: { vtxos }
+            payload: { vtxos, filterApplied: true }
           });
         }
         case "GET_BOARDING_UTXOS": {
@@ -18413,11 +18595,15 @@ var WalletMessageHandler = class {
         }
         case "GET_CONTRACTS_WITH_VTXOS": {
           const manager = await this.readonlyWallet.getContractManager();
-          const contracts = await manager.getContractsWithVtxos(message.payload.filter);
+          const contracts = await manager.getContractsWithVtxos(
+            message.payload.filter,
+            void 0,
+            message.payload.options
+          );
           return this.tagged({
             id,
             type: "CONTRACTS_WITH_VTXOS",
-            payload: { contracts }
+            payload: { contracts, filterApplied: true }
           });
         }
         case "WATCH_SCRIPT": {
@@ -18835,7 +19021,8 @@ var WalletMessageHandler = class {
       now: { timestamp: /* @__PURE__ */ new Date() },
       isPendingRecovery: (vtxo) => pendingOutpoints.has(`${vtxo.txid}:${vtxo.vout}`),
       isGenericallySpendable: (vtxo) => !isGatedVtxo(vtxo, gated),
-      isUnlocked: (vtxo) => unlocked.has(`${vtxo.txid}:${vtxo.vout}`)
+      isUnlocked: (vtxo) => unlocked.has(`${vtxo.txid}:${vtxo.vout}`),
+      dustCarrier: getDustAmount(this.readonlyWallet)
     });
     return {
       boarding: {
@@ -19088,7 +19275,7 @@ var WalletMessageHandler = class {
       if (v.isUnrolled) {
         return withUnrolled;
       }
-      if (hasTerminalSpend(v)) {
+      if (isVtxoSpent(v)) {
         return false;
       }
       if (includeRecoverable) {
@@ -19941,7 +20128,13 @@ var ServiceWorkerReadonlyWallet = class _ServiceWorkerReadonlyWallet {
     };
     try {
       const response = await this.sendMessage(message);
-      return response.payload.vtxos.map(normalizeVtxo);
+      const payload = response.payload;
+      if ((filter?.watchedOnly || filter?.genericallySpendableOnly || filter?.requireSynced) && payload.filterApplied !== true) {
+        throw new Error(
+          "Service worker does not support the requested contract scope or freshness check"
+        );
+      }
+      return payload.vtxos.map(normalizeVtxo);
     } catch (error) {
       throw new Error(`Failed to get spendable vtxos: ${error}`);
     }
@@ -20026,15 +20219,20 @@ var ServiceWorkerReadonlyWallet = class _ServiceWorkerReadonlyWallet {
           throw new Error("Failed to get contracts");
         }
       },
-      async getContractsWithVtxos(filter) {
+      async getContractsWithVtxos(filter, _pageSize, options) {
         const message = {
           type: "GET_CONTRACTS_WITH_VTXOS",
           id: getRandomId(),
           tag: messageTag,
-          payload: { filter }
+          payload: { filter, options }
         };
         try {
           const response = await sendContractMessage(message);
+          if (options?.requireSynced && response.payload.filterApplied !== true) {
+            throw new Error(
+              "Service worker does not support the requested freshness check"
+            );
+          }
           await refreshSyncState();
           return response.payload.contracts;
         } catch (e) {
@@ -23512,7 +23710,9 @@ __export(arkade_exports, {
   fromASM: () => fromASM,
   getOpcodeName: () => getOpcodeName,
   getOpcodeValue: () => getOpcodeValue,
+  isContractArtifact: () => isContractArtifact,
   parseArtifact: () => parseArtifact,
+  programFromArtifact: () => programFromArtifact,
   resolveAsm: () => resolveAsm,
   serializeArkadeContractParams: () => serializeArkadeContractParams,
   stringifyArtifact: () => stringifyArtifact,
@@ -23710,6 +23910,263 @@ function createArkadeBatchHandler(intentId, inputs, signer, signedProof, message
     }
   };
 }
+var NATIVE_STRUCTS = {
+  AssetId: [
+    ["txid", "bytes32"],
+    ["gidx", "int"]
+  ],
+  Outpoint: [
+    ["txid", "bytes32"],
+    ["vout", "int"]
+  ],
+  ECPoint: [
+    ["x", "int"],
+    ["y", "int"]
+  ]
+};
+var HASH_OPCODES = /* @__PURE__ */ new Set(["OP_SHA256", "OP_HASH160", "OP_HASH256", "OP_RIPEMD160"]);
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNamed(value) {
+  return isRecord(value) && typeof value.name === "string" && typeof value.type === "string" && value.type.length > 0;
+}
+function isContractArtifact(value) {
+  if (!isRecord(value) || typeof value.contractName !== "string") return false;
+  if (!Array.isArray(value.constructorInputs)) return false;
+  if (value.structs !== void 0 && !Array.isArray(value.structs)) return false;
+  if (!Array.isArray(value.functions) || value.functions.length === 0) return false;
+  return value.functions.every(
+    (group) => isRecord(group) && typeof group.name === "string" && Array.isArray(group.leaves) && group.leaves.length > 0
+  );
+}
+function fail(detail) {
+  throw new Error(`programFromArtifact: ${detail}`);
+}
+function claim(seen, name, kind) {
+  if (seen.has(name)) fail(`duplicate ${kind} '${name}'`);
+  seen.add(name);
+}
+var SCALAR_TYPES = {
+  pubkey: "pubkey",
+  signature: "sig",
+  bytes: "bytes",
+  bytes20: "hash",
+  bytes32: "hash",
+  asset: "hash",
+  int: "int",
+  bool: "int"
+};
+function argType(arkType) {
+  if (!Object.hasOwn(SCALAR_TYPES, arkType)) fail(`unknown type '${arkType}'`);
+  return SCALAR_TYPES[arkType];
+}
+function arrayParts(type) {
+  const open = type.indexOf("[");
+  if (open < 0 || !type.endsWith("]")) return [type, 0];
+  const length = Number(type.slice(open + 1, -1));
+  return Number.isInteger(length) && length > 0 ? [type.slice(0, open), length] : [type, 0];
+}
+function flatten(param, structs, stack = []) {
+  if (!isNamed(param)) fail("parameter needs a name and a type");
+  if (Object.hasOwn(NATIVE_STRUCTS, param.type)) {
+    return NATIVE_STRUCTS[param.type].map(([field, type]) => ({
+      name: `${param.name}.${field}`,
+      type: argType(type)
+    }));
+  }
+  const declared = structs.find((struct) => struct?.name === param.type);
+  if (declared) {
+    if (stack.includes(param.type)) fail(`recursive struct layout '${param.type}'`);
+    return declared.fields.flatMap(
+      (field) => flatten({ name: `${param.name}.${field.name}`, type: field.type }, structs, [
+        ...stack,
+        param.type
+      ])
+    );
+  }
+  const [element, length] = arrayParts(param.type);
+  if (length === 0) {
+    if (param.type.includes("[") || param.type.includes("]")) {
+      fail(`invalid array type '${param.type}'`);
+    }
+    return [{ name: param.name, type: argType(param.type) }];
+  }
+  if (Object.hasOwn(NATIVE_STRUCTS, element) || structs.some((struct) => struct.name === element)) {
+    fail(`arrays of structs are not supported: '${param.type}'`);
+  }
+  return Array.from({ length }, (_, index) => ({
+    name: `${param.name}.${index}`,
+    type: argType(element)
+  }));
+}
+function opcodeToken(token) {
+  const base = token.slice(3);
+  const name = base === "0" || /^([1-9]|1[0-6])$/.test(base) ? token : base;
+  if (!Object.hasOwn(ARKADE_OPS, name)) {
+    fail(`opcode '${token}' is not in this SDK's table`);
+  }
+  return name;
+}
+function instantiationParam(body) {
+  return `contract_${body.replace(/[^A-Za-z0-9]+/g, "_")}`.replace(/_+$/, "");
+}
+function asmToken(token, instantiations) {
+  if (token.startsWith("OP_")) return opcodeToken(token);
+  if (token.startsWith("<") && token.endsWith(">")) {
+    const inner = token.slice(1, -1);
+    if (inner.startsWith("CONTRACT:")) {
+      const body = inner.slice("CONTRACT:".length);
+      const name = instantiationParam(body);
+      const seen = instantiations.get(name);
+      if (seen !== void 0 && seen !== body) {
+        fail(`instantiations '${seen}' and '${body}' both map to parameter '${name}'`);
+      }
+      instantiations.set(name, body);
+      return `$${name}`;
+    }
+    if (inner.startsWith("VTXO:")) {
+      fail(`'${token}' is not a placeholder; the compiler emits <CONTRACT:\u2026>`);
+    }
+    if (inner === "SERVER_KEY" || inner.startsWith("EMULATOR_KEY:")) {
+      fail(`${token} is a signer role and cannot appear in a covenant`);
+    }
+    return `$${inner}`;
+  }
+  if (token.startsWith("0x")) return hex.decode(token.slice(2));
+  try {
+    return BigInt(token);
+  } catch {
+    fail(`unrecognized assembly token '${token}'`);
+  }
+}
+function providedWitness(witness) {
+  if (witness === void 0) return [];
+  if (!Array.isArray(witness)) fail("leaf witness must be an array");
+  return witness.filter((item) => {
+    if (!isNamed(item)) fail("witness item needs a name and a type");
+    return !item.injected && item.type !== "signature";
+  });
+}
+function parseLeaf(leaf, hasCovenant, instantiations, extras) {
+  const asm = leaf.asm;
+  let index = 0;
+  let condition;
+  if (asm.length >= 4 && HASH_OPCODES.has(asm[0]) && asm[2] === "OP_EQUAL") {
+    if (asm[3] !== "OP_VERIFY")
+      fail(`leaf '${leaf.name}': hash condition must end in OP_VERIFY`);
+    condition = asm.slice(0, 3).map((token) => asmToken(token, instantiations));
+    index = 4;
+  }
+  let csv;
+  let cltv;
+  if (asm.length >= index + 3 && asm[index + 2] === "OP_DROP") {
+    const operand = asm[index].startsWith("<") && asm[index].endsWith(">") ? `$${asm[index].slice(1, -1)}` : BigInt(asm[index]);
+    if (asm[index + 1] === "OP_CHECKSEQUENCEVERIFY") csv = { type: "blocks", value: operand };
+    else if (asm[index + 1] === "OP_CHECKLOCKTIMEVERIFY") cltv = operand;
+    else fail(`leaf '${leaf.name}': unexpected timelock opcode ${asm[index + 1]}`);
+    index += 3;
+  }
+  const signers = [];
+  let emulator;
+  while (index < asm.length) {
+    const key = asm[index];
+    const terminator = asm[index + 1];
+    const last = terminator === "OP_CHECKSIG";
+    if (!last && terminator !== "OP_CHECKSIGVERIFY") {
+      fail(`leaf '${leaf.name}': expected CHECKSIG after '${key}', found '${terminator}'`);
+    }
+    if (!key.startsWith("<") || !key.endsWith(">")) {
+      fail(`leaf '${leaf.name}': unsupported key operand '${key}'`);
+    }
+    const inner = key.slice(1, -1);
+    if (inner === "SERVER_KEY") signers.push("$server");
+    else if (inner.startsWith("TWEAK:")) {
+      const [, base, fn] = inner.match(/^TWEAK:([^:]+):([^:]+)$/) ?? [];
+      if (!base || !fn) fail(`leaf '${leaf.name}': malformed tweak '${key}'`);
+      signers.push({ tweak: `$${base}`, fn });
+    } else if (inner.startsWith("EMULATOR_KEY:")) {
+      if (!hasCovenant) fail(`leaf '${leaf.name}': ${key} needs a covenant`);
+      if (!last) fail(`leaf '${leaf.name}': ${key} must be the last signer`);
+      emulator = inner.slice("EMULATOR_KEY:".length);
+    } else signers.push(`$${inner}`);
+    index += 2;
+  }
+  const constructorTweak = signers.some((signer) => typeof signer !== "string");
+  if (hasCovenant && emulator === void 0 && !constructorTweak) {
+    fail(
+      `leaf '${leaf.name}': covenant leaf must sign with the emulator or a tweaked constructor key`
+    );
+  }
+  if (signers.length === 0) fail(`leaf '${leaf.name}': at least one named signer is required`);
+  return {
+    signers,
+    ...emulator !== void 0 ? { emulator } : hasCovenant ? { emulator: null } : {},
+    ...condition ? { asm: condition } : {},
+    ...csv ? { csv } : {},
+    ...cltv !== void 0 ? { cltv } : {},
+    ...extras.length > 0 ? { witness: extras.map((item) => item.name) } : {}
+  };
+}
+function programFromArtifact(artifact) {
+  if (!isContractArtifact(artifact)) {
+    fail(
+      "expected a complete arkadec artifact with contractName, constructorInputs, and non-empty functions"
+    );
+  }
+  const structs = artifact.structs ?? [];
+  const structNames = /* @__PURE__ */ new Set();
+  for (const struct of structs) {
+    if (!isRecord(struct) || typeof struct.name !== "string") continue;
+    if (Object.hasOwn(SCALAR_TYPES, struct.name) || Object.hasOwn(NATIVE_STRUCTS, struct.name)) {
+      fail(`struct name '${struct.name}' shadows a built-in type`);
+    }
+    claim(structNames, struct.name, "struct");
+  }
+  const instantiations = /* @__PURE__ */ new Map();
+  const functions = {};
+  const groups = /* @__PURE__ */ new Set();
+  const leafNames = /* @__PURE__ */ new Set();
+  for (const group of artifact.functions) {
+    claim(groups, group.name, "spend group");
+    const covenantInputs = (group.arkade?.inputs ?? []).flatMap(
+      (input) => flatten(input, structs)
+    );
+    const arkadeScript = group.arkade ? {
+      asm: group.arkade.asm.map((token) => asmToken(token, instantiations)),
+      // Covenant witness is reverse declaration order.
+      witness: covenantInputs.map((field) => field.name).reverse()
+    } : void 0;
+    for (const [index, leaf] of group.leaves.entries()) {
+      const name = index === 0 ? group.name : `${group.name}/${index}:${leaf.name}`;
+      claim(leafNames, name, "function name");
+      const extras = providedWitness(leaf.witness);
+      const tapscript = parseLeaf(leaf, group.arkade !== void 0, instantiations, extras);
+      const inputs = [
+        ...covenantInputs,
+        ...extras.map((item) => ({ name: item.name, type: argType(item.type) }))
+      ];
+      functions[name] = {
+        ...inputs.length > 0 ? { inputs } : {},
+        tapscript,
+        ...arkadeScript ? { arkadeScript } : {}
+      };
+    }
+  }
+  const params = [
+    ...artifact.constructorInputs.flatMap((input) => flatten(input, structs)),
+    { name: "server", type: "pubkey" },
+    ...[...instantiations.keys()].map((name) => ({ name, type: "hash" }))
+  ];
+  const paramNames = /* @__PURE__ */ new Set();
+  for (const param of params) claim(paramNames, param.name, "program parameter");
+  return {
+    version: SUPPORTED_PROGRAM_VERSION,
+    name: artifact.contractName,
+    params,
+    functions
+  };
+}
 var Arkade = class _Arkade {
   arkProvider;
   /** The co-signing service, or undefined for emulator-less (pure tapscript) usage. */
@@ -23922,9 +24379,7 @@ var ArkadeContract = class _ArkadeContract {
       const [registered] = await manager.getContracts({ script: scriptHex });
       if (registered) {
         const [withVtxos] = await manager.getContractsWithVtxos({ script: scriptHex });
-        return (withVtxos?.vtxos ?? []).filter(
-          (v) => !hasTerminalSpend(v) && !v.isUnrolled
-        );
+        return (withVtxos?.vtxos ?? []).filter((v) => !isVtxoSpent(v) && !v.isUnrolled);
       }
     }
     if (!this.client.indexer) {
@@ -23934,7 +24389,7 @@ var ArkadeContract = class _ArkadeContract {
       scripts: [scriptHex],
       spendableOnly: true
     });
-    return vtxos.filter((v) => !hasTerminalSpend(v) && !v.isUnrolled);
+    return vtxos.filter((v) => !isVtxoSpent(v) && !v.isUnrolled);
   }
   /** Total spendable balance (requires an indexer). */
   async getBalance() {
@@ -24199,6 +24654,7 @@ var BIP21Error = /* @__PURE__ */ ((BIP21Error2) => {
   BIP21Error2["INVALID_ADDRESS"] = "Invalid address";
   return BIP21Error2;
 })(BIP21Error || {});
+var formatAmount = (btc) => btc.toFixed(8).replace(/\.?0+$/, "");
 var BIP21 = class _BIP21 {
   /**
    * Create a BIP21 URI from the provided parameters.
@@ -24220,7 +24676,7 @@ var BIP21 = class _BIP21 {
         if (amount < 0) {
           continue;
         }
-        queryParams[key] = value;
+        queryParams[key] = formatAmount(amount);
       } else if (key === "ark") {
         if (typeof value === "string" && (value.startsWith("ark") || value.startsWith("tark"))) {
           queryParams[key] = value;
@@ -24657,6 +25113,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, 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, OversizedChangeError, 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, assertNoSelection, 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, registerWalletRestoreHook, requiresMigration, resolveAssetAmount, resolveBatchExpiryPolicy, resolveCheckpointExitDelayPolicy, resolveDescriptorSigner, resolvePrevTxs, resolveSendAmount, rollbackMigration, saveVtxosForContract, scriptFromArkAddress, selectCoinsWithAsset, selectVirtualCoins, selectionOf, serializeAssets, serializeExitPackage, serializeUtxo, serializeVtxo, setupServiceWorker, signAndSubmitOffchainTx, signerSetFromInfo, signingDescriptorIndex, strictSigningDescriptorIndex, toXOnlySignerHex, tryResolveSendAmount, validateBatchRecipients, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, waitForIncomingFunds, walletFeeSource, warnAndFilterVtxosForScript, withPrevTxs };
-//# sourceMappingURL=chunk-FTLPTF3R.js.map
-//# sourceMappingURL=chunk-FTLPTF3R.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, 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, OversizedChangeError, 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, assertNoSelection, 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, registerWalletRestoreHook, requiresMigration, resolveAssetAmount, resolveBatchExpiryPolicy, resolveCheckpointExitDelayPolicy, resolveDescriptorSigner, resolvePrevTxs, resolveSendAmount, rollbackMigration, saveVtxosForContract, scriptFromArkAddress, selectCoinsWithAsset, selectVirtualCoins, selectionOf, serializeAssets, serializeExitPackage, serializeUtxo, serializeVtxo, setupServiceWorker, signAndSubmitOffchainTx, signerSetFromInfo, signingDescriptorIndex, strictSigningDescriptorIndex, toXOnlySignerHex, tryResolveSendAmount, validateBatchRecipients, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, waitForIncomingFunds, walletFeeSource, warnAndFilterVtxosForScript, withPrevTxs };
+//# sourceMappingURL=chunk-MLOZHTBN.js.map
+//# sourceMappingURL=chunk-MLOZHTBN.js.map