@arkade-os/sdk 0.4.22 → 0.4.23

package/dist/cjs/identity/seedIdentity.js

@@ -11,6 +11,7 @@ const base_1 = require("@scure/base");
 const signingSession_1 = require("../tree/signingSession");
 const secp256k1_1 = require("@noble/secp256k1");
 const descriptors_scure_1 = require("@bitcoinerlab/descriptors-scure");
+const descriptor_1 = require("./descriptor");
 const ALL_SIGHASH = Object.values(btc_signer_1.SigHash).filter((x) => typeof x === "number");
 /**
  * Secret-bearing state for seed-backed identities, held off the public
@@ -24,85 +25,117 @@ const ALL_SIGHASH = Object.values(btc_signer_1.SigHash).filter((x) => typeof x =
  */
 const seedBytes = new WeakMap();
 const mnemonicMeta = new WeakMap();
-// ── Helpers ──────────────────────────────────────────────────────
 /**
- * Detects the network from a descriptor string by checking for tpub (testnet)
- * vs xpub (mainnet) key prefix.
- * @internal
- */
-function detectNetwork(descriptor) {
-    return descriptor.includes("tpub") ? descriptors_scure_1.networks.testnet : descriptors_scure_1.networks.bitcoin;
-}
-function hasDescriptor(opts = {}) {
-    return "descriptor" in opts && typeof opts.descriptor === "string";
-}
-/**
- * Builds a BIP86 Taproot output descriptor from a seed and network flag.
- * @internal
- */
-function buildDescriptor(seed, isMainnet) {
-    const network = isMainnet ? descriptors_scure_1.networks.bitcoin : descriptors_scure_1.networks.testnet;
-    const masterNode = descriptors_scure_1.HDKey.fromMasterSeed(seed, network.bip32);
-    return descriptors_scure_1.scriptExpressions.trBIP32({
-        masterNode,
-        network,
-        account: 0,
-        change: 0,
-        index: 0,
-    });
-}
-/**
- * Seed-based identity derived from a raw seed and an output descriptor.
+ * Seed-based identity derived from a raw seed and an account descriptor
+ * *template*.
  *
  * This is the recommended identity type for most applications. It uses
- * standard BIP86 (Taproot) derivation by default and stores an output
- * descriptor for interoperability with other wallets.
+ * standard BIP86 (Taproot) derivation by default; callers that need a
+ * different path supply the wildcard template directly.
  *
  * Prefer this (or @see MnemonicIdentity) over `SingleKey` for new
  * integrations — `SingleKey` exists for backward compatibility with
  * raw nsec-style keys.
  *
- * For descriptor-based signing, wrap with {@link StaticDescriptorProvider}.
+ * The identity holds the wildcard *template* (e.g.
+ * `tr([fp/86'/0'/0']xpub/0/*)`) on its public {@link descriptor}
+ * field. HD rotation reads it directly; consumers that need a
+ * concrete descriptor at a specific index materialize it themselves
+ * (see `HDDescriptorProvider` in the wallet layer).
+ *
+ * Exposes seed-level primitives (signing, derivation, the template)
+ * but is deliberately NOT a `DescriptorProvider`. Wrap it explicitly
+ * to get one:
+ *  - `HDDescriptorProvider` for rotating receive addresses.
+ *  - {@link StaticDescriptorProvider} for legacy, single-key behaviour.
+ *
+ * The split prevents a SeedIdentity from being silently used as a
+ * concrete descriptor source, which would defeat HD rotation without
+ * any compile-time signal that something was wrong.
  *
  * @example
  * ```typescript
  * const seed = mnemonicToSeedSync(mnemonic);
  *
- * // Testnet (BIP86 path m/86'/1'/0'/0/0)
+ * // Testnet (BIP86 wildcard descriptor m/86'/1'/0'/0/*)
  * const identity = SeedIdentity.fromSeed(seed, { isMainnet: false });
  *
- * // Mainnet (BIP86 path m/86'/0'/0'/0/0)
+ * // Mainnet (BIP86 wildcard descriptor m/86'/0'/0'/0/*)
  * const identity = SeedIdentity.fromSeed(seed, { isMainnet: true });
  *
- * // Custom descriptor
+ * // Caller-supplied wildcard descriptor (must end in `/*)`).
  * const identity = SeedIdentity.fromSeed(seed, { descriptor });
  * ```
  */
 class SeedIdentity {
-    constructor(seed, descriptor) {
+    /**
+     * Constructs a SeedIdentity from a 64-byte seed and either a
+     * caller-supplied wildcard descriptor (`{ descriptor }`) or the
+     * default BIP86 path at the requested network (`{ isMainnet }`).
+     * Prefer the {@link fromSeed} factory for symmetry with
+     * {@link MnemonicIdentity.fromMnemonic}.
+     *
+     * Throws on a non-wildcard descriptor, an xpub mismatch with the
+     * seed, or a missing derivation path.
+     */
+    constructor(seed, opts = {}) {
         if (seed.length !== 64) {
             throw new Error("Seed must be 64 bytes");
         }
+        // Resolve the descriptor: caller-supplied wins; otherwise build
+        // the BIP86 default at the requested network via the library.
+        let descriptor;
+        let network;
+        if ("descriptor" in opts && typeof opts.descriptor === "string") {
+            descriptor = opts.descriptor;
+            network = (0, descriptor_1.isMainnetDescriptor)(descriptor)
+                ? descriptors_scure_1.networks.bitcoin
+                : descriptors_scure_1.networks.testnet;
+        }
+        else {
+            network =
+                (opts.isMainnet ?? true)
+                    ? descriptors_scure_1.networks.bitcoin
+                    : descriptors_scure_1.networks.testnet;
+            descriptor = descriptors_scure_1.scriptExpressions.trBIP32({
+                masterNode: descriptors_scure_1.HDKey.fromMasterSeed(seed, network.bip32),
+                network,
+                account: 0,
+                change: 0,
+                index: "*",
+            });
+        }
+        // Parse the descriptor, substituting the wildcard at index 0.
+        // The library raises "index passed for non-ranged descriptor"
+        // if the input isn't a wildcard template, which we re-wrap so
+        // the caller sees what they actually got wrong.
+        let expansion;
+        try {
+            expansion = (0, descriptors_scure_1.expand)({ descriptor, network, index: 0 });
+        }
+        catch (e) {
+            throw new Error(`SeedIdentity requires a wildcard descriptor template (must end in "/*)"); ${e instanceof Error ? e.message : String(e)}`);
+        }
+        const keyInfo = expansion.expansionMap?.["@0"];
         // Defensive copy: `derivedKey` and `descriptor` are computed eagerly
         // from the bytes we're about to stash, so a later mutation of the
         // caller's buffer must not drift the serialized `seed` out of sync
         // with the live identity state.
         seedBytes.set(this, new Uint8Array(seed));
         this.descriptor = descriptor;
-        const network = detectNetwork(descriptor);
-        // Parse and validate the descriptor using the library
-        const expansion = (0, descriptors_scure_1.expand)({ descriptor, network });
-        const keyInfo = expansion.expansionMap?.["@0"];
         if (!keyInfo?.originPath) {
             throw new Error("Descriptor must include a key origin path");
         }
-        // Verify the xpub in the descriptor matches our seed
+        // Verify the xpub in the descriptor matches our seed (validates
+        // that the descriptor was generated from this seed; we don't
+        // need to keep the xpub around afterwards — `isOurs` re-derives
+        // it from `this.descriptor` on demand).
         const masterNode = descriptors_scure_1.HDKey.fromMasterSeed(seed, network.bip32);
         const accountNode = masterNode.derive(`m${keyInfo.originPath}`);
         if (accountNode.publicExtendedKey !== keyInfo.bip32?.toBase58()) {
             throw new Error("xpub mismatch: derived key does not match descriptor");
         }
-        // Derive the private key using the full path from the descriptor
+        // Derive the private key for index 0 using the full path
         if (!keyInfo.path) {
             throw new Error("Descriptor must specify a full derivation path");
         }
@@ -116,16 +149,14 @@ class SeedIdentity {
      * Creates a SeedIdentity from a raw 64-byte seed.
      *
      * Pass `{ isMainnet }` for default BIP86 derivation, or
-     * `{ descriptor }` for a custom derivation path.
+     * `{ descriptor }` for a caller-supplied account-descriptor
+     * template (the option's value must end with `/*)`).
      *
      * @param seed - 64-byte seed (typically from mnemonicToSeedSync)
-     * @param opts - Network selection or custom descriptor.
+     * @param opts - Network selection or descriptor template.
      */
     static fromSeed(seed, opts = {}) {
-        const descriptor = hasDescriptor(opts)
-            ? opts.descriptor
-            : buildDescriptor(seed, opts.isMainnet ?? true);
-        return new SeedIdentity(seed, descriptor);
+        return new SeedIdentity(seed, opts);
     }
     async xOnlyPublicKey() {
         return (0, utils_js_1.pubSchnorr)(this.derivedKey);
@@ -134,10 +165,82 @@ class SeedIdentity {
         return (0, utils_js_1.pubECDSA)(this.derivedKey, true);
     }
     async sign(tx, inputIndexes) {
+        return this.signTxWithKey(tx, this.derivedKey, inputIndexes);
+    }
+    async signMessage(message, signatureType = "schnorr") {
+        return this.signMessageWithKey(this.derivedKey, message, signatureType);
+    }
+    signerSession() {
+        return signingSession_1.TreeSignerSession.random();
+    }
+    /**
+     * Converts to a watch-only identity that cannot sign. Carries the
+     * template forward, so the readonly side stays HD-capable (can
+     * derive descriptors at any index without seed access).
+     */
+    async toReadonly() {
+        return ReadonlyDescriptorIdentity.fromDescriptor(this.descriptor);
+    }
+    /**
+     * Returns true when `descriptor` is derived from this identity's seed.
+     * HD descriptors match by account xpub; bare `tr(pubkey)` descriptors
+     * match by raw pubkey. See {@link descriptorIsOurs}.
+     */
+    isOurs(descriptor) {
+        return (0, descriptor_1.descriptorIsOurs)(descriptor, this.descriptor, (0, utils_js_1.pubSchnorr)(this.derivedKey));
+    }
+    /**
+     * Signs each request with the key derived from its descriptor.
+     * Each descriptor must share this identity's seed ({@link isOurs}).
+     */
+    async signWithDescriptor(requests) {
+        return requests.map((request) => {
+            if (!this.isOurs(request.descriptor)) {
+                throw new Error(`Descriptor ${request.descriptor} does not belong to this identity`);
+            }
+            const key = this.derivePrivateKeyForDescriptor(request.descriptor);
+            return this.signTxWithKey(request.tx, key, request.inputIndexes);
+        });
+    }
+    /**
+     * Signs a message with the key derived from `descriptor`.
+     */
+    async signMessageWithDescriptor(descriptor, message, signatureType = "schnorr") {
+        if (!this.isOurs(descriptor)) {
+            throw new Error(`Descriptor ${descriptor} does not belong to this identity`);
+        }
+        const key = this.derivePrivateKeyForDescriptor(descriptor);
+        return this.signMessageWithKey(key, message, signatureType);
+    }
+    // ── internal helpers ─────────────────────────────────────────────
+    derivePrivateKeyForDescriptor(descriptor) {
+        const network = (0, descriptor_1.isMainnetDescriptor)(descriptor)
+            ? descriptors_scure_1.networks.bitcoin
+            : descriptors_scure_1.networks.testnet;
+        const expansion = (0, descriptors_scure_1.expand)({ descriptor, network });
+        if (expansion.isRanged) {
+            throw new Error("Cannot sign with a wildcard descriptor; derive a concrete index first");
+        }
+        const keyInfo = expansion.expansionMap?.["@0"];
+        if (!keyInfo?.path) {
+            throw new Error("Descriptor must specify a full derivation path for signing");
+        }
+        const seed = seedBytes.get(this);
+        if (!seed) {
+            throw new Error("Seed bytes not available for descriptor signing");
+        }
+        const masterNode = descriptors_scure_1.HDKey.fromMasterSeed(seed, network.bip32);
+        const node = masterNode.derive(keyInfo.path);
+        if (!node.privateKey) {
+            throw new Error("Failed to derive private key for descriptor");
+        }
+        return node.privateKey;
+    }
+    signTxWithKey(tx, key, inputIndexes) {
         const txCpy = tx.clone();
         if (!inputIndexes) {
             try {
-                if (!txCpy.sign(this.derivedKey, ALL_SIGHASH)) {
+                if (!txCpy.sign(key, ALL_SIGHASH)) {
                     throw new Error("Failed to sign transaction");
                 }
             }
@@ -150,29 +253,20 @@ class SeedIdentity {
                     throw e;
                 }
             }
-            return txCpy;
         }
-        for (const inputIndex of inputIndexes) {
-            if (!txCpy.signIdx(this.derivedKey, inputIndex, ALL_SIGHASH)) {
-                throw new Error(`Failed to sign input #${inputIndex}`);
+        else {
+            for (const idx of inputIndexes) {
+                if (!txCpy.signIdx(key, idx, ALL_SIGHASH)) {
+                    throw new Error(`Failed to sign input #${idx}`);
+                }
             }
         }
         return txCpy;
     }
-    async signMessage(message, signatureType = "schnorr") {
-        if (signatureType === "ecdsa") {
-            return (0, secp256k1_1.signAsync)(message, this.derivedKey, { prehash: false });
-        }
-        return secp256k1_1.schnorr.signAsync(message, this.derivedKey);
-    }
-    signerSession() {
-        return signingSession_1.TreeSignerSession.random();
-    }
-    /**
-     * Converts to a watch-only identity that cannot sign.
-     */
-    async toReadonly() {
-        return ReadonlyDescriptorIdentity.fromDescriptor(this.descriptor);
+    signMessageWithKey(key, message, signatureType) {
+        if (signatureType === "ecdsa")
+            return (0, secp256k1_1.signAsync)(message, key, { prehash: false });
+        return secp256k1_1.schnorr.signAsync(message, key);
     }
 }
 exports.SeedIdentity = SeedIdentity;
@@ -193,83 +287,108 @@ exports.SeedIdentity = SeedIdentity;
  * ```
  */
 class MnemonicIdentity extends SeedIdentity {
-    constructor(seed, descriptor, mnemonic, passphrase) {
-        super(seed, descriptor);
-        mnemonicMeta.set(this, { mnemonic, passphrase });
+    constructor(phrase, opts) {
+        const { passphrase } = opts;
+        super((0, bip39_1.mnemonicToSeedSync)(phrase, passphrase), opts);
+        mnemonicMeta.set(this, { mnemonic: phrase, passphrase });
     }
     /**
      * Creates a MnemonicIdentity from a BIP39 mnemonic phrase.
      *
      * Pass `{ isMainnet }` for default BIP86 derivation, or
-     * `{ descriptor }` for a custom derivation path.
+     * `{ descriptor }` for a caller-supplied account-descriptor
+     * template (the option's value must end with `/*)`).
      *
      * @param phrase - BIP39 mnemonic phrase (12 or 24 words)
-     * @param opts - Network selection or custom descriptor, plus optional passphrase
+     * @param opts - Network selection or descriptor template, plus optional passphrase
      */
     static fromMnemonic(phrase, opts = {}) {
         if (!(0, bip39_1.validateMnemonic)(phrase, english_js_1.wordlist)) {
             throw new Error("Invalid mnemonic");
         }
-        const passphrase = opts.passphrase;
-        const seed = (0, bip39_1.mnemonicToSeedSync)(phrase, passphrase);
-        const descriptor = hasDescriptor(opts)
-            ? opts.descriptor
-            : buildDescriptor(seed, opts.isMainnet ?? true);
-        return new MnemonicIdentity(seed, descriptor, phrase, passphrase);
+        return new MnemonicIdentity(phrase, opts);
     }
 }
 exports.MnemonicIdentity = MnemonicIdentity;
 /**
- * Watch-only identity from an output descriptor.
+ * Watch-only HD identity from a descriptor *template*.
  *
  * Can derive public keys but cannot sign transactions. Use this for
- * watch-only wallets or when sharing identity information without
- * exposing private keys.
+ * watch-only wallets — given just an xpub-based template, the readonly
+ * side still rotates through HD indices.
+ *
+ * Constructed from a wildcard template (e.g.
+ * `tr([fp/86'/0'/0']xpub.../0/*)`); the {@link descriptor} field
+ * holds it for HD providers to consume.
  *
  * @example
  * ```typescript
- * const descriptor = "tr([fingerprint/86'/0'/0']xpub.../0/0)";
- * const readonly = ReadonlyDescriptorIdentity.fromDescriptor(descriptor);
- * const pubKey = await readonly.xOnlyPublicKey();
+ * const ro = ReadonlyDescriptorIdentity.fromDescriptor(
+ *   "tr([fp/86'/0'/0']xpub.../0/*)"
+ * );
+ * ro.descriptor;
+ * // => "tr([fp/86'/0'/0']xpub.../0/*)" — the template
  * ```
  */
 class ReadonlyDescriptorIdentity {
     constructor(descriptor) {
-        this.descriptor = descriptor;
-        const network = detectNetwork(descriptor);
-        const expansion = (0, descriptors_scure_1.expand)({ descriptor, network });
+        const network = (0, descriptor_1.isMainnetDescriptor)(descriptor)
+            ? descriptors_scure_1.networks.bitcoin
+            : descriptors_scure_1.networks.testnet;
+        // Library substitutes the wildcard at index 0 and raises
+        // "index passed for non-ranged descriptor" if `descriptor` isn't
+        // actually a wildcard template — re-wrap so the caller sees
+        // the higher-level invariant they violated.
+        let expansion;
+        try {
+            expansion = (0, descriptors_scure_1.expand)({ descriptor, network, index: 0 });
+        }
+        catch (e) {
+            throw new Error(`ReadonlyDescriptorIdentity requires a wildcard descriptor template (must end in "/*)"); ${e instanceof Error ? e.message : String(e)}`);
+        }
         const keyInfo = expansion.expansionMap?.["@0"];
         if (!keyInfo?.pubkey) {
             throw new Error("Failed to derive public key from descriptor");
         }
-        // For taproot, the library returns 32-byte x-only pubkey
-        this.xOnlyPubKey = keyInfo.pubkey;
-        // Get 33-byte compressed key with correct parity from the bip32 node
-        if (keyInfo.bip32 && keyInfo.keyPath) {
-            // Strip leading "/" — the library's derivePath prepends "m/" itself
-            const relPath = keyInfo.keyPath.replace(/^\//, "");
-            this.compressedPubKey = keyInfo.bip32.derivePath(relPath).publicKey;
-        }
-        else if (keyInfo.bip32) {
-            this.compressedPubKey = keyInfo.bip32.publicKey;
-        }
-        else {
+        if (!keyInfo.bip32) {
             throw new Error("Cannot determine compressed public key parity from descriptor");
         }
+        this.descriptor = descriptor;
+        this.indexZero = keyInfo;
     }
     /**
-     * Creates a ReadonlyDescriptorIdentity from an output descriptor.
+     * Creates a ReadonlyDescriptorIdentity from an account-descriptor
+     * *template* (must end with the BIP-32 wildcard suffix `/*)`).
      *
-     * @param descriptor - Taproot descriptor: tr([fingerprint/path']xpub.../child/path)
+     * @param descriptor - Wildcard-suffixed Taproot template
+     *   (`tr([fp/path']xpub.../child/*)`).
      */
     static fromDescriptor(descriptor) {
         return new ReadonlyDescriptorIdentity(descriptor);
     }
     async xOnlyPublicKey() {
-        return this.xOnlyPubKey;
+        // Validated non-null in the constructor.
+        return this.indexZero.pubkey;
     }
     async compressedPublicKey() {
-        return this.compressedPubKey;
+        const { bip32, keyPath } = this.indexZero;
+        // bip32 validated non-null in the constructor; derivePath
+        // returns a fresh node so this is a read of the index-0
+        // compressed pubkey, not a mutation of the stored one.
+        if (keyPath) {
+            // Strip leading "/" — the library's derivePath prepends "m/" itself
+            return bip32.derivePath(keyPath.replace(/^\//, "")).publicKey;
+        }
+        return bip32.publicKey;
+    }
+    /**
+     * Returns true when `descriptor` derives from this identity's xpub.
+     * HD descriptors match by account xpub; bare `tr(pubkey)` descriptors
+     * fall back to comparing against the index-0 x-only pubkey. See
+     * {@link descriptorIsOurs}.
+     */
+    isOurs(descriptor) {
+        return (0, descriptor_1.descriptorIsOurs)(descriptor, this.descriptor, this.indexZero.pubkey);
     }
 }
 exports.ReadonlyDescriptorIdentity = ReadonlyDescriptorIdentity;
@@ -335,5 +454,8 @@ function serializeSeedOwnedSigningIdentity(identity) {
  * @internal
  */
 function serializeSeedOwnedReadonlyIdentity(identity) {
-    return { type: "readonly-descriptor", descriptor: identity.descriptor };
+    return {
+        type: "readonly-descriptor",
+        descriptor: identity.descriptor,
+    };
 }

package/dist/cjs/identity/serialize.js

@@ -61,6 +61,11 @@ async function serializeReadonlyIdentity(identity) {
  * The return type is the union of signing and readonly; use
  * {@link isSigningSerialized} on the envelope before hydration if the caller
  * needs to know which side it ends up on.
+ *
+ * Envelopes store the wildcard template directly (see
+ * `serializeSeedOwnedSigningIdentity` / `serializeSeedOwnedReadonlyIdentity`),
+ * so the `descriptor` field is passed straight through to the
+ * template-only factories.
  */
 function hydrateIdentity(s) {
     switch (s.type) {

package/dist/cjs/identity/staticDescriptorProvider.js

@@ -18,7 +18,7 @@ class StaticDescriptorProvider {
         const pubKey = await identity.xOnlyPublicKey();
         return new StaticDescriptorProvider(identity, base_1.hex.encode(pubKey));
     }
-    getSigningDescriptor() {
+    async getNextSigningDescriptor() {
         return this.descriptor;
     }
     isOurs(descriptor) {

package/dist/cjs/index.js

@@ -36,9 +36,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArkPsbtFieldKeyType = exports.ArkPsbtFieldKey = exports.TapTreeCoder = exports.CLTVMultisigTapscript = exports.ConditionMultisigTapscript = exports.ConditionCSVMultisigTapscript = exports.CSVMultisigTapscript = exports.MultisigTapscript = exports.decodeTapscript = exports.DEFAULT_MESSAGE_TIMEOUTS = exports.ServiceWorkerReadonlyWallet = exports.ServiceWorkerWallet = exports.ServiceWorkerTimeoutError = exports.MessageBusNotInitializedError = exports.MESSAGE_BUS_NOT_INITIALIZED = exports.DelegatorNotConfiguredError = exports.ReadonlyWalletError = exports.WalletNotInitializedError = exports.WalletMessageHandler = exports.MessageBus = exports.setupServiceWorker = exports.SettlementEventType = exports.ChainTxType = exports.IndexerTxType = exports.TxType = exports.VHTLC = exports.VtxoScript = exports.DelegateVtxo = exports.DefaultVtxo = exports.ArkAddress = exports.RestIndexerProvider = exports.RestArkProvider = exports.WsElectrumChainSource = exports.ElectrumOnchainProvider = exports.EsploraProvider = exports.ESPLORA_URL = exports.RestDelegatorProvider = exports.DelegatorManagerImpl = exports.VtxoManager = exports.Ramps = exports.OnchainWallet = exports.isBatchSignable = exports.ReadonlyDescriptorIdentity = exports.MnemonicIdentity = exports.SeedIdentity = exports.ReadonlySingleKey = exports.SingleKey = exports.ReadonlyWallet = exports.Wallet = exports.asset = void 0;
-exports.DelegateContractHandler = exports.DefaultContractHandler = exports.contractHandlers = exports.ContractWatcher = exports.ContractManager = exports.getSequence = exports.isExpired = exports.isSubdust = exports.isSpendable = exports.isRecoverable = exports.buildForfeitTx = exports.validateConnectorsTxGraph = exports.validateVtxoTxGraph = exports.Batch = exports.maybeArkError = exports.ArkError = exports.Transaction = exports.Unroll = exports.P2A = exports.TxTree = exports.BIP322 = exports.Intent = exports.ContractRepositoryImpl = exports.WalletRepositoryImpl = exports.rollbackMigration = exports.getMigrationStatus = exports.requiresMigration = exports.migrateWalletRepository = exports.MIGRATION_KEY = exports.InMemoryContractRepository = exports.InMemoryWalletRepository = exports.IndexedDBContractRepository = exports.IndexedDBWalletRepository = exports.openDatabase = exports.closeDatabase = exports.networks = exports.ArkNote = exports.isValidArkAddress = exports.isVtxoExpiringSoon = exports.combineTapscriptSigs = exports.hasBoardingTxExpired = exports.waitForIncomingFunds = exports.verifyTapscriptSignatures = exports.buildOffchainTx = exports.ConditionWitness = exports.VtxoTaprootTree = exports.VtxoTreeExpiry = exports.CosignerPublicKey = exports.getArkPsbtFields = exports.setArkPsbtField = void 0;
-exports.isArkContract = exports.contractFromArkContractWithAddress = exports.contractFromArkContract = exports.decodeArkContract = exports.encodeArkContract = exports.VHTLCContractHandler = void 0;
+exports.CLTVMultisigTapscript = exports.ConditionMultisigTapscript = exports.ConditionCSVMultisigTapscript = exports.CSVMultisigTapscript = exports.MultisigTapscript = exports.decodeTapscript = exports.DEFAULT_MESSAGE_TIMEOUTS = exports.ServiceWorkerReadonlyWallet = exports.ServiceWorkerWallet = exports.ServiceWorkerTimeoutError = exports.MessageBusNotInitializedError = exports.MESSAGE_BUS_NOT_INITIALIZED = exports.DelegatorNotConfiguredError = exports.ReadonlyWalletError = exports.WalletNotInitializedError = exports.WalletMessageHandler = exports.MessageBus = exports.setupServiceWorker = exports.SettlementEventType = exports.ChainTxType = exports.IndexerTxType = exports.TxType = exports.VHTLC = exports.VtxoScript = exports.DelegateVtxo = exports.DefaultVtxo = exports.ArkAddress = exports.RestIndexerProvider = exports.RestArkProvider = exports.WsElectrumChainSource = exports.ElectrumOnchainProvider = exports.ELECTRUM_TCP_HOST = exports.ELECTRUM_WS_URL = exports.EsploraProvider = exports.ESPLORA_URL = exports.RestDelegatorProvider = exports.DelegatorManagerImpl = exports.HDDescriptorProvider = exports.VtxoManager = exports.Ramps = exports.OnchainWallet = exports.isBatchSignable = exports.ReadonlyDescriptorIdentity = exports.MnemonicIdentity = exports.SeedIdentity = exports.ReadonlySingleKey = exports.SingleKey = exports.ReadonlyWallet = exports.Wallet = exports.asset = void 0;
+exports.isExpired = exports.isSubdust = exports.isSpendable = exports.isRecoverable = exports.buildForfeitTx = exports.validateConnectorsTxGraph = exports.validateVtxoTxGraph = exports.Batch = exports.maybeArkError = exports.ArkError = exports.sequenceToTimelock = exports.timelockToSequence = exports.TxWeightEstimator = exports.Transaction = exports.Unroll = exports.P2A = exports.TxTree = exports.BIP322 = exports.Intent = exports.ContractRepositoryImpl = exports.WalletRepositoryImpl = exports.rollbackMigration = exports.getMigrationStatus = exports.requiresMigration = exports.migrateWalletRepository = exports.MIGRATION_KEY = exports.InMemoryContractRepository = exports.InMemoryWalletRepository = exports.IndexedDBContractRepository = exports.IndexedDBWalletRepository = exports.openDatabase = exports.closeDatabase = exports.networks = exports.ArkNote = exports.isValidArkAddress = exports.isVtxoExpiringSoon = exports.combineTapscriptSigs = exports.hasBoardingTxExpired = exports.waitForIncomingFunds = exports.verifyTapscriptSignatures = exports.buildOffchainTx = exports.ConditionWitness = exports.VtxoTaprootTree = exports.VtxoTreeExpiry = exports.CosignerPublicKey = exports.getArkPsbtFields = exports.setArkPsbtField = exports.ArkPsbtFieldKeyType = exports.ArkPsbtFieldKey = exports.TapTreeCoder = void 0;
+exports.isArkContract = exports.contractFromArkContractWithAddress = exports.contractFromArkContract = exports.decodeArkContract = exports.encodeArkContract = exports.VHTLCContractHandler = exports.DelegateContractHandler = exports.DefaultContractHandler = exports.contractHandlers = exports.ContractWatcher = exports.ContractManager = exports.getSequence = void 0;
 const transaction_1 = require("./utils/transaction");
 Object.defineProperty(exports, "Transaction", { enumerable: true, get: function () { return transaction_1.Transaction; } });
 const singleKey_1 = require("./identity/singleKey");
@@ -80,6 +80,8 @@ const txTree_1 = require("./tree/txTree");
 Object.defineProperty(exports, "TxTree", { enumerable: true, get: function () { return txTree_1.TxTree; } });
 const ramps_1 = require("./wallet/ramps");
 Object.defineProperty(exports, "Ramps", { enumerable: true, get: function () { return ramps_1.Ramps; } });
+const hdDescriptorProvider_1 = require("./wallet/hdDescriptorProvider");
+Object.defineProperty(exports, "HDDescriptorProvider", { enumerable: true, get: function () { return hdDescriptorProvider_1.HDDescriptorProvider; } });
 const vtxo_manager_1 = require("./wallet/vtxo-manager");
 Object.defineProperty(exports, "isVtxoExpiringSoon", { enumerable: true, get: function () { return vtxo_manager_1.isVtxoExpiringSoon; } });
 Object.defineProperty(exports, "VtxoManager", { enumerable: true, get: function () { return vtxo_manager_1.VtxoManager; } });
@@ -95,6 +97,8 @@ const onchain_2 = require("./providers/onchain");
 Object.defineProperty(exports, "ESPLORA_URL", { enumerable: true, get: function () { return onchain_2.ESPLORA_URL; } });
 Object.defineProperty(exports, "EsploraProvider", { enumerable: true, get: function () { return onchain_2.EsploraProvider; } });
 const electrum_1 = require("./providers/electrum");
+Object.defineProperty(exports, "ELECTRUM_TCP_HOST", { enumerable: true, get: function () { return electrum_1.ELECTRUM_TCP_HOST; } });
+Object.defineProperty(exports, "ELECTRUM_WS_URL", { enumerable: true, get: function () { return electrum_1.ELECTRUM_WS_URL; } });
 Object.defineProperty(exports, "ElectrumOnchainProvider", { enumerable: true, get: function () { return electrum_1.ElectrumOnchainProvider; } });
 Object.defineProperty(exports, "WsElectrumChainSource", { enumerable: true, get: function () { return electrum_1.WsElectrumChainSource; } });
 const ark_1 = require("./providers/ark");
@@ -138,6 +142,8 @@ Object.defineProperty(exports, "IndexerTxType", { enumerable: true, get: functio
 Object.defineProperty(exports, "ChainTxType", { enumerable: true, get: function () { return indexer_1.ChainTxType; } });
 const anchor_1 = require("./utils/anchor");
 Object.defineProperty(exports, "P2A", { enumerable: true, get: function () { return anchor_1.P2A; } });
+const txSizeEstimator_1 = require("./utils/txSizeEstimator");
+Object.defineProperty(exports, "TxWeightEstimator", { enumerable: true, get: function () { return txSizeEstimator_1.TxWeightEstimator; } });
 const unroll_1 = require("./wallet/unroll");
 Object.defineProperty(exports, "Unroll", { enumerable: true, get: function () { return unroll_1.Unroll; } });
 const errors_1 = require("./providers/errors");
@@ -177,6 +183,9 @@ Object.defineProperty(exports, "decodeArkContract", { enumerable: true, get: fun
 Object.defineProperty(exports, "contractFromArkContract", { enumerable: true, get: function () { return contracts_1.contractFromArkContract; } });
 Object.defineProperty(exports, "contractFromArkContractWithAddress", { enumerable: true, get: function () { return contracts_1.contractFromArkContractWithAddress; } });
 Object.defineProperty(exports, "isArkContract", { enumerable: true, get: function () { return contracts_1.isArkContract; } });
+const helpers_1 = require("./contracts/handlers/helpers");
+Object.defineProperty(exports, "timelockToSequence", { enumerable: true, get: function () { return helpers_1.timelockToSequence; } });
+Object.defineProperty(exports, "sequenceToTimelock", { enumerable: true, get: function () { return helpers_1.sequenceToTimelock; } });
 const manager_1 = require("./repositories/indexedDB/manager");
 Object.defineProperty(exports, "closeDatabase", { enumerable: true, get: function () { return manager_1.closeDatabase; } });
 Object.defineProperty(exports, "openDatabase", { enumerable: true, get: function () { return manager_1.openDatabase; } });