@orangecheck/sdk 1.1.0 → 1.2.0

package/dist/index.d.mts

@@ -33,6 +33,7 @@ interface CheckResult {
 }
 declare function check(params: CheckParams): Promise<CheckResult>;
 
+declare const BINDING_KIND = 30079;
 interface BindingInput {
     principal: string;
     btc: string;
@@ -57,6 +58,7 @@ interface BindingEnvelope {
     btc?: string;
     nostr?: string;
     message: string;
+    message_b64url?: string;
     btc_signature?: string;
     btc_scheme?: 'bip322' | 'legacy';
     nostr_event?: BindingNostrEvent;
@@ -76,6 +78,27 @@ type BindingVerifyResult = {
 declare function buildBindingMessage(input: BindingInput): string;
 declare function bindingId(message: string): string;
 declare function verifyBinding(envelope: BindingEnvelope): BindingVerifyResult;
+declare function xOnlyHexToNpub(hex: string): string;
+interface BindingEventTemplate {
+    kind: typeof BINDING_KIND;
+    pubkey: string;
+    created_at: number;
+    tags: string[][];
+    content: string;
+}
+declare function buildBindingEventTemplate(params: {
+    message: string;
+    btcSignature: string;
+    nostrPubkeyHex: string;
+    btc: string;
+    createdAt?: number;
+}): BindingEventTemplate;
+declare function assembleBindingEnvelope(params: {
+    message: string;
+    btcSignature: string;
+    btcScheme?: 'bip322' | 'legacy';
+    nostrEvent: BindingNostrEvent;
+}): BindingEnvelope;
 
 declare function isNip07Available(): boolean;
 declare function getNostrPublicKey(): Promise<string | null>;
@@ -94,4 +117,4 @@ interface StatusMeta {
 }
 declare const STATUS_META: Record<StatusCode, StatusMeta>;
 
-export { type BindingEnvelope, type BindingInput, type BindingNostrEvent, type BindingStatus, type BindingVerifyResult, type CheckParams, type CheckResult, IdentityBinding, Network, NostrEvent, STATUS_META, type Severity, StatusCode, type StatusMeta, VerifyOptions, bindingId, buildBindingMessage, check, getNip07Info, getNostrPublicKey, isNip07Available, signNostrEvent, verifyBinding };
+export { type BindingEnvelope, type BindingEventTemplate, type BindingInput, type BindingNostrEvent, type BindingStatus, type BindingVerifyResult, type CheckParams, type CheckResult, IdentityBinding, Network, NostrEvent, STATUS_META, type Severity, StatusCode, type StatusMeta, VerifyOptions, assembleBindingEnvelope, bindingId, buildBindingEventTemplate, buildBindingMessage, check, getNip07Info, getNostrPublicKey, isNip07Available, signNostrEvent, verifyBinding, xOnlyHexToNpub };

package/dist/index.d.ts

@@ -33,6 +33,7 @@ interface CheckResult {
 }
 declare function check(params: CheckParams): Promise<CheckResult>;
 
+declare const BINDING_KIND = 30079;
 interface BindingInput {
     principal: string;
     btc: string;
@@ -57,6 +58,7 @@ interface BindingEnvelope {
     btc?: string;
     nostr?: string;
     message: string;
+    message_b64url?: string;
     btc_signature?: string;
     btc_scheme?: 'bip322' | 'legacy';
     nostr_event?: BindingNostrEvent;
@@ -76,6 +78,27 @@ type BindingVerifyResult = {
 declare function buildBindingMessage(input: BindingInput): string;
 declare function bindingId(message: string): string;
 declare function verifyBinding(envelope: BindingEnvelope): BindingVerifyResult;
+declare function xOnlyHexToNpub(hex: string): string;
+interface BindingEventTemplate {
+    kind: typeof BINDING_KIND;
+    pubkey: string;
+    created_at: number;
+    tags: string[][];
+    content: string;
+}
+declare function buildBindingEventTemplate(params: {
+    message: string;
+    btcSignature: string;
+    nostrPubkeyHex: string;
+    btc: string;
+    createdAt?: number;
+}): BindingEventTemplate;
+declare function assembleBindingEnvelope(params: {
+    message: string;
+    btcSignature: string;
+    btcScheme?: 'bip322' | 'legacy';
+    nostrEvent: BindingNostrEvent;
+}): BindingEnvelope;
 
 declare function isNip07Available(): boolean;
 declare function getNostrPublicKey(): Promise<string | null>;
@@ -94,4 +117,4 @@ interface StatusMeta {
 }
 declare const STATUS_META: Record<StatusCode, StatusMeta>;
 
-export { type BindingEnvelope, type BindingInput, type BindingNostrEvent, type BindingStatus, type BindingVerifyResult, type CheckParams, type CheckResult, IdentityBinding, Network, NostrEvent, STATUS_META, type Severity, StatusCode, type StatusMeta, VerifyOptions, bindingId, buildBindingMessage, check, getNip07Info, getNostrPublicKey, isNip07Available, signNostrEvent, verifyBinding };
+export { type BindingEnvelope, type BindingEventTemplate, type BindingInput, type BindingNostrEvent, type BindingStatus, type BindingVerifyResult, type CheckParams, type CheckResult, IdentityBinding, Network, NostrEvent, STATUS_META, type Severity, StatusCode, type StatusMeta, VerifyOptions, assembleBindingEnvelope, bindingId, buildBindingEventTemplate, buildBindingMessage, check, getNip07Info, getNostrPublicKey, isNip07Available, signNostrEvent, verifyBinding, xOnlyHexToNpub };

package/dist/index.js

@@ -1360,6 +1360,63 @@ function verifyBinding(envelope) {
     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 base.bech32.encode("npub", base.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() {
@@ -2297,7 +2354,9 @@ var STATUS_META = {
 
 exports.DEFAULT_RELAYS = DEFAULT_RELAYS;
 exports.STATUS_META = STATUS_META;
+exports.assembleBindingEnvelope = assembleBindingEnvelope;
 exports.bindingId = bindingId;
+exports.buildBindingEventTemplate = buildBindingEventTemplate;
 exports.buildBindingMessage = buildBindingMessage;
 exports.buildCanonicalMessage = buildCanonicalMessage;
 exports.check = check;
@@ -2357,5 +2416,6 @@ exports.verifyGitHubIdentity = verifyGitHubIdentity;
 exports.verifyIdentity = verifyIdentity;
 exports.verifyNostrIdentity = verifyNostrIdentity;
 exports.verifyTwitterIdentity = verifyTwitterIdentity;
+exports.xOnlyHexToNpub = xOnlyHexToNpub;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map