@calimero-network/mero-js 19.2.0 → 19.4.0

package/dist/index.d.ts

@@ -22,6 +22,10 @@ export type { DeviceCertInput } from './device-cert/index.js';
 export { signMemberJoinOp, encodeSignedInvitation, SIGNED_NAMESPACE_OP_SCHEMA_VERSION, } from './namespace-op/index.js';
 export type { SignMemberJoinInput } from './namespace-op/index.js';
 export type { WarrantInput } from './warrant/index.js';
+export { signLoginStatement } from './login/index.js';
+export type { Audience, LoginStatementInput } from './login/index.js';
+export { login, generateSessionKey } from './login/index.js';
+export type { LoginConfig, DelegatedSession, SessionKeyPair, } from './login/index.js';
 export * from './capabilities.js';
 export { DEFAULT_LOCAL_NODE_PORTS, localNodeUrl, nodeEndpoint, probeNodeHealth, discoverLocalNodes, } from './nodeDiscovery.js';
 export type { DiscoverLocalNodesOptions } from './nodeDiscovery.js';

package/dist/index.js

@@ -26,6 +26,9 @@ export * from './relay/index.js';
 export { signWarrant, intentHash } from './warrant/index.js';
 export { signDeviceCert, mintDeviceId, deviceCertPayload, accountForRoot, } from './device-cert/index.js';
 export { signMemberJoinOp, encodeSignedInvitation, SIGNED_NAMESPACE_OP_SCHEMA_VERSION, } from './namespace-op/index.js';
+// Login-statement signing — the device's half of a password-free session
+export { signLoginStatement } from './login/index.js';
+export { login, generateSessionKey } from './login/index.js';
 // Member capability bitmask constants & helpers
 export * from './capabilities.js';
 // Utilities

package/dist/index.mjs

@@ -3608,6 +3608,171 @@ async function signMemberJoinOp(input) {
   return hex(concat(signable, signature, unendorsed));
 }
 
+// src/login/login.ts
+var SIGN_DOMAIN2 = new TextEncoder().encode("calimero.auth.login.v1");
+var AUDIENCE_TAG = {
+  webOrigin: 0,
+  codeSigningId: 1,
+  cli: 2
+};
+function audienceBody(audience) {
+  const encoder = new TextEncoder();
+  switch (audience.kind) {
+    case "webOrigin":
+      return encoder.encode(audience.origin);
+    case "codeSigningId":
+      return encoder.encode(audience.id);
+    case "cli":
+      return new Uint8Array(0);
+  }
+}
+function audienceSigningBytes(audience) {
+  return concat(
+    Uint8Array.from([AUDIENCE_TAG[audience.kind]]),
+    audienceBody(audience)
+  );
+}
+function audienceWire(audience) {
+  const tag = Uint8Array.from([AUDIENCE_TAG[audience.kind]]);
+  if (audience.kind === "cli") {
+    return tag;
+  }
+  const body = audienceBody(audience);
+  return concat(tag, u32le(body.length), body);
+}
+async function signLoginStatement(input) {
+  const node = fromHex(input.node, "node", 32);
+  const challenge = fromHex(input.challenge, "challenge", 32);
+  const sessionKey = fromHex(input.sessionKey, "sessionKey", 32);
+  const key = await importSigningKey(input.deviceSecret);
+  const deviceKey = await derivePublicKey(input.deviceSecret);
+  const issuedAt = u64le(input.issuedAt);
+  const expiresAt = u64le(input.expiresAt);
+  const preimage = await domainHash(SIGN_DOMAIN2, [
+    node,
+    audienceSigningBytes(input.audience),
+    challenge,
+    sessionKey,
+    deviceKey,
+    issuedAt,
+    expiresAt
+  ]);
+  const signature = new Uint8Array(
+    await crypto.subtle.sign({ name: "Ed25519" }, key, preimage)
+  );
+  return hex(
+    concat(
+      node,
+      audienceWire(input.audience),
+      challenge,
+      sessionKey,
+      deviceKey,
+      issuedAt,
+      expiresAt,
+      signature
+    )
+  );
+}
+
+// src/login/session.ts
+var DEFAULT_TTL_SECONDS2 = 300;
+async function generateSessionKey() {
+  const secret = hex(crypto.getRandomValues(new Uint8Array(32)));
+  return { publicKey: hex(await derivePublicKey(secret)), secret };
+}
+function audienceLabel(audience) {
+  switch (audience.kind) {
+    case "webOrigin":
+      return audience.origin;
+    case "codeSigningId":
+      return audience.id;
+    case "cli":
+      return "cli";
+  }
+}
+async function login(config) {
+  const baseUrl = config.nodeUrl.replace(/\/+$/, "");
+  const doFetch = config.fetch ?? globalThis.fetch;
+  const timeoutMs = config.timeoutMs ?? 1e4;
+  const request = async (path, init) => {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    let response;
+    try {
+      response = await doFetch(`${baseUrl}${path}`, {
+        ...init,
+        signal: controller.signal
+      });
+    } catch (err) {
+      throw new HTTPError(
+        0,
+        err instanceof Error ? err.name : "NetworkError",
+        `${baseUrl}${path}`,
+        new Headers(),
+        err instanceof Error ? err.message : String(err)
+      );
+    } finally {
+      clearTimeout(timer);
+    }
+    const text = await response.text().catch(() => "");
+    if (!response.ok) {
+      throw new HTTPError(
+        response.status,
+        response.statusText,
+        `${baseUrl}${path}`,
+        response.headers,
+        text
+      );
+    }
+    return text ? JSON.parse(text) : {};
+  };
+  const challengeBody = await request("/auth/challenge", {
+    method: "GET",
+    headers: { Accept: "application/json" }
+  });
+  const challenge = challengeBody.challenge ?? challengeBody.data?.challenge;
+  if (!challenge) {
+    throw new Error("the node issued no challenge");
+  }
+  const session = await generateSessionKey();
+  const issuedAt = Math.floor(Date.now() / 1e3);
+  const statement = await signLoginStatement({
+    node: config.node,
+    audience: config.audience,
+    challenge,
+    sessionKey: session.publicKey,
+    issuedAt,
+    expiresAt: issuedAt + (config.ttlSeconds ?? DEFAULT_TTL_SECONDS2),
+    deviceSecret: config.deviceSecret
+  });
+  const tokenBody = await request("/auth/token", {
+    method: "POST",
+    headers: { "Content-Type": "application/json", Accept: "application/json" },
+    body: JSON.stringify({
+      auth_method: "account_proof",
+      public_key: session.publicKey,
+      client_name: config.clientName ?? audienceLabel(config.audience),
+      timestamp: issuedAt,
+      provider_data: {
+        challenge,
+        login_statement: statement,
+        account_proof: config.accountProof
+      }
+    })
+  });
+  const accessToken = tokenBody.access_token ?? tokenBody.data?.access_token;
+  const refreshToken = tokenBody.refresh_token ?? tokenBody.data?.refresh_token;
+  if (!accessToken) {
+    throw new Error("the node minted no session");
+  }
+  return {
+    accessToken,
+    refreshToken: refreshToken ?? "",
+    sessionKey: session.publicKey,
+    sessionSecret: session.secret
+  };
+}
+
 // src/capabilities.ts
 var CAPABILITIES = {
   CAN_CREATE_CONTEXT: 1 << 0,
@@ -3740,15 +3905,18 @@ export {
   deviceCertPayload,
   discoverLocalNodes,
   encodeSignedInvitation,
+  generateSessionKey,
   hasCap,
   intentHash,
   jsonCodec,
   localNodeUrl,
+  login,
   mintDeviceId,
   nodeEndpoint,
   parseAuthCallback,
   probeNodeHealth,
   signDeviceCert,
+  signLoginStatement,
   signMemberJoinOp,
   signWarrant,
   withCap,