@bitgo-beta/abstract-utxo 1.6.1-alpha.43 → 1.6.1-alpha.430

package/dist/esm/transaction/descriptor/verifyTransaction.d.ts

@@ -0,0 +1,36 @@
+import * as utxolib from '@bitgo-beta/utxo-lib';
+import { ITransactionRecipient } from '@bitgo-beta/sdk-core';
+import { DescriptorMap } from '@bitgo-beta/utxo-core/descriptor';
+import { AbstractUtxoCoin, VerifyTransactionOptions } from '../../abstractUtxoCoin';
+import { BaseOutput, BaseParsedTransactionOutputs } from '../types';
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
+export declare class ErrorMissingOutputs extends ValidationError {
+    missingOutputs: BaseOutput<bigint | 'max'>[];
+    constructor(missingOutputs: BaseOutput<bigint | 'max'>[]);
+}
+export declare class ErrorImplicitExternalOutputs extends ValidationError {
+    implicitExternalOutputs: BaseOutput<bigint | 'max'>[];
+    constructor(implicitExternalOutputs: BaseOutput<bigint | 'max'>[]);
+}
+export declare class AggregateValidationError extends ValidationError {
+    errors: ValidationError[];
+    constructor(errors: ValidationError[]);
+}
+export declare function assertExpectedOutputDifference(parsedOutputs: BaseParsedTransactionOutputs<bigint, BaseOutput<bigint | 'max'>>): void;
+export declare function assertValidTransaction(psbt: utxolib.bitgo.UtxoPsbt, descriptors: DescriptorMap, recipients: ITransactionRecipient[], network: utxolib.Network): void;
+/**
+ * Wrapper around assertValidTransaction that returns a boolean instead of throwing.
+ *
+ * We follow the AbstractUtxoCoin interface here which is a bit confused - the return value is a boolean but we
+ * also throw errors (because we actually want to know what went wrong).
+ *
+ * @param coin
+ * @param params
+ * @param descriptorMap
+ * @returns {boolean} True if verification passes
+ * @throws {TxIntentMismatchError} if transaction validation fails
+ */
+export declare function verifyTransaction<TNumber extends number | bigint>(coin: AbstractUtxoCoin, params: VerifyTransactionOptions<TNumber>, descriptorMap: DescriptorMap): Promise<boolean>;
+//# sourceMappingURL=verifyTransaction.d.ts.map

package/dist/esm/transaction/descriptor/verifyTransaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifyTransaction.d.ts","sourceRoot":"","sources":["../../../../src/transaction/descriptor/verifyTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAoC,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AAIpE,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,mBAAoB,SAAQ,eAAe;IACnC,cAAc,EAAE,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,EAAE;gBAA5C,cAAc,EAAE,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,EAAE;CAGhE;AAED,qBAAa,4BAA6B,SAAQ,eAAe;IAC5C,uBAAuB,EAAE,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,EAAE;gBAArD,uBAAuB,EAAE,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,EAAE;CAGzE;AAED,qBAAa,wBAAyB,SAAQ,eAAe;IACxC,MAAM,EAAE,eAAe,EAAE;gBAAzB,MAAM,EAAE,eAAe,EAAE;CAG7C;AAED,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,4BAA4B,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,GAC9E,IAAI,CAcN;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAC5B,WAAW,EAAE,aAAa,EAC1B,UAAU,EAAE,qBAAqB,EAAE,EACnC,OAAO,EAAE,OAAO,CAAC,OAAO,GACvB,IAAI,CAEN;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EACrE,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,wBAAwB,CAAC,OAAO,CAAC,EACzC,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,OAAO,CAAC,CAmBlB"}

package/dist/esm/transaction/descriptor/verifyTransaction.js

@@ -0,0 +1,66 @@
+import * as utxolib from '@bitgo-beta/utxo-lib';
+import { TxIntentMismatchError } from '@bitgo-beta/sdk-core';
+import { toBaseParsedTransactionOutputsFromPsbt } from './parse';
+export class ValidationError extends Error {
+    constructor(message) {
+        super(message);
+    }
+}
+export class ErrorMissingOutputs extends ValidationError {
+    constructor(missingOutputs) {
+        super(`missing outputs (count=${missingOutputs.length})`);
+        this.missingOutputs = missingOutputs;
+    }
+}
+export class ErrorImplicitExternalOutputs extends ValidationError {
+    constructor(implicitExternalOutputs) {
+        super(`unexpected implicit external outputs (count=${implicitExternalOutputs.length})`);
+        this.implicitExternalOutputs = implicitExternalOutputs;
+    }
+}
+export class AggregateValidationError extends ValidationError {
+    constructor(errors) {
+        super(`aggregate validation error (count=${errors.length})`);
+        this.errors = errors;
+    }
+}
+export function assertExpectedOutputDifference(parsedOutputs) {
+    const errors = [];
+    if (parsedOutputs.missingOutputs.length > 0) {
+        errors.push(new ErrorMissingOutputs(parsedOutputs.missingOutputs));
+    }
+    if (parsedOutputs.implicitExternalOutputs.length > 0) {
+        // FIXME: for paygo we need to relax this a little bit
+        errors.push(new ErrorImplicitExternalOutputs(parsedOutputs.implicitExternalOutputs));
+    }
+    if (errors.length > 0) {
+        // FIXME(BTC-1688): enable ES2021
+        // throw new AggregateError(errors);
+        throw new AggregateValidationError(errors);
+    }
+}
+export function assertValidTransaction(psbt, descriptors, recipients, network) {
+    assertExpectedOutputDifference(toBaseParsedTransactionOutputsFromPsbt(psbt, descriptors, recipients, network));
+}
+/**
+ * Wrapper around assertValidTransaction that returns a boolean instead of throwing.
+ *
+ * We follow the AbstractUtxoCoin interface here which is a bit confused - the return value is a boolean but we
+ * also throw errors (because we actually want to know what went wrong).
+ *
+ * @param coin
+ * @param params
+ * @param descriptorMap
+ * @returns {boolean} True if verification passes
+ * @throws {TxIntentMismatchError} if transaction validation fails
+ */
+export async function verifyTransaction(coin, params, descriptorMap) {
+    const tx = coin.decodeTransactionFromPrebuild(params.txPrebuild);
+    if (!(tx instanceof utxolib.bitgo.UtxoPsbt)) {
+        const txExplanation = await TxIntentMismatchError.tryGetTxExplanation(coin, params.txPrebuild);
+        throw new TxIntentMismatchError('unexpected transaction type', params.reqId, [params.txParams], params.txPrebuild.txHex, txExplanation);
+    }
+    assertValidTransaction(tx, descriptorMap, params.txParams.recipients ?? [], tx.network);
+    return true;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmVyaWZ5VHJhbnNhY3Rpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvdHJhbnNhY3Rpb24vZGVzY3JpcHRvci92ZXJpZnlUcmFuc2FjdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLHNCQUFzQixDQUFDO0FBQ2hELE9BQU8sRUFBeUIscUJBQXFCLEVBQWEsTUFBTSxzQkFBc0IsQ0FBQztBQU0vRixPQUFPLEVBQUUsc0NBQXNDLEVBQUUsTUFBTSxTQUFTLENBQUM7QUFFakUsTUFBTSxPQUFPLGVBQWdCLFNBQVEsS0FBSztJQUN4QyxZQUFZLE9BQWU7UUFDekIsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQ2pCLENBQUM7Q0FDRjtBQUVELE1BQU0sT0FBTyxtQkFBb0IsU0FBUSxlQUFlO0lBQ3RELFlBQW1CLGNBQTRDO1FBQzdELEtBQUssQ0FBQywwQkFBMEIsY0FBYyxDQUFDLE1BQU0sR0FBRyxDQUFDLENBQUM7UUFEekMsbUJBQWMsR0FBZCxjQUFjLENBQThCO0lBRS9ELENBQUM7Q0FDRjtBQUVELE1BQU0sT0FBTyw0QkFBNkIsU0FBUSxlQUFlO0lBQy9ELFlBQW1CLHVCQUFxRDtRQUN0RSxLQUFLLENBQUMsK0NBQStDLHVCQUF1QixDQUFDLE1BQU0sR0FBRyxDQUFDLENBQUM7UUFEdkUsNEJBQXVCLEdBQXZCLHVCQUF1QixDQUE4QjtJQUV4RSxDQUFDO0NBQ0Y7QUFFRCxNQUFNLE9BQU8sd0JBQXlCLFNBQVEsZUFBZTtJQUMzRCxZQUFtQixNQUF5QjtRQUMxQyxLQUFLLENBQUMscUNBQXFDLE1BQU0sQ0FBQyxNQUFNLEdBQUcsQ0FBQyxDQUFDO1FBRDVDLFdBQU0sR0FBTixNQUFNLENBQW1CO0lBRTVDLENBQUM7Q0FDRjtBQUVELE1BQU0sVUFBVSw4QkFBOEIsQ0FDNUMsYUFBK0U7SUFFL0UsTUFBTSxNQUFNLEdBQXNCLEVBQUUsQ0FBQztJQUNyQyxJQUFJLGFBQWEsQ0FBQyxjQUFjLENBQUMsTUFBTSxHQUFHLENBQUMsRUFBRSxDQUFDO1FBQzVDLE1BQU0sQ0FBQyxJQUFJLENBQUMsSUFBSSxtQkFBbUIsQ0FBQyxhQUFhLENBQUMsY0FBYyxDQUFDLENBQUMsQ0FBQztJQUNyRSxDQUFDO0lBQ0QsSUFBSSxhQUFhLENBQUMsdUJBQXVCLENBQUMsTUFBTSxHQUFHLENBQUMsRUFBRSxDQUFDO1FBQ3JELHNEQUFzRDtRQUN0RCxNQUFNLENBQUMsSUFBSSxDQUFDLElBQUksNEJBQTRCLENBQUMsYUFBYSxDQUFDLHVCQUF1QixDQUFDLENBQUMsQ0FBQztJQUN2RixDQUFDO0lBQ0QsSUFBSSxNQUFNLENBQUMsTUFBTSxHQUFHLENBQUMsRUFBRSxDQUFDO1FBQ3RCLGlDQUFpQztRQUNqQyxvQ0FBb0M7UUFDcEMsTUFBTSxJQUFJLHdCQUF3QixDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQzdDLENBQUM7QUFDSCxDQUFDO0FBRUQsTUFBTSxVQUFVLHNCQUFzQixDQUNwQyxJQUE0QixFQUM1QixXQUEwQixFQUMxQixVQUFtQyxFQUNuQyxPQUF3QjtJQUV4Qiw4QkFBOEIsQ0FBQyxzQ0FBc0MsQ0FBQyxJQUFJLEVBQUUsV0FBVyxFQUFFLFVBQVUsRUFBRSxPQUFPLENBQUMsQ0FBQyxDQUFDO0FBQ2pILENBQUM7QUFFRDs7Ozs7Ozs7Ozs7R0FXRztBQUNILE1BQU0sQ0FBQyxLQUFLLFVBQVUsaUJBQWlCLENBQ3JDLElBQXNCLEVBQ3RCLE1BQXlDLEVBQ3pDLGFBQTRCO0lBRTVCLE1BQU0sRUFBRSxHQUFHLElBQUksQ0FBQyw2QkFBNkIsQ0FBQyxNQUFNLENBQUMsVUFBVSxDQUFDLENBQUM7SUFDakUsSUFBSSxDQUFDLENBQUMsRUFBRSxZQUFZLE9BQU8sQ0FBQyxLQUFLLENBQUMsUUFBUSxDQUFDLEVBQUUsQ0FBQztRQUM1QyxNQUFNLGFBQWEsR0FBRyxNQUFNLHFCQUFxQixDQUFDLG1CQUFtQixDQUNuRSxJQUE0QixFQUM1QixNQUFNLENBQUMsVUFBVSxDQUNsQixDQUFDO1FBQ0YsTUFBTSxJQUFJLHFCQUFxQixDQUM3Qiw2QkFBNkIsRUFDN0IsTUFBTSxDQUFDLEtBQUssRUFDWixDQUFDLE1BQU0sQ0FBQyxRQUFRLENBQUMsRUFDakIsTUFBTSxDQUFDLFVBQVUsQ0FBQyxLQUFLLEVBQ3ZCLGFBQWEsQ0FDZCxDQUFDO0lBQ0osQ0FBQztJQUVELHNCQUFzQixDQUFDLEVBQUUsRUFBRSxhQUFhLEVBQUUsTUFBTSxDQUFDLFFBQVEsQ0FBQyxVQUFVLElBQUksRUFBRSxFQUFFLEVBQUUsQ0FBQyxPQUFPLENBQUMsQ0FBQztJQUV4RixPQUFPLElBQUksQ0FBQztBQUNkLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgKiBhcyB1dHhvbGliIGZyb20gJ0BiaXRnby1iZXRhL3V0eG8tbGliJztcbmltcG9ydCB7IElUcmFuc2FjdGlvblJlY2lwaWVudCwgVHhJbnRlbnRNaXNtYXRjaEVycm9yLCBJQmFzZUNvaW4gfSBmcm9tICdAYml0Z28tYmV0YS9zZGstY29yZSc7XG5pbXBvcnQgeyBEZXNjcmlwdG9yTWFwIH0gZnJvbSAnQGJpdGdvLWJldGEvdXR4by1jb3JlL2Rlc2NyaXB0b3InO1xuXG5pbXBvcnQgeyBBYnN0cmFjdFV0eG9Db2luLCBWZXJpZnlUcmFuc2FjdGlvbk9wdGlvbnMgfSBmcm9tICcuLi8uLi9hYnN0cmFjdFV0eG9Db2luJztcbmltcG9ydCB7IEJhc2VPdXRwdXQsIEJhc2VQYXJzZWRUcmFuc2FjdGlvbk91dHB1dHMgfSBmcm9tICcuLi90eXBlcyc7XG5cbmltcG9ydCB7IHRvQmFzZVBhcnNlZFRyYW5zYWN0aW9uT3V0cHV0c0Zyb21Qc2J0IH0gZnJvbSAnLi9wYXJzZSc7XG5cbmV4cG9ydCBjbGFzcyBWYWxpZGF0aW9uRXJyb3IgZXh0ZW5kcyBFcnJvciB7XG4gIGNvbnN0cnVjdG9yKG1lc3NhZ2U6IHN0cmluZykge1xuICAgIHN1cGVyKG1lc3NhZ2UpO1xuICB9XG59XG5cbmV4cG9ydCBjbGFzcyBFcnJvck1pc3NpbmdPdXRwdXRzIGV4dGVuZHMgVmFsaWRhdGlvbkVycm9yIHtcbiAgY29uc3RydWN0b3IocHVibGljIG1pc3NpbmdPdXRwdXRzOiBCYXNlT3V0cHV0PGJpZ2ludCB8ICdtYXgnPltdKSB7XG4gICAgc3VwZXIoYG1pc3Npbmcgb3V0cHV0cyAoY291bnQ9JHttaXNzaW5nT3V0cHV0cy5sZW5ndGh9KWApO1xuICB9XG59XG5cbmV4cG9ydCBjbGFzcyBFcnJvckltcGxpY2l0RXh0ZXJuYWxPdXRwdXRzIGV4dGVuZHMgVmFsaWRhdGlvbkVycm9yIHtcbiAgY29uc3RydWN0b3IocHVibGljIGltcGxpY2l0RXh0ZXJuYWxPdXRwdXRzOiBCYXNlT3V0cHV0PGJpZ2ludCB8ICdtYXgnPltdKSB7XG4gICAgc3VwZXIoYHVuZXhwZWN0ZWQgaW1wbGljaXQgZXh0ZXJuYWwgb3V0cHV0cyAoY291bnQ9JHtpbXBsaWNpdEV4dGVybmFsT3V0cHV0cy5sZW5ndGh9KWApO1xuICB9XG59XG5cbmV4cG9ydCBjbGFzcyBBZ2dyZWdhdGVWYWxpZGF0aW9uRXJyb3IgZXh0ZW5kcyBWYWxpZGF0aW9uRXJyb3Ige1xuICBjb25zdHJ1Y3RvcihwdWJsaWMgZXJyb3JzOiBWYWxpZGF0aW9uRXJyb3JbXSkge1xuICAgIHN1cGVyKGBhZ2dyZWdhdGUgdmFsaWRhdGlvbiBlcnJvciAoY291bnQ9JHtlcnJvcnMubGVuZ3RofSlgKTtcbiAgfVxufVxuXG5leHBvcnQgZnVuY3Rpb24gYXNzZXJ0RXhwZWN0ZWRPdXRwdXREaWZmZXJlbmNlKFxuICBwYXJzZWRPdXRwdXRzOiBCYXNlUGFyc2VkVHJhbnNhY3Rpb25PdXRwdXRzPGJpZ2ludCwgQmFzZU91dHB1dDxiaWdpbnQgfCAnbWF4Jz4+XG4pOiB2b2lkIHtcbiAgY29uc3QgZXJyb3JzOiBWYWxpZGF0aW9uRXJyb3JbXSA9IFtdO1xuICBpZiAocGFyc2VkT3V0cHV0cy5taXNzaW5nT3V0cHV0cy5sZW5ndGggPiAwKSB7XG4gICAgZXJyb3JzLnB1c2gobmV3IEVycm9yTWlzc2luZ091dHB1dHMocGFyc2VkT3V0cHV0cy5taXNzaW5nT3V0cHV0cykpO1xuICB9XG4gIGlmIChwYXJzZWRPdXRwdXRzLmltcGxpY2l0RXh0ZXJuYWxPdXRwdXRzLmxlbmd0aCA+IDApIHtcbiAgICAvLyBGSVhNRTogZm9yIHBheWdvIHdlIG5lZWQgdG8gcmVsYXggdGhpcyBhIGxpdHRsZSBiaXRcbiAgICBlcnJvcnMucHVzaChuZXcgRXJyb3JJbXBsaWNpdEV4dGVybmFsT3V0cHV0cyhwYXJzZWRPdXRwdXRzLmltcGxpY2l0RXh0ZXJuYWxPdXRwdXRzKSk7XG4gIH1cbiAgaWYgKGVycm9ycy5sZW5ndGggPiAwKSB7XG4gICAgLy8gRklYTUUoQlRDLTE2ODgpOiBlbmFibGUgRVMyMDIxXG4gICAgLy8gdGhyb3cgbmV3IEFnZ3JlZ2F0ZUVycm9yKGVycm9ycyk7XG4gICAgdGhyb3cgbmV3IEFnZ3JlZ2F0ZVZhbGlkYXRpb25FcnJvcihlcnJvcnMpO1xuICB9XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBhc3NlcnRWYWxpZFRyYW5zYWN0aW9uKFxuICBwc2J0OiB1dHhvbGliLmJpdGdvLlV0eG9Qc2J0LFxuICBkZXNjcmlwdG9yczogRGVzY3JpcHRvck1hcCxcbiAgcmVjaXBpZW50czogSVRyYW5zYWN0aW9uUmVjaXBpZW50W10sXG4gIG5ldHdvcms6IHV0eG9saWIuTmV0d29ya1xuKTogdm9pZCB7XG4gIGFzc2VydEV4cGVjdGVkT3V0cHV0RGlmZmVyZW5jZSh0b0Jhc2VQYXJzZWRUcmFuc2FjdGlvbk91dHB1dHNGcm9tUHNidChwc2J0LCBkZXNjcmlwdG9ycywgcmVjaXBpZW50cywgbmV0d29yaykpO1xufVxuXG4vKipcbiAqIFdyYXBwZXIgYXJvdW5kIGFzc2VydFZhbGlkVHJhbnNhY3Rpb24gdGhhdCByZXR1cm5zIGEgYm9vbGVhbiBpbnN0ZWFkIG9mIHRocm93aW5nLlxuICpcbiAqIFdlIGZvbGxvdyB0aGUgQWJzdHJhY3RVdHhvQ29pbiBpbnRlcmZhY2UgaGVyZSB3aGljaCBpcyBhIGJpdCBjb25mdXNlZCAtIHRoZSByZXR1cm4gdmFsdWUgaXMgYSBib29sZWFuIGJ1dCB3ZVxuICogYWxzbyB0aHJvdyBlcnJvcnMgKGJlY2F1c2Ugd2UgYWN0dWFsbHkgd2FudCB0byBrbm93IHdoYXQgd2VudCB3cm9uZykuXG4gKlxuICogQHBhcmFtIGNvaW5cbiAqIEBwYXJhbSBwYXJhbXNcbiAqIEBwYXJhbSBkZXNjcmlwdG9yTWFwXG4gKiBAcmV0dXJucyB7Ym9vbGVhbn0gVHJ1ZSBpZiB2ZXJpZmljYXRpb24gcGFzc2VzXG4gKiBAdGhyb3dzIHtUeEludGVudE1pc21hdGNoRXJyb3J9IGlmIHRyYW5zYWN0aW9uIHZhbGlkYXRpb24gZmFpbHNcbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIHZlcmlmeVRyYW5zYWN0aW9uPFROdW1iZXIgZXh0ZW5kcyBudW1iZXIgfCBiaWdpbnQ+KFxuICBjb2luOiBBYnN0cmFjdFV0eG9Db2luLFxuICBwYXJhbXM6IFZlcmlmeVRyYW5zYWN0aW9uT3B0aW9uczxUTnVtYmVyPixcbiAgZGVzY3JpcHRvck1hcDogRGVzY3JpcHRvck1hcFxuKTogUHJvbWlzZTxib29sZWFuPiB7XG4gIGNvbnN0IHR4ID0gY29pbi5kZWNvZGVUcmFuc2FjdGlvbkZyb21QcmVidWlsZChwYXJhbXMudHhQcmVidWlsZCk7XG4gIGlmICghKHR4IGluc3RhbmNlb2YgdXR4b2xpYi5iaXRnby5VdHhvUHNidCkpIHtcbiAgICBjb25zdCB0eEV4cGxhbmF0aW9uID0gYXdhaXQgVHhJbnRlbnRNaXNtYXRjaEVycm9yLnRyeUdldFR4RXhwbGFuYXRpb24oXG4gICAgICBjb2luIGFzIHVua25vd24gYXMgSUJhc2VDb2luLFxuICAgICAgcGFyYW1zLnR4UHJlYnVpbGRcbiAgICApO1xuICAgIHRocm93IG5ldyBUeEludGVudE1pc21hdGNoRXJyb3IoXG4gICAgICAndW5leHBlY3RlZCB0cmFuc2FjdGlvbiB0eXBlJyxcbiAgICAgIHBhcmFtcy5yZXFJZCxcbiAgICAgIFtwYXJhbXMudHhQYXJhbXNdLFxuICAgICAgcGFyYW1zLnR4UHJlYnVpbGQudHhIZXgsXG4gICAgICB0eEV4cGxhbmF0aW9uXG4gICAgKTtcbiAgfVxuXG4gIGFzc2VydFZhbGlkVHJhbnNhY3Rpb24odHgsIGRlc2NyaXB0b3JNYXAsIHBhcmFtcy50eFBhcmFtcy5yZWNpcGllbnRzID8/IFtdLCB0eC5uZXR3b3JrKTtcblxuICByZXR1cm4gdHJ1ZTtcbn1cbiJdfQ==

package/dist/esm/transaction/explainTransaction.d.ts

@@ -0,0 +1,18 @@
+import * as utxolib from '@bitgo-beta/utxo-lib';
+import { fixedScriptWallet } from '@bitgo/wasm-utxo';
+import { IWallet } from '@bitgo-beta/sdk-core';
+import type { TransactionExplanationUtxolibLegacy, TransactionExplanationUtxolibPsbt, TransactionExplanationWasm } from './fixedScript/explainTransaction';
+import * as fixedScript from './fixedScript';
+/**
+ * Decompose a raw transaction into useful information, such as the total amounts,
+ * change amounts, and transaction outputs.
+ */
+export declare function explainTx<TNumber extends number | bigint>(tx: utxolib.bitgo.UtxoTransaction<TNumber> | utxolib.bitgo.UtxoPsbt | fixedScriptWallet.BitGoPsbt, params: {
+    wallet?: IWallet;
+    pubs?: string[];
+    txInfo?: {
+        unspents?: utxolib.bitgo.Unspent<TNumber>[];
+    };
+    changeInfo?: fixedScript.ChangeAddressInfo[];
+}, network: utxolib.Network): TransactionExplanationUtxolibLegacy | TransactionExplanationUtxolibPsbt | TransactionExplanationWasm;
+//# sourceMappingURL=explainTransaction.d.ts.map

package/dist/esm/transaction/explainTransaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainTransaction.d.ts","sourceRoot":"","sources":["../../../src/transaction/explainTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAY,OAAO,EAAU,MAAM,sBAAsB,CAAC;AAOjE,OAAO,KAAK,EACV,mCAAmC,EACnC,iCAAiC,EACjC,0BAA0B,EAC3B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,WAAW,MAAM,eAAe,CAAC;AAG7C;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EACvD,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,iBAAiB,CAAC,SAAS,EACjG,MAAM,EAAE;IACN,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAA;KAAE,CAAC;IACzD,UAAU,CAAC,EAAE,WAAW,CAAC,iBAAiB,EAAE,CAAC;CAC9C,EACD,OAAO,EAAE,OAAO,CAAC,OAAO,GACvB,mCAAmC,GAAG,iCAAiC,GAAG,0BAA0B,CAyCtG"}

package/dist/esm/transaction/explainTransaction.js

@@ -0,0 +1,52 @@
+import * as utxolib from '@bitgo-beta/utxo-lib';
+import { fixedScriptWallet } from '@bitgo/wasm-utxo';
+import { isTriple } from '@bitgo-beta/sdk-core';
+import { getDescriptorMapFromWallet, isDescriptorWallet } from '../descriptor';
+import { toBip32Triple } from '../keychains';
+import { getPolicyForEnv } from '../descriptor/validatePolicy';
+import { getReplayProtectionPubkeys } from './fixedScript/replayProtection';
+import * as fixedScript from './fixedScript';
+import * as descriptor from './descriptor';
+/**
+ * Decompose a raw transaction into useful information, such as the total amounts,
+ * change amounts, and transaction outputs.
+ */
+export function explainTx(tx, params, network) {
+    if (params.wallet && isDescriptorWallet(params.wallet)) {
+        if (tx instanceof utxolib.bitgo.UtxoPsbt) {
+            if (!params.pubs || !isTriple(params.pubs)) {
+                throw new Error('pub triple is required for descriptor wallets');
+            }
+            const walletKeys = toBip32Triple(params.pubs);
+            const descriptors = getDescriptorMapFromWallet(params.wallet, walletKeys, getPolicyForEnv(params.wallet.bitgo.env));
+            return descriptor.explainPsbt(tx, descriptors);
+        }
+        throw new Error('legacy transactions are not supported for descriptor wallets');
+    }
+    if (tx instanceof utxolib.bitgo.UtxoPsbt) {
+        return fixedScript.explainPsbt(tx, params, network);
+    }
+    else if (tx instanceof fixedScriptWallet.BitGoPsbt) {
+        const pubs = params.pubs;
+        if (!pubs) {
+            throw new Error('pub triple is required');
+        }
+        const walletXpubs = pubs instanceof utxolib.bitgo.RootWalletKeys
+            ? pubs.triple.map((k) => k.neutered().toBase58())
+            : isTriple(pubs)
+                ? pubs
+                : undefined;
+        if (!walletXpubs) {
+            throw new Error('pub triple must be valid triple or RootWalletKeys');
+        }
+        return fixedScript.explainPsbtWasm(tx, walletXpubs, {
+            replayProtection: {
+                publicKeys: getReplayProtectionPubkeys(network),
+            },
+        });
+    }
+    else {
+        return fixedScript.explainLegacyTx(tx, params, network);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXhwbGFpblRyYW5zYWN0aW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3RyYW5zYWN0aW9uL2V4cGxhaW5UcmFuc2FjdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLHNCQUFzQixDQUFDO0FBQ2hELE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQ3JELE9BQU8sRUFBRSxRQUFRLEVBQW1CLE1BQU0sc0JBQXNCLENBQUM7QUFFakUsT0FBTyxFQUFFLDBCQUEwQixFQUFFLGtCQUFrQixFQUFFLE1BQU0sZUFBZSxDQUFDO0FBQy9FLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFDN0MsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBRS9ELE9BQU8sRUFBRSwwQkFBMEIsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBTTVFLE9BQU8sS0FBSyxXQUFXLE1BQU0sZUFBZSxDQUFDO0FBQzdDLE9BQU8sS0FBSyxVQUFVLE1BQU0sY0FBYyxDQUFDO0FBRTNDOzs7R0FHRztBQUNILE1BQU0sVUFBVSxTQUFTLENBQ3ZCLEVBQWlHLEVBQ2pHLE1BS0MsRUFDRCxPQUF3QjtJQUV4QixJQUFJLE1BQU0sQ0FBQyxNQUFNLElBQUksa0JBQWtCLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7UUFDdkQsSUFBSSxFQUFFLFlBQVksT0FBTyxDQUFDLEtBQUssQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUN6QyxJQUFJLENBQUMsTUFBTSxDQUFDLElBQUksSUFBSSxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztnQkFDM0MsTUFBTSxJQUFJLEtBQUssQ0FBQywrQ0FBK0MsQ0FBQyxDQUFDO1lBQ25FLENBQUM7WUFDRCxNQUFNLFVBQVUsR0FBRyxhQUFhLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDO1lBQzlDLE1BQU0sV0FBVyxHQUFHLDBCQUEwQixDQUM1QyxNQUFNLENBQUMsTUFBTSxFQUNiLFVBQVUsRUFDVixlQUFlLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLENBQ3pDLENBQUM7WUFDRixPQUFPLFVBQVUsQ0FBQyxXQUFXLENBQUMsRUFBRSxFQUFFLFdBQVcsQ0FBQyxDQUFDO1FBQ2pELENBQUM7UUFFRCxNQUFNLElBQUksS0FBSyxDQUFDLDhEQUE4RCxDQUFDLENBQUM7SUFDbEYsQ0FBQztJQUNELElBQUksRUFBRSxZQUFZLE9BQU8sQ0FBQyxLQUFLLENBQUMsUUFBUSxFQUFFLENBQUM7UUFDekMsT0FBTyxXQUFXLENBQUMsV0FBVyxDQUFDLEVBQUUsRUFBRSxNQUFNLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDdEQsQ0FBQztTQUFNLElBQUksRUFBRSxZQUFZLGlCQUFpQixDQUFDLFNBQVMsRUFBRSxDQUFDO1FBQ3JELE1BQU0sSUFBSSxHQUFHLE1BQU0sQ0FBQyxJQUFJLENBQUM7UUFDekIsSUFBSSxDQUFDLElBQUksRUFBRSxDQUFDO1lBQ1YsTUFBTSxJQUFJLEtBQUssQ0FBQyx3QkFBd0IsQ0FBQyxDQUFDO1FBQzVDLENBQUM7UUFDRCxNQUFNLFdBQVcsR0FDZixJQUFJLFlBQVksT0FBTyxDQUFDLEtBQUssQ0FBQyxjQUFjO1lBQzFDLENBQUMsQ0FBRSxJQUFJLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLFFBQVEsRUFBRSxDQUFDLFFBQVEsRUFBRSxDQUFvQjtZQUNyRSxDQUFDLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQztnQkFDaEIsQ0FBQyxDQUFFLElBQXVCO2dCQUMxQixDQUFDLENBQUMsU0FBUyxDQUFDO1FBQ2hCLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQztZQUNqQixNQUFNLElBQUksS0FBSyxDQUFDLG1EQUFtRCxDQUFDLENBQUM7UUFDdkUsQ0FBQztRQUNELE9BQU8sV0FBVyxDQUFDLGVBQWUsQ0FBQyxFQUFFLEVBQUUsV0FBVyxFQUFFO1lBQ2xELGdCQUFnQixFQUFFO2dCQUNoQixVQUFVLEVBQUUsMEJBQTBCLENBQUMsT0FBTyxDQUFDO2FBQ2hEO1NBQ0YsQ0FBQyxDQUFDO0lBQ0wsQ0FBQztTQUFNLENBQUM7UUFDTixPQUFPLFdBQVcsQ0FBQyxlQUFlLENBQUMsRUFBRSxFQUFFLE1BQU0sRUFBRSxPQUFPLENBQUMsQ0FBQztJQUMxRCxDQUFDO0FBQ0gsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCAqIGFzIHV0eG9saWIgZnJvbSAnQGJpdGdvLWJldGEvdXR4by1saWInO1xuaW1wb3J0IHsgZml4ZWRTY3JpcHRXYWxsZXQgfSBmcm9tICdAYml0Z28vd2FzbS11dHhvJztcbmltcG9ydCB7IGlzVHJpcGxlLCBJV2FsbGV0LCBUcmlwbGUgfSBmcm9tICdAYml0Z28tYmV0YS9zZGstY29yZSc7XG5cbmltcG9ydCB7IGdldERlc2NyaXB0b3JNYXBGcm9tV2FsbGV0LCBpc0Rlc2NyaXB0b3JXYWxsZXQgfSBmcm9tICcuLi9kZXNjcmlwdG9yJztcbmltcG9ydCB7IHRvQmlwMzJUcmlwbGUgfSBmcm9tICcuLi9rZXljaGFpbnMnO1xuaW1wb3J0IHsgZ2V0UG9saWN5Rm9yRW52IH0gZnJvbSAnLi4vZGVzY3JpcHRvci92YWxpZGF0ZVBvbGljeSc7XG5cbmltcG9ydCB7IGdldFJlcGxheVByb3RlY3Rpb25QdWJrZXlzIH0gZnJvbSAnLi9maXhlZFNjcmlwdC9yZXBsYXlQcm90ZWN0aW9uJztcbmltcG9ydCB0eXBlIHtcbiAgVHJhbnNhY3Rpb25FeHBsYW5hdGlvblV0eG9saWJMZWdhY3ksXG4gIFRyYW5zYWN0aW9uRXhwbGFuYXRpb25VdHhvbGliUHNidCxcbiAgVHJhbnNhY3Rpb25FeHBsYW5hdGlvbldhc20sXG59IGZyb20gJy4vZml4ZWRTY3JpcHQvZXhwbGFpblRyYW5zYWN0aW9uJztcbmltcG9ydCAqIGFzIGZpeGVkU2NyaXB0IGZyb20gJy4vZml4ZWRTY3JpcHQnO1xuaW1wb3J0ICogYXMgZGVzY3JpcHRvciBmcm9tICcuL2Rlc2NyaXB0b3InO1xuXG4vKipcbiAqIERlY29tcG9zZSBhIHJhdyB0cmFuc2FjdGlvbiBpbnRvIHVzZWZ1bCBpbmZvcm1hdGlvbiwgc3VjaCBhcyB0aGUgdG90YWwgYW1vdW50cyxcbiAqIGNoYW5nZSBhbW91bnRzLCBhbmQgdHJhbnNhY3Rpb24gb3V0cHV0cy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGV4cGxhaW5UeDxUTnVtYmVyIGV4dGVuZHMgbnVtYmVyIHwgYmlnaW50PihcbiAgdHg6IHV0eG9saWIuYml0Z28uVXR4b1RyYW5zYWN0aW9uPFROdW1iZXI+IHwgdXR4b2xpYi5iaXRnby5VdHhvUHNidCB8IGZpeGVkU2NyaXB0V2FsbGV0LkJpdEdvUHNidCxcbiAgcGFyYW1zOiB7XG4gICAgd2FsbGV0PzogSVdhbGxldDtcbiAgICBwdWJzPzogc3RyaW5nW107XG4gICAgdHhJbmZvPzogeyB1bnNwZW50cz86IHV0eG9saWIuYml0Z28uVW5zcGVudDxUTnVtYmVyPltdIH07XG4gICAgY2hhbmdlSW5mbz86IGZpeGVkU2NyaXB0LkNoYW5nZUFkZHJlc3NJbmZvW107XG4gIH0sXG4gIG5ldHdvcms6IHV0eG9saWIuTmV0d29ya1xuKTogVHJhbnNhY3Rpb25FeHBsYW5hdGlvblV0eG9saWJMZWdhY3kgfCBUcmFuc2FjdGlvbkV4cGxhbmF0aW9uVXR4b2xpYlBzYnQgfCBUcmFuc2FjdGlvbkV4cGxhbmF0aW9uV2FzbSB7XG4gIGlmIChwYXJhbXMud2FsbGV0ICYmIGlzRGVzY3JpcHRvcldhbGxldChwYXJhbXMud2FsbGV0KSkge1xuICAgIGlmICh0eCBpbnN0YW5jZW9mIHV0eG9saWIuYml0Z28uVXR4b1BzYnQpIHtcbiAgICAgIGlmICghcGFyYW1zLnB1YnMgfHwgIWlzVHJpcGxlKHBhcmFtcy5wdWJzKSkge1xuICAgICAgICB0aHJvdyBuZXcgRXJyb3IoJ3B1YiB0cmlwbGUgaXMgcmVxdWlyZWQgZm9yIGRlc2NyaXB0b3Igd2FsbGV0cycpO1xuICAgICAgfVxuICAgICAgY29uc3Qgd2FsbGV0S2V5cyA9IHRvQmlwMzJUcmlwbGUocGFyYW1zLnB1YnMpO1xuICAgICAgY29uc3QgZGVzY3JpcHRvcnMgPSBnZXREZXNjcmlwdG9yTWFwRnJvbVdhbGxldChcbiAgICAgICAgcGFyYW1zLndhbGxldCxcbiAgICAgICAgd2FsbGV0S2V5cyxcbiAgICAgICAgZ2V0UG9saWN5Rm9yRW52KHBhcmFtcy53YWxsZXQuYml0Z28uZW52KVxuICAgICAgKTtcbiAgICAgIHJldHVybiBkZXNjcmlwdG9yLmV4cGxhaW5Qc2J0KHR4LCBkZXNjcmlwdG9ycyk7XG4gICAgfVxuXG4gICAgdGhyb3cgbmV3IEVycm9yKCdsZWdhY3kgdHJhbnNhY3Rpb25zIGFyZSBub3Qgc3VwcG9ydGVkIGZvciBkZXNjcmlwdG9yIHdhbGxldHMnKTtcbiAgfVxuICBpZiAodHggaW5zdGFuY2VvZiB1dHhvbGliLmJpdGdvLlV0eG9Qc2J0KSB7XG4gICAgcmV0dXJuIGZpeGVkU2NyaXB0LmV4cGxhaW5Qc2J0KHR4LCBwYXJhbXMsIG5ldHdvcmspO1xuICB9IGVsc2UgaWYgKHR4IGluc3RhbmNlb2YgZml4ZWRTY3JpcHRXYWxsZXQuQml0R29Qc2J0KSB7XG4gICAgY29uc3QgcHVicyA9IHBhcmFtcy5wdWJzO1xuICAgIGlmICghcHVicykge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKCdwdWIgdHJpcGxlIGlzIHJlcXVpcmVkJyk7XG4gICAgfVxuICAgIGNvbnN0IHdhbGxldFhwdWJzOiBUcmlwbGU8c3RyaW5nPiB8IHVuZGVmaW5lZCA9XG4gICAgICBwdWJzIGluc3RhbmNlb2YgdXR4b2xpYi5iaXRnby5Sb290V2FsbGV0S2V5c1xuICAgICAgICA/IChwdWJzLnRyaXBsZS5tYXAoKGspID0+IGsubmV1dGVyZWQoKS50b0Jhc2U1OCgpKSBhcyBUcmlwbGU8c3RyaW5nPilcbiAgICAgICAgOiBpc1RyaXBsZShwdWJzKVxuICAgICAgICA/IChwdWJzIGFzIFRyaXBsZTxzdHJpbmc+KVxuICAgICAgICA6IHVuZGVmaW5lZDtcbiAgICBpZiAoIXdhbGxldFhwdWJzKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoJ3B1YiB0cmlwbGUgbXVzdCBiZSB2YWxpZCB0cmlwbGUgb3IgUm9vdFdhbGxldEtleXMnKTtcbiAgICB9XG4gICAgcmV0dXJuIGZpeGVkU2NyaXB0LmV4cGxhaW5Qc2J0V2FzbSh0eCwgd2FsbGV0WHB1YnMsIHtcbiAgICAgIHJlcGxheVByb3RlY3Rpb246IHtcbiAgICAgICAgcHVibGljS2V5czogZ2V0UmVwbGF5UHJvdGVjdGlvblB1YmtleXMobmV0d29yayksXG4gICAgICB9LFxuICAgIH0pO1xuICB9IGVsc2Uge1xuICAgIHJldHVybiBmaXhlZFNjcmlwdC5leHBsYWluTGVnYWN5VHgodHgsIHBhcmFtcywgbmV0d29yayk7XG4gIH1cbn1cbiJdfQ==

package/dist/esm/transaction/fetchInputs.d.ts

@@ -0,0 +1,26 @@
+import * as utxolib from '@bitgo-beta/utxo-lib';
+import { BitGoBase, IRequestTracer } from '@bitgo-beta/sdk-core';
+import { AbstractUtxoCoin, TransactionPrebuild } from '../abstractUtxoCoin';
+/**
+ * Get the inputs for a psbt from a prebuild.
+ */
+export declare function getPsbtTxInputs(psbtArg: string | utxolib.bitgo.UtxoPsbt, network: utxolib.Network): {
+    address: string;
+    value: bigint;
+    valueString: string;
+}[];
+/**
+ * Get the inputs for a transaction from a prebuild.
+ */
+export declare function getTxInputs<TNumber extends number | bigint>(params: {
+    txPrebuild: TransactionPrebuild<TNumber>;
+    bitgo: BitGoBase;
+    coin: AbstractUtxoCoin;
+    disableNetworking: boolean;
+    reqId?: IRequestTracer;
+}): Promise<{
+    address: string;
+    value: TNumber;
+    valueString: string;
+}[]>;
+//# sourceMappingURL=fetchInputs.d.ts.map

package/dist/esm/transaction/fetchInputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchInputs.d.ts","sourceRoot":"","sources":["../../../src/transaction/fetchInputs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE5E;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,EACxC,OAAO,EAAE,OAAO,CAAC,OAAO,GACvB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,CAyB3D;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE;IACzE,UAAU,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACzC,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,gBAAgB,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAoCtE"}

package/dist/esm/transaction/fetchInputs.js

@@ -0,0 +1,72 @@
+import * as utxolib from '@bitgo-beta/utxo-lib';
+/**
+ * Get the inputs for a psbt from a prebuild.
+ */
+export function getPsbtTxInputs(psbtArg, network) {
+    const psbt = psbtArg instanceof utxolib.bitgo.UtxoPsbt ? psbtArg : utxolib.bitgo.createPsbtFromHex(psbtArg, network);
+    const txInputs = psbt.txInputs;
+    return psbt.data.inputs.map((input, index) => {
+        let address;
+        let value;
+        if (input.witnessUtxo) {
+            address = utxolib.address.fromOutputScript(input.witnessUtxo.script, network);
+            value = input.witnessUtxo.value;
+        }
+        else if (input.nonWitnessUtxo) {
+            const tx = utxolib.bitgo.createTransactionFromBuffer(input.nonWitnessUtxo, network, {
+                amountType: 'bigint',
+            });
+            const txId = Buffer.from(txInputs[index].hash).reverse().toString('hex');
+            if (tx.getId() !== txId) {
+                throw new Error('input transaction hex does not match id');
+            }
+            const prevTxOutputIndex = txInputs[index].index;
+            address = utxolib.address.fromOutputScript(tx.outs[prevTxOutputIndex].script, network);
+            value = tx.outs[prevTxOutputIndex].value;
+        }
+        else {
+            throw new Error('psbt input is missing both witnessUtxo and nonWitnessUtxo');
+        }
+        return { address, value, valueString: value.toString() };
+    });
+}
+/**
+ * Get the inputs for a transaction from a prebuild.
+ */
+export async function getTxInputs(params) {
+    const { txPrebuild, bitgo, coin, disableNetworking, reqId } = params;
+    if (!txPrebuild.txHex) {
+        throw new Error(`txPrebuild.txHex not set`);
+    }
+    const transaction = coin.createTransactionFromHex(txPrebuild.txHex);
+    const transactionCache = {};
+    return await Promise.all(transaction.ins.map(async (currentInput) => {
+        const transactionId = Buffer.from(currentInput.hash).reverse().toString('hex');
+        const txHex = txPrebuild.txInfo?.txHexes?.[transactionId];
+        if (txHex) {
+            const localTx = coin.createTransactionFromHex(txHex);
+            if (localTx.getId() !== transactionId) {
+                throw new Error('input transaction hex does not match id');
+            }
+            const currentOutput = localTx.outs[currentInput.index];
+            const address = utxolib.address.fromOutputScript(currentOutput.script, coin.network);
+            return {
+                address,
+                value: currentOutput.value,
+                valueString: currentOutput.value.toString(),
+            };
+        }
+        else if (!transactionCache[transactionId]) {
+            if (disableNetworking) {
+                throw new Error('attempting to retrieve transaction details externally with networking disabled');
+            }
+            if (reqId) {
+                bitgo.setRequestTracer(reqId);
+            }
+            transactionCache[transactionId] = await bitgo.get(coin.url(`/public/tx/${transactionId}`)).result();
+        }
+        const transactionDetails = transactionCache[transactionId];
+        return transactionDetails.outputs[currentInput.index];
+    }));
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmV0Y2hJbnB1dHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvdHJhbnNhY3Rpb24vZmV0Y2hJbnB1dHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxzQkFBc0IsQ0FBQztBQUtoRDs7R0FFRztBQUNILE1BQU0sVUFBVSxlQUFlLENBQzdCLE9BQXdDLEVBQ3hDLE9BQXdCO0lBRXhCLE1BQU0sSUFBSSxHQUFHLE9BQU8sWUFBWSxPQUFPLENBQUMsS0FBSyxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLGlCQUFpQixDQUFDLE9BQU8sRUFBRSxPQUFPLENBQUMsQ0FBQztJQUNySCxNQUFNLFFBQVEsR0FBRyxJQUFJLENBQUMsUUFBUSxDQUFDO0lBQy9CLE9BQU8sSUFBSSxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUMsS0FBSyxFQUFFLEtBQUssRUFBRSxFQUFFO1FBQzNDLElBQUksT0FBZSxDQUFDO1FBQ3BCLElBQUksS0FBYSxDQUFDO1FBQ2xCLElBQUksS0FBSyxDQUFDLFdBQVcsRUFBRSxDQUFDO1lBQ3RCLE9BQU8sR0FBRyxPQUFPLENBQUMsT0FBTyxDQUFDLGdCQUFnQixDQUFDLEtBQUssQ0FBQyxXQUFXLENBQUMsTUFBTSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1lBQzlFLEtBQUssR0FBRyxLQUFLLENBQUMsV0FBVyxDQUFDLEtBQUssQ0FBQztRQUNsQyxDQUFDO2FBQU0sSUFBSSxLQUFLLENBQUMsY0FBYyxFQUFFLENBQUM7WUFDaEMsTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLEtBQUssQ0FBQywyQkFBMkIsQ0FBUyxLQUFLLENBQUMsY0FBYyxFQUFFLE9BQU8sRUFBRTtnQkFDMUYsVUFBVSxFQUFFLFFBQVE7YUFDckIsQ0FBQyxDQUFDO1lBQ0gsTUFBTSxJQUFJLEdBQUksTUFBTSxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsS0FBSyxDQUFDLENBQUMsSUFBSSxDQUFDLENBQUMsT0FBTyxFQUFhLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQyxDQUFDO1lBQ3JGLElBQUksRUFBRSxDQUFDLEtBQUssRUFBRSxLQUFLLElBQUksRUFBRSxDQUFDO2dCQUN4QixNQUFNLElBQUksS0FBSyxDQUFDLHlDQUF5QyxDQUFDLENBQUM7WUFDN0QsQ0FBQztZQUNELE1BQU0saUJBQWlCLEdBQUcsUUFBUSxDQUFDLEtBQUssQ0FBQyxDQUFDLEtBQUssQ0FBQztZQUNoRCxPQUFPLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQyxFQUFFLENBQUMsSUFBSSxDQUFDLGlCQUFpQixDQUFDLENBQUMsTUFBTSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1lBQ3ZGLEtBQUssR0FBRyxFQUFFLENBQUMsSUFBSSxDQUFDLGlCQUFpQixDQUFDLENBQUMsS0FBSyxDQUFDO1FBQzNDLENBQUM7YUFBTSxDQUFDO1lBQ04sTUFBTSxJQUFJLEtBQUssQ0FBQywyREFBMkQsQ0FBQyxDQUFDO1FBQy9FLENBQUM7UUFDRCxPQUFPLEVBQUUsT0FBTyxFQUFFLEtBQUssRUFBRSxXQUFXLEVBQUUsS0FBSyxDQUFDLFFBQVEsRUFBRSxFQUFFLENBQUM7SUFDM0QsQ0FBQyxDQUFDLENBQUM7QUFDTCxDQUFDO0FBRUQ7O0dBRUc7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLFdBQVcsQ0FBa0MsTUFNbEU7SUFDQyxNQUFNLEVBQUUsVUFBVSxFQUFFLEtBQUssRUFBRSxJQUFJLEVBQUUsaUJBQWlCLEVBQUUsS0FBSyxFQUFFLEdBQUcsTUFBTSxDQUFDO0lBQ3JFLElBQUksQ0FBQyxVQUFVLENBQUMsS0FBSyxFQUFFLENBQUM7UUFDdEIsTUFBTSxJQUFJLEtBQUssQ0FBQywwQkFBMEIsQ0FBQyxDQUFDO0lBQzlDLENBQUM7SUFDRCxNQUFNLFdBQVcsR0FBRyxJQUFJLENBQUMsd0JBQXdCLENBQVUsVUFBVSxDQUFDLEtBQUssQ0FBQyxDQUFDO0lBQzdFLE1BQU0sZ0JBQWdCLEdBQUcsRUFBRSxDQUFDO0lBQzVCLE9BQU8sTUFBTSxPQUFPLENBQUMsR0FBRyxDQUN0QixXQUFXLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxLQUFLLEVBQUUsWUFBWSxFQUFxRSxFQUFFO1FBQzVHLE1BQU0sYUFBYSxHQUFJLE1BQU0sQ0FBQyxJQUFJLENBQUMsWUFBWSxDQUFDLElBQUksQ0FBQyxDQUFDLE9BQU8sRUFBYSxDQUFDLFFBQVEsQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUMzRixNQUFNLEtBQUssR0FBRyxVQUFVLENBQUMsTUFBTSxFQUFFLE9BQU8sRUFBRSxDQUFDLGFBQWEsQ0FBQyxDQUFDO1FBQzFELElBQUksS0FBSyxFQUFFLENBQUM7WUFDVixNQUFNLE9BQU8sR0FBRyxJQUFJLENBQUMsd0JBQXdCLENBQVUsS0FBSyxDQUFDLENBQUM7WUFDOUQsSUFBSSxPQUFPLENBQUMsS0FBSyxFQUFFLEtBQUssYUFBYSxFQUFFLENBQUM7Z0JBQ3RDLE1BQU0sSUFBSSxLQUFLLENBQUMseUNBQXlDLENBQUMsQ0FBQztZQUM3RCxDQUFDO1lBQ0QsTUFBTSxhQUFhLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxZQUFZLENBQUMsS0FBSyxDQUFDLENBQUM7WUFDdkQsTUFBTSxPQUFPLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQyxhQUFhLENBQUMsTUFBTSxFQUFFLElBQUksQ0FBQyxPQUFPLENBQUMsQ0FBQztZQUNyRixPQUFPO2dCQUNMLE9BQU87Z0JBQ1AsS0FBSyxFQUFFLGFBQWEsQ0FBQyxLQUFLO2dCQUMxQixXQUFXLEVBQUUsYUFBYSxDQUFDLEtBQUssQ0FBQyxRQUFRLEVBQUU7YUFDNUMsQ0FBQztRQUNKLENBQUM7YUFBTSxJQUFJLENBQUMsZ0JBQWdCLENBQUMsYUFBYSxDQUFDLEVBQUUsQ0FBQztZQUM1QyxJQUFJLGlCQUFpQixFQUFFLENBQUM7Z0JBQ3RCLE1BQU0sSUFBSSxLQUFLLENBQUMsZ0ZBQWdGLENBQUMsQ0FBQztZQUNwRyxDQUFDO1lBQ0QsSUFBSSxLQUFLLEVBQUUsQ0FBQztnQkFDVixLQUFLLENBQUMsZ0JBQWdCLENBQUMsS0FBSyxDQUFDLENBQUM7WUFDaEMsQ0FBQztZQUNELGdCQUFnQixDQUFDLGFBQWEsQ0FBQyxHQUFHLE1BQU0sS0FBSyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLGNBQWMsYUFBYSxFQUFFLENBQUMsQ0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDO1FBQ3RHLENBQUM7UUFDRCxNQUFNLGtCQUFrQixHQUFHLGdCQUFnQixDQUFDLGFBQWEsQ0FBQyxDQUFDO1FBQzNELE9BQU8sa0JBQWtCLENBQUMsT0FBTyxDQUFDLFlBQVksQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUN4RCxDQUFDLENBQUMsQ0FDSCxDQUFDO0FBQ0osQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCAqIGFzIHV0eG9saWIgZnJvbSAnQGJpdGdvLWJldGEvdXR4by1saWInO1xuaW1wb3J0IHsgQml0R29CYXNlLCBJUmVxdWVzdFRyYWNlciB9IGZyb20gJ0BiaXRnby1iZXRhL3Nkay1jb3JlJztcblxuaW1wb3J0IHsgQWJzdHJhY3RVdHhvQ29pbiwgVHJhbnNhY3Rpb25QcmVidWlsZCB9IGZyb20gJy4uL2Fic3RyYWN0VXR4b0NvaW4nO1xuXG4vKipcbiAqIEdldCB0aGUgaW5wdXRzIGZvciBhIHBzYnQgZnJvbSBhIHByZWJ1aWxkLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0UHNidFR4SW5wdXRzKFxuICBwc2J0QXJnOiBzdHJpbmcgfCB1dHhvbGliLmJpdGdvLlV0eG9Qc2J0LFxuICBuZXR3b3JrOiB1dHhvbGliLk5ldHdvcmtcbik6IHsgYWRkcmVzczogc3RyaW5nOyB2YWx1ZTogYmlnaW50OyB2YWx1ZVN0cmluZzogc3RyaW5nIH1bXSB7XG4gIGNvbnN0IHBzYnQgPSBwc2J0QXJnIGluc3RhbmNlb2YgdXR4b2xpYi5iaXRnby5VdHhvUHNidCA/IHBzYnRBcmcgOiB1dHhvbGliLmJpdGdvLmNyZWF0ZVBzYnRGcm9tSGV4KHBzYnRBcmcsIG5ldHdvcmspO1xuICBjb25zdCB0eElucHV0cyA9IHBzYnQudHhJbnB1dHM7XG4gIHJldHVybiBwc2J0LmRhdGEuaW5wdXRzLm1hcCgoaW5wdXQsIGluZGV4KSA9PiB7XG4gICAgbGV0IGFkZHJlc3M6IHN0cmluZztcbiAgICBsZXQgdmFsdWU6IGJpZ2ludDtcbiAgICBpZiAoaW5wdXQud2l0bmVzc1V0eG8pIHtcbiAgICAgIGFkZHJlc3MgPSB1dHhvbGliLmFkZHJlc3MuZnJvbU91dHB1dFNjcmlwdChpbnB1dC53aXRuZXNzVXR4by5zY3JpcHQsIG5ldHdvcmspO1xuICAgICAgdmFsdWUgPSBpbnB1dC53aXRuZXNzVXR4by52YWx1ZTtcbiAgICB9IGVsc2UgaWYgKGlucHV0Lm5vbldpdG5lc3NVdHhvKSB7XG4gICAgICBjb25zdCB0eCA9IHV0eG9saWIuYml0Z28uY3JlYXRlVHJhbnNhY3Rpb25Gcm9tQnVmZmVyPGJpZ2ludD4oaW5wdXQubm9uV2l0bmVzc1V0eG8sIG5ldHdvcmssIHtcbiAgICAgICAgYW1vdW50VHlwZTogJ2JpZ2ludCcsXG4gICAgICB9KTtcbiAgICAgIGNvbnN0IHR4SWQgPSAoQnVmZmVyLmZyb20odHhJbnB1dHNbaW5kZXhdLmhhc2gpLnJldmVyc2UoKSBhcyBCdWZmZXIpLnRvU3RyaW5nKCdoZXgnKTtcbiAgICAgIGlmICh0eC5nZXRJZCgpICE9PSB0eElkKSB7XG4gICAgICAgIHRocm93IG5ldyBFcnJvcignaW5wdXQgdHJhbnNhY3Rpb24gaGV4IGRvZXMgbm90IG1hdGNoIGlkJyk7XG4gICAgICB9XG4gICAgICBjb25zdCBwcmV2VHhPdXRwdXRJbmRleCA9IHR4SW5wdXRzW2luZGV4XS5pbmRleDtcbiAgICAgIGFkZHJlc3MgPSB1dHhvbGliLmFkZHJlc3MuZnJvbU91dHB1dFNjcmlwdCh0eC5vdXRzW3ByZXZUeE91dHB1dEluZGV4XS5zY3JpcHQsIG5ldHdvcmspO1xuICAgICAgdmFsdWUgPSB0eC5vdXRzW3ByZXZUeE91dHB1dEluZGV4XS52YWx1ZTtcbiAgICB9IGVsc2Uge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKCdwc2J0IGlucHV0IGlzIG1pc3NpbmcgYm90aCB3aXRuZXNzVXR4byBhbmQgbm9uV2l0bmVzc1V0eG8nKTtcbiAgICB9XG4gICAgcmV0dXJuIHsgYWRkcmVzcywgdmFsdWUsIHZhbHVlU3RyaW5nOiB2YWx1ZS50b1N0cmluZygpIH07XG4gIH0pO1xufVxuXG4vKipcbiAqIEdldCB0aGUgaW5wdXRzIGZvciBhIHRyYW5zYWN0aW9uIGZyb20gYSBwcmVidWlsZC5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGdldFR4SW5wdXRzPFROdW1iZXIgZXh0ZW5kcyBudW1iZXIgfCBiaWdpbnQ+KHBhcmFtczoge1xuICB0eFByZWJ1aWxkOiBUcmFuc2FjdGlvblByZWJ1aWxkPFROdW1iZXI+O1xuICBiaXRnbzogQml0R29CYXNlO1xuICBjb2luOiBBYnN0cmFjdFV0eG9Db2luO1xuICBkaXNhYmxlTmV0d29ya2luZzogYm9vbGVhbjtcbiAgcmVxSWQ/OiBJUmVxdWVzdFRyYWNlcjtcbn0pOiBQcm9taXNlPHsgYWRkcmVzczogc3RyaW5nOyB2YWx1ZTogVE51bWJlcjsgdmFsdWVTdHJpbmc6IHN0cmluZyB9W10+IHtcbiAgY29uc3QgeyB0eFByZWJ1aWxkLCBiaXRnbywgY29pbiwgZGlzYWJsZU5ldHdvcmtpbmcsIHJlcUlkIH0gPSBwYXJhbXM7XG4gIGlmICghdHhQcmVidWlsZC50eEhleCkge1xuICAgIHRocm93IG5ldyBFcnJvcihgdHhQcmVidWlsZC50eEhleCBub3Qgc2V0YCk7XG4gIH1cbiAgY29uc3QgdHJhbnNhY3Rpb24gPSBjb2luLmNyZWF0ZVRyYW5zYWN0aW9uRnJvbUhleDxUTnVtYmVyPih0eFByZWJ1aWxkLnR4SGV4KTtcbiAgY29uc3QgdHJhbnNhY3Rpb25DYWNoZSA9IHt9O1xuICByZXR1cm4gYXdhaXQgUHJvbWlzZS5hbGwoXG4gICAgdHJhbnNhY3Rpb24uaW5zLm1hcChhc3luYyAoY3VycmVudElucHV0KTogUHJvbWlzZTx7IGFkZHJlc3M6IHN0cmluZzsgdmFsdWU6IFROdW1iZXI7IHZhbHVlU3RyaW5nOiBzdHJpbmcgfT4gPT4ge1xuICAgICAgY29uc3QgdHJhbnNhY3Rpb25JZCA9IChCdWZmZXIuZnJvbShjdXJyZW50SW5wdXQuaGFzaCkucmV2ZXJzZSgpIGFzIEJ1ZmZlcikudG9TdHJpbmcoJ2hleCcpO1xuICAgICAgY29uc3QgdHhIZXggPSB0eFByZWJ1aWxkLnR4SW5mbz8udHhIZXhlcz8uW3RyYW5zYWN0aW9uSWRdO1xuICAgICAgaWYgKHR4SGV4KSB7XG4gICAgICAgIGNvbnN0IGxvY2FsVHggPSBjb2luLmNyZWF0ZVRyYW5zYWN0aW9uRnJvbUhleDxUTnVtYmVyPih0eEhleCk7XG4gICAgICAgIGlmIChsb2NhbFR4LmdldElkKCkgIT09IHRyYW5zYWN0aW9uSWQpIHtcbiAgICAgICAgICB0aHJvdyBuZXcgRXJyb3IoJ2lucHV0IHRyYW5zYWN0aW9uIGhleCBkb2VzIG5vdCBtYXRjaCBpZCcpO1xuICAgICAgICB9XG4gICAgICAgIGNvbnN0IGN1cnJlbnRPdXRwdXQgPSBsb2NhbFR4Lm91dHNbY3VycmVudElucHV0LmluZGV4XTtcbiAgICAgICAgY29uc3QgYWRkcmVzcyA9IHV0eG9saWIuYWRkcmVzcy5mcm9tT3V0cHV0U2NyaXB0KGN1cnJlbnRPdXRwdXQuc2NyaXB0LCBjb2luLm5ldHdvcmspO1xuICAgICAgICByZXR1cm4ge1xuICAgICAgICAgIGFkZHJlc3MsXG4gICAgICAgICAgdmFsdWU6IGN1cnJlbnRPdXRwdXQudmFsdWUsXG4gICAgICAgICAgdmFsdWVTdHJpbmc6IGN1cnJlbnRPdXRwdXQudmFsdWUudG9TdHJpbmcoKSxcbiAgICAgICAgfTtcbiAgICAgIH0gZWxzZSBpZiAoIXRyYW5zYWN0aW9uQ2FjaGVbdHJhbnNhY3Rpb25JZF0pIHtcbiAgICAgICAgaWYgKGRpc2FibGVOZXR3b3JraW5nKSB7XG4gICAgICAgICAgdGhyb3cgbmV3IEVycm9yKCdhdHRlbXB0aW5nIHRvIHJldHJpZXZlIHRyYW5zYWN0aW9uIGRldGFpbHMgZXh0ZXJuYWxseSB3aXRoIG5ldHdvcmtpbmcgZGlzYWJsZWQnKTtcbiAgICAgICAgfVxuICAgICAgICBpZiAocmVxSWQpIHtcbiAgICAgICAgICBiaXRnby5zZXRSZXF1ZXN0VHJhY2VyKHJlcUlkKTtcbiAgICAgICAgfVxuICAgICAgICB0cmFuc2FjdGlvbkNhY2hlW3RyYW5zYWN0aW9uSWRdID0gYXdhaXQgYml0Z28uZ2V0KGNvaW4udXJsKGAvcHVibGljL3R4LyR7dHJhbnNhY3Rpb25JZH1gKSkucmVzdWx0KCk7XG4gICAgICB9XG4gICAgICBjb25zdCB0cmFuc2FjdGlvbkRldGFpbHMgPSB0cmFuc2FjdGlvbkNhY2hlW3RyYW5zYWN0aW9uSWRdO1xuICAgICAgcmV0dXJuIHRyYW5zYWN0aW9uRGV0YWlscy5vdXRwdXRzW2N1cnJlbnRJbnB1dC5pbmRleF07XG4gICAgfSlcbiAgKTtcbn1cbiJdfQ==

package/dist/esm/transaction/fixedScript/SigningError.d.ts

@@ -0,0 +1,24 @@
+import * as utxolib from '@bitgo-beta/utxo-lib';
+import type { PsbtParsedScriptType } from './signPsbt';
+type Unspent<TNumber extends number | bigint = number> = utxolib.bitgo.Unspent<TNumber>;
+export declare class InputSigningError<TNumber extends number | bigint = number> extends Error {
+    inputIndex: number;
+    inputType: PsbtParsedScriptType | null;
+    unspent: Unspent<TNumber> | {
+        id: string;
+    };
+    reason: Error | string;
+    static expectedWalletUnspent<TNumber extends number | bigint>(inputIndex: number, inputType: PsbtParsedScriptType | null, // null for legacy transaction format
+    unspent: Unspent<TNumber> | {
+        id: string;
+    }): InputSigningError<TNumber>;
+    constructor(inputIndex: number, inputType: PsbtParsedScriptType | null, // null for legacy transaction format
+    unspent: Unspent<TNumber> | {
+        id: string;
+    }, reason: Error | string);
+}
+export declare class TransactionSigningError<TNumber extends number | bigint = number> extends Error {
+    constructor(signErrors: InputSigningError<TNumber>[], verifyError: InputSigningError<TNumber>[]);
+}
+export {};
+//# sourceMappingURL=SigningError.d.ts.map

package/dist/esm/transaction/fixedScript/SigningError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SigningError.d.ts","sourceRoot":"","sources":["../../../../src/transaction/fixedScript/SigningError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAEhD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,KAAK,OAAO,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAExF,qBAAa,iBAAiB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;IAe3E,UAAU,EAAE,MAAM;IAClB,SAAS,EAAE,oBAAoB,GAAG,IAAI;IACtC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE;IAC1C,MAAM,EAAE,KAAK,GAAG,MAAM;IAjB/B,MAAM,CAAC,qBAAqB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAC1D,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,oBAAoB,GAAG,IAAI,EAAE,qCAAqC;IAC7E,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GACzC,iBAAiB,CAAC,OAAO,CAAC;gBAUpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,oBAAoB,GAAG,IAAI,EAAE,qCAAqC;IAC7E,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAC1C,MAAM,EAAE,KAAK,GAAG,MAAM;CAIhC;AAED,qBAAa,uBAAuB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;gBAC9E,UAAU,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE;CAMhG"}

package/dist/esm/transaction/fixedScript/SigningError.js

@@ -0,0 +1,21 @@
+export class InputSigningError extends Error {
+    static expectedWalletUnspent(inputIndex, inputType, // null for legacy transaction format
+    unspent) {
+        return new InputSigningError(inputIndex, inputType, unspent, `not a wallet unspent, not a replay protection unspent`);
+    }
+    constructor(inputIndex, inputType, // null for legacy transaction format
+    unspent, reason) {
+        super(`signing error at input ${inputIndex}: type=${inputType} unspentId=${unspent.id}: ${reason}`);
+        this.inputIndex = inputIndex;
+        this.inputType = inputType;
+        this.unspent = unspent;
+        this.reason = reason;
+    }
+}
+export class TransactionSigningError extends Error {
+    constructor(signErrors, verifyError) {
+        super(`sign errors at inputs: [${signErrors.join(',')}], ` +
+            `verify errors at inputs: [${verifyError.join(',')}], see log for details`);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiU2lnbmluZ0Vycm9yLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3RyYW5zYWN0aW9uL2ZpeGVkU2NyaXB0L1NpZ25pbmdFcnJvci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFNQSxNQUFNLE9BQU8saUJBQTRELFNBQVEsS0FBSztJQUNwRixNQUFNLENBQUMscUJBQXFCLENBQzFCLFVBQWtCLEVBQ2xCLFNBQXNDLEVBQUUscUNBQXFDO0lBQzdFLE9BQTBDO1FBRTFDLE9BQU8sSUFBSSxpQkFBaUIsQ0FDMUIsVUFBVSxFQUNWLFNBQVMsRUFDVCxPQUFPLEVBQ1AsdURBQXVELENBQ3hELENBQUM7SUFDSixDQUFDO0lBRUQsWUFDUyxVQUFrQixFQUNsQixTQUFzQyxFQUFFLHFDQUFxQztJQUM3RSxPQUEwQyxFQUMxQyxNQUFzQjtRQUU3QixLQUFLLENBQUMsMEJBQTBCLFVBQVUsVUFBVSxTQUFTLGNBQWMsT0FBTyxDQUFDLEVBQUUsS0FBSyxNQUFNLEVBQUUsQ0FBQyxDQUFDO1FBTDdGLGVBQVUsR0FBVixVQUFVLENBQVE7UUFDbEIsY0FBUyxHQUFULFNBQVMsQ0FBNkI7UUFDdEMsWUFBTyxHQUFQLE9BQU8sQ0FBbUM7UUFDMUMsV0FBTSxHQUFOLE1BQU0sQ0FBZ0I7SUFHL0IsQ0FBQztDQUNGO0FBRUQsTUFBTSxPQUFPLHVCQUFrRSxTQUFRLEtBQUs7SUFDMUYsWUFBWSxVQUF3QyxFQUFFLFdBQXlDO1FBQzdGLEtBQUssQ0FDSCwyQkFBMkIsVUFBVSxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsS0FBSztZQUNsRCw2QkFBNkIsV0FBVyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsd0JBQXdCLENBQzdFLENBQUM7SUFDSixDQUFDO0NBQ0YiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgKiBhcyB1dHhvbGliIGZyb20gJ0BiaXRnby1iZXRhL3V0eG8tbGliJztcblxuaW1wb3J0IHR5cGUgeyBQc2J0UGFyc2VkU2NyaXB0VHlwZSB9IGZyb20gJy4vc2lnblBzYnQnO1xuXG50eXBlIFVuc3BlbnQ8VE51bWJlciBleHRlbmRzIG51bWJlciB8IGJpZ2ludCA9IG51bWJlcj4gPSB1dHhvbGliLmJpdGdvLlVuc3BlbnQ8VE51bWJlcj47XG5cbmV4cG9ydCBjbGFzcyBJbnB1dFNpZ25pbmdFcnJvcjxUTnVtYmVyIGV4dGVuZHMgbnVtYmVyIHwgYmlnaW50ID0gbnVtYmVyPiBleHRlbmRzIEVycm9yIHtcbiAgc3RhdGljIGV4cGVjdGVkV2FsbGV0VW5zcGVudDxUTnVtYmVyIGV4dGVuZHMgbnVtYmVyIHwgYmlnaW50PihcbiAgICBpbnB1dEluZGV4OiBudW1iZXIsXG4gICAgaW5wdXRUeXBlOiBQc2J0UGFyc2VkU2NyaXB0VHlwZSB8IG51bGwsIC8vIG51bGwgZm9yIGxlZ2FjeSB0cmFuc2FjdGlvbiBmb3JtYXRcbiAgICB1bnNwZW50OiBVbnNwZW50PFROdW1iZXI+IHwgeyBpZDogc3RyaW5nIH1cbiAgKTogSW5wdXRTaWduaW5nRXJyb3I8VE51bWJlcj4ge1xuICAgIHJldHVybiBuZXcgSW5wdXRTaWduaW5nRXJyb3IoXG4gICAgICBpbnB1dEluZGV4LFxuICAgICAgaW5wdXRUeXBlLFxuICAgICAgdW5zcGVudCxcbiAgICAgIGBub3QgYSB3YWxsZXQgdW5zcGVudCwgbm90IGEgcmVwbGF5IHByb3RlY3Rpb24gdW5zcGVudGBcbiAgICApO1xuICB9XG5cbiAgY29uc3RydWN0b3IoXG4gICAgcHVibGljIGlucHV0SW5kZXg6IG51bWJlcixcbiAgICBwdWJsaWMgaW5wdXRUeXBlOiBQc2J0UGFyc2VkU2NyaXB0VHlwZSB8IG51bGwsIC8vIG51bGwgZm9yIGxlZ2FjeSB0cmFuc2FjdGlvbiBmb3JtYXRcbiAgICBwdWJsaWMgdW5zcGVudDogVW5zcGVudDxUTnVtYmVyPiB8IHsgaWQ6IHN0cmluZyB9LFxuICAgIHB1YmxpYyByZWFzb246IEVycm9yIHwgc3RyaW5nXG4gICkge1xuICAgIHN1cGVyKGBzaWduaW5nIGVycm9yIGF0IGlucHV0ICR7aW5wdXRJbmRleH06IHR5cGU9JHtpbnB1dFR5cGV9IHVuc3BlbnRJZD0ke3Vuc3BlbnQuaWR9OiAke3JlYXNvbn1gKTtcbiAgfVxufVxuXG5leHBvcnQgY2xhc3MgVHJhbnNhY3Rpb25TaWduaW5nRXJyb3I8VE51bWJlciBleHRlbmRzIG51bWJlciB8IGJpZ2ludCA9IG51bWJlcj4gZXh0ZW5kcyBFcnJvciB7XG4gIGNvbnN0cnVjdG9yKHNpZ25FcnJvcnM6IElucHV0U2lnbmluZ0Vycm9yPFROdW1iZXI+W10sIHZlcmlmeUVycm9yOiBJbnB1dFNpZ25pbmdFcnJvcjxUTnVtYmVyPltdKSB7XG4gICAgc3VwZXIoXG4gICAgICBgc2lnbiBlcnJvcnMgYXQgaW5wdXRzOiBbJHtzaWduRXJyb3JzLmpvaW4oJywnKX1dLCBgICtcbiAgICAgICAgYHZlcmlmeSBlcnJvcnMgYXQgaW5wdXRzOiBbJHt2ZXJpZnlFcnJvci5qb2luKCcsJyl9XSwgc2VlIGxvZyBmb3IgZGV0YWlsc2BcbiAgICApO1xuICB9XG59XG4iXX0=

package/dist/esm/transaction/fixedScript/explainPsbtWasm.d.ts

@@ -0,0 +1,11 @@
+import { fixedScriptWallet } from '@bitgo/wasm-utxo';
+import { Triple } from '@bitgo-beta/sdk-core';
+import type { TransactionExplanationWasm } from './explainTransaction';
+export declare function explainPsbtWasm(psbt: fixedScriptWallet.BitGoPsbt, walletXpubs: Triple<string>, params: {
+    replayProtection: {
+        checkSignature?: boolean;
+        publicKeys: Buffer[];
+    };
+    customChangeWalletXpubs?: Triple<string>;
+}): TransactionExplanationWasm;
+//# sourceMappingURL=explainPsbtWasm.d.ts.map

package/dist/esm/transaction/fixedScript/explainPsbtWasm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainPsbtWasm.d.ts","sourceRoot":"","sources":["../../../../src/transaction/fixedScript/explainPsbtWasm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAI9C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAmCvE,wBAAgB,eAAe,CAC7B,IAAI,EAAE,iBAAiB,CAAC,SAAS,EACjC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,EAC3B,MAAM,EAAE;IACN,gBAAgB,EAAE;QAChB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF,uBAAuB,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;CAC1C,GACA,0BAA0B,CAuC5B"}

package/dist/esm/transaction/fixedScript/explainPsbtWasm.js

@@ -0,0 +1,64 @@
+function scriptToAddress(script) {
+    return `scriptPubKey:${Buffer.from(script).toString('hex')}`;
+}
+function isParsedWalletOutput(output) {
+    return output.scriptId !== null;
+}
+function isParsedExternalOutput(output) {
+    return output.scriptId === null;
+}
+function toChangeOutput(output) {
+    return {
+        address: output.address ?? scriptToAddress(output.script),
+        amount: output.value.toString(),
+        chain: output.scriptId.chain,
+        index: output.scriptId.index,
+        external: false,
+    };
+}
+function toExternalOutput(output) {
+    return {
+        address: output.address ?? scriptToAddress(output.script),
+        amount: output.value.toString(),
+        external: true,
+    };
+}
+export function explainPsbtWasm(psbt, walletXpubs, params) {
+    const parsed = psbt.parseTransactionWithWalletKeys(walletXpubs, params.replayProtection);
+    const changeOutputs = [];
+    const outputs = [];
+    const parsedCustomChangeOutputs = params.customChangeWalletXpubs
+        ? psbt.parseOutputsWithWalletKeys(params.customChangeWalletXpubs)
+        : undefined;
+    const customChangeOutputs = [];
+    parsed.outputs.forEach((output, i) => {
+        const parseCustomChangeOutput = parsedCustomChangeOutputs?.[i];
+        if (isParsedWalletOutput(output)) {
+            // This is a change output
+            changeOutputs.push(toChangeOutput(output));
+        }
+        else if (parseCustomChangeOutput && isParsedWalletOutput(parseCustomChangeOutput)) {
+            customChangeOutputs.push(toChangeOutput(parseCustomChangeOutput));
+        }
+        else if (isParsedExternalOutput(output)) {
+            outputs.push(toExternalOutput(output));
+        }
+        else {
+            throw new Error('Invalid output');
+        }
+    });
+    const outputAmount = outputs.reduce((sum, output) => sum + BigInt(output.amount), BigInt(0));
+    const changeAmount = changeOutputs.reduce((sum, output) => sum + BigInt(output.amount), BigInt(0));
+    const customChangeAmount = customChangeOutputs.reduce((sum, output) => sum + BigInt(output.amount), BigInt(0));
+    return {
+        id: psbt.unsignedTxid(),
+        outputAmount: outputAmount.toString(),
+        changeAmount: changeAmount.toString(),
+        customChangeAmount: customChangeAmount.toString(),
+        outputs,
+        changeOutputs,
+        customChangeOutputs,
+        fee: parsed.minerFee.toString(),
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXhwbGFpblBzYnRXYXNtLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3RyYW5zYWN0aW9uL2ZpeGVkU2NyaXB0L2V4cGxhaW5Qc2J0V2FzbS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFPQSxTQUFTLGVBQWUsQ0FBQyxNQUFrQjtJQUN6QyxPQUFPLGdCQUFnQixNQUFNLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxDQUFDLFFBQVEsQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDO0FBQy9ELENBQUM7QUFLRCxTQUFTLG9CQUFvQixDQUFDLE1BQWlEO0lBQzdFLE9BQU8sTUFBTSxDQUFDLFFBQVEsS0FBSyxJQUFJLENBQUM7QUFDbEMsQ0FBQztBQUVELFNBQVMsc0JBQXNCLENBQUMsTUFBaUQ7SUFDL0UsT0FBTyxNQUFNLENBQUMsUUFBUSxLQUFLLElBQUksQ0FBQztBQUNsQyxDQUFDO0FBRUQsU0FBUyxjQUFjLENBQUMsTUFBMEI7SUFDaEQsT0FBTztRQUNMLE9BQU8sRUFBRSxNQUFNLENBQUMsT0FBTyxJQUFJLGVBQWUsQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDO1FBQ3pELE1BQU0sRUFBRSxNQUFNLENBQUMsS0FBSyxDQUFDLFFBQVEsRUFBRTtRQUMvQixLQUFLLEVBQUUsTUFBTSxDQUFDLFFBQVEsQ0FBQyxLQUFLO1FBQzVCLEtBQUssRUFBRSxNQUFNLENBQUMsUUFBUSxDQUFDLEtBQUs7UUFDNUIsUUFBUSxFQUFFLEtBQUs7S0FDaEIsQ0FBQztBQUNKLENBQUM7QUFFRCxTQUFTLGdCQUFnQixDQUFDLE1BQTRCO0lBQ3BELE9BQU87UUFDTCxPQUFPLEVBQUUsTUFBTSxDQUFDLE9BQU8sSUFBSSxlQUFlLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQztRQUN6RCxNQUFNLEVBQUUsTUFBTSxDQUFDLEtBQUssQ0FBQyxRQUFRLEVBQUU7UUFDL0IsUUFBUSxFQUFFLElBQUk7S0FDZixDQUFDO0FBQ0osQ0FBQztBQUVELE1BQU0sVUFBVSxlQUFlLENBQzdCLElBQWlDLEVBQ2pDLFdBQTJCLEVBQzNCLE1BTUM7SUFFRCxNQUFNLE1BQU0sR0FBRyxJQUFJLENBQUMsOEJBQThCLENBQUMsV0FBVyxFQUFFLE1BQU0sQ0FBQyxnQkFBZ0IsQ0FBQyxDQUFDO0lBRXpGLE1BQU0sYUFBYSxHQUE4QixFQUFFLENBQUM7SUFDcEQsTUFBTSxPQUFPLEdBQWEsRUFBRSxDQUFDO0lBQzdCLE1BQU0seUJBQXlCLEdBQUcsTUFBTSxDQUFDLHVCQUF1QjtRQUM5RCxDQUFDLENBQUMsSUFBSSxDQUFDLDBCQUEwQixDQUFDLE1BQU0sQ0FBQyx1QkFBdUIsQ0FBQztRQUNqRSxDQUFDLENBQUMsU0FBUyxDQUFDO0lBRWQsTUFBTSxtQkFBbUIsR0FBOEIsRUFBRSxDQUFDO0lBRTFELE1BQU0sQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsRUFBRSxFQUFFO1FBQ25DLE1BQU0sdUJBQXVCLEdBQUcseUJBQXlCLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQztRQUMvRCxJQUFJLG9CQUFvQixDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7WUFDakMsMEJBQTBCO1lBQzFCLGFBQWEsQ0FBQyxJQUFJLENBQUMsY0FBYyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUM7UUFDN0MsQ0FBQzthQUFNLElBQUksdUJBQXVCLElBQUksb0JBQW9CLENBQUMsdUJBQXVCLENBQUMsRUFBRSxDQUFDO1lBQ3BGLG1CQUFtQixDQUFDLElBQUksQ0FBQyxjQUFjLENBQUMsdUJBQXVCLENBQUMsQ0FBQyxDQUFDO1FBQ3BFLENBQUM7YUFBTSxJQUFJLHNCQUFzQixDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7WUFDMUMsT0FBTyxDQUFDLElBQUksQ0FBQyxnQkFBZ0IsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDO1FBQ3pDLENBQUM7YUFBTSxDQUFDO1lBQ04sTUFBTSxJQUFJLEtBQUssQ0FBQyxnQkFBZ0IsQ0FBQyxDQUFDO1FBQ3BDLENBQUM7SUFDSCxDQUFDLENBQUMsQ0FBQztJQUVILE1BQU0sWUFBWSxHQUFHLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FBQyxHQUFHLEVBQUUsTUFBTSxFQUFFLEVBQUUsQ0FBQyxHQUFHLEdBQUcsTUFBTSxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsRUFBRSxNQUFNLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUM3RixNQUFNLFlBQVksR0FBRyxhQUFhLENBQUMsTUFBTSxDQUFDLENBQUMsR0FBRyxFQUFFLE1BQU0sRUFBRSxFQUFFLENBQUMsR0FBRyxHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsTUFBTSxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDbkcsTUFBTSxrQkFBa0IsR0FBRyxtQkFBbUIsQ0FBQyxNQUFNLENBQUMsQ0FBQyxHQUFHLEVBQUUsTUFBTSxFQUFFLEVBQUUsQ0FBQyxHQUFHLEdBQUcsTUFBTSxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsRUFBRSxNQUFNLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUUvRyxPQUFPO1FBQ0wsRUFBRSxFQUFFLElBQUksQ0FBQyxZQUFZLEVBQUU7UUFDdkIsWUFBWSxFQUFFLFlBQVksQ0FBQyxRQUFRLEVBQUU7UUFDckMsWUFBWSxFQUFFLFlBQVksQ0FBQyxRQUFRLEVBQUU7UUFDckMsa0JBQWtCLEVBQUUsa0JBQWtCLENBQUMsUUFBUSxFQUFFO1FBQ2pELE9BQU87UUFDUCxhQUFhO1FBQ2IsbUJBQW1CO1FBQ25CLEdBQUcsRUFBRSxNQUFNLENBQUMsUUFBUSxDQUFDLFFBQVEsRUFBRTtLQUNoQyxDQUFDO0FBQ0osQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IGZpeGVkU2NyaXB0V2FsbGV0IH0gZnJvbSAnQGJpdGdvL3dhc20tdXR4byc7XG5pbXBvcnQgeyBUcmlwbGUgfSBmcm9tICdAYml0Z28tYmV0YS9zZGstY29yZSc7XG5cbmltcG9ydCB0eXBlIHsgRml4ZWRTY3JpcHRXYWxsZXRPdXRwdXQsIE91dHB1dCB9IGZyb20gJy4uL3R5cGVzJztcblxuaW1wb3J0IHR5cGUgeyBUcmFuc2FjdGlvbkV4cGxhbmF0aW9uV2FzbSB9IGZyb20gJy4vZXhwbGFpblRyYW5zYWN0aW9uJztcblxuZnVuY3Rpb24gc2NyaXB0VG9BZGRyZXNzKHNjcmlwdDogVWludDhBcnJheSk6IHN0cmluZyB7XG4gIHJldHVybiBgc2NyaXB0UHViS2V5OiR7QnVmZmVyLmZyb20oc2NyaXB0KS50b1N0cmluZygnaGV4Jyl9YDtcbn1cblxudHlwZSBQYXJzZWRXYWxsZXRPdXRwdXQgPSBmaXhlZFNjcmlwdFdhbGxldC5QYXJzZWRPdXRwdXQgJiB7IHNjcmlwdElkOiBmaXhlZFNjcmlwdFdhbGxldC5TY3JpcHRJZCB9O1xudHlwZSBQYXJzZWRFeHRlcm5hbE91dHB1dCA9IGZpeGVkU2NyaXB0V2FsbGV0LlBhcnNlZE91dHB1dCAmIHsgc2NyaXB0SWQ6IG51bGwgfTtcblxuZnVuY3Rpb24gaXNQYXJzZWRXYWxsZXRPdXRwdXQob3V0cHV0OiBQYXJzZWRXYWxsZXRPdXRwdXQgfCBQYXJzZWRFeHRlcm5hbE91dHB1dCk6IG91dHB1dCBpcyBQYXJzZWRXYWxsZXRPdXRwdXQge1xuICByZXR1cm4gb3V0cHV0LnNjcmlwdElkICE9PSBudWxsO1xufVxuXG5mdW5jdGlvbiBpc1BhcnNlZEV4dGVybmFsT3V0cHV0KG91dHB1dDogUGFyc2VkV2FsbGV0T3V0cHV0IHwgUGFyc2VkRXh0ZXJuYWxPdXRwdXQpOiBvdXRwdXQgaXMgUGFyc2VkRXh0ZXJuYWxPdXRwdXQge1xuICByZXR1cm4gb3V0cHV0LnNjcmlwdElkID09PSBudWxsO1xufVxuXG5mdW5jdGlvbiB0b0NoYW5nZU91dHB1dChvdXRwdXQ6IFBhcnNlZFdhbGxldE91dHB1dCk6IEZpeGVkU2NyaXB0V2FsbGV0T3V0cHV0IHtcbiAgcmV0dXJuIHtcbiAgICBhZGRyZXNzOiBvdXRwdXQuYWRkcmVzcyA/PyBzY3JpcHRUb0FkZHJlc3Mob3V0cHV0LnNjcmlwdCksXG4gICAgYW1vdW50OiBvdXRwdXQudmFsdWUudG9TdHJpbmcoKSxcbiAgICBjaGFpbjogb3V0cHV0LnNjcmlwdElkLmNoYWluLFxuICAgIGluZGV4OiBvdXRwdXQuc2NyaXB0SWQuaW5kZXgsXG4gICAgZXh0ZXJuYWw6IGZhbHNlLFxuICB9O1xufVxuXG5mdW5jdGlvbiB0b0V4dGVybmFsT3V0cHV0KG91dHB1dDogUGFyc2VkRXh0ZXJuYWxPdXRwdXQpOiBPdXRwdXQge1xuICByZXR1cm4ge1xuICAgIGFkZHJlc3M6IG91dHB1dC5hZGRyZXNzID8/IHNjcmlwdFRvQWRkcmVzcyhvdXRwdXQuc2NyaXB0KSxcbiAgICBhbW91bnQ6IG91dHB1dC52YWx1ZS50b1N0cmluZygpLFxuICAgIGV4dGVybmFsOiB0cnVlLFxuICB9O1xufVxuXG5leHBvcnQgZnVuY3Rpb24gZXhwbGFpblBzYnRXYXNtKFxuICBwc2J0OiBmaXhlZFNjcmlwdFdhbGxldC5CaXRHb1BzYnQsXG4gIHdhbGxldFhwdWJzOiBUcmlwbGU8c3RyaW5nPixcbiAgcGFyYW1zOiB7XG4gICAgcmVwbGF5UHJvdGVjdGlvbjoge1xuICAgICAgY2hlY2tTaWduYXR1cmU/OiBib29sZWFuO1xuICAgICAgcHVibGljS2V5czogQnVmZmVyW107XG4gICAgfTtcbiAgICBjdXN0b21DaGFuZ2VXYWxsZXRYcHVicz86IFRyaXBsZTxzdHJpbmc+O1xuICB9XG4pOiBUcmFuc2FjdGlvbkV4cGxhbmF0aW9uV2FzbSB7XG4gIGNvbnN0IHBhcnNlZCA9IHBzYnQucGFyc2VUcmFuc2FjdGlvbldpdGhXYWxsZXRLZXlzKHdhbGxldFhwdWJzLCBwYXJhbXMucmVwbGF5UHJvdGVjdGlvbik7XG5cbiAgY29uc3QgY2hhbmdlT3V0cHV0czogRml4ZWRTY3JpcHRXYWxsZXRPdXRwdXRbXSA9IFtdO1xuICBjb25zdCBvdXRwdXRzOiBPdXRwdXRbXSA9IFtdO1xuICBjb25zdCBwYXJzZWRDdXN0b21DaGFuZ2VPdXRwdXRzID0gcGFyYW1zLmN1c3RvbUNoYW5nZVdhbGxldFhwdWJzXG4gICAgPyBwc2J0LnBhcnNlT3V0cHV0c1dpdGhXYWxsZXRLZXlzKHBhcmFtcy5jdXN0b21DaGFuZ2VXYWxsZXRYcHVicylcbiAgICA6IHVuZGVmaW5lZDtcblxuICBjb25zdCBjdXN0b21DaGFuZ2VPdXRwdXRzOiBGaXhlZFNjcmlwdFdhbGxldE91dHB1dFtdID0gW107XG5cbiAgcGFyc2VkLm91dHB1dHMuZm9yRWFjaCgob3V0cHV0LCBpKSA9PiB7XG4gICAgY29uc3QgcGFyc2VDdXN0b21DaGFuZ2VPdXRwdXQgPSBwYXJzZWRDdXN0b21DaGFuZ2VPdXRwdXRzPy5baV07XG4gICAgaWYgKGlzUGFyc2VkV2FsbGV0T3V0cHV0KG91dHB1dCkpIHtcbiAgICAgIC8vIFRoaXMgaXMgYSBjaGFuZ2Ugb3V0cHV0XG4gICAgICBjaGFuZ2VPdXRwdXRzLnB1c2godG9DaGFuZ2VPdXRwdXQob3V0cHV0KSk7XG4gICAgfSBlbHNlIGlmIChwYXJzZUN1c3RvbUNoYW5nZU91dHB1dCAmJiBpc1BhcnNlZFdhbGxldE91dHB1dChwYXJzZUN1c3RvbUNoYW5nZU91dHB1dCkpIHtcbiAgICAgIGN1c3RvbUNoYW5nZU91dHB1dHMucHVzaCh0b0NoYW5nZU91dHB1dChwYXJzZUN1c3RvbUNoYW5nZU91dHB1dCkpO1xuICAgIH0gZWxzZSBpZiAoaXNQYXJzZWRFeHRlcm5hbE91dHB1dChvdXRwdXQpKSB7XG4gICAgICBvdXRwdXRzLnB1c2godG9FeHRlcm5hbE91dHB1dChvdXRwdXQpKTtcbiAgICB9IGVsc2Uge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKCdJbnZhbGlkIG91dHB1dCcpO1xuICAgIH1cbiAgfSk7XG5cbiAgY29uc3Qgb3V0cHV0QW1vdW50ID0gb3V0cHV0cy5yZWR1Y2UoKHN1bSwgb3V0cHV0KSA9PiBzdW0gKyBCaWdJbnQob3V0cHV0LmFtb3VudCksIEJpZ0ludCgwKSk7XG4gIGNvbnN0IGNoYW5nZUFtb3VudCA9IGNoYW5nZU91dHB1dHMucmVkdWNlKChzdW0sIG91dHB1dCkgPT4gc3VtICsgQmlnSW50KG91dHB1dC5hbW91bnQpLCBCaWdJbnQoMCkpO1xuICBjb25zdCBjdXN0b21DaGFuZ2VBbW91bnQgPSBjdXN0b21DaGFuZ2VPdXRwdXRzLnJlZHVjZSgoc3VtLCBvdXRwdXQpID0+IHN1bSArIEJpZ0ludChvdXRwdXQuYW1vdW50KSwgQmlnSW50KDApKTtcblxuICByZXR1cm4ge1xuICAgIGlkOiBwc2J0LnVuc2lnbmVkVHhpZCgpLFxuICAgIG91dHB1dEFtb3VudDogb3V0cHV0QW1vdW50LnRvU3RyaW5nKCksXG4gICAgY2hhbmdlQW1vdW50OiBjaGFuZ2VBbW91bnQudG9TdHJpbmcoKSxcbiAgICBjdXN0b21DaGFuZ2VBbW91bnQ6IGN1c3RvbUNoYW5nZUFtb3VudC50b1N0cmluZygpLFxuICAgIG91dHB1dHMsXG4gICAgY2hhbmdlT3V0cHV0cyxcbiAgICBjdXN0b21DaGFuZ2VPdXRwdXRzLFxuICAgIGZlZTogcGFyc2VkLm1pbmVyRmVlLnRvU3RyaW5nKCksXG4gIH07XG59XG4iXX0=

package/dist/esm/transaction/fixedScript/explainTransaction.d.ts

@@ -0,0 +1,73 @@
+import * as utxolib from '@bitgo-beta/utxo-lib';
+import { bitgo } from '@bitgo-beta/utxo-lib';
+import { ITransactionExplanation as BaseTransactionExplanation } from '@bitgo-beta/sdk-core';
+import type { Bip322Message } from '../../abstractUtxoCoin';
+import type { Output, FixedScriptWalletOutput } from '../types';
+export interface AbstractUtxoTransactionExplanation<TFee = string, TChangeOutput extends Output = Output> extends BaseTransactionExplanation<TFee, string> {
+    /** NOTE: this actually only captures external outputs */
+    outputs: Output[];
+    changeOutputs: TChangeOutput[];
+    customChangeOutputs?: TChangeOutput[];
+    customChangeAmount?: string;
+    /**
+     * BIP322 messages extracted from the transaction inputs.
+     * These messages are used for verifying the transaction against the BIP322 standard.
+     */
+    messages?: Bip322Message[];
+}
+/** @deprecated - the signature fields are not very useful */
+interface TransactionExplanationWithSignatures<TFee = string, TChangeOutput extends Output = Output> extends AbstractUtxoTransactionExplanation<TFee, TChangeOutput> {
+    /** @deprecated - unused outside of tests */
+    locktime?: number;
+    /**
+     * Number of input signatures per input.
+     * @deprecated - this is not very useful without knowing who signed each input.
+     */
+    inputSignatures: number[];
+    /**
+     * Highest input signature count for the transaction
+     * @deprecated - this is not very useful without knowing who signed each input.
+     */
+    signatures: number;
+}
+/** For our wasm backend, we do not return the deprecated fields. We set TFee to string for backwards compatibility. */
+export type TransactionExplanationWasm = AbstractUtxoTransactionExplanation<string, FixedScriptWalletOutput>;
+/** When parsing the legacy transaction format, we cannot always infer the fee so we set it to string | undefined */
+export type TransactionExplanationUtxolibLegacy = TransactionExplanationWithSignatures<string | undefined>;
+/** When parsing a PSBT, we can infer the fee so we set TFee to string. */
+export type TransactionExplanationUtxolibPsbt = TransactionExplanationWithSignatures<string>;
+export type TransactionExplanationDescriptor = TransactionExplanationWithSignatures<string, Output>;
+export type TransactionExplanation = TransactionExplanationUtxolibLegacy | TransactionExplanationUtxolibPsbt | TransactionExplanationWasm;
+export type ChangeAddressInfo = {
+    address: string;
+    chain: number;
+    index: number;
+};
+/**
+ * Decompose a raw psbt into useful information, such as the total amounts,
+ * change amounts, and transaction outputs.
+ *
+ * @param psbt {bitgo.UtxoPsbt} The PSBT to explain
+ * @param pubs {bitgo.RootWalletKeys | string[]} The public keys to use for the explanation
+ * @param network {utxolib.Network} The network to use for the explanation
+ * @param strict {boolean} Whether to throw an error if the PayGo address proof is invalid
+ */
+export declare function explainPsbt(psbt: bitgo.UtxoPsbt, params: {
+    pubs?: bitgo.RootWalletKeys | string[];
+    customChangePubs?: bitgo.RootWalletKeys | string[];
+}, network: utxolib.Network, { strict }?: {
+    strict?: boolean;
+}): TransactionExplanationUtxolibPsbt;
+export declare function explainLegacyTx<TNumber extends number | bigint>(tx: bitgo.UtxoTransaction<TNumber>, params: {
+    pubs?: string[];
+    txInfo?: {
+        unspents?: bitgo.Unspent<TNumber>[];
+    };
+    changeInfo?: {
+        address: string;
+        chain: number;
+        index: number;
+    }[];
+}, network: utxolib.Network): TransactionExplanationUtxolibLegacy;
+export {};
+//# sourceMappingURL=explainTransaction.d.ts.map

package/dist/esm/transaction/fixedScript/explainTransaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainTransaction.d.ts","sourceRoot":"","sources":["../../../../src/transaction/fixedScript/explainTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAGhD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,uBAAuB,IAAI,0BAA0B,EAAU,MAAM,sBAAsB,CAAC;AAGrG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAOhE,MAAM,WAAW,kCAAkC,CAAC,IAAI,GAAG,MAAM,EAAE,aAAa,SAAS,MAAM,GAAG,MAAM,CACtG,SAAQ,0BAA0B,CAAC,IAAI,EAAE,MAAM,CAAC;IAChD,yDAAyD;IACzD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,aAAa,EAAE,CAAC;IAC/B,mBAAmB,CAAC,EAAE,aAAa,EAAE,CAAC;IACtC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,6DAA6D;AAC7D,UAAU,oCAAoC,CAAC,IAAI,GAAG,MAAM,EAAE,aAAa,SAAS,MAAM,GAAG,MAAM,CACjG,SAAQ,kCAAkC,CAAC,IAAI,EAAE,aAAa,CAAC;IAC/D,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1B;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,uHAAuH;AACvH,MAAM,MAAM,0BAA0B,GAAG,kCAAkC,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;AAE7G,oHAAoH;AACpH,MAAM,MAAM,mCAAmC,GAAG,oCAAoC,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAE3G,0EAA0E;AAC1E,MAAM,MAAM,iCAAiC,GAAG,oCAAoC,CAAC,MAAM,CAAC,CAAC;AAE7F,MAAM,MAAM,gCAAgC,GAAG,oCAAoC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpG,MAAM,MAAM,sBAAsB,GAC9B,mCAAmC,GACnC,iCAAiC,GACjC,0BAA0B,CAAC;AAE/B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AA8SF;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,KAAK,CAAC,QAAQ,EACpB,MAAM,EAAE;IACN,IAAI,CAAC,EAAE,KAAK,CAAC,cAAc,GAAG,MAAM,EAAE,CAAC;IACvC,gBAAgB,CAAC,EAAE,KAAK,CAAC,cAAc,GAAG,MAAM,EAAE,CAAC;CACpD,EACD,OAAO,EAAE,OAAO,CAAC,OAAO,EACxB,EAAE,MAAa,EAAE,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3C,iCAAiC,CA+CnC;AAED,wBAAgB,eAAe,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAC7D,EAAE,EAAE,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,EAClC,MAAM,EAAE;IACN,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAA;KAAE,CAAC;IACjD,UAAU,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAClE,EACD,OAAO,EAAE,OAAO,CAAC,OAAO,GACvB,mCAAmC,CAQrC"}