@arkade-os/sdk 0.4.49 → 0.4.50

package/dist/{chunk-5QVBJUOG.js → chunk-SNTSB6M2.js}

@@ -1,4 +1,4 @@
-import { Transaction, setArkPsbtField, PrevArkTxField, ConditionWitness, AssetId, AssetGroup, AssetInput, AssetOutput, Metadata, Packet, craftToSpendTx, getArkPsbtFields, CosignerPublicKey, BufferReader, BufferWriter, OP_RETURN_EMPTY_PKSCRIPT, VtxoTaprootTree, baseFetch, Intent, rateGate, maybeArkError, isArkError, ArkErrorName, ProviderUnavailableError, FetchError, isFetchTimeoutError, AssetRef, isEventSourceError, RestArkProvider, RestIndexerProvider, ArkError } from './chunk-CPO2UB7L.js';
+import { Transaction, setArkPsbtField, PrevArkTxField, ConditionWitness, AssetId, AssetGroup, AssetInput, AssetOutput, Metadata, Packet, craftToSpendTx, getArkPsbtFields, CosignerPublicKey, BufferReader, BufferWriter, OP_RETURN_EMPTY_PKSCRIPT, VtxoTaprootTree, baseFetch, Intent, rateGate, maybeArkError, isArkError, ArkErrorName, ProviderUnavailableError, FetchError, isFetchTimeoutError, AssetRef, isEventSourceError, RestArkProvider, RestIndexerProvider, ArkError } from './chunk-AA4Q2J57.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, inputName, contractHandlers, isMainnetDescriptor, descriptorIsOurs, DefaultVtxo, DelegateVtxo, WALLET_RECEIVE_SOURCE, deriveDescriptorLeafPubKey, BoardingContractHandler } from './chunk-MBSYQ3WX.js';
 import { VtxoScript, isRecoverable, CSVMultisigTapscript, DEFAULT_NETWORK, hasTerminalSpend, getNormalizedVtxos, isVirtualCoin, ArkAddress, sequenceToTimelock, decodeTapscript, scriptFromTapLeafScript, CLTVMultisigTapscript, timelockToSequence, DEFAULT_NETWORK_NAME, normalizeVtxo, getSequence, toBatchExpiry, toOffchainInputFeeParams, canRecoverOnchain, getNetwork, MultisigTapscript, getAllNormalizedVtxos, DEFAULT_PAGE_SIZE, canSpendOffchain, toVirtualStatus, resolveTimeHeight, parseLegacyExpiry, networks as networks$1, isExpired, DEFAULT_ARKADE_SERVER_URL, isPastExpiry } from './chunk-EFNLTS6Q.js';
 import { __export } from './chunk-NSBPE2FW.js';
@@ -8114,10 +8114,10 @@ var ContractWatcher = class {
   /**
    * Add a contract to be watched.
    *
-   * Active contracts are immediately subscribed.
+   * Once watching, every contract is subscribed and polled whatever
+   * its state.
    *
-   * All contracts are polled to discover any existing virtual outputs
-   * (which may cause them to be watched even if inactive).
+   * @see getWatchedContracts
    */
   async addContract(contract) {
     const state = {
@@ -8185,18 +8185,18 @@ var ContractWatcher = class {
     return Array.from(this.contracts.values()).map((s) => s.contract);
   }
   /**
-   * Contracts the watcher is actually tracking:
-   * - all active contracts, plus
-   * - inactive contracts that still hold known virtual outputs
-   *   (the subscription keeps watching them so `vtxo_spent` events for
-   *   those unspent outputs are still observed).
+   * Every registered contract, retired (`inactive`) ones included.
    *
-   * This is the single source of truth for "contracts whose VTXO state
-   * we still care about" — callers and the subscription itself fan out
-   * over the same set so nothing is reconciled that isn't also watched.
+   * Feeds both the subscription and the indexer sweep scope, so
+   * narrowing it drops a contract from every background channel at
+   * once. Nothing may be narrowed out: an Ark receive address can be
+   * paid again after the wallet has rotated past it, and a payment
+   * that lands outside every background channel is invisible until
+   * some foreground read happens to sweep it. Retirement therefore
+   * governs receive-address selection, not coverage.
    */
   getWatchedContracts() {
-    return Array.from(this.contracts.values()).filter((s) => s.contract.state === "active" || s.lastKnownVtxos.size > 0).map((s) => s.contract);
+    return this.getAllContracts();
   }
   /**
    * Get virtual outputs for contracts, grouped by contract script.
@@ -8225,7 +8225,7 @@ var ContractWatcher = class {
     return new Map(results.flat(1));
   }
   /**
-   * Start watching for virtual output events across all active contracts.
+   * Start watching for virtual output events across all watched contracts.
    */
   async startWatching(callback) {
     if (this.isWatching) {
@@ -8276,7 +8276,7 @@ var ContractWatcher = class {
     return this.connectionState;
   }
   /**
-   * Force a poll of all active contracts.
+   * Force a poll of all watched contracts.
    * Useful for manual refresh or after app resume.
    */
   async forcePoll() {
@@ -8464,7 +8464,7 @@ var ContractWatcher = class {
   /**
    * Update the subscription with scripts that should be watched.
    *
-   * Watches both active contracts and contracts with virtual outputs.
+   * @see getWatchedContracts
    */
   async updateSubscription() {
     const scriptsToWatch = this.getWatchedContracts().map((c) => c.script);
@@ -8737,8 +8737,8 @@ var ContractManager = class _ContractManager {
    * Static factory method for creating a new ContractManager.
    * Initialize the manager by loading persisted contracts and starting to watch.
    *
-   * After initialization, the manager automatically watches all active contracts
-   * and contracts with virtual outputs. Use `onContractEvent()` to register event callbacks.
+   * After initialization, the manager automatically watches every persisted
+   * contract. Use `onContractEvent()` to register event callbacks.
    *
    * @param config ContractManagerConfig
    */
@@ -9185,13 +9185,17 @@ var ContractManager = class _ContractManager {
     return updated;
   }
   /**
-   * Set a contract's state.
+   * Set a contract's state. Retiring (`inactive`) keeps it watched;
+   * see {@link ContractState}. To stop watching, use
+   * {@link deleteContract}.
    */
   async setContractState(script, state) {
     await this.updateContract(script, { state });
   }
   /**
-   * Delete a contract.
+   * Delete a contract. Also removes it from the watcher — the only way
+   * to stop watching a contract (retiring it via
+   * {@link setContractState} does not).
    *
    * @param script - Contract script
    */
@@ -9266,22 +9270,10 @@ var ContractManager = class _ContractManager {
   /**
    * Force refresh virtual outputs from the indexer.
    *
-   * Without options, re-fetches every contract in the watcher's
-   * watched set and advances the global cursor.
-   *
-   * `scripts` narrows the refresh to a specific list (subset query —
-   * cursor is not advanced because contracts outside the list may
-   * have data we'd skip).
-   *
-   * `includeInactive: true` (and no `scripts`) widens the refresh to
-   * every contract in the repository, including ones marked
-   * `inactive` and ones that have dropped out of the watcher's
-   * active set. This is a *superset* of the watched set, so the
-   * cursor invariant still holds and the cursor advances normally.
-   *
-   * `after` / `before` apply a caller-supplied time window. The
-   * cursor never advances on a windowed query because the window
-   * may skip data outside its bounds.
+   * Without options, re-fetches the watcher's watched set and
+   * advances the global cursor. Each option narrows or widens that
+   * scope and may hold the cursor back — see
+   * {@link RefreshVtxosOptions}.
    */
   async refreshVtxos(opts) {
     const contracts = opts?.scripts ? await this.getContracts({ script: opts.scripts }) : void 0;
@@ -9397,11 +9389,10 @@ var ContractManager = class _ContractManager {
    * Sync virtual outputs for the given contracts against the indexer.
    *
    * When `options.contracts` is omitted the sync covers the full
-   * watched set (active contracts plus any inactive contracts still
-   * holding cached VTXOs) and the global cursor is advanced on
-   * success. Passing an explicit subset leaves the cursor alone so a
-   * narrow poll can't hide data that other contracts still need to
-   * pick up.
+   * watched set ({@link ContractWatcher.getWatchedContracts}) and the
+   * global cursor is advanced on success. Passing an explicit subset
+   * leaves the cursor alone so a narrow poll can't hide data that
+   * other contracts still need to pick up.
    */
   async syncContracts(options) {
     const cursor = await getSyncCursor(this.config.walletRepository);
@@ -19887,5 +19878,5 @@ function isArkContract(str) {
 }
 
 export { ARKADE_MAGIC, ActivityRegistry, ArkNote, ArkadeCash, ArkadeCashCreateError, AssetManager, BIP322, Batch, ChainedTxType, ContractManager, ContractRepositoryImpl, ContractWatcher, DB_VERSION, DEFAULT_MESSAGE_TIMEOUTS, DelegateManagerImpl, DelegateNotConfiguredError, DelegatorManagerImpl, DelegatorNotConfiguredError, DescriptorSigningProviderMissingError, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, ESPLORA_URL, ElectrumOnchainProvider, EmulatorPacket, EsploraProvider, Estimator, Extension, ExtensionNotFoundError, HDDescriptorProvider, INTENT_TERMINAL_STATES, InMemoryContractRepository, InMemoryIntentRepository, InMemoryVirtualTxRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBIntentRepository, IndexedDBVirtualTxRepository, 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, RestEmulatorProvider, SeedIdentity, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, SingleKey, TxTree, TxType, TxWeightEstimator, UnilateralExit, UnknownPacket, Unroll, VtxoManager, Wallet2 as Wallet, WalletMessageHandler, WalletNotInitializedError, WalletRepositoryImpl, WsElectrumChainSource, arkade_exports, assertIntentIdUnique, boardingResolver, buildForfeitTx, buildOffchainTx, classifyAgainstSignerSet, classifyContractSigner, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, createAssetPacket, createDefaultActivityRegistry, createExitChainResolver, decodeArkContract, deserializeAssets, deserializeExitPackage, deserializeUtxo, deserializeVtxo, encodeArkContract, extendVirtualCoinForContract, getMigrationStatus, getRandomId, hasBoardingTxExpired, intentMatchesFilter, intentPageBounds, isArkContract, isBatchSignable, isCooperativelyMigratable, isDiscoverable, isRetryableProviderError, isSubdust, isTerminalIntentState, isValidArkAddress, isVtxoExpiringSoon, isVtxoForScript, mergeChainedTxType, migrateWalletRepository, openDatabase, requiresMigration, rollbackMigration, saveVtxosForContract, scriptFromArkAddress, selectCoinsWithAsset, selectVirtualCoins, serializeAssets, serializeExitPackage, serializeUtxo, serializeVtxo, setupServiceWorker, signerSetFromInfo, toXOnlySignerHex, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, waitForIncomingFunds, warnAndFilterVtxosForScript };
-//# sourceMappingURL=chunk-5QVBJUOG.js.map
-//# sourceMappingURL=chunk-5QVBJUOG.js.map
+//# sourceMappingURL=chunk-SNTSB6M2.js.map
+//# sourceMappingURL=chunk-SNTSB6M2.js.map