@knuth/js-wasm 3.0.0 → 4.0.0

package/types/AsyncResults.d.ts

@@ -0,0 +1,11 @@
+// Copyright (c) 2016-present Knuth Project developers.
+// Distributed under the MIT software license, see the accompanying
+// file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+type Conversion = {
+    owned: boolean;
+    adopt: boolean;
+    read: (value: any) => unknown;
+};
+export declare function convertAsyncResults(values: readonly unknown[], conversions: readonly Conversion[]): unknown[];
+export {};

package/types/ListHelper.d.ts

@@ -3,7 +3,7 @@
 // file COPYING or http://www.opensource.org/licenses/mit-license.php.
 
 import { ListNative } from './ListNative';
-export declare function fromNative<T, N, L extends ListNative<N>>(nativeList: L, fromNativeFunc: (nativeItem: N) => T): Array<T>;
+export declare function fromNative<T, N, L extends ListNative<N>>(nativeList: L, fromNativeFunc: (nativeItem: N) => T, releaseElement?: (item: T) => void): Array<T>;
 export declare function toNative<T, N, L extends ListNative<N>>(items: Array<T>, toNativeFunc: (item: T) => N, NativeConstructor: new () => L): L;
 export declare function toNativeCopied<T, N, L extends ListNative<N>>(items: Array<T>, toNativeFunc: (item: T) => N, NativeConstructor: new () => L): L;
 export declare function fromNativePrimitive<T, L extends ListNative<T>>(nativeList: L): Array<T>;
@@ -14,4 +14,4 @@ export interface ListAdapter<T, L> {
 }
 export declare function definePrimitiveList<T, L extends ListNative<T>>(NativeConstructor: new () => L): ListAdapter<T, L>;
 export declare function defineCopiedList<T, N, L extends ListNative<N>>(NativeConstructor: new () => L, readElement: (native: N) => T, writeElement: (item: T) => N): ListAdapter<T, L>;
-export declare function defineBorrowedList<T, N, L extends ListNative<N>>(NativeConstructor: new () => L, readElement: (native: N) => T, writeElement: (item: T) => N): ListAdapter<T, L>;
+export declare function defineBorrowedList<T, N, L extends ListNative<N>>(NativeConstructor: new () => L, readElement: (native: N) => T, writeElement: (item: T) => N, releaseElement?: (item: T) => void): ListAdapter<T, L>;

package/types/PaymentAddress.d.ts

@@ -21,8 +21,8 @@ export declare class PaymentAddress {
     private static parse;
     static fromString(addressStr: string): PaymentAddress | undefined;
     static isValid(addressStr: string): boolean;
-    static fromScript(script: Script, version: number): PaymentAddress;
-    static fromPayPublicKeyHashScript(script: Script, version: number): PaymentAddress;
+    static fromScript(script: Script, version: number): PaymentAddress | undefined;
+    static fromPayPublicKeyHashScript(script: Script, version: number): PaymentAddress | undefined;
     get hash20(): ShortHash;
     get hash32(): Hash;
     get hash(): ShortHash;

package/types/nativeScope.d.ts

@@ -8,3 +8,4 @@ export declare class NativeScope {
     release(): void;
 }
 export declare function withNatives<T>(body: (scope: NativeScope) => T): T;
+export declare function withNativesAsync<T>(body: (scope: NativeScope) => Promise<T>): Promise<T>;

package/types/wasm/callbacks.d.ts

@@ -0,0 +1,30 @@
+// Copyright (c) 2016-present Knuth Project developers.
+// Distributed under the MIT software license, see the accompanying
+// file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export declare class CallbackStatusError extends Error {
+    readonly code: number;
+    constructor(code: number);
+}
+export interface CallbackConversion<T> {
+    take(value: unknown): T;
+    release(value: unknown): void;
+}
+/** One registry per module/executor. The native terminal callback owns completion.
+ * A JS timeout/abort must not release the receiver while C++ still uses it.
+ */
+export declare class CallbackRegistry {
+    private readonly capacity;
+    private readonly pending;
+    private readonly owners;
+    private sequence;
+    constructor(capacity?: number);
+    get size(): number;
+    assertIdle(owner: object): void;
+    invoke<T>(owner: object, start: (id: number, enterNative: () => void) => void): Promise<T>;
+    /** Call enterNative immediately before crossing the native boundary.
+     * Once entered, only terminal completion releases ownership pins/inputs.
+     */
+    invokeWithOwners<T>(receivers: readonly object[], start: (id: number, enterNative: () => void) => void, conversion?: CallbackConversion<T>): Promise<T>;
+    complete(id: number, status: number, value: unknown): boolean;
+}

package/types/wasm/glue.d.ts

@@ -50,7 +50,7 @@ export declare class LibConfig {
     static getEmscriptenVersionTiny(): number;
     static getBuildTimestamp(): number;
 }
-declare const _NetworkIntToKey: readonly ["mainnet", "testnet", "regtest", "testnet4", "scalenet", "chipnet"];
+declare const _NetworkIntToKey: readonly ["mainnet", "testnet", "regtest", "testnet4", "scalenet", "chipnet", "tempnet"];
 export declare type Network = (typeof _NetworkIntToKey)[number];
 export declare function NetworkToInt(value: Network): number;
 export declare function NetworkFromInt(value: number): Network;
@@ -291,10 +291,9 @@ export declare class HdPrivateNative {
 }
 export declare class PaymentAddressNative {
     private readonly [ptrSym];
+    private constructor();
     static _create(ptr: number): PaymentAddressNative;
     protected _destructor(): void;
-    constructor(short_hash: ShortHashNative, version: number);
-    constructor(hash: HashNative, version: number);
     copy(): PaymentAddressNative;
     static cashaddrPrefixFor(net: Network): string;
     static parseFromSimple(address: string): PaymentAddressNative;
@@ -304,6 +303,9 @@ export declare class PaymentAddressNative {
     static fromEcPublic(point: EcPublicNative, version: number): PaymentAddressNative;
     static fromScript(script: ScriptNative, version: number): PaymentAddressNative;
     static fromPayPublicKeyHashScript(script: ScriptNative, version: number): PaymentAddressNative;
+    static fromShorthash(hash: ShortHashNative, version: number): PaymentAddressNative;
+    static fromHash(hash: HashNative, version: number): PaymentAddressNative;
+    static isSupportedVersion(version: number): boolean;
     equals(other: PaymentAddressNative): boolean;
     notEqual(other: PaymentAddressNative): boolean;
     less(x: PaymentAddressNative): boolean;
@@ -869,6 +871,7 @@ export declare class OutputPointNative {
     copy(): OutputPointNative;
     static createNull(): OutputPointNative;
     isMature(height: number): boolean;
+    isMatureWithTicks(ticks: BlockTicksNative, height: number): boolean;
     equals(other: OutputPointNative): boolean;
     notEqual(other: OutputPointNative): boolean;
     less(x: OutputPointNative): boolean;
@@ -988,6 +991,7 @@ export declare class InputNative {
     addresses(): PaymentAddressListNative;
     isFinal(): boolean;
     isLocked(block_height: number, median_time_past: number): boolean;
+    isLockedWithTicks(ticks: BlockTicksNative, block_height: number, median_time_past: number): boolean;
     signatureOperations(bip16: boolean, bip141: boolean): number;
     extractEmbeddedScript(): ScriptNative;
 }
@@ -1085,17 +1089,21 @@ export declare class TransactionNative {
     isNullNonCoinbase(): boolean;
     isOversizedCoinbase(): boolean;
     isMature(height: number): boolean;
+    isMatureWithTicks(ticks: BlockTicksNative, height: number): boolean;
     isInternalDoubleSpend(): boolean;
     isDoubleSpend(include_unconfirmed: boolean): boolean;
     isDusty(minimum_output_value: bigint): boolean;
     isMissingPreviousOutputs(): boolean;
     isFinal(block_height: number, block_time: number): boolean;
+    isFinalWithTicks(ticks: BlockTicksNative, block_height: number, block_time: number): boolean;
     isLocked(block_height: number, median_time_past: number): boolean;
+    isLockedWithTicks(ticks: BlockTicksNative, block_height: number, median_time_past: number): boolean;
     isLocktimeConflict(): boolean;
     isOverspent(): boolean;
     check(max_block_size: number, transaction_pool: boolean, retarget: boolean): number;
     minTxSize(flags: bigint): number;
     accept(flags: bigint, height: number, median_time_past: number, max_sigops: number, is_under_checkpoint: boolean, transaction_pool: boolean, duplicate: boolean): number;
+    acceptWithTicks(ticks: BlockTicksNative, flags: bigint, height: number, median_time_past: number, max_sigops: number, is_under_checkpoint: boolean, transaction_pool: boolean, duplicate: boolean): number;
     isStandardSimple(): boolean;
     isStandard(flags: bigint): boolean;
 }
@@ -1325,6 +1333,21 @@ export declare class ProgramNative {
     closed(): boolean;
     succeeded(): boolean;
 }
+export declare class BlockTicksNative {
+    private readonly [ptrSym];
+    static _create(ptr: number): BlockTicksNative;
+    protected _destructor(): void;
+    constructor();
+    copy(): BlockTicksNative;
+    static activatedAt(activation_height: bigint): BlockTicksNative;
+    heightToTick(height: bigint): bigint;
+    tickToHeight(tick: bigint): bigint;
+    blockInterval(height: bigint): bigint;
+    nextBlockInterval(height: bigint): bigint;
+    nextBlockTick(tip: bigint): bigint;
+    equals(other: BlockTicksNative): boolean;
+    notEqual(other: BlockTicksNative): boolean;
+}
 declare const _RuleForkEnumNativeIntToKey: readonly ["no_rules", "easy_blocks", "bip16_rule", "bip30_rule", "bip34_rule", "bip66_rule", "bip65_rule", "bip90_rule", "allow_collisions", "bip68_rule", "bip112_rule", "bip113_rule", "bch_uahf", "bch_daa_cw144", "bch_pythagoras", "bch_euclid", "bch_pisano", "bch_mersenne", "bch_fermat", "bch_euler", "bch_gauss", "bch_descartes", "bch_lobachevski", "bch_galois", "bch_leibniz", "retarget", "unverified", "bip34_activations", "bip9_bit0_group", "bip9_bit1_group", "all_rules"];
 export declare type RuleForkEnumNative = (typeof _RuleForkEnumNativeIntToKey)[number];
 export declare function RuleForkEnumNativeToInt(value: RuleForkEnumNative): number;

package/types/wasm/mem.d.ts

@@ -25,9 +25,9 @@ declare function allocZeroedSlot(): number;
  */
 declare function takeByteArray(ptr: number, sizePtr: number, release?: (ptr: number) => void): Uint8Array<ArrayBuffer>;
 /** An input byte array must be a non-null Uint8Array (checked before any buffer is allocated). */
-declare function checkBytes(value: Uint8Array, name: string): void;
+declare function checkBytes(value: unknown, name: string): asserts value is Uint8Array;
 /** A fixed-size value struct passed as bytes: exactly `size` bytes, because the C function takes no length. */
-declare function checkFixedBytes(value: Uint8Array, name: string, size: number): void;
+declare function checkFixedBytes(value: unknown, name: string, size: number): asserts value is Uint8Array;
 /** Copy `size` bytes out of native memory. */
 declare function readBytes(ptr: number, size: number): Uint8Array;
 /**