@arkade-os/sdk 0.4.64 → 0.4.65

package/dist/index.d.cts

@@ -2,8 +2,8 @@ import { a2 as ReadonlyIdentity, a as Identity, ap as DescriptorSigningRequest,
 export { aW as ActivityIntent, aX as ActivityResolver, ac as ArkInfo, aY as ArkIntentState, aZ as ArkTapscript, a_ as AssetMetadata, a$ as BITCOIN_EMULATOR_PUBKEY, b0 as BaseWalletConfig, _ as BatchFailedEvent, Y as BatchFinalizationEvent, Z as BatchFinalizedEvent, b1 as BatchInfo, b2 as BatchSignableIdentity, P as BatchStartedEvent, b3 as CLTVMultisigTapscript, b4 as CandidateDeps, b5 as ChainTxType, J as ChainedTxType, b6 as CommitmentTx, b7 as ConditionCSVMultisigTapscript, b8 as ConditionMultisigTapscript, b9 as ContractBalance, ba as ContractEventCallback, bb as ContractHandler, ah as ContractManager, ai as ContractManagerConfig, bc as ContractState, bd as ContractVtxo, be as ContractWatcher, bf as DelegateManagerImpl, bg as DelegateOptions, a4 as DelegateProvider, bh as DelegatorManagerImpl, bi as DelegatorProvider, bj as DeprecatedSignerMigrationReport, bk as DeprecatedSignerReport, bl as DigestMismatchError, bm as Discoverable, bn as DiscoveredContract, bo as DiscoveryDeps, bp as ESPLORA_URL, bq as EsploraProvider, br as EventSourceCapable, bs as EventSourceFactory, bt as EventSourceLike, bu as EventSourceUnavailableError, a6 as ExitCaptureMode, bv as ExitChainResolver, a7 as ExitDataSource, bw as ExtendedContractVtxo, bx as GroupMembership, by as HandlerError, bz as IDelegatorManager, bA as INTENT_TERMINAL_STATES, bB as IndexerTxType, bC as KnownMetadata, bD as MUTINYNET_EMULATOR_PUBKEY, bE as MigrateDeprecatedSignerOptions, bF as MigrationLegReport, bG as MigrationVtxoRef, bH as MultisigTapscript, bI as Nonces, bJ as Output, bK as PageResponse, bL as PaginationOptions, bM as PartialSig, bN as ProviderClass, bO as REGTEST_EMULATOR_PUBKEY, a5 as ReadonlyWalletConfig, l as RestArkProvider, bP as RestDelegateProvider, bQ as RestDelegatorProvider, m as RestIndexerProvider, bR as ScanContractsOptions, bS as ScanResult, bT as ScheduledSession, bU as SettlementEventType, bV as SignRequest, am as SignedIntent, bW as SignerClassification, bX as SignerSet, bY as SubscriptionEvent, bZ as SubscriptionHeartbeat, n as SubscriptionResponse, b_ as TapLeaves, b$ as TapTreeCoder, c0 as TapscriptType, ao as TimeHeight, c1 as TreeNonces, X as TreeNoncesEvent, c2 as TreePartialSigs, a0 as TreeSignatureEvent, Q as TreeSigningStartedEvent, $ as TreeTxEvent, c3 as Tx, c4 as TxHistoryRecord, c5 as TxKey, T as TxNotification, c6 as TxTag, c7 as TxTreeNode, c8 as TxType, c9 as VirtualStatus, ca as Vtxo, cb as VtxoChain, ak as VtxoManager, cc as VtxoType, b as WalletConfig, cd as WalletMode, ce as assetMintResolver, cf as boardingResolver, cg as canRecoverOnchain, ch as canSpendOffchain, ci as classifyAgainstSignerSet, cj as classifyContractSigner, ck as collabExitResolver, cl as configureEventSource, cm as createDefaultActivityRegistry, cn as createExitChainResolver, co as decodeTapscript, cp as defaultEmulatorPubkey, cq as getConfiguredEventSource, cr as getNetwork, cs as getRandomId, ct as getSequence, cu as hasCandidates, cv as hasTerminalSpend, cw as isBatchSignable, cx as isCooperativelyMigratable, cy as isDiscoverable, cz as isEventSourceUnavailableError, cA as isExpired, cB as isPastExpiry, cC as isRecoverable, cD as isSigningIdentity, cE as isSpendable, cF as isSubdust, cG as isTerminalIntentState, cH as isVirtualCoin, cI as isVtxoExpiringSoon, cJ as networks, cK as resolveEmulatorPubkey, cL as resolveEventSource, cM as scriptFromTapLeafScript, cN as signerSetFromInfo, cO as toXOnlySignerHex } from './index-CFOMyVMt.cjs';
 import { W as Wallet, R as ReadonlyWallet, b as ReceiveRotatorFactory, c as ReceiveRotatorBootOpts, d as ReceiveRotatorBoot, P as ProviderConnectionState, H as HDWalletCapable, a as HDAllocationCapable, B as BatchExpiryPolicy, e as Batch } from './wallet-C2NvHjWB.cjs';
 export { A as ArkError, f as ArkErrorName, g as ArkadeCashClaimResult, h as ArkadeCashCreateError, i as ArkadeCashUnclaimedReason, j as ArkadeCashUnclaimedVtxo, k as BoardingUtxoGroup, C as CheckpointExitDelayPolicy, D as DEFAULT_MIN_BATCH_EXPIRY_SECONDS, l as DEFAULT_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, F as ForeignDescriptorError, I as IncomingFunds, M as MAX_USED_SIGNING_DESCRIPTORS_LOOK_AHEAD, m as MUTINYNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, n as ProviderKind, o as ProviderUnavailableError, p as REGTEST_MIN_BATCH_EXPIRY_SECONDS, q as REGTEST_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, S as SIGNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, r as ServerInfoSource, s as ServerResponseMismatchError, t as assertValidBatchExpiry, u as assertValidServerUnrollScript, v as defaultBatchExpiryPolicy, w as defaultCheckpointExitDelayPolicy, x as isArkError, y as isHDAllocationCapable, z as isHDWalletCapable, E as maybeArkError, G as resolveBatchExpiryPolicy, J as resolveCheckpointExitDelayPolicy, K as resolveDescriptorSigner, L as selectVirtualCoins, N as signingDescriptorIndex, O as strictSigningDescriptorIndex, Q as waitForIncomingFunds } from './wallet-C2NvHjWB.cjs';
-import { P as Program, A as ArkadeParamValue, a as ArkadeProgramScript, b as ProgramKeys, c as ArkadeArgValue, C as CompiledProgramFunction, d as ArkadeFunction, I as InputRef, e as InputDef, f as ArkadeValueType, g as ArkadeArgType, h as ArkadeContractParams, i as ArkadeSegment, j as AsmToken, S as SUPPORTED_PROGRAM_VERSION, k as SignerRef, T as TapscriptSegment, W as WitnessRef, l as deserializeArkadeContractParams, p as parseArtifact, r as resolveAsm, s as serializeArkadeContractParams, m as stringifyArtifact, v as validateProgram, w as witnessRefToBytes } from './index-aZycGEsQ.cjs';
-export { n as ArkadeContractHandler, B as BoardingContractHandler, o as BoardingContractParams, D as DefaultContractHandler, q as DefaultContractParams, t as DelegateContractHandler, u as DelegateContractParams, V as VHTLC, x as VHTLCContractHandler, y as VHTLCContractParams, z as VHTLCV2ContractHandler, E as VHTLCV2ContractParams, F as contractHandlers } from './index-aZycGEsQ.cjs';
+import { P as Program, A as ArkadeParamValue, a as ArkadeProgramScript, b as ProgramKeys, c as ArkadeArgValue, C as CompiledProgramFunction, d as ArkadeFunction, I as InputRef, e as InputDef, f as ArkadeValueType, g as ArkadeArgType, h as ArkadeContractParams, i as ArkadeSegment, j as AsmToken, S as SUPPORTED_PROGRAM_VERSION, k as SignerRef, T as TapscriptSegment, W as WitnessRef, l as deserializeArkadeContractParams, p as parseArtifact, r as resolveAsm, s as serializeArkadeContractParams, m as stringifyArtifact, v as validateProgram, w as witnessRefToBytes } from './index-BtTtQFUX.cjs';
+export { n as ArkadeContractHandler, B as BoardingContractHandler, o as BoardingContractParams, D as DefaultContractHandler, q as DefaultContractParams, t as DelegateContractHandler, u as DelegateContractParams, V as VHTLC, x as VHTLCContractHandler, y as VHTLCContractParams, z as VHTLCV2ContractHandler, E as VHTLCV2ContractParams, F as contractHandlers } from './index-BtTtQFUX.cjs';
 import { D as DefaultVtxo } from './delegate-BBQW61ym.cjs';
 export { a as DelegateVtxo } from './delegate-BBQW61ym.cjs';
 import { Bytes, BTC_NETWORK } from '@scure/btc-signer/utils.js';
@@ -638,9 +638,8 @@ declare class InMemoryVirtualTxRepository implements VirtualTxRepository {
  * shared DB's version-conflict guard rejects the mismatched open.
  */
 declare class IndexedDBVirtualTxRepository implements VirtualTxRepository {
-    private readonly dbName;
     readonly version: 1;
-    private db;
+    private readonly connection;
     constructor(dbName?: string);
     private getDB;
     clear(): Promise<void>;
@@ -661,9 +660,8 @@ declare class IndexedDBVirtualTxRepository implements VirtualTxRepository {
  * DB's version-conflict guard rejects the mismatched open.
  */
 declare class IndexedDBIntentRepository implements IntentRepository {
-    private readonly dbName;
     readonly version: 1;
-    private db;
+    private readonly connection;
     constructor(dbName?: string);
     private getDB;
     clear(): Promise<void>;
@@ -922,15 +920,13 @@ declare class InMemoryContractRepository implements ContractRepository {
  * Data is stored as JSON strings in key/value stores.
  */
 declare class IndexedDBContractRepository implements ContractRepository {
-    private readonly dbName;
     readonly version: 2;
-    private db;
+    private readonly connection;
     constructor(dbName?: string);
     clear(): Promise<void>;
     getContracts(filter?: ContractFilter): Promise<Contract[]>;
     saveContract(contract: Contract): Promise<void>;
     deleteContract(script: string): Promise<void>;
-    private getContractsByIndexValues;
     private applyContractFilter;
     private getDB;
     [Symbol.asyncDispose](): Promise<void>;
@@ -940,9 +936,8 @@ declare class IndexedDBContractRepository implements ContractRepository {
  * IndexedDB-based implementation of WalletRepository.
  */
 declare class IndexedDBWalletRepository implements WalletRepository {
-    private readonly dbName;
     readonly version: 1;
-    private db;
+    private readonly connection;
     constructor(dbName?: string);
     clear(): Promise<void>;
     [Symbol.asyncDispose](): Promise<void>;
@@ -2051,10 +2046,90 @@ declare class Packet implements ExtensionPacket {
     private static fromReader;
 }
 
+/**
+ * Cross-repo test vectors for the Arkade Asset ID encodings.
+ *
+ * @remarks
+ * Shipped from `src/` rather than `test/` so consumers outside this package can
+ * pin the same bytes: `lightning-swap-service` imports this value, while NArk
+ * and go-sdk vendor the backing `assetIdVectors.json` from a pinned revision of
+ * this repository.
+ *
+ * The encoding is implemented in seven places across three repos and every
+ * disagreement between them fails silently — a flipped txid makes a covenant
+ * unsatisfiable, a flipped group index resolves to a different asset, a case
+ * mismatch is a routing miss. None of those name their cause, which is what
+ * these vectors are for.
+ *
+ * @see plans/asset-id-shared-vectors.md
+ */
+interface AssetIdVectors {
+    readonly version: number;
+    readonly note: string;
+    /** Genesis txid in display order — the 32 bytes an id's leading 64 hex chars carry. */
+    readonly txid_hex: string;
+    /** `txid_hex` reversed: serialization order, what the introspection opcodes match. */
+    readonly script_txid_hex: string;
+    readonly valid: ReadonlyArray<{
+        readonly label: string;
+        readonly group_index: number;
+        /** `txid_hex` with the group index appended little-endian. */
+        readonly asset_id_hex: string;
+        /**
+         * The group index as a stack item, after script-number encoding and
+         * before push framing. Not the raw u16: `65535` is `ffff00` here and
+         * `ffff` on the wire, and `0` is the empty item.
+         */
+        readonly script_group_index_item_hex: string;
+    }>;
+    /** Refused by the identity rule (`^[0-9a-f]{68}$`), though not necessarily by the decoder. */
+    readonly invalid_identity: ReadonlyArray<{
+        readonly label: string;
+        readonly value: string;
+        readonly why: string;
+        /** Present when the value still decodes: what `toString()` must return. */
+        readonly normalizes_to?: string;
+    }>;
+    /** Refused by {@link AssetId.fromString} / `fromBytes`. */
+    readonly invalid_decode: ReadonlyArray<{
+        readonly label: string;
+        readonly value: string;
+        /** Substring of the thrown message — normative for TS, advisory for other SDKs. */
+        readonly expected_error: string;
+    }>;
+    /** Refused by {@link AssetId.create} / `validate`. */
+    readonly invalid_construction: ReadonlyArray<{
+        readonly label: string;
+        readonly txid_hex: string;
+        readonly group_index: number;
+        readonly expected_error: string;
+        /** Set when the group index cannot be expressed by an SDK whose constructor takes a native u16. */
+        readonly outside_uint16?: boolean;
+    }>;
+}
+/**
+ * The asset-id test vectors, deeply frozen.
+ *
+ * @remarks
+ * Frozen all the way down, not just at the top: every value that matters lives
+ * inside the nested arrays, and the module is a singleton — one consumer
+ * mutating an entry would corrupt it for every other consumer in the process.
+ *
+ * @example
+ * ```typescript
+ * import { asset } from '@arkade-os/sdk'
+ * const { txid_hex, valid } = asset.ASSET_ID_VECTORS
+ * expect(AssetId.create(txid_hex, valid[0].group_index).toString()).toBe(valid[0].asset_id_hex)
+ * ```
+ */
+declare const ASSET_ID_VECTORS: AssetIdVectors;
+
+declare const index$1_ASSET_ID_VECTORS: typeof ASSET_ID_VECTORS;
 type index$1_AssetGroup = AssetGroup;
 declare const index$1_AssetGroup: typeof AssetGroup;
 type index$1_AssetId = AssetId;
 declare const index$1_AssetId: typeof AssetId;
+type index$1_AssetIdVectors = AssetIdVectors;
 type index$1_AssetInput = AssetInput;
 declare const index$1_AssetInput: typeof AssetInput;
 type index$1_AssetInputType = AssetInputType;
@@ -2076,7 +2151,7 @@ declare const index$1_MetadataList: typeof MetadataList;
 type index$1_Packet = Packet;
 declare const index$1_Packet: typeof Packet;
 declare namespace index$1 {
-  export { index$1_AssetGroup as AssetGroup, index$1_AssetId as AssetId, index$1_AssetInput as AssetInput, index$1_AssetInputType as AssetInputType, index$1_AssetInputs as AssetInputs, index$1_AssetOutput as AssetOutput, index$1_AssetOutputs as AssetOutputs, index$1_AssetRef as AssetRef, index$1_AssetRefType as AssetRefType, index$1_Metadata as Metadata, index$1_MetadataList as MetadataList, index$1_Packet as Packet };
+  export { index$1_ASSET_ID_VECTORS as ASSET_ID_VECTORS, index$1_AssetGroup as AssetGroup, index$1_AssetId as AssetId, type index$1_AssetIdVectors as AssetIdVectors, index$1_AssetInput as AssetInput, index$1_AssetInputType as AssetInputType, index$1_AssetInputs as AssetInputs, index$1_AssetOutput as AssetOutput, index$1_AssetOutputs as AssetOutputs, index$1_AssetRef as AssetRef, index$1_AssetRefType as AssetRefType, index$1_Metadata as Metadata, index$1_MetadataList as MetadataList, index$1_Packet as Packet };
 }
 
 /**
@@ -5993,6 +6068,22 @@ declare class FetchError extends Error {
     });
 }
 
+/**
+ * How long a blocked upgrade waits before the open is reported as failed.
+ *
+ * An `IDBOpenDBRequest` that is blocked never settles on its own: it waits for
+ * the other connection to close, however long that takes. A hang is worse than a
+ * failure here, because the caller cannot retry what never settles.
+ */
+declare const BLOCKED_UPGRADE_TIMEOUT_MS = 10000;
+/** A database upgrade was held open by another connection past
+ * {@link BLOCKED_UPGRADE_TIMEOUT_MS}. Retryable: closing the other tab and
+ * calling again is the remedy, and the bookkeeping was cleared so it can be. */
+declare class DatabaseUpgradeBlockedError extends Error {
+    readonly dbName: string;
+    readonly name = "DatabaseUpgradeBlockedError";
+    constructor(dbName: string);
+}
 /**
  * Opens an IndexedDB database and increments the reference count.
  * Handles global object detection and callbacks.
@@ -6010,12 +6101,95 @@ declare function openDatabase(dbName: string, dbVersion: number, initDatabase: (
 /**
  * Decrements the reference count and closes the database when no references remain.
  *
+ * Refcount contract: call once per *successful* {@link openDatabase}, never per
+ * rejection. A rejected open already cleared its own bookkeeping, so a call
+ * paired with it decrements whatever entry a successor installed under the same
+ * name. {@link createManagedConnection} honours this — it only closes while it
+ * holds a promise, and every rejection path drops that promise first.
+ *
  * @param dbName The name of the database to close.
  *
  * @returns True if the database was closed, false otherwise.
  */
 declare function closeDatabase(dbName: string): Promise<boolean>;
 
+/** A disposed {@link ManagedConnection} was read from. Reopening instead would
+ * take a refcount nothing will ever release, so this is loud rather than
+ * silently leaky: the fix belongs at the caller, which is using a repository it
+ * already tore down. */
+declare class ConnectionDisposedError extends Error {
+    readonly dbName: string;
+    readonly name = "ConnectionDisposedError";
+    constructor(dbName: string);
+}
+/** Lazily-opened, self-healing handle on one IndexedDB database. */
+interface ManagedConnection extends AsyncDisposable {
+    /**
+     * The open connection, opening it on first call.
+     *
+     * Call this once per operation and use the handle for the transaction you
+     * start right away — never store it on the repository, and never carry it
+     * across an `await`. The connection can be closed underneath you at any
+     * time (a `versionchange` from another tab, eviction, "clear site data"),
+     * after which every transaction on that handle throws `InvalidStateError`;
+     * a later `get()` transparently reopens, but only for callers that ask
+     * again. Holding the resolved database is exactly the defect this type
+     * exists to remove.
+     *
+     * ## The dispose boundary
+     *
+     * `get()` is valid only before `[Symbol.asyncDispose]`. Afterwards it
+     * rejects with {@link ConnectionDisposedError}, permanently: dispose has
+     * released this connection's single reference, and reopening would take a
+     * refcount nothing is left to release. Disposal is final by design — there
+     * is no revive; construct a new repository, which constructs a new
+     * connection, instead.
+     *
+     * Dispose neither awaits nor cancels work already in flight. A transaction
+     * started just before it can abort when the underlying handle closes, and
+     * an in-flight `get()` may resolve to a database that is closing. So
+     * sequence disposal after the operations you care about have settled —
+     * `await` the repository's outstanding calls first — rather than racing it
+     * against them.
+     *
+     * Callers must not close the database themselves; the reference this
+     * connection holds is released by its own dispose, once.
+     */
+    get(): Promise<IDBDatabase>;
+}
+/**
+ * Forget-and-reopen around {@link openDatabase}, shared by every IndexedDB
+ * repository. Caching the resolved `IDBDatabase` is the defect this exists to
+ * remove: once the manager closes on `versionchange`, every later transaction on
+ * that handle throws `InvalidStateError` with no path back.
+ *
+ * Opens nothing until the first {@link ManagedConnection.get} — repositories
+ * construct their storage in their own constructors, and an eager open would
+ * move the "IndexedDB is not available in this environment" throw to
+ * construction time.
+ */
+declare function createManagedConnection(dbName: string, version: number, initDatabase: (db: IDBDatabase, oldVersion: number, transaction: IDBTransaction | null) => void): ManagedConnection;
+
+/** Resolve with an {@link IDBRequest}'s result, or reject with its error. */
+declare const promisifyRequest: <T>(request: IDBRequest<T>) => Promise<T>;
+/**
+ * Resolve once a transaction commits, or reject if it errors or aborts.
+ *
+ * A write is durable at *commit*, not at request success — quota pressure and
+ * storage eviction abort a transaction whose every request already succeeded.
+ * Reads may resolve on {@link promisifyRequest}; writes must await this.
+ */
+declare const awaitTransaction: (transaction: IDBTransaction) => Promise<void>;
+/**
+ * Queue a delete for every row an index matches. Fire-and-forget by design:
+ * the requests are queued as the cursor walks and the caller learns they
+ * committed by awaiting the transaction, not this. A failing cursor or delete
+ * aborts the transaction, which {@link awaitTransaction} reports.
+ */
+declare const deleteByIndex: (store: IDBObjectStore, indexName: string, value: IDBValidKey) => void;
+/** Read every row matching any of `values` on an index, flattened. */
+declare const getAllByIndexValues: <T>(store: IDBObjectStore, indexName: string, values: readonly IDBValidKey[]) => Promise<T[]>;
+
 declare const MESSAGE_BUS_NOT_INITIALIZED = "MessageBus not initialized";
 /**
  * Message for the "an init is in flight" variant.
@@ -6102,4 +6276,4 @@ declare class AssetManager extends ReadonlyAssetManager implements IAssetManager
     burn(params: BurnParams): Promise<string>;
 }
 
-export { ARKADE_MAGIC, ARKADE_SALTED_PREIMAGE_TAG, ARKADE_SWAP_PREIMAGE_TAG, Activity, ActivityRegistry, AmbiguousRouteError, type AnchorBumper, ArkAddress, ArkIntent, ArkNote, ArkProvider, type ArkPsbtFieldCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ArkTransaction, type ArkTxInput, type ArkadeBatchInput, ArkadeCash, ArkadeContractParams, type ArkadeExtendedCoin, type ArkadeExtendedVirtualCoin, Asset, AssetDetails, AssetManager, BIP21, BIP21Error, type BIP21Params, type BIP21ParseResult, BIP322, Batch, BatchExpiryPolicy, BurnParams, CSVMultisigTapscript, ChainTx, Coin, ConditionWitness, type ConnectorTreeNode, Contract, ContractEvent, ContractRepository, ContractRepositoryImpl, ContractSyncState, ContractWatcherConfig, ContractWithVtxos, CosignerPublicKey, CreateContractParams, DEFAULT_MESSAGE_TIMEOUTS, DefaultVtxo, DelegateInfo, DelegateNotConfiguredError, DelegatorNotConfiguredError, DescriptorIdentity, type DescriptorIdentityOptions, type DescriptorOptions, type DescriptorSigner, DescriptorSigningProviderMissingError, type DeterministicSigner, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, type BlockHeader as ElectrumBlockHeader, ElectrumOnchainProvider, type TransactionHistory as ElectrumTransactionHistory, type Unspent as ElectrumUnspent, type EmulatorEntry, type EmulatorInfo, EmulatorPacket, type EmulatorProvider, EncodedVtxoScript, Estimator, type ExcludableVtxo, type ExecutorEvent, type ExitDelay, type ExitFeeWallet, type ExitMode, type ExitOptions, type ExitPackage, type ExitQuote, type ExitStep, type ExitTotals, type ExitVtxoInfo, ExplorerTransaction, ExtendedCoin, ExtendedVirtualCoin, Extension, ExtensionNotFoundError, type ExtensionPacket, FeeAmount, FeeInfo, FeeOutput, FetchError, GetVtxosFilter, HDAllocationCapable, HDDescriptorProvider, type HDDeterministicSignCapable, HDWalletCapable, IAssetManager, IContractManager, IDelegateManager, IReadonlyAssetManager, IReadonlyWallet, IVtxoManager, IWallet, Identity, InMemoryContractRepository, InMemoryIntentRepository, InMemoryVirtualTxRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBIntentRepository, IndexedDBVirtualTxRepository, IndexedDBWalletRepository, IndexerProvider, Intent, IntentFeeConfig, IntentFilter, IntentRepository, IssuanceParams, IssuanceResult, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, type MessageHandler, type MessageTimeouts, MigrationGlobalSkipReason, MigrationLegSkipReason, type MigrationStatus, MissingSigningDescriptorError, MnemonicIdentity, type MnemonicOptions, Network, NetworkName, type NetworkOptions, OffchainInput, type OffchainTx, OnchainInput, OnchainProvider, OnchainWallet, Outpoint, P2A, type ParsedArkContract, PathContext, PathSelection, type PaymentHandle, type PaymentOption, type PaymentRail, type PaymentRequest, PaymentRouter, type PaymentStatus, PrevArkTxField, PrevoutTxField, ProviderConnectionState, type ProvisionedClaimSecret, type ProvisionedKey, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlyIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, Recipient, ReissuanceParams, RelativeTimelock, RenewVtxosOptions, type RequestEnvelope, type ResponseEnvelope, RestEmulatorProvider, type RouteQuote, type RouteResult, type RouterContext, type RouterPreferences, SeedIdentity, type SeedIdentityOptions, SendBitcoinParams, SendParams, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, type ServiceWorkerWalletMode, SettleParams, SettlementConfig, SettlementEvent, SignerSession, SignerStatus, SingleKey, Status, StorageConfig, TapLeafScript, Transaction, TxTree, TxWeightEstimator, UnannotatableInputError, UnilateralExit, UnknownPacket, Unroll, type VSize, type VerifyServerSignatures, VirtualCoin, VirtualTx, VirtualTxRepository, VtxoBranch, type VtxoExclusion, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, Wallet, WalletBalance, WalletCannotSignError, WalletMessageHandler, WalletNotInitializedError, WalletRepository, WalletRepositoryImpl, WsElectrumChainSource, adoptContractDescriptor, arkRail, arkTarget, index as arkade, assembleBtcdTaprootTree, assertFinalCommitmentMatchesValidated, assertSendableAmount, assertSubmittedArkTxid, index$1 as asset, btcTarget, buildForfeitTx, buildOffchainTx, buildPreimageMessage, buildSaltedPreimageMessage, buildVersion, claimWithPreimageIdentity, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, contractPreimage, contractSigner, createAssetPacket, createDefaultPaymentRouter, decodeArkContract, deriveDescriptorLeafCompressedPubKey, deriveDescriptorLeafPubKey, deserializeExitPackage, encodeArkContract, gateExclusion, gatedContracts, getArkPsbtFields, getMigrationStatus, hasBoardingTxExpired, identityDescriptor, invoiceTarget, isArkContract, isBtcAddress, isCltvSatisfied, isContractGenericallySpendable, isCsvSpendable, isDeterministicSigner, isHDDeterministicSignCapable, isLightningInvoice, isLnurl, isMessageBusInitializingError, isMessageBusNotInitializedError, isPerArtifactDescriptor, isRetryableProviderError, isValidArkAddress, logExcludedVtxos, makeHandle, matchServerCheckpoints, migrateWalletRepository, normalizeToDescriptor, onchainRail, openDatabase, outpointExclusion, outpointReasons, parseHDDescriptor, provisionClaimSecret, provisionRefundKey, requiresMigration, resolveSendAmount, rollbackMigration, sdkVersion, selectCoinsWithAsset, sequenceToTimelock, serializeExitPackage, setArkPsbtField, setupServiceWorker, signAndSubmitOffchainTx, timelockToSequence, tryResolveSendAmount, validateBatchRecipients, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures };
+export { ARKADE_MAGIC, ARKADE_SALTED_PREIMAGE_TAG, ARKADE_SWAP_PREIMAGE_TAG, Activity, ActivityRegistry, AmbiguousRouteError, type AnchorBumper, ArkAddress, ArkIntent, ArkNote, ArkProvider, type ArkPsbtFieldCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ArkTransaction, type ArkTxInput, type ArkadeBatchInput, ArkadeCash, ArkadeContractParams, type ArkadeExtendedCoin, type ArkadeExtendedVirtualCoin, Asset, AssetDetails, AssetManager, BIP21, BIP21Error, type BIP21Params, type BIP21ParseResult, BIP322, BLOCKED_UPGRADE_TIMEOUT_MS, Batch, BatchExpiryPolicy, BurnParams, CSVMultisigTapscript, ChainTx, Coin, ConditionWitness, ConnectionDisposedError, type ConnectorTreeNode, Contract, ContractEvent, ContractRepository, ContractRepositoryImpl, ContractSyncState, ContractWatcherConfig, ContractWithVtxos, CosignerPublicKey, CreateContractParams, DEFAULT_MESSAGE_TIMEOUTS, DatabaseUpgradeBlockedError, DefaultVtxo, DelegateInfo, DelegateNotConfiguredError, DelegatorNotConfiguredError, DescriptorIdentity, type DescriptorIdentityOptions, type DescriptorOptions, type DescriptorSigner, DescriptorSigningProviderMissingError, type DeterministicSigner, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, type BlockHeader as ElectrumBlockHeader, ElectrumOnchainProvider, type TransactionHistory as ElectrumTransactionHistory, type Unspent as ElectrumUnspent, type EmulatorEntry, type EmulatorInfo, EmulatorPacket, type EmulatorProvider, EncodedVtxoScript, Estimator, type ExcludableVtxo, type ExecutorEvent, type ExitDelay, type ExitFeeWallet, type ExitMode, type ExitOptions, type ExitPackage, type ExitQuote, type ExitStep, type ExitTotals, type ExitVtxoInfo, ExplorerTransaction, ExtendedCoin, ExtendedVirtualCoin, Extension, ExtensionNotFoundError, type ExtensionPacket, FeeAmount, FeeInfo, FeeOutput, FetchError, GetVtxosFilter, HDAllocationCapable, HDDescriptorProvider, type HDDeterministicSignCapable, HDWalletCapable, IAssetManager, IContractManager, IDelegateManager, IReadonlyAssetManager, IReadonlyWallet, IVtxoManager, IWallet, Identity, InMemoryContractRepository, InMemoryIntentRepository, InMemoryVirtualTxRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBIntentRepository, IndexedDBVirtualTxRepository, IndexedDBWalletRepository, IndexerProvider, Intent, IntentFeeConfig, IntentFilter, IntentRepository, IssuanceParams, IssuanceResult, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, type ManagedConnection, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, type MessageHandler, type MessageTimeouts, MigrationGlobalSkipReason, MigrationLegSkipReason, type MigrationStatus, MissingSigningDescriptorError, MnemonicIdentity, type MnemonicOptions, Network, NetworkName, type NetworkOptions, OffchainInput, type OffchainTx, OnchainInput, OnchainProvider, OnchainWallet, Outpoint, P2A, type ParsedArkContract, PathContext, PathSelection, type PaymentHandle, type PaymentOption, type PaymentRail, type PaymentRequest, PaymentRouter, type PaymentStatus, PrevArkTxField, PrevoutTxField, ProviderConnectionState, type ProvisionedClaimSecret, type ProvisionedKey, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlyIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, Recipient, ReissuanceParams, RelativeTimelock, RenewVtxosOptions, type RequestEnvelope, type ResponseEnvelope, RestEmulatorProvider, type RouteQuote, type RouteResult, type RouterContext, type RouterPreferences, SeedIdentity, type SeedIdentityOptions, SendBitcoinParams, SendParams, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, type ServiceWorkerWalletMode, SettleParams, SettlementConfig, SettlementEvent, SignerSession, SignerStatus, SingleKey, Status, StorageConfig, TapLeafScript, Transaction, TxTree, TxWeightEstimator, UnannotatableInputError, UnilateralExit, UnknownPacket, Unroll, type VSize, type VerifyServerSignatures, VirtualCoin, VirtualTx, VirtualTxRepository, VtxoBranch, type VtxoExclusion, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, Wallet, WalletBalance, WalletCannotSignError, WalletMessageHandler, WalletNotInitializedError, WalletRepository, WalletRepositoryImpl, WsElectrumChainSource, adoptContractDescriptor, arkRail, arkTarget, index as arkade, assembleBtcdTaprootTree, assertFinalCommitmentMatchesValidated, assertSendableAmount, assertSubmittedArkTxid, index$1 as asset, awaitTransaction, btcTarget, buildForfeitTx, buildOffchainTx, buildPreimageMessage, buildSaltedPreimageMessage, buildVersion, claimWithPreimageIdentity, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, contractPreimage, contractSigner, createAssetPacket, createDefaultPaymentRouter, createManagedConnection, decodeArkContract, deleteByIndex, deriveDescriptorLeafCompressedPubKey, deriveDescriptorLeafPubKey, deserializeExitPackage, encodeArkContract, gateExclusion, gatedContracts, getAllByIndexValues, getArkPsbtFields, getMigrationStatus, hasBoardingTxExpired, identityDescriptor, invoiceTarget, isArkContract, isBtcAddress, isCltvSatisfied, isContractGenericallySpendable, isCsvSpendable, isDeterministicSigner, isHDDeterministicSignCapable, isLightningInvoice, isLnurl, isMessageBusInitializingError, isMessageBusNotInitializedError, isPerArtifactDescriptor, isRetryableProviderError, isValidArkAddress, logExcludedVtxos, makeHandle, matchServerCheckpoints, migrateWalletRepository, normalizeToDescriptor, onchainRail, openDatabase, outpointExclusion, outpointReasons, parseHDDescriptor, promisifyRequest, provisionClaimSecret, provisionRefundKey, requiresMigration, resolveSendAmount, rollbackMigration, sdkVersion, selectCoinsWithAsset, sequenceToTimelock, serializeExitPackage, setArkPsbtField, setupServiceWorker, signAndSubmitOffchainTx, timelockToSequence, tryResolveSendAmount, validateBatchRecipients, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures };

package/dist/index.d.ts

@@ -2,8 +2,8 @@ import { a2 as ReadonlyIdentity, a as Identity, ap as DescriptorSigningRequest,
 export { aW as ActivityIntent, aX as ActivityResolver, ac as ArkInfo, aY as ArkIntentState, aZ as ArkTapscript, a_ as AssetMetadata, a$ as BITCOIN_EMULATOR_PUBKEY, b0 as BaseWalletConfig, _ as BatchFailedEvent, Y as BatchFinalizationEvent, Z as BatchFinalizedEvent, b1 as BatchInfo, b2 as BatchSignableIdentity, P as BatchStartedEvent, b3 as CLTVMultisigTapscript, b4 as CandidateDeps, b5 as ChainTxType, J as ChainedTxType, b6 as CommitmentTx, b7 as ConditionCSVMultisigTapscript, b8 as ConditionMultisigTapscript, b9 as ContractBalance, ba as ContractEventCallback, bb as ContractHandler, ah as ContractManager, ai as ContractManagerConfig, bc as ContractState, bd as ContractVtxo, be as ContractWatcher, bf as DelegateManagerImpl, bg as DelegateOptions, a4 as DelegateProvider, bh as DelegatorManagerImpl, bi as DelegatorProvider, bj as DeprecatedSignerMigrationReport, bk as DeprecatedSignerReport, bl as DigestMismatchError, bm as Discoverable, bn as DiscoveredContract, bo as DiscoveryDeps, bp as ESPLORA_URL, bq as EsploraProvider, br as EventSourceCapable, bs as EventSourceFactory, bt as EventSourceLike, bu as EventSourceUnavailableError, a6 as ExitCaptureMode, bv as ExitChainResolver, a7 as ExitDataSource, bw as ExtendedContractVtxo, bx as GroupMembership, by as HandlerError, bz as IDelegatorManager, bA as INTENT_TERMINAL_STATES, bB as IndexerTxType, bC as KnownMetadata, bD as MUTINYNET_EMULATOR_PUBKEY, bE as MigrateDeprecatedSignerOptions, bF as MigrationLegReport, bG as MigrationVtxoRef, bH as MultisigTapscript, bI as Nonces, bJ as Output, bK as PageResponse, bL as PaginationOptions, bM as PartialSig, bN as ProviderClass, bO as REGTEST_EMULATOR_PUBKEY, a5 as ReadonlyWalletConfig, l as RestArkProvider, bP as RestDelegateProvider, bQ as RestDelegatorProvider, m as RestIndexerProvider, bR as ScanContractsOptions, bS as ScanResult, bT as ScheduledSession, bU as SettlementEventType, bV as SignRequest, am as SignedIntent, bW as SignerClassification, bX as SignerSet, bY as SubscriptionEvent, bZ as SubscriptionHeartbeat, n as SubscriptionResponse, b_ as TapLeaves, b$ as TapTreeCoder, c0 as TapscriptType, ao as TimeHeight, c1 as TreeNonces, X as TreeNoncesEvent, c2 as TreePartialSigs, a0 as TreeSignatureEvent, Q as TreeSigningStartedEvent, $ as TreeTxEvent, c3 as Tx, c4 as TxHistoryRecord, c5 as TxKey, T as TxNotification, c6 as TxTag, c7 as TxTreeNode, c8 as TxType, c9 as VirtualStatus, ca as Vtxo, cb as VtxoChain, ak as VtxoManager, cc as VtxoType, b as WalletConfig, cd as WalletMode, ce as assetMintResolver, cf as boardingResolver, cg as canRecoverOnchain, ch as canSpendOffchain, ci as classifyAgainstSignerSet, cj as classifyContractSigner, ck as collabExitResolver, cl as configureEventSource, cm as createDefaultActivityRegistry, cn as createExitChainResolver, co as decodeTapscript, cp as defaultEmulatorPubkey, cq as getConfiguredEventSource, cr as getNetwork, cs as getRandomId, ct as getSequence, cu as hasCandidates, cv as hasTerminalSpend, cw as isBatchSignable, cx as isCooperativelyMigratable, cy as isDiscoverable, cz as isEventSourceUnavailableError, cA as isExpired, cB as isPastExpiry, cC as isRecoverable, cD as isSigningIdentity, cE as isSpendable, cF as isSubdust, cG as isTerminalIntentState, cH as isVirtualCoin, cI as isVtxoExpiringSoon, cJ as networks, cK as resolveEmulatorPubkey, cL as resolveEventSource, cM as scriptFromTapLeafScript, cN as signerSetFromInfo, cO as toXOnlySignerHex } from './index-CFOMyVMt.js';
 import { W as Wallet, R as ReadonlyWallet, b as ReceiveRotatorFactory, c as ReceiveRotatorBootOpts, d as ReceiveRotatorBoot, P as ProviderConnectionState, H as HDWalletCapable, a as HDAllocationCapable, B as BatchExpiryPolicy, e as Batch } from './wallet-DJUnN939.js';
 export { A as ArkError, f as ArkErrorName, g as ArkadeCashClaimResult, h as ArkadeCashCreateError, i as ArkadeCashUnclaimedReason, j as ArkadeCashUnclaimedVtxo, k as BoardingUtxoGroup, C as CheckpointExitDelayPolicy, D as DEFAULT_MIN_BATCH_EXPIRY_SECONDS, l as DEFAULT_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, F as ForeignDescriptorError, I as IncomingFunds, M as MAX_USED_SIGNING_DESCRIPTORS_LOOK_AHEAD, m as MUTINYNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, n as ProviderKind, o as ProviderUnavailableError, p as REGTEST_MIN_BATCH_EXPIRY_SECONDS, q as REGTEST_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, S as SIGNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, r as ServerInfoSource, s as ServerResponseMismatchError, t as assertValidBatchExpiry, u as assertValidServerUnrollScript, v as defaultBatchExpiryPolicy, w as defaultCheckpointExitDelayPolicy, x as isArkError, y as isHDAllocationCapable, z as isHDWalletCapable, E as maybeArkError, G as resolveBatchExpiryPolicy, J as resolveCheckpointExitDelayPolicy, K as resolveDescriptorSigner, L as selectVirtualCoins, N as signingDescriptorIndex, O as strictSigningDescriptorIndex, Q as waitForIncomingFunds } from './wallet-DJUnN939.js';
-import { P as Program, A as ArkadeParamValue, a as ArkadeProgramScript, b as ProgramKeys, c as ArkadeArgValue, C as CompiledProgramFunction, d as ArkadeFunction, I as InputRef, e as InputDef, f as ArkadeValueType, g as ArkadeArgType, h as ArkadeContractParams, i as ArkadeSegment, j as AsmToken, S as SUPPORTED_PROGRAM_VERSION, k as SignerRef, T as TapscriptSegment, W as WitnessRef, l as deserializeArkadeContractParams, p as parseArtifact, r as resolveAsm, s as serializeArkadeContractParams, m as stringifyArtifact, v as validateProgram, w as witnessRefToBytes } from './index-Bxe9kBFs.js';
-export { n as ArkadeContractHandler, B as BoardingContractHandler, o as BoardingContractParams, D as DefaultContractHandler, q as DefaultContractParams, t as DelegateContractHandler, u as DelegateContractParams, V as VHTLC, x as VHTLCContractHandler, y as VHTLCContractParams, z as VHTLCV2ContractHandler, E as VHTLCV2ContractParams, F as contractHandlers } from './index-Bxe9kBFs.js';
+import { P as Program, A as ArkadeParamValue, a as ArkadeProgramScript, b as ProgramKeys, c as ArkadeArgValue, C as CompiledProgramFunction, d as ArkadeFunction, I as InputRef, e as InputDef, f as ArkadeValueType, g as ArkadeArgType, h as ArkadeContractParams, i as ArkadeSegment, j as AsmToken, S as SUPPORTED_PROGRAM_VERSION, k as SignerRef, T as TapscriptSegment, W as WitnessRef, l as deserializeArkadeContractParams, p as parseArtifact, r as resolveAsm, s as serializeArkadeContractParams, m as stringifyArtifact, v as validateProgram, w as witnessRefToBytes } from './index-fDDiA1-L.js';
+export { n as ArkadeContractHandler, B as BoardingContractHandler, o as BoardingContractParams, D as DefaultContractHandler, q as DefaultContractParams, t as DelegateContractHandler, u as DelegateContractParams, V as VHTLC, x as VHTLCContractHandler, y as VHTLCContractParams, z as VHTLCV2ContractHandler, E as VHTLCV2ContractParams, F as contractHandlers } from './index-fDDiA1-L.js';
 import { D as DefaultVtxo } from './delegate-Dv_9OVHv.js';
 export { a as DelegateVtxo } from './delegate-Dv_9OVHv.js';
 import { Bytes, BTC_NETWORK } from '@scure/btc-signer/utils.js';
@@ -638,9 +638,8 @@ declare class InMemoryVirtualTxRepository implements VirtualTxRepository {
  * shared DB's version-conflict guard rejects the mismatched open.
  */
 declare class IndexedDBVirtualTxRepository implements VirtualTxRepository {
-    private readonly dbName;
     readonly version: 1;
-    private db;
+    private readonly connection;
     constructor(dbName?: string);
     private getDB;
     clear(): Promise<void>;
@@ -661,9 +660,8 @@ declare class IndexedDBVirtualTxRepository implements VirtualTxRepository {
  * DB's version-conflict guard rejects the mismatched open.
  */
 declare class IndexedDBIntentRepository implements IntentRepository {
-    private readonly dbName;
     readonly version: 1;
-    private db;
+    private readonly connection;
     constructor(dbName?: string);
     private getDB;
     clear(): Promise<void>;
@@ -922,15 +920,13 @@ declare class InMemoryContractRepository implements ContractRepository {
  * Data is stored as JSON strings in key/value stores.
  */
 declare class IndexedDBContractRepository implements ContractRepository {
-    private readonly dbName;
     readonly version: 2;
-    private db;
+    private readonly connection;
     constructor(dbName?: string);
     clear(): Promise<void>;
     getContracts(filter?: ContractFilter): Promise<Contract[]>;
     saveContract(contract: Contract): Promise<void>;
     deleteContract(script: string): Promise<void>;
-    private getContractsByIndexValues;
     private applyContractFilter;
     private getDB;
     [Symbol.asyncDispose](): Promise<void>;
@@ -940,9 +936,8 @@ declare class IndexedDBContractRepository implements ContractRepository {
  * IndexedDB-based implementation of WalletRepository.
  */
 declare class IndexedDBWalletRepository implements WalletRepository {
-    private readonly dbName;
     readonly version: 1;
-    private db;
+    private readonly connection;
     constructor(dbName?: string);
     clear(): Promise<void>;
     [Symbol.asyncDispose](): Promise<void>;
@@ -2051,10 +2046,90 @@ declare class Packet implements ExtensionPacket {
     private static fromReader;
 }
 
+/**
+ * Cross-repo test vectors for the Arkade Asset ID encodings.
+ *
+ * @remarks
+ * Shipped from `src/` rather than `test/` so consumers outside this package can
+ * pin the same bytes: `lightning-swap-service` imports this value, while NArk
+ * and go-sdk vendor the backing `assetIdVectors.json` from a pinned revision of
+ * this repository.
+ *
+ * The encoding is implemented in seven places across three repos and every
+ * disagreement between them fails silently — a flipped txid makes a covenant
+ * unsatisfiable, a flipped group index resolves to a different asset, a case
+ * mismatch is a routing miss. None of those name their cause, which is what
+ * these vectors are for.
+ *
+ * @see plans/asset-id-shared-vectors.md
+ */
+interface AssetIdVectors {
+    readonly version: number;
+    readonly note: string;
+    /** Genesis txid in display order — the 32 bytes an id's leading 64 hex chars carry. */
+    readonly txid_hex: string;
+    /** `txid_hex` reversed: serialization order, what the introspection opcodes match. */
+    readonly script_txid_hex: string;
+    readonly valid: ReadonlyArray<{
+        readonly label: string;
+        readonly group_index: number;
+        /** `txid_hex` with the group index appended little-endian. */
+        readonly asset_id_hex: string;
+        /**
+         * The group index as a stack item, after script-number encoding and
+         * before push framing. Not the raw u16: `65535` is `ffff00` here and
+         * `ffff` on the wire, and `0` is the empty item.
+         */
+        readonly script_group_index_item_hex: string;
+    }>;
+    /** Refused by the identity rule (`^[0-9a-f]{68}$`), though not necessarily by the decoder. */
+    readonly invalid_identity: ReadonlyArray<{
+        readonly label: string;
+        readonly value: string;
+        readonly why: string;
+        /** Present when the value still decodes: what `toString()` must return. */
+        readonly normalizes_to?: string;
+    }>;
+    /** Refused by {@link AssetId.fromString} / `fromBytes`. */
+    readonly invalid_decode: ReadonlyArray<{
+        readonly label: string;
+        readonly value: string;
+        /** Substring of the thrown message — normative for TS, advisory for other SDKs. */
+        readonly expected_error: string;
+    }>;
+    /** Refused by {@link AssetId.create} / `validate`. */
+    readonly invalid_construction: ReadonlyArray<{
+        readonly label: string;
+        readonly txid_hex: string;
+        readonly group_index: number;
+        readonly expected_error: string;
+        /** Set when the group index cannot be expressed by an SDK whose constructor takes a native u16. */
+        readonly outside_uint16?: boolean;
+    }>;
+}
+/**
+ * The asset-id test vectors, deeply frozen.
+ *
+ * @remarks
+ * Frozen all the way down, not just at the top: every value that matters lives
+ * inside the nested arrays, and the module is a singleton — one consumer
+ * mutating an entry would corrupt it for every other consumer in the process.
+ *
+ * @example
+ * ```typescript
+ * import { asset } from '@arkade-os/sdk'
+ * const { txid_hex, valid } = asset.ASSET_ID_VECTORS
+ * expect(AssetId.create(txid_hex, valid[0].group_index).toString()).toBe(valid[0].asset_id_hex)
+ * ```
+ */
+declare const ASSET_ID_VECTORS: AssetIdVectors;
+
+declare const index$1_ASSET_ID_VECTORS: typeof ASSET_ID_VECTORS;
 type index$1_AssetGroup = AssetGroup;
 declare const index$1_AssetGroup: typeof AssetGroup;
 type index$1_AssetId = AssetId;
 declare const index$1_AssetId: typeof AssetId;
+type index$1_AssetIdVectors = AssetIdVectors;
 type index$1_AssetInput = AssetInput;
 declare const index$1_AssetInput: typeof AssetInput;
 type index$1_AssetInputType = AssetInputType;
@@ -2076,7 +2151,7 @@ declare const index$1_MetadataList: typeof MetadataList;
 type index$1_Packet = Packet;
 declare const index$1_Packet: typeof Packet;
 declare namespace index$1 {
-  export { index$1_AssetGroup as AssetGroup, index$1_AssetId as AssetId, index$1_AssetInput as AssetInput, index$1_AssetInputType as AssetInputType, index$1_AssetInputs as AssetInputs, index$1_AssetOutput as AssetOutput, index$1_AssetOutputs as AssetOutputs, index$1_AssetRef as AssetRef, index$1_AssetRefType as AssetRefType, index$1_Metadata as Metadata, index$1_MetadataList as MetadataList, index$1_Packet as Packet };
+  export { index$1_ASSET_ID_VECTORS as ASSET_ID_VECTORS, index$1_AssetGroup as AssetGroup, index$1_AssetId as AssetId, type index$1_AssetIdVectors as AssetIdVectors, index$1_AssetInput as AssetInput, index$1_AssetInputType as AssetInputType, index$1_AssetInputs as AssetInputs, index$1_AssetOutput as AssetOutput, index$1_AssetOutputs as AssetOutputs, index$1_AssetRef as AssetRef, index$1_AssetRefType as AssetRefType, index$1_Metadata as Metadata, index$1_MetadataList as MetadataList, index$1_Packet as Packet };
 }
 
 /**
@@ -5993,6 +6068,22 @@ declare class FetchError extends Error {
     });
 }
 
+/**
+ * How long a blocked upgrade waits before the open is reported as failed.
+ *
+ * An `IDBOpenDBRequest` that is blocked never settles on its own: it waits for
+ * the other connection to close, however long that takes. A hang is worse than a
+ * failure here, because the caller cannot retry what never settles.
+ */
+declare const BLOCKED_UPGRADE_TIMEOUT_MS = 10000;
+/** A database upgrade was held open by another connection past
+ * {@link BLOCKED_UPGRADE_TIMEOUT_MS}. Retryable: closing the other tab and
+ * calling again is the remedy, and the bookkeeping was cleared so it can be. */
+declare class DatabaseUpgradeBlockedError extends Error {
+    readonly dbName: string;
+    readonly name = "DatabaseUpgradeBlockedError";
+    constructor(dbName: string);
+}
 /**
  * Opens an IndexedDB database and increments the reference count.
  * Handles global object detection and callbacks.
@@ -6010,12 +6101,95 @@ declare function openDatabase(dbName: string, dbVersion: number, initDatabase: (
 /**
  * Decrements the reference count and closes the database when no references remain.
  *
+ * Refcount contract: call once per *successful* {@link openDatabase}, never per
+ * rejection. A rejected open already cleared its own bookkeeping, so a call
+ * paired with it decrements whatever entry a successor installed under the same
+ * name. {@link createManagedConnection} honours this — it only closes while it
+ * holds a promise, and every rejection path drops that promise first.
+ *
  * @param dbName The name of the database to close.
  *
  * @returns True if the database was closed, false otherwise.
  */
 declare function closeDatabase(dbName: string): Promise<boolean>;
 
+/** A disposed {@link ManagedConnection} was read from. Reopening instead would
+ * take a refcount nothing will ever release, so this is loud rather than
+ * silently leaky: the fix belongs at the caller, which is using a repository it
+ * already tore down. */
+declare class ConnectionDisposedError extends Error {
+    readonly dbName: string;
+    readonly name = "ConnectionDisposedError";
+    constructor(dbName: string);
+}
+/** Lazily-opened, self-healing handle on one IndexedDB database. */
+interface ManagedConnection extends AsyncDisposable {
+    /**
+     * The open connection, opening it on first call.
+     *
+     * Call this once per operation and use the handle for the transaction you
+     * start right away — never store it on the repository, and never carry it
+     * across an `await`. The connection can be closed underneath you at any
+     * time (a `versionchange` from another tab, eviction, "clear site data"),
+     * after which every transaction on that handle throws `InvalidStateError`;
+     * a later `get()` transparently reopens, but only for callers that ask
+     * again. Holding the resolved database is exactly the defect this type
+     * exists to remove.
+     *
+     * ## The dispose boundary
+     *
+     * `get()` is valid only before `[Symbol.asyncDispose]`. Afterwards it
+     * rejects with {@link ConnectionDisposedError}, permanently: dispose has
+     * released this connection's single reference, and reopening would take a
+     * refcount nothing is left to release. Disposal is final by design — there
+     * is no revive; construct a new repository, which constructs a new
+     * connection, instead.
+     *
+     * Dispose neither awaits nor cancels work already in flight. A transaction
+     * started just before it can abort when the underlying handle closes, and
+     * an in-flight `get()` may resolve to a database that is closing. So
+     * sequence disposal after the operations you care about have settled —
+     * `await` the repository's outstanding calls first — rather than racing it
+     * against them.
+     *
+     * Callers must not close the database themselves; the reference this
+     * connection holds is released by its own dispose, once.
+     */
+    get(): Promise<IDBDatabase>;
+}
+/**
+ * Forget-and-reopen around {@link openDatabase}, shared by every IndexedDB
+ * repository. Caching the resolved `IDBDatabase` is the defect this exists to
+ * remove: once the manager closes on `versionchange`, every later transaction on
+ * that handle throws `InvalidStateError` with no path back.
+ *
+ * Opens nothing until the first {@link ManagedConnection.get} — repositories
+ * construct their storage in their own constructors, and an eager open would
+ * move the "IndexedDB is not available in this environment" throw to
+ * construction time.
+ */
+declare function createManagedConnection(dbName: string, version: number, initDatabase: (db: IDBDatabase, oldVersion: number, transaction: IDBTransaction | null) => void): ManagedConnection;
+
+/** Resolve with an {@link IDBRequest}'s result, or reject with its error. */
+declare const promisifyRequest: <T>(request: IDBRequest<T>) => Promise<T>;
+/**
+ * Resolve once a transaction commits, or reject if it errors or aborts.
+ *
+ * A write is durable at *commit*, not at request success — quota pressure and
+ * storage eviction abort a transaction whose every request already succeeded.
+ * Reads may resolve on {@link promisifyRequest}; writes must await this.
+ */
+declare const awaitTransaction: (transaction: IDBTransaction) => Promise<void>;
+/**
+ * Queue a delete for every row an index matches. Fire-and-forget by design:
+ * the requests are queued as the cursor walks and the caller learns they
+ * committed by awaiting the transaction, not this. A failing cursor or delete
+ * aborts the transaction, which {@link awaitTransaction} reports.
+ */
+declare const deleteByIndex: (store: IDBObjectStore, indexName: string, value: IDBValidKey) => void;
+/** Read every row matching any of `values` on an index, flattened. */
+declare const getAllByIndexValues: <T>(store: IDBObjectStore, indexName: string, values: readonly IDBValidKey[]) => Promise<T[]>;
+
 declare const MESSAGE_BUS_NOT_INITIALIZED = "MessageBus not initialized";
 /**
  * Message for the "an init is in flight" variant.
@@ -6102,4 +6276,4 @@ declare class AssetManager extends ReadonlyAssetManager implements IAssetManager
     burn(params: BurnParams): Promise<string>;
 }
 
-export { ARKADE_MAGIC, ARKADE_SALTED_PREIMAGE_TAG, ARKADE_SWAP_PREIMAGE_TAG, Activity, ActivityRegistry, AmbiguousRouteError, type AnchorBumper, ArkAddress, ArkIntent, ArkNote, ArkProvider, type ArkPsbtFieldCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ArkTransaction, type ArkTxInput, type ArkadeBatchInput, ArkadeCash, ArkadeContractParams, type ArkadeExtendedCoin, type ArkadeExtendedVirtualCoin, Asset, AssetDetails, AssetManager, BIP21, BIP21Error, type BIP21Params, type BIP21ParseResult, BIP322, Batch, BatchExpiryPolicy, BurnParams, CSVMultisigTapscript, ChainTx, Coin, ConditionWitness, type ConnectorTreeNode, Contract, ContractEvent, ContractRepository, ContractRepositoryImpl, ContractSyncState, ContractWatcherConfig, ContractWithVtxos, CosignerPublicKey, CreateContractParams, DEFAULT_MESSAGE_TIMEOUTS, DefaultVtxo, DelegateInfo, DelegateNotConfiguredError, DelegatorNotConfiguredError, DescriptorIdentity, type DescriptorIdentityOptions, type DescriptorOptions, type DescriptorSigner, DescriptorSigningProviderMissingError, type DeterministicSigner, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, type BlockHeader as ElectrumBlockHeader, ElectrumOnchainProvider, type TransactionHistory as ElectrumTransactionHistory, type Unspent as ElectrumUnspent, type EmulatorEntry, type EmulatorInfo, EmulatorPacket, type EmulatorProvider, EncodedVtxoScript, Estimator, type ExcludableVtxo, type ExecutorEvent, type ExitDelay, type ExitFeeWallet, type ExitMode, type ExitOptions, type ExitPackage, type ExitQuote, type ExitStep, type ExitTotals, type ExitVtxoInfo, ExplorerTransaction, ExtendedCoin, ExtendedVirtualCoin, Extension, ExtensionNotFoundError, type ExtensionPacket, FeeAmount, FeeInfo, FeeOutput, FetchError, GetVtxosFilter, HDAllocationCapable, HDDescriptorProvider, type HDDeterministicSignCapable, HDWalletCapable, IAssetManager, IContractManager, IDelegateManager, IReadonlyAssetManager, IReadonlyWallet, IVtxoManager, IWallet, Identity, InMemoryContractRepository, InMemoryIntentRepository, InMemoryVirtualTxRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBIntentRepository, IndexedDBVirtualTxRepository, IndexedDBWalletRepository, IndexerProvider, Intent, IntentFeeConfig, IntentFilter, IntentRepository, IssuanceParams, IssuanceResult, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, type MessageHandler, type MessageTimeouts, MigrationGlobalSkipReason, MigrationLegSkipReason, type MigrationStatus, MissingSigningDescriptorError, MnemonicIdentity, type MnemonicOptions, Network, NetworkName, type NetworkOptions, OffchainInput, type OffchainTx, OnchainInput, OnchainProvider, OnchainWallet, Outpoint, P2A, type ParsedArkContract, PathContext, PathSelection, type PaymentHandle, type PaymentOption, type PaymentRail, type PaymentRequest, PaymentRouter, type PaymentStatus, PrevArkTxField, PrevoutTxField, ProviderConnectionState, type ProvisionedClaimSecret, type ProvisionedKey, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlyIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, Recipient, ReissuanceParams, RelativeTimelock, RenewVtxosOptions, type RequestEnvelope, type ResponseEnvelope, RestEmulatorProvider, type RouteQuote, type RouteResult, type RouterContext, type RouterPreferences, SeedIdentity, type SeedIdentityOptions, SendBitcoinParams, SendParams, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, type ServiceWorkerWalletMode, SettleParams, SettlementConfig, SettlementEvent, SignerSession, SignerStatus, SingleKey, Status, StorageConfig, TapLeafScript, Transaction, TxTree, TxWeightEstimator, UnannotatableInputError, UnilateralExit, UnknownPacket, Unroll, type VSize, type VerifyServerSignatures, VirtualCoin, VirtualTx, VirtualTxRepository, VtxoBranch, type VtxoExclusion, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, Wallet, WalletBalance, WalletCannotSignError, WalletMessageHandler, WalletNotInitializedError, WalletRepository, WalletRepositoryImpl, WsElectrumChainSource, adoptContractDescriptor, arkRail, arkTarget, index as arkade, assembleBtcdTaprootTree, assertFinalCommitmentMatchesValidated, assertSendableAmount, assertSubmittedArkTxid, index$1 as asset, btcTarget, buildForfeitTx, buildOffchainTx, buildPreimageMessage, buildSaltedPreimageMessage, buildVersion, claimWithPreimageIdentity, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, contractPreimage, contractSigner, createAssetPacket, createDefaultPaymentRouter, decodeArkContract, deriveDescriptorLeafCompressedPubKey, deriveDescriptorLeafPubKey, deserializeExitPackage, encodeArkContract, gateExclusion, gatedContracts, getArkPsbtFields, getMigrationStatus, hasBoardingTxExpired, identityDescriptor, invoiceTarget, isArkContract, isBtcAddress, isCltvSatisfied, isContractGenericallySpendable, isCsvSpendable, isDeterministicSigner, isHDDeterministicSignCapable, isLightningInvoice, isLnurl, isMessageBusInitializingError, isMessageBusNotInitializedError, isPerArtifactDescriptor, isRetryableProviderError, isValidArkAddress, logExcludedVtxos, makeHandle, matchServerCheckpoints, migrateWalletRepository, normalizeToDescriptor, onchainRail, openDatabase, outpointExclusion, outpointReasons, parseHDDescriptor, provisionClaimSecret, provisionRefundKey, requiresMigration, resolveSendAmount, rollbackMigration, sdkVersion, selectCoinsWithAsset, sequenceToTimelock, serializeExitPackage, setArkPsbtField, setupServiceWorker, signAndSubmitOffchainTx, timelockToSequence, tryResolveSendAmount, validateBatchRecipients, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures };
+export { ARKADE_MAGIC, ARKADE_SALTED_PREIMAGE_TAG, ARKADE_SWAP_PREIMAGE_TAG, Activity, ActivityRegistry, AmbiguousRouteError, type AnchorBumper, ArkAddress, ArkIntent, ArkNote, ArkProvider, type ArkPsbtFieldCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ArkTransaction, type ArkTxInput, type ArkadeBatchInput, ArkadeCash, ArkadeContractParams, type ArkadeExtendedCoin, type ArkadeExtendedVirtualCoin, Asset, AssetDetails, AssetManager, BIP21, BIP21Error, type BIP21Params, type BIP21ParseResult, BIP322, BLOCKED_UPGRADE_TIMEOUT_MS, Batch, BatchExpiryPolicy, BurnParams, CSVMultisigTapscript, ChainTx, Coin, ConditionWitness, ConnectionDisposedError, type ConnectorTreeNode, Contract, ContractEvent, ContractRepository, ContractRepositoryImpl, ContractSyncState, ContractWatcherConfig, ContractWithVtxos, CosignerPublicKey, CreateContractParams, DEFAULT_MESSAGE_TIMEOUTS, DatabaseUpgradeBlockedError, DefaultVtxo, DelegateInfo, DelegateNotConfiguredError, DelegatorNotConfiguredError, DescriptorIdentity, type DescriptorIdentityOptions, type DescriptorOptions, type DescriptorSigner, DescriptorSigningProviderMissingError, type DeterministicSigner, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, type BlockHeader as ElectrumBlockHeader, ElectrumOnchainProvider, type TransactionHistory as ElectrumTransactionHistory, type Unspent as ElectrumUnspent, type EmulatorEntry, type EmulatorInfo, EmulatorPacket, type EmulatorProvider, EncodedVtxoScript, Estimator, type ExcludableVtxo, type ExecutorEvent, type ExitDelay, type ExitFeeWallet, type ExitMode, type ExitOptions, type ExitPackage, type ExitQuote, type ExitStep, type ExitTotals, type ExitVtxoInfo, ExplorerTransaction, ExtendedCoin, ExtendedVirtualCoin, Extension, ExtensionNotFoundError, type ExtensionPacket, FeeAmount, FeeInfo, FeeOutput, FetchError, GetVtxosFilter, HDAllocationCapable, HDDescriptorProvider, type HDDeterministicSignCapable, HDWalletCapable, IAssetManager, IContractManager, IDelegateManager, IReadonlyAssetManager, IReadonlyWallet, IVtxoManager, IWallet, Identity, InMemoryContractRepository, InMemoryIntentRepository, InMemoryVirtualTxRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBIntentRepository, IndexedDBVirtualTxRepository, IndexedDBWalletRepository, IndexerProvider, Intent, IntentFeeConfig, IntentFilter, IntentRepository, IssuanceParams, IssuanceResult, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, type ManagedConnection, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, type MessageHandler, type MessageTimeouts, MigrationGlobalSkipReason, MigrationLegSkipReason, type MigrationStatus, MissingSigningDescriptorError, MnemonicIdentity, type MnemonicOptions, Network, NetworkName, type NetworkOptions, OffchainInput, type OffchainTx, OnchainInput, OnchainProvider, OnchainWallet, Outpoint, P2A, type ParsedArkContract, PathContext, PathSelection, type PaymentHandle, type PaymentOption, type PaymentRail, type PaymentRequest, PaymentRouter, type PaymentStatus, PrevArkTxField, PrevoutTxField, ProviderConnectionState, type ProvisionedClaimSecret, type ProvisionedKey, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlyIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, Recipient, ReissuanceParams, RelativeTimelock, RenewVtxosOptions, type RequestEnvelope, type ResponseEnvelope, RestEmulatorProvider, type RouteQuote, type RouteResult, type RouterContext, type RouterPreferences, SeedIdentity, type SeedIdentityOptions, SendBitcoinParams, SendParams, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, type ServiceWorkerWalletMode, SettleParams, SettlementConfig, SettlementEvent, SignerSession, SignerStatus, SingleKey, Status, StorageConfig, TapLeafScript, Transaction, TxTree, TxWeightEstimator, UnannotatableInputError, UnilateralExit, UnknownPacket, Unroll, type VSize, type VerifyServerSignatures, VirtualCoin, VirtualTx, VirtualTxRepository, VtxoBranch, type VtxoExclusion, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, Wallet, WalletBalance, WalletCannotSignError, WalletMessageHandler, WalletNotInitializedError, WalletRepository, WalletRepositoryImpl, WsElectrumChainSource, adoptContractDescriptor, arkRail, arkTarget, index as arkade, assembleBtcdTaprootTree, assertFinalCommitmentMatchesValidated, assertSendableAmount, assertSubmittedArkTxid, index$1 as asset, awaitTransaction, btcTarget, buildForfeitTx, buildOffchainTx, buildPreimageMessage, buildSaltedPreimageMessage, buildVersion, claimWithPreimageIdentity, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, contractPreimage, contractSigner, createAssetPacket, createDefaultPaymentRouter, createManagedConnection, decodeArkContract, deleteByIndex, deriveDescriptorLeafCompressedPubKey, deriveDescriptorLeafPubKey, deserializeExitPackage, encodeArkContract, gateExclusion, gatedContracts, getAllByIndexValues, getArkPsbtFields, getMigrationStatus, hasBoardingTxExpired, identityDescriptor, invoiceTarget, isArkContract, isBtcAddress, isCltvSatisfied, isContractGenericallySpendable, isCsvSpendable, isDeterministicSigner, isHDDeterministicSignCapable, isLightningInvoice, isLnurl, isMessageBusInitializingError, isMessageBusNotInitializedError, isPerArtifactDescriptor, isRetryableProviderError, isValidArkAddress, logExcludedVtxos, makeHandle, matchServerCheckpoints, migrateWalletRepository, normalizeToDescriptor, onchainRail, openDatabase, outpointExclusion, outpointReasons, parseHDDescriptor, promisifyRequest, provisionClaimSecret, provisionRefundKey, requiresMigration, resolveSendAmount, rollbackMigration, sdkVersion, selectCoinsWithAsset, sequenceToTimelock, serializeExitPackage, setArkPsbtField, setupServiceWorker, signAndSubmitOffchainTx, timelockToSequence, tryResolveSendAmount, validateBatchRecipients, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures };