@orangecheck/sdk 1.18.0 → 1.18.2

package/dist/challenge.js

@@ -4,6 +4,34 @@ var bip322 = require('@orangecheck/bip322');
 var buffer = require('buffer');
 
 // src/challenge.ts
+
+// src/options.ts
+function refuseUnknown(where, opts, known) {
+  if (opts === null || typeof opts !== "object") {
+    throw new TypeError(`@orangecheck/sdk: ${where} must be an object`);
+  }
+  const unknown = Object.keys(opts).filter((k) => !known.has(k));
+  if (unknown.length > 0) {
+    throw new TypeError(
+      `@orangecheck/sdk: ${where}: unknown option ${unknown.join(", ")}. It reads only ${[...known].join(", ")}.`
+    );
+  }
+  const inherited = [...known].filter((k) => k in opts && !Object.prototype.hasOwnProperty.call(opts, k));
+  if (inherited.length > 0) {
+    throw new TypeError(`@orangecheck/sdk: ${where}: option ${inherited.join(", ")} is inherited, not set by the caller`);
+  }
+}
+var CHALLENGE_OPTIONS = /* @__PURE__ */ new Set([
+  "address",
+  "ttlSeconds",
+  "nonce",
+  "audience",
+  "purpose",
+  "now"
+]);
+function checkChallengeOptions(opts) {
+  refuseUnknown("issueChallenge()", opts, CHALLENGE_OPTIONS);
+}
 function toBase64Maybe(sig) {
   if (/^[0-9a-fA-F]+$/.test(sig) && sig.length % 2 === 0) {
     return buffer.Buffer.from(sig, "hex").toString("base64");
@@ -32,6 +60,7 @@ function iso(date) {
   return date.toISOString().replace(/\.\d{3}Z$/, "Z");
 }
 function issueChallenge(opts) {
+  checkChallengeOptions(opts);
   const now = opts.now ?? /* @__PURE__ */ new Date();
   const ttl = opts.ttlSeconds ?? 300;
   const expiresAt = new Date(now.getTime() + ttl * 1e3);

package/dist/challenge.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/signature.ts","../src/challenge.ts"],"names":["Buffer","verifyBitcoinSignature"],"mappings":"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","file":"challenge.js","sourcesContent":["import type { Scheme } from '../types';\n\nimport { Buffer } from 'buffer';\n\n/** A signature as base64: hex input is converted, anything else passes through. */\nexport function toBase64Maybe(sig: string): string {\n    if (/^[0-9a-fA-F]+$/.test(sig) && sig.length % 2 === 0) {\n        return Buffer.from(sig, 'hex').toString('base64');\n    }\n    return sig;\n}\n\n/**\n * The scheme a signature's bytes say it is, the same rule @orangecheck/bip322\n * verifies by: 65 bytes is a BIP-137 compact signature, whatever the address,\n * and anything else is BIP-322 simple. `null` for a BIP-322 full or\n * proof-of-funds signature, which is not supported.\n */\nexport function signatureScheme(sigBase64: string): Scheme | null {\n    if (/^(ful|pof)/.test(sigBase64)) return null;\n    if (sigBase64.startsWith('smp')) return 'bip322';\n    return Buffer.from(sigBase64, 'base64').length === 65 ? 'legacy' : 'bip322';\n}\n","/**\n * Signed-challenge auth\n *\n * When a gate can't trust the address source (public header, query string,\n * unsigned cookie), run a one-shot BIP-322 challenge first to cryptographically\n * prove the caller controls the address. Bind the proven address to a session\n * cookie or JWT, and the gate reads from there.\n *\n * This is a different wire format from the main OCP attestation — the header\n * literal is `orangecheck-auth`, not `orangecheck`, so a signed auth challenge\n * can never be confused with a reputation attestation.\n *\n *   // Server, on the \"connect wallet\" flow:\n *   const challenge = issueChallenge({ address, ttlSeconds: 300 });\n *   // → send challenge.message to the client\n *\n *   // Client signs challenge.message with BIP-322 via the user's wallet,\n *   // then posts { message, signature } back.\n *\n *   // Server, on callback:\n *   const result = await verifyChallenge({ message, signature });\n *   if (result.ok) {\n *     // result.address is now cryptographically proven; attach to session.\n *   }\n */\n\nimport type { Scheme } from './types';\n\nimport { verifySignature as verifyBitcoinSignature } from '@orangecheck/bip322';\n\nimport { signatureScheme, toBase64Maybe } from './utils/signature';\n\nconst AUTH_HEADER = 'orangecheck-auth';\nconst AUTH_ACK = 'I authorize this session under the OrangeCheck auth challenge.';\n\nfunction randomNonce(): string {\n    // 16 bytes → 32 lowercase hex chars. Matches OCP core nonce format.\n    const bytes = new Uint8Array(16);\n    // Runtimes: Node 20+ (webcrypto), browsers.\n    if (typeof globalThis.crypto?.getRandomValues === 'function') {\n        globalThis.crypto.getRandomValues(bytes);\n    } else {\n        // Fallback: Math.random is *not* cryptographic — acceptable only for\n        // environments without webcrypto (old Node). Flagged explicitly.\n        for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 256);\n    }\n    return Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('');\n}\n\nfunction iso(date: Date): string {\n    return date.toISOString().replace(/\\.\\d{3}Z$/, 'Z');\n}\n\nexport interface IssueChallengeOptions {\n    /** Bitcoin address the caller claims to control. */\n    address: string;\n    /** How long the challenge is valid for. Default 300 (5 minutes). */\n    ttlSeconds?: number;\n    /** Explicit nonce. Rare; prefer auto-generated. */\n    nonce?: string;\n    /** Origin-binding extension. If set, verify will require a match. */\n    audience?: string;\n    /** Human-readable label baked into the signed message. */\n    purpose?: string;\n    /** Freeze `now` for tests. */\n    now?: Date;\n}\n\nexport interface Challenge {\n    /** The canonical text the client MUST sign. */\n    message: string;\n    /** The generated nonce (kept for correlation / server-side storage). */\n    nonce: string;\n    /** Unix ms epoch the challenge expires at. */\n    expiresAt: number;\n    /** ISO string of the same. */\n    expiresAtIso: string;\n}\n\n/**\n * Build a new signed-challenge message. The server MUST remember the nonce\n * it issued against the session (Redis, signed cookie, DB) so it can detect\n * replay or a different nonce coming back on verify.\n */\nexport function issueChallenge(opts: IssueChallengeOptions): Challenge {\n    const now = opts.now ?? new Date();\n    const ttl = opts.ttlSeconds ?? 300;\n    const expiresAt = new Date(now.getTime() + ttl * 1000);\n    const nonce = opts.nonce ?? randomNonce();\n\n    if (!/^[0-9a-f]{32}$/.test(nonce)) {\n        throw new Error('nonce must be 32 lowercase hex characters');\n    }\n\n    const coreLines = [\n        AUTH_HEADER,\n        `address: ${opts.address}`,\n        `nonce: ${nonce}`,\n        `issued_at: ${iso(now)}`,\n        `expires_at: ${iso(expiresAt)}`,\n        `ack: ${AUTH_ACK}`,\n    ];\n\n    const extensions: Array<[string, string]> = [];\n    if (opts.audience) extensions.push(['audience', opts.audience]);\n    if (opts.purpose) extensions.push(['purpose', opts.purpose]);\n    // Lexicographic sort by key — matches OCP canonicalization rules.\n    extensions.sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));\n\n    const extLines = extensions.map(([k, v]) => `${k}: ${v}`);\n    const message = [...coreLines, ...extLines].join('\\n') + '\\n';\n\n    return {\n        message,\n        nonce,\n        expiresAt: expiresAt.getTime(),\n        expiresAtIso: iso(expiresAt),\n    };\n}\n\ninterface ParsedChallenge {\n    address?: string;\n    nonce?: string;\n    issuedAt?: Date;\n    expiresAt?: Date;\n    ack?: string;\n    audience?: string;\n    purpose?: string;\n    extensions: Array<[string, string]>;\n}\n\nfunction parseChallenge(message: string): ParsedChallenge {\n    const lines = message.endsWith('\\n') ? message.slice(0, -1).split('\\n') : message.split('\\n');\n\n    if (lines[0] !== AUTH_HEADER) {\n        throw new Error('not an orangecheck-auth challenge');\n    }\n\n    const out: ParsedChallenge = { extensions: [] };\n    const coreKeys = ['address', 'nonce', 'issued_at', 'expires_at', 'ack'] as const;\n    const coreKeySet = new Set<string>(coreKeys);\n    // Duplicate detection: a challenge with two `address:` lines would\n    // previously let the second overwrite the first. A signer who saw both\n    // lines would still sign the whole text — which means the verifier and\n    // the signer disagree about what the message \"said\". Refuse instead.\n    const seenCore = new Set<string>();\n\n    for (let i = 1; i < lines.length; i++) {\n        const line = lines[i] ?? '';\n        const sep = line.indexOf(': ');\n        if (sep === -1) continue;\n        const key = line.slice(0, sep);\n        const val = line.slice(sep + 2);\n\n        if (coreKeySet.has(key)) {\n            if (seenCore.has(key)) {\n                throw new Error(`duplicate core key in challenge: ${key}`);\n            }\n            seenCore.add(key);\n            if (key === 'address') out.address = val;\n            else if (key === 'nonce') out.nonce = val;\n            else if (key === 'issued_at') out.issuedAt = new Date(val);\n            else if (key === 'expires_at') out.expiresAt = new Date(val);\n            else if (key === 'ack') out.ack = val;\n        } else {\n            out.extensions.push([key, val]);\n            if (key === 'audience') out.audience = val;\n            if (key === 'purpose') out.purpose = val;\n        }\n    }\n\n    if (seenCore.size !== coreKeys.length) {\n        throw new Error(`challenge missing core lines (${seenCore.size}/${coreKeys.length})`);\n    }\n    return out;\n}\n\nexport interface VerifyChallengeOptions {\n    /** The signed canonical challenge text, exactly as issued. */\n    message: string;\n    /** BIP-322 or legacy signature, base64 or hex. */\n    signature: string;\n    /** @deprecated Ignored: the signature's own bytes decide the scheme. */\n    scheme?: Scheme;\n\n    /** If set, require the challenge's `audience:` extension to match. */\n    expectedAudience?: string;\n    /** If set, require the challenge's `purpose:` extension to match. */\n    expectedPurpose?: string;\n    /**\n     * If set, require the challenge's `nonce:` to match. Use this to defeat\n     * replay — pair with server-side nonce storage (Redis / signed cookie).\n     */\n    expectedNonce?: string;\n\n    /** Tolerance on expiry check in ms. Default 0. */\n    clockSkewMs?: number;\n    /** Freeze `now` for tests. */\n    now?: Date;\n}\n\nexport type VerifyChallengeReason =\n    | 'ok'\n    | 'malformed'\n    | 'expired'\n    | 'not_yet_valid'\n    | 'sig_invalid'\n    | 'sig_unsupported_scheme'\n    | 'audience_mismatch'\n    | 'purpose_mismatch'\n    | 'nonce_mismatch';\n\nexport interface VerifyChallengeResult {\n    ok: boolean;\n    reason: VerifyChallengeReason;\n    /** Present on success — the cryptographically proven Bitcoin address. */\n    address?: string;\n    /** Present on success — the scheme that verified the signature. */\n    scheme?: Scheme;\n    /** Present on success — when the challenge expires (unix ms). */\n    expiresAt?: number;\n    /** Present on success — the nonce from the challenge. */\n    nonce?: string;\n    /** Present on success — the audience extension, if any. */\n    audience?: string;\n    /** Present on success — the purpose extension, if any. */\n    purpose?: string;\n}\n\n/**\n * Verify a signed challenge. Returns the proven address on success.\n *\n * The caller is responsible for nonce replay prevention — pass `expectedNonce`\n * with the value you stashed at issue time.\n */\nexport async function verifyChallenge(\n    opts: VerifyChallengeOptions\n): Promise<VerifyChallengeResult> {\n    let parsed: ParsedChallenge;\n    try {\n        parsed = parseChallenge(opts.message);\n    } catch {\n        return { ok: false, reason: 'malformed' };\n    }\n\n    const { address, nonce, issuedAt, expiresAt, ack, audience, purpose } = parsed;\n    if (!address || !nonce || !issuedAt || !expiresAt || !ack) {\n        return { ok: false, reason: 'malformed' };\n    }\n    if (ack !== AUTH_ACK) {\n        return { ok: false, reason: 'malformed' };\n    }\n    if (!/^[0-9a-f]{32}$/.test(nonce)) {\n        return { ok: false, reason: 'malformed' };\n    }\n\n    const now = opts.now ?? new Date();\n    const skew = opts.clockSkewMs ?? 0;\n\n    if (now.getTime() - skew > expiresAt.getTime()) {\n        return { ok: false, reason: 'expired' };\n    }\n    if (now.getTime() + skew < issuedAt.getTime()) {\n        return { ok: false, reason: 'not_yet_valid' };\n    }\n\n    if (opts.expectedNonce && nonce !== opts.expectedNonce) {\n        return { ok: false, reason: 'nonce_mismatch' };\n    }\n    if (opts.expectedAudience && audience !== opts.expectedAudience) {\n        return { ok: false, reason: 'audience_mismatch' };\n    }\n    if (opts.expectedPurpose && purpose !== opts.expectedPurpose) {\n        return { ok: false, reason: 'purpose_mismatch' };\n    }\n\n    const sigBase64 = toBase64Maybe(opts.signature);\n    const scheme = signatureScheme(sigBase64);\n    if (!scheme) return { ok: false, reason: 'sig_unsupported_scheme' };\n    if (!verifyBitcoinSignature(address, opts.message, sigBase64)) {\n        return { ok: false, reason: 'sig_invalid' };\n    }\n\n    return {\n        ok: true,\n        reason: 'ok',\n        address,\n        scheme,\n        expiresAt: expiresAt.getTime(),\n        nonce,\n        ...(audience !== undefined ? { audience } : {}),\n        ...(purpose !== undefined ? { purpose } : {}),\n    };\n}\n"]}
+{"version":3,"sources":["../src/options.ts","../src/utils/signature.ts","../src/challenge.ts"],"names":["Buffer","verifyBitcoinSignature"],"mappings":"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","file":"challenge.js","sourcesContent":["import type { IssueChallengeOptions } from './challenge';\nimport type { CheckParams } from './check';\nimport type { ScoringConfig } from './scoring';\nimport type { VerifyOptions } from './types';\n\n/** The options `check()` reads. */\nconst CHECK_OPTIONS: ReadonlySet<string> = new Set<keyof CheckParams>([\n    'addr',\n    'id',\n    'identity',\n    'minSats',\n    'minDays',\n    'relays',\n    'verifyOptions',\n]);\n\n/** The options `verify()` reads. */\nconst VERIFY_OPTIONS: ReadonlySet<string> = new Set<keyof VerifyOptions>([\n    'testMode',\n    'demoMode',\n    'expectedAud',\n    'esploraMainnetBase',\n    'esploraSignetBase',\n    'esploraTestnetBase',\n    'coverSats',\n]);\n\n/**\n * Throw on a key the SDK does not read. Ignored, a misspelt `minSats` would\n * leave the threshold at 0, and a misspelt `expectedAud` would skip the\n * audience check.\n */\nfunction refuseUnknown(where: string, opts: unknown, known: ReadonlySet<string>): void {\n    if (opts === null || typeof opts !== 'object') {\n        throw new TypeError(`@orangecheck/sdk: ${where} must be an object`);\n    }\n    const unknown = Object.keys(opts).filter((k) => !known.has(k));\n    if (unknown.length > 0) {\n        throw new TypeError(\n            `@orangecheck/sdk: ${where}: unknown option ${unknown.join(', ')}. ` +\n                `It reads only ${[...known].join(', ')}.`\n        );\n    }\n    // Readers read opts.key, which follows the prototype: a known key must be the caller's own.\n    const inherited = [...known].filter((k) => k in opts && !Object.prototype.hasOwnProperty.call(opts, k));\n    if (inherited.length > 0) {\n        throw new TypeError(`@orangecheck/sdk: ${where}: option ${inherited.join(', ')} is inherited, not set by the caller`);\n    }\n}\n\nexport function checkCheckParams(params: CheckParams): void {\n    refuseUnknown('check()', params, CHECK_OPTIONS);\n    if (params.verifyOptions !== undefined) checkVerifyOptions(params.verifyOptions, 'verifyOptions');\n}\n\nexport function checkVerifyOptions(opts: VerifyOptions, where = 'verify()'): void {\n    refuseUnknown(where, opts, VERIFY_OPTIONS);\n}\n\n/** The options `issueChallenge()` reads. */\nconst CHALLENGE_OPTIONS: ReadonlySet<string> = new Set<keyof IssueChallengeOptions>([\n    'address',\n    'ttlSeconds',\n    'nonce',\n    'audience',\n    'purpose',\n    'now',\n]);\n\nexport function checkChallengeOptions(opts: IssueChallengeOptions): void {\n    refuseUnknown('issueChallenge()', opts, CHALLENGE_OPTIONS);\n}\n\n/** The keys `computeScore()` reads from its config. */\nconst SCORING_OPTIONS: ReadonlySet<string> = new Set<keyof ScoringConfig>(['algorithm']);\n\nexport function checkScoringConfig(config: ScoringConfig): void {\n    refuseUnknown('computeScore()', config, SCORING_OPTIONS);\n}\n","import type { Scheme } from '../types';\n\nimport { Buffer } from 'buffer';\n\n/** A signature as base64: hex input is converted, anything else passes through. */\nexport function toBase64Maybe(sig: string): string {\n    if (/^[0-9a-fA-F]+$/.test(sig) && sig.length % 2 === 0) {\n        return Buffer.from(sig, 'hex').toString('base64');\n    }\n    return sig;\n}\n\n/**\n * The scheme a signature's bytes say it is, the same rule @orangecheck/bip322\n * verifies by: 65 bytes is a BIP-137 compact signature, whatever the address,\n * and anything else is BIP-322 simple. `null` for a BIP-322 full or\n * proof-of-funds signature, which is not supported.\n */\nexport function signatureScheme(sigBase64: string): Scheme | null {\n    if (/^(ful|pof)/.test(sigBase64)) return null;\n    if (sigBase64.startsWith('smp')) return 'bip322';\n    return Buffer.from(sigBase64, 'base64').length === 65 ? 'legacy' : 'bip322';\n}\n","/**\n * Signed-challenge auth\n *\n * When a gate can't trust the address source (public header, query string,\n * unsigned cookie), run a one-shot BIP-322 challenge first to cryptographically\n * prove the caller controls the address. Bind the proven address to a session\n * cookie or JWT, and the gate reads from there.\n *\n * This is a different wire format from the main OCP attestation — the header\n * literal is `orangecheck-auth`, not `orangecheck`, so a signed auth challenge\n * can never be confused with a reputation attestation.\n *\n *   // Server, on the \"connect wallet\" flow:\n *   const challenge = issueChallenge({ address, ttlSeconds: 300 });\n *   // → send challenge.message to the client\n *\n *   // Client signs challenge.message with BIP-322 via the user's wallet,\n *   // then posts { message, signature } back.\n *\n *   // Server, on callback:\n *   const result = await verifyChallenge({ message, signature });\n *   if (result.ok) {\n *     // result.address is now cryptographically proven; attach to session.\n *   }\n */\n\nimport type { Scheme } from './types';\n\nimport { verifySignature as verifyBitcoinSignature } from '@orangecheck/bip322';\n\nimport { checkChallengeOptions } from './options';\nimport { signatureScheme, toBase64Maybe } from './utils/signature';\n\nconst AUTH_HEADER = 'orangecheck-auth';\nconst AUTH_ACK = 'I authorize this session under the OrangeCheck auth challenge.';\n\nfunction randomNonce(): string {\n    // 16 bytes → 32 lowercase hex chars. Matches OCP core nonce format.\n    const bytes = new Uint8Array(16);\n    // Runtimes: Node 20+ (webcrypto), browsers.\n    if (typeof globalThis.crypto?.getRandomValues === 'function') {\n        globalThis.crypto.getRandomValues(bytes);\n    } else {\n        // Fallback: Math.random is *not* cryptographic — acceptable only for\n        // environments without webcrypto (old Node). Flagged explicitly.\n        for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 256);\n    }\n    return Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('');\n}\n\nfunction iso(date: Date): string {\n    return date.toISOString().replace(/\\.\\d{3}Z$/, 'Z');\n}\n\nexport interface IssueChallengeOptions {\n    /** Bitcoin address the caller claims to control. */\n    address: string;\n    /** How long the challenge is valid for. Default 300 (5 minutes). */\n    ttlSeconds?: number;\n    /** Explicit nonce. Rare; prefer auto-generated. */\n    nonce?: string;\n    /** Origin-binding extension. If set, verify will require a match. */\n    audience?: string;\n    /** Human-readable label baked into the signed message. */\n    purpose?: string;\n    /** Freeze `now` for tests. */\n    now?: Date;\n}\n\nexport interface Challenge {\n    /** The canonical text the client MUST sign. */\n    message: string;\n    /** The generated nonce (kept for correlation / server-side storage). */\n    nonce: string;\n    /** Unix ms epoch the challenge expires at. */\n    expiresAt: number;\n    /** ISO string of the same. */\n    expiresAtIso: string;\n}\n\n/**\n * Build a new signed-challenge message. The server MUST remember the nonce\n * it issued against the session (Redis, signed cookie, DB) so it can detect\n * replay or a different nonce coming back on verify.\n */\nexport function issueChallenge(opts: IssueChallengeOptions): Challenge {\n    checkChallengeOptions(opts);\n    const now = opts.now ?? new Date();\n    const ttl = opts.ttlSeconds ?? 300;\n    const expiresAt = new Date(now.getTime() + ttl * 1000);\n    const nonce = opts.nonce ?? randomNonce();\n\n    if (!/^[0-9a-f]{32}$/.test(nonce)) {\n        throw new Error('nonce must be 32 lowercase hex characters');\n    }\n\n    const coreLines = [\n        AUTH_HEADER,\n        `address: ${opts.address}`,\n        `nonce: ${nonce}`,\n        `issued_at: ${iso(now)}`,\n        `expires_at: ${iso(expiresAt)}`,\n        `ack: ${AUTH_ACK}`,\n    ];\n\n    const extensions: Array<[string, string]> = [];\n    if (opts.audience) extensions.push(['audience', opts.audience]);\n    if (opts.purpose) extensions.push(['purpose', opts.purpose]);\n    // Lexicographic sort by key — matches OCP canonicalization rules.\n    extensions.sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));\n\n    const extLines = extensions.map(([k, v]) => `${k}: ${v}`);\n    const message = [...coreLines, ...extLines].join('\\n') + '\\n';\n\n    return {\n        message,\n        nonce,\n        expiresAt: expiresAt.getTime(),\n        expiresAtIso: iso(expiresAt),\n    };\n}\n\ninterface ParsedChallenge {\n    address?: string;\n    nonce?: string;\n    issuedAt?: Date;\n    expiresAt?: Date;\n    ack?: string;\n    audience?: string;\n    purpose?: string;\n    extensions: Array<[string, string]>;\n}\n\nfunction parseChallenge(message: string): ParsedChallenge {\n    const lines = message.endsWith('\\n') ? message.slice(0, -1).split('\\n') : message.split('\\n');\n\n    if (lines[0] !== AUTH_HEADER) {\n        throw new Error('not an orangecheck-auth challenge');\n    }\n\n    const out: ParsedChallenge = { extensions: [] };\n    const coreKeys = ['address', 'nonce', 'issued_at', 'expires_at', 'ack'] as const;\n    const coreKeySet = new Set<string>(coreKeys);\n    // Duplicate detection: a challenge with two `address:` lines would\n    // previously let the second overwrite the first. A signer who saw both\n    // lines would still sign the whole text — which means the verifier and\n    // the signer disagree about what the message \"said\". Refuse instead.\n    const seenCore = new Set<string>();\n\n    for (let i = 1; i < lines.length; i++) {\n        const line = lines[i] ?? '';\n        const sep = line.indexOf(': ');\n        if (sep === -1) continue;\n        const key = line.slice(0, sep);\n        const val = line.slice(sep + 2);\n\n        if (coreKeySet.has(key)) {\n            if (seenCore.has(key)) {\n                throw new Error(`duplicate core key in challenge: ${key}`);\n            }\n            seenCore.add(key);\n            if (key === 'address') out.address = val;\n            else if (key === 'nonce') out.nonce = val;\n            else if (key === 'issued_at') out.issuedAt = new Date(val);\n            else if (key === 'expires_at') out.expiresAt = new Date(val);\n            else if (key === 'ack') out.ack = val;\n        } else {\n            out.extensions.push([key, val]);\n            if (key === 'audience') out.audience = val;\n            if (key === 'purpose') out.purpose = val;\n        }\n    }\n\n    if (seenCore.size !== coreKeys.length) {\n        throw new Error(`challenge missing core lines (${seenCore.size}/${coreKeys.length})`);\n    }\n    return out;\n}\n\nexport interface VerifyChallengeOptions {\n    /** The signed canonical challenge text, exactly as issued. */\n    message: string;\n    /** BIP-322 or legacy signature, base64 or hex. */\n    signature: string;\n    /** @deprecated Ignored: the signature's own bytes decide the scheme. */\n    scheme?: Scheme;\n\n    /** If set, require the challenge's `audience:` extension to match. */\n    expectedAudience?: string;\n    /** If set, require the challenge's `purpose:` extension to match. */\n    expectedPurpose?: string;\n    /**\n     * If set, require the challenge's `nonce:` to match. Use this to defeat\n     * replay — pair with server-side nonce storage (Redis / signed cookie).\n     */\n    expectedNonce?: string;\n\n    /** Tolerance on expiry check in ms. Default 0. */\n    clockSkewMs?: number;\n    /** Freeze `now` for tests. */\n    now?: Date;\n}\n\nexport type VerifyChallengeReason =\n    | 'ok'\n    | 'malformed'\n    | 'expired'\n    | 'not_yet_valid'\n    | 'sig_invalid'\n    | 'sig_unsupported_scheme'\n    | 'audience_mismatch'\n    | 'purpose_mismatch'\n    | 'nonce_mismatch';\n\nexport interface VerifyChallengeResult {\n    ok: boolean;\n    reason: VerifyChallengeReason;\n    /** Present on success — the cryptographically proven Bitcoin address. */\n    address?: string;\n    /** Present on success — the scheme that verified the signature. */\n    scheme?: Scheme;\n    /** Present on success — when the challenge expires (unix ms). */\n    expiresAt?: number;\n    /** Present on success — the nonce from the challenge. */\n    nonce?: string;\n    /** Present on success — the audience extension, if any. */\n    audience?: string;\n    /** Present on success — the purpose extension, if any. */\n    purpose?: string;\n}\n\n/**\n * Verify a signed challenge. Returns the proven address on success.\n *\n * The caller is responsible for nonce replay prevention — pass `expectedNonce`\n * with the value you stashed at issue time.\n */\nexport async function verifyChallenge(\n    opts: VerifyChallengeOptions\n): Promise<VerifyChallengeResult> {\n    let parsed: ParsedChallenge;\n    try {\n        parsed = parseChallenge(opts.message);\n    } catch {\n        return { ok: false, reason: 'malformed' };\n    }\n\n    const { address, nonce, issuedAt, expiresAt, ack, audience, purpose } = parsed;\n    if (!address || !nonce || !issuedAt || !expiresAt || !ack) {\n        return { ok: false, reason: 'malformed' };\n    }\n    if (ack !== AUTH_ACK) {\n        return { ok: false, reason: 'malformed' };\n    }\n    if (!/^[0-9a-f]{32}$/.test(nonce)) {\n        return { ok: false, reason: 'malformed' };\n    }\n\n    const now = opts.now ?? new Date();\n    const skew = opts.clockSkewMs ?? 0;\n\n    if (now.getTime() - skew > expiresAt.getTime()) {\n        return { ok: false, reason: 'expired' };\n    }\n    if (now.getTime() + skew < issuedAt.getTime()) {\n        return { ok: false, reason: 'not_yet_valid' };\n    }\n\n    if (opts.expectedNonce && nonce !== opts.expectedNonce) {\n        return { ok: false, reason: 'nonce_mismatch' };\n    }\n    if (opts.expectedAudience && audience !== opts.expectedAudience) {\n        return { ok: false, reason: 'audience_mismatch' };\n    }\n    if (opts.expectedPurpose && purpose !== opts.expectedPurpose) {\n        return { ok: false, reason: 'purpose_mismatch' };\n    }\n\n    const sigBase64 = toBase64Maybe(opts.signature);\n    const scheme = signatureScheme(sigBase64);\n    if (!scheme) return { ok: false, reason: 'sig_unsupported_scheme' };\n    if (!verifyBitcoinSignature(address, opts.message, sigBase64)) {\n        return { ok: false, reason: 'sig_invalid' };\n    }\n\n    return {\n        ok: true,\n        reason: 'ok',\n        address,\n        scheme,\n        expiresAt: expiresAt.getTime(),\n        nonce,\n        ...(audience !== undefined ? { audience } : {}),\n        ...(purpose !== undefined ? { purpose } : {}),\n    };\n}\n"]}

package/dist/challenge.mjs

@@ -2,6 +2,34 @@ import { verifySignature } from '@orangecheck/bip322';
 import { Buffer } from 'buffer';
 
 // src/challenge.ts
+
+// src/options.ts
+function refuseUnknown(where, opts, known) {
+  if (opts === null || typeof opts !== "object") {
+    throw new TypeError(`@orangecheck/sdk: ${where} must be an object`);
+  }
+  const unknown = Object.keys(opts).filter((k) => !known.has(k));
+  if (unknown.length > 0) {
+    throw new TypeError(
+      `@orangecheck/sdk: ${where}: unknown option ${unknown.join(", ")}. It reads only ${[...known].join(", ")}.`
+    );
+  }
+  const inherited = [...known].filter((k) => k in opts && !Object.prototype.hasOwnProperty.call(opts, k));
+  if (inherited.length > 0) {
+    throw new TypeError(`@orangecheck/sdk: ${where}: option ${inherited.join(", ")} is inherited, not set by the caller`);
+  }
+}
+var CHALLENGE_OPTIONS = /* @__PURE__ */ new Set([
+  "address",
+  "ttlSeconds",
+  "nonce",
+  "audience",
+  "purpose",
+  "now"
+]);
+function checkChallengeOptions(opts) {
+  refuseUnknown("issueChallenge()", opts, CHALLENGE_OPTIONS);
+}
 function toBase64Maybe(sig) {
   if (/^[0-9a-fA-F]+$/.test(sig) && sig.length % 2 === 0) {
     return Buffer.from(sig, "hex").toString("base64");
@@ -30,6 +58,7 @@ function iso(date) {
   return date.toISOString().replace(/\.\d{3}Z$/, "Z");
 }
 function issueChallenge(opts) {
+  checkChallengeOptions(opts);
   const now = opts.now ?? /* @__PURE__ */ new Date();
   const ttl = opts.ttlSeconds ?? 300;
   const expiresAt = new Date(now.getTime() + ttl * 1e3);

package/dist/challenge.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/signature.ts","../src/challenge.ts"],"names":["verifyBitcoinSignature"],"mappings":";;;;AAKO,SAAS,cAAc,GAAA,EAAqB;AAC/C,EAAA,IAAI,iBAAiB,IAAA,CAAK,GAAG,KAAK,GAAA,CAAI,MAAA,GAAS,MAAM,CAAA,EAAG;AACpD,IAAA,OAAO,OAAO,IAAA,CAAK,GAAA,EAAK,KAAK,CAAA,CAAE,SAAS,QAAQ,CAAA;AAAA,EACpD;AACA,EAAA,OAAO,GAAA;AACX;AAQO,SAAS,gBAAgB,SAAA,EAAkC;AAC9D,EAAA,IAAI,YAAA,CAAa,IAAA,CAAK,SAAS,CAAA,EAAG,OAAO,IAAA;AACzC,EAAA,IAAI,SAAA,CAAU,UAAA,CAAW,KAAK,CAAA,EAAG,OAAO,QAAA;AACxC,EAAA,OAAO,OAAO,IAAA,CAAK,SAAA,EAAW,QAAQ,CAAA,CAAE,MAAA,KAAW,KAAK,QAAA,GAAW,QAAA;AACvE;;;ACUA,IAAM,WAAA,GAAc,kBAAA;AACpB,IAAM,QAAA,GAAW,gEAAA;AAEjB,SAAS,WAAA,GAAsB;AAE3B,EAAA,MAAM,KAAA,GAAQ,IAAI,UAAA,CAAW,EAAE,CAAA;AAE/B,EAAA,IAAI,OAAO,UAAA,CAAW,MAAA,EAAQ,eAAA,KAAoB,UAAA,EAAY;AAC1D,IAAA,UAAA,CAAW,MAAA,CAAO,gBAAgB,KAAK,CAAA;AAAA,EAC3C,CAAA,MAAO;AAGH,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,QAAQ,CAAA,EAAA,EAAK,KAAA,CAAM,CAAC,CAAA,GAAI,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,MAAA,KAAW,GAAG,CAAA;AAAA,EACpF;AACA,EAAA,OAAO,KAAA,CAAM,IAAA,CAAK,KAAA,EAAO,CAAC,MAAM,CAAA,CAAE,QAAA,CAAS,EAAE,CAAA,CAAE,SAAS,CAAA,EAAG,GAAG,CAAC,CAAA,CAAE,KAAK,EAAE,CAAA;AAC5E;AAEA,SAAS,IAAI,IAAA,EAAoB;AAC7B,EAAA,OAAO,IAAA,CAAK,WAAA,EAAY,CAAE,OAAA,CAAQ,aAAa,GAAG,CAAA;AACtD;AAiCO,SAAS,eAAe,IAAA,EAAwC;AACnE,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,GAAA,oBAAO,IAAI,IAAA,EAAK;AACjC,EAAA,MAAM,GAAA,GAAM,KAAK,UAAA,IAAc,GAAA;AAC/B,EAAA,MAAM,YAAY,IAAI,IAAA,CAAK,IAAI,OAAA,EAAQ,GAAI,MAAM,GAAI,CAAA;AACrD,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,IAAS,WAAA,EAAY;AAExC,EAAA,IAAI,CAAC,gBAAA,CAAiB,IAAA,CAAK,KAAK,CAAA,EAAG;AAC/B,IAAA,MAAM,IAAI,MAAM,2CAA2C,CAAA;AAAA,EAC/D;AAEA,EAAA,MAAM,SAAA,GAAY;AAAA,IACd,WAAA;AAAA,IACA,CAAA,SAAA,EAAY,KAAK,OAAO,CAAA,CAAA;AAAA,IACxB,UAAU,KAAK,CAAA,CAAA;AAAA,IACf,CAAA,WAAA,EAAc,GAAA,CAAI,GAAG,CAAC,CAAA,CAAA;AAAA,IACtB,CAAA,YAAA,EAAe,GAAA,CAAI,SAAS,CAAC,CAAA,CAAA;AAAA,IAC7B,QAAQ,QAAQ,CAAA;AAAA,GACpB;AAEA,EAAA,MAAM,aAAsC,EAAC;AAC7C,EAAA,IAAI,IAAA,CAAK,UAAU,UAAA,CAAW,IAAA,CAAK,CAAC,UAAA,EAAY,IAAA,CAAK,QAAQ,CAAC,CAAA;AAC9D,EAAA,IAAI,IAAA,CAAK,SAAS,UAAA,CAAW,IAAA,CAAK,CAAC,SAAA,EAAW,IAAA,CAAK,OAAO,CAAC,CAAA;AAE3D,EAAA,UAAA,CAAW,IAAA,CAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA,KAAO,CAAA,GAAI,CAAA,GAAI,EAAA,GAAK,CAAA,GAAI,CAAA,GAAI,IAAI,CAAE,CAAA;AAE1D,EAAA,MAAM,QAAA,GAAW,UAAA,CAAW,GAAA,CAAI,CAAC,CAAC,CAAA,EAAG,CAAC,CAAA,KAAM,CAAA,EAAG,CAAC,CAAA,EAAA,EAAK,CAAC,CAAA,CAAE,CAAA;AACxD,EAAA,MAAM,OAAA,GAAU,CAAC,GAAG,SAAA,EAAW,GAAG,QAAQ,CAAA,CAAE,IAAA,CAAK,IAAI,CAAA,GAAI,IAAA;AAEzD,EAAA,OAAO;AAAA,IACH,OAAA;AAAA,IACA,KAAA;AAAA,IACA,SAAA,EAAW,UAAU,OAAA,EAAQ;AAAA,IAC7B,YAAA,EAAc,IAAI,SAAS;AAAA,GAC/B;AACJ;AAaA,SAAS,eAAe,OAAA,EAAkC;AACtD,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,QAAA,CAAS,IAAI,IAAI,OAAA,CAAQ,KAAA,CAAM,CAAA,EAAG,EAAE,EAAE,KAAA,CAAM,IAAI,CAAA,GAAI,OAAA,CAAQ,MAAM,IAAI,CAAA;AAE5F,EAAA,IAAI,KAAA,CAAM,CAAC,CAAA,KAAM,WAAA,EAAa;AAC1B,IAAA,MAAM,IAAI,MAAM,mCAAmC,CAAA;AAAA,EACvD;AAEA,EAAA,MAAM,GAAA,GAAuB,EAAE,UAAA,EAAY,EAAC,EAAE;AAC9C,EAAA,MAAM,WAAW,CAAC,SAAA,EAAW,OAAA,EAAS,WAAA,EAAa,cAAc,KAAK,CAAA;AACtE,EAAA,MAAM,UAAA,GAAa,IAAI,GAAA,CAAY,QAAQ,CAAA;AAK3C,EAAA,MAAM,QAAA,uBAAe,GAAA,EAAY;AAEjC,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,QAAQ,CAAA,EAAA,EAAK;AACnC,IAAA,MAAM,IAAA,GAAO,KAAA,CAAM,CAAC,CAAA,IAAK,EAAA;AACzB,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,OAAA,CAAQ,IAAI,CAAA;AAC7B,IAAA,IAAI,QAAQ,EAAA,EAAI;AAChB,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,CAAA,EAAG,GAAG,CAAA;AAC7B,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,GAAA,GAAM,CAAC,CAAA;AAE9B,IAAA,IAAI,UAAA,CAAW,GAAA,CAAI,GAAG,CAAA,EAAG;AACrB,MAAA,IAAI,QAAA,CAAS,GAAA,CAAI,GAAG,CAAA,EAAG;AACnB,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,iCAAA,EAAoC,GAAG,CAAA,CAAE,CAAA;AAAA,MAC7D;AACA,MAAA,QAAA,CAAS,IAAI,GAAG,CAAA;AAChB,MAAA,IAAI,GAAA,KAAQ,SAAA,EAAW,GAAA,CAAI,OAAA,GAAU,GAAA;AAAA,WAAA,IAC5B,GAAA,KAAQ,OAAA,EAAS,GAAA,CAAI,KAAA,GAAQ,GAAA;AAAA,WAAA,IAC7B,QAAQ,WAAA,EAAa,GAAA,CAAI,QAAA,GAAW,IAAI,KAAK,GAAG,CAAA;AAAA,WAAA,IAChD,QAAQ,YAAA,EAAc,GAAA,CAAI,SAAA,GAAY,IAAI,KAAK,GAAG,CAAA;AAAA,WAAA,IAClD,GAAA,KAAQ,KAAA,EAAO,GAAA,CAAI,GAAA,GAAM,GAAA;AAAA,IACtC,CAAA,MAAO;AACH,MAAA,GAAA,CAAI,UAAA,CAAW,IAAA,CAAK,CAAC,GAAA,EAAK,GAAG,CAAC,CAAA;AAC9B,MAAA,IAAI,GAAA,KAAQ,UAAA,EAAY,GAAA,CAAI,QAAA,GAAW,GAAA;AACvC,MAAA,IAAI,GAAA,KAAQ,SAAA,EAAW,GAAA,CAAI,OAAA,GAAU,GAAA;AAAA,IACzC;AAAA,EACJ;AAEA,EAAA,IAAI,QAAA,CAAS,IAAA,KAAS,QAAA,CAAS,MAAA,EAAQ;AACnC,IAAA,MAAM,IAAI,MAAM,CAAA,8BAAA,EAAiC,QAAA,CAAS,IAAI,CAAA,CAAA,EAAI,QAAA,CAAS,MAAM,CAAA,CAAA,CAAG,CAAA;AAAA,EACxF;AACA,EAAA,OAAO,GAAA;AACX;AA4DA,eAAsB,gBAClB,IAAA,EAC8B;AAC9B,EAAA,IAAI,MAAA;AACJ,EAAA,IAAI;AACA,IAAA,MAAA,GAAS,cAAA,CAAe,KAAK,OAAO,CAAA;AAAA,EACxC,CAAA,CAAA,MAAQ;AACJ,IAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,MAAA,EAAQ,WAAA,EAAY;AAAA,EAC5C;AAEA,EAAA,MAAM,EAAE,SAAS,KAAA,EAAO,QAAA,EAAU,WAAW,GAAA,EAAK,QAAA,EAAU,SAAQ,GAAI,MAAA;AACxE,EAAA,IAAI,CAAC,WAAW,CAAC,KAAA,IAAS,CAAC,QAAA,IAAY,CAAC,SAAA,IAAa,CAAC,GAAA,EAAK;AACvD,IAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,MAAA,EAAQ,WAAA,EAAY;AAAA,EAC5C;AACA,EAAA,IAAI,QAAQ,QAAA,EAAU;AAClB,IAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,MAAA,EAAQ,WAAA,EAAY;AAAA,EAC5C;AACA,EAAA,IAAI,CAAC,gBAAA,CAAiB,IAAA,CAAK,KAAK,CAAA,EAAG;AAC/B,IAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,MAAA,EAAQ,WAAA,EAAY;AAAA,EAC5C;AAEA,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,GAAA,oBAAO,IAAI,IAAA,EAAK;AACjC,EAAA,MAAM,IAAA,GAAO,KAAK,WAAA,IAAe,CAAA;AAEjC,EAAA,IAAI,IAAI,OAAA,EAAQ,GAAI,IAAA,GAAO,SAAA,CAAU,SAAQ,EAAG;AAC5C,IAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,MAAA,EAAQ,SAAA,EAAU;AAAA,EAC1C;AACA,EAAA,IAAI,IAAI,OAAA,EAAQ,GAAI,IAAA,GAAO,QAAA,CAAS,SAAQ,EAAG;AAC3C,IAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,MAAA,EAAQ,eAAA,EAAgB;AAAA,EAChD;AAEA,EAAA,IAAI,IAAA,CAAK,aAAA,IAAiB,KAAA,KAAU,IAAA,CAAK,aAAA,EAAe;AACpD,IAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,MAAA,EAAQ,gBAAA,EAAiB;AAAA,EACjD;AACA,EAAA,IAAI,IAAA,CAAK,gBAAA,IAAoB,QAAA,KAAa,IAAA,CAAK,gBAAA,EAAkB;AAC7D,IAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,MAAA,EAAQ,mBAAA,EAAoB;AAAA,EACpD;AACA,EAAA,IAAI,IAAA,CAAK,eAAA,IAAmB,OAAA,KAAY,IAAA,CAAK,eAAA,EAAiB;AAC1D,IAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,MAAA,EAAQ,kBAAA,EAAmB;AAAA,EACnD;AAEA,EAAA,MAAM,SAAA,GAAY,aAAA,CAAc,IAAA,CAAK,SAAS,CAAA;AAC9C,EAAA,MAAM,MAAA,GAAS,gBAAgB,SAAS,CAAA;AACxC,EAAA,IAAI,CAAC,MAAA,EAAQ,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,QAAQ,wBAAA,EAAyB;AAClE,EAAA,IAAI,CAACA,eAAA,CAAuB,OAAA,EAAS,IAAA,CAAK,OAAA,EAAS,SAAS,CAAA,EAAG;AAC3D,IAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,MAAA,EAAQ,aAAA,EAAc;AAAA,EAC9C;AAEA,EAAA,OAAO;AAAA,IACH,EAAA,EAAI,IAAA;AAAA,IACJ,MAAA,EAAQ,IAAA;AAAA,IACR,OAAA;AAAA,IACA,MAAA;AAAA,IACA,SAAA,EAAW,UAAU,OAAA,EAAQ;AAAA,IAC7B,KAAA;AAAA,IACA,GAAI,QAAA,KAAa,MAAA,GAAY,EAAE,QAAA,KAAa,EAAC;AAAA,IAC7C,GAAI,OAAA,KAAY,MAAA,GAAY,EAAE,OAAA,KAAY;AAAC,GAC/C;AACJ","file":"challenge.mjs","sourcesContent":["import type { Scheme } from '../types';\n\nimport { Buffer } from 'buffer';\n\n/** A signature as base64: hex input is converted, anything else passes through. */\nexport function toBase64Maybe(sig: string): string {\n    if (/^[0-9a-fA-F]+$/.test(sig) && sig.length % 2 === 0) {\n        return Buffer.from(sig, 'hex').toString('base64');\n    }\n    return sig;\n}\n\n/**\n * The scheme a signature's bytes say it is, the same rule @orangecheck/bip322\n * verifies by: 65 bytes is a BIP-137 compact signature, whatever the address,\n * and anything else is BIP-322 simple. `null` for a BIP-322 full or\n * proof-of-funds signature, which is not supported.\n */\nexport function signatureScheme(sigBase64: string): Scheme | null {\n    if (/^(ful|pof)/.test(sigBase64)) return null;\n    if (sigBase64.startsWith('smp')) return 'bip322';\n    return Buffer.from(sigBase64, 'base64').length === 65 ? 'legacy' : 'bip322';\n}\n","/**\n * Signed-challenge auth\n *\n * When a gate can't trust the address source (public header, query string,\n * unsigned cookie), run a one-shot BIP-322 challenge first to cryptographically\n * prove the caller controls the address. Bind the proven address to a session\n * cookie or JWT, and the gate reads from there.\n *\n * This is a different wire format from the main OCP attestation — the header\n * literal is `orangecheck-auth`, not `orangecheck`, so a signed auth challenge\n * can never be confused with a reputation attestation.\n *\n *   // Server, on the \"connect wallet\" flow:\n *   const challenge = issueChallenge({ address, ttlSeconds: 300 });\n *   // → send challenge.message to the client\n *\n *   // Client signs challenge.message with BIP-322 via the user's wallet,\n *   // then posts { message, signature } back.\n *\n *   // Server, on callback:\n *   const result = await verifyChallenge({ message, signature });\n *   if (result.ok) {\n *     // result.address is now cryptographically proven; attach to session.\n *   }\n */\n\nimport type { Scheme } from './types';\n\nimport { verifySignature as verifyBitcoinSignature } from '@orangecheck/bip322';\n\nimport { signatureScheme, toBase64Maybe } from './utils/signature';\n\nconst AUTH_HEADER = 'orangecheck-auth';\nconst AUTH_ACK = 'I authorize this session under the OrangeCheck auth challenge.';\n\nfunction randomNonce(): string {\n    // 16 bytes → 32 lowercase hex chars. Matches OCP core nonce format.\n    const bytes = new Uint8Array(16);\n    // Runtimes: Node 20+ (webcrypto), browsers.\n    if (typeof globalThis.crypto?.getRandomValues === 'function') {\n        globalThis.crypto.getRandomValues(bytes);\n    } else {\n        // Fallback: Math.random is *not* cryptographic — acceptable only for\n        // environments without webcrypto (old Node). Flagged explicitly.\n        for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 256);\n    }\n    return Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('');\n}\n\nfunction iso(date: Date): string {\n    return date.toISOString().replace(/\\.\\d{3}Z$/, 'Z');\n}\n\nexport interface IssueChallengeOptions {\n    /** Bitcoin address the caller claims to control. */\n    address: string;\n    /** How long the challenge is valid for. Default 300 (5 minutes). */\n    ttlSeconds?: number;\n    /** Explicit nonce. Rare; prefer auto-generated. */\n    nonce?: string;\n    /** Origin-binding extension. If set, verify will require a match. */\n    audience?: string;\n    /** Human-readable label baked into the signed message. */\n    purpose?: string;\n    /** Freeze `now` for tests. */\n    now?: Date;\n}\n\nexport interface Challenge {\n    /** The canonical text the client MUST sign. */\n    message: string;\n    /** The generated nonce (kept for correlation / server-side storage). */\n    nonce: string;\n    /** Unix ms epoch the challenge expires at. */\n    expiresAt: number;\n    /** ISO string of the same. */\n    expiresAtIso: string;\n}\n\n/**\n * Build a new signed-challenge message. The server MUST remember the nonce\n * it issued against the session (Redis, signed cookie, DB) so it can detect\n * replay or a different nonce coming back on verify.\n */\nexport function issueChallenge(opts: IssueChallengeOptions): Challenge {\n    const now = opts.now ?? new Date();\n    const ttl = opts.ttlSeconds ?? 300;\n    const expiresAt = new Date(now.getTime() + ttl * 1000);\n    const nonce = opts.nonce ?? randomNonce();\n\n    if (!/^[0-9a-f]{32}$/.test(nonce)) {\n        throw new Error('nonce must be 32 lowercase hex characters');\n    }\n\n    const coreLines = [\n        AUTH_HEADER,\n        `address: ${opts.address}`,\n        `nonce: ${nonce}`,\n        `issued_at: ${iso(now)}`,\n        `expires_at: ${iso(expiresAt)}`,\n        `ack: ${AUTH_ACK}`,\n    ];\n\n    const extensions: Array<[string, string]> = [];\n    if (opts.audience) extensions.push(['audience', opts.audience]);\n    if (opts.purpose) extensions.push(['purpose', opts.purpose]);\n    // Lexicographic sort by key — matches OCP canonicalization rules.\n    extensions.sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));\n\n    const extLines = extensions.map(([k, v]) => `${k}: ${v}`);\n    const message = [...coreLines, ...extLines].join('\\n') + '\\n';\n\n    return {\n        message,\n        nonce,\n        expiresAt: expiresAt.getTime(),\n        expiresAtIso: iso(expiresAt),\n    };\n}\n\ninterface ParsedChallenge {\n    address?: string;\n    nonce?: string;\n    issuedAt?: Date;\n    expiresAt?: Date;\n    ack?: string;\n    audience?: string;\n    purpose?: string;\n    extensions: Array<[string, string]>;\n}\n\nfunction parseChallenge(message: string): ParsedChallenge {\n    const lines = message.endsWith('\\n') ? message.slice(0, -1).split('\\n') : message.split('\\n');\n\n    if (lines[0] !== AUTH_HEADER) {\n        throw new Error('not an orangecheck-auth challenge');\n    }\n\n    const out: ParsedChallenge = { extensions: [] };\n    const coreKeys = ['address', 'nonce', 'issued_at', 'expires_at', 'ack'] as const;\n    const coreKeySet = new Set<string>(coreKeys);\n    // Duplicate detection: a challenge with two `address:` lines would\n    // previously let the second overwrite the first. A signer who saw both\n    // lines would still sign the whole text — which means the verifier and\n    // the signer disagree about what the message \"said\". Refuse instead.\n    const seenCore = new Set<string>();\n\n    for (let i = 1; i < lines.length; i++) {\n        const line = lines[i] ?? '';\n        const sep = line.indexOf(': ');\n        if (sep === -1) continue;\n        const key = line.slice(0, sep);\n        const val = line.slice(sep + 2);\n\n        if (coreKeySet.has(key)) {\n            if (seenCore.has(key)) {\n                throw new Error(`duplicate core key in challenge: ${key}`);\n            }\n            seenCore.add(key);\n            if (key === 'address') out.address = val;\n            else if (key === 'nonce') out.nonce = val;\n            else if (key === 'issued_at') out.issuedAt = new Date(val);\n            else if (key === 'expires_at') out.expiresAt = new Date(val);\n            else if (key === 'ack') out.ack = val;\n        } else {\n            out.extensions.push([key, val]);\n            if (key === 'audience') out.audience = val;\n            if (key === 'purpose') out.purpose = val;\n        }\n    }\n\n    if (seenCore.size !== coreKeys.length) {\n        throw new Error(`challenge missing core lines (${seenCore.size}/${coreKeys.length})`);\n    }\n    return out;\n}\n\nexport interface VerifyChallengeOptions {\n    /** The signed canonical challenge text, exactly as issued. */\n    message: string;\n    /** BIP-322 or legacy signature, base64 or hex. */\n    signature: string;\n    /** @deprecated Ignored: the signature's own bytes decide the scheme. */\n    scheme?: Scheme;\n\n    /** If set, require the challenge's `audience:` extension to match. */\n    expectedAudience?: string;\n    /** If set, require the challenge's `purpose:` extension to match. */\n    expectedPurpose?: string;\n    /**\n     * If set, require the challenge's `nonce:` to match. Use this to defeat\n     * replay — pair with server-side nonce storage (Redis / signed cookie).\n     */\n    expectedNonce?: string;\n\n    /** Tolerance on expiry check in ms. Default 0. */\n    clockSkewMs?: number;\n    /** Freeze `now` for tests. */\n    now?: Date;\n}\n\nexport type VerifyChallengeReason =\n    | 'ok'\n    | 'malformed'\n    | 'expired'\n    | 'not_yet_valid'\n    | 'sig_invalid'\n    | 'sig_unsupported_scheme'\n    | 'audience_mismatch'\n    | 'purpose_mismatch'\n    | 'nonce_mismatch';\n\nexport interface VerifyChallengeResult {\n    ok: boolean;\n    reason: VerifyChallengeReason;\n    /** Present on success — the cryptographically proven Bitcoin address. */\n    address?: string;\n    /** Present on success — the scheme that verified the signature. */\n    scheme?: Scheme;\n    /** Present on success — when the challenge expires (unix ms). */\n    expiresAt?: number;\n    /** Present on success — the nonce from the challenge. */\n    nonce?: string;\n    /** Present on success — the audience extension, if any. */\n    audience?: string;\n    /** Present on success — the purpose extension, if any. */\n    purpose?: string;\n}\n\n/**\n * Verify a signed challenge. Returns the proven address on success.\n *\n * The caller is responsible for nonce replay prevention — pass `expectedNonce`\n * with the value you stashed at issue time.\n */\nexport async function verifyChallenge(\n    opts: VerifyChallengeOptions\n): Promise<VerifyChallengeResult> {\n    let parsed: ParsedChallenge;\n    try {\n        parsed = parseChallenge(opts.message);\n    } catch {\n        return { ok: false, reason: 'malformed' };\n    }\n\n    const { address, nonce, issuedAt, expiresAt, ack, audience, purpose } = parsed;\n    if (!address || !nonce || !issuedAt || !expiresAt || !ack) {\n        return { ok: false, reason: 'malformed' };\n    }\n    if (ack !== AUTH_ACK) {\n        return { ok: false, reason: 'malformed' };\n    }\n    if (!/^[0-9a-f]{32}$/.test(nonce)) {\n        return { ok: false, reason: 'malformed' };\n    }\n\n    const now = opts.now ?? new Date();\n    const skew = opts.clockSkewMs ?? 0;\n\n    if (now.getTime() - skew > expiresAt.getTime()) {\n        return { ok: false, reason: 'expired' };\n    }\n    if (now.getTime() + skew < issuedAt.getTime()) {\n        return { ok: false, reason: 'not_yet_valid' };\n    }\n\n    if (opts.expectedNonce && nonce !== opts.expectedNonce) {\n        return { ok: false, reason: 'nonce_mismatch' };\n    }\n    if (opts.expectedAudience && audience !== opts.expectedAudience) {\n        return { ok: false, reason: 'audience_mismatch' };\n    }\n    if (opts.expectedPurpose && purpose !== opts.expectedPurpose) {\n        return { ok: false, reason: 'purpose_mismatch' };\n    }\n\n    const sigBase64 = toBase64Maybe(opts.signature);\n    const scheme = signatureScheme(sigBase64);\n    if (!scheme) return { ok: false, reason: 'sig_unsupported_scheme' };\n    if (!verifyBitcoinSignature(address, opts.message, sigBase64)) {\n        return { ok: false, reason: 'sig_invalid' };\n    }\n\n    return {\n        ok: true,\n        reason: 'ok',\n        address,\n        scheme,\n        expiresAt: expiresAt.getTime(),\n        nonce,\n        ...(audience !== undefined ? { audience } : {}),\n        ...(purpose !== undefined ? { purpose } : {}),\n    };\n}\n"]}
+{"version":3,"sources":["../src/options.ts","../src/utils/signature.ts","../src/challenge.ts"],"names":["verifyBitcoinSignature"],"mappings":"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","file":"challenge.mjs","sourcesContent":["import type { IssueChallengeOptions } from './challenge';\nimport type { CheckParams } from './check';\nimport type { ScoringConfig } from './scoring';\nimport type { VerifyOptions } from './types';\n\n/** The options `check()` reads. */\nconst CHECK_OPTIONS: ReadonlySet<string> = new Set<keyof CheckParams>([\n    'addr',\n    'id',\n    'identity',\n    'minSats',\n    'minDays',\n    'relays',\n    'verifyOptions',\n]);\n\n/** The options `verify()` reads. */\nconst VERIFY_OPTIONS: ReadonlySet<string> = new Set<keyof VerifyOptions>([\n    'testMode',\n    'demoMode',\n    'expectedAud',\n    'esploraMainnetBase',\n    'esploraSignetBase',\n    'esploraTestnetBase',\n    'coverSats',\n]);\n\n/**\n * Throw on a key the SDK does not read. Ignored, a misspelt `minSats` would\n * leave the threshold at 0, and a misspelt `expectedAud` would skip the\n * audience check.\n */\nfunction refuseUnknown(where: string, opts: unknown, known: ReadonlySet<string>): void {\n    if (opts === null || typeof opts !== 'object') {\n        throw new TypeError(`@orangecheck/sdk: ${where} must be an object`);\n    }\n    const unknown = Object.keys(opts).filter((k) => !known.has(k));\n    if (unknown.length > 0) {\n        throw new TypeError(\n            `@orangecheck/sdk: ${where}: unknown option ${unknown.join(', ')}. ` +\n                `It reads only ${[...known].join(', ')}.`\n        );\n    }\n    // Readers read opts.key, which follows the prototype: a known key must be the caller's own.\n    const inherited = [...known].filter((k) => k in opts && !Object.prototype.hasOwnProperty.call(opts, k));\n    if (inherited.length > 0) {\n        throw new TypeError(`@orangecheck/sdk: ${where}: option ${inherited.join(', ')} is inherited, not set by the caller`);\n    }\n}\n\nexport function checkCheckParams(params: CheckParams): void {\n    refuseUnknown('check()', params, CHECK_OPTIONS);\n    if (params.verifyOptions !== undefined) checkVerifyOptions(params.verifyOptions, 'verifyOptions');\n}\n\nexport function checkVerifyOptions(opts: VerifyOptions, where = 'verify()'): void {\n    refuseUnknown(where, opts, VERIFY_OPTIONS);\n}\n\n/** The options `issueChallenge()` reads. */\nconst CHALLENGE_OPTIONS: ReadonlySet<string> = new Set<keyof IssueChallengeOptions>([\n    'address',\n    'ttlSeconds',\n    'nonce',\n    'audience',\n    'purpose',\n    'now',\n]);\n\nexport function checkChallengeOptions(opts: IssueChallengeOptions): void {\n    refuseUnknown('issueChallenge()', opts, CHALLENGE_OPTIONS);\n}\n\n/** The keys `computeScore()` reads from its config. */\nconst SCORING_OPTIONS: ReadonlySet<string> = new Set<keyof ScoringConfig>(['algorithm']);\n\nexport function checkScoringConfig(config: ScoringConfig): void {\n    refuseUnknown('computeScore()', config, SCORING_OPTIONS);\n}\n","import type { Scheme } from '../types';\n\nimport { Buffer } from 'buffer';\n\n/** A signature as base64: hex input is converted, anything else passes through. */\nexport function toBase64Maybe(sig: string): string {\n    if (/^[0-9a-fA-F]+$/.test(sig) && sig.length % 2 === 0) {\n        return Buffer.from(sig, 'hex').toString('base64');\n    }\n    return sig;\n}\n\n/**\n * The scheme a signature's bytes say it is, the same rule @orangecheck/bip322\n * verifies by: 65 bytes is a BIP-137 compact signature, whatever the address,\n * and anything else is BIP-322 simple. `null` for a BIP-322 full or\n * proof-of-funds signature, which is not supported.\n */\nexport function signatureScheme(sigBase64: string): Scheme | null {\n    if (/^(ful|pof)/.test(sigBase64)) return null;\n    if (sigBase64.startsWith('smp')) return 'bip322';\n    return Buffer.from(sigBase64, 'base64').length === 65 ? 'legacy' : 'bip322';\n}\n","/**\n * Signed-challenge auth\n *\n * When a gate can't trust the address source (public header, query string,\n * unsigned cookie), run a one-shot BIP-322 challenge first to cryptographically\n * prove the caller controls the address. Bind the proven address to a session\n * cookie or JWT, and the gate reads from there.\n *\n * This is a different wire format from the main OCP attestation — the header\n * literal is `orangecheck-auth`, not `orangecheck`, so a signed auth challenge\n * can never be confused with a reputation attestation.\n *\n *   // Server, on the \"connect wallet\" flow:\n *   const challenge = issueChallenge({ address, ttlSeconds: 300 });\n *   // → send challenge.message to the client\n *\n *   // Client signs challenge.message with BIP-322 via the user's wallet,\n *   // then posts { message, signature } back.\n *\n *   // Server, on callback:\n *   const result = await verifyChallenge({ message, signature });\n *   if (result.ok) {\n *     // result.address is now cryptographically proven; attach to session.\n *   }\n */\n\nimport type { Scheme } from './types';\n\nimport { verifySignature as verifyBitcoinSignature } from '@orangecheck/bip322';\n\nimport { checkChallengeOptions } from './options';\nimport { signatureScheme, toBase64Maybe } from './utils/signature';\n\nconst AUTH_HEADER = 'orangecheck-auth';\nconst AUTH_ACK = 'I authorize this session under the OrangeCheck auth challenge.';\n\nfunction randomNonce(): string {\n    // 16 bytes → 32 lowercase hex chars. Matches OCP core nonce format.\n    const bytes = new Uint8Array(16);\n    // Runtimes: Node 20+ (webcrypto), browsers.\n    if (typeof globalThis.crypto?.getRandomValues === 'function') {\n        globalThis.crypto.getRandomValues(bytes);\n    } else {\n        // Fallback: Math.random is *not* cryptographic — acceptable only for\n        // environments without webcrypto (old Node). Flagged explicitly.\n        for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 256);\n    }\n    return Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('');\n}\n\nfunction iso(date: Date): string {\n    return date.toISOString().replace(/\\.\\d{3}Z$/, 'Z');\n}\n\nexport interface IssueChallengeOptions {\n    /** Bitcoin address the caller claims to control. */\n    address: string;\n    /** How long the challenge is valid for. Default 300 (5 minutes). */\n    ttlSeconds?: number;\n    /** Explicit nonce. Rare; prefer auto-generated. */\n    nonce?: string;\n    /** Origin-binding extension. If set, verify will require a match. */\n    audience?: string;\n    /** Human-readable label baked into the signed message. */\n    purpose?: string;\n    /** Freeze `now` for tests. */\n    now?: Date;\n}\n\nexport interface Challenge {\n    /** The canonical text the client MUST sign. */\n    message: string;\n    /** The generated nonce (kept for correlation / server-side storage). */\n    nonce: string;\n    /** Unix ms epoch the challenge expires at. */\n    expiresAt: number;\n    /** ISO string of the same. */\n    expiresAtIso: string;\n}\n\n/**\n * Build a new signed-challenge message. The server MUST remember the nonce\n * it issued against the session (Redis, signed cookie, DB) so it can detect\n * replay or a different nonce coming back on verify.\n */\nexport function issueChallenge(opts: IssueChallengeOptions): Challenge {\n    checkChallengeOptions(opts);\n    const now = opts.now ?? new Date();\n    const ttl = opts.ttlSeconds ?? 300;\n    const expiresAt = new Date(now.getTime() + ttl * 1000);\n    const nonce = opts.nonce ?? randomNonce();\n\n    if (!/^[0-9a-f]{32}$/.test(nonce)) {\n        throw new Error('nonce must be 32 lowercase hex characters');\n    }\n\n    const coreLines = [\n        AUTH_HEADER,\n        `address: ${opts.address}`,\n        `nonce: ${nonce}`,\n        `issued_at: ${iso(now)}`,\n        `expires_at: ${iso(expiresAt)}`,\n        `ack: ${AUTH_ACK}`,\n    ];\n\n    const extensions: Array<[string, string]> = [];\n    if (opts.audience) extensions.push(['audience', opts.audience]);\n    if (opts.purpose) extensions.push(['purpose', opts.purpose]);\n    // Lexicographic sort by key — matches OCP canonicalization rules.\n    extensions.sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));\n\n    const extLines = extensions.map(([k, v]) => `${k}: ${v}`);\n    const message = [...coreLines, ...extLines].join('\\n') + '\\n';\n\n    return {\n        message,\n        nonce,\n        expiresAt: expiresAt.getTime(),\n        expiresAtIso: iso(expiresAt),\n    };\n}\n\ninterface ParsedChallenge {\n    address?: string;\n    nonce?: string;\n    issuedAt?: Date;\n    expiresAt?: Date;\n    ack?: string;\n    audience?: string;\n    purpose?: string;\n    extensions: Array<[string, string]>;\n}\n\nfunction parseChallenge(message: string): ParsedChallenge {\n    const lines = message.endsWith('\\n') ? message.slice(0, -1).split('\\n') : message.split('\\n');\n\n    if (lines[0] !== AUTH_HEADER) {\n        throw new Error('not an orangecheck-auth challenge');\n    }\n\n    const out: ParsedChallenge = { extensions: [] };\n    const coreKeys = ['address', 'nonce', 'issued_at', 'expires_at', 'ack'] as const;\n    const coreKeySet = new Set<string>(coreKeys);\n    // Duplicate detection: a challenge with two `address:` lines would\n    // previously let the second overwrite the first. A signer who saw both\n    // lines would still sign the whole text — which means the verifier and\n    // the signer disagree about what the message \"said\". Refuse instead.\n    const seenCore = new Set<string>();\n\n    for (let i = 1; i < lines.length; i++) {\n        const line = lines[i] ?? '';\n        const sep = line.indexOf(': ');\n        if (sep === -1) continue;\n        const key = line.slice(0, sep);\n        const val = line.slice(sep + 2);\n\n        if (coreKeySet.has(key)) {\n            if (seenCore.has(key)) {\n                throw new Error(`duplicate core key in challenge: ${key}`);\n            }\n            seenCore.add(key);\n            if (key === 'address') out.address = val;\n            else if (key === 'nonce') out.nonce = val;\n            else if (key === 'issued_at') out.issuedAt = new Date(val);\n            else if (key === 'expires_at') out.expiresAt = new Date(val);\n            else if (key === 'ack') out.ack = val;\n        } else {\n            out.extensions.push([key, val]);\n            if (key === 'audience') out.audience = val;\n            if (key === 'purpose') out.purpose = val;\n        }\n    }\n\n    if (seenCore.size !== coreKeys.length) {\n        throw new Error(`challenge missing core lines (${seenCore.size}/${coreKeys.length})`);\n    }\n    return out;\n}\n\nexport interface VerifyChallengeOptions {\n    /** The signed canonical challenge text, exactly as issued. */\n    message: string;\n    /** BIP-322 or legacy signature, base64 or hex. */\n    signature: string;\n    /** @deprecated Ignored: the signature's own bytes decide the scheme. */\n    scheme?: Scheme;\n\n    /** If set, require the challenge's `audience:` extension to match. */\n    expectedAudience?: string;\n    /** If set, require the challenge's `purpose:` extension to match. */\n    expectedPurpose?: string;\n    /**\n     * If set, require the challenge's `nonce:` to match. Use this to defeat\n     * replay — pair with server-side nonce storage (Redis / signed cookie).\n     */\n    expectedNonce?: string;\n\n    /** Tolerance on expiry check in ms. Default 0. */\n    clockSkewMs?: number;\n    /** Freeze `now` for tests. */\n    now?: Date;\n}\n\nexport type VerifyChallengeReason =\n    | 'ok'\n    | 'malformed'\n    | 'expired'\n    | 'not_yet_valid'\n    | 'sig_invalid'\n    | 'sig_unsupported_scheme'\n    | 'audience_mismatch'\n    | 'purpose_mismatch'\n    | 'nonce_mismatch';\n\nexport interface VerifyChallengeResult {\n    ok: boolean;\n    reason: VerifyChallengeReason;\n    /** Present on success — the cryptographically proven Bitcoin address. */\n    address?: string;\n    /** Present on success — the scheme that verified the signature. */\n    scheme?: Scheme;\n    /** Present on success — when the challenge expires (unix ms). */\n    expiresAt?: number;\n    /** Present on success — the nonce from the challenge. */\n    nonce?: string;\n    /** Present on success — the audience extension, if any. */\n    audience?: string;\n    /** Present on success — the purpose extension, if any. */\n    purpose?: string;\n}\n\n/**\n * Verify a signed challenge. Returns the proven address on success.\n *\n * The caller is responsible for nonce replay prevention — pass `expectedNonce`\n * with the value you stashed at issue time.\n */\nexport async function verifyChallenge(\n    opts: VerifyChallengeOptions\n): Promise<VerifyChallengeResult> {\n    let parsed: ParsedChallenge;\n    try {\n        parsed = parseChallenge(opts.message);\n    } catch {\n        return { ok: false, reason: 'malformed' };\n    }\n\n    const { address, nonce, issuedAt, expiresAt, ack, audience, purpose } = parsed;\n    if (!address || !nonce || !issuedAt || !expiresAt || !ack) {\n        return { ok: false, reason: 'malformed' };\n    }\n    if (ack !== AUTH_ACK) {\n        return { ok: false, reason: 'malformed' };\n    }\n    if (!/^[0-9a-f]{32}$/.test(nonce)) {\n        return { ok: false, reason: 'malformed' };\n    }\n\n    const now = opts.now ?? new Date();\n    const skew = opts.clockSkewMs ?? 0;\n\n    if (now.getTime() - skew > expiresAt.getTime()) {\n        return { ok: false, reason: 'expired' };\n    }\n    if (now.getTime() + skew < issuedAt.getTime()) {\n        return { ok: false, reason: 'not_yet_valid' };\n    }\n\n    if (opts.expectedNonce && nonce !== opts.expectedNonce) {\n        return { ok: false, reason: 'nonce_mismatch' };\n    }\n    if (opts.expectedAudience && audience !== opts.expectedAudience) {\n        return { ok: false, reason: 'audience_mismatch' };\n    }\n    if (opts.expectedPurpose && purpose !== opts.expectedPurpose) {\n        return { ok: false, reason: 'purpose_mismatch' };\n    }\n\n    const sigBase64 = toBase64Maybe(opts.signature);\n    const scheme = signatureScheme(sigBase64);\n    if (!scheme) return { ok: false, reason: 'sig_unsupported_scheme' };\n    if (!verifyBitcoinSignature(address, opts.message, sigBase64)) {\n        return { ok: false, reason: 'sig_invalid' };\n    }\n\n    return {\n        ok: true,\n        reason: 'ok',\n        address,\n        scheme,\n        expiresAt: expiresAt.getTime(),\n        nonce,\n        ...(audience !== undefined ? { audience } : {}),\n        ...(purpose !== undefined ? { purpose } : {}),\n    };\n}\n"]}

package/dist/index.js

@@ -265,6 +265,10 @@ function refuseUnknown(where, opts, known) {
       `@orangecheck/sdk: ${where}: unknown option ${unknown.join(", ")}. It reads only ${[...known].join(", ")}.`
     );
   }
+  const inherited = [...known].filter((k) => k in opts && !Object.prototype.hasOwnProperty.call(opts, k));
+  if (inherited.length > 0) {
+    throw new TypeError(`@orangecheck/sdk: ${where}: option ${inherited.join(", ")} is inherited, not set by the caller`);
+  }
 }
 function checkCheckParams(params) {
   refuseUnknown("check()", params, CHECK_OPTIONS);
@@ -273,6 +277,21 @@ function checkCheckParams(params) {
 function checkVerifyOptions(opts, where = "verify()") {
   refuseUnknown(where, opts, VERIFY_OPTIONS);
 }
+var CHALLENGE_OPTIONS = /* @__PURE__ */ new Set([
+  "address",
+  "ttlSeconds",
+  "nonce",
+  "audience",
+  "purpose",
+  "now"
+]);
+function checkChallengeOptions(opts) {
+  refuseUnknown("issueChallenge()", opts, CHALLENGE_OPTIONS);
+}
+var SCORING_OPTIONS = /* @__PURE__ */ new Set(["algorithm"]);
+function checkScoringConfig(config) {
+  refuseUnknown("computeScore()", config, SCORING_OPTIONS);
+}
 
 // src/scoring.ts
 function scoreV0(sats, days) {
@@ -287,6 +306,7 @@ function scoreTier(sats, days) {
   return "none";
 }
 function computeScore(sats, days, config) {
+  checkScoringConfig(config);
   switch (config.algorithm) {
     case "v0":
       return scoreV0(sats, days);
@@ -1295,6 +1315,7 @@ function iso(date) {
   return date.toISOString().replace(/\.\d{3}Z$/, "Z");
 }
 function issueChallenge(opts) {
+  checkChallengeOptions(opts);
   const now = opts.now ?? /* @__PURE__ */ new Date();
   const ttl = opts.ttlSeconds ?? 300;
   const expiresAt = new Date(now.getTime() + ttl * 1e3);