@1sat/wallet-remote 0.0.2

package/dist/createRemoteWallet.d.ts

@@ -0,0 +1,39 @@
+import { OneSatServices } from '@1sat/client';
+import { PrivateKey } from '@bsv/sdk';
+import { Wallet, WalletStorageManager } from '@bsv/wallet-toolbox-mobile/out/src/index.client.js';
+type Chain = 'main' | 'test';
+export interface RemoteWalletConfig {
+    /** Private key - can be PrivateKey instance, WIF string, or hex string */
+    privateKey: PrivateKey | string;
+    /** Network: 'main' or 'test' */
+    chain: Chain;
+    /** Remote storage server URL */
+    remoteStorageUrl: string;
+    /** Fee model. Default: { model: 'sat/kb', value: 100 } */
+    feeModel?: {
+        model: 'sat/kb';
+        value: number;
+    };
+    /** Connection timeout in milliseconds. Default: 5000 */
+    connectionTimeout?: number;
+}
+export interface RemoteWalletResult {
+    /** Wallet instance */
+    wallet: Wallet;
+    /** 1Sat services for API access */
+    services: OneSatServices;
+    /** Cleanup function - destroys wallet */
+    destroy: () => Promise<void>;
+    /** Storage manager (for diagnostics) */
+    storage: WalletStorageManager;
+}
+/**
+ * Create a wallet that uses a remote storage server as its sole storage.
+ *
+ * No local storage (IndexedDB/SQLite) is created. No Monitor is started
+ * client-side — the server handles transaction lifecycle (broadcasting,
+ * proof checking, failure management).
+ */
+export declare function createRemoteWallet(config: RemoteWalletConfig): Promise<RemoteWalletResult>;
+export {};
+//# sourceMappingURL=createRemoteWallet.d.ts.map

package/dist/createRemoteWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRemoteWallet.d.ts","sourceRoot":"","sources":["../src/createRemoteWallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAc,UAAU,EAAwB,MAAM,UAAU,CAAA;AAEvE,OAAO,EAGN,MAAM,EACN,oBAAoB,EACpB,MAAM,oDAAoD,CAAA;AAE3D,KAAK,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AAM5B,MAAM,WAAW,kBAAkB;IAClC,0EAA0E;IAC1E,UAAU,EAAE,UAAU,GAAG,MAAM,CAAA;IAC/B,gCAAgC;IAChC,KAAK,EAAE,KAAK,CAAA;IACZ,gCAAgC;IAChC,gBAAgB,EAAE,MAAM,CAAA;IACxB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IAClC,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,mCAAmC;IACnC,QAAQ,EAAE,cAAc,CAAA;IACxB,yCAAyC;IACzC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,wCAAwC;IACxC,OAAO,EAAE,oBAAoB,CAAA;CAC7B;AAwBD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACvC,MAAM,EAAE,kBAAkB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CA+D7B"}

package/dist/createRemoteWallet.js

@@ -0,0 +1,77 @@
+import { OneSatServices } from '@1sat/client';
+import { KeyDeriver, PrivateKey } from '@bsv/sdk';
+import { Services, StorageClient, Wallet, WalletStorageManager, } from '@bsv/wallet-toolbox-mobile/out/src/index.client.js';
+const DEFAULT_FEE_MODEL = { model: 'sat/kb', value: 100 };
+const DEFAULT_CONNECTION_TIMEOUT = 5000;
+function parsePrivateKey(input) {
+    if (input instanceof PrivateKey) {
+        return input;
+    }
+    if (/^[5KLc][1-9A-HJ-NP-Za-km-z]{50,51}$/.test(input)) {
+        return PrivateKey.fromWif(input);
+    }
+    if (/^[0-9a-fA-F]{64}$/.test(input)) {
+        return new PrivateKey(input);
+    }
+    try {
+        return PrivateKey.fromWif(input);
+    }
+    catch {
+        throw new Error('Invalid private key format. Expected PrivateKey instance, WIF string, or 64-char hex string.');
+    }
+}
+/**
+ * Create a wallet that uses a remote storage server as its sole storage.
+ *
+ * No local storage (IndexedDB/SQLite) is created. No Monitor is started
+ * client-side — the server handles transaction lifecycle (broadcasting,
+ * proof checking, failure management).
+ */
+export async function createRemoteWallet(config) {
+    const { chain } = config;
+    const feeModel = config.feeModel ?? DEFAULT_FEE_MODEL;
+    const timeout = config.connectionTimeout ?? DEFAULT_CONNECTION_TIMEOUT;
+    const privateKey = parsePrivateKey(config.privateKey);
+    const identityPubKey = privateKey.toPublicKey().toString();
+    const keyDeriver = new KeyDeriver(privateKey);
+    const fallbackServices = new Services(chain);
+    const oneSatServices = new OneSatServices(chain, undefined, fallbackServices);
+    // Create storage manager without any stores initially.
+    // _authId is set from identityKey, which is all the Wallet constructor needs.
+    const storage = new WalletStorageManager(identityPubKey);
+    // Create wallet — needed by StorageClient for AuthFetch signing.
+    // The Wallet constructor only checks storage._authId.identityKey and calls
+    // storage.setServices(), both of which work on an empty manager.
+    const wallet = new Wallet({
+        chain,
+        keyDeriver,
+        storage,
+        services: oneSatServices,
+    });
+    // Create remote storage client using the wallet for authenticated requests.
+    const remoteClient = new StorageClient(wallet, config.remoteStorageUrl);
+    // Connect and make the remote storage the active (and only) store.
+    // addWalletStorageProvider calls remoteClient.makeAvailable() internally,
+    // which triggers AuthFetch using the wallet for signing.
+    const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error('Remote storage connection timeout')), timeout));
+    await Promise.race([
+        storage.addWalletStorageProvider(remoteClient),
+        timeoutPromise,
+    ]);
+    // Ensure user.activeStorage matches the remote server's storageIdentityKey.
+    // Without this, isActiveEnabled returns false and writes fail with WERR_NOT_ACTIVE.
+    const remoteSettings = remoteClient.getSettings();
+    if (remoteSettings?.storageIdentityKey) {
+        await storage.setActive(remoteSettings.storageIdentityKey);
+    }
+    const destroy = async () => {
+        await wallet.destroy();
+    };
+    return {
+        wallet,
+        services: oneSatServices,
+        destroy,
+        storage,
+    };
+}
+//# sourceMappingURL=createRemoteWallet.js.map

package/dist/createRemoteWallet.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from '@1sat/wallet';
+export { createRemoteWallet } from './createRemoteWallet';
+export type { RemoteWalletConfig, RemoteWalletResult } from './createRemoteWallet';
+export { Services, StorageClient, Wallet, WalletStorageManager, type sdk as walletSdk, } from '@bsv/wallet-toolbox-mobile/out/src/index.client.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":"AAAA,cAAc,cAAc,CAAA;AAE5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAElF,OAAO,EACN,QAAQ,EACR,aAAa,EACb,MAAM,EACN,oBAAoB,EACpB,KAAK,GAAG,IAAI,SAAS,GACrB,MAAM,oDAAoD,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from '@1sat/wallet';
+export { createRemoteWallet } from './createRemoteWallet';
+export { Services, StorageClient, Wallet, WalletStorageManager, } from '@bsv/wallet-toolbox-mobile/out/src/index.client.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":"AAAA,cAAc,cAAc,CAAA;AAE5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAGzD,OAAO,EACN,QAAQ,EACR,aAAa,EACb,MAAM,EACN,oBAAoB,GAEpB,MAAM,oDAAoD,CAAA"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@1sat/wallet-remote",
+  "version": "0.0.2",
+  "description": "Remote-only wallet factory for 1Sat Ordinals SDK",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "1sat",
+    "bsv",
+    "ordinals",
+    "wallet",
+    "remote"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@1sat/wallet": "^0.0.13"
+  },
+  "peerDependencies": {
+    "@1sat/client": "^0.0.6",
+    "@bsv/sdk": "^2.0.1",
+    "@bsv/wallet-toolbox-mobile": "npm:@bopen-io/wallet-toolbox-mobile@2.0.5-idb-fix.2"
+  },
+  "devDependencies": {
+    "@bsv/sdk": "^2.0.1",
+    "@bsv/wallet-toolbox-mobile": "npm:@bopen-io/wallet-toolbox-mobile@2.0.5-idb-fix.2",
+    "typescript": "^5.9.3"
+  }
+}