@midnight-ntwrk/midnight-js-types 3.0.0 → 3.1.0

package/dist/errors.d.ts

@@ -10,4 +10,42 @@ export declare class InvalidProtocolSchemeError extends Error {
      */
     constructor(invalidScheme: string, allowableSchemes: string[]);
 }
+/**
+ * An error thrown when exporting private states fails.
+ */
+export declare class PrivateStateExportError extends Error {
+    constructor(message: string);
+}
+/**
+ * Cause types for private state import errors.
+ */
+export type PrivateStateImportErrorCause = 'decryption_failed' | 'invalid_format' | 'conflict' | 'unknown';
+/**
+ * Base error thrown when importing private states fails.
+ */
+export declare class PrivateStateImportError extends Error {
+    readonly cause?: PrivateStateImportErrorCause | undefined;
+    constructor(message: string, cause?: PrivateStateImportErrorCause | undefined);
+}
+/**
+ * Error thrown when decryption of export data fails.
+ * This could be due to wrong password, corrupted data, or tampered content.
+ * The specific cause is intentionally not disclosed to prevent oracle attacks.
+ */
+export declare class ExportDecryptionError extends PrivateStateImportError {
+    constructor();
+}
+/**
+ * Error thrown when the export data format is invalid.
+ */
+export declare class InvalidExportFormatError extends PrivateStateImportError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when import conflicts with existing data and conflictStrategy is 'error'.
+ */
+export declare class ImportConflictError extends PrivateStateImportError {
+    readonly conflictCount: number;
+    constructor(conflictCount: number);
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAeA;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;aAMjC,aAAa,EAAE,MAAM;aACrB,gBAAgB,EAAE,MAAM,EAAE;IAN5C;;;OAGG;gBAEe,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,EAAE;CAI7C"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAeA;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;aAMjC,aAAa,EAAE,MAAM;aACrB,gBAAgB,EAAE,MAAM,EAAE;IAN5C;;;OAGG;gBAEe,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,EAAE;CAI7C;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,MAAM,MAAM,4BAA4B,GACpC,mBAAmB,GACnB,gBAAgB,GAChB,UAAU,GACV,SAAS,CAAC;AAEd;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;aAG9B,KAAK,CAAC,EAAE,4BAA4B;gBADpD,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,4BAA4B,YAAA;CAKvD;AAED;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,uBAAuB;;CAQjE;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,uBAAuB;gBACvD,OAAO,SAA0B;CAI9C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,uBAAuB;aAClC,aAAa,EAAE,MAAM;gBAArB,aAAa,EAAE,MAAM;CAOlD"}

package/dist/index.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var effect$1 = require('@midnight-ntwrk/compact-js/effect');
+var effect = require('@midnight-ntwrk/compact-js/effect');
 var platformJs = require('@midnight-ntwrk/platform-js');
 var Configuration = require('@midnight-ntwrk/platform-js/effect/Configuration');
-var effect = require('effect');
+var effect$1 = require('effect');
 var ledgerV7 = require('@midnight-ntwrk/ledger-v7');
 
 function _interopNamespaceDefault(e) {
@@ -48,21 +48,21 @@ var Configuration__namespace = /*#__PURE__*/_interopNamespaceDefault(Configurati
  *
  * @internal
  */
-const makeAdaptedReader = (zkConfigProvider) => (compiledContract) => effect.Effect.gen(function* () {
+const makeAdaptedReader = (zkConfigProvider) => (compiledContract) => effect$1.Effect.gen(function* () {
     // TODO: Consider implementing the logic used in Compact.js (look at the contract manifest to determine
     // if the circuit is verifiable). See PM-21376.
-    const getVerifierKey = (impureCircuitId) => effect.Effect.tryPromise({
-        try: () => zkConfigProvider.getVerifierKey(impureCircuitId).then((verifierKey) => effect.Option.some(effect$1.Contract.VerifierKey(verifierKey))),
-        catch: (err) => effect$1.ZKConfigurationReadError.make(compiledContract.tag, impureCircuitId, 'verifier-key', err)
+    const getVerifierKey = (impureCircuitId) => effect$1.Effect.tryPromise({
+        try: () => zkConfigProvider.getVerifierKey(impureCircuitId).then((verifierKey) => effect$1.Option.some(effect.Contract.VerifierKey(verifierKey))),
+        catch: (err) => effect.ZKConfigurationReadError.make(compiledContract.tag, impureCircuitId, 'verifier-key', err)
     });
     return {
         getVerifierKey,
-        getVerifierKeys: (impureCircuitIds) => effect.Effect.forEach(impureCircuitIds, (impureCircuitId) => getVerifierKey(impureCircuitId).pipe(effect.Effect.map((verifierKey) => [impureCircuitId, verifierKey])), { concurrency: 'unbounded', discard: false })
+        getVerifierKeys: (impureCircuitIds) => effect$1.Effect.forEach(impureCircuitIds, (impureCircuitId) => getVerifierKey(impureCircuitId).pipe(effect$1.Effect.map((verifierKey) => [impureCircuitId, verifierKey])), { concurrency: 'unbounded', discard: false })
     };
 });
-const makeAdaptedRuntimeLayer = (zkConfigProvider, configMap) => effect.Layer.mergeAll(effect.Layer.succeed(effect$1.ZKConfiguration.ZKConfiguration, effect$1.ZKConfiguration.ZKConfiguration.of({
+const makeAdaptedRuntimeLayer = (zkConfigProvider, configMap) => effect$1.Layer.mergeAll(effect$1.Layer.succeed(effect.ZKConfiguration.ZKConfiguration, effect.ZKConfiguration.ZKConfiguration.of({
     createReader: makeAdaptedReader(zkConfigProvider)
-})), Configuration__namespace.layer).pipe(effect.Layer.provide(effect.Layer.setConfigProvider(effect.ConfigProvider.fromMap(configMap, { pathDelim: '_' }).pipe(effect.ConfigProvider.constantCase))));
+})), Configuration__namespace.layer).pipe(effect$1.Layer.provide(effect$1.Layer.setConfigProvider(effect$1.ConfigProvider.fromMap(configMap, { pathDelim: '_' }).pipe(effect$1.ConfigProvider.constantCase))));
 /**
  * Constructs an Effect managed runtime configured to execute contract executables.
  *
@@ -75,7 +75,7 @@ const makeContractExecutableRuntime = (zkConfigProvider, options) => {
     if (options.signingKey) {
         config = config.concat([['KEYS_SIGNING', options.signingKey]]);
     }
-    return effect$1.ContractExecutableRuntime.make(makeAdaptedRuntimeLayer(zkConfigProvider, new Map(config)));
+    return effect.ContractExecutableRuntime.make(makeAdaptedRuntimeLayer(zkConfigProvider, new Map(config)));
 };
 /**
  * Unwraps an Effect `Exit` instance, returning its value if it is successful, or throwing the error contained
@@ -84,12 +84,12 @@ const makeContractExecutableRuntime = (zkConfigProvider, options) => {
  * @param exit The source Effect `Exit` instance.
  * @returns The value from `exit` if it is successful, otherwise throws the error contained within it.
  */
-const exitResultOrError = (exit) => effect.Exit.match(exit, {
+const exitResultOrError = (exit) => effect$1.Exit.match(exit, {
     onSuccess: (a) => a,
     onFailure: (cause) => {
-        if (effect.Cause.isFailType(cause))
+        if (effect$1.Cause.isFailType(cause))
             throw cause.error;
-        throw new Error(`Unexpected error: ${effect.Cause.pretty(cause)}`);
+        throw new Error(`Unexpected error: ${effect$1.Cause.pretty(cause)}`);
     }
 });
 /**
@@ -99,7 +99,7 @@ const exitResultOrError = (exit) => effect.Exit.match(exit, {
  * @returns An `Option.some` for `obj`.
  */
 const asEffectOption = (obj) => {
-    return effect.Option.some(obj);
+    return effect$1.Option.some(obj);
 };
 /**
  * Constructs a branded contract address from a given string value.
@@ -139,6 +139,57 @@ class InvalidProtocolSchemeError extends Error {
         this.allowableSchemes = allowableSchemes;
     }
 }
+/**
+ * An error thrown when exporting private states fails.
+ */
+class PrivateStateExportError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PrivateStateExportError';
+    }
+}
+/**
+ * Base error thrown when importing private states fails.
+ */
+class PrivateStateImportError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'PrivateStateImportError';
+    }
+}
+/**
+ * Error thrown when decryption of export data fails.
+ * This could be due to wrong password, corrupted data, or tampered content.
+ * The specific cause is intentionally not disclosed to prevent oracle attacks.
+ */
+class ExportDecryptionError extends PrivateStateImportError {
+    constructor() {
+        super('Failed to decrypt export data. The password may be incorrect or the data may be corrupted.', 'decryption_failed');
+        this.name = 'ExportDecryptionError';
+    }
+}
+/**
+ * Error thrown when the export data format is invalid.
+ */
+class InvalidExportFormatError extends PrivateStateImportError {
+    constructor(message = 'Invalid export format') {
+        super(message, 'invalid_format');
+        this.name = 'InvalidExportFormatError';
+    }
+}
+/**
+ * Error thrown when import conflicts with existing data and conflictStrategy is 'error'.
+ */
+class ImportConflictError extends PrivateStateImportError {
+    conflictCount;
+    constructor(conflictCount) {
+        super(`Import conflicts with ${conflictCount} existing private state${conflictCount === 1 ? '' : 's'}`, 'conflict');
+        this.conflictCount = conflictCount;
+        this.name = 'ImportConflictError';
+    }
+}
 
 /*
  * This file is part of midnight-js.
@@ -248,6 +299,26 @@ const FailFallible = 'FailFallible';
  */
 const SucceedEntirely = 'SucceedEntirely';
 
+/*
+ * This file is part of midnight-js.
+ * Copyright (C) 2025 Midnight Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Maximum number of states that can be exported/imported.
+ * This limit prevents memory exhaustion attacks.
+ */
+const MAX_EXPORT_STATES = 10000;
+
 /*
  * This file is part of midnight-js.
  * Copyright (C) 2025 Midnight Foundation
@@ -301,9 +372,15 @@ Object.defineProperty(exports, "Transaction", {
     enumerable: true,
     get: function () { return ledgerV7.Transaction; }
 });
+exports.ExportDecryptionError = ExportDecryptionError;
 exports.FailEntirely = FailEntirely;
 exports.FailFallible = FailFallible;
+exports.ImportConflictError = ImportConflictError;
+exports.InvalidExportFormatError = InvalidExportFormatError;
 exports.InvalidProtocolSchemeError = InvalidProtocolSchemeError;
+exports.MAX_EXPORT_STATES = MAX_EXPORT_STATES;
+exports.PrivateStateExportError = PrivateStateExportError;
+exports.PrivateStateImportError = PrivateStateImportError;
 exports.SegmentFail = SegmentFail;
 exports.SegmentSuccess = SegmentSuccess;
 exports.SucceedEntirely = SucceedEntirely;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/contract.ts","../src/errors.ts","../src/logger-provider.ts","../src/midnight-types.ts","../src/zk-config-provider.ts"],"sourcesContent":[null,null,null,null,null],"names":["Effect","Option","Contract","ZKConfigurationReadError","Layer","ZKConfiguration","Configuration","ConfigProvider","ContractExecutableRuntime","Exit","Cause","ContractAddress","LogLevel"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../src/contract.ts","../src/errors.ts","../src/logger-provider.ts","../src/midnight-types.ts","../src/private-state-provider.ts","../src/zk-config-provider.ts"],"sourcesContent":[null,null,null,null,null,null],"names":["Effect","Option","Contract","ZKConfigurationReadError","Layer","ZKConfiguration","Configuration","ConfigProvider","ContractExecutableRuntime","Exit","Cause","ContractAddress","LogLevel"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 import { ContractExecutable } from '@midnight-ntwrk/compact-js/effect';
 import { ContractAddress as ContractAddress$1 } from '@midnight-ntwrk/platform-js';
-import { ConfigError, Exit, Option } from 'effect';
+import { Option, Exit, ConfigError } from 'effect';
 import { ManagedRuntime } from 'effect/ManagedRuntime';
-import { ContractAddress, IntentHash, RawTokenType, Transaction, SignatureEnabled, Proof, Binding, TransactionId, TransactionHash, FinalizedTransaction, PreBinding, UnprovenTransaction, ZswapChainState, CoinPublicKey, EncPublicKey } from '@midnight-ntwrk/ledger-v7';
+import { Transaction, SignatureEnabled, Proof, Binding, TransactionId, TransactionHash, ContractAddress, IntentHash, RawTokenType, FinalizedTransaction, UnprovenTransaction, PreBinding, ZswapChainState, CoinPublicKey, EncPublicKey } from '@midnight-ntwrk/ledger-v7';
 export { Transaction } from '@midnight-ntwrk/ledger-v7';
 import { LogFn } from 'pino';
 import { ContractAddress as ContractAddress$2, SigningKey, ContractState } from '@midnight-ntwrk/compact-runtime';
@@ -356,6 +356,44 @@ declare class InvalidProtocolSchemeError extends Error {
      */
     constructor(invalidScheme: string, allowableSchemes: string[]);
 }
+/**
+ * An error thrown when exporting private states fails.
+ */
+declare class PrivateStateExportError extends Error {
+    constructor(message: string);
+}
+/**
+ * Cause types for private state import errors.
+ */
+type PrivateStateImportErrorCause = 'decryption_failed' | 'invalid_format' | 'conflict' | 'unknown';
+/**
+ * Base error thrown when importing private states fails.
+ */
+declare class PrivateStateImportError extends Error {
+    readonly cause?: PrivateStateImportErrorCause | undefined;
+    constructor(message: string, cause?: PrivateStateImportErrorCause | undefined);
+}
+/**
+ * Error thrown when decryption of export data fails.
+ * This could be due to wrong password, corrupted data, or tampered content.
+ * The specific cause is intentionally not disclosed to prevent oracle attacks.
+ */
+declare class ExportDecryptionError extends PrivateStateImportError {
+    constructor();
+}
+/**
+ * Error thrown when the export data format is invalid.
+ */
+declare class InvalidExportFormatError extends PrivateStateImportError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when import conflicts with existing data and conflictStrategy is 'error'.
+ */
+declare class ImportConflictError extends PrivateStateImportError {
+    readonly conflictCount: number;
+    constructor(conflictCount: number);
+}
 
 /**
  * A valid named log level.
@@ -403,6 +441,90 @@ interface MidnightProvider {
  * A type representing an ID used to store a contract's private state.
  */
 type PrivateStateId = string;
+/**
+ * Represents the exported private state data structure.
+ * All metadata is included in the encrypted payload to prevent tampering.
+ */
+interface PrivateStateExport {
+    /**
+     * Format identifier. Must be 'midnight-private-state-export'.
+     */
+    readonly format: 'midnight-private-state-export';
+    /**
+     * Encrypted payload containing version, metadata, and serialized private states.
+     * Format: base64-encoded AES-256-GCM encrypted JSON.
+     */
+    readonly encryptedPayload: string;
+    /**
+     * Salt used for key derivation (hex-encoded, 32 bytes / 64 characters).
+     * Required for decryption with the export password.
+     */
+    readonly salt: string;
+}
+/**
+ * Maximum number of states that can be exported/imported.
+ * This limit prevents memory exhaustion attacks.
+ */
+declare const MAX_EXPORT_STATES = 10000;
+/**
+ * Options for exporting private states.
+ */
+interface ExportPrivateStatesOptions {
+    /**
+     * Password used to encrypt the export.
+     * Must be at least 16 characters.
+     * If not provided, uses the storage password.
+     */
+    readonly password?: string;
+    /**
+     * Maximum number of states to export.
+     * Defaults to MAX_EXPORT_STATES (10000).
+     * Set to a lower value to limit memory usage.
+     */
+    readonly maxStates?: number;
+}
+/**
+ * Options for importing private states.
+ */
+interface ImportPrivateStatesOptions {
+    /**
+     * Password used to decrypt the import.
+     * Must match the password used during export.
+     * If not provided, uses the storage password.
+     */
+    readonly password?: string;
+    /**
+     * How to handle conflicts when a private state ID already exists.
+     * - 'skip': Keep existing state, ignore imported state
+     * - 'overwrite': Replace existing state with imported state
+     * - 'error': Throw an error if any conflict is detected
+     * Default: 'error'
+     */
+    readonly conflictStrategy?: 'skip' | 'overwrite' | 'error';
+    /**
+     * Maximum number of states to import.
+     * Defaults to MAX_EXPORT_STATES (10000).
+     * Set to a lower value to limit memory usage.
+     */
+    readonly maxStates?: number;
+}
+/**
+ * Result of an import operation.
+ */
+interface ImportPrivateStatesResult {
+    /**
+     * Number of states successfully imported.
+     */
+    readonly imported: number;
+    /**
+     * Number of states skipped due to conflicts (when conflictStrategy is 'skip').
+     */
+    readonly skipped: number;
+    /**
+     * Number of states that overwrote existing states (when conflictStrategy is 'overwrite').
+     */
+    readonly overwritten: number;
+}
 /**
  * Interface for a typed key-valued store containing contract private states.
  *
@@ -410,6 +532,14 @@ type PrivateStateId = string;
  * @typeParam PS - Parameter indicating the private state type stored, sometimes a union of private state types.
  */
 interface PrivateStateProvider<PSI extends PrivateStateId = PrivateStateId, PS = any> {
+    /**
+     * Set the contract address for scoping private state operations.
+     * Must be called before any get/set/remove operations on private states.
+     * This provides namespace isolation between different contracts.
+     *
+     * @param address The contract address to scope operations to.
+     */
+    setContractAddress(address: ContractAddress$2): void;
     /**
      * Store the given private state at the given private state ID.
      *
@@ -456,6 +586,27 @@ interface PrivateStateProvider<PSI extends PrivateStateId = PrivateStateId, PS =
      * Remove all contract signing keys.
      */
     clearSigningKeys(): Promise<void>;
+    /**
+     * Export all private states as an encrypted JSON-serializable structure.
+     *
+     * NOTE: This does NOT export signing keys for security reasons.
+     *
+     * @param options Export options including optional custom password and state limit.
+     * @returns A JSON-serializable export structure that can be saved or transmitted.
+     * @throws {PrivateStateExportError} If no states exist to export or limit exceeded.
+     */
+    exportPrivateStates(options?: ExportPrivateStatesOptions): Promise<PrivateStateExport>;
+    /**
+     * Import private states from a previously exported structure.
+     *
+     * @param exportData The export data structure to import.
+     * @param options Import options including password, conflict strategy, and state limit.
+     * @returns Result indicating how many states were imported/skipped/overwritten.
+     * @throws {ExportDecryptionError} If decryption fails (wrong password or corrupted data).
+     * @throws {InvalidExportFormatError} If the export format is invalid or unsupported.
+     * @throws {ImportConflictError} If conflictStrategy is 'error' and conflicts exist.
+     */
+    importPrivateStates(exportData: PrivateStateExport, options?: ImportPrivateStatesOptions): Promise<ImportPrivateStatesResult>;
 }
 
 type UnboundTransaction = Transaction<SignatureEnabled, Proof, PreBinding>;
@@ -695,5 +846,5 @@ interface MidnightProviders<ICK extends Contract.ImpureCircuitId<Contract.Any> =
     readonly loggerProvider?: LoggerProvider;
 }
 
-export { FailEntirely, FailFallible, InvalidProtocolSchemeError, LogLevel, SegmentFail, SegmentSuccess, SucceedEntirely, ZKConfigProvider, asContractAddress, asEffectOption, createProverKey, createVerifierKey, createZKIR, exitResultOrError, makeContractExecutableRuntime, zkConfigToProvingKeyMaterial };
-export type { All, BlockHash, BlockHashConfig, BlockHeightConfig, ContractExecutableRuntimeOptions, ContractStateObservableConfig, Fees, FinalizedTxData, KeyMaterialProvider, Latest, LoggerProvider, MidnightProvider, MidnightProviders, PrivateStateId, PrivateStateProvider, ProofProvider, ProveTxConfig, ProverKey, PublicDataProvider, SegmentStatus, TxIdConfig, TxStatus, UnboundTransaction, UnshieldedBalance, UnshieldedBalances, UnshieldedUtxo, UnshieldedUtxos, VerifierKey, WalletProvider, ZKConfig, ZKIR };
+export { ExportDecryptionError, FailEntirely, FailFallible, ImportConflictError, InvalidExportFormatError, InvalidProtocolSchemeError, LogLevel, MAX_EXPORT_STATES, PrivateStateExportError, PrivateStateImportError, SegmentFail, SegmentSuccess, SucceedEntirely, ZKConfigProvider, asContractAddress, asEffectOption, createProverKey, createVerifierKey, createZKIR, exitResultOrError, makeContractExecutableRuntime, zkConfigToProvingKeyMaterial };
+export type { All, BlockHash, BlockHashConfig, BlockHeightConfig, ContractExecutableRuntimeOptions, ContractStateObservableConfig, ExportPrivateStatesOptions, Fees, FinalizedTxData, ImportPrivateStatesOptions, ImportPrivateStatesResult, KeyMaterialProvider, Latest, LoggerProvider, MidnightProvider, MidnightProviders, PrivateStateExport, PrivateStateId, PrivateStateImportErrorCause, PrivateStateProvider, ProofProvider, ProveTxConfig, ProverKey, PublicDataProvider, SegmentStatus, TxIdConfig, TxStatus, UnboundTransaction, UnshieldedBalance, UnshieldedBalances, UnshieldedUtxo, UnshieldedUtxos, VerifierKey, WalletProvider, ZKConfig, ZKIR };

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 import { ContractExecutable } from '@midnight-ntwrk/compact-js/effect';
 import { ContractAddress as ContractAddress$1 } from '@midnight-ntwrk/platform-js';
-import { ConfigError, Exit, Option } from 'effect';
+import { Option, Exit, ConfigError } from 'effect';
 import { ManagedRuntime } from 'effect/ManagedRuntime';
-import { ContractAddress, IntentHash, RawTokenType, Transaction, SignatureEnabled, Proof, Binding, TransactionId, TransactionHash, FinalizedTransaction, PreBinding, UnprovenTransaction, ZswapChainState, CoinPublicKey, EncPublicKey } from '@midnight-ntwrk/ledger-v7';
+import { Transaction, SignatureEnabled, Proof, Binding, TransactionId, TransactionHash, ContractAddress, IntentHash, RawTokenType, FinalizedTransaction, UnprovenTransaction, PreBinding, ZswapChainState, CoinPublicKey, EncPublicKey } from '@midnight-ntwrk/ledger-v7';
 export { Transaction } from '@midnight-ntwrk/ledger-v7';
 import { LogFn } from 'pino';
 import { ContractAddress as ContractAddress$2, SigningKey, ContractState } from '@midnight-ntwrk/compact-runtime';
@@ -356,6 +356,44 @@ declare class InvalidProtocolSchemeError extends Error {
      */
     constructor(invalidScheme: string, allowableSchemes: string[]);
 }
+/**
+ * An error thrown when exporting private states fails.
+ */
+declare class PrivateStateExportError extends Error {
+    constructor(message: string);
+}
+/**
+ * Cause types for private state import errors.
+ */
+type PrivateStateImportErrorCause = 'decryption_failed' | 'invalid_format' | 'conflict' | 'unknown';
+/**
+ * Base error thrown when importing private states fails.
+ */
+declare class PrivateStateImportError extends Error {
+    readonly cause?: PrivateStateImportErrorCause | undefined;
+    constructor(message: string, cause?: PrivateStateImportErrorCause | undefined);
+}
+/**
+ * Error thrown when decryption of export data fails.
+ * This could be due to wrong password, corrupted data, or tampered content.
+ * The specific cause is intentionally not disclosed to prevent oracle attacks.
+ */
+declare class ExportDecryptionError extends PrivateStateImportError {
+    constructor();
+}
+/**
+ * Error thrown when the export data format is invalid.
+ */
+declare class InvalidExportFormatError extends PrivateStateImportError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when import conflicts with existing data and conflictStrategy is 'error'.
+ */
+declare class ImportConflictError extends PrivateStateImportError {
+    readonly conflictCount: number;
+    constructor(conflictCount: number);
+}
 
 /**
  * A valid named log level.
@@ -403,6 +441,90 @@ interface MidnightProvider {
  * A type representing an ID used to store a contract's private state.
  */
 type PrivateStateId = string;
+/**
+ * Represents the exported private state data structure.
+ * All metadata is included in the encrypted payload to prevent tampering.
+ */
+interface PrivateStateExport {
+    /**
+     * Format identifier. Must be 'midnight-private-state-export'.
+     */
+    readonly format: 'midnight-private-state-export';
+    /**
+     * Encrypted payload containing version, metadata, and serialized private states.
+     * Format: base64-encoded AES-256-GCM encrypted JSON.
+     */
+    readonly encryptedPayload: string;
+    /**
+     * Salt used for key derivation (hex-encoded, 32 bytes / 64 characters).
+     * Required for decryption with the export password.
+     */
+    readonly salt: string;
+}
+/**
+ * Maximum number of states that can be exported/imported.
+ * This limit prevents memory exhaustion attacks.
+ */
+declare const MAX_EXPORT_STATES = 10000;
+/**
+ * Options for exporting private states.
+ */
+interface ExportPrivateStatesOptions {
+    /**
+     * Password used to encrypt the export.
+     * Must be at least 16 characters.
+     * If not provided, uses the storage password.
+     */
+    readonly password?: string;
+    /**
+     * Maximum number of states to export.
+     * Defaults to MAX_EXPORT_STATES (10000).
+     * Set to a lower value to limit memory usage.
+     */
+    readonly maxStates?: number;
+}
+/**
+ * Options for importing private states.
+ */
+interface ImportPrivateStatesOptions {
+    /**
+     * Password used to decrypt the import.
+     * Must match the password used during export.
+     * If not provided, uses the storage password.
+     */
+    readonly password?: string;
+    /**
+     * How to handle conflicts when a private state ID already exists.
+     * - 'skip': Keep existing state, ignore imported state
+     * - 'overwrite': Replace existing state with imported state
+     * - 'error': Throw an error if any conflict is detected
+     * Default: 'error'
+     */
+    readonly conflictStrategy?: 'skip' | 'overwrite' | 'error';
+    /**
+     * Maximum number of states to import.
+     * Defaults to MAX_EXPORT_STATES (10000).
+     * Set to a lower value to limit memory usage.
+     */
+    readonly maxStates?: number;
+}
+/**
+ * Result of an import operation.
+ */
+interface ImportPrivateStatesResult {
+    /**
+     * Number of states successfully imported.
+     */
+    readonly imported: number;
+    /**
+     * Number of states skipped due to conflicts (when conflictStrategy is 'skip').
+     */
+    readonly skipped: number;
+    /**
+     * Number of states that overwrote existing states (when conflictStrategy is 'overwrite').
+     */
+    readonly overwritten: number;
+}
 /**
  * Interface for a typed key-valued store containing contract private states.
  *
@@ -410,6 +532,14 @@ type PrivateStateId = string;
  * @typeParam PS - Parameter indicating the private state type stored, sometimes a union of private state types.
  */
 interface PrivateStateProvider<PSI extends PrivateStateId = PrivateStateId, PS = any> {
+    /**
+     * Set the contract address for scoping private state operations.
+     * Must be called before any get/set/remove operations on private states.
+     * This provides namespace isolation between different contracts.
+     *
+     * @param address The contract address to scope operations to.
+     */
+    setContractAddress(address: ContractAddress$2): void;
     /**
      * Store the given private state at the given private state ID.
      *
@@ -456,6 +586,27 @@ interface PrivateStateProvider<PSI extends PrivateStateId = PrivateStateId, PS =
      * Remove all contract signing keys.
      */
     clearSigningKeys(): Promise<void>;
+    /**
+     * Export all private states as an encrypted JSON-serializable structure.
+     *
+     * NOTE: This does NOT export signing keys for security reasons.
+     *
+     * @param options Export options including optional custom password and state limit.
+     * @returns A JSON-serializable export structure that can be saved or transmitted.
+     * @throws {PrivateStateExportError} If no states exist to export or limit exceeded.
+     */
+    exportPrivateStates(options?: ExportPrivateStatesOptions): Promise<PrivateStateExport>;
+    /**
+     * Import private states from a previously exported structure.
+     *
+     * @param exportData The export data structure to import.
+     * @param options Import options including password, conflict strategy, and state limit.
+     * @returns Result indicating how many states were imported/skipped/overwritten.
+     * @throws {ExportDecryptionError} If decryption fails (wrong password or corrupted data).
+     * @throws {InvalidExportFormatError} If the export format is invalid or unsupported.
+     * @throws {ImportConflictError} If conflictStrategy is 'error' and conflicts exist.
+     */
+    importPrivateStates(exportData: PrivateStateExport, options?: ImportPrivateStatesOptions): Promise<ImportPrivateStatesResult>;
 }
 
 type UnboundTransaction = Transaction<SignatureEnabled, Proof, PreBinding>;
@@ -695,5 +846,5 @@ interface MidnightProviders<ICK extends Contract.ImpureCircuitId<Contract.Any> =
     readonly loggerProvider?: LoggerProvider;
 }
 
-export { FailEntirely, FailFallible, InvalidProtocolSchemeError, LogLevel, SegmentFail, SegmentSuccess, SucceedEntirely, ZKConfigProvider, asContractAddress, asEffectOption, createProverKey, createVerifierKey, createZKIR, exitResultOrError, makeContractExecutableRuntime, zkConfigToProvingKeyMaterial };
-export type { All, BlockHash, BlockHashConfig, BlockHeightConfig, ContractExecutableRuntimeOptions, ContractStateObservableConfig, Fees, FinalizedTxData, KeyMaterialProvider, Latest, LoggerProvider, MidnightProvider, MidnightProviders, PrivateStateId, PrivateStateProvider, ProofProvider, ProveTxConfig, ProverKey, PublicDataProvider, SegmentStatus, TxIdConfig, TxStatus, UnboundTransaction, UnshieldedBalance, UnshieldedBalances, UnshieldedUtxo, UnshieldedUtxos, VerifierKey, WalletProvider, ZKConfig, ZKIR };
+export { ExportDecryptionError, FailEntirely, FailFallible, ImportConflictError, InvalidExportFormatError, InvalidProtocolSchemeError, LogLevel, MAX_EXPORT_STATES, PrivateStateExportError, PrivateStateImportError, SegmentFail, SegmentSuccess, SucceedEntirely, ZKConfigProvider, asContractAddress, asEffectOption, createProverKey, createVerifierKey, createZKIR, exitResultOrError, makeContractExecutableRuntime, zkConfigToProvingKeyMaterial };
+export type { All, BlockHash, BlockHashConfig, BlockHeightConfig, ContractExecutableRuntimeOptions, ContractStateObservableConfig, ExportPrivateStatesOptions, Fees, FinalizedTxData, ImportPrivateStatesOptions, ImportPrivateStatesResult, KeyMaterialProvider, Latest, LoggerProvider, MidnightProvider, MidnightProviders, PrivateStateExport, PrivateStateId, PrivateStateImportErrorCause, PrivateStateProvider, ProofProvider, ProveTxConfig, ProverKey, PublicDataProvider, SegmentStatus, TxIdConfig, TxStatus, UnboundTransaction, UnshieldedBalance, UnshieldedBalances, UnshieldedUtxo, UnshieldedUtxos, VerifierKey, WalletProvider, ZKConfig, ZKIR };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { ContractExecutable } from '@midnight-ntwrk/compact-js/effect';
 import { ContractAddress as ContractAddress$1 } from '@midnight-ntwrk/platform-js';
-import { ConfigError, Exit, Option } from 'effect';
+import { Option, Exit, ConfigError } from 'effect';
 import { ManagedRuntime } from 'effect/ManagedRuntime';
-import { ContractAddress, IntentHash, RawTokenType, Transaction, SignatureEnabled, Proof, Binding, TransactionId, TransactionHash, FinalizedTransaction, PreBinding, UnprovenTransaction, ZswapChainState, CoinPublicKey, EncPublicKey } from '@midnight-ntwrk/ledger-v7';
+import { Transaction, SignatureEnabled, Proof, Binding, TransactionId, TransactionHash, ContractAddress, IntentHash, RawTokenType, FinalizedTransaction, UnprovenTransaction, PreBinding, ZswapChainState, CoinPublicKey, EncPublicKey } from '@midnight-ntwrk/ledger-v7';
 export { Transaction } from '@midnight-ntwrk/ledger-v7';
 import { LogFn } from 'pino';
 import { ContractAddress as ContractAddress$2, SigningKey, ContractState } from '@midnight-ntwrk/compact-runtime';
@@ -356,6 +356,44 @@ declare class InvalidProtocolSchemeError extends Error {
      */
     constructor(invalidScheme: string, allowableSchemes: string[]);
 }
+/**
+ * An error thrown when exporting private states fails.
+ */
+declare class PrivateStateExportError extends Error {
+    constructor(message: string);
+}
+/**
+ * Cause types for private state import errors.
+ */
+type PrivateStateImportErrorCause = 'decryption_failed' | 'invalid_format' | 'conflict' | 'unknown';
+/**
+ * Base error thrown when importing private states fails.
+ */
+declare class PrivateStateImportError extends Error {
+    readonly cause?: PrivateStateImportErrorCause | undefined;
+    constructor(message: string, cause?: PrivateStateImportErrorCause | undefined);
+}
+/**
+ * Error thrown when decryption of export data fails.
+ * This could be due to wrong password, corrupted data, or tampered content.
+ * The specific cause is intentionally not disclosed to prevent oracle attacks.
+ */
+declare class ExportDecryptionError extends PrivateStateImportError {
+    constructor();
+}
+/**
+ * Error thrown when the export data format is invalid.
+ */
+declare class InvalidExportFormatError extends PrivateStateImportError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when import conflicts with existing data and conflictStrategy is 'error'.
+ */
+declare class ImportConflictError extends PrivateStateImportError {
+    readonly conflictCount: number;
+    constructor(conflictCount: number);
+}
 
 /**
  * A valid named log level.
@@ -403,6 +441,90 @@ interface MidnightProvider {
  * A type representing an ID used to store a contract's private state.
  */
 type PrivateStateId = string;
+/**
+ * Represents the exported private state data structure.
+ * All metadata is included in the encrypted payload to prevent tampering.
+ */
+interface PrivateStateExport {
+    /**
+     * Format identifier. Must be 'midnight-private-state-export'.
+     */
+    readonly format: 'midnight-private-state-export';
+    /**
+     * Encrypted payload containing version, metadata, and serialized private states.
+     * Format: base64-encoded AES-256-GCM encrypted JSON.
+     */
+    readonly encryptedPayload: string;
+    /**
+     * Salt used for key derivation (hex-encoded, 32 bytes / 64 characters).
+     * Required for decryption with the export password.
+     */
+    readonly salt: string;
+}
+/**
+ * Maximum number of states that can be exported/imported.
+ * This limit prevents memory exhaustion attacks.
+ */
+declare const MAX_EXPORT_STATES = 10000;
+/**
+ * Options for exporting private states.
+ */
+interface ExportPrivateStatesOptions {
+    /**
+     * Password used to encrypt the export.
+     * Must be at least 16 characters.
+     * If not provided, uses the storage password.
+     */
+    readonly password?: string;
+    /**
+     * Maximum number of states to export.
+     * Defaults to MAX_EXPORT_STATES (10000).
+     * Set to a lower value to limit memory usage.
+     */
+    readonly maxStates?: number;
+}
+/**
+ * Options for importing private states.
+ */
+interface ImportPrivateStatesOptions {
+    /**
+     * Password used to decrypt the import.
+     * Must match the password used during export.
+     * If not provided, uses the storage password.
+     */
+    readonly password?: string;
+    /**
+     * How to handle conflicts when a private state ID already exists.
+     * - 'skip': Keep existing state, ignore imported state
+     * - 'overwrite': Replace existing state with imported state
+     * - 'error': Throw an error if any conflict is detected
+     * Default: 'error'
+     */
+    readonly conflictStrategy?: 'skip' | 'overwrite' | 'error';
+    /**
+     * Maximum number of states to import.
+     * Defaults to MAX_EXPORT_STATES (10000).
+     * Set to a lower value to limit memory usage.
+     */
+    readonly maxStates?: number;
+}
+/**
+ * Result of an import operation.
+ */
+interface ImportPrivateStatesResult {
+    /**
+     * Number of states successfully imported.
+     */
+    readonly imported: number;
+    /**
+     * Number of states skipped due to conflicts (when conflictStrategy is 'skip').
+     */
+    readonly skipped: number;
+    /**
+     * Number of states that overwrote existing states (when conflictStrategy is 'overwrite').
+     */
+    readonly overwritten: number;
+}
 /**
  * Interface for a typed key-valued store containing contract private states.
  *
@@ -410,6 +532,14 @@ type PrivateStateId = string;
  * @typeParam PS - Parameter indicating the private state type stored, sometimes a union of private state types.
  */
 interface PrivateStateProvider<PSI extends PrivateStateId = PrivateStateId, PS = any> {
+    /**
+     * Set the contract address for scoping private state operations.
+     * Must be called before any get/set/remove operations on private states.
+     * This provides namespace isolation between different contracts.
+     *
+     * @param address The contract address to scope operations to.
+     */
+    setContractAddress(address: ContractAddress$2): void;
     /**
      * Store the given private state at the given private state ID.
      *
@@ -456,6 +586,27 @@ interface PrivateStateProvider<PSI extends PrivateStateId = PrivateStateId, PS =
      * Remove all contract signing keys.
      */
     clearSigningKeys(): Promise<void>;
+    /**
+     * Export all private states as an encrypted JSON-serializable structure.
+     *
+     * NOTE: This does NOT export signing keys for security reasons.
+     *
+     * @param options Export options including optional custom password and state limit.
+     * @returns A JSON-serializable export structure that can be saved or transmitted.
+     * @throws {PrivateStateExportError} If no states exist to export or limit exceeded.
+     */
+    exportPrivateStates(options?: ExportPrivateStatesOptions): Promise<PrivateStateExport>;
+    /**
+     * Import private states from a previously exported structure.
+     *
+     * @param exportData The export data structure to import.
+     * @param options Import options including password, conflict strategy, and state limit.
+     * @returns Result indicating how many states were imported/skipped/overwritten.
+     * @throws {ExportDecryptionError} If decryption fails (wrong password or corrupted data).
+     * @throws {InvalidExportFormatError} If the export format is invalid or unsupported.
+     * @throws {ImportConflictError} If conflictStrategy is 'error' and conflicts exist.
+     */
+    importPrivateStates(exportData: PrivateStateExport, options?: ImportPrivateStatesOptions): Promise<ImportPrivateStatesResult>;
 }
 
 type UnboundTransaction = Transaction<SignatureEnabled, Proof, PreBinding>;
@@ -695,5 +846,5 @@ interface MidnightProviders<ICK extends Contract.ImpureCircuitId<Contract.Any> =
     readonly loggerProvider?: LoggerProvider;
 }
 
-export { FailEntirely, FailFallible, InvalidProtocolSchemeError, LogLevel, SegmentFail, SegmentSuccess, SucceedEntirely, ZKConfigProvider, asContractAddress, asEffectOption, createProverKey, createVerifierKey, createZKIR, exitResultOrError, makeContractExecutableRuntime, zkConfigToProvingKeyMaterial };
-export type { All, BlockHash, BlockHashConfig, BlockHeightConfig, ContractExecutableRuntimeOptions, ContractStateObservableConfig, Fees, FinalizedTxData, KeyMaterialProvider, Latest, LoggerProvider, MidnightProvider, MidnightProviders, PrivateStateId, PrivateStateProvider, ProofProvider, ProveTxConfig, ProverKey, PublicDataProvider, SegmentStatus, TxIdConfig, TxStatus, UnboundTransaction, UnshieldedBalance, UnshieldedBalances, UnshieldedUtxo, UnshieldedUtxos, VerifierKey, WalletProvider, ZKConfig, ZKIR };
+export { ExportDecryptionError, FailEntirely, FailFallible, ImportConflictError, InvalidExportFormatError, InvalidProtocolSchemeError, LogLevel, MAX_EXPORT_STATES, PrivateStateExportError, PrivateStateImportError, SegmentFail, SegmentSuccess, SucceedEntirely, ZKConfigProvider, asContractAddress, asEffectOption, createProverKey, createVerifierKey, createZKIR, exitResultOrError, makeContractExecutableRuntime, zkConfigToProvingKeyMaterial };
+export type { All, BlockHash, BlockHashConfig, BlockHeightConfig, ContractExecutableRuntimeOptions, ContractStateObservableConfig, ExportPrivateStatesOptions, Fees, FinalizedTxData, ImportPrivateStatesOptions, ImportPrivateStatesResult, KeyMaterialProvider, Latest, LoggerProvider, MidnightProvider, MidnightProviders, PrivateStateExport, PrivateStateId, PrivateStateImportErrorCause, PrivateStateProvider, ProofProvider, ProveTxConfig, ProverKey, PublicDataProvider, SegmentStatus, TxIdConfig, TxStatus, UnboundTransaction, UnshieldedBalance, UnshieldedBalances, UnshieldedUtxo, UnshieldedUtxos, VerifierKey, WalletProvider, ZKConfig, ZKIR };

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { ContractExecutableRuntime, ZKConfiguration, ZKConfigurationReadError, Contract } from '@midnight-ntwrk/compact-js/effect';
 import { ContractAddress } from '@midnight-ntwrk/platform-js';
 import * as Configuration from '@midnight-ntwrk/platform-js/effect/Configuration';
-import { Exit, Layer, Cause, Option, Effect, ConfigProvider } from 'effect';
+import { Exit, Cause, Option, Layer, ConfigProvider, Effect } from 'effect';
 export { Transaction } from '@midnight-ntwrk/ledger-v7';
 
 /*
@@ -118,6 +118,57 @@ class InvalidProtocolSchemeError extends Error {
         this.allowableSchemes = allowableSchemes;
     }
 }
+/**
+ * An error thrown when exporting private states fails.
+ */
+class PrivateStateExportError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PrivateStateExportError';
+    }
+}
+/**
+ * Base error thrown when importing private states fails.
+ */
+class PrivateStateImportError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'PrivateStateImportError';
+    }
+}
+/**
+ * Error thrown when decryption of export data fails.
+ * This could be due to wrong password, corrupted data, or tampered content.
+ * The specific cause is intentionally not disclosed to prevent oracle attacks.
+ */
+class ExportDecryptionError extends PrivateStateImportError {
+    constructor() {
+        super('Failed to decrypt export data. The password may be incorrect or the data may be corrupted.', 'decryption_failed');
+        this.name = 'ExportDecryptionError';
+    }
+}
+/**
+ * Error thrown when the export data format is invalid.
+ */
+class InvalidExportFormatError extends PrivateStateImportError {
+    constructor(message = 'Invalid export format') {
+        super(message, 'invalid_format');
+        this.name = 'InvalidExportFormatError';
+    }
+}
+/**
+ * Error thrown when import conflicts with existing data and conflictStrategy is 'error'.
+ */
+class ImportConflictError extends PrivateStateImportError {
+    conflictCount;
+    constructor(conflictCount) {
+        super(`Import conflicts with ${conflictCount} existing private state${conflictCount === 1 ? '' : 's'}`, 'conflict');
+        this.conflictCount = conflictCount;
+        this.name = 'ImportConflictError';
+    }
+}
 
 /*
  * This file is part of midnight-js.
@@ -227,6 +278,26 @@ const FailFallible = 'FailFallible';
  */
 const SucceedEntirely = 'SucceedEntirely';
 
+/*
+ * This file is part of midnight-js.
+ * Copyright (C) 2025 Midnight Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Maximum number of states that can be exported/imported.
+ * This limit prevents memory exhaustion attacks.
+ */
+const MAX_EXPORT_STATES = 10000;
+
 /*
  * This file is part of midnight-js.
  * Copyright (C) 2025 Midnight Foundation
@@ -276,5 +347,5 @@ class ZKConfigProvider {
     }
 }
 
-export { FailEntirely, FailFallible, InvalidProtocolSchemeError, LogLevel, SegmentFail, SegmentSuccess, SucceedEntirely, ZKConfigProvider, asContractAddress, asEffectOption, createProverKey, createVerifierKey, createZKIR, exitResultOrError, makeContractExecutableRuntime, zkConfigToProvingKeyMaterial };
+export { ExportDecryptionError, FailEntirely, FailFallible, ImportConflictError, InvalidExportFormatError, InvalidProtocolSchemeError, LogLevel, MAX_EXPORT_STATES, PrivateStateExportError, PrivateStateImportError, SegmentFail, SegmentSuccess, SucceedEntirely, ZKConfigProvider, asContractAddress, asEffectOption, createProverKey, createVerifierKey, createZKIR, exitResultOrError, makeContractExecutableRuntime, zkConfigToProvingKeyMaterial };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/contract.ts","../src/errors.ts","../src/logger-provider.ts","../src/midnight-types.ts","../src/zk-config-provider.ts"],"sourcesContent":[null,null,null,null,null],"names":[],"mappings":"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"}
+{"version":3,"file":"index.mjs","sources":["../src/contract.ts","../src/errors.ts","../src/logger-provider.ts","../src/midnight-types.ts","../src/private-state-provider.ts","../src/zk-config-provider.ts"],"sourcesContent":[null,null,null,null,null,null],"names":[],"mappings":"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"}

package/dist/private-state-provider.d.ts

@@ -3,6 +3,90 @@ import type { ContractAddress, SigningKey } from '@midnight-ntwrk/compact-runtim
  * A type representing an ID used to store a contract's private state.
  */
 export type PrivateStateId = string;
+/**
+ * Represents the exported private state data structure.
+ * All metadata is included in the encrypted payload to prevent tampering.
+ */
+export interface PrivateStateExport {
+    /**
+     * Format identifier. Must be 'midnight-private-state-export'.
+     */
+    readonly format: 'midnight-private-state-export';
+    /**
+     * Encrypted payload containing version, metadata, and serialized private states.
+     * Format: base64-encoded AES-256-GCM encrypted JSON.
+     */
+    readonly encryptedPayload: string;
+    /**
+     * Salt used for key derivation (hex-encoded, 32 bytes / 64 characters).
+     * Required for decryption with the export password.
+     */
+    readonly salt: string;
+}
+/**
+ * Maximum number of states that can be exported/imported.
+ * This limit prevents memory exhaustion attacks.
+ */
+export declare const MAX_EXPORT_STATES = 10000;
+/**
+ * Options for exporting private states.
+ */
+export interface ExportPrivateStatesOptions {
+    /**
+     * Password used to encrypt the export.
+     * Must be at least 16 characters.
+     * If not provided, uses the storage password.
+     */
+    readonly password?: string;
+    /**
+     * Maximum number of states to export.
+     * Defaults to MAX_EXPORT_STATES (10000).
+     * Set to a lower value to limit memory usage.
+     */
+    readonly maxStates?: number;
+}
+/**
+ * Options for importing private states.
+ */
+export interface ImportPrivateStatesOptions {
+    /**
+     * Password used to decrypt the import.
+     * Must match the password used during export.
+     * If not provided, uses the storage password.
+     */
+    readonly password?: string;
+    /**
+     * How to handle conflicts when a private state ID already exists.
+     * - 'skip': Keep existing state, ignore imported state
+     * - 'overwrite': Replace existing state with imported state
+     * - 'error': Throw an error if any conflict is detected
+     * Default: 'error'
+     */
+    readonly conflictStrategy?: 'skip' | 'overwrite' | 'error';
+    /**
+     * Maximum number of states to import.
+     * Defaults to MAX_EXPORT_STATES (10000).
+     * Set to a lower value to limit memory usage.
+     */
+    readonly maxStates?: number;
+}
+/**
+ * Result of an import operation.
+ */
+export interface ImportPrivateStatesResult {
+    /**
+     * Number of states successfully imported.
+     */
+    readonly imported: number;
+    /**
+     * Number of states skipped due to conflicts (when conflictStrategy is 'skip').
+     */
+    readonly skipped: number;
+    /**
+     * Number of states that overwrote existing states (when conflictStrategy is 'overwrite').
+     */
+    readonly overwritten: number;
+}
 /**
  * Interface for a typed key-valued store containing contract private states.
  *
@@ -10,6 +94,14 @@ export type PrivateStateId = string;
  * @typeParam PS - Parameter indicating the private state type stored, sometimes a union of private state types.
  */
 export interface PrivateStateProvider<PSI extends PrivateStateId = PrivateStateId, PS = any> {
+    /**
+     * Set the contract address for scoping private state operations.
+     * Must be called before any get/set/remove operations on private states.
+     * This provides namespace isolation between different contracts.
+     *
+     * @param address The contract address to scope operations to.
+     */
+    setContractAddress(address: ContractAddress): void;
     /**
      * Store the given private state at the given private state ID.
      *
@@ -56,5 +148,26 @@ export interface PrivateStateProvider<PSI extends PrivateStateId = PrivateStateI
      * Remove all contract signing keys.
      */
     clearSigningKeys(): Promise<void>;
+    /**
+     * Export all private states as an encrypted JSON-serializable structure.
+     *
+     * NOTE: This does NOT export signing keys for security reasons.
+     *
+     * @param options Export options including optional custom password and state limit.
+     * @returns A JSON-serializable export structure that can be saved or transmitted.
+     * @throws {PrivateStateExportError} If no states exist to export or limit exceeded.
+     */
+    exportPrivateStates(options?: ExportPrivateStatesOptions): Promise<PrivateStateExport>;
+    /**
+     * Import private states from a previously exported structure.
+     *
+     * @param exportData The export data structure to import.
+     * @param options Import options including password, conflict strategy, and state limit.
+     * @returns Result indicating how many states were imported/skipped/overwritten.
+     * @throws {ExportDecryptionError} If decryption fails (wrong password or corrupted data).
+     * @throws {InvalidExportFormatError} If the export format is invalid or unsupported.
+     * @throws {ImportConflictError} If conflictStrategy is 'error' and conflicts exist.
+     */
+    importPrivateStates(exportData: PrivateStateExport, options?: ImportPrivateStatesOptions): Promise<ImportPrivateStatesResult>;
 }
 //# sourceMappingURL=private-state-provider.d.ts.map

package/dist/private-state-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"private-state-provider.d.ts","sourceRoot":"","sources":["../src/private-state-provider.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,eAAe,EAAC,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAIpC;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB,CAAC,GAAG,SAAS,cAAc,GAAG,cAAc,EAAE,EAAE,GAAG,GAAG;IACzF;;;;;OAKG;IACH,GAAG,CAAC,cAAc,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;;OAIG;IACH,GAAG,CAAC,cAAc,EAAE,GAAG,GAAG,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAE7C;;;;OAIG;IACH,MAAM,CAAC,cAAc,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/E;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAEpE;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D;;OAEG;IACH,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC"}
+{"version":3,"file":"private-state-provider.d.ts","sourceRoot":"","sources":["../src/private-state-provider.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,eAAe,EAAC,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;IAEjD;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;IAE3D;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAID;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB,CAAC,GAAG,SAAS,cAAc,GAAG,cAAc,EAAE,EAAE,GAAG,GAAG;IACzF;;;;;;OAMG;IACH,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAEnD;;;;;OAKG;IACH,GAAG,CAAC,cAAc,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;;OAIG;IACH,GAAG,CAAC,cAAc,EAAE,GAAG,GAAG,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAE7C;;;;OAIG;IACH,MAAM,CAAC,cAAc,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/E;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAEpE;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D;;OAEG;IACH,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;;;;;;;OAQG;IACH,mBAAmB,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEvF;;;;;;;;;OASG;IACH,mBAAmB,CACjB,UAAU,EAAE,kBAAkB,EAC9B,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACvC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midnight-ntwrk/midnight-js-types",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Shared data types and interfaces for MidnightJS modules",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -32,6 +32,5 @@
     "@midnight-ntwrk/compact-js": "2.4.0",
     "@midnight-ntwrk/platform-js": "2.2.0",
     "rxjs": "^7.5.0"
-  },
-  "stableVersion": "3.0.0"
+  }
 }