ecash-lib 4.7.0 → 4.9.0

package/dist/index.d.ts

@@ -27,5 +27,6 @@ export * from './token/empp.js';
 export * from './token/slp.js';
 export * from './token/slp.parse.js';
 export * from './parse/opreturn.js';
+export * from './inputData.js';
 export * as payment from './payment';
 //# sourceMappingURL=index.d.ts.map

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,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,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

@@ -69,5 +69,6 @@ __exportStar(require("./token/empp.js"), exports);
 __exportStar(require("./token/slp.js"), exports);
 __exportStar(require("./token/slp.parse.js"), exports);
 __exportStar(require("./parse/opreturn.js"), exports);
+__exportStar(require("./inputData.js"), exports);
 exports.payment = __importStar(require("./payment"));
 //# sourceMappingURL=index.js.map

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,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,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/inputData.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Result of decoding a P2SH input that uses the Agora-style input-data format.
+ *
+ * Format follows ecash-agora ad script (ad.ts parseAdScriptSig, partial.ts adScript):
+ * - scriptSig = <lokad> <data> <sig> <pubkey> <redeemScript>
+ * - lokad first for chronik lokadId indexing
+ * - Redeem script: OP_CHECKSIGVERIFY pushBytes(data) OP_EQUALVERIFY pushBytes(lokad) OP_EQUAL
+ */
+export interface DecodedInputData {
+    /** 4-byte lokad ID (for chronik indexing) */
+    lokadId: Uint8Array;
+    /** Arbitrary data bytes */
+    data: Uint8Array;
+    /** Sender's P2PKH address (from pubkey in scriptSig) */
+    address: string;
+}
+/**
+ * Decode scriptSig from a P2SH input that uses the Agora-style input-data format.
+ *
+ * Built: scriptSig = [lokad, data, sig, pubkey, redeemScript]
+ * Redeem script: OP_CHECKSIG pushBytes(data) OP_EQUALVERIFY pushBytes(lokad) OP_EQUAL
+ *
+ * @param scriptSig - The scriptSig bytes from the spending input
+ * @param prefix - Address prefix (default 'ecash')
+ * @returns Decoded lokadId, data, and address, or undefined if the format doesn't match
+ */
+export declare function decodeInputData(scriptSig: Uint8Array, prefix?: string): DecodedInputData | undefined;
+//# sourceMappingURL=inputData.d.ts.map

package/dist/inputData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputData.d.ts","sourceRoot":"","sources":["../src/inputData.ts"],"names":[],"mappings":"AAUA;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC7B,6CAA6C;IAC7C,OAAO,EAAE,UAAU,CAAC;IACpB,2BAA2B;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC3B,SAAS,EAAE,UAAU,EACrB,MAAM,SAAU,GACjB,gBAAgB,GAAG,SAAS,CAoE9B"}

package/dist/inputData.js

@@ -0,0 +1,85 @@
+"use strict";
+// Copyright (c) 2026 The Bitcoin developers
+// Distributed under the MIT software license, see the accompanying
+// file COPYING or http://www.opensource.org/licenses/mit-license.php.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeInputData = decodeInputData;
+const bytes_js_1 = require("./io/bytes.js");
+const op_js_1 = require("./op.js");
+const hash_js_1 = require("./hash.js");
+const address_js_1 = require("./address/address.js");
+const opcode_js_1 = require("./opcode.js");
+/**
+ * Decode scriptSig from a P2SH input that uses the Agora-style input-data format.
+ *
+ * Built: scriptSig = [lokad, data, sig, pubkey, redeemScript]
+ * Redeem script: OP_CHECKSIG pushBytes(data) OP_EQUALVERIFY pushBytes(lokad) OP_EQUAL
+ *
+ * @param scriptSig - The scriptSig bytes from the spending input
+ * @param prefix - Address prefix (default 'ecash')
+ * @returns Decoded lokadId, data, and address, or undefined if the format doesn't match
+ */
+function decodeInputData(scriptSig, prefix = 'ecash') {
+    const pushes = [];
+    const bytes = new bytes_js_1.Bytes(scriptSig);
+    while (bytes.data.length - bytes.idx > 0) {
+        try {
+            const op = (0, op_js_1.readOp)(bytes);
+            if ((0, op_js_1.isPushOp)(op)) {
+                pushes.push(op.data);
+            }
+        }
+        catch {
+            return undefined;
+        }
+    }
+    // scriptSig = <lokad> <data> <sig> <pubkey> <redeemScript>
+    if (pushes.length < 5) {
+        return undefined;
+    }
+    const lokadId = pushes[0];
+    if (lokadId.length !== 4) {
+        return undefined;
+    }
+    const data = pushes[1];
+    const pubkey = pushes[pushes.length - 2];
+    const redeemScript = pushes[pushes.length - 1];
+    if (pubkey.length !== 33 && pubkey.length !== 65) {
+        return undefined;
+    }
+    // Redeem script: OP_CHECKSIGVERIFY pushBytes(data) OP_EQUALVERIFY pushBytes(lokad) OP_EQUAL
+    const redeemBytes = new bytes_js_1.Bytes(redeemScript);
+    try {
+        if ((0, op_js_1.readOp)(redeemBytes) !== opcode_js_1.OP_CHECKSIGVERIFY) {
+            return undefined;
+        }
+        const dataOp = (0, op_js_1.readOp)(redeemBytes);
+        if (!(0, op_js_1.isPushOp)(dataOp)) {
+            return undefined;
+        }
+        if (dataOp.data.length !== data.length ||
+            dataOp.data.some((b, i) => b !== data[i])) {
+            return undefined;
+        }
+        if ((0, op_js_1.readOp)(redeemBytes) !== opcode_js_1.OP_EQUALVERIFY) {
+            return undefined;
+        }
+        const lokadOp = (0, op_js_1.readOp)(redeemBytes);
+        if (!(0, op_js_1.isPushOp)(lokadOp) || lokadOp.data.length !== 4) {
+            return undefined;
+        }
+        if (lokadOp.data.some((b, i) => b !== lokadId[i])) {
+            return undefined;
+        }
+        if ((0, op_js_1.readOp)(redeemBytes) !== opcode_js_1.OP_EQUAL) {
+            return undefined;
+        }
+    }
+    catch {
+        return undefined;
+    }
+    const pkh = (0, hash_js_1.shaRmd160)(pubkey);
+    const address = address_js_1.Address.p2pkh(pkh, prefix).toString();
+    return { lokadId, data, address };
+}
+//# sourceMappingURL=inputData.js.map

package/dist/inputData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputData.js","sourceRoot":"","sources":["../src/inputData.ts"],"names":[],"mappings":"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"}

package/dist/op.d.ts

@@ -14,6 +14,14 @@ export interface PushOp {
     opcode: Opcode;
     data: Uint8Array;
 }
+/**
+ * Parse a number from a script op.
+ * Inverse of pushNumberOp: handles OP_0 (0), OP_1NEGATE (-1), OP_1 through OP_16,
+ * single-byte push data, and multi-byte minimal script number encoding (up to 64-bit).
+ * Always returns bigint for type safety (matches CScriptNum::getint).
+ * @throws Error with descriptive message if the op does not encode a number
+ */
+export declare function parseNumberFromOp(op: Op): bigint;
 /** Returns true if the given object is a `PushOp` */
 export declare function isPushOp(op: any): op is PushOp;
 /** Read a single Script operation from the bytes */

package/dist/op.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"op.d.ts","sourceRoot":"","sources":["../src/op.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAMH,MAAM,EACT,MAAM,aAAa,CAAC;AAErB;;;IAGI;AACJ,MAAM,MAAM,EAAE,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjC;;;IAGI;AACJ,MAAM,WAAW,MAAM;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;CACpB;AAED,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,IAAI,MAAM,CAU9C;AAED,oDAAoD;AACpD,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,EAAE,CAsBvC;AAED,6CAA6C;AAC7C,wBAAgB,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QA+B7C;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,EAAE,CAuBhD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,EAAE,CA8BvD"}
+{"version":3,"file":"op.d.ts","sourceRoot":"","sources":["../src/op.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAQH,MAAM,EACT,MAAM,aAAa,CAAC;AAErB;;;IAGI;AACJ,MAAM,MAAM,EAAE,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjC;;;IAGI;AACJ,MAAM,WAAW,MAAM;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;CACpB;AAqED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,EAAE,GAAG,MAAM,CAwBhD;AAED,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,IAAI,MAAM,CAU9C;AAED,oDAAoD;AACpD,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,EAAE,CAsBvC;AAED,6CAA6C;AAC7C,wBAAgB,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QA+B7C;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,EAAE,CAuBhD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,EAAE,CA8BvD"}

package/dist/op.js

@@ -3,12 +3,109 @@
 // Distributed under the MIT software license, see the accompanying
 // file COPYING or http://www.opensource.org/licenses/mit-license.php.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseNumberFromOp = parseNumberFromOp;
 exports.isPushOp = isPushOp;
 exports.readOp = readOp;
 exports.writeOp = writeOp;
 exports.pushBytesOp = pushBytesOp;
 exports.pushNumberOp = pushNumberOp;
+const consts_js_1 = require("./consts.js");
 const opcode_js_1 = require("./opcode.js");
+/**
+ * Check if bytes are a minimally encoded script number (not arbitrary data).
+ * See CScriptNum::IsMinimallyEncoded in script/script.cpp.
+ */
+function isMinimallyEncoded(data) {
+    if (data.length === 0)
+        return true;
+    // Check that the number is encoded with the minimum possible number of bytes.
+    // If the most-significant-byte (excluding the sign bit) is zero then we're not minimal.
+    // This also rejects the negative-zero encoding, 0x80.
+    const last = data[data.length - 1];
+    if ((last & 0x7f) === 0) {
+        // One exception: if there's more than one byte and the most significant bit of the
+        // second-to-last byte is set, it would conflict with the sign bit. E.g. +-255
+        // encode to 0xff00 and 0xff80 respectively.
+        if (data.length <= 1 || (data[data.length - 2] & 0x80) === 0) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Decode a minimally-encoded script number from bytes (little-endian, sign-magnitude).
+ * Validates size and minimal encoding; callers can rely on returned value being valid.
+ * Always returns bigint for type safety and full 64-bit range (matches CScriptNum::getint).
+ * Empty byte array decodes to 0.
+ * @throws Error if data exceeds max size or is not minimally encoded
+ */
+function decodeScriptNum(data) {
+    if (data.length === 0) {
+        return 0n;
+    }
+    if (data.length > consts_js_1.MAX_SCRIPTNUM_BYTE_SIZE) {
+        throw new Error(`Script number exceeds maximum size (${data.length} > ${consts_js_1.MAX_SCRIPTNUM_BYTE_SIZE} bytes)`);
+    }
+    if (!isMinimallyEncoded(data)) {
+        throw new Error('Script number is not minimally encoded');
+    }
+    let result = 0n;
+    for (let i = 0; i < data.length; i++) {
+        result |= BigInt(data[i]) << BigInt(8 * i);
+    }
+    if (data[data.length - 1] & 0x80) {
+        const mask = ~(0x80n << BigInt(8 * (data.length - 1)));
+        result &= mask;
+        result = -result;
+    }
+    return result;
+}
+/**
+ * Check if the PushOp uses minimal push encoding for its data length.
+ * pushNumberOp always produces minimal pushes.
+ */
+function isMinimalPushOp(pushOp) {
+    const len = pushOp.data.length;
+    if (len === 0)
+        return pushOp.opcode === opcode_js_1.OP_0;
+    if (len >= 1 && len <= 0x4b)
+        return pushOp.opcode === len;
+    if (len >= 0x4c && len <= 0xff)
+        return pushOp.opcode === opcode_js_1.OP_PUSHDATA1;
+    if (len >= 0x100 && len <= 0xffff)
+        return pushOp.opcode === opcode_js_1.OP_PUSHDATA2;
+    if (len >= 0x10000 && len <= 0xffffffff)
+        return pushOp.opcode === opcode_js_1.OP_PUSHDATA4;
+    return false;
+}
+/**
+ * Parse a number from a script op.
+ * Inverse of pushNumberOp: handles OP_0 (0), OP_1NEGATE (-1), OP_1 through OP_16,
+ * single-byte push data, and multi-byte minimal script number encoding (up to 64-bit).
+ * Always returns bigint for type safety (matches CScriptNum::getint).
+ * @throws Error with descriptive message if the op does not encode a number
+ */
+function parseNumberFromOp(op) {
+    if (typeof op === 'number') {
+        if (op === opcode_js_1.OP_0) {
+            return 0n;
+        }
+        if (op === opcode_js_1.OP_1NEGATE) {
+            return -1n;
+        }
+        if (op >= opcode_js_1.OP_1 && op <= opcode_js_1.OP_16) {
+            return BigInt(op - 0x50);
+        }
+        throw new Error(`Opcode 0x${op.toString(16)} does not encode a number (expected OP_0, OP_1NEGATE, or OP_1-OP_16)`);
+    }
+    if (!isPushOp(op)) {
+        throw new Error('Op is not a push op');
+    }
+    if (!isMinimalPushOp(op)) {
+        throw new Error(`Push uses non-minimal encoding (opcode 0x${op.opcode.toString(16)} for ${op.data.length} bytes)`);
+    }
+    return decodeScriptNum(op.data);
+}
 /** Returns true if the given object is a `PushOp` */
 function isPushOp(op) {
     if (!op || typeof op !== 'object') {

package/dist/op.js.map

@@ -1 +1 @@
-{"version":3,"file":"op.js","sourceRoot":"","sources":["../src/op.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"op.js","sourceRoot":"","sources":["../src/op.ts"],"names":[],"mappings":"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"}

package/dist/payment/action.d.ts

@@ -71,6 +71,23 @@ export interface Action {
     feePerKb?: bigint;
     /** Maximum tx sersize to be used for tx(s) of this action, defaults to MAX_TX_SERSIZE */
     maxTxSersize?: number;
+    /**
+     * Data encoded in a P2SH redeem script, revealed when the input is spent.
+     * Creates a chained tx: prep tx sends to P2SH, main tx spends it.
+     * Works for any tx type (XEC-only, SLP, ALP). Redeem script includes
+     * sender pubkey, so P2PKH address derivable from the spending input.
+     *
+     * Format follows ecash-agora ad script for chronik indexing:
+     * - lokad: 4-byte identifier (indexed by chronik as lokadId)
+     * - data: arbitrary bytes (like Agora covenant consts, minus covenant variant)
+     *
+     * scriptSig = <lokad> <data> <sig> <pubkey> <redeemScript>
+     * Redeem script: OP_CHECKSIGVERIFY pushBytes(data) OP_EQUALVERIFY pushBytes(lokad) OP_EQUAL
+     */
+    p2shInputData?: {
+        lokad: Uint8Array;
+        data: Uint8Array;
+    };
 }
 /**
  * Instructions for token actions within a given Action
@@ -139,6 +156,7 @@ export interface BurnAction {
 /**
  * Arbitrary data push to be included for token types that support EMPP
  * Not associated with PaymentOutput[]
+ * Only supported for ALP_TOKEN_TYPE_STANDARD (EMPP in OP_RETURN)
  */
 export interface DataAction {
     type: 'DATA';

package/dist/payment/action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/payment/action.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,MAAM;IACnB;;;;OAIG;IACH,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC3B;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACjB,aAAa,GACb,UAAU,GACV,UAAU,GACV,UAAU,GACV,UAAU,CAAC;AAEjB;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;CACpB"}
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/payment/action.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,MAAM;IACnB;;;;OAIG;IACH,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC3B;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC;CAC3D;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACjB,aAAa,GACb,UAAU,GACV,UAAU,GACV,UAAU,GACV,UAAU,CAAC;AAEjB;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;CACpB"}

package/dist/payment/action.js.map

@@ -1 +1 @@
-{"version":3,"file":"action.js","sourceRoot":"","sources":["../../src/payment/action.ts"],"names":[],"mappings":";AAAA,4CAA4C;AAC5C,mEAAmE;AACnE,sEAAsE;;;AA0FtE;;;;GAIG;AACU,QAAA,4BAA4B,GAAG,8BAA8B,CAAC"}
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../../src/payment/action.ts"],"names":[],"mappings":";AAAA,4CAA4C;AAC5C,mEAAmE;AACnE,sEAAsE;;;AAwGtE;;;;GAIG;AACU,QAAA,4BAA4B,GAAG,8BAA8B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ecash-lib",
-    "version": "4.7.0",
+    "version": "4.9.0",
     "description": "Library for eCash transaction building",
     "main": "./dist/indexNodeJs.js",
     "browser": "./dist/indexBrowser.js",

package/src/consts.ts

@@ -37,5 +37,11 @@ export const OP_RETURN_MAX_BYTES = 223;
  */
 export const MAX_TX_SERSIZE = 100_000;
 
+/**
+ * Maximum byte size of script numbers when interpreting Script.
+ * Mirrors MAX_SCRIPTNUM_BYTE_SIZE in src/script/script.h.
+ */
+export const MAX_SCRIPTNUM_BYTE_SIZE = 8;
+
 // The size in bytes of a p2pkh output
 export const P2PKH_OUTPUT_SIZE = 34;