@orbitmem/sdk 0.1.0

package/dist/identity/ows-adapter.js

@@ -0,0 +1,67 @@
+/**
+ * @param walletName — OWS wallet name (e.g., "orbitmem")
+ * @param chain — CAIP-2 chain ID (e.g., "eip155:84532" for Base Sepolia)
+ */
+export function createOwsAdapter(walletName, chain) {
+    // OWS NAPI-RS bindings are synchronous — wrap in lazy import for ESM compat.
+    const ows = () => import("@open-wallet-standard/core");
+    function hexToBytes(hex) {
+        const clean = hex.replace(/^0x/, "");
+        return new Uint8Array(clean.match(/.{2}/g).map((b) => Number.parseInt(b, 16)));
+    }
+    /**
+     * Find the EVM address for the given CAIP-2 chain from WalletInfo.accounts.
+     * Falls back to the first eip155 account if exact chain not found.
+     */
+    function resolveAddress(accounts) {
+        const exact = accounts.find((a) => a.chainId === chain);
+        if (exact)
+            return exact.address;
+        const evm = accounts.find((a) => a.chainId.startsWith("eip155:"));
+        if (evm)
+            return evm.address;
+        throw new Error(`No EVM account found for chain ${chain} in wallet "${walletName}"`);
+    }
+    return {
+        async getAddress() {
+            const { getWallet } = await ows();
+            const wallet = getWallet(walletName);
+            return resolveAddress(wallet.accounts);
+        },
+        async signMessage(message) {
+            const { signMessage: owsSign } = await ows();
+            const result = owsSign(walletName, chain, message);
+            return { signature: hexToBytes(result.signature), algorithm: "ecdsa-secp256k1" };
+        },
+        async toViemAccount() {
+            const address = await this.getAddress();
+            const { toAccount } = await import("viem/accounts");
+            return toAccount({
+                address: address,
+                async signMessage({ message }) {
+                    const { signMessage: owsSign } = await ows();
+                    const msg = typeof message === "string"
+                        ? message
+                        : typeof message === "object" && "raw" in message
+                            ? typeof message.raw === "string"
+                                ? message.raw
+                                : new TextDecoder().decode(message.raw)
+                            : String(message);
+                    const result = owsSign(walletName, chain, msg);
+                    return result.signature;
+                },
+                async signTransaction(tx) {
+                    const { signTransaction: owsSignTx } = await ows();
+                    const result = owsSignTx(walletName, chain, JSON.stringify(tx));
+                    return result.signature;
+                },
+                async signTypedData(typedData) {
+                    const { signTypedData: owsSignTyped } = await ows();
+                    const result = owsSignTyped(walletName, chain, JSON.stringify(typedData));
+                    return result.signature;
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=ows-adapter.js.map

package/dist/identity/ows-adapter.js.map

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

package/dist/identity/session.d.ts

@@ -0,0 +1,10 @@
+import type { ChainFamily, SessionKey, SessionPermission, WalletAddress } from "../types.js";
+export declare function deriveSessionKey(opts: {
+    family: ChainFamily;
+    signature: Uint8Array;
+    parentAddress: WalletAddress;
+    permissions: SessionPermission[];
+    ttl: number;
+    nonce?: Uint8Array;
+}): Promise<SessionKey>;
+//# sourceMappingURL=session.d.ts.map

package/dist/identity/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/identity/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,iBAAiB,EAEjB,aAAa,EACd,MAAM,aAAa,CAAC;AAErB,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,UAAU,CAAC;IACtB,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB,GAAG,OAAO,CAAC,UAAU,CAAC,CAyCtB"}

package/dist/identity/session.js

@@ -0,0 +1,36 @@
+export async function deriveSessionKey(opts) {
+    const nonce = opts.nonce ?? crypto.getRandomValues(new Uint8Array(32));
+    // Derive session address from signature + nonce
+    const combined = new Uint8Array(opts.signature.length + nonce.length);
+    combined.set(opts.signature, 0);
+    combined.set(nonce, opts.signature.length);
+    const hashBuffer = await crypto.subtle.digest("SHA-256", combined);
+    const hashArray = new Uint8Array(hashBuffer);
+    // Use first 20 bytes as session address (EVM-style)
+    const sessionAddrBytes = hashArray.slice(0, 20);
+    const sessionAddress = ("0x" +
+        Array.from(sessionAddrBytes)
+            .map((b) => b.toString(16).padStart(2, "0"))
+            .join(""));
+    // Session ID from hash
+    const id = Array.from(hashArray.slice(20, 32))
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join("");
+    const expiresAt = Date.now() + opts.ttl * 1000;
+    const algorithmMap = {
+        passkey: "p256",
+        evm: "ecdsa-secp256k1",
+        solana: "ed25519",
+    };
+    return {
+        id,
+        parentAddress: opts.parentAddress,
+        family: opts.family,
+        sessionAddress,
+        permissions: opts.permissions,
+        expiresAt,
+        isActive: expiresAt > Date.now(),
+        algorithm: algorithmMap[opts.family],
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/identity/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/identity/session.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAOtC;IACC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IAEvE,gDAAgD;IAChD,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACtE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAChC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAE3C,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;IAE7C,oDAAoD;IACpD,MAAM,gBAAgB,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,cAAc,GAAG,CAAC,IAAI;QAC1B,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC;aACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;aAC3C,IAAI,CAAC,EAAE,CAAC,CAAkB,CAAC;IAEhC,uBAAuB;IACvB,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;SAC3C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;IAEZ,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;IAE/C,MAAM,YAAY,GAA4C;QAC5D,OAAO,EAAE,MAAM;QACf,GAAG,EAAE,iBAAiB;QACtB,MAAM,EAAE,SAAS;KAClB,CAAC;IAEF,OAAO;QACL,EAAE;QACF,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,cAAc;QACd,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,SAAS;QACT,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE;QAChC,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { createOrbitMem } from "./client.js";
+export type { NetworkConfig, NetworkId } from "./contracts.js";
+export { DEFAULT_NETWORK, getNetwork, NETWORKS } from "./contracts.js";
+export { createOrbitDBInstance, createVault } from "./data/index.js";
+export { createDiscoveryLayer, MockRegistry, OnChainRegistry } from "./discovery/index.js";
+export { AESEngine, createEncryptionLayer } from "./encryption/index.js";
+export { createIdentityLayer } from "./identity/index.js";
+export { createPersistenceLayer } from "./persistence/index.js";
+export { createRelaySession, createTransportLayer } from "./transport/index.js";
+export { deriveVaultKeyWithCache } from "./encryption/vault-key.js";
+export * from "./types.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,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE3F,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export { createOrbitMem } from "./client.js";
+export { DEFAULT_NETWORK, getNetwork, NETWORKS } from "./contracts.js";
+export { createOrbitDBInstance, createVault } from "./data/index.js";
+export { createDiscoveryLayer, MockRegistry, OnChainRegistry } from "./discovery/index.js";
+// Layer-level exports for advanced usage
+export { AESEngine, createEncryptionLayer } from "./encryption/index.js";
+export { createIdentityLayer } from "./identity/index.js";
+export { createPersistenceLayer } from "./persistence/index.js";
+export { createRelaySession, createTransportLayer } from "./transport/index.js";
+export { deriveVaultKeyWithCache } from "./encryption/vault-key.js";
+export * from "./types.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,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC3F,yCAAyC;AACzC,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,cAAc,YAAY,CAAC"}

package/dist/persistence/create-agent.d.ts

@@ -0,0 +1,11 @@
+/**
+ * One-time setup helper for BYOS (Bring Your Own Storacha) users.
+ * Creates a Storacha agent, provisions a space, and returns the
+ * serialized proof to store in config.
+ */
+export declare function createStorachaAgent(name?: string): Promise<{
+    agentDID: string;
+    proof: string;
+    instructions: string;
+}>;
+//# sourceMappingURL=create-agent.d.ts.map

package/dist/persistence/create-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent.d.ts","sourceRoot":"","sources":["../../src/persistence/create-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,SAAa,GAAG,OAAO,CAAC;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CA6CD"}

package/dist/persistence/create-agent.js

@@ -0,0 +1,47 @@
+/**
+ * One-time setup helper for BYOS (Bring Your Own Storacha) users.
+ * Creates a Storacha agent, provisions a space, and returns the
+ * serialized proof to store in config.
+ */
+export async function createStorachaAgent(name = "orbitmem") {
+    const { Client } = await import("@storacha/client");
+    const client = await Client.create();
+    const space = await client.createSpace(name);
+    await client.setCurrentSpace(space.did());
+    const delegation = await client.createDelegation(client.agent, ["*"], {
+        expiration: Infinity,
+    });
+    const chunks = [];
+    for await (const chunk of delegation.archive()) {
+        chunks.push(chunk);
+    }
+    const totalLength = chunks.reduce((acc, c) => acc + c.length, 0);
+    const car = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const chunk of chunks) {
+        car.set(chunk, offset);
+        offset += chunk.length;
+    }
+    const proof = btoa(String.fromCharCode(...car));
+    return {
+        agentDID: client.agent.did(),
+        proof,
+        instructions: [
+            "Storacha agent created successfully.",
+            `Agent DID: ${client.agent.did()}`,
+            `Space DID: ${space.did()}`,
+            "",
+            "Save the 'proof' string in your OrbitMem config:",
+            "",
+            "  createOrbitMem({ persistence: { proof: '<proof string>' } })",
+            "",
+            "Or set it as an environment variable:",
+            "",
+            "  ORBITMEM_STORACHA_PROOF=<proof string>",
+            "",
+            "Note: You must register this agent with Storacha before uploading.",
+            "Run: npx @storacha/cli login <email>",
+        ].join("\n"),
+    };
+}
+//# sourceMappingURL=create-agent.js.map

package/dist/persistence/create-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent.js","sourceRoot":"","sources":["../../src/persistence/create-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAI,GAAG,UAAU;IAKzD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAEpD,MAAM,MAAM,GAAG,MAAO,MAAc,CAAC,MAAM,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IAE1C,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE;QACpE,UAAU,EAAE,QAAQ;KACrB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IACxC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;IACzB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAEhD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;QAC5B,KAAK;QACL,YAAY,EAAE;YACZ,sCAAsC;YACtC,cAAc,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE;YAClC,cAAc,KAAK,CAAC,GAAG,EAAE,EAAE;YAC3B,EAAE;YACF,kDAAkD;YAClD,EAAE;YACF,gEAAgE;YAChE,EAAE;YACF,uCAAuC;YACvC,EAAE;YACF,0CAA0C;YAC1C,EAAE;YACF,oEAAoE;YACpE,sCAAsC;SACvC,CAAC,IAAI,CAAC,IAAI,CAAC;KACb,CAAC;AACJ,CAAC"}

package/dist/persistence/index.d.ts

@@ -0,0 +1,3 @@
+export { createStorachaAgent } from "./create-agent.js";
+export { createPersistenceLayer } from "./persistence-layer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/persistence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/persistence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/persistence/index.js

@@ -0,0 +1,3 @@
+export { createStorachaAgent } from "./create-agent.js";
+export { createPersistenceLayer } from "./persistence-layer.js";
+//# sourceMappingURL=index.js.map

package/dist/persistence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/persistence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/persistence/persistence-layer.d.ts

@@ -0,0 +1,12 @@
+import type { IPersistenceLayer, WalletAddress } from "../types.js";
+interface PersistenceConfig {
+    mock?: boolean;
+    relayUrl?: string;
+    proof?: string;
+    gatewayUrl?: string;
+    author?: WalletAddress;
+    signer?: string;
+}
+export declare function createPersistenceLayer(config: PersistenceConfig): IPersistenceLayer;
+export {};
+//# sourceMappingURL=persistence-layer.d.ts.map

package/dist/persistence/persistence-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence-layer.d.ts","sourceRoot":"","sources":["../../src/persistence/persistence-layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAY,aAAa,EAAE,MAAM,aAAa,CAAC;AAI9E,UAAU,iBAAiB;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4ND,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAInF"}

package/dist/persistence/persistence-layer.js

@@ -0,0 +1,194 @@
+const DEFAULT_GATEWAY = "https://w3s.link";
+function generateCID() {
+    const bytes = crypto.getRandomValues(new Uint8Array(32));
+    return ("bafy" +
+        Array.from(bytes)
+            .map((b) => b.toString(36))
+            .join("")
+            .slice(0, 55));
+}
+// ── Mock Persistence ─────────────────────────────────────────
+function createMockPersistence(config) {
+    const store = new Map();
+    return {
+        async archive(opts = {}) {
+            const data = opts.data ?? new Uint8Array(0);
+            const cid = generateCID();
+            const snapshot = {
+                cid,
+                size: data.length,
+                archivedAt: Date.now(),
+                author: config.author ?? "0x0",
+                entryCount: opts.entryCount ?? 0,
+                encrypted: true,
+                filecoinStatus: "pending",
+            };
+            store.set(cid, { data, snapshot });
+            return snapshot;
+        },
+        async retrieve(cid) {
+            const entry = store.get(cid);
+            if (!entry)
+                throw new Error(`Snapshot not found: ${cid}`);
+            return entry.data;
+        },
+        async restore(cid) {
+            const entry = store.get(cid);
+            if (!entry)
+                throw new Error(`Snapshot not found: ${cid}`);
+            return { merged: entry.snapshot.entryCount, conflicts: 0 };
+        },
+        async listSnapshots(opts) {
+            const all = Array.from(store.values()).map((e) => e.snapshot);
+            const offset = opts?.offset ?? 0;
+            const limit = opts?.limit ?? all.length;
+            return all.slice(offset, offset + limit);
+        },
+        async deleteSnapshot(cid) {
+            store.delete(cid);
+        },
+        async getDealStatus(cid) {
+            const entry = store.get(cid);
+            if (!entry)
+                throw new Error(`Snapshot not found: ${cid}`);
+            return { status: entry.snapshot.filecoinStatus };
+        },
+    };
+}
+// ── Managed Persistence (relay-backed) ───────────────────────
+function createManagedPersistence(config) {
+    const relayUrl = config.relayUrl;
+    const gateway = config.gatewayUrl ?? DEFAULT_GATEWAY;
+    return {
+        async archive(opts = {}) {
+            const data = opts.data ?? new Uint8Array(0);
+            const body = JSON.stringify({
+                data: new TextDecoder().decode(data),
+                entryCount: opts.entryCount ?? 0,
+            });
+            const res = await fetch(`${relayUrl}/v1/snapshots/archive`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body,
+            });
+            if (!res.ok) {
+                const text = await res.text();
+                throw new Error(`Archive failed (${res.status}): ${text}`);
+            }
+            const snap = await res.json();
+            return snap;
+        },
+        async retrieve(cid) {
+            const res = await fetch(`${gateway}/ipfs/${cid}`);
+            if (!res.ok)
+                throw new Error(`Failed to retrieve ${cid}: ${res.status}`);
+            return new Uint8Array(await res.arrayBuffer());
+        },
+        async restore(cid) {
+            const res = await fetch(`${gateway}/ipfs/${cid}`);
+            if (!res.ok)
+                throw new Error(`Failed to retrieve ${cid}: ${res.status}`);
+            return { merged: 0, conflicts: 0 };
+        },
+        async listSnapshots(_opts) {
+            const res = await fetch(`${relayUrl}/v1/snapshots`);
+            if (!res.ok) {
+                const text = await res.text();
+                throw new Error(`List snapshots failed (${res.status}): ${text}`);
+            }
+            const items = await res.json();
+            return items;
+        },
+        async deleteSnapshot(cid) {
+            const res = await fetch(`${relayUrl}/v1/snapshots/${cid}`, {
+                method: "DELETE",
+            });
+            if (!res.ok && res.status !== 204) {
+                const text = await res.text();
+                throw new Error(`Delete failed (${res.status}): ${text}`);
+            }
+        },
+        async getDealStatus(_cid) {
+            return { status: "pending" };
+        },
+    };
+}
+// ── Direct Persistence (Storacha UCAN) ───────────────────────
+function createDirectPersistence(config) {
+    const gateway = config.gatewayUrl ?? DEFAULT_GATEWAY;
+    let clientPromise = null;
+    async function getClient() {
+        if (!clientPromise) {
+            clientPromise = (async () => {
+                const { create } = await import("@storacha/client");
+                const { parse } = await import("@storacha/client/proof");
+                const client = await create();
+                const proof = await parse(config.proof);
+                const space = await client.addSpace(proof);
+                await client.setCurrentSpace(space.did());
+                return client;
+            })();
+        }
+        return clientPromise;
+    }
+    return {
+        async archive(opts = {}) {
+            const client = await getClient();
+            const data = opts.data ?? new Uint8Array(0);
+            const blob = new Blob([data]);
+            const cid = await client.uploadFile(blob);
+            const snapshot = {
+                cid: cid.toString(),
+                size: data.length,
+                archivedAt: Date.now(),
+                author: config.author ?? "0x0",
+                entryCount: opts.entryCount ?? 0,
+                encrypted: true,
+                filecoinStatus: "pending",
+            };
+            return snapshot;
+        },
+        async retrieve(cid) {
+            const res = await fetch(`${gateway}/ipfs/${cid}`);
+            if (!res.ok)
+                throw new Error(`Failed to retrieve ${cid}: ${res.status}`);
+            return new Uint8Array(await res.arrayBuffer());
+        },
+        async restore(cid) {
+            const res = await fetch(`${gateway}/ipfs/${cid}`);
+            if (!res.ok)
+                throw new Error(`Failed to retrieve ${cid}: ${res.status}`);
+            return { merged: 0, conflicts: 0 };
+        },
+        async listSnapshots(_opts) {
+            const client = await getClient();
+            const result = await client.capability.upload.list();
+            return (result.results ?? []).map((entry) => ({
+                cid: entry.root.toString(),
+                size: entry.size ?? 0,
+                archivedAt: entry.insertedAt ? new Date(entry.insertedAt).getTime() : Date.now(),
+                author: config.author ?? "0x0",
+                entryCount: 0,
+                encrypted: true,
+                filecoinStatus: "pending",
+            }));
+        },
+        async deleteSnapshot(cid) {
+            const client = await getClient();
+            const { CID: CIDClass } = await import("multiformats/cid");
+            await client.capability.upload.remove(CIDClass.parse(cid));
+        },
+        async getDealStatus(_cid) {
+            return { status: "pending" };
+        },
+    };
+}
+// ── Factory (mode detection) ─────────────────────────────────
+export function createPersistenceLayer(config) {
+    if (config.proof)
+        return createDirectPersistence(config);
+    if (config.relayUrl)
+        return createManagedPersistence(config);
+    return createMockPersistence(config);
+}
+//# sourceMappingURL=persistence-layer.js.map

package/dist/persistence/persistence-layer.js.map

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

package/dist/transport/index.d.ts

@@ -0,0 +1,3 @@
+export { createRelaySession } from "./relay-session.js";
+export { createTransportLayer } from "./transport-layer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/transport/index.js

@@ -0,0 +1,3 @@
+export { createRelaySession } from "./relay-session.js";
+export { createTransportLayer } from "./transport-layer.js";
+//# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/transport/relay-session.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Relay session transport — acquires a bearer token via ERC-8128 auth
+ * and caches it for subsequent requests. Designed for browser use with
+ * sessionStorage, but works anywhere with a custom storage adapter.
+ */
+export interface RelaySessionConfig {
+    /** Relay server URL (e.g. "https://orbitmem-relay.fly.dev") */
+    relayUrl: string;
+    /** Wallet address (checksummed) */
+    address: `0x${string}`;
+    /** Chain ID (default: 84532 = Base Sepolia) */
+    chainId?: number;
+    /** Wallet signMessage function */
+    signMessage: (message: Uint8Array) => Promise<`0x${string}`>;
+    /** Session TTL in seconds (default: 1800 = 30 min) */
+    ttl?: number;
+    /** Storage adapter for caching (default: sessionStorage if available) */
+    storage?: {
+        getItem(key: string): string | null;
+        setItem(key: string, value: string): void;
+        removeItem(key: string): void;
+    };
+}
+/**
+ * Create a relay session transport that handles session token
+ * acquisition, caching, and authenticated fetch.
+ *
+ * Usage:
+ * ```ts
+ * const relay = createRelaySession({ relayUrl, address, signMessage });
+ * const res = await relay.fetch("/v1/vault/keys", { method: "POST", body: ... });
+ * relay.clear(); // on disconnect
+ * ```
+ */
+export declare function createRelaySession(config: RelaySessionConfig): {
+    /** Make an authenticated fetch to the relay using a cached session token. */
+    fetch(path: string, init?: RequestInit): Promise<Response>;
+    /** Clear the cached session token. Call on disconnect. */
+    clear(): void;
+};
+//# sourceMappingURL=relay-session.d.ts.map

package/dist/transport/relay-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-session.d.ts","sourceRoot":"","sources":["../../src/transport/relay-session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;IACvB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,WAAW,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;IAC7D,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;QACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC;CACH;AAUD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB;IAqDzD,6EAA6E;gBAC3D,MAAM,SAAS,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWhE,0DAA0D;;EAK7D"}

package/dist/transport/relay-session.js

@@ -0,0 +1,86 @@
+/**
+ * Relay session transport — acquires a bearer token via ERC-8128 auth
+ * and caches it for subsequent requests. Designed for browser use with
+ * sessionStorage, but works anywhere with a custom storage adapter.
+ */
+import { createSignerClient } from "@slicekit/erc8128";
+const CACHE_KEY = "orbitmem:session";
+/**
+ * Create a relay session transport that handles session token
+ * acquisition, caching, and authenticated fetch.
+ *
+ * Usage:
+ * ```ts
+ * const relay = createRelaySession({ relayUrl, address, signMessage });
+ * const res = await relay.fetch("/v1/vault/keys", { method: "POST", body: ... });
+ * relay.clear(); // on disconnect
+ * ```
+ */
+export function createRelaySession(config) {
+    const { relayUrl, address, chainId = 84532, signMessage, ttl = 1800 } = config;
+    const storage = config.storage ?? (typeof sessionStorage !== "undefined" ? sessionStorage : null);
+    const signer = {
+        address,
+        chainId,
+        signMessage: async (message) => signMessage(message),
+    };
+    const client = createSignerClient(signer, {
+        preferReplayable: true,
+        ttlSeconds: ttl,
+    });
+    function getCached() {
+        if (!storage)
+            return null;
+        const raw = storage.getItem(CACHE_KEY);
+        if (!raw)
+            return null;
+        try {
+            const session = JSON.parse(raw);
+            if (session.address !== address)
+                return null;
+            if (session.expiresAt <= Date.now() + 30_000)
+                return null;
+            return session;
+        }
+        catch {
+            return null;
+        }
+    }
+    async function acquireToken() {
+        const cached = getCached();
+        if (cached)
+            return cached.token;
+        const res = await client.fetch(`${relayUrl}/v1/auth/session`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ ttl }),
+        }, {
+            binding: "class-bound",
+            replay: "replayable",
+            components: ["@authority"],
+        });
+        if (!res.ok)
+            throw new Error(`Session request failed: ${res.status}`);
+        const data = await res.json();
+        storage?.setItem(CACHE_KEY, JSON.stringify(data));
+        return data.token;
+    }
+    return {
+        /** Make an authenticated fetch to the relay using a cached session token. */
+        async fetch(path, init) {
+            const token = await acquireToken();
+            return globalThis.fetch(`${relayUrl}${path}`, {
+                ...init,
+                headers: {
+                    ...init?.headers,
+                    Authorization: `Bearer ${token}`,
+                },
+            });
+        },
+        /** Clear the cached session token. Call on disconnect. */
+        clear() {
+            storage?.removeItem(CACHE_KEY);
+        },
+    };
+}
+//# sourceMappingURL=relay-session.js.map

package/dist/transport/relay-session.js.map

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