@0xsequence/wallet-core 0.0.0-20250520201059

package/dist/state/local/indexed-db.js

@@ -0,0 +1,149 @@
+const DB_VERSION = 1;
+const STORE_CONFIGS = 'configs';
+const STORE_WALLETS = 'counterfactualWallets';
+const STORE_PAYLOADS = 'payloads';
+const STORE_SIGNER_SUBDIGESTS = 'signerSubdigests';
+const STORE_SIGNATURES = 'signatures';
+const STORE_SAPIENT_SIGNER_SUBDIGESTS = 'sapientSignerSubdigests';
+const STORE_SAPIENT_SIGNATURES = 'sapientSignatures';
+const STORE_TREES = 'trees';
+export class IndexedDbStore {
+    _db = null;
+    dbName;
+    constructor(dbName = 'sequence-indexeddb') {
+        this.dbName = dbName;
+    }
+    async openDB() {
+        if (this._db)
+            return this._db;
+        return new Promise((resolve, reject) => {
+            const request = indexedDB.open(this.dbName, DB_VERSION);
+            request.onupgradeneeded = () => {
+                const db = request.result;
+                if (!db.objectStoreNames.contains(STORE_CONFIGS)) {
+                    db.createObjectStore(STORE_CONFIGS);
+                }
+                if (!db.objectStoreNames.contains(STORE_WALLETS)) {
+                    db.createObjectStore(STORE_WALLETS);
+                }
+                if (!db.objectStoreNames.contains(STORE_PAYLOADS)) {
+                    db.createObjectStore(STORE_PAYLOADS);
+                }
+                if (!db.objectStoreNames.contains(STORE_SIGNER_SUBDIGESTS)) {
+                    db.createObjectStore(STORE_SIGNER_SUBDIGESTS);
+                }
+                if (!db.objectStoreNames.contains(STORE_SIGNATURES)) {
+                    db.createObjectStore(STORE_SIGNATURES);
+                }
+                if (!db.objectStoreNames.contains(STORE_SAPIENT_SIGNER_SUBDIGESTS)) {
+                    db.createObjectStore(STORE_SAPIENT_SIGNER_SUBDIGESTS);
+                }
+                if (!db.objectStoreNames.contains(STORE_SAPIENT_SIGNATURES)) {
+                    db.createObjectStore(STORE_SAPIENT_SIGNATURES);
+                }
+                if (!db.objectStoreNames.contains(STORE_TREES)) {
+                    db.createObjectStore(STORE_TREES);
+                }
+            };
+            request.onsuccess = () => {
+                this._db = request.result;
+                resolve(this._db);
+            };
+            request.onerror = () => {
+                reject(request.error);
+            };
+        });
+    }
+    async get(storeName, key) {
+        const db = await this.openDB();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(storeName, 'readonly');
+            const store = tx.objectStore(storeName);
+            const req = store.get(key);
+            req.onsuccess = () => resolve(req.result);
+            req.onerror = () => reject(req.error);
+        });
+    }
+    async put(storeName, key, value) {
+        const db = await this.openDB();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(storeName, 'readwrite');
+            const store = tx.objectStore(storeName);
+            const req = store.put(value, key);
+            req.onsuccess = () => resolve();
+            req.onerror = () => reject(req.error);
+        });
+    }
+    async getSet(storeName, key) {
+        const data = (await this.get(storeName, key)) || new Set();
+        return Array.isArray(data) ? new Set(data) : data;
+    }
+    async putSet(storeName, key, setData) {
+        await this.put(storeName, key, Array.from(setData));
+    }
+    getSignatureKey(signer, subdigest) {
+        return `${signer.toLowerCase()}-${subdigest.toLowerCase()}`;
+    }
+    getSapientSignatureKey(signer, subdigest, imageHash) {
+        return `${signer.toLowerCase()}-${imageHash.toLowerCase()}-${subdigest.toLowerCase()}`;
+    }
+    async loadConfig(imageHash) {
+        return this.get(STORE_CONFIGS, imageHash.toLowerCase());
+    }
+    async saveConfig(imageHash, config) {
+        await this.put(STORE_CONFIGS, imageHash.toLowerCase(), config);
+    }
+    async loadCounterfactualWallet(wallet) {
+        return this.get(STORE_WALLETS, wallet.toLowerCase());
+    }
+    async saveCounterfactualWallet(wallet, imageHash, context) {
+        await this.put(STORE_WALLETS, wallet.toLowerCase(), { imageHash, context });
+    }
+    async loadPayloadOfSubdigest(subdigest) {
+        return this.get(STORE_PAYLOADS, subdigest.toLowerCase());
+    }
+    async savePayloadOfSubdigest(subdigest, payload) {
+        await this.put(STORE_PAYLOADS, subdigest.toLowerCase(), payload);
+    }
+    async loadSubdigestsOfSigner(signer) {
+        const dataSet = await this.getSet(STORE_SIGNER_SUBDIGESTS, signer.toLowerCase());
+        return Array.from(dataSet);
+    }
+    async loadSignatureOfSubdigest(signer, subdigest) {
+        const key = this.getSignatureKey(signer, subdigest);
+        return this.get(STORE_SIGNATURES, key.toLowerCase());
+    }
+    async saveSignatureOfSubdigest(signer, subdigest, signature) {
+        const key = this.getSignatureKey(signer, subdigest);
+        await this.put(STORE_SIGNATURES, key.toLowerCase(), signature);
+        const signerKey = signer.toLowerCase();
+        const subdigestKey = subdigest.toLowerCase();
+        const dataSet = await this.getSet(STORE_SIGNER_SUBDIGESTS, signerKey);
+        dataSet.add(subdigestKey);
+        await this.putSet(STORE_SIGNER_SUBDIGESTS, signerKey, dataSet);
+    }
+    async loadSubdigestsOfSapientSigner(signer, imageHash) {
+        const key = `${signer.toLowerCase()}-${imageHash.toLowerCase()}`;
+        const dataSet = await this.getSet(STORE_SAPIENT_SIGNER_SUBDIGESTS, key);
+        return Array.from(dataSet);
+    }
+    async loadSapientSignatureOfSubdigest(signer, subdigest, imageHash) {
+        const key = this.getSapientSignatureKey(signer, subdigest, imageHash);
+        return this.get(STORE_SAPIENT_SIGNATURES, key.toLowerCase());
+    }
+    async saveSapientSignatureOfSubdigest(signer, subdigest, imageHash, signature) {
+        const fullKey = this.getSapientSignatureKey(signer, subdigest, imageHash).toLowerCase();
+        await this.put(STORE_SAPIENT_SIGNATURES, fullKey, signature);
+        const signerKey = `${signer.toLowerCase()}-${imageHash.toLowerCase()}`;
+        const subdigestKey = subdigest.toLowerCase();
+        const dataSet = await this.getSet(STORE_SAPIENT_SIGNER_SUBDIGESTS, signerKey);
+        dataSet.add(subdigestKey);
+        await this.putSet(STORE_SAPIENT_SIGNER_SUBDIGESTS, signerKey, dataSet);
+    }
+    async loadTree(rootHash) {
+        return this.get(STORE_TREES, rootHash.toLowerCase());
+    }
+    async saveTree(rootHash, tree) {
+        await this.put(STORE_TREES, rootHash.toLowerCase(), tree);
+    }
+}

package/dist/state/local/memory.d.ts

@@ -0,0 +1,41 @@
+import { Context, Payload, Signature, Config, GenericTree } from '@0xsequence/wallet-primitives';
+import { Address, Hex } from 'ox';
+import { Store } from './index.js';
+export declare class MemoryStore implements Store {
+    private configs;
+    private counterfactualWallets;
+    private payloads;
+    private signerSubdigests;
+    private signatures;
+    private sapientSignerSubdigests;
+    private sapientSignatures;
+    private trees;
+    private getSignatureKey;
+    private getSapientSignatureKey;
+    loadConfig(imageHash: Hex.Hex): Promise<Config.Config | undefined>;
+    saveConfig(imageHash: Hex.Hex, config: Config.Config): Promise<void>;
+    loadCounterfactualWallet(wallet: Address.Address): Promise<{
+        imageHash: Hex.Hex;
+        context: Context.Context;
+    } | undefined>;
+    saveCounterfactualWallet(wallet: Address.Address, imageHash: Hex.Hex, context: Context.Context): Promise<void>;
+    loadPayloadOfSubdigest(subdigest: Hex.Hex): Promise<{
+        content: Payload.Parented;
+        chainId: bigint;
+        wallet: Address.Address;
+    } | undefined>;
+    savePayloadOfSubdigest(subdigest: Hex.Hex, payload: {
+        content: Payload.Parented;
+        chainId: bigint;
+        wallet: Address.Address;
+    }): Promise<void>;
+    loadSubdigestsOfSigner(signer: Address.Address): Promise<Hex.Hex[]>;
+    loadSignatureOfSubdigest(signer: Address.Address, subdigest: Hex.Hex): Promise<Signature.SignatureOfSignerLeaf | undefined>;
+    saveSignatureOfSubdigest(signer: Address.Address, subdigest: Hex.Hex, signature: Signature.SignatureOfSignerLeaf): Promise<void>;
+    loadSubdigestsOfSapientSigner(signer: Address.Address, imageHash: Hex.Hex): Promise<Hex.Hex[]>;
+    loadSapientSignatureOfSubdigest(signer: Address.Address, subdigest: Hex.Hex, imageHash: Hex.Hex): Promise<Signature.SignatureOfSapientSignerLeaf | undefined>;
+    saveSapientSignatureOfSubdigest(signer: Address.Address, subdigest: Hex.Hex, imageHash: Hex.Hex, signature: Signature.SignatureOfSapientSignerLeaf): Promise<void>;
+    loadTree(rootHash: Hex.Hex): Promise<GenericTree.Tree | undefined>;
+    saveTree(rootHash: Hex.Hex, tree: GenericTree.Tree): Promise<void>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/state/local/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/state/local/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAChG,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,IAAI,CAAA;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,qBAAa,WAAY,YAAW,KAAK;IACvC,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,qBAAqB,CAA6E;IAC1G,OAAO,CAAC,QAAQ,CAAoG;IACpH,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,UAAU,CAA4D;IAE9E,OAAO,CAAC,uBAAuB,CAAiC;IAChE,OAAO,CAAC,iBAAiB,CAAmE;IAE5F,OAAO,CAAC,KAAK,CAA6C;IAE1D,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,sBAAsB;IAIxB,UAAU,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC;IAIlE,UAAU,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,wBAAwB,CAC5B,MAAM,EAAE,OAAO,CAAC,OAAO,GACtB,OAAO,CAAC;QAAE,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IAIlE,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9G,sBAAsB,CAC1B,SAAS,EAAE,GAAG,CAAC,GAAG,GACjB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IAIzF,sBAAsB,CAC1B,SAAS,EAAE,GAAG,CAAC,GAAG,EAClB,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAA;KAAE,GAC/E,OAAO,CAAC,IAAI,CAAC;IAIV,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;IAKnE,wBAAwB,CAC5B,MAAM,EAAE,OAAO,CAAC,OAAO,EACvB,SAAS,EAAE,GAAG,CAAC,GAAG,GACjB,OAAO,CAAC,SAAS,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAKjD,wBAAwB,CAC5B,MAAM,EAAE,OAAO,CAAC,OAAO,EACvB,SAAS,EAAE,GAAG,CAAC,GAAG,EAClB,SAAS,EAAE,SAAS,CAAC,qBAAqB,GACzC,OAAO,CAAC,IAAI,CAAC;IAaV,6BAA6B,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;IAM9F,+BAA+B,CACnC,MAAM,EAAE,OAAO,CAAC,OAAO,EACvB,SAAS,EAAE,GAAG,CAAC,GAAG,EAClB,SAAS,EAAE,GAAG,CAAC,GAAG,GACjB,OAAO,CAAC,SAAS,CAAC,4BAA4B,GAAG,SAAS,CAAC;IAKxD,+BAA+B,CACnC,MAAM,EAAE,OAAO,CAAC,OAAO,EACvB,SAAS,EAAE,GAAG,CAAC,GAAG,EAClB,SAAS,EAAE,GAAG,CAAC,GAAG,EAClB,SAAS,EAAE,SAAS,CAAC,4BAA4B,GAChD,OAAO,CAAC,IAAI,CAAC;IAaV,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,GAAG,SAAS,CAAC;IAIlE,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAGzE"}

package/dist/state/local/memory.js

@@ -0,0 +1,77 @@
+export class MemoryStore {
+    configs = new Map();
+    counterfactualWallets = new Map();
+    payloads = new Map();
+    signerSubdigests = new Map();
+    signatures = new Map();
+    sapientSignerSubdigests = new Map();
+    sapientSignatures = new Map();
+    trees = new Map();
+    getSignatureKey(signer, subdigest) {
+        return `${signer.toLowerCase()}-${subdigest.toLowerCase()}`;
+    }
+    getSapientSignatureKey(signer, subdigest, imageHash) {
+        return `${signer.toLowerCase()}-${imageHash.toLowerCase()}-${subdigest.toLowerCase()}`;
+    }
+    async loadConfig(imageHash) {
+        return this.configs.get(imageHash.toLowerCase());
+    }
+    async saveConfig(imageHash, config) {
+        this.configs.set(imageHash.toLowerCase(), config);
+    }
+    async loadCounterfactualWallet(wallet) {
+        return this.counterfactualWallets.get(wallet.toLowerCase());
+    }
+    async saveCounterfactualWallet(wallet, imageHash, context) {
+        this.counterfactualWallets.set(wallet.toLowerCase(), { imageHash, context });
+    }
+    async loadPayloadOfSubdigest(subdigest) {
+        return this.payloads.get(subdigest.toLowerCase());
+    }
+    async savePayloadOfSubdigest(subdigest, payload) {
+        this.payloads.set(subdigest.toLowerCase(), payload);
+    }
+    async loadSubdigestsOfSigner(signer) {
+        const subdigests = this.signerSubdigests.get(signer.toLowerCase());
+        return subdigests ? Array.from(subdigests).map((s) => s) : [];
+    }
+    async loadSignatureOfSubdigest(signer, subdigest) {
+        const key = this.getSignatureKey(signer, subdigest);
+        return this.signatures.get(key);
+    }
+    async saveSignatureOfSubdigest(signer, subdigest, signature) {
+        const key = this.getSignatureKey(signer, subdigest);
+        this.signatures.set(key, signature);
+        const signerKey = signer.toLowerCase();
+        const subdigestKey = subdigest.toLowerCase();
+        if (!this.signerSubdigests.has(signerKey)) {
+            this.signerSubdigests.set(signerKey, new Set());
+        }
+        this.signerSubdigests.get(signerKey).add(subdigestKey);
+    }
+    async loadSubdigestsOfSapientSigner(signer, imageHash) {
+        const key = `${signer.toLowerCase()}-${imageHash.toLowerCase()}`;
+        const subdigests = this.sapientSignerSubdigests.get(key);
+        return subdigests ? Array.from(subdigests).map((s) => s) : [];
+    }
+    async loadSapientSignatureOfSubdigest(signer, subdigest, imageHash) {
+        const key = this.getSapientSignatureKey(signer, subdigest, imageHash);
+        return this.sapientSignatures.get(key);
+    }
+    async saveSapientSignatureOfSubdigest(signer, subdigest, imageHash, signature) {
+        const key = this.getSapientSignatureKey(signer, subdigest, imageHash);
+        this.sapientSignatures.set(key, signature);
+        const signerKey = `${signer.toLowerCase()}-${imageHash.toLowerCase()}`;
+        const subdigestKey = subdigest.toLowerCase();
+        if (!this.sapientSignerSubdigests.has(signerKey)) {
+            this.sapientSignerSubdigests.set(signerKey, new Set());
+        }
+        this.sapientSignerSubdigests.get(signerKey).add(subdigestKey);
+    }
+    async loadTree(rootHash) {
+        return this.trees.get(rootHash.toLowerCase());
+    }
+    async saveTree(rootHash, tree) {
+        this.trees.set(rootHash.toLowerCase(), tree);
+    }
+}

package/dist/state/remote/dev-http.d.ts

@@ -0,0 +1,57 @@
+import { Address, Hex } from 'ox';
+import { Config, Context, GenericTree, Payload, Signature } from '@0xsequence/wallet-primitives';
+import { Provider } from '../index.js';
+export declare class DevHttpProvider implements Provider {
+    private readonly baseUrl;
+    constructor(baseUrl: string);
+    private request;
+    getConfiguration(imageHash: Hex.Hex): Promise<Config.Config | undefined>;
+    getDeploy(wallet: Address.Address): Promise<{
+        imageHash: Hex.Hex;
+        context: Context.Context;
+    } | undefined>;
+    getWallets(signer: Address.Address): Promise<{
+        [wallet: Address.Address]: {
+            chainId: bigint;
+            payload: Payload.Parented;
+            signature: Signature.SignatureOfSignerLeaf;
+        };
+    }>;
+    getWalletsForSapient(signer: Address.Address, imageHash: Hex.Hex): Promise<{
+        [wallet: Address.Address]: {
+            chainId: bigint;
+            payload: Payload.Parented;
+            signature: Signature.SignatureOfSapientSignerLeaf;
+        };
+    }>;
+    getWitnessFor(wallet: Address.Address, signer: Address.Address): Promise<{
+        chainId: bigint;
+        payload: Payload.Parented;
+        signature: Signature.SignatureOfSignerLeaf;
+    } | undefined>;
+    getWitnessForSapient(wallet: Address.Address, signer: Address.Address, imageHash: Hex.Hex): Promise<{
+        chainId: bigint;
+        payload: Payload.Parented;
+        signature: Signature.SignatureOfSapientSignerLeaf;
+    } | undefined>;
+    getConfigurationUpdates(wallet: Address.Address, fromImageHash: Hex.Hex, options?: {
+        allUpdates?: boolean;
+    }): Promise<Array<{
+        imageHash: Hex.Hex;
+        signature: Signature.RawSignature;
+    }>>;
+    getTree(rootHash: Hex.Hex): Promise<GenericTree.Tree | undefined>;
+    saveWallet(deployConfiguration: Config.Config, context: Context.Context): Promise<void>;
+    saveWitnesses(wallet: Address.Address, chainId: bigint, payload: Payload.Parented, signatures: Signature.RawTopology): Promise<void>;
+    saveUpdate(wallet: Address.Address, configuration: Config.Config, signature: Signature.RawSignature): Promise<void>;
+    saveTree(tree: GenericTree.Tree): Promise<void>;
+    saveConfiguration(config: Config.Config): Promise<void>;
+    saveDeploy(imageHash: Hex.Hex, context: Context.Context): Promise<void>;
+    getPayload(opHash: Hex.Hex): Promise<{
+        chainId: bigint;
+        payload: Payload.Parented;
+        wallet: Address.Address;
+    } | undefined>;
+    savePayload(wallet: Address.Address, payload: Payload.Parented, chainId: bigint): Promise<void>;
+}
+//# sourceMappingURL=dev-http.d.ts.map

package/dist/state/remote/dev-http.d.ts.map

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

package/dist/state/remote/dev-http.js

@@ -0,0 +1,162 @@
+import { Utils } from '@0xsequence/wallet-primitives';
+export class DevHttpProvider {
+    baseUrl;
+    constructor(baseUrl) {
+        // Remove trailing slash if present
+        this.baseUrl = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const options = {
+            method,
+            headers: {},
+        };
+        if (body && method === 'POST') {
+            options.headers = { 'Content-Type': 'application/json' };
+            options.body = Utils.toJSON(body);
+        }
+        let response;
+        try {
+            response = await fetch(url, options);
+        }
+        catch (networkError) {
+            // Handle immediate network errors (e.g., DNS resolution failure, refused connection)
+            console.error(`Network error during ${method} request to ${url}:`, networkError);
+            throw networkError; // Re-throw network errors
+        }
+        // --- Error Handling for HTTP Status ---
+        if (!response.ok) {
+            let errorPayload = { message: `HTTP error! Status: ${response.status}` };
+            try {
+                const errorText = await response.text();
+                const errorJson = await Utils.fromJSON(errorText);
+                errorPayload = { ...errorPayload, ...errorJson };
+            }
+            catch (e) {
+                try {
+                    // If JSON parsing fails, try getting text for better error message
+                    const errorText = await response.text();
+                    errorPayload.body = errorText;
+                }
+                catch (textErr) {
+                    // Ignore if reading text also fails
+                }
+            }
+            console.error('HTTP Request Failed:', errorPayload);
+            throw new Error(errorPayload.message || `Request failed for ${method} ${path} with status ${response.status}`);
+        }
+        // --- Response Body Handling (with fix for empty body) ---
+        try {
+            // Handle cases where POST might return 201/204 No Content
+            // 204 should definitely have no body. 201 might or might not.
+            if (response.status === 204) {
+                return undefined; // No content expected
+            }
+            if (response.status === 201 && method === 'POST') {
+                // Attempt to parse JSON (e.g., for { success: true }), but handle empty body gracefully
+                const text = await response.clone().text(); // Clone and check text first
+                if (text.trim() === '') {
+                    return undefined; // Treat empty 201 as success with no specific return data
+                }
+                // If not empty, try parsing JSON
+                const responseText = await response.text();
+                return (await Utils.fromJSON(responseText));
+            }
+            // For 200 OK or other success statuses expecting a body
+            // Clone the response before attempting to read the body,
+            // so we can potentially read it again (as text) if json() fails.
+            const clonedResponse = response.clone();
+            const textContent = await clonedResponse.text(); // Read as text first
+            if (textContent.trim() === '') {
+                // If the body is empty (or only whitespace) and status was OK (checked above),
+                // treat this as the server sending 'undefined' or 'null'.
+                // Return `undefined` to match the expected optional types in the Provider interface.
+                return undefined;
+            }
+            else {
+                // If there is content, attempt to parse it as JSON.
+                // We use the original response here, which hasn't had its body consumed yet.
+                const responseText = await response.text();
+                const data = await Utils.fromJSON(responseText);
+                // BigInt Deserialization note remains the same: manual conversion may be needed by consumer.
+                return data;
+            }
+        }
+        catch (error) {
+            // This catch block now primarily handles errors from response.json()
+            // if the non-empty textContent wasn't valid JSON.
+            console.error(`Error processing response body for ${method} ${url}:`, error);
+            // Also include the raw text in the error if possible
+            try {
+                const text = await response.text(); // Try reading original response if not already done
+                throw new Error(`Failed to parse JSON response from server. Status: ${response.status}. Body: "${text}". Original error: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            catch (readError) {
+                throw new Error(`Failed to parse JSON response from server and could not read response body as text. Status: ${response.status}. Original error: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+    // --- Reader Methods ---
+    async getConfiguration(imageHash) {
+        // The response needs careful handling if BigInts are involved (threshold, checkpoint)
+        const config = await this.request('GET', `/configuration/${imageHash}`);
+        // Manual conversion example (if needed by consumer):
+        // if (config?.threshold) config.threshold = BigInt(config.threshold);
+        // if (config?.checkpoint) config.checkpoint = BigInt(config.checkpoint);
+        return config;
+    }
+    async getDeploy(wallet) {
+        return this.request('GET', `/deploy/${wallet}`);
+    }
+    async getWallets(signer) {
+        // Response `chainId` will be a string/number, needs conversion if BigInt is strictly required upstream
+        return this.request('GET', `/wallets/signer/${signer}`);
+    }
+    async getWalletsForSapient(signer, imageHash) {
+        // Response `chainId` will be a string/number, needs conversion
+        return this.request('GET', `/wallets/sapient/${signer}/${imageHash}`);
+    }
+    async getWitnessFor(wallet, signer) {
+        // Response `chainId` will be a string/number, needs conversion
+        return this.request('GET', `/witness/${wallet}/signer/${signer}`);
+    }
+    async getWitnessForSapient(wallet, signer, imageHash) {
+        // Response `chainId` will be a string/number, needs conversion
+        return this.request('GET', `/witness/sapient/${wallet}/${signer}/${imageHash}`);
+    }
+    async getConfigurationUpdates(wallet, fromImageHash, options) {
+        const query = options?.allUpdates ? '?allUpdates=true' : '';
+        // Response signature object might contain BigInts (threshold, checkpoint) as strings
+        return this.request('GET', `/configuration-updates/${wallet}/from/${fromImageHash}${query}`);
+    }
+    async getTree(rootHash) {
+        return this.request('GET', `/tree/${rootHash}`);
+    }
+    // --- Writer Methods ---
+    async saveWallet(deployConfiguration, context) {
+        await this.request('POST', '/wallet', { deployConfiguration, context });
+    }
+    async saveWitnesses(wallet, chainId, payload, signatures) {
+        // chainId will be correctly stringified by the jsonReplacer
+        await this.request('POST', '/witnesses', { wallet, chainId, payload, signatures });
+    }
+    async saveUpdate(wallet, configuration, signature) {
+        // configuration and signature might contain BigInts, handled by replacer
+        await this.request('POST', '/update', { wallet, configuration, signature });
+    }
+    async saveTree(tree) {
+        await this.request('POST', '/tree', { tree });
+    }
+    saveConfiguration(config) {
+        return this.request('POST', '/configuration', { config });
+    }
+    saveDeploy(imageHash, context) {
+        return this.request('POST', '/deploy', { imageHash, context });
+    }
+    async getPayload(opHash) {
+        return this.request('GET', `/payload/${opHash}`);
+    }
+    async savePayload(wallet, payload, chainId) {
+        return this.request('POST', '/payload', { wallet, payload, chainId });
+    }
+}

package/dist/state/remote/index.d.ts

@@ -0,0 +1,2 @@
+export * from './dev-http.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/state/remote/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/state/remote/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA"}

package/dist/state/remote/index.js

@@ -0,0 +1 @@
+export * from './dev-http.js';

package/dist/state/utils.d.ts

@@ -0,0 +1,12 @@
+import { Payload, Signature } from '@0xsequence/wallet-primitives';
+import { Address } from 'ox';
+import { Reader } from './index.js';
+import { SapientSigner, Signer } from '../signers/index.js';
+export type WalletWithWitness<S extends Signer | SapientSigner> = {
+    wallet: Address.Address;
+    chainId: bigint;
+    payload: Payload.Parented;
+    signature: S extends SapientSigner ? Signature.SignatureOfSapientSignerLeaf : Signature.SignatureOfSignerLeaf;
+};
+export declare function getWalletsFor<S extends Signer | SapientSigner>(stateReader: Reader, signer: S): Promise<Array<WalletWithWitness<S>>>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/state/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/state/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,EAAE,OAAO,EAAO,MAAM,IAAI,CAAA;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACnC,OAAO,EAAmB,aAAa,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAE5E,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,aAAa,IAAI;IAChE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAA;IACzB,SAAS,EAAE,CAAC,SAAS,aAAa,GAAG,SAAS,CAAC,4BAA4B,GAAG,SAAS,CAAC,qBAAqB,CAAA;CAC9G,CAAA;AAED,wBAAsB,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,aAAa,EAClE,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAWtC"}

package/dist/state/utils.js

@@ -0,0 +1,29 @@
+import { Hex } from 'ox';
+import { isSapientSigner } from '../signers/index.js';
+export async function getWalletsFor(stateReader, signer) {
+    const wallets = await retrieveWallets(stateReader, signer);
+    return Object.entries(wallets).map(([wallet, { chainId, payload, signature }]) => {
+        Hex.assert(wallet);
+        return {
+            wallet,
+            chainId,
+            payload,
+            signature,
+        };
+    });
+}
+async function retrieveWallets(stateReader, signer) {
+    if (isSapientSigner(signer)) {
+        const [signerAddress, signerImageHash] = await Promise.all([signer.address, signer.imageHash]);
+        if (signerImageHash) {
+            return stateReader.getWalletsForSapient(signerAddress, signerImageHash);
+        }
+        else {
+            console.warn('Sapient signer has no imageHash');
+            return {};
+        }
+    }
+    else {
+        return stateReader.getWallets(await signer.address);
+    }
+}

package/dist/wallet.d.ts

@@ -0,0 +1,58 @@
+import { Config, Context, Payload, Signature as SequenceSignature } from '@0xsequence/wallet-primitives';
+import { Address, Bytes, Hex, Provider } from 'ox';
+import * as Envelope from './envelope.js';
+import * as State from './state/index.js';
+export type WalletOptions = {
+    context: Context.Context;
+    stateProvider: State.Provider;
+    guest: Address.Address;
+};
+export declare const DefaultWalletOptions: WalletOptions;
+export type WalletStatus = {
+    address: Address.Address;
+    isDeployed: boolean;
+    implementation?: Address.Address;
+    stage?: 'stage1' | 'stage2';
+    configuration: Config.Config;
+    imageHash: Hex.Hex;
+    /** Pending updates in reverse chronological order (newest first) */
+    pendingUpdates: Array<{
+        imageHash: Hex.Hex;
+        signature: SequenceSignature.RawSignature;
+    }>;
+    chainId?: bigint;
+};
+export type WalletStatusWithOnchain = WalletStatus & {
+    onChainImageHash: Hex.Hex;
+};
+export declare class Wallet {
+    readonly address: Address.Address;
+    readonly context: Context.Context;
+    readonly guest: Address.Address;
+    readonly stateProvider: State.Provider;
+    constructor(address: Address.Address, options?: Partial<WalletOptions>);
+    static fromConfiguration(configuration: Config.Config, options?: Partial<WalletOptions>): Promise<Wallet>;
+    isDeployed(provider: Provider.Provider): Promise<boolean>;
+    buildDeployTransaction(): Promise<{
+        to: Address.Address;
+        data: Hex.Hex;
+    }>;
+    prepareUpdate(configuration: Config.Config): Promise<Envelope.Envelope<Payload.ConfigUpdate>>;
+    submitUpdate(envelope: Envelope.Signed<Payload.ConfigUpdate>, options?: {
+        validateSave?: boolean;
+    }): Promise<void>;
+    getStatus<T extends Provider.Provider | undefined = undefined>(provider?: T): Promise<T extends Provider.Provider ? WalletStatusWithOnchain : WalletStatus>;
+    getNonce(provider: Provider.Provider, space: bigint): Promise<bigint>;
+    prepareTransaction(provider: Provider.Provider, calls: Payload.Call[], options?: {
+        space?: bigint;
+        noConfigUpdate?: boolean;
+    }): Promise<Envelope.Envelope<Payload.Calls>>;
+    buildTransaction(provider: Provider.Provider, envelope: Envelope.Signed<Payload.Calls>): Promise<{
+        to: `0x${string}`;
+        data: `0x${string}`;
+    }>;
+    prepareMessageSignature(message: string | Hex.Hex | Payload.TypedDataToSign, chainId: bigint): Promise<Envelope.Envelope<Payload.Message>>;
+    buildMessageSignature(envelope: Envelope.Signed<Payload.Message>, provider?: Provider.Provider): Promise<Bytes.Bytes>;
+    private prepareBlankEnvelope;
+}
+//# sourceMappingURL=wallet.d.ts.map

package/dist/wallet.d.ts.map

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