pshenmic-dpp 2.0.0-dev.26 → 2.0.0-dev.27

package/dist/binaries/bindingsTypes.d.ts

@@ -31,6 +31,8 @@ export declare class AddressCreditWithdrawalTransitionNAPI {
     set feeStrategy(jsFeeStrategy: Array<AddressFundsFeeStrategyStepNAPI>);
     set userFeeIncrease(userFeeIncrease: number);
     set inputWitness(jsInputWitnesses: Array<AddressWitnessNAPI>);
+    static estimateMinFee(jsInputCount: number, jsHasChangeOutput: boolean, jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
+    calculateMinRequiredFee(jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     bytes(): Uint8Array;
     hex(): string;
     base64(): string;
@@ -56,6 +58,7 @@ export declare class AddressFundingFromAssetLockTransitionNAPI {
     set feeStrategy(jsFeeStrategy: Array<AddressFundsFeeStrategyStepNAPI>);
     set userFeeIncrease(userFeeIncrease: number);
     set inputWitness(jsInputWitnesses: Array<AddressWitnessNAPI>);
+    calculateMinRequiredFee(jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     bytes(): Uint8Array;
     hex(): string;
     base64(): string;
@@ -84,6 +87,8 @@ export declare class AddressFundsTransferTransitionNAPI {
     set feeStrategy(jsFeeStrategy: Array<AddressFundsFeeStrategyStepNAPI>);
     set userFeeIncrease(userFeeIncrease: number);
     set inputWitness(jsInputWitnesses: Array<AddressWitnessNAPI>);
+    static estimateMinFee(jsInputCount: number, jsOutputCount: number, jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
+    calculateMinRequiredFee(jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     bytes(): Uint8Array;
     hex(): string;
     base64(): string;
@@ -148,6 +153,7 @@ export declare class BatchTransitionNAPI {
     setIdentityContractNonce(nonce: BigIntString): void;
     toStateTransition(): StateTransitionNAPI;
     static fromStateTransition(stateTransition: StateTransitionNAPI): BatchTransitionNAPI;
+    calculateMinRequiredFee(jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     bytes(): Uint8Array;
     hex(): string;
     base64(): string;
@@ -285,6 +291,7 @@ export declare class DataContractCreateTransitionNAPI {
     static fromBytes(bytes: Uint8Array): DataContractCreateTransitionNAPI;
     static fromHex(hex: string): DataContractCreateTransitionNAPI;
     static fromBase64(base64: string): DataContractCreateTransitionNAPI;
+    calculateMinRequiredFee(jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     bytes(): Uint8Array;
     hex(): string;
     base64(): string;
@@ -334,6 +341,7 @@ export declare class DataContractUpdateTransitionNAPI {
     static fromBytes(bytes: Uint8Array): DataContractUpdateTransitionNAPI;
     static fromHex(hex: string): DataContractUpdateTransitionNAPI;
     static fromBase64(base64: string): DataContractUpdateTransitionNAPI;
+    calculateMinRequiredFee(jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     bytes(): Uint8Array;
     hex(): string;
     base64(): string;
@@ -576,6 +584,7 @@ export declare class IdentityCreateFromAddressesTransitionNAPI {
     set feeStrategy(jsFeeStrategy: Array<AddressFundsFeeStrategyStepNAPI>);
     set userFeeIncrease(userFeeIncrease: number);
     set inputWitness(jsInputWitnesses: Array<AddressWitnessNAPI>);
+    calculateMinRequiredFee(jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     bytes(): Uint8Array;
     hex(): string;
     base64(): string;
@@ -626,6 +635,7 @@ export declare class IdentityCreateTransitionNAPI {
     static default(jsPlatformVersion: DynamicValue): IdentityCreateTransitionNAPI;
     static fromHex(hex: string): IdentityCreateTransitionNAPI;
     static fromBase64(base64: string): IdentityCreateTransitionNAPI;
+    calculateMinRequiredFee(jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     bytes(): Uint8Array;
     static fromBytes(bytes: Uint8Array): IdentityCreateTransitionNAPI;
     get publicKeys(): Array<IdentityPublicKeyInCreationNAPI>;
@@ -643,6 +653,7 @@ export declare class IdentityCreateTransitionNAPI {
 }
 export declare class IdentityCreditTransferNAPI {
     constructor(jsSender: IdentifierLikeNAPI, amount: BigIntString, jsRecipient: IdentifierLikeNAPI, nonce: BigIntString, userFeeIncrease?: number | undefined | null);
+    calculateMinRequiredFee(jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     bytes(): Uint8Array;
     hex(): string;
     base64(): string;
@@ -681,6 +692,7 @@ export declare class IdentityCreditTransferToAddressesTransitionNAPI {
     set userFeeIncrease(userFeeIncrease: number);
     set signaturePublicKeyId(keyId: number);
     set signature(signature: Uint8Array);
+    calculateMinRequiredFee(jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     bytes(): Uint8Array;
     hex(): string;
     base64(): string;
@@ -716,6 +728,7 @@ export declare class IdentityCreditWithdrawalTransitionNAPI {
     set signaturePublicKeyId(signaturePublicKeyId: number);
     static fromHex(hex: string): IdentityCreditWithdrawalTransitionNAPI;
     static fromBase64(base64: string): IdentityCreditWithdrawalTransitionNAPI;
+    calculateMinRequiredFee(jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     bytes(): Uint8Array;
     hex(): string;
     base64(): string;
@@ -823,6 +836,7 @@ export declare class IdentityTopUpFromAddressesTransitionNAPI {
     set feeStrategy(jsFeeStrategy: Array<AddressFundsFeeStrategyStepNAPI>);
     set userFeeIncrease(userFeeIncrease: number);
     set inputWitness(jsInputWitnesses: Array<AddressWitnessNAPI>);
+    calculateMinRequiredFee(jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     bytes(): Uint8Array;
     hex(): string;
     base64(): string;
@@ -845,6 +859,7 @@ export declare class IdentityTopUpTransitionNAPI {
     get signature(): Uint8Array;
     getSignableBytes(): Uint8Array;
     set signature(signature: Uint8Array);
+    calculateMinRequiredFee(jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     bytes(): Uint8Array;
     hex(): string;
     base64(): string;
@@ -878,6 +893,7 @@ export declare class IdentityUpdateTransitionNAPI {
     set signaturePublicKeyId(signaturePublicKeyId: number);
     static fromHex(hex: string): IdentityUpdateTransitionNAPI;
     static fromBase64(base64: string): IdentityUpdateTransitionNAPI;
+    calculateMinRequiredFee(jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     bytes(): Uint8Array;
     hex(): string;
     base64(): string;
@@ -936,6 +952,7 @@ export declare class MasternodeVoteTransitionNAPI {
     set signature(signature: Uint8Array);
     static fromHex(hex: string): MasternodeVoteTransitionNAPI;
     static fromBase64(base64: string): MasternodeVoteTransitionNAPI;
+    calculateMinRequiredFee(jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     bytes(): Uint8Array;
     hex(): string;
     base64(): string;
@@ -1039,6 +1056,17 @@ export declare class PlatformAddressInfoNAPI {
 export declare class PlatformAddressNAPI {
     constructor(address: PlatformAddressLikeNAPI);
     bytes(): Uint8Array;
+    /**
+     * Storage fee GroveDB charges for creating balance entries for addresses that are not in
+     * state yet.
+     *
+     * Minimum fees price a transition as if every one of its outputs pays a fresh address, but
+     * the fee actually charged is metered: paying an address that already exists writes no new
+     * bytes and costs (close to) nothing in storage, while every address created costs
+     * `PLATFORM_ADDRESS_STORAGE_BYTES` at the disk rate. Add this to a processing estimate when
+     * you know how many of your outputs are new.
+     */
+    static estimateStorageFeeForNewAddresses(jsAddressCount: number, jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     toAddress(jsNetwork: DynamicValue): string;
     toBech32m(jsNetwork: DynamicValue): string;
     isP2PKH(): boolean;
@@ -1359,6 +1387,15 @@ export declare class StateTransitionNAPI {
     static fromBase64(base64: string): StateTransitionNAPI;
     hash(skipSignature: boolean): string;
     getActionName(): string;
+    /**
+     * The minimum fee the network requires for this transition to be accepted.
+     *
+     * This is the same value the node checks the payer balance against before execution.
+     * The fee actually charged is metered during execution and depends on state (for
+     * example, paying an address that does not exist yet adds storage cost), so it can
+     * be higher than this minimum.
+     */
+    calculateMinRequiredFee(jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     getActionType(): string;
     getActionTypeNumber(): number;
     getOwnerId(): IdentifierNAPI | null;

package/dist/binaries/node.cjs

@@ -3,10 +3,17 @@ const path = require('node:path');
 function isMusl() {
     if (process.platform !== 'linux')
         return false;
-    const report = process.report?.getReport?.();
-    return !report?.header?.glibcVersionRuntime;
+    try {
+        const report = process.report?.getReport?.();
+        return !report?.header?.glibcVersionRuntime;
+    }
+    catch {
+        // getReport() is unavailable in some embedders/worker contexts; assume
+        // glibc, and let the require below fall back to WebAssembly if wrong.
+        return false;
+    }
 }
-function getBinaryPath() {
+function getTarget() {
     const platform = process.platform;
     const arch = process.arch;
     let target = '';
@@ -24,27 +31,41 @@ function getBinaryPath() {
             target = `x86_64-unknown-linux-${libc}`;
         }
     }
-    // else if (platform === 'win32') {
-    //   if (arch === 'arm64') {
-    //     target = 'aarch64-pc-windows-msvc';
-    //   }
-    //   else {
-    //     target = 'x86_64-pc-windows-msvc';
-    //   }
-    // }
+    else if (platform === 'win32') {
+        if (arch === 'arm64') {
+            target = 'aarch64-pc-windows-msvc';
+        }
+        else {
+            target = 'x86_64-pc-windows-msvc';
+        }
+    }
     else {
         console.error(`Unsupported platform: ${platform} ${arch}. Using WebAssembly instead Node-API`);
         return null;
     }
-    console.log(`running on native dpp (${target})`);
-    return path.join('native', target, 'pshenmic_dpp.node');
-}
-const binaryPath = getBinaryPath();
-let exportedModule;
-if (binaryPath !== null) {
-    exportedModule = require(`./${binaryPath}`);
+    return target;
 }
-else {
-    exportedModule = require('./wasmCreation.cjs');
+// The native addon can be unusable even on a supported platform: the binary may
+// be missing from the package, built for another libc/arch, or fail to link
+// against a system dependency (e.g. the VC++ runtime on Windows). None of that
+// should be fatal — WebAssembly is a complete fallback, so any load failure
+// degrades to it instead of taking the whole import down.
+function loadNative() {
+    const target = getTarget();
+    if (target === null) {
+        return null;
+    }
+    try {
+        const nativeModule = require(`./${path.join('native', target, 'pshenmic_dpp.node')}`);
+        console.log(`running on native dpp (${target})`);
+        return nativeModule;
+    }
+    catch (error) {
+        // Only the first line: node appends a multi-line "Require stack" to
+        // MODULE_NOT_FOUND messages, which buries the actual reason.
+        const reason = String(error?.message ?? error).split('\n')[0];
+        console.error(`Failed to load native dpp (${target}): ${reason}. Using WebAssembly instead Node-API`);
+        return null;
+    }
 }
-module.exports = exportedModule;
+module.exports = loadNative() ?? require('./wasmCreation.cjs');

package/dist/binaries/node.d.cts

@@ -1,2 +1,2 @@
-export = exportedModule;
-declare let exportedModule: any;
+declare const _exports: any;
+export = _exports;