@orbitmem/sdk 0.1.0

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

@@ -0,0 +1,32 @@
+import type { EthHttpSigner } from "@slicekit/erc8128";
+import type { ChainFamily, ITransportLayer, SignatureAlgorithm, WalletAddress } from "../types.js";
+interface TransportConfig {
+    signer: (payload: Uint8Array) => Promise<{
+        signature: Uint8Array;
+        algorithm: SignatureAlgorithm;
+    }>;
+    verifier?: (payload: Uint8Array, signature: Uint8Array, algorithm: SignatureAlgorithm) => Promise<boolean>;
+    signerAddress: WalletAddress;
+    family: ChainFamily;
+    nonceTTL?: number;
+    /** ERC-8128 chain ID (default 84532 = Base Sepolia) */
+    chainId?: number;
+}
+export declare function createTransportLayer(config: TransportConfig): ITransportLayer;
+/**
+ * Create an RFC 9421 / ERC-8128 compliant transport layer using @slicekit/erc8128.
+ * This is the recommended transport for new integrations.
+ */
+export declare function createErc8128TransportLayer(config: {
+    signer: EthHttpSigner;
+    /** Whether to prefer replayable signatures (default false) */
+    preferReplayable?: boolean;
+    /** Signature TTL in seconds (default 60) */
+    ttlSeconds?: number;
+}): {
+    client: import("@slicekit/erc8128").SignerClient;
+    signRequest: (input: RequestInfo, init?: RequestInit) => Promise<Request>;
+    fetch: (input: RequestInfo, init?: RequestInit) => Promise<Response>;
+};
+export {};
+//# sourceMappingURL=transport-layer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport-layer.d.ts","sourceRoot":"","sources":["../../src/transport/transport-layer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEnG,UAAU,eAAe;IACvB,MAAM,EAAE,CACN,OAAO,EAAE,UAAU,KAChB,OAAO,CAAC;QAAE,SAAS,EAAE,UAAU,CAAC;QAAC,SAAS,EAAE,kBAAkB,CAAA;KAAE,CAAC,CAAC;IACvE,QAAQ,CAAC,EAAE,CACT,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,UAAU,EACrB,SAAS,EAAE,kBAAkB,KAC1B,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CA8H7E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,MAAM,EAAE,aAAa,CAAC;IACtB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;;yBAQwB,WAAW,SAAS,WAAW;mBACrC,WAAW,SAAS,WAAW;EAEjD"}

package/dist/transport/transport-layer.js

@@ -0,0 +1,110 @@
+import { createSignerClient } from "@slicekit/erc8128";
+export function createTransportLayer(config) {
+    const nonceCache = new Map(); // nonce -> timestamp
+    const NONCE_TTL = config.nonceTTL ?? 5 * 60 * 1000;
+    const TIMESTAMP_TOLERANCE = 30 * 1000; // ±30s
+    // Periodic cleanup
+    function cleanNonces() {
+        const now = Date.now();
+        for (const [nonce, ts] of nonceCache) {
+            if (now - ts > NONCE_TTL)
+                nonceCache.delete(nonce);
+        }
+    }
+    async function computePayload(method, url, timestamp, nonce, body) {
+        const bodyHash = body
+            ? new Uint8Array(await crypto.subtle.digest("SHA-256", new TextEncoder().encode(JSON.stringify(body))))
+            : new Uint8Array(0);
+        const payload = new TextEncoder().encode(`${method}\n${url}\n${timestamp}\n${nonce}\n${Array.from(bodyHash)
+            .map((b) => b.toString(16).padStart(2, "0"))
+            .join("")}`);
+        return payload;
+    }
+    return {
+        async createSignedRequest(request) {
+            const timestamp = Date.now();
+            const nonce = crypto.randomUUID();
+            const payload = await computePayload(request.method, request.url, timestamp, nonce, request.body);
+            const { signature, algorithm } = await config.signer(payload);
+            const headers = {
+                ...request.headers,
+                "X-OrbitMem-Signer": config.signerAddress,
+                "X-OrbitMem-Family": config.family,
+                "X-OrbitMem-Algorithm": algorithm,
+                "X-OrbitMem-Timestamp": String(timestamp),
+                "X-OrbitMem-Nonce": nonce,
+                "X-OrbitMem-Signature": Array.from(signature)
+                    .map((b) => b.toString(16).padStart(2, "0"))
+                    .join(""),
+            };
+            return {
+                url: request.url,
+                method: request.method ?? "GET",
+                headers,
+                body: request.body,
+                proof: {
+                    signer: config.signerAddress,
+                    family: config.family,
+                    signature,
+                    algorithm,
+                    timestamp,
+                    nonce,
+                },
+            };
+        },
+        async verifyRequest(request) {
+            cleanNonces();
+            const { proof } = request;
+            // Timestamp check
+            const now = Date.now();
+            if (Math.abs(now - proof.timestamp) > TIMESTAMP_TOLERANCE) {
+                return { valid: false, signer: proof.signer, family: proof.family, isReplay: false };
+            }
+            // Nonce replay check
+            if (nonceCache.has(proof.nonce)) {
+                return { valid: true, signer: proof.signer, family: proof.family, isReplay: true };
+            }
+            // Signature verification
+            if (config.verifier) {
+                const payload = await computePayload(request.method, request.url, proof.timestamp, proof.nonce, request.body);
+                const valid = await config.verifier(payload, proof.signature, proof.algorithm);
+                if (valid) {
+                    nonceCache.set(proof.nonce, Date.now());
+                }
+                return { valid, signer: proof.signer, family: proof.family, isReplay: false };
+            }
+            // No verifier — trust the signature (for client-side use)
+            nonceCache.set(proof.nonce, Date.now());
+            return { valid: true, signer: proof.signer, family: proof.family, isReplay: false };
+        },
+        async fetch(url, init) {
+            const signed = await this.createSignedRequest({
+                url,
+                method: init?.method ?? "GET",
+                headers: init?.headers,
+                body: init?.body,
+            });
+            return globalThis.fetch(signed.url, {
+                method: signed.method,
+                headers: signed.headers,
+                body: signed.body ? JSON.stringify(signed.body) : undefined,
+            });
+        },
+    };
+}
+/**
+ * Create an RFC 9421 / ERC-8128 compliant transport layer using @slicekit/erc8128.
+ * This is the recommended transport for new integrations.
+ */
+export function createErc8128TransportLayer(config) {
+    const client = createSignerClient(config.signer, {
+        preferReplayable: config.preferReplayable ?? false,
+        ttlSeconds: config.ttlSeconds ?? 60,
+    });
+    return {
+        client,
+        signRequest: (input, init) => client.signRequest(input, init),
+        fetch: (input, init) => client.fetch(input, init),
+    };
+}
+//# sourceMappingURL=transport-layer.js.map

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

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