ecash-lib 1.2.2-rc9 → 1.4.0

package/dist/script.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../src/script.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAIxC,OAAO,EAAE,EAAE,EAAgC,MAAM,SAAS,CAAC;AAS3D,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAGtC,gDAAgD;AAChD,qBAAa,MAAM;IACR,QAAQ,EAAE,UAAU,CAAC;IAE5B,2DAA2D;gBACxC,QAAQ,CAAC,EAAE,UAAU;IAIxC;;;QAGI;IACG,aAAa,CAAC,MAAM,EAAE,MAAM;WAKrB,YAAY,CAAC,KAAK,EAAE,KAAK;IAKvC,+CAA+C;WACjC,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,MAAM;WAc1B,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAqBlD,0CAA0C;IACnC,GAAG,IAAI,YAAY;IAI1B,wCAAwC;IACjC,IAAI,IAAI,MAAM;IAIrB;;;;;;;;;;;;;;;;;;OAkBG;IACI,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAe9C;;;QAGI;IACG,MAAM,IAAI,OAAO;IAWxB,oDAAoD;WACtC,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;IASlD,yDAAyD;WAC3C,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM;IAa5C,oDAAoD;WACtC,UAAU,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,GAAG,MAAM;CAGpE;AAED,yCAAyC;AACzC,qBAAa,YAAY;IACrB,KAAK,EAAE,KAAK,CAAC;gBAEM,KAAK,EAAE,KAAK;IAI/B;;;OAGG;IACI,IAAI,IAAI,EAAE,GAAG,SAAS;CAMhC"}
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../src/script.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAIxC,OAAO,EAAE,EAAE,EAAgC,MAAM,SAAS,CAAC;AAS3D,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAGtC,gDAAgD;AAChD,qBAAa,MAAM;IACR,QAAQ,EAAE,UAAU,CAAC;IAE5B,2DAA2D;gBACxC,QAAQ,CAAC,EAAE,UAAU;IAIxC;;;QAGI;IACG,aAAa,CAAC,MAAM,EAAE,MAAM;WAKrB,YAAY,CAAC,KAAK,EAAE,KAAK;IAKvC,+CAA+C;WACjC,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,MAAM;WAc1B,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAqBlD,0CAA0C;IACnC,GAAG,IAAI,YAAY;IAI1B,wCAAwC;IACjC,IAAI,IAAI,MAAM;IAIrB;;;;;;;;;;;;;;;;;;OAkBG;IACI,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAe9C;;;QAGI;IACG,MAAM,IAAI,OAAO;IAWxB;;OAEG;IACI,KAAK,IAAI,MAAM;IAItB,oDAAoD;WACtC,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;IASlD,yDAAyD;WAC3C,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM;IAa5C,oDAAoD;WACtC,UAAU,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,GAAG,MAAM;CAGpE;AAED,yCAAyC;AACzC,qBAAa,YAAY;IACrB,KAAK,EAAE,KAAK,CAAC;gBAEM,KAAK,EAAE,KAAK;IAI/B;;;OAGG;IACI,IAAI,IAAI,EAAE,GAAG,SAAS;CAMhC"}

package/dist/script.js

@@ -114,6 +114,12 @@ class Script {
             this.bytecode[1] == 20 &&
             this.bytecode[22] == opcode_js_1.OP_EQUAL);
     }
+    /**
+     * Return hex string of this Script's bytecode
+     */
+    toHex() {
+        return (0, hex_js_1.toHex)(this.bytecode);
+    }
     /** Build a P2SH script for the given script hash */
     static p2sh(scriptHash) {
         if (scriptHash.length !== 20) {

package/dist/script.js.map

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

package/package.json

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

package/src/address/address.ts

@@ -0,0 +1,346 @@
+// Copyright (c) 2024 The Bitcoin developers
+// Distributed under the MIT software license, see the accompanying
+// file COPYING or http://www.opensource.org/licenses/mit-license.php.
+import { toHex, fromHex } from '../io/hex';
+import {
+    decodeCashAddress,
+    getOutputScriptFromTypeAndHash,
+    getTypeAndHashFromOutputScript,
+    encodeCashAddress,
+    isValidCashAddress,
+} from 'ecashaddrjs';
+import {
+    decodeLegacyAddress,
+    encodeBase58Check,
+    LEGACY_VERSION_BYTES,
+} from './legacyaddr';
+import { Script } from '../script';
+
+export type AddressType = 'p2pkh' | 'p2sh';
+export type AddressEncoding = 'cashaddr' | 'legacy';
+
+export const ECASH_PREFIXES_TESTNET = ['ectest', 'ecregtest'];
+
+/**
+ * Converts an ecash address in cashaddr format to legacy format
+ * Throws if user attempts to convert a legacy address to a legacy address
+ * Separated as its own function here for
+ *
+ * 1 - simpler unit testing
+ * 2 - exported for users looking to convert string cashaddr to string legacy addr
+ *     without using the Address class
+ */
+export const toLegacyAddress = (cashaddress: string): string => {
+    try {
+        // No-op if user is trying to convert legacy to legacy
+        decodeLegacyAddress(cashaddress);
+        return cashaddress;
+    } catch {
+        // Do nothing with this error since we expect it every time for the function's intended use case
+        // Proceed to convert to legacy
+    }
+    const { prefix, type, hash } = decodeCashAddress(cashaddress);
+
+    const isTestnet = ECASH_PREFIXES_TESTNET.includes(prefix);
+
+    // Get correct version byte for legacy format
+    let versionByte: number;
+    switch (type) {
+        case 'p2pkh':
+            versionByte = isTestnet
+                ? LEGACY_VERSION_BYTES.legacy.testnet.p2pkh
+                : LEGACY_VERSION_BYTES.legacy.mainnet.p2pkh;
+            break;
+        case 'p2sh':
+            versionByte = isTestnet
+                ? LEGACY_VERSION_BYTES.legacy.testnet.p2sh
+                : LEGACY_VERSION_BYTES.legacy.mainnet.p2sh;
+            break;
+        default:
+            throw new Error('Unsupported address type: ' + type);
+    }
+
+    // Convert hash to Uint8Array
+    const hashArray = fromHex(hash);
+
+    // Create a new Uint8Array to hold the data
+    const uint8Array = new Uint8Array(1 + hashArray.length);
+
+    // Set the version byte
+    uint8Array[0] = versionByte;
+
+    // Set the hash
+    uint8Array.set(hashArray, 1);
+
+    // Encode to base58check
+    return encodeBase58Check(uint8Array);
+};
+
+interface AddressInterface {
+    /**
+     * hash
+     * The hash this address encodes as a hex string.
+     * It's part of the Script this address represents.
+     */
+    hash: string;
+    /**
+     * p2pkh or p2sh
+     * The type of address
+     * Address supports p2pkh or p2sh address types
+     */
+    type: AddressType;
+    /**
+     * Defined for a cashaddr address, i.e. one with encoding === 'cashaddr'
+     * This is distinct from the version byte. Common prefixes on ecash include
+     * 'ecash', 'etoken', 'ectest', and 'ecregest'. But a prefix could be anything
+     * so long as the address checksum matches.
+     */
+    prefix?: string;
+    /**
+     * encoded address as a string
+     * cashaddr or legacy
+     * type available in 'encoding' field
+     */
+    address: string;
+    /**
+     * How this address is encoded
+     * cashaddr or legacy
+     * If cashaddr, 'prefix' is defined and a string
+     */
+    encoding: AddressEncoding;
+}
+
+/**
+ * Constructor params for private constructor method of the Address class
+ */
+interface AddressConstructorParams {
+    hash: string;
+    type: AddressType;
+    prefix?: string;
+    address: string;
+    encoding: AddressEncoding;
+}
+
+export const DEFAULT_PREFIX = 'ecash';
+
+/**
+ * Address
+ * Stores properties of supported crypto addresses
+ * in standard typed structure. Provides methods for
+ * easy access of address data in dev-friendly formats.
+ * Provides methods for instantiating by type, encoding,
+ * script, prefix, and address string of arbitrary encoding.
+ *
+ * Simplifies conversion between cashaddr prefixes and
+ * address encoding types.
+ *
+ * Address is an ecash-first class. Legacy BTC format
+ * is supported to simplify conversion to and from
+ * ecash addresses.
+ *
+ * Address may be extended to support other crypto
+ * address formats.
+ */
+export class Address implements AddressInterface {
+    hash: string;
+    type: AddressType;
+    prefix?: string;
+    address: string;
+    encoding: AddressEncoding;
+
+    private constructor(params: AddressConstructorParams) {
+        const { hash, type, address, encoding } = params;
+        this.hash = hash;
+        this.type = type;
+        this.address = address;
+        this.encoding = encoding;
+        if (typeof params.prefix !== 'undefined') {
+            this.prefix = params.prefix;
+        }
+    }
+
+    /**
+     * Create a new p2pkh Address from hash
+     * cashaddr encoding, ecash: prefix
+     */
+    static p2pkh = (hash: string | Uint8Array) =>
+        new Address({
+            type: 'p2pkh',
+            hash: hash instanceof Uint8Array ? toHex(hash) : hash,
+            prefix: DEFAULT_PREFIX,
+            address: encodeCashAddress(DEFAULT_PREFIX, 'p2pkh', hash),
+            encoding: 'cashaddr',
+        });
+
+    /**
+     * Create a new p2sh Address from hash
+     * cashaddr encoding
+     * ecash: prefix
+     */
+    static p2sh = (hash: string | Uint8Array) =>
+        new Address({
+            type: 'p2sh',
+            hash: hash instanceof Uint8Array ? toHex(hash) : hash,
+            prefix: DEFAULT_PREFIX,
+            address: encodeCashAddress(DEFAULT_PREFIX, 'p2sh', hash),
+            encoding: 'cashaddr',
+        });
+
+    /**
+     * Create a new Address from a given address string
+     * address must be valid legacy or cashaddr address
+     */
+    static parse = (address: string) => {
+        if (isValidCashAddress(address)) {
+            const { type, hash, prefix } = decodeCashAddress(address);
+            return new Address({
+                type,
+                hash,
+                prefix,
+                encoding: 'cashaddr',
+                address,
+            });
+        }
+        try {
+            const { type, hash } = decodeLegacyAddress(address);
+            return new Address({
+                type,
+                hash,
+                encoding: 'legacy',
+                address,
+            });
+        } catch {
+            throw new Error('Invalid cashaddr or legacy address');
+        }
+    };
+
+    /**
+     * Create a new Address from a cashaddr
+     * prefix, type, and hash from creating cashaddr
+     */
+    static fromCashAddress = (address: string) => {
+        const { type, hash, prefix } = decodeCashAddress(address);
+        return new Address({
+            type,
+            hash,
+            address,
+            encoding: 'cashaddr',
+            prefix,
+        });
+    };
+
+    /**
+     * Create a new Address from legacy address
+     * No prefix for Address created from legacy address
+     * type and hash from legacy address
+     */
+    static fromLegacyAddress = (legacy: string) => {
+        // Determine addr params from legacy address
+        const { type, hash } = decodeLegacyAddress(legacy);
+        return new Address({
+            type,
+            hash,
+            address: legacy,
+            encoding: 'legacy',
+        });
+    };
+
+    /**
+     * Create a new Address from an outputScript as Script
+     * type and hash from outputScript
+     * cashaddr encoding
+     * ecash: prefix
+     */
+    static fromScript = (script: Script) => {
+        const scriptHex = toHex(script.bytecode);
+        return Address.fromScriptHex(scriptHex);
+    };
+
+    /**
+     * Create a new Address from an outputScript as hex string
+     * type and hash from outputScript
+     * cashaddr encoding
+     * ecash: prefix
+     */
+    static fromScriptHex = (scriptHex: string) => {
+        const { type, hash } = getTypeAndHashFromOutputScript(scriptHex);
+
+        // Default cashaddr encoding with default prefix
+        const address = encodeCashAddress(DEFAULT_PREFIX, type, hash);
+        const prefix = DEFAULT_PREFIX;
+
+        return new Address({
+            type,
+            hash,
+            prefix,
+            address,
+            encoding: 'cashaddr',
+        });
+    };
+
+    toString = () => {
+        return this.address;
+    };
+
+    legacy = () =>
+        new Address({
+            type: this.type,
+            hash: this.hash,
+            address: toLegacyAddress(this.address),
+            encoding: 'legacy',
+        });
+
+    /**
+     * Create an Address with cashaddr encoding
+     * from an existing Address
+     */
+    cash = () =>
+        new Address({
+            type: this.type,
+            hash: this.hash,
+            address: encodeCashAddress(
+                typeof this.prefix !== 'undefined'
+                    ? this.prefix
+                    : DEFAULT_PREFIX,
+                this.type,
+                this.hash,
+            ),
+            encoding: 'cashaddr',
+            prefix:
+                typeof this.prefix !== 'undefined'
+                    ? this.prefix
+                    : DEFAULT_PREFIX,
+        });
+
+    /**
+     * Create address with specified prefix
+     * from an existing cashaddr-encoding Address
+     */
+    withPrefix = (prefix: string) => {
+        if (this.encoding === 'legacy') {
+            // Take no action for legacy address types
+            throw new Error('withPrefix does not support legacy address types');
+        }
+        if (this.prefix === prefix) {
+            // Take no action if prefix is not changing
+            throw new Error(`prefix is already "${this.prefix}"`);
+        }
+        return new Address({
+            type: this.type,
+            hash: this.hash,
+            prefix,
+            address: encodeCashAddress(prefix, this.type, this.hash),
+            encoding: 'cashaddr',
+        });
+    };
+
+    toScript = (): Script => {
+        return new Script(
+            fromHex(getOutputScriptFromTypeAndHash(this.type, this.hash)),
+        );
+    };
+
+    toScriptHex = (): string => {
+        return getOutputScriptFromTypeAndHash(this.type, this.hash);
+    };
+}

package/src/address/legacyaddr.ts

@@ -0,0 +1,129 @@
+// Copyright (c) 2024 The Bitcoin developers
+// Distributed under the MIT software license, see the accompanying
+// file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+import { sha256d } from '../hash';
+import { encodeBase58, decodeBase58 } from 'b58-ts';
+import { AddressType } from './address';
+import { toHex } from '../io/hex';
+
+/**
+ * Base 58 Check
+ */
+
+export const encodeBase58Check = (data: Uint8Array): string => {
+    const checksum = sha256d(data);
+    const dataWithChecksum = new Uint8Array(data.length + 4);
+    dataWithChecksum.set(data, 0);
+    dataWithChecksum.set(checksum.subarray(0, 4), data.length);
+    return encodeBase58(dataWithChecksum);
+};
+
+export const decodeBase58Check = (str: string): Uint8Array => {
+    const dataWithChecksum = decodeBase58(str);
+    const payload = dataWithChecksum.slice(0, -4);
+    const checksum = dataWithChecksum.slice(-4);
+    const expectedChecksum = sha256d(payload);
+
+    // Ensure the two checksums are equal
+    if (
+        (checksum[0] ^ expectedChecksum[0]) |
+        (checksum[1] ^ expectedChecksum[1]) |
+        (checksum[2] ^ expectedChecksum[2]) |
+        (checksum[3] ^ expectedChecksum[3])
+    ) {
+        throw new Error('Invalid checksum');
+    }
+
+    return payload;
+};
+
+type NetworkType = 'mainnet' | 'testnet';
+export interface DecodedLegacyAddress {
+    type: AddressType;
+    hash: string;
+    network: NetworkType;
+}
+// Length of a valid base58check encoding payload: 1 byte for
+// the version byte plus 20 bytes for a RIPEMD - 160 hash.
+const BASE_58_CHECK_PAYLOAD_LENGTH = 21;
+
+interface NetworkVersionBytes {
+    p2pkh: number;
+    p2sh: number;
+}
+interface VersionByteReference {
+    legacy: {
+        mainnet: NetworkVersionBytes;
+        testnet: NetworkVersionBytes;
+    };
+}
+export const LEGACY_VERSION_BYTES: VersionByteReference = {
+    legacy: {
+        mainnet: { p2pkh: 0, p2sh: 5 },
+        testnet: { p2pkh: 111, p2sh: 196 },
+    },
+};
+
+// Modeled from https://github.com/ealmansi/bchaddrjs/blob/master/src/bchaddr.js#L193
+export const decodeLegacyAddress = (address: string): DecodedLegacyAddress => {
+    try {
+        const payload = decodeBase58Check(address);
+        if (payload.length !== BASE_58_CHECK_PAYLOAD_LENGTH) {
+            throw new Error(
+                `Invalid legacy address: payload length must be ${BASE_58_CHECK_PAYLOAD_LENGTH}`,
+            );
+        }
+        const versionByte = payload[0];
+        const hash = toHex(new Uint8Array(payload.slice(1)));
+        switch (versionByte) {
+            case LEGACY_VERSION_BYTES.legacy.mainnet.p2pkh:
+                return {
+                    hash,
+                    type: 'p2pkh',
+                    network: 'mainnet',
+                };
+            case LEGACY_VERSION_BYTES.legacy.mainnet.p2sh:
+                return {
+                    hash,
+                    type: 'p2sh',
+                    network: 'mainnet',
+                };
+            case LEGACY_VERSION_BYTES.legacy.testnet.p2pkh:
+                return {
+                    hash,
+                    type: 'p2pkh',
+                    network: 'testnet',
+                };
+            case LEGACY_VERSION_BYTES.legacy.testnet.p2sh:
+                return {
+                    hash,
+                    type: 'p2sh',
+                    network: 'testnet',
+                };
+            default: {
+                throw new Error(
+                    `Invalid legacy address: unrecognized version byte "${versionByte}"`,
+                );
+            }
+        }
+    } catch {
+        throw new Error(`Invalid legacy address`);
+    }
+};
+
+/**
+ * Encode a legacy address given type and hash
+ * For now, this is a stub method that supports only BTC p2pkh and p2sh
+ */
+export const encodeLegacyAddress = (
+    hash: Uint8Array,
+    type: 'p2pkh' | 'p2sh',
+    network: NetworkType = 'mainnet',
+) => {
+    const versionByte = LEGACY_VERSION_BYTES.legacy[network][type];
+    const combined = new Uint8Array(1 + hash.length);
+    combined[0] = versionByte;
+    combined.set(hash, 1);
+    return encodeBase58Check(combined);
+};

package/src/consts.ts

@@ -0,0 +1,8 @@
+// Copyright (c) 2024 The Bitcoin developers
+// Distributed under the MIT software license, see the accompanying
+// file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+/** Default dust limit on the eCash network. */
+export const DEFAULT_DUST_LIMIT = 546;
+/** Default fee per kB on the eCash network. */
+export const DEFAULT_FEE_PER_KB = 1000;

package/src/ecc.ts

@@ -0,0 +1,61 @@
+// Copyright (c) 2024 The Bitcoin developers
+// Distributed under the MIT software license, see the accompanying
+// file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+/** Interface to abstract over Elliptic Curve Cryptography */
+export interface Ecc {
+    /** Derive a public key from secret key. */
+    derivePubkey(seckey: Uint8Array): Uint8Array;
+
+    /** Sign an ECDSA signature. msg needs to be a 32-byte hash */
+    ecdsaSign(seckey: Uint8Array, msg: Uint8Array): Uint8Array;
+
+    /** Sign a Schnorr signature. msg needs to be a 32-byte hash */
+    schnorrSign(seckey: Uint8Array, msg: Uint8Array): Uint8Array;
+
+    /**
+     * Return whether the given secret key is valid, i.e. whether is of correct
+     * length (32 bytes) and is on the curve.
+     */
+    isValidSeckey(seckey: Uint8Array): boolean;
+
+    /** Add a scalar to a secret key */
+    seckeyAdd(a: Uint8Array, b: Uint8Array): Uint8Array;
+
+    /** Add a scalar to a public key (adding G*b) */
+    pubkeyAdd(a: Uint8Array, b: Uint8Array): Uint8Array;
+}
+
+/** Ecc implementation using WebAssembly */
+export let Ecc: { new (): Ecc };
+
+/** Dummy Ecc impl that always returns 0, useful for measuring tx size */
+export class EccDummy implements Ecc {
+    derivePubkey(_seckey: Uint8Array): Uint8Array {
+        return new Uint8Array(33);
+    }
+
+    ecdsaSign(_seckey: Uint8Array, _msg: Uint8Array): Uint8Array {
+        return new Uint8Array(73);
+    }
+
+    schnorrSign(_seckey: Uint8Array, _msg: Uint8Array): Uint8Array {
+        return new Uint8Array(64);
+    }
+
+    isValidSeckey(_seckey: Uint8Array): boolean {
+        return false;
+    }
+
+    seckeyAdd(_a: Uint8Array, _b: Uint8Array): Uint8Array {
+        return new Uint8Array(32);
+    }
+
+    pubkeyAdd(_a: Uint8Array, _b: Uint8Array): Uint8Array {
+        return new Uint8Array(32);
+    }
+}
+
+export function __setEcc(ecc: { new (): Ecc }) {
+    Ecc = ecc;
+}

package/src/ffi/ecash_lib_wasm_bg_browser.wasm.d.ts

@@ -0,0 +1,32 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export function sha512h_new(): number;
+export function sha512h_update(a: number, b: number, c: number): void;
+export function sha512h_finalize(a: number, b: number): void;
+export function sha512h_clone(a: number): number;
+export function sha256h_new(): number;
+export function sha256h_update(a: number, b: number, c: number): void;
+export function sha256h_finalize(a: number, b: number): void;
+export function sha256h_clone(a: number): number;
+export function __wbg_sha256h_free(a: number): void;
+export function sha512(a: number, b: number, c: number): void;
+export function sha256d(a: number, b: number, c: number): void;
+export function sha256(a: number, b: number, c: number): void;
+export function shaRmd160(a: number, b: number, c: number): void;
+export function ecc_new(): number;
+export function ecc_derivePubkey(a: number, b: number, c: number, d: number): void;
+export function ecc_ecdsaSign(a: number, b: number, c: number, d: number, e: number, f: number): void;
+export function ecc_schnorrSign(a: number, b: number, c: number, d: number, e: number, f: number): void;
+export function ecc_isValidSeckey(a: number, b: number, c: number): number;
+export function ecc_seckeyAdd(a: number, b: number, c: number, d: number, e: number, f: number): void;
+export function ecc_pubkeyAdd(a: number, b: number, c: number, d: number, e: number, f: number): void;
+export function __wbg_ecc_free(a: number): void;
+export function ecash_secp256k1_context_create(a: number): number;
+export function ecash_secp256k1_context_destroy(a: number): void;
+export function secp256k1_default_illegal_callback_fn(a: number, b: number): void;
+export function secp256k1_default_error_callback_fn(a: number, b: number): void;
+export function __wbg_sha512h_free(a: number): void;
+export function __wbindgen_export_0(a: number, b: number): number;
+export function __wbindgen_add_to_stack_pointer(a: number): number;
+export function __wbindgen_export_1(a: number, b: number, c: number): void;

package/src/ffi/ecash_lib_wasm_bg_nodejs.wasm.d.ts

@@ -0,0 +1,32 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export function sha512h_new(): number;
+export function sha512h_update(a: number, b: number, c: number): void;
+export function sha512h_finalize(a: number, b: number): void;
+export function sha512h_clone(a: number): number;
+export function sha256h_new(): number;
+export function sha256h_update(a: number, b: number, c: number): void;
+export function sha256h_finalize(a: number, b: number): void;
+export function sha256h_clone(a: number): number;
+export function __wbg_sha256h_free(a: number): void;
+export function sha512(a: number, b: number, c: number): void;
+export function sha256d(a: number, b: number, c: number): void;
+export function sha256(a: number, b: number, c: number): void;
+export function shaRmd160(a: number, b: number, c: number): void;
+export function ecc_new(): number;
+export function ecc_derivePubkey(a: number, b: number, c: number, d: number): void;
+export function ecc_ecdsaSign(a: number, b: number, c: number, d: number, e: number, f: number): void;
+export function ecc_schnorrSign(a: number, b: number, c: number, d: number, e: number, f: number): void;
+export function ecc_isValidSeckey(a: number, b: number, c: number): number;
+export function ecc_seckeyAdd(a: number, b: number, c: number, d: number, e: number, f: number): void;
+export function ecc_pubkeyAdd(a: number, b: number, c: number, d: number, e: number, f: number): void;
+export function __wbg_ecc_free(a: number): void;
+export function ecash_secp256k1_context_create(a: number): number;
+export function ecash_secp256k1_context_destroy(a: number): void;
+export function secp256k1_default_illegal_callback_fn(a: number, b: number): void;
+export function secp256k1_default_error_callback_fn(a: number, b: number): void;
+export function __wbg_sha512h_free(a: number): void;
+export function __wbindgen_export_0(a: number, b: number): number;
+export function __wbindgen_add_to_stack_pointer(a: number): number;
+export function __wbindgen_export_1(a: number, b: number, c: number): void;