@arkade-os/sdk 0.4.25 → 0.4.27

package/dist/esm/wallet/inputSignerRouter.js

@@ -0,0 +1,94 @@
+import { hex } from "@scure/base";
+import { DescriptorSigningProviderMissingError, MissingSigningDescriptorError, } from "./signingErrors.js";
+const DESCRIPTOR_CAPABLE_CONTRACT_TYPES = new Set(["default", "delegate"]);
+/**
+ * Routes PSBT inputs to the correct signer based on the owning contract.
+ * Inputs whose script matches a `default`/`delegate` contract with a
+ * non-baseline owner are sent to {@link DescriptorProvider}; everything
+ * else (baseline-owned contracts, non-default/non-delegate contracts,
+ * and the boarding script) is sent to {@link Identity}. Inputs with no
+ * matching contract and no boarding match are silently skipped, matching
+ * how the wallet historically handled cosigner/connector inputs.
+ */
+export class InputSignerRouter {
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async sign(tx, jobs) {
+        if (jobs.length === 0)
+            return tx;
+        const distinctScripts = Array.from(new Set(jobs.map((j) => hex.encode(j.lookupScript))));
+        const contracts = await this.deps.contractRepository.getContracts({
+            script: distinctScripts,
+        });
+        // Repo may yield duplicates if seeded oddly; keep the first one
+        // for each script to match the wallet's historical behaviour.
+        const scriptToContract = new Map();
+        for (const contract of contracts) {
+            if (!scriptToContract.has(contract.script)) {
+                scriptToContract.set(contract.script, contract);
+            }
+        }
+        const baselinePubKeyHex = hex.encode(await this.deps.identity.xOnlyPublicKey());
+        const boardingScriptHex = hex.encode(this.deps.boardingPkScript);
+        const identityIndexes = [];
+        const descriptorGroups = new Map();
+        for (const job of jobs) {
+            const scriptHex = hex.encode(job.lookupScript);
+            const contract = scriptToContract.get(scriptHex);
+            if (!contract) {
+                if (scriptHex === boardingScriptHex) {
+                    identityIndexes.push(job.index);
+                }
+                continue;
+            }
+            if (!DESCRIPTOR_CAPABLE_CONTRACT_TYPES.has(contract.type)) {
+                identityIndexes.push(job.index);
+                continue;
+            }
+            // `baselinePubKeyHex` is freshly produced by `hex.encode`,
+            // so it is already lowercase. `contract.params.pubKey` is
+            // persisted data: a migration or custom repository adapter
+            // could legitimately store it uppercase, so canonicalize
+            // before comparing to match the legacy router behaviour.
+            const ownerPubKeyHex = contract.params.pubKey?.toLowerCase();
+            if (ownerPubKeyHex && ownerPubKeyHex === baselinePubKeyHex) {
+                identityIndexes.push(job.index);
+                continue;
+            }
+            const descriptor = contract.metadata?.signingDescriptor;
+            if (typeof descriptor !== "string" || descriptor.length === 0) {
+                throw new MissingSigningDescriptorError(contract.script, contract.type);
+            }
+            const bucket = descriptorGroups.get(descriptor);
+            if (bucket) {
+                bucket.push(job.index);
+            }
+            else {
+                descriptorGroups.set(descriptor, [job.index]);
+            }
+        }
+        let signed = tx;
+        if (identityIndexes.length > 0) {
+            signed = await this.deps.identity.sign(signed, identityIndexes);
+        }
+        if (descriptorGroups.size > 0) {
+            if (!this.deps.descriptorProvider) {
+                throw new DescriptorSigningProviderMissingError();
+            }
+            const sortedDescriptors = Array.from(descriptorGroups.keys()).sort();
+            for (const descriptor of sortedDescriptors) {
+                const indexes = descriptorGroups.get(descriptor);
+                const [next] = await this.deps.descriptorProvider.signWithDescriptor([
+                    {
+                        tx: signed,
+                        descriptor,
+                        inputIndexes: indexes,
+                    },
+                ]);
+                signed = next;
+            }
+        }
+        return signed;
+    }
+}

package/dist/esm/wallet/onchain.js

@@ -1,11 +1,11 @@
 import { p2tr } from "@scure/btc-signer";
-import { DEFAULT_NETWORK_NAME } from './index.js';
-import { getNetwork } from '../networks.js';
-import { ESPLORA_URL, EsploraProvider, } from '../providers/onchain.js';
-import { findP2AOutput, P2A } from '../utils/anchor.js';
-import { TxWeightEstimator } from '../utils/txSizeEstimator.js';
-import { Transaction } from '../utils/transaction.js';
-import { DUST_AMOUNT } from './utils.js';
+import { DEFAULT_NETWORK_NAME } from "./index.js";
+import { getNetwork } from "../networks.js";
+import { ESPLORA_URL, EsploraProvider, } from "../providers/onchain.js";
+import { findP2AOutput, P2A } from "../utils/anchor.js";
+import { TxWeightEstimator } from "../utils/txSizeEstimator.js";
+import { Transaction } from "../utils/transaction.js";
+import { DUST_AMOUNT } from "./utils.js";
 /**
  * Onchain Bitcoin wallet implementation for traditional Bitcoin transactions.
  *

package/dist/esm/wallet/ramps.js

@@ -1,8 +1,8 @@
-import { Estimator } from '../arkfee/index.js';
+import { Estimator } from "../arkfee/index.js";
 import { Address, OutScript } from "@scure/btc-signer";
 import { hex } from "@scure/base";
-import { networks } from '../networks.js';
-import { ArkAddress } from '../script/address.js';
+import { networks } from "../networks.js";
+import { ArkAddress } from "../script/address.js";
 /**
  * Ramps is a class wrapping `settle` method to provide a more convenient interface for onboarding and offboarding operations.
  *

package/dist/esm/wallet/serviceWorker/wallet-message-handler.js

@@ -1,9 +1,9 @@
-import { RestIndexerProvider } from '../../providers/indexer.js';
-import { isExpired, isRecoverable, isSpendable, isSubdust, } from '../index.js';
-import { extendCoin } from '../utils.js';
-import { buildTransactionHistory } from '../../utils/transactionHistory.js';
-import { filterVtxosForScript, getVtxosForContract, saveVtxosForContract, warnAndFilterVtxosForScript, } from '../../contracts/vtxoOwnership.js';
-import { scriptFromArkAddress } from '../../repositories/scriptFromAddress.js';
+import { RestIndexerProvider } from "../../providers/indexer.js";
+import { isExpired, isRecoverable, isSpendable, isSubdust, } from "../index.js";
+import { extendCoin } from "../utils.js";
+import { buildTransactionHistory } from "../../utils/transactionHistory.js";
+import { filterVtxosForScript, getVtxosForContract, saveVtxosForContract, warnAndFilterVtxosForScript, } from "../../contracts/vtxoOwnership.js";
+import { scriptFromArkAddress } from "../../repositories/scriptFromAddress.js";
 export class WalletNotInitializedError extends Error {
     constructor() {
         super("Wallet handler not initialized");

package/dist/esm/wallet/serviceWorker/wallet.js

@@ -1,11 +1,11 @@
 import { hex } from "@scure/base";
-import { serializeReadonlyIdentity, serializeSigningIdentity, } from '../../identity/index.js';
-import { setupServiceWorker } from '../../worker/browser/utils.js';
-import { IndexedDBContractRepository, IndexedDBWalletRepository, } from '../../repositories/index.js';
-import { DEFAULT_MESSAGE_TAG, } from './wallet-message-handler.js';
-import { getRandomId } from '../utils.js';
-import { MESSAGE_BUS_NOT_INITIALIZED, ServiceWorkerTimeoutError, } from '../../worker/errors.js';
-import { getArkadeServerUrl } from '../wallet.js';
+import { serializeReadonlyIdentity, serializeSigningIdentity, } from "../../identity/index.js";
+import { setupServiceWorker } from "../../worker/browser/utils.js";
+import { IndexedDBContractRepository, IndexedDBWalletRepository, } from "../../repositories/index.js";
+import { DEFAULT_MESSAGE_TAG, } from "./wallet-message-handler.js";
+import { getRandomId } from "../utils.js";
+import { MESSAGE_BUS_NOT_INITIALIZED, ServiceWorkerTimeoutError, } from "../../worker/errors.js";
+import { getArkadeServerUrl } from "../wallet.js";
 // Check by error message content instead of instanceof because postMessage uses the
 // structured clone algorithm which strips the prototype chain — the page
 // receives a plain Error, not the original MessageBusNotInitializedError.
@@ -917,6 +917,7 @@ export class ServiceWorkerWallet extends ServiceWorkerReadonlyWallet {
             indexerUrl: options.indexerUrl,
             esploraUrl: options.esploraUrl,
             settlementConfig: options.settlementConfig,
+            walletMode: options.walletMode,
             watcherConfig: options.watcherConfig,
             messageTimeouts,
         };

package/dist/esm/wallet/signingErrors.js

@@ -0,0 +1,27 @@
+/**
+ * Thrown when a rotated contract (default or delegate) is missing the
+ * metadata.signingDescriptor required to route it to a descriptor-aware
+ * signer.
+ */
+export class MissingSigningDescriptorError extends Error {
+    constructor(contractScript, contractType) {
+        super(`Cannot sign input for ${contractType} contract ${contractScript}: ` +
+            `metadata.signingDescriptor is missing. This wallet was rotated ` +
+            `on an earlier build that did not persist signing descriptors. ` +
+            `Manually set metadata.signingDescriptor on the contract record, ` +
+            `or restore from a pre-rotation snapshot.`);
+        this.contractScript = contractScript;
+        this.contractType = contractType;
+        this.name = "MissingSigningDescriptorError";
+    }
+}
+/**
+ * Thrown when an input needs descriptor-aware signing but no
+ * DescriptorProvider was wired into the wallet.
+ */
+export class DescriptorSigningProviderMissingError extends Error {
+    constructor() {
+        super("Descriptor signing requested but no DescriptorProvider was wired into this wallet");
+        this.name = "DescriptorSigningProviderMissingError";
+    }
+}

package/dist/esm/wallet/unroll.js

@@ -1,12 +1,12 @@
 import { base64, hex } from "@scure/base";
 import { SigHash, TaprootControlBlock } from "@scure/btc-signer";
-import { timelockToSequence } from '../utils/timelock.js';
-import { ChainTxType } from '../providers/indexer.js';
-import { VtxoScript } from '../script/base.js';
-import { TxWeightEstimator } from '../utils/txSizeEstimator.js';
-import { Wallet } from './wallet.js';
-import { Transaction } from '../utils/transaction.js';
-import { DUST_AMOUNT } from './utils.js';
+import { timelockToSequence } from "../utils/timelock.js";
+import { ChainTxType } from "../providers/indexer.js";
+import { VtxoScript } from "../script/base.js";
+import { TxWeightEstimator } from "../utils/txSizeEstimator.js";
+import { Wallet } from "./wallet.js";
+import { Transaction } from "../utils/transaction.js";
+import { DUST_AMOUNT } from "./utils.js";
 export var Unroll;
 (function (Unroll) {
     let StepType;
@@ -227,7 +227,11 @@ export async function prepareUnrollTransaction(wallet, vtxoTxIds, outputAddress)
     if (!feeRate || feeRate < Wallet.MIN_FEE_RATE) {
         feeRate = Wallet.MIN_FEE_RATE;
     }
-    const feeAmount = txWeightEstimator.vsize().fee(BigInt(feeRate));
+    // Esplora returns a `number` and bitcoind regtest sometimes reports
+    // fractional sat/vB (e.g. 1.006). `BigInt(1.006)` throws RangeError
+    // — round up so we always pay AT LEAST the advertised rate and
+    // satisfy BigInt's integer requirement.
+    const feeAmount = txWeightEstimator.vsize().fee(BigInt(Math.ceil(feeRate)));
     if (feeAmount > totalAmount) {
         throw new Error("fee amount is greater than the total amount");
     }

package/dist/esm/wallet/utils.js

@@ -1,5 +1,5 @@
-import { ArkAddress, } from '../index.js';
-import { contractHandlers } from '../contracts/handlers/index.js';
+import { ArkAddress, } from "../index.js";
+import { contractHandlers } from "../contracts/handlers/index.js";
 import { hex } from "@scure/base";
 export const DUST_AMOUNT = 546; // sats
 export function extendCoin(wallet, utxo) {

package/dist/esm/wallet/validation.js

@@ -1,6 +1,6 @@
 import { equalBytes } from "@scure/btc-signer/utils.js";
-import { ArkAddress } from '../script/address.js';
-import { Extension } from '../extension/index.js';
+import { ArkAddress } from "../script/address.js";
+import { Extension } from "../extension/index.js";
 import { Address, OutScript } from "@scure/btc-signer";
 export const ErrOffchainOutputNotFound = (address) => new Error(`offchain send output not found: ${address}`);
 export const ErrInvalidAssetOutputAmount = (got, want, assetId) => new Error(`invalid asset output amount for ${assetId}: got ${got}, want ${want}`);

package/dist/esm/wallet/vtxo-manager.js

@@ -1,13 +1,13 @@
-import { isExpired, isRecoverable, isSpendable, isSubdust, } from './index.js';
-import { maybeArkError } from '../providers/errors.js';
-import { hasBoardingTxExpired } from '../utils/arkTransaction.js';
-import { CSVMultisigTapscript } from '../script/tapscript.js';
+import { isExpired, isRecoverable, isSpendable, isSubdust, } from "./index.js";
+import { maybeArkError } from "../providers/errors.js";
+import { hasBoardingTxExpired } from "../utils/arkTransaction.js";
+import { CSVMultisigTapscript } from "../script/tapscript.js";
 import { hex } from "@scure/base";
-import { getSequence } from '../script/base.js';
-import { Transaction } from '../utils/transaction.js';
-import { TxWeightEstimator } from '../utils/txSizeEstimator.js';
-import { Estimator } from '../arkfee/index.js';
-import { ArkAddress } from '../script/address.js';
+import { getSequence } from "../script/base.js";
+import { Transaction } from "../utils/transaction.js";
+import { TxWeightEstimator } from "../utils/txSizeEstimator.js";
+import { Estimator } from "../arkfee/index.js";
+import { ArkAddress } from "../script/address.js";
 /**
  * Return whether a wallet exposes the properties required for boarding input sweep operations.
  *