ecash-lib 4.10.0 → 4.12.0

package/dist/index.d.ts

@@ -10,6 +10,8 @@ export * from './hdwallet.js';
 export * from './address/address.js';
 export * from './sigHashType.js';
 export * from './tx.js';
+export * from './psbt.js';
+export * from './signatories.js';
 export * from './txBuilder.js';
 export * from './unsignedTx.js';
 export * from './io/bytes.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -52,6 +52,8 @@ __exportStar(require("./hdwallet.js"), exports);
 __exportStar(require("./address/address.js"), exports);
 __exportStar(require("./sigHashType.js"), exports);
 __exportStar(require("./tx.js"), exports);
+__exportStar(require("./psbt.js"), exports);
+__exportStar(require("./signatories.js"), exports);
 __exportStar(require("./txBuilder.js"), exports);
 __exportStar(require("./unsignedTx.js"), exports);
 __exportStar(require("./io/bytes.js"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,4CAA4C;AAC5C,mEAAmE;AACnE,sEAAsE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEtE,8CAA4B;AAC5B,2CAAyB;AACzB,4CAA0B;AAC1B,0CAAwB;AACxB,8CAA4B;AAC5B,8CAA4B;AAC5B,gDAA8B;AAC9B,gDAA8B;AAC9B,gDAA8B;AAC9B,uDAAqC;AACrC,mDAAiC;AACjC,0CAAwB;AACxB,iDAA+B;AAC/B,kDAAgC;AAChC,gDAA8B;AAC9B,8CAA4B;AAC5B,8CAA4B;AAC5B,8CAA4B;AAC5B,kDAAgC;AAChC,iDAA+B;AAC/B,sDAAoC;AACpC,uDAAqC;AACrC,iDAA+B;AAC/B,uDAAqC;AACrC,oDAAkC;AAClC,kDAAgC;AAChC,iDAA+B;AAC/B,uDAAqC;AACrC,sDAAoC;AACpC,iDAA+B;AAC/B,qDAAqC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,4CAA4C;AAC5C,mEAAmE;AACnE,sEAAsE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEtE,8CAA4B;AAC5B,2CAAyB;AACzB,4CAA0B;AAC1B,0CAAwB;AACxB,8CAA4B;AAC5B,8CAA4B;AAC5B,gDAA8B;AAC9B,gDAA8B;AAC9B,gDAA8B;AAC9B,uDAAqC;AACrC,mDAAiC;AACjC,0CAAwB;AACxB,4CAA0B;AAC1B,mDAAiC;AACjC,iDAA+B;AAC/B,kDAAgC;AAChC,gDAA8B;AAC9B,8CAA4B;AAC5B,8CAA4B;AAC5B,8CAA4B;AAC5B,kDAAgC;AAChC,iDAA+B;AAC/B,sDAAoC;AACpC,uDAAqC;AACrC,iDAA+B;AAC/B,uDAAqC;AACrC,oDAAkC;AAClC,kDAAgC;AAChC,iDAA+B;AAC/B,uDAAqC;AACrC,sDAAoC;AACpC,iDAA+B;AAC/B,qDAAqC"}

package/dist/psbt.d.ts

@@ -0,0 +1,115 @@
+import { Ecc } from './ecc.js';
+import { Script } from './script.js';
+import { type SigHashType } from './sigHashType.js';
+import { SignData, Tx } from './tx.js';
+/**
+ * BIP 174 **magic bytes** for PSBT version 0: ASCII `psbt` + `0xff`.
+ * Defined in BIP 174 “Specification > Version 0” (must be first bytes of a `.psbt`).
+ * - https://github.com/bitcoin/bips/blob/master/bip-0174.mediawiki#specification
+ * - https://bips.dev/174/#specification
+ */
+export declare const PSBT_MAGIC: Uint8Array<ArrayBuffer>;
+/**
+ * Bitcoin ABC `PSBT_IN_UTXO` (BIP 174 input type `0x00`): value is either the full
+ * previous transaction (BIP “non-witness UTXO”) or a serialized `CTxOut` (amount +
+ * scriptPubKey). This is the **only** key we use for spent-output data; BIP type
+ * `0x01` is not handled like the node (see module TSDoc). Resolved in
+ * {@link resolveWitnessFromKey00}.
+ */
+export declare const PSBT_IN_UTXO = 0;
+/** Strip input scripts for PSBT global unsigned transaction (BIP 174). */
+export declare function txToUnsigned(tx: Tx): Tx;
+export interface PsbtInputMaps {
+    witnessUtxo: {
+        sats: bigint;
+        scriptPubKey: Uint8Array;
+    };
+    redeemScript?: Script;
+    partialSigs: Map<string, Uint8Array>;
+}
+/** One PSBT key-value pair (BIP 174). */
+export type PsbtKeyValue = {
+    key: Uint8Array;
+    value: Uint8Array;
+};
+/**
+ * BIP 174 PSBT for eCash multisig and ABC-aligned decode/encode.
+ * See https://github.com/bitcoin/bips/blob/master/bip-0174.mediawiki#serialization
+ *
+ * Typical flow: {@link Psbt.fromTx} from a partially signed {@link Tx} plus
+ * {@link SignData} per input → {@link Psbt.toBytes} → share → {@link Psbt.fromBytes}.
+ * Unknown key-value pairs are preserved (BIP 174).
+ */
+export declare class Psbt {
+    /** Unsigned transaction (empty scriptSigs). */
+    readonly unsignedTx: Tx;
+    /** Per-input signing data (amount, scripts, partial sig maps). */
+    readonly signDataPerInput: SignData[];
+    /** Per-input partial signatures: hex(pubkey) → signature incl. sighash byte. */
+    readonly inputPartialSigs: Map<string, Uint8Array>[];
+    /**
+     * Unknown global key-value pairs (BIP 174: implementations must preserve
+     * unknown keys on round-trip).
+     */
+    readonly unknownGlobalPairs: PsbtKeyValue[];
+    /** Unknown per-input pairs (excluding consumed `PSBT_IN_UTXO` / `0x00` entries). */
+    readonly unknownInputPairs: PsbtKeyValue[][];
+    /** Unknown per-output pairs. */
+    readonly unknownOutputPairs: PsbtKeyValue[][];
+    /**
+     * When true, this input had no `PSBT_IN_UTXO` (`0x00`) field in the PSBT (e.g.
+     * creator-only PSBT or finalized script fields only). {@link toBytes} will
+     * not emit that entry for the input.
+     */
+    readonly inputWitnessIncomplete: boolean[];
+    constructor(params: {
+        unsignedTx: Tx;
+        signDataPerInput: SignData[];
+        inputPartialSigs: Map<string, Uint8Array>[];
+        unknownGlobalPairs?: PsbtKeyValue[];
+        unknownInputPairs?: PsbtKeyValue[][];
+        unknownOutputPairs?: PsbtKeyValue[][];
+        inputWitnessIncomplete?: boolean[];
+    });
+    /**
+     * Build a PSBT from a transaction that may already include partial scriptSigs.
+     * Populates `PSBT_IN_UTXO` (`0x00`) + redeem script + partial signatures.
+     */
+    static fromTx(tx: Tx, signDataPerInput: SignData[], ecc: Ecc): Psbt;
+    /** Deserialize PSBT bytes (BIP 174). */
+    static fromBytes(data: Uint8Array): Psbt;
+    /** Serialize to BIP 174 bytes. */
+    toBytes(): Uint8Array;
+    /**
+     * Current transaction with scriptSigs built from partial signatures.
+     * Attach each input's `signData` for signing and validation helpers.
+     */
+    toTx(): Tx;
+    /**
+     * Add or merge a multisig signature on an input (same semantics as
+     * {@link Tx.addMultisigSignature}).
+     */
+    addMultisigSignature(params: {
+        inputIdx: number;
+        signature: Uint8Array;
+        signData: SignData;
+        ecc?: Ecc;
+    }): Psbt;
+    /**
+     * Like {@link addMultisigSignature}, but signs with a secret key (see
+     * {@link Tx.addMultisigSignatureFromKey}).
+     */
+    addMultisigSignatureFromKey(params: {
+        inputIdx: number;
+        sk: Uint8Array;
+        signData: SignData;
+        sigHashType?: SigHashType;
+        ecc?: Ecc;
+    }): Psbt;
+    /**
+     * Same as {@link Tx.isFullySignedMultisig} on {@link toTx} (including
+     * vacuous `true` when there are no multisig inputs).
+     */
+    isFullySignedMultisig(): boolean;
+}
+//# sourceMappingURL=psbt.d.ts.map

package/dist/psbt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"psbt.d.ts","sourceRoot":"","sources":["../src/psbt.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAIH,QAAQ,EACR,EAAE,EAEL,MAAM,SAAS,CAAC;AAGjB;;;;;GAKG;AACH,eAAO,MAAM,UAAU,yBAAiD,CAAC;AAGzE;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,IAAO,CAAC;AAmKjC,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAWvC;AAiPD,MAAM,WAAW,aAAa;IAC1B,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,UAAU,CAAA;KAAE,CAAC;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACxC;AAED,yCAAyC;AACzC,MAAM,MAAM,YAAY,GAAG;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAgFlE;;;;;;;GAOG;AACH,qBAAa,IAAI;IACb,+CAA+C;IAC/C,SAAgB,UAAU,EAAE,EAAE,CAAC;IAC/B,kEAAkE;IAClE,SAAgB,gBAAgB,EAAE,QAAQ,EAAE,CAAC;IAC7C,gFAAgF;IAChF,SAAgB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC;IAC5D;;;OAGG;IACH,SAAgB,kBAAkB,EAAE,YAAY,EAAE,CAAC;IACnD,oFAAoF;IACpF,SAAgB,iBAAiB,EAAE,YAAY,EAAE,EAAE,CAAC;IACpD,gCAAgC;IAChC,SAAgB,kBAAkB,EAAE,YAAY,EAAE,EAAE,CAAC;IACrD;;;;OAIG;IACH,SAAgB,sBAAsB,EAAE,OAAO,EAAE,CAAC;gBAE/B,MAAM,EAAE;QACvB,UAAU,EAAE,EAAE,CAAC;QACf,gBAAgB,EAAE,QAAQ,EAAE,CAAC;QAC7B,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC;QAC5C,kBAAkB,CAAC,EAAE,YAAY,EAAE,CAAC;QACpC,iBAAiB,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC;QACrC,kBAAkB,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC;QACtC,sBAAsB,CAAC,EAAE,OAAO,EAAE,CAAC;KACtC;IAoCD;;;OAGG;WACW,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IAyB1E,wCAAwC;WAC1B,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAiG/C,kCAAkC;IAC3B,OAAO,IAAI,UAAU;IAuD5B;;;OAGG;IACI,IAAI,IAAI,EAAE;IAoBjB;;;OAGG;IACI,oBAAoB,CAAC,MAAM,EAAE;QAChC,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,UAAU,CAAC;QACtB,QAAQ,EAAE,QAAQ,CAAC;QACnB,GAAG,CAAC,EAAE,GAAG,CAAC;KACb,GAAG,IAAI;IAmBR;;;OAGG;IACI,2BAA2B,CAAC,MAAM,EAAE;QACvC,QAAQ,EAAE,MAAM,CAAC;QACjB,EAAE,EAAE,UAAU,CAAC;QACf,QAAQ,EAAE,QAAQ,CAAC;QACnB,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,GAAG,CAAC,EAAE,GAAG,CAAC;KACb,GAAG,IAAI;IAmBR;;;OAGG;IACI,qBAAqB,IAAI,OAAO;CAG1C"}