@cogcoin/client 0.5.14 → 1.0.0

package/dist/wallet/lifecycle.d.ts

@@ -1,12 +1,10 @@
 import { attachOrStartIndexerDaemon, probeIndexerDaemon } from "../bitcoind/indexer-daemon.js";
 import { attachOrStartManagedBitcoindService, probeManagedBitcoindService } from "../bitcoind/service.js";
 import { createRpcClient } from "../bitcoind/node.js";
-import type { ManagedCoreWalletReplicaStatus } from "../bitcoind/types.js";
+import type { ManagedCoreWalletReplicaStatus, RpcListUnspentEntry } from "../bitcoind/types.js";
 import { type WalletRuntimePaths } from "./runtime.js";
-import { requestMiningGenerationPreemption } from "./mining/coordination.js";
 import { type WalletSecretProvider } from "./state/provider.js";
-import type { UnlockSessionStateV1, WalletStateV1 } from "./types.js";
-export declare const DEFAULT_UNLOCK_DURATION_MS: number;
+import type { WalletStateV1 } from "./types.js";
 export interface WalletPrompter {
     readonly isInteractive: boolean;
     writeLine(message: string): void;
@@ -15,37 +13,17 @@ export interface WalletPrompter {
     clearSensitiveDisplay?(scope: "mnemonic-reveal" | "restore-mnemonic-entry"): void | Promise<void>;
 }
 export interface WalletInitializationResult {
+    passwordAction: "created" | "migrated" | "already-configured";
+    walletAction: "initialized" | "already-initialized";
     walletRootId: string;
     fundingAddress: string;
-    unlockUntilUnixMs: number;
-    state: WalletStateV1;
-}
-export interface WalletUnlockResult {
-    unlockUntilUnixMs: number;
-    state: WalletStateV1;
-    source: "primary" | "backup";
-}
-export interface LoadedUnlockedWalletState {
-    session: UnlockSessionStateV1;
-    state: WalletStateV1;
-    source: "primary" | "backup";
-}
-export interface WalletExportResult {
-    archivePath: string;
-    walletRootId: string;
-}
-export interface WalletImportResult {
-    archivePath: string;
-    walletRootId: string;
-    fundingAddress: string;
-    unlockUntilUnixMs: number;
     state: WalletStateV1;
 }
 export interface WalletRestoreResult {
+    passwordAction: "created" | "migrated" | "already-configured";
     seedName?: string | null;
     walletRootId: string;
     fundingAddress: string;
-    unlockUntilUnixMs: number;
     state: WalletStateV1;
     warnings?: string[];
 }
@@ -113,20 +91,12 @@ interface WalletLifecycleRpcClient {
     }>;
     unloadWallet?(walletName: string, loadOnStartup?: boolean): Promise<null>;
     listWallets(): Promise<string[]>;
+    listUnspent(walletName: string, minConf?: number): Promise<RpcListUnspentEntry[]>;
     getBlockchainInfo(): Promise<{
         blocks: number;
         headers: number;
     }>;
 }
-declare function readManagedSnapshotTip(options: {
-    dataDir: string;
-    databasePath: string;
-    walletRootId: string;
-}): Promise<{
-    nodeBestHeight: number | null;
-    snapshotHeight: number | null;
-}>;
-export declare function parseUnlockDurationToMs(raw: string | null | undefined): number;
 export declare function verifyManagedCoreWalletReplica(state: WalletStateV1, dataDir: string, dependencies?: {
     nodeHandle?: {
         rpc: Parameters<typeof createRpcClient>[0];
@@ -134,30 +104,11 @@ export declare function verifyManagedCoreWalletReplica(state: WalletStateV1, dat
     attachService?: typeof attachOrStartManagedBitcoindService;
     rpcFactory?: (config: Parameters<typeof createRpcClient>[0]) => WalletLifecycleRpcClient;
 }): Promise<ManagedCoreWalletReplicaStatus>;
-export declare function loadUnlockedWalletState(options?: {
-    provider?: WalletSecretProvider;
-    nowUnixMs?: number;
-    paths?: WalletRuntimePaths;
-    dataDir?: string;
-    attachService?: typeof attachOrStartManagedBitcoindService;
-    rpcFactory?: (config: Parameters<typeof createRpcClient>[0]) => WalletLifecycleRpcClient;
-}): Promise<LoadedUnlockedWalletState | null>;
-export declare function loadOrAutoUnlockWalletState(options?: {
-    provider?: WalletSecretProvider;
-    nowUnixMs?: number;
-    unlockDurationMs?: number;
-    paths?: WalletRuntimePaths;
-    dataDir?: string;
-    controlLockHeld?: boolean;
-    attachService?: typeof attachOrStartManagedBitcoindService;
-    rpcFactory?: (config: Parameters<typeof createRpcClient>[0]) => WalletLifecycleRpcClient;
-}): Promise<LoadedUnlockedWalletState | null>;
 export declare function initializeWallet(options: {
     dataDir: string;
     provider?: WalletSecretProvider;
     prompter: WalletPrompter;
     nowUnixMs?: number;
-    unlockDurationMs?: number;
     paths?: WalletRuntimePaths;
     attachService?: typeof attachOrStartManagedBitcoindService;
     rpcFactory?: (config: Parameters<typeof createRpcClient>[0]) => WalletLifecycleRpcClient;
@@ -168,54 +119,11 @@ export declare function showWalletMnemonic(options: {
     nowUnixMs?: number;
     paths?: WalletRuntimePaths;
 }): Promise<void>;
-export declare function unlockWallet(options?: {
-    provider?: WalletSecretProvider;
-    nowUnixMs?: number;
-    unlockDurationMs?: number;
-    paths?: WalletRuntimePaths;
-}): Promise<WalletUnlockResult>;
-export declare function lockWallet(options: {
-    dataDir: string;
-    provider?: WalletSecretProvider;
-    nowUnixMs?: number;
-    paths?: WalletRuntimePaths;
-    attachService?: typeof attachOrStartManagedBitcoindService;
-    rpcFactory?: (config: Parameters<typeof createRpcClient>[0]) => WalletLifecycleRpcClient;
-}): Promise<{
-    walletRootId: string | null;
-    coreLocked: boolean;
-}>;
-export declare function exportWallet(options: {
-    archivePath: string;
-    dataDir: string;
-    databasePath: string;
-    provider?: WalletSecretProvider;
-    prompter: WalletPrompter;
-    nowUnixMs?: number;
-    paths?: WalletRuntimePaths;
-    attachService?: typeof attachOrStartManagedBitcoindService;
-    rpcFactory?: (config: Parameters<typeof createRpcClient>[0]) => WalletLifecycleRpcClient;
-    readSnapshotTip?: typeof readManagedSnapshotTip;
-}): Promise<WalletExportResult>;
-export declare function importWallet(options: {
-    archivePath: string;
-    dataDir: string;
-    databasePath: string;
-    provider?: WalletSecretProvider;
-    prompter: WalletPrompter;
-    nowUnixMs?: number;
-    unlockDurationMs?: number;
-    paths?: WalletRuntimePaths;
-    attachService?: typeof attachOrStartManagedBitcoindService;
-    attachIndexerDaemon?: typeof attachOrStartIndexerDaemon;
-    rpcFactory?: (config: Parameters<typeof createRpcClient>[0]) => WalletLifecycleRpcClient;
-}): Promise<WalletImportResult>;
 export declare function restoreWalletFromMnemonic(options: {
     dataDir: string;
     provider?: WalletSecretProvider;
     prompter: WalletPrompter;
     nowUnixMs?: number;
-    unlockDurationMs?: number;
     paths?: WalletRuntimePaths;
     attachService?: typeof attachOrStartManagedBitcoindService;
     rpcFactory?: (config: Parameters<typeof createRpcClient>[0]) => WalletLifecycleRpcClient;
@@ -243,6 +151,6 @@ export declare function repairWallet(options: {
     rpcFactory?: (config: Parameters<typeof createRpcClient>[0]) => WalletLifecycleRpcClient;
     attachIndexerDaemon?: typeof attachOrStartIndexerDaemon;
     probeIndexerDaemon?: typeof probeIndexerDaemon;
-    requestMiningPreemption?: typeof requestMiningGenerationPreemption;
+    requestMiningPreemption?: typeof import("./mining/coordination.js").requestMiningGenerationPreemption;
     startBackgroundMining?: typeof import("./mining/runner.js").startBackgroundMining;
 }): Promise<WalletRepairResult>;