@orangecheck/sdk 1.2.0 → 1.4.0

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { Buffer as Buffer$1 } from 'buffer';
+import { Buffer } from 'buffer';
 import { Verifier } from 'bip322-js';
 import * as bitcoinMessage from 'bitcoinjs-message';
 import { schnorr } from '@noble/curves/secp256k1.js';
@@ -193,14 +193,19 @@ var DEFAULT_RELAYS = [
   "wss://relay.damus.io",
   "wss://relay.nostr.band",
   "wss://nos.lol",
-  "wss://relay.snort.social"
+  "wss://relay.snort.social",
+  "wss://relay.ochk.io"
 ];
 function createAttestationEvent(envelope, pubkey) {
   const tags = [
     ["d", envelope.attestation_id],
-    // Parameterized replaceable event identifier
+    // Parameterized replaceable event identifier (indexed)
+    ["t", envelope.address],
+    // Indexed btc-address tag — query with `#t`
+    ["t", "oc-attest"],
+    // Family marker — `#t=["oc-attest"]` for cross-cut discovery
     ["address", envelope.address],
-    // Bitcoin address
+    // Diagnostic / legacy — relay won't index this
     ["scheme", envelope.scheme],
     // Signature scheme (bip322 or legacy)
     ["issued_at", envelope.issued_at]
@@ -232,6 +237,17 @@ async function publishToRelays(event, relays = DEFAULT_RELAYS) {
   log.info({ eventId: event.id, relayCount: relays.length }, "Publishing event to relays");
   const publishPromises = relays.map(async (relayUrl) => {
     let ws = null;
+    let settled = false;
+    const recordSuccess = () => {
+      if (settled) return;
+      settled = true;
+      success.push(relayUrl);
+    };
+    const recordFailure = () => {
+      if (settled) return;
+      settled = true;
+      failed.push(relayUrl);
+    };
     try {
       ws = new WebSocket(relayUrl);
       const wsRef = ws;
@@ -252,7 +268,7 @@ async function publishToRelays(event, relays = DEFAULT_RELAYS) {
             const data = JSON.parse(msg.data);
             if (data[0] === "OK" && data[1] === event.id) {
               if (data[2] === true) {
-                success.push(relayUrl);
+                recordSuccess();
                 cleanup();
                 resolve();
               } else {
@@ -260,7 +276,7 @@ async function publishToRelays(event, relays = DEFAULT_RELAYS) {
                   { relay: relayUrl, reason: data[3] },
                   "Relay rejected event"
                 );
-                failed.push(relayUrl);
+                recordFailure();
                 cleanup();
                 reject(new Error(data[3] || "Relay rejected event"));
               }
@@ -270,14 +286,14 @@ async function publishToRelays(event, relays = DEFAULT_RELAYS) {
               { relay: relayUrl, error: err },
               "Failed to parse relay response"
             );
-            failed.push(relayUrl);
+            recordFailure();
             cleanup();
             reject(err);
           }
         };
         wsRef.onerror = (err) => {
           log.error({ relay: relayUrl, error: err }, "WebSocket error");
-          failed.push(relayUrl);
+          recordFailure();
           cleanup();
           reject(err);
         };
@@ -287,9 +303,7 @@ async function publishToRelays(event, relays = DEFAULT_RELAYS) {
       });
     } catch (err) {
       log.error({ relay: relayUrl, error: err }, "Failed to publish to relay");
-      if (!failed.includes(relayUrl)) {
-        failed.push(relayUrl);
-      }
+      recordFailure();
     } finally {
       if (ws && ws.readyState !== WebSocket.CLOSED) {
         ws.close();
@@ -384,8 +398,15 @@ async function queryByAddress(address, relays = DEFAULT_RELAYS) {
               subscriptionId,
               {
                 kinds: [30078],
-                "#address": [address],
-                limit: 10
+                // `#t`, NOT `#address`: NIP-12 relays index
+                // single-letter tags only, so `#address`
+                // matched nothing on any relay and this
+                // function returned empty for every real
+                // attestation. attest.ochk.io's verifier has
+                // queried `#t` since the same fix landed
+                // there; this is the back-port.
+                "#t": [address],
+                limit: 50
               }
             ])
           );
@@ -712,7 +733,7 @@ function looksLikeHex(s) {
 }
 function toBase64Maybe(sig) {
   if (looksLikeHex(sig)) {
-    return Buffer$1.from(sig, "hex").toString("base64");
+    return Buffer.from(sig, "hex").toString("base64");
   }
   return sig;
 }
@@ -1155,246 +1176,6 @@ 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() {
@@ -1512,7 +1293,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$1.from(opts.signature, "hex").toString("base64") : opts.signature;
+      const sigBase64 = /^[0-9a-fA-F]+$/.test(opts.signature) && opts.signature.length % 2 === 0 ? Buffer.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)) {
@@ -1850,12 +1631,12 @@ function getGistCreationUrl() {
 }
 var log7 = createLogger("identity-verification/nostr");
 var HEX_64_RE = /^[0-9a-f]{64}$/;
-function toHex2(bytes) {
+function toHex(bytes) {
   let out = "";
   for (const b of bytes) out += b.toString(16).padStart(2, "0");
   return out;
 }
-function fromHex2(hex) {
+function fromHex(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++) {
@@ -1879,7 +1660,7 @@ function npubToHex(npub) {
   if (bytes.length !== 32) {
     throw new Error(`invalid npub payload length: ${bytes.length}`);
   }
-  return toHex2(Uint8Array.from(bytes));
+  return toHex(Uint8Array.from(bytes));
 }
 async function queryNostrEvents(options) {
   const { authors, kinds, search, relays = DEFAULT_RELAYS, limit = 100 } = options;
@@ -1962,7 +1743,7 @@ async function verifyNostrEventSignature(event) {
       event.tags ?? [],
       event.content ?? ""
     ]);
-    const computedId = toHex2(sha256(new TextEncoder().encode(preimage)));
+    const computedId = toHex(sha256(new TextEncoder().encode(preimage)));
     if (computedId !== event.id.toLowerCase()) {
       log7.warn(
         { eventId: event.id, computedId },
@@ -1970,7 +1751,7 @@ async function verifyNostrEventSignature(event) {
       );
       return false;
     }
-    return schnorr.verify(fromHex2(event.sig), fromHex2(event.id), fromHex2(event.pubkey));
+    return schnorr.verify(fromHex(event.sig), fromHex(event.id), fromHex(event.pubkey));
   } catch (err) {
     log7.warn({ err }, "schnorr verify threw");
     return false;
@@ -2330,6 +2111,6 @@ var STATUS_META = {
   }
 };
 
-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 };
+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 };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map