@arkade-os/sdk 0.4.40 → 0.4.42

package/dist/{chunk-I2O4Q2EL.js → chunk-V3FCNVJE.js}

@@ -1,6 +1,6 @@
-import { craftToSpendTx, Transaction, OP_RETURN_EMPTY_PKSCRIPT, baseFetch, Intent, getArkPsbtFields, CosignerPublicKey, setArkPsbtField, VtxoTaprootTree, maybeArkError, AssetRef, AssetId, AssetOutput, AssetGroup, AssetInput, Packet, Metadata, isEventSourceError, RestArkProvider, RestIndexerProvider, ArkError, BufferReader } from './chunk-GF6NPAOJ.js';
-import { isMainnetDescriptor, descriptorIsOurs, contractHandlers, DEFAULT_PAGE_SIZE, DelegateVtxo, WALLET_RECEIVE_SOURCE, deriveDescriptorLeafPubKey, DefaultVtxo, BoardingContractHandler } from './chunk-CUSABEUQ.js';
-import { VtxoScript, timelockToSequence, DEFAULT_NETWORK, DEFAULT_NETWORK_NAME, decodeTapscript, scriptFromTapLeafScript, CLTVMultisigTapscript, ArkAddress, CSVMultisigTapscript, getSequence, getNetwork, MultisigTapscript, networks as networks$1, DEFAULT_ARKADE_SERVER_URL } from './chunk-OUVTG72A.js';
+import { craftToSpendTx, Transaction, OP_RETURN_EMPTY_PKSCRIPT, baseFetch, Intent, getArkPsbtFields, CosignerPublicKey, setArkPsbtField, VtxoTaprootTree, maybeArkError, AssetRef, AssetId, AssetOutput, AssetGroup, AssetInput, Packet, Metadata, isEventSourceError, RestArkProvider, RestIndexerProvider, ArkError, BufferReader } from './chunk-5X5YMZHB.js';
+import { isMainnetDescriptor, descriptorIsOurs, contractHandlers, DEFAULT_PAGE_SIZE, DelegateVtxo, WALLET_RECEIVE_SOURCE, deriveDescriptorLeafPubKey, DefaultVtxo, BoardingContractHandler } from './chunk-YNEDJTX2.js';
+import { VtxoScript, timelockToSequence, DEFAULT_NETWORK, DEFAULT_NETWORK_NAME, decodeTapscript, scriptFromTapLeafScript, CLTVMultisigTapscript, ArkAddress, CSVMultisigTapscript, getSequence, getNetwork, MultisigTapscript, networks as networks$1, DEFAULT_ARKADE_SERVER_URL } from './chunk-BE5MUB7T.js';
 import { sha256, hash160, sha256x2, concatBytes, randomPrivateKeyBytes, pubECDSA, pubSchnorr, equalBytes as equalBytes$1 } from '@scure/btc-signer/utils.js';
 import { SigHash, Script, p2tr, RawWitness, Address, OutScript, p2wpkh, TaprootControlBlock, DEFAULT_SEQUENCE, Transaction as Transaction$2 } from '@scure/btc-signer';
 import { hex, base58, base64 } from '@scure/base';
@@ -1678,6 +1678,122 @@ function validateAssetGroupOutput(packet, outputIndex, assetId, expectedAmount)
   }
 }
 
+// src/wallet/activity.ts
+async function buildActivities(txs, resolvers) {
+  const preparedResolvers = (await Promise.all(
+    resolvers.map(async (r) => {
+      try {
+        await r.prepare?.();
+        return r;
+      } catch {
+        return void 0;
+      }
+    })
+  )).filter((r) => r !== void 0);
+  const keyOf = (tx) => tx.key.arkTxid || tx.key.commitmentTxid || tx.key.boardingTxid;
+  const merge = (a, b) => ({
+    groupId: a.groupId,
+    label: a.label ?? b.label,
+    kind: a.kind ?? b.kind,
+    metadata: { ...b.metadata, ...a.metadata },
+    amount: a.amount ?? b.amount
+  });
+  const isSent = (tx) => tx.type === "SENT" /* TxSent */;
+  const signedAmount = (tx, amount = tx.amount) => {
+    const magnitude = Math.abs(amount);
+    return isSent(tx) ? -magnitude : magnitude;
+  };
+  const buckets = /* @__PURE__ */ new Map();
+  for (const tx of txs) {
+    const perGroup = /* @__PURE__ */ new Map();
+    for (const r of preparedResolvers) {
+      let ms;
+      try {
+        ms = r.resolve(tx);
+      } catch {
+        ms = void 0;
+      }
+      for (const m of ms ?? []) {
+        if (!m.groupId) continue;
+        if (m.amount !== void 0 && !Number.isFinite(m.amount)) continue;
+        const existing = perGroup.get(m.groupId);
+        perGroup.set(m.groupId, existing ? merge(existing, m) : { ...m });
+      }
+    }
+    if (perGroup.size === 0) {
+      const id = keyOf(tx);
+      const b = buckets.get(id) ?? { members: [] };
+      b.members.push({ tx, amount: signedAmount(tx) });
+      buckets.set(id, b);
+      continue;
+    }
+    for (const m of perGroup.values()) {
+      const b = buckets.get(m.groupId) ?? { members: [] };
+      b.intent = {
+        label: b.intent?.label ?? m.label,
+        kind: b.intent?.kind ?? m.kind,
+        metadata: { ...m.metadata, ...b.intent?.metadata }
+      };
+      b.members.push({ tx, amount: signedAmount(tx, m.amount ?? tx.amount) });
+      buckets.set(m.groupId, b);
+    }
+  }
+  const netAmount = (members) => {
+    const sentKeys = new Set(members.filter((x) => isSent(x.tx)).map((x) => keyOf(x.tx)));
+    return members.reduce((s, x) => {
+      if (!isSent(x.tx) && sentKeys.has(keyOf(x.tx))) return s;
+      return s + x.amount;
+    }, 0);
+  };
+  const latest = (a) => a.txs[a.txs.length - 1].createdAt;
+  return [...buckets.entries()].map(([id, b]) => {
+    const members = [...b.members].sort((x, y) => x.tx.createdAt - y.tx.createdAt);
+    return {
+      id,
+      intent: b.intent,
+      txs: members.map((x) => x.tx),
+      amount: netAmount(members),
+      createdAt: members[0].tx.createdAt,
+      settled: members.every((x) => x.tx.settled)
+    };
+  }).sort((a, c) => latest(c) - latest(a));
+}
+var ActivityRegistry = class {
+  resolvers = /* @__PURE__ */ new Map();
+  /** Add a resolver, or override an existing one with the same id (kept in place). */
+  use(resolver) {
+    this.resolvers.set(resolver.id, resolver);
+  }
+  /** Remove a resolver (built-in or custom) by id. */
+  remove(id) {
+    this.resolvers.delete(id);
+  }
+  /** The registered resolver ids, in registration order. */
+  list() {
+    return [...this.resolvers.keys()];
+  }
+  /** All registered resolvers, in registration (priority) order. */
+  all() {
+    return [...this.resolvers.values()];
+  }
+};
+function boardingResolver() {
+  return {
+    id: "boarding",
+    resolve(tx) {
+      if (!tx.key.boardingTxid) return void 0;
+      return [
+        { groupId: `boarding:${tx.key.boardingTxid}`, label: "Deposit", kind: "boarding" }
+      ];
+    }
+  };
+}
+function createDefaultActivityRegistry() {
+  const registry = new ActivityRegistry();
+  registry.use(boardingResolver());
+  return registry;
+}
+
 // src/wallet/index.ts
 var TxType = /* @__PURE__ */ ((TxType2) => {
   TxType2["TxSent"] = "SENT";
@@ -5605,7 +5721,13 @@ async function openDatabase(dbName, dbVersion, initDatabase2) {
       reject(request.error);
     };
     request.onsuccess = () => {
-      resolve(request.result);
+      const db = request.result;
+      db.onversionchange = () => {
+        db.close();
+        dbCache.delete(dbName);
+        refCounts.delete(dbName);
+      };
+      resolve(db);
     };
     request.onupgradeneeded = (event) => {
       const db = request.result;
@@ -6994,7 +7116,7 @@ var ContractWatcher = class {
         this.subscriptionId
       );
     } catch (error) {
-      const isStale = error instanceof Error && /subscription\s+\S+\s+not\s+found/i.test(error.message);
+      const isStale = error instanceof Error && /subscription\b.*\bnot\s+found/i.test(error.message);
       if (this.subscriptionId && isStale) {
         this.subscriptionId = void 0;
         this.subscriptionId = await this.config.indexerProvider.subscribeForScripts(scriptsToWatch);
@@ -8655,6 +8777,8 @@ var ReadonlyWallet = class _ReadonlyWallet {
   // already on their way out. The set is in-memory only: a process crash
   // clears it, and a stale entry only hides a VTXO (never spends one).
   _pendingSpendOutpoints = /* @__PURE__ */ new Set();
+  /** Activity resolvers consumed by {@link getActivityHistory}. */
+  activity = createDefaultActivityRegistry();
   get assetManager() {
     return this._assetManager;
   }
@@ -8860,7 +8984,7 @@ var ReadonlyWallet = class _ReadonlyWallet {
       type: info.boardingExitDelay < 512n ? "blocks" : "seconds"
     };
     const serverPubKey = hex.decode(info.signerPubkey).slice(1);
-    const delegatePubKey = config.delegateProvider ? await config.delegateProvider.getDelegateInfo().then((info2) => hex.decode(info2.pubkey).slice(1)) : config.delegatorProvider ? await config.delegatorProvider.getDelegateInfo().then((info2) => hex.decode(info2.pubkey).slice(1)) : void 0;
+    const delegatePubKey = config.delegateProvider ? await config.delegateProvider.getDelegateInfo().then((info2) => hex.decode(info2.pubkey).slice(1)).catch(() => void 0) : config.delegatorProvider ? await config.delegatorProvider.getDelegateInfo().then((info2) => hex.decode(info2.pubkey).slice(1)).catch(() => void 0) : void 0;
     const offchainOptions = {
       pubKey,
       serverPubKey,
@@ -9051,6 +9175,13 @@ var ReadonlyWallet = class _ReadonlyWallet {
     const getTxCreatedAt = (txid) => this.indexerProvider.getVtxos({ outpoints: [{ txid, vout: 0 }] }).then((res) => res.vtxos[0]?.createdAt.getTime());
     return buildTransactionHistory(allVtxos, boardingTxs, commitmentsToIgnore, getTxCreatedAt);
   }
+  /**
+   * Wallet history grouped by registered activity resolvers. With no resolver match,
+   * rows bucket by transaction key so send/change pairs stay together.
+   */
+  async getActivityHistory() {
+    return buildActivities(await this.getTransactionHistory(), this.activity.all());
+  }
   /**
    * Clear the global VTXO sync cursor, forcing a full re-bootstrap on next sync.
    * Useful for recovery after indexer reprocessing or debugging.
@@ -9058,6 +9189,17 @@ var ReadonlyWallet = class _ReadonlyWallet {
   async clearSyncCursor() {
     await clearSyncCursor(this.walletRepository);
   }
+  /**
+   * Wipe all locally persisted wallet data (VTXOs, UTXOs, history, sync
+   * cursor, contracts). Create a fresh wallet instance afterward.
+   */
+  async clear() {
+    try {
+      await this.dispose();
+    } finally {
+      await Promise.all([this.walletRepository.clear(), this.contractRepository.clear()]);
+    }
+  }
   /**
    * The on-chain (P2TR) addresses of every boarding tapscript this wallet
    * uses — the current address plus any historical rotated boarding
@@ -10536,6 +10678,9 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
           settlementPsbt = await this._signerRouter.sign(settlementPsbt, [
             { index: i, lookupScript: script }
           ]);
+          if (!settlementPsbt.getInput(i).tapScriptSig?.length) {
+            throw new Error(await this.unsignableBoardingInputError(input, script));
+          }
           hasBoardingUtxos = true;
           break;
         }
@@ -10600,6 +10745,24 @@ var Wallet2 = class _Wallet extends ReadonlyWallet {
       );
     }
   }
+  // Best-effort: every enrichment is guarded so a secondary failure can't
+  // mask the original signing error.
+  async unsignableBoardingInputError(input, script) {
+    const scriptHex = hex.encode(script);
+    let unresolvedAddress = "<undecodable>";
+    try {
+      unresolvedAddress = Address(this.network).encode(OutScript.decode(script));
+    } catch {
+    }
+    let recognized = "<unavailable>";
+    try {
+      const current = await this.getBoardingAddress();
+      const all = await this.getBoardingAddresses();
+      recognized = `current=${current}; all=[${all.join(", ")}]`;
+    } catch {
+    }
+    return `failed to sign boarding input ${input.txid}:${input.vout}: signer did not recognize script ${scriptHex} (${unresolvedAddress}); would have reached arkd unsigned and been rejected as "not a wallet script". Recognized boarding addresses: ${recognized}. Likely a rotated boarding address with a missing contract row.`;
+  }
   /**
    * Create a batch event handler for settlement flows.
    *
@@ -13188,26 +13351,19 @@ var WalletMessageHandler = class {
     });
     return filteredVtxos;
   }
+  /** Tear down handler subscriptions, then delegate the full wipe to the wallet. */
   async clear() {
-    if (!this.readonlyWallet) return;
-    if (this.incomingFundsSubscription) this.incomingFundsSubscription();
+    const wallet = this.wallet ?? this.readonlyWallet;
+    if (!wallet) return;
+    if (this.incomingFundsSubscription) {
+      this.incomingFundsSubscription();
+      this.incomingFundsSubscription = void 0;
+    }
     if (this.contractEventsSubscription) {
       this.contractEventsSubscription();
       this.contractEventsSubscription = void 0;
     }
-    try {
-      if (this.wallet) {
-        await this.wallet.dispose();
-      } else {
-        await this.readonlyWallet.dispose();
-      }
-    } catch (_) {
-    }
-    try {
-      await this.walletRepository?.clear();
-    } catch (_) {
-      console.warn("Failed to clear vtxos from wallet repository");
-    }
+    await wallet.clear();
     this.wallet = void 0;
     this.readonlyWallet = void 0;
     this.arkProvider = void 0;
@@ -13498,6 +13654,7 @@ var ServiceWorkerReadonlyWallet = class _ServiceWorkerReadonlyWallet {
   walletRepository;
   contractRepository;
   identity;
+  activity = createDefaultActivityRegistry();
   _readonlyAssetManager;
   initConfig = null;
   initWalletPayload = null;
@@ -13856,19 +14013,13 @@ var ServiceWorkerReadonlyWallet = class _ServiceWorkerReadonlyWallet {
       );
     }
   }
-  /** Clear cached wallet state from both the page and service worker storage. */
+  /** This tells the service worker to wipe all locally persisted wallet data. */
   async clear() {
     const message = {
       id: getRandomId(),
       tag: this.messageTag,
       type: "CLEAR"
     };
-    try {
-      const address = await this.getAddress();
-      await this.walletRepository.deleteVtxos(address);
-    } catch (_) {
-      console.warn("Failed to clear vtxos from wallet repository");
-    }
     await this.sendMessage(message);
   }
   async getAddress() {
@@ -13941,6 +14092,9 @@ var ServiceWorkerReadonlyWallet = class _ServiceWorkerReadonlyWallet {
       throw new Error(`Failed to get status: ${error}`);
     }
   }
+  async getActivityHistory() {
+    return buildActivities(await this.getTransactionHistory(), this.activity.all());
+  }
   async getTransactionHistory() {
     const message = {
       id: getRandomId(),
@@ -15944,6 +16098,6 @@ function isArkContract(str) {
   return str.startsWith(ARKCONTRACT_PREFIX + "=");
 }
 
-export { ArkNote, AssetManager, BIP322, Batch, ContractManager, ContractRepositoryImpl, ContractWatcher, DB_VERSION, DEFAULT_MESSAGE_TIMEOUTS, DelegateManagerImpl, DelegateNotConfiguredError, DelegatorManagerImpl, DelegatorNotConfiguredError, DescriptorSigningProviderMissingError, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, ESPLORA_URL, ElectrumOnchainProvider, EsploraProvider, Estimator, HDDescriptorProvider, InMemoryContractRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBWalletRepository, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, MissingSigningDescriptorError, MnemonicIdentity, OnchainWallet, P2A, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, RestDelegateProvider, RestDelegatorProvider, SeedIdentity, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, SingleKey, TxTree, TxType, TxWeightEstimator, Unroll, VtxoManager, Wallet2 as Wallet, WalletMessageHandler, WalletNotInitializedError, WalletRepositoryImpl, WsElectrumChainSource, buildForfeitTx, buildOffchainTx, classifyAgainstSignerSet, classifyContractSigner, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, decodeArkContract, deserializeAssets, deserializeUtxo, deserializeVtxo, encodeArkContract, extendVirtualCoinForContract, getMigrationStatus, getRandomId, hasBoardingTxExpired, isArkContract, isBatchSignable, isCooperativelyMigratable, isDiscoverable, isExpired, isRecoverable, isSpendable, isSubdust, isValidArkAddress, isVtxoExpiringSoon, isVtxoForScript, migrateWalletRepository, openDatabase, requiresMigration, rollbackMigration, saveVtxosForContract, scriptFromArkAddress, serializeAssets, serializeUtxo, serializeVtxo, setupServiceWorker, signerSetFromInfo, toXOnlySignerHex, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, waitForIncomingFunds, warnAndFilterVtxosForScript };
-//# sourceMappingURL=chunk-I2O4Q2EL.js.map
-//# sourceMappingURL=chunk-I2O4Q2EL.js.map
+export { ActivityRegistry, ArkNote, AssetManager, BIP322, Batch, ContractManager, ContractRepositoryImpl, ContractWatcher, DB_VERSION, DEFAULT_MESSAGE_TIMEOUTS, DelegateManagerImpl, DelegateNotConfiguredError, DelegatorManagerImpl, DelegatorNotConfiguredError, DescriptorSigningProviderMissingError, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, ESPLORA_URL, ElectrumOnchainProvider, EsploraProvider, Estimator, HDDescriptorProvider, InMemoryContractRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBWalletRepository, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, MissingSigningDescriptorError, MnemonicIdentity, OnchainWallet, P2A, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, RestDelegateProvider, RestDelegatorProvider, SeedIdentity, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, SingleKey, TxTree, TxType, TxWeightEstimator, Unroll, VtxoManager, Wallet2 as Wallet, WalletMessageHandler, WalletNotInitializedError, WalletRepositoryImpl, WsElectrumChainSource, boardingResolver, buildForfeitTx, buildOffchainTx, classifyAgainstSignerSet, classifyContractSigner, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, createDefaultActivityRegistry, decodeArkContract, deserializeAssets, deserializeUtxo, deserializeVtxo, encodeArkContract, extendVirtualCoinForContract, getMigrationStatus, getRandomId, hasBoardingTxExpired, isArkContract, isBatchSignable, isCooperativelyMigratable, isDiscoverable, isExpired, isRecoverable, isSpendable, isSubdust, isValidArkAddress, isVtxoExpiringSoon, isVtxoForScript, migrateWalletRepository, openDatabase, requiresMigration, rollbackMigration, saveVtxosForContract, scriptFromArkAddress, serializeAssets, serializeUtxo, serializeVtxo, setupServiceWorker, signerSetFromInfo, toXOnlySignerHex, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, waitForIncomingFunds, warnAndFilterVtxosForScript };
+//# sourceMappingURL=chunk-V3FCNVJE.js.map
+//# sourceMappingURL=chunk-V3FCNVJE.js.map