@moon-x/core 0.4.0 → 0.5.0

package/dist/sdk/index.js

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/sdk/index.ts
 var sdk_exports = {};
 __export(sdk_exports, {
+  EphemeralSignerSignError: () => EphemeralSignerSignError,
   assertPasskeyInParent: () => assertPasskeyInParent,
   flattenPresenceTokens: () => flattenPresenceTokens,
   getHeadlessAuthenticationMethods: () => getHeadlessAuthenticationMethods,
@@ -37,7 +38,8 @@ __export(sdk_exports, {
   getHeadlessGeneralMethods: () => getHeadlessGeneralMethods,
   getHeadlessSolanaMethods: () => getHeadlessSolanaMethods,
   getInternalPresenceTokens: () => getInternalPresenceTokens,
-  getPresenceToken: () => getPresenceToken
+  getPresenceToken: () => getPresenceToken,
+  signWithEphemeralSigner: () => signWithEphemeralSigner
 });
 module.exports = __toCommonJS(sdk_exports);
 
@@ -244,6 +246,20 @@ var PostMessageMethod = {
   // dispatcher boring.
   SIGN_HASH: "SIGN_HASH",
   SIGN_7702_AUTHORIZATION: "SIGN_7702_AUTHORIZATION",
+  // Provision a SES (Secure Ephemeral Signer) over one or more of the
+  // user's MPC wallets. Iframe verifies the Nitro attestation, decrypts
+  // the selected keyshares, HPKE-seals them to the verified enclave
+  // pubkey, and returns a freshly-generated Ed25519 signer keypair.
+  // MoonX never persists the private key — the parent must hand it to
+  // the user immediately.
+  PROVISION_EPHEMERAL_SIGNER: "PROVISION_EPHEMERAL_SIGNER",
+  // List the user's active provisioned ephemeral signers from the
+  // wallets backend. Read-only; doesn't touch SES or the enclave.
+  LIST_EPHEMERAL_SIGNERS: "LIST_EPHEMERAL_SIGNERS",
+  // Soft-revoke a previously-provisioned ephemeral signer. The wallets
+  // backend updates revoked_at locally and forwards the revoke to SES
+  // so the enclave drops the policy.
+  REVOKE_EPHEMERAL_SIGNER: "REVOKE_EPHEMERAL_SIGNER",
   VERIFY_EMAIL_OTP: "VERIFY_EMAIL_OTP",
   VERIFY_OAUTH: "VERIFY_OAUTH",
   START_OAUTH: "START_OAUTH",
@@ -357,7 +373,8 @@ var getInternalPresenceTokens = async ({
   passkey,
   publishableKey,
   relyingPartyOrigin,
-  scopes
+  scopes,
+  scopeCounts
 }) => {
   const { token, optionsJSON } = await transport.send(
     PostMessageType.AUTH,
@@ -365,24 +382,36 @@ var getInternalPresenceTokens = async ({
     { publishableKey, relyingPartyOrigin }
   );
   const { response, userHandleB64url, credentialIdB64url } = await passkey.assertForInternalPresence({ optionsJSON });
+  const verifyPayload = {
+    publishableKey,
+    relyingPartyOrigin,
+    token,
+    response,
+    purpose: "internal"
+  };
+  if (scopes && scopes.length > 0) verifyPayload.scopes = scopes;
+  if (scopeCounts && Object.keys(scopeCounts).length > 0) {
+    verifyPayload.scope_counts = scopeCounts;
+  }
   const verify = await transport.send(
     PostMessageType.AUTH,
     PostMessageMethod.PASSKEY_PRESENCE_VERIFY,
-    {
-      publishableKey,
-      relyingPartyOrigin,
-      token,
-      response,
-      purpose: "internal",
-      scopes
-    }
+    verifyPayload
   );
   const out = {};
   for (const [scope, t] of Object.entries(verify.tokens ?? {})) {
     out[scope] = { token: t.token, expiresAt: t.expires_at };
   }
+  const outBatches = {};
+  for (const [scope, batch] of Object.entries(verify.token_batches ?? {})) {
+    outBatches[scope] = batch.map((t) => ({
+      token: t.token,
+      expiresAt: t.expires_at
+    }));
+  }
   return {
     tokens: out,
+    tokenBatches: outBatches,
     userHandleB64url,
     credentialIdB64url
   };
@@ -829,6 +858,8 @@ var getHeadlessAuthenticationMethods = ({
 var SCOPES_CREATE_WALLET = ["dek_bootstrap", "keyshare_write"];
 var SCOPES_IMPORT_KEY = ["dek_bootstrap", "keyshare_write"];
 var SCOPES_REMOVE_PASSKEY = ["passkey_remove"];
+var SCOPES_PROVISION_EPHEMERAL_SIGNER = ["keyshare_read"];
+var SCOPES_REVOKE_EPHEMERAL_SIGNER = ["ephemeral_signer_revoke"];
 var getHeadlessGeneralMethods = ({
   transport,
   passkey,
@@ -844,7 +875,11 @@ var getHeadlessGeneralMethods = ({
     { publishableKey }
   ),
   removePasskey: async (credentialIdB64url) => {
-    const { tokens, userHandleB64url, credentialIdB64url: assertedCredId } = await getInternalPresenceTokens({
+    const {
+      tokens,
+      userHandleB64url,
+      credentialIdB64url: assertedCredId
+    } = await getInternalPresenceTokens({
       transport,
       passkey,
       publishableKey,
@@ -917,6 +952,83 @@ var getHeadlessGeneralMethods = ({
     );
     return { wallet };
   },
+  provisionEphemeralSigner: async (params) => {
+    const walletCount = params.walletIds.length;
+    if (walletCount === 0) {
+      throw new Error(
+        "provisionEphemeralSigner: at least one walletId required"
+      );
+    }
+    const { userHandleB64url, credentialIdB64url, tokenBatches } = await getInternalPresenceTokens({
+      transport,
+      passkey,
+      publishableKey,
+      relyingPartyOrigin,
+      scopeCounts: { [SCOPES_PROVISION_EPHEMERAL_SIGNER[0]]: walletCount }
+    });
+    const keyshareReadBatch = (tokenBatches[SCOPES_PROVISION_EPHEMERAL_SIGNER[0]] ?? []).map((t) => t.token);
+    if (keyshareReadBatch.length !== walletCount) {
+      throw new Error(
+        `provisionEphemeralSigner: server returned ${keyshareReadBatch.length} tokens, expected ${walletCount}`
+      );
+    }
+    return transport.send(
+      PostMessageType.WALLET,
+      PostMessageMethod.PROVISION_EPHEMERAL_SIGNER,
+      {
+        publishableKey,
+        userHandleB64url,
+        credentialIdB64url,
+        // One keyshare_read token per wallet, parallel to params.walletIds
+        // (iframe consumes them positionally after wallet resolution).
+        presenceTokenBatches: {
+          [SCOPES_PROVISION_EPHEMERAL_SIGNER[0]]: keyshareReadBatch
+        },
+        walletIds: params.walletIds,
+        expiresAt: params.expiresAt?.toISOString(),
+        label: params.label
+      }
+    );
+  },
+  // Read-only: list the user's active (non-revoked) provisioned agents
+  // for the current app. No WebAuthn ceremony needed — the wallet
+  // session JWT is enough since this exposes only metadata (api_pub,
+  // key_ids, expiry) and not the private agent material.
+  listEphemeralSigners: async () => {
+    return transport.send(
+      PostMessageType.WALLET,
+      PostMessageMethod.LIST_EPHEMERAL_SIGNERS,
+      { publishableKey }
+    );
+  },
+  // Soft-revoke a signer (and forward the revoke to SES). Requires a
+  // fresh WebAuthn-bound presence token: ephemeral_signer_revoke scope. Wallet JWT
+  // alone isn't enough because revoke is destructive (DoS-grade) — the
+  // presence proof confirms it's really the user driving it.
+  revokeEphemeralSigner: async (params) => {
+    const { userHandleB64url, credentialIdB64url, tokens } = await getInternalPresenceTokens({
+      transport,
+      passkey,
+      publishableKey,
+      relyingPartyOrigin,
+      scopes: SCOPES_REVOKE_EPHEMERAL_SIGNER
+    });
+    await transport.send(
+      PostMessageType.WALLET,
+      PostMessageMethod.REVOKE_EPHEMERAL_SIGNER,
+      {
+        publishableKey,
+        apiPubHex: params.apiPubHex,
+        userHandleB64url,
+        credentialIdB64url,
+        presenceTokens: flattenPresenceTokens({
+          tokens,
+          userHandleB64url,
+          credentialIdB64url
+        })
+      }
+    );
+  },
   getWallets: async (walletType) => {
     const { wallets } = await transport.send(
       PostMessageType.WALLET,
@@ -933,11 +1045,9 @@ var getHeadlessGeneralMethods = ({
   // silently extend session lifetime.
   getSessionTokens: async () => {
     try {
-      const session = await transport.send(
-        PostMessageType.AUTH,
-        PostMessageMethod.GET_CURRENT_SESSION,
-        { publishableKey }
-      );
+      const session = await transport.send(PostMessageType.AUTH, PostMessageMethod.GET_CURRENT_SESSION, {
+        publishableKey
+      });
       return session ? {
         accessToken: session.accessToken,
         identityToken: session.identityToken,
@@ -1001,8 +1111,150 @@ var getHeadlessGeneralMethods = ({
     }
   }
 });
+
+// src/sdk/ephemeral-signer-sign.ts
+var import_ed25519 = require("@noble/curves/ed25519");
+var import_utils = require("@noble/hashes/utils");
+function normalizeBase(url) {
+  return url.replace(/\/+$/, "");
+}
+var EphemeralSignerSignError = class extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "EphemeralSignerSignError";
+  }
+};
+var bindingsCache = /* @__PURE__ */ new Map();
+async function resolveBinding(input) {
+  const cached = bindingsCache.get(input.apiPubHex);
+  if (cached) {
+    const hit2 = cached.find((b) => b.walletId === input.walletId);
+    if (hit2) return hit2;
+  }
+  const issuedAt = (/* @__PURE__ */ new Date()).toISOString();
+  const signedBodyBytes = new TextEncoder().encode(
+    JSON.stringify({ issued_at: issuedAt })
+  );
+  const apiPrivBytes = (0, import_utils.hexToBytes)(input.apiPrivHex);
+  const agentSig = import_ed25519.ed25519.sign(signedBodyBytes, apiPrivBytes);
+  const url = `${normalizeBase(input.baseUrl)}/v0/wallets/ephemeral-signers/me/wallets`;
+  const fetchFn = input.fetchImpl ?? fetch;
+  let response;
+  try {
+    response = await fetchFn(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `PublicToken ${input.publishableKey}`
+      },
+      body: JSON.stringify({
+        api_pub: input.apiPubHex,
+        signed_body: (0, import_utils.bytesToHex)(signedBodyBytes),
+        agent_signature: (0, import_utils.bytesToHex)(agentSig)
+      })
+    });
+  } catch (e) {
+    throw new EphemeralSignerSignError(
+      `wallet binding fetch failed: ${e instanceof Error ? e.message : String(e)}`
+    );
+  }
+  if (!response.ok) {
+    const body = await response.text().catch(() => "");
+    throw new EphemeralSignerSignError(
+      `wallet binding fetch failed: ${response.status}`,
+      response.status,
+      body
+    );
+  }
+  const json = await response.json();
+  const bindings = json.wallets.map((w) => ({
+    walletId: w.wallet_id,
+    keyId: w.key_id,
+    derivationPath: w.derivation_path
+  }));
+  bindingsCache.set(input.apiPubHex, bindings);
+  const hit = bindings.find((b) => b.walletId === input.walletId);
+  if (!hit) {
+    throw new EphemeralSignerSignError(
+      `walletId ${input.walletId} is not authorized for this agent`
+    );
+  }
+  return hit;
+}
+async function signWithEphemeralSigner(input) {
+  if (!/^[0-9a-f]{64}$/i.test(input.apiPubHex)) {
+    throw new EphemeralSignerSignError(
+      "apiPubHex must be 64 lowercase hex chars (32-byte Ed25519 pubkey)"
+    );
+  }
+  if (!/^[0-9a-f]{64}$/i.test(input.apiPrivHex)) {
+    throw new EphemeralSignerSignError(
+      "apiPrivHex must be 64 lowercase hex chars (32-byte Ed25519 privkey)"
+    );
+  }
+  if (!input.walletId) {
+    throw new EphemeralSignerSignError("walletId is required");
+  }
+  if (!input.rawSigningPayloadHex || !/^[0-9a-f]+$/i.test(input.rawSigningPayloadHex)) {
+    throw new EphemeralSignerSignError(
+      "rawSigningPayloadHex must be a non-empty lowercase hex string"
+    );
+  }
+  if (!input.publishableKey) {
+    throw new EphemeralSignerSignError(
+      "publishableKey is required \u2014 wallets backend gates /ephemeral-signers/* with RequirePublicToken"
+    );
+  }
+  const binding = await resolveBinding(input);
+  const issuedAt = (input.issuedAt ?? /* @__PURE__ */ new Date()).toISOString();
+  const signedPayload = {
+    raw_signing_payload: input.rawSigningPayloadHex,
+    key_id: binding.keyId,
+    derivation_path: binding.derivationPath,
+    issued_at: issuedAt
+  };
+  const signedBodyBytes = new TextEncoder().encode(
+    JSON.stringify(signedPayload)
+  );
+  const apiPrivBytes = (0, import_utils.hexToBytes)(input.apiPrivHex);
+  const agentSig = import_ed25519.ed25519.sign(signedBodyBytes, apiPrivBytes);
+  const requestBody = {
+    api_pub: input.apiPubHex,
+    signed_body: (0, import_utils.bytesToHex)(signedBodyBytes),
+    agent_signature: (0, import_utils.bytesToHex)(agentSig)
+  };
+  const url = `${normalizeBase(input.baseUrl)}/v0/wallets/ephemeral-signers/sign`;
+  const fetchFn = input.fetchImpl ?? fetch;
+  let response;
+  try {
+    response = await fetchFn(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `PublicToken ${input.publishableKey}`
+      },
+      body: JSON.stringify(requestBody)
+    });
+  } catch (e) {
+    throw new EphemeralSignerSignError(
+      `transport failure: ${e instanceof Error ? e.message : String(e)}`
+    );
+  }
+  if (!response.ok) {
+    const body = await response.text().catch(() => "");
+    throw new EphemeralSignerSignError(
+      `ephemeral signer sign failed: ${response.status}`,
+      response.status,
+      body
+    );
+  }
+  return await response.json();
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  EphemeralSignerSignError,
   assertPasskeyInParent,
   flattenPresenceTokens,
   getHeadlessAuthenticationMethods,
@@ -1010,5 +1262,6 @@ var getHeadlessGeneralMethods = ({
   getHeadlessGeneralMethods,
   getHeadlessSolanaMethods,
   getInternalPresenceTokens,
-  getPresenceToken
+  getPresenceToken,
+  signWithEphemeralSigner
 });