@shieldedtech/moth-wallet 0.2.0

package/dist/diagnostics/timings.js

@@ -0,0 +1,100 @@
+// Phase timings: a storage-agnostic recorder for "where did the wall clock go".
+//
+// The wallet already announces every phase it moves through — sync progress
+// messages from core, transaction stages from the transaction paths. Stamping
+// those at whatever boundary a surface has turns them into a timeline with no
+// further instrumentation: the gap between two labels IS the cost of the phase
+// between them. That technique localised the pre-seed reference cost to a single
+// 46.7s DustLocalState.deserialize with every other startup stage at 0.0s.
+//
+// The arithmetic and the policy (enabled/disabled, bounded history, never throw)
+// are identical everywhere; only the persistence differs — storage.local in the
+// extension, a file under ~/.moth for the CLI, TUI and daemon, memory in tests.
+// So the store is an interface and everything else lives here, isomorphic and
+// dependency-free: no node builtins, no extension APIs, no WASM. See
+// storage/adapter.ts for the same split applied to wallet state.
+/** Oldest entries are dropped past this. Bounded so an always-on session cannot
+ *  grow storage without limit; ~500 is several unlock+sync runs. */
+export const DEFAULT_MAX_ENTRIES = 500;
+/**
+ * Build a recorder over any store.
+ *
+ * `now` is injectable so the arithmetic is testable without faking the clock
+ * globally; it defaults to Date.now.
+ *
+ * Every method is best-effort by design: a failed read or write must never
+ * disturb the thing being measured, and an instrument that can break the wallet
+ * is worse than no instrument. That is why `record` swallows everything rather
+ * than propagating — callers stamp phases on hot paths and cannot be asked to
+ * wrap each one.
+ */
+export function createTimingRecorder(store, options) {
+    const maxEntries = options?.maxEntries ?? DEFAULT_MAX_ENTRIES;
+    const now = options?.now ?? (() => Date.now());
+    // Cached so the hot path (every ~1s sync emission) does not hit storage just to
+    // ask whether it should be recording.
+    let enabledCache = null;
+    const isEnabled = async () => {
+        if (enabledCache !== null)
+            return enabledCache;
+        try {
+            enabledCache = await store.isEnabled();
+        }
+        catch {
+            // A store that cannot answer is treated as off: recording is the optional
+            // behaviour, so the failure mode is "no data", never "broken wallet".
+            enabledCache = false;
+        }
+        return enabledCache;
+    };
+    const setEnabled = async (on) => {
+        enabledCache = on;
+        await store.setEnabled(on);
+        await record('marker', on ? 'timings: enabled' : 'timings: disabled');
+    };
+    async function record(source, label, detail) {
+        try {
+            if (!(await isEnabled()))
+                return;
+            const entries = await store.read();
+            const at = now();
+            // First entry of a run has no predecessor, so its delta is 0 rather than
+            // the time since the epoch.
+            const previous = entries.length > 0 ? entries[entries.length - 1].at : at;
+            entries.push({ at, deltaMs: at - previous, label, source, ...(detail ? { detail } : {}) });
+            await store.write(entries.slice(-maxEntries));
+        }
+        catch {
+            /* never let instrumentation break the path it measures */
+        }
+    }
+    return {
+        record,
+        isEnabled,
+        setEnabled,
+        list: () => store.read().catch(() => []),
+        clear: () => store.clear(),
+    };
+}
+/**
+ * In-memory store. For tests, and for a short-lived process that only wants the
+ * timeline it prints at exit.
+ */
+export function createMemoryTimingStore(initiallyEnabled = false) {
+    let enabled = initiallyEnabled;
+    let entries = [];
+    return {
+        isEnabled: async () => enabled,
+        setEnabled: async (on) => {
+            enabled = on;
+        },
+        read: async () => [...entries],
+        write: async (next) => {
+            entries = [...next];
+        },
+        clear: async () => {
+            entries = [];
+        },
+    };
+}
+//# sourceMappingURL=timings.js.map

package/dist/diagnostics/timings.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+export * from './types/index.js';
+export type { NetworkConfig, NetworkEndpoints, ProverConfig } from './types/network.js';
+export { DEFAULT_NETWORKS, validateNetworkUrl, validateNetworkConfig, serverProver, resolveProverConfig, isProverConfig, proverConfigsEqual, describeProver, } from './types/network.js';
+export { WalletManager } from './wallet/manager.js';
+export { NIGHT_DENOMINATION, DUST_DENOMINATION, formatBalance, formatDustBalance, } from './wallet/balance-format.js';
+export { generateMnemonic24, validateMnemonic, mnemonicToSeed, hexSeedToUint8Array } from './wallet/mnemonic.js';
+export { Roles } from './wallet/address.js';
+export { encryptKeystore, decryptKeystore, type EncryptedKeystore } from './wallet/keystore.js';
+export { deriveAllAddressesFromSeed, deriveRawKeys, deriveShieldedPublicKeys, decodeBech32mAddress } from './wallet/address.js';
+export { signMessage, signedMessageBytes, type SignEncoding, type SignedMessage } from './wallet/sign-message.js';
+export { deriveAppSecret } from './wallet/app-secret.js';
+export { loadBatchFile, executeBatchTransfer, batchExitCode, type BatchTransferEntry, type BatchTransferResult, type BatchTransferSummary } from './wallet/batch-transfer.js';
+export type { StorageAdapter } from './storage/adapter.js';
+export { FilesystemStorageAdapter } from './storage/fs-adapter.js';
+export { JsonRpcNodeClient, type NodeClient } from './network/node-client.js';
+export { IndexerClient } from './network/indexer-client.js';
+export type { Block, ContractAction, DustGenerationStatus, TransactionInfo } from './network/indexer-client.js';
+export { ProofClient, type ProofServerStatus } from './proof/client.js';
+export { createProvingProvider, createProofProvider, createWalletProvingService, ensureProverReady, } from './proof/provider.js';
+export { startWalletSync, formatNight, NIGHT_TOKEN_ID, clearSyncCache, clearDustSyncCache, resolveSyncStore, EMPTY_COINS, EMPTY_SUB_PROGRESS, type WalletSyncOptions, type WalletBalances, type SyncedWallet, type DustGeneration, type SyncProgress, type SubWalletSyncProgress, type SubWalletProgress, type WalletCoinDetails, type ShieldedCoinInfo, type UnshieldedCoinInfo, type DustCoinInfo, } from './sync/wallet-sync.js';
+export { sendTokens, sendTokensWithKeys, deriveWalletKeys, buildTransferTransaction, estimateTransferFee, submitFinalizedTransaction, designateForDust, designateForDustWithKeys, estimateDustRegistration, dedesignateFromDust, dedesignateFromDustWithKeys, listNightUtxos, type SendRequest, type TxStage, type NightUtxo, type FinalizedTransaction, type WalletKeys, } from './sync/operations.js';
+export { InMemorySyncStateStore, syncStateKey, emptyRefStateKey, emptyRefMnemonicKey, emptyRefHeightKey, type SyncStateStore, type WalletPart, } from './sync/sync-store.js';
+export { deriveActivity, deriveActivityEntry, sortActivity, type ActivityEntry, type ActivityDelta, type ActivityKind, type ActivityStatus, } from './sync/activity.js';
+export { estimateRegistrationAffordability, describeWait, DustRegistrationNotYetError, type DustGenerationSlice, type DustRegistrationEstimate, } from './sync/dust-registration-estimate.js';
+export { ensureEmptyRefCache, warmEmptyRefCache, refreshEmptyRefCache, preseedReferenceStatus, preSeedNewWallet, type WarmProgress } from './sync/preseed.js';
+export { loadContractArtifact, type ContractArtifact } from './contract/artifact-loader.js';
+export { loadWitnessProvider, type WitnessProvider } from './contract/witness-loader.js';
+export { deployContract, type DeployOptions } from './contract/deploy.js';
+export { callCircuit, type CallOptions } from './contract/call.js';
+export { insertVerifierKey, type InsertVerifierKeyOptions, insertVerifierKeys, type InsertVerifierKeysOptions, type BatchEntryResult, type BatchInsertResult, } from './contract/maintenance.js';
+export { queryContractState, type ContractState } from './contract/state.js';
+export { deployFungibleToken, mintFungibleToken, FUNGIBLE_TOKEN_ARTIFACT_DIR, type DeployFungibleTokenOptions, type MintFungibleTokenOptions, } from './contract/fungible-token.js';
+export { parseArgs, toPositionalArgs } from './contract/args-parser.js';
+export { resolveInitialPrivateState, type ResolveInitialPrivateStateOptions, } from './contract/initial-private-state.js';
+export { createMidnightProvider } from './providers/midnight-provider.js';
+export { startDaemon, connectDaemon, connectDaemonTcp, connectDaemonBind, daemonSocketPath, PROTOCOL_VERSION as DAEMON_PROTOCOL_VERSION, DaemonProtocolError, ConfirmationQueue, buildWalletHandlers, AuditLog, ApiKeyStore, parseSubmitTransactionParams, parseTransferTokensParams, parseCallCircuitParams, parseDeployContractParams, parseDustRegisterParams, parseDustDeregisterParams, parseInsertVerifierKeyParams, parseInsertVerifierKeysBatchParams, shortenHex, shortenAddress, type DaemonHandle, type DaemonOptions, type DaemonClient, type DaemonBind, type RpcHandler, type ConnectionContext, type RpcErrorCode, type AuthHandler, type AuthResult, type Scope, type ConfirmationRequest, type ConfirmationQueueOptions, type WalletHandlerDeps, type DaemonGetStateResult, type DaemonSubmitTransactionParams, type DaemonSubmitTransactionResult, type DaemonTransferTokensParams, type DaemonTransferTokensResult, type DaemonCallCircuitParams, type DaemonCallCircuitResult, type DaemonDeployContractParams, type DaemonDeployContractResult, type DaemonDustRegisterParams, type DaemonDustRegisterResult, type DaemonDustDeregisterParams, type DaemonDustDeregisterResult, type DaemonInsertVerifierKeyParams, type DaemonInsertVerifierKeyResult, type DaemonInsertVerifierKeysBatchParams, type DaemonInsertVerifierKeysBatchResult, type AuditEntry, type AuditRpcEntry, type AuditLifecycleEntry, type AuditDecision, type AuditLogOptions, type ApiKeyRecord, type ApiKeyGenerated, type ApiKeyAuthResult, } from './daemon/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,47 @@
+// Types
+export * from './types/index.js';
+export { DEFAULT_NETWORKS, validateNetworkUrl, validateNetworkConfig, serverProver, resolveProverConfig, isProverConfig, proverConfigsEqual, describeProver, } from './types/network.js';
+// Wallet
+export { WalletManager } from './wallet/manager.js';
+export { NIGHT_DENOMINATION, DUST_DENOMINATION, formatBalance, formatDustBalance, } from './wallet/balance-format.js';
+export { generateMnemonic24, validateMnemonic, mnemonicToSeed, hexSeedToUint8Array } from './wallet/mnemonic.js';
+export { Roles } from './wallet/address.js';
+export { encryptKeystore, decryptKeystore } from './wallet/keystore.js';
+export { deriveAllAddressesFromSeed, deriveRawKeys, deriveShieldedPublicKeys, decodeBech32mAddress } from './wallet/address.js';
+export { signMessage, signedMessageBytes } from './wallet/sign-message.js';
+export { deriveAppSecret } from './wallet/app-secret.js';
+export { loadBatchFile, executeBatchTransfer, batchExitCode } from './wallet/batch-transfer.js';
+export { FilesystemStorageAdapter } from './storage/fs-adapter.js';
+// Network
+export { JsonRpcNodeClient } from './network/node-client.js';
+export { IndexerClient } from './network/indexer-client.js';
+// Proof
+export { ProofClient } from './proof/client.js';
+export { createProvingProvider, createProofProvider, createWalletProvingService, ensureProverReady, } from './proof/provider.js';
+// Sync
+export { startWalletSync, formatNight, NIGHT_TOKEN_ID, clearSyncCache, clearDustSyncCache, resolveSyncStore, EMPTY_COINS, EMPTY_SUB_PROGRESS, } from './sync/wallet-sync.js';
+export { 
+// Union of both lines: main's build/estimate/submit + batch types the
+// extension imports, plus v8's derive-and-drop walletKeys write paths.
+sendTokens, sendTokensWithKeys, deriveWalletKeys, buildTransferTransaction, estimateTransferFee, submitFinalizedTransaction, designateForDust, designateForDustWithKeys, estimateDustRegistration, dedesignateFromDust, dedesignateFromDustWithKeys, listNightUtxos, } from './sync/operations.js';
+export { InMemorySyncStateStore, syncStateKey, emptyRefStateKey, emptyRefMnemonicKey, emptyRefHeightKey, } from './sync/sync-store.js';
+export { deriveActivity, deriveActivityEntry, sortActivity, } from './sync/activity.js';
+export { estimateRegistrationAffordability, describeWait, DustRegistrationNotYetError, } from './sync/dust-registration-estimate.js';
+export { ensureEmptyRefCache, warmEmptyRefCache, refreshEmptyRefCache, preseedReferenceStatus, preSeedNewWallet } from './sync/preseed.js';
+// Contract
+export { loadContractArtifact } from './contract/artifact-loader.js';
+export { loadWitnessProvider } from './contract/witness-loader.js';
+export { deployContract } from './contract/deploy.js';
+export { callCircuit } from './contract/call.js';
+export { insertVerifierKey, insertVerifierKeys, } from './contract/maintenance.js';
+export { queryContractState } from './contract/state.js';
+export { deployFungibleToken, mintFungibleToken, FUNGIBLE_TOKEN_ARTIFACT_DIR, } from './contract/fungible-token.js';
+export { parseArgs, toPositionalArgs } from './contract/args-parser.js';
+export { resolveInitialPrivateState, } from './contract/initial-private-state.js';
+// Providers — bridge SDK interfaces with our infrastructure
+export { createMidnightProvider } from './providers/midnight-provider.js';
+// Daemon — opt-in Unix-socket RPC for sharing a live wallet between the TUI
+// host and CLI clients. L1 perms enforced at the socket; L3 confirmation is
+// the host's responsibility (see packages/tui).
+export { startDaemon, connectDaemon, connectDaemonTcp, connectDaemonBind, daemonSocketPath, PROTOCOL_VERSION as DAEMON_PROTOCOL_VERSION, DaemonProtocolError, ConfirmationQueue, buildWalletHandlers, AuditLog, ApiKeyStore, parseSubmitTransactionParams, parseTransferTokensParams, parseCallCircuitParams, parseDeployContractParams, parseDustRegisterParams, parseDustDeregisterParams, parseInsertVerifierKeyParams, parseInsertVerifierKeysBatchParams, shortenHex, shortenAddress, } from './daemon/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/network/indexer-client.d.ts

@@ -0,0 +1,66 @@
+export interface Block {
+    hash: string;
+    height: number;
+    timestamp: number;
+    protocolVersion: number;
+}
+export interface ContractAction {
+    address: string;
+    state: string;
+    zswapState: string;
+    entryPoint?: string;
+    unshieldedBalances: Array<{
+        tokenType: string;
+        amount: string;
+    }>;
+    transaction: {
+        hash: string;
+        id: number;
+    };
+    block: {
+        hash: string;
+        height: number;
+    };
+}
+export interface DustGenerationStatus {
+    cardanoRewardAddress: string;
+    dustAddress: string | null;
+    registered: boolean;
+    nightBalance: string;
+    generationRate: string;
+    maxCapacity: string;
+    currentCapacity: string;
+}
+export interface TransactionInfo {
+    id: number;
+    hash: string;
+    protocolVersion: number;
+    raw: string;
+    block: Block;
+}
+export declare class IndexerClient {
+    private url;
+    constructor(url: string);
+    getBlock(offset?: {
+        hash?: string;
+        height?: number;
+    }): Promise<Block | null>;
+    getTransactions(offset: {
+        hash?: string;
+        identifier?: string;
+    }): Promise<TransactionInfo[]>;
+    getContractAction(address: string, offset?: {
+        blockOffset?: {
+            hash?: string;
+            height?: number;
+        };
+        transactionOffset?: {
+            hash?: string;
+        };
+    }): Promise<ContractAction | null>;
+    getDustGenerationStatus(cardanoRewardAddresses: string[]): Promise<DustGenerationStatus[]>;
+    connect(viewingKey: string): Promise<string>;
+    disconnect(sessionId: string): Promise<void>;
+    private query;
+}
+//# sourceMappingURL=indexer-client.d.ts.map

package/dist/network/indexer-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer-client.d.ts","sourceRoot":"","sources":["../../src/network/indexer-client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;CACd;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,EAAE,MAAM;IAIjB,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAY5E,eAAe,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAa3F,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,iBAAiB,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GACnG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAoB3B,uBAAuB,CAAC,sBAAsB,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAe1F,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM5C,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAKpC,KAAK;CAwCpB"}

package/dist/network/indexer-client.js

@@ -0,0 +1,112 @@
+import { NetworkError } from '../types/errors.js';
+export class IndexerClient {
+    url;
+    constructor(url) {
+        this.url = url;
+    }
+    async getBlock(offset) {
+        const query = `
+      query ($offset: BlockOffset) {
+        block(offset: $offset) {
+          hash height timestamp protocolVersion
+        }
+      }
+    `;
+        const result = await this.query(query, { offset: offset ?? null });
+        return result.block;
+    }
+    async getTransactions(offset) {
+        const query = `
+      query ($offset: TransactionOffset!) {
+        transactions(offset: $offset) {
+          id hash protocolVersion raw
+          block { hash height timestamp protocolVersion }
+        }
+      }
+    `;
+        const result = await this.query(query, { offset });
+        return result.transactions;
+    }
+    async getContractAction(address, offset) {
+        const query = `
+      query ($address: HexEncoded!, $offset: ContractActionOffset) {
+        contractAction(address: $address, offset: $offset) {
+          address state zswapState
+          ... on ContractCall { entryPoint }
+          unshieldedBalances { tokenType amount }
+          transaction { hash }
+          ... on ContractDeploy { transaction { hash } }
+          ... on ContractCall { transaction { hash } deploy { address } }
+        }
+      }
+    `;
+        const result = await this.query(query, {
+            address,
+            offset: offset ?? null,
+        });
+        return result.contractAction;
+    }
+    async getDustGenerationStatus(cardanoRewardAddresses) {
+        const query = `
+      query ($addresses: [CardanoRewardAddress!]!) {
+        dustGenerationStatus(cardanoRewardAddresses: $addresses) {
+          cardanoRewardAddress dustAddress registered
+          nightBalance generationRate maxCapacity currentCapacity
+        }
+      }
+    `;
+        const result = await this.query(query, {
+            addresses: cardanoRewardAddresses,
+        });
+        return result.dustGenerationStatus;
+    }
+    async connect(viewingKey) {
+        const query = `mutation ($viewingKey: ViewingKey!) { connect(viewingKey: $viewingKey) }`;
+        const result = await this.query(query, { viewingKey });
+        return result.connect;
+    }
+    async disconnect(sessionId) {
+        const query = `mutation ($sessionId: HexEncoded!) { disconnect(sessionId: $sessionId) }`;
+        await this.query(query, { sessionId });
+    }
+    async query(query, variables) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 10_000);
+        try {
+            const response = await fetch(this.url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ query, variables }),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new NetworkError(`Indexer request failed: HTTP ${response.status}`);
+            }
+            const json = await response.json();
+            // SR-002: Validate GraphQL response structure before acting on data
+            if (typeof json !== 'object' || json === null) {
+                throw new NetworkError('Indexer response is not a valid JSON object');
+            }
+            const errors = json.errors;
+            if (Array.isArray(errors) && errors.length > 0) {
+                throw new NetworkError(`Indexer error: ${errors[0]?.message ?? 'unknown'}`);
+            }
+            if (!('data' in json)) {
+                throw new NetworkError('Indexer response missing data field');
+            }
+            return json.data;
+        }
+        catch (err) {
+            if (err instanceof NetworkError)
+                throw err;
+            if (err instanceof Error && err.name === 'AbortError') {
+                throw new NetworkError(`Indexer timeout after 10s to ${this.url}`);
+            }
+            throw new NetworkError(`Indexer query failed: ${err}`, err);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=indexer-client.js.map

package/dist/network/indexer-client.js.map

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

package/dist/network/node-client.d.ts

@@ -0,0 +1,27 @@
+import type { NetworkConfig } from '../types/network.js';
+export interface NodeClient {
+    connect(config: NetworkConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    getBlockHeight(): Promise<number>;
+    getGenesisHash(): Promise<string>;
+    isConnected(): boolean;
+}
+/**
+ * Minimal JSON-RPC client for read-only chain status queries
+ * (block height, genesis hash, ledger version, contract state).
+ * Transaction submission is handled by @midnightntwrk/wallet-sdk-node-client
+ * via createMidnightProvider.
+ */
+export declare class JsonRpcNodeClient implements NodeClient {
+    private nodeUrl;
+    private connected;
+    connect(config: NetworkConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    getBlockHeight(): Promise<number>;
+    getGenesisHash(): Promise<string>;
+    getContractState(address: string): Promise<string | null>;
+    getLedgerVersion(): Promise<string>;
+    private rpcCall;
+}
+//# sourceMappingURL=node-client.d.ts.map

package/dist/network/node-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-client.d.ts","sourceRoot":"","sources":["../../src/network/node-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAGvD,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,WAAW,IAAI,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,UAAU;IAClD,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,SAAS,CAAS;IAEpB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,WAAW,IAAI,OAAO;IAIhB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAKjC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAIjC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQzD,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;YAI3B,OAAO;CAgDtB"}

package/dist/network/node-client.js

@@ -0,0 +1,94 @@
+import { NetworkError } from '../types/errors.js';
+/**
+ * Minimal JSON-RPC client for read-only chain status queries
+ * (block height, genesis hash, ledger version, contract state).
+ * Transaction submission is handled by @midnightntwrk/wallet-sdk-node-client
+ * via createMidnightProvider.
+ */
+export class JsonRpcNodeClient {
+    nodeUrl = '';
+    connected = false;
+    async connect(config) {
+        this.nodeUrl = config.nodeUrl.replace('ws://', 'http://').replace('wss://', 'https://');
+        // Verify connectivity with a simple RPC call
+        try {
+            await this.rpcCall('system_health', []);
+            this.connected = true;
+        }
+        catch (err) {
+            throw new NetworkError(`Could not connect to node at ${config.nodeUrl}`, err);
+        }
+    }
+    async disconnect() {
+        this.connected = false;
+    }
+    isConnected() {
+        return this.connected;
+    }
+    async getBlockHeight() {
+        const header = await this.rpcCall('chain_getHeader', []);
+        return parseInt(header.number, 16);
+    }
+    async getGenesisHash() {
+        return this.rpcCall('chain_getBlockHash', [0]);
+    }
+    async getContractState(address) {
+        try {
+            return await this.rpcCall('midnight_contractState', [address]);
+        }
+        catch {
+            return null;
+        }
+    }
+    async getLedgerVersion() {
+        return this.rpcCall('midnight_ledgerVersion', []);
+    }
+    async rpcCall(method, params) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 10_000);
+        try {
+            const response = await fetch(this.nodeUrl, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    jsonrpc: '2.0',
+                    id: 1,
+                    method,
+                    params,
+                }),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new NetworkError(`RPC request failed: HTTP ${response.status}`);
+            }
+            const json = (await response.json());
+            // SR-002: Validate RPC response structure before acting on data
+            if (typeof json !== 'object' || json === null) {
+                throw new NetworkError(`RPC response is not a valid JSON object`);
+            }
+            if (json.jsonrpc !== '2.0') {
+                throw new NetworkError(`RPC response missing jsonrpc 2.0 field`);
+            }
+            if (json.error) {
+                const err = json.error;
+                throw new NetworkError(`RPC error: ${err.message ?? 'unknown'}`);
+            }
+            if (!('result' in json)) {
+                throw new NetworkError(`RPC response missing result field for method ${method}`);
+            }
+            return json.result;
+        }
+        catch (err) {
+            if (err instanceof NetworkError)
+                throw err;
+            if (err instanceof Error && err.name === 'AbortError') {
+                throw new NetworkError(`Connection timeout after 10s to ${this.nodeUrl}`);
+            }
+            throw new NetworkError(`RPC call failed: ${err}`, err);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=node-client.js.map

package/dist/network/node-client.js.map

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

package/dist/proof/client.d.ts

@@ -0,0 +1,15 @@
+export interface ProofServerStatus {
+    healthy: boolean;
+    jobsProcessing: number;
+    jobsPending: number;
+    jobCapacity: number;
+}
+export declare class ProofClient {
+    private readonly url;
+    private readonly timeoutMs;
+    constructor(url: string, timeoutMs?: number);
+    healthCheck(): Promise<ProofServerStatus>;
+    ensureReady(): Promise<void>;
+    check(preimage: Uint8Array): Promise<(bigint | undefined)[]>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/proof/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/proof/client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,GAAG,EAAE,MAAM,EAAE,SAAS,SAAU;IAKtC,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAoCzC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B,KAAK,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;CA2BnE"}

package/dist/proof/client.js

@@ -0,0 +1,77 @@
+import { ProofError, NetworkError } from '../types/errors.js';
+export class ProofClient {
+    url;
+    timeoutMs;
+    constructor(url, timeoutMs = 300_000) {
+        this.url = url;
+        this.timeoutMs = timeoutMs;
+    }
+    async healthCheck() {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 5_000);
+        try {
+            const response = await fetch(`${this.url}/ready`, {
+                signal: controller.signal,
+            });
+            if (response.status === 503) {
+                const json = await response.json();
+                return { ...json, healthy: false };
+            }
+            if (!response.ok) {
+                throw new ProofError(`Proof server returned HTTP ${response.status}`);
+            }
+            const json = await response.json();
+            return { ...json, healthy: true };
+        }
+        catch (err) {
+            if (err instanceof ProofError)
+                throw err;
+            if (err instanceof Error && err.name === 'AbortError') {
+                throw new NetworkError(`Proof server not reachable at ${this.url}. Start with: moth proof-server start`);
+            }
+            throw new NetworkError(`Proof server not reachable at ${this.url}. Start with: moth proof-server start`, err);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    async ensureReady() {
+        const status = await this.healthCheck();
+        if (!status.healthy) {
+            throw new ProofError(`Proof server at ${this.url} is busy (${status.jobsProcessing} jobs processing, ${status.jobsPending} pending)`);
+        }
+    }
+    // The raw `prove()` method (POST of a bare serialized transaction to /prove)
+    // is deliberately gone: it predated payload versioning — ledger-v8 rejects
+    // the unversioned circuit-call proofs it produced — and all proving now
+    // flows through the SDK proof provider (see proof/provider.ts). Removed
+    // rather than left exported so the old request format can't be wired back in.
+    async check(preimage) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(`${this.url}/check`, {
+                method: 'POST',
+                body: preimage,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const text = await response.text();
+                throw new ProofError(`Proof check failed: ${text}`);
+            }
+            const buffer = await response.arrayBuffer();
+            // Parse check result — format depends on ledger serialization
+            // Placeholder: return raw bytes interpretation
+            return [BigInt(new Uint8Array(buffer).length)];
+        }
+        catch (err) {
+            if (err instanceof ProofError)
+                throw err;
+            throw new ProofError(`Proof check failed: ${err}`, err);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map