@vultisig/core-chain 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # @vultisig/core-chain
 
+## 1.2.0
+
+### Minor Changes
+
+- [#235](https://github.com/vultisig/vultisig-sdk/pull/235) [`aea1c28`](https://github.com/vultisig/vultisig-sdk/commit/aea1c28051345ddef9c952108b203caa8b7fa032) Thanks [@rcoderdev](https://github.com/rcoderdev)! - ### Swap amounts (backward compatible)
+  - `SwapQuoteParams.amount` and `SwapTxParams.amount` now accept **`string | number`**. Call sites that already pass a **number** require no code changes.
+  - Human-readable swap amounts can be passed as **decimal strings** end-to-end (compound `vault.swap()`, `getSwapQuote`, `prepareSwapTx`, CLI agent), avoiding precision loss from `Number()` / `parseFloat()` on extreme magnitudes or fractional digits.
+  - `toChainAmount` accepts **`string | number`**; whitespace-only / empty strings throw instead of being treated as zero.
+
+  ### Send preparation (stricter validation)
+  - `prepareSendTx` and `estimateSendFee` reject **zero or negative** `amount` in base units. This aligns with real transfers; payloads with `toAmount: "0"` are no longer built for native/token sends.
+  - **Zero-value EVM contract calls** are unchanged: use `prepareContractCallTx` (or `vault.contractCall()`), which still builds via the internal path that allows `value: 0n`.
+
+  ### Other
+  - Swap approval sizing uses `toChainAmount` instead of float scaling for required allowance.
+  - `@vultisig/rujira` (source): `VultisigSignature.format` includes **`MLDSA`** to match SDK `Signature` — type-only widening, no runtime change; Rujira will pick up a **patch** version via normal dependency releases when published next.
+  - CLI: direct **`viem`** dependency; Solana local swap human amount via `formatUnits`; agent SSE `Transaction` typing includes optional `swap_tx` / `send_tx` / `tx`.
+
+  **Semver:** **Minor** for `@vultisig/core-chain`, `@vultisig/core-mpc`, and `@vultisig/sdk` (additive types + intentional validation tightening). **`@vultisig/cli` is linked to the SDK** in Changesets config, so it receives the same minor bump. This is **not** a SemVer **major** for integration purposes: swap inputs are only widened; `prepareSendTx({ amount: 0n })` was never a valid broadcast path.
+
+  **Release tooling note:** `yarn changeset status` may still propose a **major** version for `@vultisig/rujira` when the SDK minors, even though the only Rujira change is adding `'MLDSA'` to a string-literal union (fully backward compatible). Review the Version Packages PR and **downgrade Rujira to patch** if your policy is to reserve majors for real breaking API changes.
+
+  **`@vultisig/sdk` is 0.x:** per [SemVer](https://semver.org/#spec-item-4), minor releases on `0.y.z` may include behavior changes; consumers pinning `^0.14.0` should still accept `0.15.0` but should read changelog for validation tightening.
+
+### Patch Changes
+
+- [#174](https://github.com/vultisig/vultisig-sdk/pull/174) [`c630597`](https://github.com/vultisig/vultisig-sdk/commit/c6305970d1685194f1c6c11d5e8d141e8aa6c9a1) Thanks [@Ehsan-saradar](https://github.com/Ehsan-saradar)! - fix: harden PSBT signing (SignBitcoin) - follow-up on PR [#174](https://github.com/vultisig/vultisig-sdk/issues/174)
+  - parameterize network in buildSignBitcoinFromPsbt (was hardcoded to mainnet)
+  - harden detectScriptType: full P2PKH template check, add P2WSH detection
+  - fail early for unsupported script types with descriptive BIP-referenced errors
+  - add fee snipe mitigation (cross-validate witnessUtxo vs nonWitnessUtxo)
+  - rename computeBip143Sighashes -> computePreSigningHashes for extensibility
+  - use @noble/hashes/sha256 instead of Node.js crypto (cross-platform)
+  - use unsigned int64 for Bitcoin amounts (writeBigUInt64LE)
+  - fix varint encoding for output script lengths in sighash computation
+  - refactor compileSignBitcoinTx to use bitcoinjs-lib Transaction class
+  - fix libType regression in commVault.ts for key-import vaults
+  - fix variable shadowing in compileTx.ts
+  - skip Blockaid simulation for PSBT flows (incompatible with WalletCore compiler)
+  - augment change detection with BIP32 derivation on outputs
+  - add 10 unit tests cross-validating sighash against bitcoinjs-lib v7
+
 ## 1.1.0
 
 ### Minor Changes

package/dist/amount/toChainAmount.d.ts

@@ -1,2 +1,7 @@
-export declare const toChainAmount: (amount: number, decimals: number) => bigint;
+/** Thrown when a human amount string cannot be converted to chain base units. */
+export declare class ChainAmountParseError extends Error {
+    readonly name = "ChainAmountParseError";
+    constructor(message: string);
+}
+export declare const toChainAmount: (amount: string | number, decimals: number) => bigint;
 //# sourceMappingURL=toChainAmount.d.ts.map

package/dist/amount/toChainAmount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toChainAmount.d.ts","sourceRoot":"","sources":["../../../../../packages/core/chain/amount/toChainAmount.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,WAI7D,CAAA"}
+{"version":3,"file":"toChainAmount.d.ts","sourceRoot":"","sources":["../../../../../packages/core/chain/amount/toChainAmount.ts"],"names":[],"mappings":"AAEA,iFAAiF;AACjF,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAkB,IAAI,2BAA0B;gBAEpC,OAAO,EAAE,MAAM;CAG5B;AAgFD,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,GAAG,MAAM,EAAE,UAAU,MAAM,WAetE,CAAA"}

package/dist/amount/toChainAmount.js

@@ -1,5 +1,93 @@
 import { parseUnits } from 'viem';
+/** Thrown when a human amount string cannot be converted to chain base units. */
+export class ChainAmountParseError extends Error {
+    name = 'ChainAmountParseError';
+    constructor(message) {
+        super(message);
+    }
+}
+const SCIENTIFIC_DECIMAL = /^([+-]?)(?:(\d+)\.?(\d*)|\.(\d+))[eE]([+-]?\d+)$/i;
+/** Limits `10n ** |scale|` work and expanded string size for untrusted input. */
+const MAX_SCALE_ABS = 10000n;
+const padFractionDigits = (frac, totalLen) => {
+    const need = totalLen - BigInt(frac.length);
+    if (need <= 0n) {
+        return frac;
+    }
+    if (need <= BigInt(Number.MAX_SAFE_INTEGER)) {
+        return `${'0'.repeat(Number(need))}${frac}`;
+    }
+    let out = frac;
+    while (BigInt(out.length) < totalLen) {
+        out = `0${out}`;
+    }
+    return out;
+};
+/**
+ * Turns a decimal string in scientific notation into a plain decimal string
+ * without floating-point conversion, so mantissa digits beyond ~15 s.d. are kept.
+ */
+const expandScientificNotationToDecimalString = (s) => {
+    const m = SCIENTIFIC_DECIMAL.exec(s.trim());
+    if (!m) {
+        throw new ChainAmountParseError(`Invalid amount: "${s}"`);
+    }
+    const signNeg = m[1] === '-';
+    let digitStr;
+    let fracLen;
+    if (m[4] !== undefined) {
+        digitStr = m[4];
+        fracLen = digitStr.length;
+    }
+    else {
+        digitStr = `${m[2] ?? ''}${m[3] ?? ''}`;
+        fracLen = (m[3] ?? '').length;
+    }
+    if (!/^\d+$/.test(digitStr)) {
+        throw new ChainAmountParseError(`Invalid amount: "${s}"`);
+    }
+    const expStr = m[5] ?? '';
+    if (expStr === '' || expStr === '+' || expStr === '-') {
+        throw new ChainAmountParseError(`Invalid amount: "${s}"`);
+    }
+    const allDigits = BigInt(digitStr);
+    const exp = BigInt(expStr);
+    const scale = exp - BigInt(fracLen);
+    const scaleAbs = scale < 0n ? -scale : scale;
+    if (scaleAbs > MAX_SCALE_ABS) {
+        throw new ChainAmountParseError(`Amount exponent out of supported range: "${s}"`);
+    }
+    let absResult;
+    if (scale >= 0n) {
+        const mult = 10n ** scale;
+        absResult = (allDigits * mult).toString();
+    }
+    else {
+        const k = -scale;
+        const divisor = 10n ** k;
+        const intPart = allDigits / divisor;
+        const rem = allDigits % divisor;
+        const frac = padFractionDigits(rem.toString(), k);
+        absResult =
+            intPart === 0n ? `0.${frac}` : `${intPart.toString()}.${frac}`;
+    }
+    if (signNeg && allDigits !== 0n) {
+        return `-${absResult}`;
+    }
+    return absResult;
+};
 export const toChainAmount = (amount, decimals) => {
+    if (typeof amount === 'string') {
+        const trimmed = amount.trim();
+        if (!trimmed) {
+            throw new ChainAmountParseError('Amount cannot be empty');
+        }
+        if (/[eE]/.test(trimmed)) {
+            const expanded = expandScientificNotationToDecimalString(trimmed);
+            return parseUnits(expanded, decimals);
+        }
+        return parseUnits(trimmed, decimals);
+    }
     const str = amount.toString();
     const value = /[eE]/.test(str) ? amount.toFixed(decimals) : str;
     return parseUnits(value, decimals);

package/dist/amount/toChainAmount.js.map

@@ -1 +1 @@
-{"version":3,"file":"toChainAmount.js","sourceRoot":"","sources":["../../../../../packages/core/chain/amount/toChainAmount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AAEjC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAc,EAAE,QAAgB,EAAE,EAAE;IAChE,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;IAC/D,OAAO,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AACpC,CAAC,CAAA"}
+{"version":3,"file":"toChainAmount.js","sourceRoot":"","sources":["../../../../../packages/core/chain/amount/toChainAmount.ts"],"names":[],"mappings":"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"}

package/dist/chains/cosmos/qbtc/claim/BtcAddressType.d.ts

@@ -0,0 +1,7 @@
+/** ZK circuit used for the claim proof. */
+export type QbtcClaimCircuit = 'ecdsa' | 'schnorr';
+/** Supported Bitcoin address types for QBTC claiming. */
+export type BtcAddressType = 'p2pkh' | 'p2wpkh' | 'p2sh-p2wpkh' | 'p2wsh' | 'p2tr';
+/** Maps a Bitcoin address type to its corresponding ZK circuit. */
+export declare const btcAddressTypeCircuit: Record<BtcAddressType, QbtcClaimCircuit>;
+//# sourceMappingURL=BtcAddressType.d.ts.map

package/dist/chains/cosmos/qbtc/claim/BtcAddressType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BtcAddressType.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/claim/BtcAddressType.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,CAAA;AAElD,yDAAyD;AACzD,MAAM,MAAM,cAAc,GACtB,OAAO,GACP,QAAQ,GACR,aAAa,GACb,OAAO,GACP,MAAM,CAAA;AAEV,mEAAmE;AACnE,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAM1E,CAAA"}

package/dist/chains/cosmos/qbtc/claim/BtcAddressType.js

@@ -0,0 +1,9 @@
+/** Maps a Bitcoin address type to its corresponding ZK circuit. */
+export const btcAddressTypeCircuit = {
+    p2pkh: 'ecdsa',
+    p2wpkh: 'ecdsa',
+    'p2sh-p2wpkh': 'ecdsa',
+    p2wsh: 'ecdsa',
+    p2tr: 'schnorr',
+};
+//# sourceMappingURL=BtcAddressType.js.map

package/dist/chains/cosmos/qbtc/claim/BtcAddressType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BtcAddressType.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/claim/BtcAddressType.ts"],"names":[],"mappings":"AAWA,mEAAmE;AACnE,MAAM,CAAC,MAAM,qBAAqB,GAA6C;IAC7E,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,aAAa,EAAE,OAAO;IACtB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,SAAS;CAChB,CAAA"}

package/dist/chains/cosmos/qbtc/claim/ClaimableUtxo.d.ts

@@ -0,0 +1,8 @@
+/** A Bitcoin UTXO that can potentially be claimed on the QBTC chain. */
+export type ClaimableUtxo = {
+    txid: string;
+    vout: number;
+    /** BTC amount in satoshis. */
+    amount: number;
+};
+//# sourceMappingURL=ClaimableUtxo.d.ts.map

package/dist/chains/cosmos/qbtc/claim/ClaimableUtxo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaimableUtxo.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/claim/ClaimableUtxo.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAA;CACf,CAAA"}

package/dist/chains/cosmos/qbtc/claim/ClaimableUtxo.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ClaimableUtxo.js.map

package/dist/chains/cosmos/qbtc/claim/ClaimableUtxo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaimableUtxo.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/claim/ClaimableUtxo.ts"],"names":[],"mappings":""}

package/dist/chains/cosmos/qbtc/claim/broadcastClaimTx.d.ts

@@ -0,0 +1,25 @@
+type ClaimTxResponse = {
+    /** Total satoshis claimed. */
+    totalAmountClaimed: bigint;
+    /** Number of UTXOs successfully claimed. */
+    utxosClaimed: number;
+    /** Number of UTXOs skipped (already claimed or address mismatch). */
+    utxosSkipped: number;
+    /** Transaction hash. */
+    txHash: string;
+};
+type BroadcastClaimTxInput = {
+    /** Base64-encoded TxRaw protobuf bytes. */
+    txBytesBase64: string;
+    /** Transaction hash (SHA256 of TxRaw), hex-encoded. */
+    txHash: string;
+};
+/**
+ * Broadcasts a signed MsgClaimWithProof transaction to the QBTC chain
+ * via the REST API (following the restOnlyChains pattern).
+ *
+ * The claim transaction is gas-free — the chain does not charge gas.
+ */
+export declare const broadcastClaimTx: ({ txBytesBase64, txHash, }: BroadcastClaimTxInput) => Promise<ClaimTxResponse>;
+export {};
+//# sourceMappingURL=broadcastClaimTx.d.ts.map

package/dist/chains/cosmos/qbtc/claim/broadcastClaimTx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcastClaimTx.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/claim/broadcastClaimTx.ts"],"names":[],"mappings":"AAEA,KAAK,eAAe,GAAG;IACrB,8BAA8B;IAC9B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAA;IACpB,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAA;IACpB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,KAAK,qBAAqB,GAAG;IAC3B,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAA;IACrB,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAWD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAU,4BAGpC,qBAAqB,KAAG,OAAO,CAAC,eAAe,CAwCjD,CAAA"}

package/dist/chains/cosmos/qbtc/claim/broadcastClaimTx.js

@@ -0,0 +1,43 @@
+import { qbtcRestUrl } from '@vultisig/core-chain/chains/cosmos/qbtc/tendermintRpcUrl';
+/**
+ * Broadcasts a signed MsgClaimWithProof transaction to the QBTC chain
+ * via the REST API (following the restOnlyChains pattern).
+ *
+ * The claim transaction is gas-free — the chain does not charge gas.
+ */
+export const broadcastClaimTx = async ({ txBytesBase64, txHash, }) => {
+    const response = await fetch(`${qbtcRestUrl}/cosmos/tx/v1beta1/txs`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            tx_bytes: txBytesBase64,
+            mode: 'BROADCAST_MODE_SYNC',
+        }),
+    });
+    const idempotentResult = {
+        totalAmountClaimed: 0n,
+        utxosClaimed: 0,
+        utxosSkipped: 0,
+        txHash,
+    };
+    if (!response.ok) {
+        const text = await response.text();
+        if (text.includes('tx already exists in cache')) {
+            return idempotentResult;
+        }
+        throw new Error(`QBTC claim broadcast failed (${response.status}): ${text}`);
+    }
+    const data = await response.json();
+    if (typeof data.tx_response?.code !== 'number') {
+        throw new Error('QBTC claim broadcast failed: missing tx_response.code');
+    }
+    if (data.tx_response.code !== 0) {
+        const log = data.tx_response.raw_log || data.tx_response.log;
+        if (log?.includes('tx already exists in cache')) {
+            return idempotentResult;
+        }
+        throw new Error(`QBTC claim tx error: ${log}`);
+    }
+    return idempotentResult;
+};
+//# sourceMappingURL=broadcastClaimTx.js.map

package/dist/chains/cosmos/qbtc/claim/broadcastClaimTx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcastClaimTx.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/claim/broadcastClaimTx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0DAA0D,CAAA;AA6BtF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,EACrC,aAAa,EACb,MAAM,GACgB,EAA4B,EAAE;IACpD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,WAAW,wBAAwB,EAAE;QACnE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,QAAQ,EAAE,aAAa;YACvB,IAAI,EAAE,qBAAqB;SAC5B,CAAC;KACH,CAAC,CAAA;IAEF,MAAM,gBAAgB,GAAoB;QACxC,kBAAkB,EAAE,EAAE;QACtB,YAAY,EAAE,CAAC;QACf,YAAY,EAAE,CAAC;QACf,MAAM;KACP,CAAA;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAClC,IAAI,IAAI,CAAC,QAAQ,CAAC,4BAA4B,CAAC,EAAE,CAAC;YAChD,OAAO,gBAAgB,CAAA;QACzB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAA;IAC9E,CAAC;IAED,MAAM,IAAI,GAAsB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAErD,IAAI,OAAO,IAAI,CAAC,WAAW,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAA;IAC1E,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAA;QAC5D,IAAI,GAAG,EAAE,QAAQ,CAAC,4BAA4B,CAAC,EAAE,CAAC;YAChD,OAAO,gBAAgB,CAAA;QACzB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAA;IAChD,CAAC;IAED,OAAO,gBAAgB,CAAA;AACzB,CAAC,CAAA"}

package/dist/chains/cosmos/qbtc/claim/buildClaimTx.d.ts

@@ -0,0 +1,26 @@
+type UtxoRef = {
+    txid: string;
+    vout: number;
+};
+type BuildMsgClaimWithProofInput = {
+    /** QBTC bech32 address of the claimer. */
+    claimer: string;
+    /** UTXOs to include in the claim (1-50, no duplicates). */
+    utxos: UtxoRef[];
+    /** Hex-encoded PLONK ZK proof. */
+    proof: string;
+    /** 64-char hex MessageHash. */
+    messageHash: string;
+    /** 40-char hex AddressHash (Hash160). */
+    addressHash: string;
+    /** 64-char hex QBTCAddressHash. */
+    qbtcAddressHash: string;
+};
+/** Validates the claim input against the chain's constraints (Section 5). */
+export declare const validateClaimInput: (input: BuildMsgClaimWithProofInput) => void;
+/** Wraps MsgClaimWithProof in a Cosmos Any message. */
+export declare const buildClaimWithProofAny: (input: BuildMsgClaimWithProofInput) => Uint8Array;
+/** Builds the TxBody containing a single MsgClaimWithProof. */
+export declare const buildClaimTxBody: (input: BuildMsgClaimWithProofInput) => Uint8Array;
+export {};
+//# sourceMappingURL=buildClaimTx.d.ts.map

package/dist/chains/cosmos/qbtc/claim/buildClaimTx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildClaimTx.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/claim/buildClaimTx.ts"],"names":[],"mappings":"AASA,KAAK,OAAO,GAAG;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,2BAA2B,GAAG;IACjC,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,mCAAmC;IACnC,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAYD,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,GAAI,OAAO,2BAA2B,SA+BpE,CAAA;AAsBD,uDAAuD;AACvD,eAAO,MAAM,sBAAsB,GACjC,OAAO,2BAA2B,KACjC,UAOF,CAAA;AAED,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB,GAC3B,OAAO,2BAA2B,KACjC,UAGF,CAAA"}

package/dist/chains/cosmos/qbtc/claim/buildClaimTx.js

@@ -0,0 +1,57 @@
+import { concatBytes, protoBytes, protoString, protoVarint, } from '@vultisig/core-chain/chains/cosmos/qbtc/protoEncoding';
+const msgClaimWithProofTypeURL = '/qbtc.qbtc.v1.MsgClaimWithProof';
+const isHex = (value) => /^[0-9a-f]+$/i.test(value);
+const assertHex = (value, name, expectedLength) => {
+    if (value.length !== expectedLength || !isHex(value)) {
+        throw new Error(`${name} must be ${expectedLength} hex chars, got ${value.length}`);
+    }
+};
+/** Validates the claim input against the chain's constraints (Section 5). */
+export const validateClaimInput = (input) => {
+    const { utxos, proof, messageHash, addressHash, qbtcAddressHash } = input;
+    if (utxos.length === 0 || utxos.length > 50) {
+        throw new Error(`UTXOs count must be 1-50, got ${utxos.length}`);
+    }
+    const seen = new Set();
+    for (const { txid, vout } of utxos) {
+        if (txid.length !== 64 || !isHex(txid)) {
+            throw new Error(`Invalid txid: expected 64 hex chars, got ${txid.length}`);
+        }
+        if (!Number.isInteger(vout) || vout < 0) {
+            throw new Error(`Invalid vout: expected non-negative integer, got ${vout}`);
+        }
+        const key = `${txid}:${vout}`;
+        if (seen.has(key)) {
+            throw new Error(`Duplicate UTXO reference: ${key}`);
+        }
+        seen.add(key);
+    }
+    if (!isHex(proof) || proof.length < 200) {
+        throw new Error('Proof too small or not valid hex (min 100 bytes / 200 hex chars)');
+    }
+    if (proof.length > 100_000) {
+        throw new Error('Proof too large (max 50 KB / 100000 hex chars)');
+    }
+    assertHex(messageHash, 'message_hash', 64);
+    assertHex(addressHash, 'address_hash', 40);
+    assertHex(qbtcAddressHash, 'qbtc_address_hash', 64);
+};
+/** Encodes a single UTXORef as protobuf. */
+const encodeUtxoRef = ({ txid, vout }) => concatBytes(protoString(1, txid), protoVarint(2, BigInt(vout)));
+/** Encodes MsgClaimWithProof as protobuf bytes. */
+const buildMsgClaimWithProof = (input) => {
+    const utxoBytes = input.utxos.map(utxo => protoBytes(2, encodeUtxoRef(utxo)));
+    return concatBytes(protoString(1, input.claimer), ...utxoBytes, protoString(3, input.proof), protoString(4, input.messageHash), protoString(5, input.addressHash), protoString(6, input.qbtcAddressHash));
+};
+/** Wraps MsgClaimWithProof in a Cosmos Any message. */
+export const buildClaimWithProofAny = (input) => {
+    validateClaimInput(input);
+    const msg = buildMsgClaimWithProof(input);
+    return concatBytes(protoString(1, msgClaimWithProofTypeURL), protoBytes(2, msg));
+};
+/** Builds the TxBody containing a single MsgClaimWithProof. */
+export const buildClaimTxBody = (input) => {
+    const anyMsg = buildClaimWithProofAny(input);
+    return protoBytes(1, anyMsg);
+};
+//# sourceMappingURL=buildClaimTx.js.map

package/dist/chains/cosmos/qbtc/claim/buildClaimTx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildClaimTx.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/claim/buildClaimTx.ts"],"names":[],"mappings":"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"}

package/dist/chains/cosmos/qbtc/claim/computeClaimHashes.d.ts

@@ -0,0 +1,49 @@
+import { QbtcClaimCircuit } from './BtcAddressType.js';
+/**
+ * Computes the address hash for QBTC claiming.
+ * - ECDSA types: Hash160(compressedPubkey) — 20 bytes
+ * - Taproot (Schnorr): x-only pubkey (last 32 bytes of 33-byte compressed key)
+ */
+export declare const computeAddressHash: ({ compressedPubkey, circuit, }: {
+    compressedPubkey: Uint8Array;
+    circuit: QbtcClaimCircuit;
+}) => Uint8Array;
+/** Computes SHA256 of the QBTC bech32 address string. */
+export declare const computeQbtcAddressHash: (qbtcAddress: string) => Uint8Array;
+/** Computes the first 8 bytes of SHA256 of the chain ID. */
+export declare const computeChainIdHash: (chainId: string) => Uint8Array;
+type ComputeClaimMessageHashInput = {
+    addressHash: Uint8Array;
+    qbtcAddressHash: Uint8Array;
+    chainIdHash: Uint8Array;
+    circuit: QbtcClaimCircuit;
+};
+/**
+ * Computes the final MessageHash for the QBTC claim.
+ *
+ * ```
+ * MessageHash = SHA256(prefix + addressHash + qbtcAddressHash + chainIdHash + "qbtc-claim-v1")
+ * ```
+ *
+ * Where prefix is `"ecdsa:"` or `"schnorr:"` depending on the BTC address type.
+ */
+export declare const computeClaimMessageHash: ({ addressHash, qbtcAddressHash, chainIdHash, circuit, }: ComputeClaimMessageHashInput) => Uint8Array;
+type ComputeAllClaimHashesInput = {
+    btcAddress: string;
+    compressedPubkey: Uint8Array;
+    qbtcAddress: string;
+    chainId: string;
+};
+type ClaimHashes = {
+    messageHash: Uint8Array;
+    addressHash: Uint8Array;
+    qbtcAddressHash: Uint8Array;
+    circuit: QbtcClaimCircuit;
+};
+/**
+ * Convenience function that computes all hashes needed for a QBTC claim
+ * in a single call.
+ */
+export declare const computeAllClaimHashes: ({ btcAddress, compressedPubkey, qbtcAddress, chainId, }: ComputeAllClaimHashesInput) => ClaimHashes;
+export {};
+//# sourceMappingURL=computeClaimHashes.d.ts.map

package/dist/chains/cosmos/qbtc/claim/computeClaimHashes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeClaimHashes.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/claim/computeClaimHashes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyB,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAQ1E;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,gCAGhC;IACD,gBAAgB,EAAE,UAAU,CAAA;IAC5B,OAAO,EAAE,gBAAgB,CAAA;CAC1B,KAAG,UAcH,CAAA;AAED,yDAAyD;AACzD,eAAO,MAAM,sBAAsB,GAAI,aAAa,MAAM,KAAG,UACd,CAAA;AAE/C,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM,KAAG,UACE,CAAA;AAEvD,KAAK,4BAA4B,GAAG;IAClC,WAAW,EAAE,UAAU,CAAA;IACvB,eAAe,EAAE,UAAU,CAAA;IAC3B,WAAW,EAAE,UAAU,CAAA;IACvB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,GAAI,yDAKrC,4BAA4B,KAAG,UAsCjC,CAAA;AAED,KAAK,0BAA0B,GAAG;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,UAAU,CAAA;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,KAAK,WAAW,GAAG;IACjB,WAAW,EAAE,UAAU,CAAA;IACvB,WAAW,EAAE,UAAU,CAAA;IACvB,eAAe,EAAE,UAAU,CAAA;IAC3B,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,yDAKnC,0BAA0B,KAAG,WAgB/B,CAAA"}

package/dist/chains/cosmos/qbtc/claim/computeClaimHashes.js

@@ -0,0 +1,85 @@
+import { ripemd160 } from '@noble/hashes/legacy.js';
+import { sha256 } from '@noble/hashes/sha2.js';
+import { btcAddressTypeCircuit } from './BtcAddressType.js';
+import { detectBtcAddressType } from './detectBtcAddressType.js';
+const claimSuffix = 'qbtc-claim-v1';
+/** Hash160 = RIPEMD160(SHA256(data)), the standard Bitcoin hash. */
+const hash160 = (data) => ripemd160(sha256(data));
+/**
+ * Computes the address hash for QBTC claiming.
+ * - ECDSA types: Hash160(compressedPubkey) — 20 bytes
+ * - Taproot (Schnorr): x-only pubkey (last 32 bytes of 33-byte compressed key)
+ */
+export const computeAddressHash = ({ compressedPubkey, circuit, }) => {
+    if (compressedPubkey.length !== 33 ||
+        (compressedPubkey[0] !== 0x02 && compressedPubkey[0] !== 0x03)) {
+        throw new Error('compressedPubkey must be a 33-byte compressed secp256k1 key');
+    }
+    if (circuit === 'schnorr') {
+        return compressedPubkey.slice(1, 33);
+    }
+    return hash160(compressedPubkey);
+};
+/** Computes SHA256 of the QBTC bech32 address string. */
+export const computeQbtcAddressHash = (qbtcAddress) => sha256(new TextEncoder().encode(qbtcAddress));
+/** Computes the first 8 bytes of SHA256 of the chain ID. */
+export const computeChainIdHash = (chainId) => sha256(new TextEncoder().encode(chainId)).slice(0, 8);
+/**
+ * Computes the final MessageHash for the QBTC claim.
+ *
+ * ```
+ * MessageHash = SHA256(prefix + addressHash + qbtcAddressHash + chainIdHash + "qbtc-claim-v1")
+ * ```
+ *
+ * Where prefix is `"ecdsa:"` or `"schnorr:"` depending on the BTC address type.
+ */
+export const computeClaimMessageHash = ({ addressHash, qbtcAddressHash, chainIdHash, circuit, }) => {
+    const expectedAddressHashLength = circuit === 'schnorr' ? 32 : 20;
+    if (addressHash.length !== expectedAddressHashLength) {
+        throw new Error(`addressHash must be ${expectedAddressHashLength} bytes for ${circuit}`);
+    }
+    if (qbtcAddressHash.length !== 32) {
+        throw new Error('qbtcAddressHash must be 32 bytes');
+    }
+    if (chainIdHash.length !== 8) {
+        throw new Error('chainIdHash must be 8 bytes');
+    }
+    const encoder = new TextEncoder();
+    const prefix = encoder.encode(`${circuit}:`);
+    const suffix = encoder.encode(claimSuffix);
+    const message = new Uint8Array(prefix.length +
+        addressHash.length +
+        qbtcAddressHash.length +
+        chainIdHash.length +
+        suffix.length);
+    let offset = 0;
+    message.set(prefix, offset);
+    offset += prefix.length;
+    message.set(addressHash, offset);
+    offset += addressHash.length;
+    message.set(qbtcAddressHash, offset);
+    offset += qbtcAddressHash.length;
+    message.set(chainIdHash, offset);
+    offset += chainIdHash.length;
+    message.set(suffix, offset);
+    return sha256(message);
+};
+/**
+ * Convenience function that computes all hashes needed for a QBTC claim
+ * in a single call.
+ */
+export const computeAllClaimHashes = ({ btcAddress, compressedPubkey, qbtcAddress, chainId, }) => {
+    const addressType = detectBtcAddressType(btcAddress);
+    const circuit = btcAddressTypeCircuit[addressType];
+    const addressHash = computeAddressHash({ compressedPubkey, circuit });
+    const qbtcAddressHash = computeQbtcAddressHash(qbtcAddress);
+    const chainIdHash = computeChainIdHash(chainId);
+    const messageHash = computeClaimMessageHash({
+        addressHash,
+        qbtcAddressHash,
+        chainIdHash,
+        circuit,
+    });
+    return { messageHash, addressHash, qbtcAddressHash, circuit };
+};
+//# sourceMappingURL=computeClaimHashes.js.map

package/dist/chains/cosmos/qbtc/claim/computeClaimHashes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeClaimHashes.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/claim/computeClaimHashes.ts"],"names":[],"mappings":"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"}

package/dist/chains/cosmos/qbtc/claim/detectBtcAddressType.d.ts

@@ -0,0 +1,14 @@
+import { BtcAddressType } from './BtcAddressType.js';
+/**
+ * Detects the Bitcoin address type from the address string format.
+ *
+ * | Format              | Type        |
+ * |---------------------|-------------|
+ * | `1...`              | P2PKH       |
+ * | `3...`              | P2SH-P2WPKH |
+ * | `bc1q...` (42 chars)| P2WPKH      |
+ * | `bc1q...` (62 chars)| P2WSH       |
+ * | `bc1p...` (62 chars)| P2TR        |
+ */
+export declare const detectBtcAddressType: (address: string) => BtcAddressType;
+//# sourceMappingURL=detectBtcAddressType.d.ts.map

package/dist/chains/cosmos/qbtc/claim/detectBtcAddressType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectBtcAddressType.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/claim/detectBtcAddressType.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,MAAM,KAAG,cAgBtD,CAAA"}

package/dist/chains/cosmos/qbtc/claim/detectBtcAddressType.js

@@ -0,0 +1,31 @@
+/**
+ * Detects the Bitcoin address type from the address string format.
+ *
+ * | Format              | Type        |
+ * |---------------------|-------------|
+ * | `1...`              | P2PKH       |
+ * | `3...`              | P2SH-P2WPKH |
+ * | `bc1q...` (42 chars)| P2WPKH      |
+ * | `bc1q...` (62 chars)| P2WSH       |
+ * | `bc1p...` (62 chars)| P2TR        |
+ */
+export const detectBtcAddressType = (address) => {
+    if (address.startsWith('1'))
+        return 'p2pkh';
+    if (address.startsWith('3'))
+        return 'p2sh-p2wpkh';
+    if (address.startsWith('bc1p')) {
+        if (address.length === 62)
+            return 'p2tr';
+        throw new Error(`Unsupported Bitcoin address format: ${address}`);
+    }
+    if (address.startsWith('bc1q')) {
+        if (address.length === 42)
+            return 'p2wpkh';
+        if (address.length === 62)
+            return 'p2wsh';
+        throw new Error(`Unsupported Bitcoin address format: ${address}`);
+    }
+    throw new Error(`Unsupported Bitcoin address format: ${address}`);
+};
+//# sourceMappingURL=detectBtcAddressType.js.map

package/dist/chains/cosmos/qbtc/claim/detectBtcAddressType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectBtcAddressType.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/claim/detectBtcAddressType.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAe,EAAkB,EAAE;IACtE,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAA;IAC3C,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,aAAa,CAAA;IAEjD,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE;YAAE,OAAO,MAAM,CAAA;QACxC,MAAM,IAAI,KAAK,CAAC,uCAAuC,OAAO,EAAE,CAAC,CAAA;IACnE,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE;YAAE,OAAO,QAAQ,CAAA;QAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE;YAAE,OAAO,OAAO,CAAA;QACzC,MAAM,IAAI,KAAK,CAAC,uCAAuC,OAAO,EAAE,CAAC,CAAA;IACnE,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,uCAAuC,OAAO,EAAE,CAAC,CAAA;AACnE,CAAC,CAAA"}

package/dist/chains/cosmos/qbtc/claim/getClaimWithProofDisabled.d.ts

@@ -0,0 +1,3 @@
+/** Checks whether the ClaimWithProof feature is disabled on the QBTC chain. */
+export declare const getClaimWithProofDisabled: () => Promise<boolean>;
+//# sourceMappingURL=getClaimWithProofDisabled.d.ts.map

package/dist/chains/cosmos/qbtc/claim/getClaimWithProofDisabled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getClaimWithProofDisabled.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/claim/getClaimWithProofDisabled.ts"],"names":[],"mappings":"AAUA,+EAA+E;AAC/E,eAAO,MAAM,yBAAyB,QAAa,OAAO,CAAC,OAAO,CAajE,CAAA"}

package/dist/chains/cosmos/qbtc/claim/getClaimWithProofDisabled.js

@@ -0,0 +1,13 @@
+import { qbtcRestUrl } from '@vultisig/core-chain/chains/cosmos/qbtc/tendermintRpcUrl';
+import { queryUrl } from '@vultisig/lib-utils/query/queryUrl';
+/** Checks whether the ClaimWithProof feature is disabled on the QBTC chain. */
+export const getClaimWithProofDisabled = async () => {
+    const url = `${qbtcRestUrl}/qbtc/v1/params/ClaimWithProofDisabled`;
+    const { param } = await queryUrl(url);
+    const parsedValue = Number(param.value);
+    if (!Number.isFinite(parsedValue)) {
+        throw new Error(`Invalid ClaimWithProofDisabled value: ${String(param.value)}`);
+    }
+    return parsedValue > 0;
+};
+//# sourceMappingURL=getClaimWithProofDisabled.js.map

package/dist/chains/cosmos/qbtc/claim/getClaimWithProofDisabled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getClaimWithProofDisabled.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/claim/getClaimWithProofDisabled.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0DAA0D,CAAA;AACtF,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAA;AAS7D,+EAA+E;AAC/E,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,IAAsB,EAAE;IACpE,MAAM,GAAG,GAAG,GAAG,WAAW,wCAAwC,CAAA;IAElE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAqB,GAAG,CAAC,CAAA;IACzD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAEvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,yCAAyC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAC/D,CAAA;IACH,CAAC;IAED,OAAO,WAAW,GAAG,CAAC,CAAA;AACxB,CAAC,CAAA"}