@taifoon/jev 0.2.1 → 0.2.2

package/docs/WORKFLOWS.md

@@ -13,8 +13,8 @@ The node outputs the receipt and the unsigned calls, and it signs nothing. With
 
 ## Workflows
 
-`workflows/0.2.1/` holds the four n8n workflows that run Jev. The same files are attached to the
-GitHub release as `jev-workflows-0.2.1.zip`:
+`workflows/0.2.2/` holds the four n8n workflows that run Jev. The same files are attached to the
+GitHub release as `jev-workflows-0.2.2.zip`:
 
 - **`hire-judge-settle.json`** runs hire → prepare (facts) → TypeSafe (the four RUBRIC_v1 questions) → answers
   (verdict, recorded and anchored) → settle on devnet. Executions 86 and 88 of this workflow are the golden runs above.
@@ -24,8 +24,8 @@ GitHub release as `jev-workflows-0.2.1.zip`:
 
 Credential references are placeholders: `{ "id": "", "name": "REPLACE: <credential type>" }`. After import, pick your
 own credential of that type. Each step names the entity it takes and emits by `$id` (`meta.taifoon.steps`). The schemas
-behind those `$id`s are in `workflows/0.2.1/schemas/`. `manifest.json` pins every file by sha256.
-`workflows/0.2.1/README.md` explains each workflow step by step and lists the nodes and credentials it needs:
+behind those `$id`s are in `workflows/0.2.2/schemas/`. `manifest.json` pins every file by sha256.
+`workflows/0.2.2/README.md` explains each workflow step by step and lists the nodes and credentials it needs:
 
 - `@taifoon/n8n-nodes-typesafe`, tested with 1.3.0, is on npm.
 - `n8n-nodes-taifoon`, tested with 0.4.2, and `n8n-nodes-taifoon-devnet-signer`, tested with 0.2.0, are custom

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taifoon/jev",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Grade AI agent jobs with TypeSafe's Jev and record the verdict on chain: code checks the facts, Jev answers a published rubric, and you get a receipt, the on-chain record and the evaluator call for ERC-8183 and Virtuals ACP. No runtime dependencies, no key inside.",
   "keywords": [
     "jev",

package/workflows/{0.2.1 → 0.2.2}/README.md

@@ -1,4 +1,4 @@
-# Jev workflows 0.2.1
+# Jev workflows 0.2.2
 
 The n8n workflows that run Jev on n8n.taifoon.dev, exported with credential references replaced by placeholders (`{ "id": "", "name": "REPLACE: <credential type>" }`: pick your own credential of that type after import). Import with n8n → Workflows → Import from File, or `n8n import:workflow --input=<file>`. Every step carries its contract: `meta.taifoon.steps` names the canonical entity it takes and emits by `$id`; the schemas are in `schemas/` (the `$id`s are identifiers, the files are here).
 
@@ -22,7 +22,7 @@ The n8n workflows that run Jev on n8n.taifoon.dev, exported with credential refe
 
 One hire from offer to settlement. The seller’s reply is held with its digest; prepare decides the facts (a hard fail skips Jev); your TypeSafe credential answers the four RUBRIC_v1 questions; answers composes the verdict under THRESHOLDS_v1, records decision.v2 and jev.answer.v1 and anchors them on the devnet logs; a complete settles through the devnet assurance hook (approve, fund, submit, complete), needs_review is held. Executions 86 and 88 of this workflow are the golden runs @taifoon/jev re-derives.
 
-- source: `tfnhiresettle001` on n8n.taifoon.dev · sha256 `013f382c33e9b54f7585dac5811f8d8a544c8e5e8315eb51335e0539e81dc148`
+- source: `tfnhiresettle001` on n8n.taifoon.dev · sha256 `7053740d120a0d46a0e35ce75194b8529579d353f83a081e80c58dcb663f0958`
 - nodes: `n8n-nodes-taifoon`, `@taifoon/n8n-nodes-typesafe`, `n8n-nodes-taifoon-devnet-signer`; built-ins manualTrigger v1, set v3.4, code v2, if v2.2
 - credentials: `taifoonRelayerApi`, `taifoonTypeSafeApi`, `taifoonDevnetKeyApi`
 
@@ -45,6 +45,7 @@ One hire from offer to settlement. The seller’s reply is held with its digest;
 | Buyer · complete + capture | settlement.json | settlement.json | complete(jobId) (+ capture): machine → Settled |
 | Held for review | settlement.json | settlement.json | needs_review / reject: funded and sealed, nothing paid; the evaluator leg or the deadline decides |
 | Receipt | settlement.json | job.json | the whole JOB: hire, delivery, facts, verdict, settlement — every transaction with its proof link |
+| Proofs · wait | job.json | job.json | GET /v1/proof/tx/36927/<tx> for every transaction of the run; pending is retried with backoff (5 s -> 60 s, <= 240 s), never reported as a gap |
 
 ## Jev on-chain grader (grade → stamp → devnet) — `jev-grader.json`
 

package/workflows/{0.2.1 → 0.2.2}/hire-judge-settle.json

@@ -51,13 +51,13 @@
             {
               "id": "i6",
               "name": "buyer",
-              "value": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
+              "value": "0xf6806EFcb34dDa2eE78967384D09367ECd364483",
               "type": "string"
             },
             {
               "id": "i7",
               "name": "seller",
-              "value": "0x70997970C51812dc3A010C7d01b50e0d17dc79C8",
+              "value": "0xe6209aD65a66d5eF11E00A7B33Cd21ce7084715c",
               "type": "string"
             },
             {
@@ -71,6 +71,24 @@
               "name": "chainId",
               "value": 36927,
               "type": "number"
+            },
+            {
+              "id": "i10",
+              "name": "lane",
+              "value": "a",
+              "type": "string"
+            },
+            {
+              "id": "i11",
+              "name": "tenant",
+              "value": "",
+              "type": "string"
+            },
+            {
+              "id": "i12",
+              "name": "deadline_sec",
+              "value": 300,
+              "type": "number"
             }
           ]
         },
@@ -286,7 +304,9 @@
         "refId": "={{ $json.handshake_id }}",
         "settleOptions": {
           "endpoint": "={{ $json.endpoint }}",
-          "note": "={{ 'agent ' + $json.candidate + ' · decision ' + ($json.decision_id || 'none') + ' · verdict ' + ($json.verdict || 'n/a') }}"
+          "note": "={{ 'agent ' + $json.candidate + ' · decision ' + ($json.decision_id || 'none') + ' · verdict ' + ($json.verdict || 'n/a') }}",
+          "tenant": "={{ $json.tenant }}",
+          "deadline": "={{ Math.floor(Date.now() / 1000) + Number($json.deadline_sec || 3600) }}"
         }
       },
       "credentials": {
@@ -408,7 +428,7 @@
     },
     {
       "parameters": {
-        "jsCode": "// The record: every transaction with its proof and explorer link, the decision, the job, and whether money moved.\nconst legs = ['Seller · approve deposit', 'Buyer · approve + fund', 'Seller · submit', 'Buyer · complete + capture'];\nconst txs = [];\nfor (const n of legs) { let sent = []; try { sent = $(n).first().json.sent || []; } catch (e) { /* a leg the verdict skipped */ }\n  for (const s of sent) txs.push({ leg: n, action: s.action, tx: s.tx, status: s.status, block: s.block, proof: 'https://www.taifoon.io/v1/proof/tx/36927/' + s.tx, scan: 'https://www.taifoon.io/scan/36927/tx/' + s.tx }); }\nlet held = null; try { held = $('Held for review').first().json; } catch (e) { held = null; }\nconst s = $('Settle').first().json;\nconst v = $('Verdict').first().json;\nconst complete = txs.find((t) => t.action === 'complete') || null;\nreturn [{ json: { handshake_id: v.handshake_id, decision_id: v.decision_id, decision_digest: v.decision_digest, decision_anchor_tx: v.decision_anchor ? v.decision_anchor.tx : null, verdict: v.verdict, verdict_auto: v.verdict_auto, reasons: v.reasons, receipt_hash: v.receipt_hash, judge: { called: v.judge_called, model: v.model, latency_ms: v.judge_latency_ms, answers_source: v.answers_source, execution: v.execution, prepare_digest: v.prepare_digest, quota: v.quota }, ending: complete ? 'completed: seller paid, deposit returned, payment captured' : held ? 'held: ' + held.next : 'incomplete', jobId: s.jobId, correlator: s.correlator, chainId: 36927, hook: s.hook, token: s.token, price: s.price, premium: s.premium, deposit: s.deposit, evidence: v.evidence, settlement_tx: complete ? complete.tx : null, settlement_proof: complete ? complete.proof : null, transactions: txs, all_mined: txs.every((t) => t.status === 'success') && txs.length === (complete ? 6 : 4) } }];"
+        "jsCode": "// The record: every transaction with its proof and explorer link, the decision, the job, and whether money moved.\nconst legs = ['Seller · approve deposit', 'Buyer · approve + fund', 'Seller · submit', 'Buyer · complete + capture'];\nconst txs = [];\nfor (const n of legs) { let sent = []; try { sent = $(n).first().json.sent || []; } catch (e) { /* a leg the verdict skipped */ }\n  for (const s of sent) txs.push({ leg: n, action: s.action, tx: s.tx, status: s.status, block: s.block, proof: 'https://www.taifoon.io/v1/proof/tx/36927/' + s.tx, scan: 'https://www.taifoon.io/scan/36927/tx/' + s.tx }); }\nlet held = null; try { held = $('Held for review').first().json; } catch (e) { held = null; }\nconst s = $('Settle').first().json;\nconst v = $('Verdict').first().json;\nconst complete = txs.find((t) => t.action === 'complete') || null;\nreturn [{ json: { handshake_id: v.handshake_id, decision_id: v.decision_id, decision_digest: v.decision_digest, decision_anchor_tx: v.decision_anchor ? v.decision_anchor.tx : null, verdict: v.verdict, verdict_auto: v.verdict_auto, reasons: v.reasons, receipt_hash: v.receipt_hash, judge: { called: v.judge_called, model: v.model, latency_ms: v.judge_latency_ms, answers_source: v.answers_source, execution: v.execution, prepare_digest: v.prepare_digest, quota: v.quota }, ending: complete ? 'completed: seller paid, deposit returned, payment captured' : held ? 'held: ' + held.next : 'incomplete', lane: v.lane || null, tenant: s.tenant || null, deadline: s.deadline ?? null, jobId: s.jobId, correlator: s.correlator, chainId: 36927, hook: s.hook, token: s.token, price: s.price, premium: s.premium, deposit: s.deposit, evidence: v.evidence, settlement_tx: complete ? complete.tx : null, settlement_proof: complete ? complete.proof : null, transactions: txs, all_mined: txs.every((t) => t.status === 'success') && txs.length === (complete ? 6 : 4) } }];"
       },
       "id": "n11",
       "name": "Receipt",
@@ -470,6 +490,21 @@
       ],
       "notes": "in: settlement.json → out: settlement.json · needs_review / reject: funded and sealed, nothing paid; the evaluator leg or the deadline decides",
       "notesInFlow": true
+    },
+    {
+      "parameters": {
+        "jsCode": "// Every transaction of the run is proven under the V5 superroot before the run ends (/v1/proof/tx/36927/<tx>).\n// The producer runs ~6-8 devnet blocks (~15 s) behind the head, and its blob route can answer \"pending\" under load:\n// a pending answer is waited out with backoff (5 s doubling to 60 s), never reported as a gap. The wait is capped at\n// 240 s (n8n's task-runner limit); what is still pending is listed, and the runner (workflows/e2e.sh) keeps waiting.\nconst r = $input.first().json;\nconst SITE = 'https://www.taifoon.io';\nconst txs = [...(r.transactions || []).map((t) => ({ leg: t.leg, action: t.action, tx: t.tx })), ...(r.decision_anchor_tx ? [{ leg: 'decision anchor', action: 'JevDecisionLog.record', tx: r.decision_anchor_tx }] : [])];\nconst until = Date.now() + 240000;\nconst sleep = (ms) => new Promise((res) => setTimeout(res, ms));\nconst final = (c) => Boolean(c && c.proof_served && c.block_hash_matches && c.within_verifiable_range);\nconst proofs = [];\nfor (const t of txs) {\n  let wait = 5000, attempts = 0, last = null;\n  for (;;) {\n    attempts++;\n    try { last = await this.helpers.httpRequest({ method: 'GET', url: SITE + '/v1/proof/tx/36927/' + t.tx + (attempts > 3 ? '?wait=1' : ''), json: true, timeout: 60000, ignoreHttpStatusErrors: true }); }\n    catch (e) { last = { ok: false, error: String((e && e.message) || e).slice(0, 160) }; }\n    if (final(last && last.checks)) break;\n    if (last && last.code === 'PROVABLE_GAP' && last.gap) break;   // the producer skipped this block: no wait fills it\n    if (Date.now() + wait > until) break;\n    await sleep(wait); wait = Math.min(wait * 2, 60000);\n  }\n  const c = (last && last.checks) || {};\n  proofs.push({ ...t, finalized: final(c), gap: Boolean(last && last.gap), attempts, checks: c, proof: SITE + '/v1/proof/tx/36927/' + t.tx });\n}\nreturn [{ json: { ...r, proofs, all_proven: proofs.length > 0 && proofs.every((p) => p.finalized), proofs_pending: proofs.filter((p) => !p.finalized).map((p) => p.tx) } }];"
+      },
+      "id": "n17",
+      "name": "Proofs · wait",
+      "type": "n8n-nodes-base.code",
+      "typeVersion": 2,
+      "position": [
+        3520,
+        300
+      ],
+      "notes": "in: job.json → out: job.json · GET /v1/proof/tx/36927/<tx> for every transaction of the run; pending is retried with backoff (5 s -> 60 s, <= 240 s), never reported as a gap",
+      "notesInFlow": true
     }
   ],
   "connections": {
@@ -662,6 +697,17 @@
           }
         ]
       ]
+    },
+    "Receipt": {
+      "main": [
+        [
+          {
+            "node": "Proofs · wait",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
     }
   },
   "settings": {
@@ -759,6 +805,11 @@
           "in": "https://www.taifoon.io/schemas/coordination/v1/settlement.json",
           "out": "https://www.taifoon.io/schemas/coordination/v1/job.json",
           "does": "the whole JOB: hire, delivery, facts, verdict, settlement — every transaction with its proof link"
+        },
+        "Proofs · wait": {
+          "in": "https://www.taifoon.io/schemas/coordination/v1/job.json",
+          "out": "https://www.taifoon.io/schemas/coordination/v1/job.json",
+          "does": "GET /v1/proof/tx/36927/<tx> for every transaction of the run; pending is retried with backoff (5 s -> 60 s, <= 240 s), never reported as a gap"
         }
       }
     }

package/workflows/{0.2.1 → 0.2.2}/manifest.json

@@ -1,13 +1,13 @@
 {
-  "bundle": "jev-workflows-0.2.1",
-  "package": "@taifoon/jev@0.2.1",
+  "bundle": "jev-workflows-0.2.2",
+  "package": "@taifoon/jev@0.2.2",
   "workflows": [
     {
       "file": "hire-judge-settle.json",
       "source_id": "tfnhiresettle001",
       "name": "Taifoon — HIRE → JUDGE → SETTLE (devnet 36927)",
-      "sha256": "013f382c33e9b54f7585dac5811f8d8a544c8e5e8315eb51335e0539e81dc148",
-      "nodes": 17,
+      "sha256": "7053740d120a0d46a0e35ce75194b8529579d353f83a081e80c58dcb663f0958",
+      "nodes": 18,
       "packages": [
         "n8n-nodes-taifoon",
         "@taifoon/n8n-nodes-typesafe",