@orangecheck/sdk 1.0.0 → 1.2.0

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { Buffer } from 'buffer';
+import { Buffer as Buffer$1 } from 'buffer';
 import { Verifier } from 'bip322-js';
 import * as bitcoinMessage from 'bitcoinjs-message';
 import { schnorr } from '@noble/curves/secp256k1.js';
@@ -712,7 +712,7 @@ function looksLikeHex(s) {
 }
 function toBase64Maybe(sig) {
   if (looksLikeHex(sig)) {
-    return Buffer.from(sig, "hex").toString("base64");
+    return Buffer$1.from(sig, "hex").toString("base64");
   }
   return sig;
 }
@@ -1155,6 +1155,246 @@ async function check(params) {
     ...reasons.length ? { reasons } : {}
   };
 }
+var HEADER = "orangecheck-binding";
+var ACK = "I attest the keys named in this message are one principal.";
+var BINDING_KIND = 30079;
+function toHex(bytes) {
+  let out = "";
+  for (const b of bytes) out += b.toString(16).padStart(2, "0");
+  return out;
+}
+function fromHex(hex) {
+  const clean = hex.toLowerCase();
+  if (clean.length % 2 !== 0 || /[^0-9a-f]/.test(clean)) {
+    throw new Error("invalid hex");
+  }
+  const out = new Uint8Array(clean.length / 2);
+  for (let i = 0; i < out.length; i++) out[i] = parseInt(clean.slice(i * 2, i * 2 + 2), 16);
+  return out;
+}
+function assertPrintableAscii(field, value) {
+  for (let i = 0; i < value.length; i++) {
+    const c = value.charCodeAt(i);
+    if (c < 32 || c > 126) {
+      throw new Error(
+        `binding ${field} contains an unsafe character (0x${c.toString(16)}) \u2014 line-smuggling defense (SPEC-BINDING \xA73.5)`
+      );
+    }
+  }
+}
+function buildBindingMessage(input) {
+  assertPrintableAscii("principal", input.principal);
+  assertPrintableAscii("btc", input.btc);
+  assertPrintableAscii("nostr", input.nostr);
+  assertPrintableAscii("nonce", input.nonce);
+  assertPrintableAscii("issued_at", input.issued_at);
+  const core = [
+    HEADER,
+    "v: 1",
+    `principal: ${input.principal}`,
+    `btc: ${input.btc}`,
+    `nostr: ${input.nostr}`,
+    `nonce: ${input.nonce}`,
+    `issued_at: ${input.issued_at}`,
+    `ack: ${ACK}`
+  ];
+  const ext = [];
+  if (input.extensions) {
+    for (const key of Object.keys(input.extensions).sort()) {
+      const value = input.extensions[key];
+      if (value == null) continue;
+      if (!/^[a-z]+$/.test(key)) {
+        throw new Error(`binding extension key "${key}" must be lowercase ASCII`);
+      }
+      assertPrintableAscii(`extension ${key}`, value);
+      ext.push(`${key}: ${value}`);
+    }
+  }
+  return [...core, ...ext].join("\n") + "\n";
+}
+function bindingId(message) {
+  return toHex(sha256(new TextEncoder().encode(message)));
+}
+function linePrefix(line, prefix) {
+  if (typeof line !== "string" || !line.startsWith(prefix)) return null;
+  return line.slice(prefix.length);
+}
+function nostrEventId(ev) {
+  const serialized = JSON.stringify([
+    0,
+    ev.pubkey,
+    ev.created_at,
+    ev.kind,
+    ev.tags,
+    ev.content
+  ]);
+  return toHex(sha256(new TextEncoder().encode(serialized)));
+}
+function npubToXOnlyHex(npub) {
+  const decoded = bech32.decode(npub, 90);
+  if (decoded.prefix !== "npub") throw new Error("not an npub");
+  const bytes = Uint8Array.from(bech32.fromWords(decoded.words));
+  if (bytes.length !== 32) throw new Error("npub payload is not 32 bytes");
+  return toHex(bytes);
+}
+function verifyBinding(envelope) {
+  const fail = (status) => ({
+    valid: false,
+    status
+  });
+  try {
+    const msg = envelope.message;
+    if (typeof msg !== "string" || msg.length === 0) return fail("malformed");
+    const lines = msg.split("\n");
+    if ((lines[0] ?? "") !== HEADER) return fail("bad_header");
+    if (lines.length < 9 || lines[lines.length - 1] !== "") return fail("malformed");
+    const body = lines.slice(0, -1);
+    if (body.length < 8) return fail("malformed");
+    if (body[1] !== "v: 1") return fail("malformed");
+    if (body[7] !== `ack: ${ACK}`) return fail("bad_ack");
+    const principal = linePrefix(body[2], "principal: ");
+    const btc = linePrefix(body[3], "btc: ");
+    const nostr = linePrefix(body[4], "nostr: ");
+    const nonce = linePrefix(body[5], "nonce: ");
+    const issuedAt = linePrefix(body[6], "issued_at: ");
+    if (principal == null || btc == null || nostr == null || nonce == null || issuedAt == null) {
+      return fail("malformed");
+    }
+    for (const value of [principal, btc, nostr, nonce, issuedAt]) {
+      for (let i = 0; i < value.length; i++) {
+        const c = value.charCodeAt(i);
+        if (c < 32 || c > 126) return fail("malformed");
+      }
+    }
+    if (!/^did:oc:[0-9a-f]{32}$/.test(principal)) return fail("bad_principal");
+    if (!/^[0-9a-f]{32}$/.test(nonce)) return fail("malformed");
+    const ext = {};
+    let prevKey = "";
+    for (const line of body.slice(8)) {
+      const idx = line.indexOf(": ");
+      if (idx <= 0) return fail("malformed");
+      const key = line.slice(0, idx);
+      const value = line.slice(idx + 2);
+      if (!/^[a-z]+$/.test(key)) return fail("malformed");
+      if (key <= prevKey) return fail("ext_unsorted");
+      prevKey = key;
+      ext[key] = value;
+    }
+    const bid = bindingId(msg);
+    if (envelope.binding_id && envelope.binding_id.toLowerCase() !== bid) {
+      return fail("id_mismatch");
+    }
+    if (envelope.btc && envelope.btc !== btc) return fail("field_mismatch");
+    if (envelope.nostr && envelope.nostr !== nostr) return fail("field_mismatch");
+    if (envelope.principal && envelope.principal !== principal) return fail("field_mismatch");
+    if (ext.expires) {
+      const t = Date.parse(ext.expires);
+      if (!Number.isNaN(t) && Date.now() > t) return fail("expired");
+    }
+    if (typeof envelope.btc_signature !== "string" || !envelope.btc_signature) {
+      return fail("btc_sig_invalid");
+    }
+    const scheme = envelope.btc_scheme ?? "bip322";
+    let btcOk = false;
+    try {
+      if (scheme === "bip322") {
+        btcOk = Verifier.verifySignature(btc, msg, envelope.btc_signature);
+      } else if (scheme === "legacy") {
+        btcOk = bitcoinMessage.verify(msg, btc, envelope.btc_signature);
+      } else {
+        return fail("bad_scheme");
+      }
+    } catch {
+      btcOk = false;
+    }
+    if (!btcOk) return fail("btc_sig_invalid");
+    const ev = envelope.nostr_event;
+    if (!ev || ev.kind !== BINDING_KIND || typeof ev.id !== "string") return fail("malformed");
+    if (nostrEventId(ev) !== ev.id.toLowerCase()) return fail("nostr_id_invalid");
+    let nostrSigOk = false;
+    try {
+      nostrSigOk = schnorr.verify(fromHex(ev.sig), fromHex(ev.id), fromHex(ev.pubkey));
+    } catch {
+      nostrSigOk = false;
+    }
+    if (!nostrSigOk) return fail("nostr_sig_invalid");
+    let nostrXOnly;
+    try {
+      nostrXOnly = npubToXOnlyHex(nostr);
+    } catch {
+      return fail("nostr_key_mismatch");
+    }
+    if (nostrXOnly !== ev.pubkey.toLowerCase()) return fail("nostr_key_mismatch");
+    let content;
+    try {
+      content = JSON.parse(ev.content);
+    } catch {
+      return fail("message_mismatch");
+    }
+    if (content.message !== msg) return fail("message_mismatch");
+    if (content.btc_signature !== envelope.btc_signature) return fail("message_mismatch");
+    return { valid: true, status: "binding_ok", binding_id: bid, principal, btc, nostr };
+  } catch {
+    return fail("malformed");
+  }
+}
+function xOnlyHexToNpub(hex) {
+  const bytes = fromHex(hex);
+  if (bytes.length !== 32) throw new Error("x-only Nostr key must be 32 bytes");
+  return bech32.encode("npub", bech32.toWords(bytes), 90);
+}
+function buildBindingEventTemplate(params) {
+  const id = bindingId(params.message);
+  return {
+    kind: BINDING_KIND,
+    pubkey: params.nostrPubkeyHex.toLowerCase(),
+    created_at: params.createdAt ?? Math.floor(Date.now() / 1e3),
+    tags: [
+      ["d", `oc-attest-binding:${id}`],
+      ["btc", params.btc],
+      ["oc", "binding-attestation"],
+      ["v", "1"]
+    ],
+    content: JSON.stringify({ message: params.message, btc_signature: params.btcSignature })
+  };
+}
+function parseBindingFields(message) {
+  const body = message.split("\n");
+  const at = (i, prefix) => {
+    const line = body[i];
+    if (typeof line !== "string" || !line.startsWith(prefix)) {
+      throw new Error(`binding message line ${i + 1} is malformed`);
+    }
+    return line.slice(prefix.length);
+  };
+  return {
+    principal: at(2, "principal: "),
+    btc: at(3, "btc: "),
+    nostr: at(4, "nostr: ")
+  };
+}
+function toBase64Url(s) {
+  const bytes = new TextEncoder().encode(s);
+  let bin = "";
+  for (const b of bytes) bin += String.fromCharCode(b);
+  const b64 = typeof btoa !== "undefined" ? btoa(bin) : Buffer.from(bytes).toString("base64");
+  return b64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function assembleBindingEnvelope(params) {
+  const { principal, btc, nostr } = parseBindingFields(params.message);
+  return {
+    binding_id: bindingId(params.message),
+    v: 1,
+    principal,
+    btc,
+    nostr,
+    message: params.message,
+    message_b64url: toBase64Url(params.message),
+    btc_signature: params.btcSignature,
+    btc_scheme: params.btcScheme ?? "bip322",
+    nostr_event: params.nostrEvent
+  };
+}
 var AUTH_HEADER = "orangecheck-auth";
 var AUTH_ACK = "I authorize this session under the OrangeCheck auth challenge.";
 function randomNonce() {
@@ -1272,7 +1512,7 @@ async function verifyChallenge(opts) {
   let sigValid = false;
   try {
     if (scheme === "bip322") {
-      const sigBase64 = /^[0-9a-fA-F]+$/.test(opts.signature) && opts.signature.length % 2 === 0 ? Buffer.from(opts.signature, "hex").toString("base64") : opts.signature;
+      const sigBase64 = /^[0-9a-fA-F]+$/.test(opts.signature) && opts.signature.length % 2 === 0 ? Buffer$1.from(opts.signature, "hex").toString("base64") : opts.signature;
       sigValid = Verifier.verifySignature(address, opts.message, sigBase64);
     } else if (scheme === "legacy") {
       if (!/^[1m][a-km-zA-HJ-NP-Z1-9]{25,34}$/.test(address)) {
@@ -1610,12 +1850,12 @@ function getGistCreationUrl() {
 }
 var log7 = createLogger("identity-verification/nostr");
 var HEX_64_RE = /^[0-9a-f]{64}$/;
-function toHex(bytes) {
+function toHex2(bytes) {
   let out = "";
   for (const b of bytes) out += b.toString(16).padStart(2, "0");
   return out;
 }
-function fromHex(hex) {
+function fromHex2(hex) {
   if (hex.length % 2 !== 0) throw new Error("odd-length hex");
   const out = new Uint8Array(hex.length / 2);
   for (let i = 0; i < out.length; i++) {
@@ -1639,7 +1879,7 @@ function npubToHex(npub) {
   if (bytes.length !== 32) {
     throw new Error(`invalid npub payload length: ${bytes.length}`);
   }
-  return toHex(Uint8Array.from(bytes));
+  return toHex2(Uint8Array.from(bytes));
 }
 async function queryNostrEvents(options) {
   const { authors, kinds, search, relays = DEFAULT_RELAYS, limit = 100 } = options;
@@ -1722,7 +1962,7 @@ async function verifyNostrEventSignature(event) {
       event.tags ?? [],
       event.content ?? ""
     ]);
-    const computedId = toHex(sha256(new TextEncoder().encode(preimage)));
+    const computedId = toHex2(sha256(new TextEncoder().encode(preimage)));
     if (computedId !== event.id.toLowerCase()) {
       log7.warn(
         { eventId: event.id, computedId },
@@ -1730,7 +1970,7 @@ async function verifyNostrEventSignature(event) {
       );
       return false;
     }
-    return schnorr.verify(fromHex(event.sig), fromHex(event.id), fromHex(event.pubkey));
+    return schnorr.verify(fromHex2(event.sig), fromHex2(event.id), fromHex2(event.pubkey));
   } catch (err) {
     log7.warn({ err }, "schnorr verify threw");
     return false;
@@ -2090,6 +2330,6 @@ var STATUS_META = {
   }
 };
 
-export { DEFAULT_RELAYS, STATUS_META, buildCanonicalMessage, check, computeAllScores, computeScore, createAttestation, createAttestationEnvelope, createAttestationEvent, discoverAttestations, extractAttestationIdFromUrl, formatIdentities, formatIdentitiesForDisplay, generateAttestationId, generateGistTemplate, generateTweetText, generateWellKnownContent, getAttestationsForAddress, getAttestationsForIdentity, getDnsVerificationInstructions, getGistCreationUrl, getGitHubVerificationInstructions, getManualVerificationInstructions, getNip07Info, getNostrPublicKey, getNostrVerificationInstructions, getTweetUrl, getTwitterComposeUrl, getTwitterVerificationInstructions, getVerificationInstructions, getVerificationSummary, getVerificationUrl, getWellKnownUrl, isDnsIdentityVerified, isGitHubIdentityVerified, isNip07Available, isNostrIdentityVerified, isValidDomain, isValidTweetUrl, issueChallenge, parseAttestationFromEvent, parseIdentities, publishAttestation, publishToRelays, queryByAddress, queryByAttestationId, queryByIdentity, requiresManualVerification, signNostrEvent, supportsAutomaticVerification, verify2 as verify, verifyAllIdentities, verifyAttestationById, verifyChallenge, verifyDnsIdentity, verifyGitHubIdentity, verifyIdentity, verifyNostrIdentity, verifyTwitterIdentity };
+export { DEFAULT_RELAYS, STATUS_META, assembleBindingEnvelope, bindingId, buildBindingEventTemplate, buildBindingMessage, buildCanonicalMessage, check, computeAllScores, computeScore, createAttestation, createAttestationEnvelope, createAttestationEvent, discoverAttestations, extractAttestationIdFromUrl, formatIdentities, formatIdentitiesForDisplay, generateAttestationId, generateGistTemplate, generateTweetText, generateWellKnownContent, getAttestationsForAddress, getAttestationsForIdentity, getDnsVerificationInstructions, getGistCreationUrl, getGitHubVerificationInstructions, getManualVerificationInstructions, getNip07Info, getNostrPublicKey, getNostrVerificationInstructions, getTweetUrl, getTwitterComposeUrl, getTwitterVerificationInstructions, getVerificationInstructions, getVerificationSummary, getVerificationUrl, getWellKnownUrl, isDnsIdentityVerified, isGitHubIdentityVerified, isNip07Available, isNostrIdentityVerified, isValidDomain, isValidTweetUrl, issueChallenge, parseAttestationFromEvent, parseIdentities, publishAttestation, publishToRelays, queryByAddress, queryByAttestationId, queryByIdentity, requiresManualVerification, signNostrEvent, supportsAutomaticVerification, verify2 as verify, verifyAllIdentities, verifyAttestationById, verifyBinding, verifyChallenge, verifyDnsIdentity, verifyGitHubIdentity, verifyIdentity, verifyNostrIdentity, verifyTwitterIdentity, xOnlyHexToNpub };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map