pshenmic-dpp 2.0.0-dev.25 → 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;
@@ -617,6 +626,7 @@ export declare class IdentityCreateFromShieldedPoolTransitionNAPI {
     set bindingsSignature(jsBindingsSignature: Uint8Array);
     set sendToAddressOnCreationFailure(jsAddress: PlatformAddressLikeNAPI);
     set identityId(jsId: IdentifierLikeNAPI);
+    static computeMinimumFee(jsNumActions: number, jsNumKeys: number, jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     toStateTransition(): StateTransitionNAPI;
     static fromStateTransition(st: StateTransitionNAPI): IdentityCreateFromShieldedPoolTransitionNAPI;
 }
@@ -625,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>;
@@ -642,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;
@@ -680,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;
@@ -715,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;
@@ -822,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;
@@ -844,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;
@@ -877,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;
@@ -935,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;
@@ -1038,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;
@@ -1254,6 +1283,7 @@ export declare class ShieldedTransferTransitionNAPI {
     set anchor(jsAnchor: Uint8Array);
     set proof(proof: Uint8Array);
     set bindingsSignature(jsBindingsSignature: Uint8Array);
+    static computeMinimumFee(jsNumActions: number, jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     toStateTransition(): StateTransitionNAPI;
     static fromStateTransition(st: StateTransitionNAPI): ShieldedTransferTransitionNAPI;
 }
@@ -1284,6 +1314,7 @@ export declare class ShieldedWithdrawalTransitionNAPI {
     set coreFeePerByte(coreFeePerByte: number);
     set pooling(jsPooling: DynamicValue);
     set outputScript(outputScript: CoreScriptNAPI);
+    static computeMinimumFee(jsNumActions: number, jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     toStateTransition(): StateTransitionNAPI;
     static fromStateTransition(st: StateTransitionNAPI): ShieldedWithdrawalTransitionNAPI;
 }
@@ -1305,6 +1336,7 @@ export declare class ShieldFromAssetLockTransitionNAPI {
     set bindingsSignature(jsBindingsSignature: Uint8Array);
     set surplusOutput(jsSurplusOutput: PlatformAddressLikeNAPI | undefined | null);
     set signature(signature: Uint8Array);
+    static computeMinimumFee(jsNumActions: number, jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     toStateTransition(): StateTransitionNAPI;
     static fromStateTransition(st: StateTransitionNAPI): ShieldFromAssetLockTransitionNAPI;
 }
@@ -1328,6 +1360,7 @@ export declare class ShieldTransitionNAPI {
     set feeStrategy(feeStrategy: Array<AddressFundsFeeStrategyStepNAPI>);
     set userFeeIncrease(userFeeIncrease: number);
     set inputWitnesses(jsInputWitnesses: Array<AddressWitnessNAPI>);
+    static computeMinimumFee(jsNumActions: number, jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     toStateTransition(): StateTransitionNAPI;
     static fromStateTransition(st: StateTransitionNAPI): ShieldTransitionNAPI;
 }
@@ -1354,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;
@@ -1755,6 +1797,7 @@ export declare class UnshieldTransitionNAPI {
     set anchor(jsAnchor: Uint8Array);
     set proof(proof: Uint8Array);
     set bindingsSignature(jsBindingsSignature: Uint8Array);
+    static computeMinimumFee(jsNumActions: number, jsPlatformVersion?: PlatformVersionNAPI | undefined | null): BigIntString;
     toStateTransition(): StateTransitionNAPI;
     static fromStateTransition(st: StateTransitionNAPI): UnshieldTransitionNAPI;
 }
@@ -1878,6 +1921,12 @@ export declare class VerifiedShieldedPoolStateNAPI {
 export declare class VerifiedStateTransitionResultNAPI {
     rootHash: Uint8Array;
     get result(): DataContractNAPI | IdentityNAPI | IdentifierNAPI | VerifiedIdentityBalanceNAPI | VerifiedIdentityTokenInfoNAPI | VerifiedTokenPricingScheduleNAPI | TokenStatusNAPI | Array<VerifiedIdentityBalanceNAPI> | PartialIdentityNAPI | VerifiedBalanceTransferNAPI | Array<VerifiedDocumentNAPI> | DocumentNAPI | VerifiedTokenGroupActionWithDocumentNAPI | VerifiedTokenGroupActionWithTokenBalanceNAPI | VerifiedTokenGroupActionWithTokenIdentityInfoNAPI | VerifiedTokenGroupActionWithTokenPricingScheduleNAPI | VoteNAPI | Array<PlatformAddressInfoNAPI> | VerifiedIdentityFullWithAddressInfosNAPI | VerifiedIdentityWithAddressInfosNAPI | StoredAssetLockInfoNAPI | Array<[Uint8Array, boolean]> | [Array<[Uint8Array, boolean]>, Array<PlatformAddressInfoNAPI>] | [Array<[Uint8Array, boolean]>, Array<VerifiedDocumentNAPI>] | [StoredAssetLockInfoNAPI, Array<PlatformAddressInfoNAPI>] | [IdentityNAPI, Array<[Uint8Array, boolean]>];
+    /**
+     * Whether the proof binds the execution of this specific state transition.
+     * When false the result is a height-pinned snapshot of the affected state,
+     * not evidence that the transition executed.
+     */
+    get isExecutionProved(): boolean;
 }
 export declare class VerifiedTokenBalancesForIdentitiesNAPI {
     rootHash: Uint8Array;
@@ -2108,7 +2157,8 @@ export declare enum PlatformVersionNAPI {
     PLATFORM_V9 = 9,
     PLATFORM_V10 = 10,
     PLATFORM_V11 = 11,
-    PLATFORM_V12 = 12
+    PLATFORM_V12 = 12,
+    PLATFORM_V13 = 13
 }
 export declare enum PoolingNAPI {
     Never = 0,

package/dist/binaries/bindingsTypes.js

@@ -58,6 +58,7 @@ export var PlatformVersionNAPI;
     PlatformVersionNAPI[PlatformVersionNAPI["PLATFORM_V10"] = 10] = "PLATFORM_V10";
     PlatformVersionNAPI[PlatformVersionNAPI["PLATFORM_V11"] = 11] = "PLATFORM_V11";
     PlatformVersionNAPI[PlatformVersionNAPI["PLATFORM_V12"] = 12] = "PLATFORM_V12";
+    PlatformVersionNAPI[PlatformVersionNAPI["PLATFORM_V13"] = 13] = "PLATFORM_V13";
 })(PlatformVersionNAPI || (PlatformVersionNAPI = {}));
 export var PoolingNAPI;
 (function (PoolingNAPI) {

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;