@bsv/wallet-toolbox 2.12.0 → 2.13.2

package/out/src/storage/remoting/StorageClientBase.d.ts

@@ -1,5 +1,7 @@
-import { AbortActionArgs, AbortActionResult, InternalizeActionArgs, ListActionsResult, ListCertificatesResult, ListOutputsResult, RelinquishCertificateArgs, RelinquishOutputArgs, WalletInterface, AuthFetch, Validation, Telemetry, TelemetryConfig, TelemetrySpan } from '@bsv/sdk';
-import { AuthId, FindCertificatesArgs, FindOutputBasketsArgs, FindOutputsArgs, FindProvenTxReqsArgs, ProcessSyncChunkResult, RequestSyncChunkArgs, StorageCreateActionResult, StorageInternalizeActionResult, StorageProcessActionArgs, StorageProcessActionResults, StoragePrepareNoSendExpiryResult, StorageActivateNoSendExpiryArgs, StorageActivateNoSendExpiryResult, StorageArmNoSendExpiryArgs, SyncChunk, UpdateProvenTxReqWithNewProvenTxArgs, UpdateProvenTxReqWithNewProvenTxResult, WalletStorageProvider } from '../../sdk/WalletStorage.interfaces';
+import { type ValidCreateActionArgs, type ValidListActionsArgs, type ValidListCertificatesArgs, type ValidListOutputsArgs } from '@bsv/sdk/wallet/validationHelpers';
+import { type SyncTransferCapabilities } from './SyncTransfer';
+import { AbortActionArgs, AbortActionResult, InternalizeActionArgs, ListActionsResult, ListCertificatesResult, ListOutputsResult, RelinquishCertificateArgs, RelinquishOutputArgs, WalletInterface, AuthFetch, Telemetry, TelemetryConfig, TelemetrySpan } from '@bsv/sdk';
+import { AuthId, FindCertificatesArgs, FindOutputBasketsArgs, FindOutputsArgs, FindProvenTxReqsArgs, ProcessSyncChunkResult, RequestSyncChunkArgs, StorageCreateActionResult, StorageInternalizeActionResult, StorageProcessActionArgs, StorageProcessActionResults, StoragePrepareNoSendExpiryResult, StorageActivateNoSendExpiryArgs, StorageActivateNoSendExpiryResult, StorageArmNoSendExpiryArgs, SyncChunk, SyncCheckpoint, UpdateProvenTxReqWithNewProvenTxArgs, UpdateProvenTxReqWithNewProvenTxResult, WalletStorageProvider } from '../../sdk/WalletStorage.interfaces';
 import { AbortActionBatchResult, ActionBatchManifest, BeginActionBatchArgs, BeginActionBatchResult, CommitActionBatchByDigestArgs, CommitActionBatchResult, ExtendActionBatchArgs, ExtendActionBatchResult, PrepareActionBatchCommitResult, PutActionBatchBlobArgs, PutActionBatchPackArgs, ResumeActionBatchArgs, ResumeActionBatchResult, RenewActionBatchResult, StorageCapabilities } from '../../sdk/ActionBatch.interfaces';
 import { TableSettings } from '../schema/tables/TableSettings';
 import { WalletServices } from '../../sdk/WalletServices.interfaces';
@@ -10,6 +12,11 @@ import { TableOutputBasket } from '../schema/tables/TableOutputBasket';
 import { TableOutput } from '../schema/tables/TableOutput';
 import { TableProvenTxReq } from '../schema/tables/TableProvenTxReq';
 import { EntityTimeStamp } from '../../sdk/types';
+type RemoteStorageSettings = TableSettings & {
+    /** Runtime-only RPC advertisement, not a persisted settings-table column. */
+    syncCheckpointVersion?: 1;
+    syncTransfer?: SyncTransferCapabilities;
+};
 export interface StorageClientOptions {
     /**
      * Send compact tagged binary request values after the server advertises
@@ -22,6 +29,18 @@ export interface StorageClientOptions {
      * supplied. Request parameters and response payloads are never emitted.
      */
     telemetry?: TelemetryConfig;
+    /**
+     * Optional independently validated server identity key. When omitted, the
+     * first authenticated response is authoritative for this client instance.
+     */
+    serverIdentityKey?: string;
+    /**
+     * Optional independently validated storage-provider identity. The storage
+     * and authenticated server may use distinct keys. When omitted, the value
+     * advertised in the first authenticated `makeAvailable` response is
+     * authoritative for this client instance.
+     */
+    storageIdentityKey?: string;
 }
 /**
  * Abstract base class shared by `StorageClient` and `StorageMobile`.
@@ -37,8 +56,18 @@ export declare abstract class StorageClientBase implements WalletStorageProvider
     protected serverSupportsBinary: boolean;
     protected readonly binaryRequests: boolean;
     protected readonly telemetry: Telemetry;
-    settings?: TableSettings;
+    private authenticatedServerIdentityKey?;
+    private readonly expectedStorageIdentityKey?;
+    private syncChunkRoughSizeLimit?;
+    /** Optional progress/cancellation hook for a bounded transfer; never receives wallet contents. */
+    onSyncTransferProgress?: (progress: {
+        direction: 'read' | 'write';
+        bytes: number;
+        totalBytes: number;
+    }) => void;
+    settings?: RemoteStorageSettings;
     constructor(wallet: WalletInterface, endpointUrl: string, options?: StorageClientOptions);
+    protected authenticatedFetch(url: string, config: Parameters<AuthFetch['fetch']>[1]): Promise<Response>;
     protected traceRpcCall<T>(method: string, params: unknown[], callback: (span?: TelemetrySpan) => Promise<T>): Promise<T>;
     protected traceRpcStep<T>(name: string, parent: TelemetrySpan | undefined, callback: (span?: TelemetrySpan) => Promise<T> | T, attributes?: Readonly<Record<string, unknown>>): Promise<T>;
     /**
@@ -55,6 +84,7 @@ export declare abstract class StorageClientBase implements WalletStorageProvider
      * @param params The array of parameters to pass to the method in order.
      */
     protected abstract rpcCall<T>(method: string, params: unknown[]): Promise<T>;
+    protected nextRequestId(): number;
     /**
      * @returns true once storage `TableSettings` have been retreived from remote storage.
      */
@@ -63,13 +93,13 @@ export declare abstract class StorageClientBase implements WalletStorageProvider
      * @returns remote storage `TableSettings` if they have been retreived by `makeAvailable`.
      * @throws WERR_INVALID_OPERATION if `makeAvailable` has not yet been called.
      */
-    getSettings(): TableSettings;
+    getSettings(): RemoteStorageSettings;
     /**
      * Must be called prior to making use of storage.
      * Retreives `TableSettings` from remote storage provider.
      * @returns remote storage `TableSettings`
      */
-    makeAvailable(): Promise<TableSettings>;
+    makeAvailable(): Promise<RemoteStorageSettings>;
     /**
      * Called to cleanup resources when no further use of this object will occur.
      */
@@ -108,7 +138,7 @@ export declare abstract class StorageClientBase implements WalletStorageProvider
      * @param args Validated extension of original wallet `createAction` arguments.
      * @returns `StorageCreateActionResults` supporting additional wallet processing to yield `createAction` results.
      */
-    createAction(auth: AuthId, args: Validation.ValidCreateActionArgs): Promise<StorageCreateActionResult>;
+    createAction(auth: AuthId, args: ValidCreateActionArgs): Promise<StorageCreateActionResult>;
     /**
      * Storage level processing for wallet `createAction` and `signAction`.
      *
@@ -120,7 +150,7 @@ export declare abstract class StorageClientBase implements WalletStorageProvider
      * @returns `StorageProcessActionResults` supporting final wallet processing to yield `createAction` or `signAction` results.
      */
     processAction(auth: AuthId, args: StorageProcessActionArgs): Promise<StorageProcessActionResults>;
-    prepareNoSendExpiry(auth: AuthId, args: Validation.ValidCreateActionArgs): Promise<StoragePrepareNoSendExpiryResult>;
+    prepareNoSendExpiry(auth: AuthId, args: ValidCreateActionArgs): Promise<StoragePrepareNoSendExpiryResult>;
     activateNoSendExpiry(auth: AuthId, args: StorageActivateNoSendExpiryArgs): Promise<StorageActivateNoSendExpiryResult>;
     armNoSendExpiry(auth: AuthId, args: StorageArmNoSendExpiryArgs): Promise<void>;
     getCapabilities(): Promise<StorageCapabilities>;
@@ -152,6 +182,8 @@ export declare abstract class StorageClientBase implements WalletStorageProvider
         user: TableUser;
         isNew: boolean;
     }>;
+    /** Read compact progress only when the provider advertises support. */
+    getSyncCheckpoint(auth: AuthId, storageIdentityKey: string, storageName: string): Promise<SyncCheckpoint | undefined>;
     /**
      * Used to both find and insert a `TableSyncState` record for the user to track wallet data replication across storage providers.
      * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
@@ -179,7 +211,7 @@ export declare abstract class StorageClientBase implements WalletStorageProvider
      * @param args Validated extension of original wallet `listActions` arguments.
      * @returns `listActions` results.
      */
-    listActions(auth: AuthId, vargs: Validation.ValidListActionsArgs): Promise<ListActionsResult>;
+    listActions(auth: AuthId, vargs: ValidListActionsArgs): Promise<ListActionsResult>;
     /**
      * Storage level processing for wallet `listOutputs`.
      * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
@@ -187,7 +219,7 @@ export declare abstract class StorageClientBase implements WalletStorageProvider
      * @param args Validated extension of original wallet `listOutputs` arguments.
      * @returns `listOutputs` results.
      */
-    listOutputs(auth: AuthId, vargs: Validation.ValidListOutputsArgs): Promise<ListOutputsResult>;
+    listOutputs(auth: AuthId, vargs: ValidListOutputsArgs): Promise<ListOutputsResult>;
     /**
      * Storage level processing for wallet `listCertificates`.
      * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
@@ -195,7 +227,7 @@ export declare abstract class StorageClientBase implements WalletStorageProvider
      * @param args Validated extension of original wallet `listCertificates` arguments.
      * @returns `listCertificates` results.
      */
-    listCertificates(auth: AuthId, vargs: Validation.ValidListCertificatesArgs): Promise<ListCertificatesResult>;
+    listCertificates(auth: AuthId, vargs: ValidListCertificatesArgs): Promise<ListCertificatesResult>;
     /**
      * Find user certificates, optionally with fields.
      *
@@ -282,6 +314,16 @@ export declare abstract class StorageClientBase implements WalletStorageProvider
      * @returns the next "chunk" of replication data
      */
     getSyncChunk(args: RequestSyncChunkArgs): Promise<SyncChunk>;
+    private readSyncChunkResponse;
+    protected requestUsesBinary(method: string): boolean;
+    protected rpcResponseError(response: Response): Error;
+    private smallerSyncRequest;
+    private syncTransferCapabilities;
+    private syncTransferRetryDelay;
+    private transferPartCall;
+    private releaseSyncTransfer;
+    private downloadSyncTransfer;
+    private uploadSyncTransfer;
     /**
      * Handles the data received when a new transaction proof is found in response to an outstanding request for proof data:
      *
@@ -319,4 +361,5 @@ export declare abstract class StorageClientBase implements WalletStorageProvider
      */
     validateEntities<T extends EntityTimeStamp>(entities: T[], dateFields?: string[]): T[];
 }
+export {};
 //# sourceMappingURL=StorageClientBase.d.ts.map

package/out/src/storage/remoting/StorageClientBase.d.ts.map

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

package/out/src/storage/remoting/StorageClientBase.js

@@ -1,11 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StorageClientBase = void 0;
+const SyncTransfer_1 = require("./SyncTransfer");
+const syncChunkBinary_1 = require("./syncChunkBinary");
+const syncCheckpoint_1 = require("../sync/syncCheckpoint");
 const sdk_1 = require("@bsv/sdk");
 const WERR_errors_1 = require("../../sdk/WERR_errors");
 const entityValidationHelpers_1 = require("./entityValidationHelpers");
 const actionBatchPack_1 = require("../../utility/actionBatchPack");
 const beefForTxids_1 = require("../../utility/beefForTxids");
+const syncChunkResponseRetryLimit = 4;
+const minimumSyncChunkRoughSize = 64 * 1024;
+function isSyncChunkResponseTooLarge(error) {
+    return error instanceof Error && /WalletStorageClient rpcCall: network error 413(?:\s|$)/.test(error.message);
+}
+function hasControlCharacter(value) {
+    return Array.from(value).some(character => {
+        const point = character.codePointAt(0);
+        return point <= 0x1f || (point >= 0x7f && point <= 0x9f);
+    });
+}
 function isLoopbackStorageHost(hostname) {
     const normalized = hostname.toLowerCase();
     return (normalized === 'localhost' ||
@@ -14,6 +28,12 @@ function isLoopbackStorageHost(hostname) {
         normalized.endsWith('.localhost'));
 }
 function normalizeStorageEndpointUrl(endpointUrl) {
+    if (typeof endpointUrl !== 'string' ||
+        endpointUrl !== endpointUrl.trim() ||
+        endpointUrl.length > 8192 ||
+        hasControlCharacter(endpointUrl)) {
+        throw new TypeError('Wallet storage endpoint must be an exact bounded URL.');
+    }
     let parsed;
     try {
         parsed = new URL(endpointUrl);
@@ -32,6 +52,76 @@ function normalizeStorageEndpointUrl(endpointUrl) {
     // boundary; canonicalizing here would be an unrelated observable change.
     return endpointUrl;
 }
+function normalizeServerIdentityKey(value) {
+    if (typeof value !== 'string' || !/^(?:02|03)[0-9a-f]{64}$/.test(value)) {
+        throw new TypeError('Wallet storage server identity key must be canonical.');
+    }
+    try {
+        if (sdk_1.PublicKey.fromString(value).toString() !== value)
+            throw new Error();
+    }
+    catch {
+        throw new TypeError('Wallet storage server identity key must be canonical.');
+    }
+    return value;
+}
+function normalizeStorageIdentityKey(value) {
+    // Despite the historical "key" name, existing stores use both public keys
+    // and opaque identifiers, including legacy 32-byte and current 33-byte
+    // random values. Preserve that contract while enforcing the schema's
+    // bounded, non-control identifier domain.
+    if (typeof value !== 'string' || value.length < 1 || value.length > 130 || hasControlCharacter(value)) {
+        throw new TypeError('Wallet storage identity must be an exact bounded identifier.');
+    }
+    return value;
+}
+function validateRemoteStorageSettings(value) {
+    if (value == null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Wallet storage returned invalid settings.');
+    }
+    const prototype = Object.getPrototypeOf(value);
+    const properties = Object.getOwnPropertyDescriptors(value);
+    if ((prototype !== Object.prototype && prototype !== null) ||
+        Object.getOwnPropertySymbols(value).length !== 0 ||
+        Object.values(properties).some(property => property.get != null || property.set != null)) {
+        throw new Error('Wallet storage returned invalid settings.');
+    }
+    normalizeStorageIdentityKey(properties.storageIdentityKey?.value);
+    const storageName = properties.storageName?.value;
+    if (storageName !== undefined &&
+        (typeof storageName !== 'string' ||
+            storageName.length < 1 ||
+            storageName.length > 255 ||
+            hasControlCharacter(storageName))) {
+        throw new Error('Wallet storage returned invalid settings.');
+    }
+    const chain = properties.chain?.value;
+    if (chain !== undefined && (typeof chain !== 'string' || !['main', 'test', 'stn', 'ttn', 'tstn'].includes(chain))) {
+        throw new Error('Wallet storage returned invalid settings.');
+    }
+    const dbtype = properties.dbtype?.value;
+    if (dbtype !== undefined && (typeof dbtype !== 'string' || !['SQLite', 'MySQL', 'IndexedDB'].includes(dbtype))) {
+        throw new Error('Wallet storage returned invalid settings.');
+    }
+    const maxOutputScript = properties.maxOutputScript?.value;
+    if (maxOutputScript !== undefined &&
+        (!Number.isSafeInteger(maxOutputScript) || maxOutputScript < 0 || maxOutputScript > 16 * 1024 * 1024)) {
+        throw new Error('Wallet storage returned invalid settings.');
+    }
+    for (const key of ['created_at', 'updated_at']) {
+        const date = properties[key]?.value;
+        if (date !== undefined && !(date instanceof Date) && !(typeof date === 'string' || typeof date === 'number')) {
+            throw new Error('Wallet storage returned invalid settings.');
+        }
+        if (date !== undefined && !Number.isFinite(new Date(date).getTime())) {
+            throw new Error('Wallet storage returned invalid settings.');
+        }
+    }
+    if (properties.syncCheckpointVersion != null && properties.syncCheckpointVersion.value !== 1) {
+        throw new Error('Wallet storage returned invalid settings.');
+    }
+    return value;
+}
 /**
  * Abstract base class shared by `StorageClient` and `StorageMobile`.
  *
@@ -46,6 +136,11 @@ class StorageClientBase {
     serverSupportsBinary = false;
     binaryRequests;
     telemetry;
+    authenticatedServerIdentityKey;
+    expectedStorageIdentityKey;
+    syncChunkRoughSizeLimit;
+    /** Optional progress/cancellation hook for a bounded transfer; never receives wallet contents. */
+    onSyncTransferProgress;
     // Track ephemeral (in-memory) "settings" if you wish to align with isAvailable() checks
     settings;
     constructor(wallet, endpointUrl, options = {}) {
@@ -53,6 +148,23 @@ class StorageClientBase {
         this.endpointUrl = normalizeStorageEndpointUrl(endpointUrl);
         this.binaryRequests = options.binaryRequests === true;
         this.telemetry = new sdk_1.Telemetry(options.telemetry);
+        this.authenticatedServerIdentityKey =
+            options.serverIdentityKey === undefined ? undefined : normalizeServerIdentityKey(options.serverIdentityKey);
+        this.expectedStorageIdentityKey =
+            options.storageIdentityKey === undefined ? undefined : normalizeStorageIdentityKey(options.storageIdentityKey);
+    }
+    async authenticatedFetch(url, config) {
+        const response = await this.authClient.fetch(url, config);
+        const authenticatedIdentityKey = response.headers.get('x-bsv-auth-identity-key');
+        if (authenticatedIdentityKey == null) {
+            throw new Error('Wallet storage response was not mutually authenticated.');
+        }
+        const identityKey = normalizeServerIdentityKey(authenticatedIdentityKey);
+        if (this.authenticatedServerIdentityKey !== undefined && identityKey !== this.authenticatedServerIdentityKey) {
+            throw new Error('Wallet storage authenticated server identity changed.');
+        }
+        this.authenticatedServerIdentityKey = identityKey;
+        return response;
     }
     async traceRpcCall(method, params, callback) {
         if (!this.telemetry.enabled)
@@ -88,6 +200,12 @@ class StorageClientBase {
     isStorageProvider() {
         return false;
     }
+    nextRequestId() {
+        if (!Number.isSafeInteger(this.nextId) || this.nextId < 1) {
+            throw new Error('Wallet storage request identifier space exhausted.');
+        }
+        return this.nextId++;
+    }
     /**
      * @returns true once storage `TableSettings` have been retreived from remote storage.
      */
@@ -111,7 +229,15 @@ class StorageClientBase {
      * @returns remote storage `TableSettings`
      */
     async makeAvailable() {
-        this.settings ??= await this.rpcCall('makeAvailable', []);
+        if (this.settings != null)
+            return this.settings;
+        const settings = validateRemoteStorageSettings(await this.rpcCall('makeAvailable', []));
+        const descriptor = Object.getOwnPropertyDescriptor(settings, 'storageIdentityKey');
+        const storageIdentityKey = normalizeStorageIdentityKey(descriptor != null && 'value' in descriptor ? descriptor.value : undefined);
+        if (this.expectedStorageIdentityKey !== undefined && storageIdentityKey !== this.expectedStorageIdentityKey) {
+            throw new Error('Wallet storage settings identity does not match the configured storage identity.');
+        }
+        this.settings = settings;
         return this.settings;
     }
     /// ///////////////////////////////////////////////////////////////////////////
@@ -183,7 +309,7 @@ class StorageClientBase {
             else {
                 let source;
                 try {
-                    source = sdk_1.Beef.fromBinary(args.inputBEEF);
+                    source = sdk_1.Beef.fromBinaryStrict(args.inputBEEF);
                 }
                 catch {
                     // Forward malformed proof data so the server preserves its established
@@ -247,14 +373,13 @@ class StorageClientBase {
         const baseUrl = this.endpointUrl.endsWith('/') ? this.endpointUrl.slice(0, -1) : this.endpointUrl;
         const url = `${baseUrl}/action-batch/${encodeURIComponent(args.batchId)}/blob/${encodeURIComponent(args.digest)}`;
         const bytes = args.bytes instanceof Uint8Array ? args.bytes : Uint8Array.from(args.bytes);
-        const response = await this.authClient.fetch(url, {
+        const response = await this.authenticatedFetch(url, {
             method: 'PUT',
             headers: { 'Content-Type': 'application/octet-stream' },
             body: bytes
         });
         if (!response.ok) {
-            const details = (await response.text()).slice(0, 512);
-            throw new Error(`WalletStorageClient putActionBatchBlob: network error ${response.status} ${response.statusText}: ${details}`);
+            throw new Error(`WalletStorageClient putActionBatchBlob: network error ${response.status}`);
         }
     }
     async putActionBatchPack(_auth, args) {
@@ -269,7 +394,7 @@ class StorageClientBase {
         }
         const baseUrl = this.endpointUrl.endsWith('/') ? this.endpointUrl.slice(0, -1) : this.endpointUrl;
         const url = `${baseUrl}/action-batch/${encodeURIComponent(args.batchId)}/pack`;
-        const response = await this.authClient.fetch(url, {
+        const response = await this.authenticatedFetch(url, {
             method: 'PUT',
             headers: {
                 'Content-Type': 'application/octet-stream',
@@ -278,8 +403,7 @@ class StorageClientBase {
             body
         });
         if (!response.ok) {
-            const details = (await response.text()).slice(0, 512);
-            throw new Error(`WalletStorageClient putActionBatchPack: network error ${response.status} ${response.statusText}: ${details}`);
+            throw new Error(`WalletStorageClient putActionBatchPack: network error ${response.status}`);
         }
     }
     async commitActionBatch(auth, manifest) {
@@ -310,6 +434,15 @@ class StorageClientBase {
     async findOrInsertUser(identityKey) {
         return await this.rpcCall('findOrInsertUser', [identityKey]);
     }
+    /** Read compact progress only when the provider advertises support. */
+    async getSyncCheckpoint(auth, storageIdentityKey, storageName) {
+        // Settings are already exchanged with legacy providers. Only an advertised
+        // capability enables this RPC; transport and authentication failures propagate.
+        if ((await this.makeAvailable()).syncCheckpointVersion !== 1)
+            return undefined;
+        const checkpoint = await this.rpcCall('getSyncCheckpoint', [auth, storageIdentityKey, storageName]);
+        return (0, syncCheckpoint_1.validateSyncCheckpoint)(checkpoint);
+    }
     /**
      * Used to both find and insert a `TableSyncState` record for the user to track wallet data replication across storage providers.
      * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
@@ -473,7 +606,17 @@ class StorageClientBase {
      * @returns whether processing is done, counts of inserts and udpates, and related progress tracking properties.
      */
     async processSyncChunk(args, chunk) {
-        const r = await this.rpcCall('processSyncChunk', [args, chunk]);
+        const wireChunk = this.binaryRequests && this.serverSupportsBinary ? (0, syncChunkBinary_1.syncChunkBinary)(chunk) : chunk;
+        const capabilities = this.syncTransferCapabilities();
+        // Keep ordinary pages on the existing RPC. Only an oversized encoded payload uses staging.
+        const bytes = capabilities == null ? undefined : (0, SyncTransfer_1.encodeSyncTransfer)({ args, chunk: (0, syncChunkBinary_1.syncChunkBinary)(chunk) });
+        // Legacy numeric byte arrays can require four JSON characters per byte.
+        const expansion = this.binaryRequests && this.serverSupportsBinary ? 1 : 4;
+        const r = bytes != null && bytes.length * expansion > (capabilities.inlineBytes ?? 6 * 1024 * 1024)
+            ? await this.uploadSyncTransfer(args.identityKey, bytes, capabilities)
+            : await this.rpcCall('processSyncChunk', [args, wireChunk]);
+        if (r.nextCheckpoint != null)
+            r.nextCheckpoint = (0, syncCheckpoint_1.validateSyncCheckpoint)(r.nextCheckpoint, args);
         return r;
     }
     /**
@@ -486,9 +629,161 @@ class StorageClientBase {
      * @returns the next "chunk" of replication data
      */
     async getSyncChunk(args) {
+        const transfer = this.syncTransferCapabilities();
+        let requestArgs = { ...args, ...(transfer == null ? {} : { syncTransferVersion: 1 }) };
+        if (this.syncChunkRoughSizeLimit != null) {
+            requestArgs.maxRoughSize = Math.min(requestArgs.maxRoughSize, this.syncChunkRoughSizeLimit);
+        }
+        for (let retries = 0;; retries++) {
+            try {
+                return await this.readSyncChunkResponse(requestArgs, args.maxRoughSize, transfer);
+            }
+            catch (error) {
+                if (!isSyncChunkResponseTooLarge(error))
+                    throw error;
+                const smaller = this.smallerSyncRequest(requestArgs, retries);
+                if (smaller != null) {
+                    requestArgs = smaller;
+                    continue;
+                }
+                if (transfer == null)
+                    throw error;
+                return await this.downloadSyncTransfer(requestArgs, transfer);
+            }
+        }
+    }
+    async readSyncChunkResponse(args, originalMaxRoughSize, transfer) {
         const r = await this.rpcCall('getSyncChunk', [args]);
+        if ('syncTransfer' in r) {
+            if (transfer == null || Object.keys(r).length !== 1)
+                throw new Error('Unexpected wallet sync transfer response');
+            return await this.downloadSyncTransfer(args, transfer, r.syncTransfer);
+        }
+        if (args.maxRoughSize < originalMaxRoughSize) {
+            this.syncChunkRoughSizeLimit = args.maxRoughSize;
+        }
         return (0, entityValidationHelpers_1.validateSyncChunkEntities)(r);
     }
+    requestUsesBinary(method) {
+        const transferPart = method === 'writeSyncTransferPart' && this.settings?.syncTransfer?.version === 1;
+        return (this.binaryRequests || transferPart) && this.serverSupportsBinary;
+    }
+    rpcResponseError(response) {
+        const error = new Error(`WalletStorageClient rpcCall: network error ${response.status}`);
+        if (response.status !== 429)
+            return error;
+        const after = response.headers.get('retry-after');
+        let delay = 1000;
+        if (after != null)
+            delay = /^\d+$/.test(after) ? Number(after) * 1000 : Date.parse(after) - Date.now();
+        return Object.assign(error, { retryAfterMs: delay });
+    }
+    smallerSyncRequest(args, retries) {
+        const nextRoughSize = Math.max(minimumSyncChunkRoughSize, Math.floor(args.maxRoughSize / 2));
+        if (retries < syncChunkResponseRetryLimit && nextRoughSize < args.maxRoughSize) {
+            return { ...args, maxRoughSize: nextRoughSize };
+        }
+        if (args.maxItems === 1)
+            return undefined;
+        return { ...args, maxItems: 1, maxRoughSize: minimumSyncChunkRoughSize };
+    }
+    syncTransferCapabilities() {
+        const value = this.settings?.syncTransfer;
+        return value == null ? undefined : (0, SyncTransfer_1.validateSyncTransferCapabilities)(value);
+    }
+    syncTransferRetryDelay(error, attempt) {
+        const message = error instanceof Error ? error.message : '';
+        if (attempt >= 2 ||
+            !/network error (?:429|502|503|504)|timed out waiting for authenticated response|fetch failed|Failed to fetch/i.test(message))
+            return undefined;
+        if (!/network error 429/.test(message))
+            return 250 * 2 ** attempt;
+        const cause = error instanceof Error && error.cause instanceof Error ? error.cause : error;
+        const retryAfter = cause != null && typeof cause === 'object' ? Reflect.get(cause, 'retryAfterMs') : undefined;
+        const delay = retryAfter ?? 1000;
+        return Number.isFinite(delay) && delay >= 0 && delay <= 60_000 ? delay : undefined;
+    }
+    async transferPartCall(method, input) {
+        for (let attempt = 0;; attempt++) {
+            try {
+                return await this.rpcCall(method, [input]);
+            }
+            catch (error) {
+                // Only immutable reads and identical staged part writes may be retried here. Never commit.
+                const delay = this.syncTransferRetryDelay(error, attempt);
+                if (delay == null)
+                    throw error;
+                await new Promise(resolve => setTimeout(resolve, delay));
+            }
+        }
+    }
+    async releaseSyncTransfer(identityKey, transferId) {
+        try {
+            await this.rpcCall('releaseSyncTransfer', [{ identityKey, transferId }]);
+        }
+        catch {
+            // Expiry reclaims staging if the connection is gone. Wallet records are never removed.
+        }
+    }
+    async downloadSyncTransfer(args, capabilities, suppliedManifest) {
+        const manifest = (0, SyncTransfer_1.validateSyncTransferManifest)(suppliedManifest ??
+            (await this.transferPartCall('beginReadSyncTransfer', {
+                identityKey: args.identityKey,
+                args
+            })), capabilities);
+        try {
+            const chunk = (await (0, SyncTransfer_1.receiveSyncTransfer)(manifest, async (offset) => {
+                this.onSyncTransferProgress?.({ direction: 'read', bytes: offset, totalBytes: manifest.totalBytes });
+                return await this.transferPartCall('readSyncTransferPart', {
+                    identityKey: args.identityKey,
+                    transferId: manifest.transferId,
+                    offset
+                });
+            }));
+            this.onSyncTransferProgress?.({ direction: 'read', bytes: manifest.totalBytes, totalBytes: manifest.totalBytes });
+            if (chunk?.userIdentityKey !== args.identityKey ||
+                chunk.fromStorageIdentityKey !== args.fromStorageIdentityKey ||
+                chunk.toStorageIdentityKey !== args.toStorageIdentityKey)
+                throw new Error('Wallet sync transfer identities changed');
+            return (0, entityValidationHelpers_1.validateSyncChunkEntities)(chunk);
+        }
+        finally {
+            await this.releaseSyncTransfer(args.identityKey, manifest.transferId);
+        }
+    }
+    async uploadSyncTransfer(identityKey, bytes, capabilities) {
+        if (bytes.length > capabilities.maxBytes)
+            throw new RangeError('Wallet sync record exceeds the negotiated transfer size limit');
+        const response = await this.transferPartCall('beginWriteSyncTransfer', { identityKey, digest: (0, SyncTransfer_1.syncTransferDigest)(bytes), totalBytes: bytes.length });
+        const manifest = (0, SyncTransfer_1.validateSyncTransferManifest)(response, capabilities);
+        if (manifest.digest !== (0, SyncTransfer_1.syncTransferDigest)(bytes) ||
+            manifest.totalBytes !== bytes.length ||
+            !Number.isSafeInteger(response.receivedBytes) ||
+            response.receivedBytes < 0 ||
+            response.receivedBytes > bytes.length ||
+            (response.receivedBytes !== bytes.length && response.receivedBytes % manifest.partBytes !== 0)) {
+            throw new Error('Invalid wallet sync upload checkpoint');
+        }
+        for (let offset = response.receivedBytes; offset < bytes.length;) {
+            this.onSyncTransferProgress?.({ direction: 'write', bytes: offset, totalBytes: bytes.length });
+            const part = bytes.subarray(offset, offset + manifest.partBytes);
+            const next = await this.transferPartCall('writeSyncTransferPart', {
+                identityKey,
+                transferId: manifest.transferId,
+                offset,
+                bytes: part
+            });
+            if (next !== offset + part.length)
+                throw new Error('Invalid wallet sync upload acknowledgement');
+            offset = next;
+        }
+        // An uncertain commit is surfaced. The next sync starts from the writer's durable checkpoint.
+        const result = await this.rpcCall('commitSyncTransfer', [
+            { identityKey, transferId: manifest.transferId }
+        ]);
+        await this.releaseSyncTransfer(identityKey, manifest.transferId);
+        return result;
+    }
     /**
      * Handles the data received when a new transaction proof is found in response to an outstanding request for proof data:
      *