@taifoon/jev 0.2.9 → 0.2.11

package/dist/addresses.d.ts

@@ -0,0 +1,62 @@
+export declare const REGISTRY_ADDRESSES: {
+    /** jev · JevAnswerLog (devnet) (devnet-only) */
+    readonly devnetAnswerLog: {
+        readonly chainId: 36927;
+        readonly address: "0xD8c1d8188Fc8EE388792f6EB3B3dbd4f341Ba8e3";
+        readonly block: 1106754;
+    };
+    /** jev · JevDecisionLog (devnet) (devnet-only) */
+    readonly devnetDecisionLog: {
+        readonly chainId: 36927;
+        readonly address: "0x1D622511862DD7DEffB8fEeBc225E0FAdA1e9A05";
+        readonly block: 981099;
+    };
+    /** taifoon-assurance · JudgeAdapter (devnet) (devnet-only) */
+    readonly devnetJudgeAdapter: {
+        readonly chainId: 36927;
+        readonly address: "0xbd4c9e797a8DBbfdde9C77bc5A5b21ACf611Db8f";
+        readonly block: null;
+    };
+    /** taifoon-assurance · AssuranceHook (proxy, devnet) (devnet-only) */
+    readonly devnetAssuranceHook: {
+        readonly chainId: 36927;
+        readonly address: "0x7110C8951d17B69054395742e265bbd98259564A";
+        readonly block: 909786;
+    };
+    /** jev · JevAnswerLog (live) */
+    readonly baseAnswerLog: {
+        readonly chainId: 8453;
+        readonly address: "0x8e9B9cE86a2d55c10318607b0c815B7B8C66254d";
+        readonly block: 51863008;
+    };
+    /** jev · JevAnswerLog (first deploy) (superseded) */
+    readonly baseAnswerLogFirstDeploy: {
+        readonly chainId: 8453;
+        readonly address: "0x5bac70eb78224bbCBa83f5A36DF09D549d3f57fa";
+        readonly block: 51856203;
+    };
+    /** jev · JevDecisionLog (live) */
+    readonly baseDecisionLog: {
+        readonly chainId: 8453;
+        readonly address: "0x209490d6A0FFC5368A42b0c2208BDCda853f6a92";
+        readonly block: 51856200;
+    };
+    /** standards-erc8183 · Virtuals ACP v3 (ERC-8183) (live) */
+    readonly virtualsErc8183: {
+        readonly chainId: 8453;
+        readonly address: "0x238E541BfefD82238730D00a2208E5497F1832E0";
+        readonly block: 44427013;
+    };
+    /** standards-erc8183 · memo-ACP router (live) */
+    readonly virtualsMemoAcpRouter: {
+        readonly chainId: 8453;
+        readonly address: "0xa6C9BA866992cfD7fd6460ba912bfa405adA9df0";
+        readonly block: 36786061;
+    };
+    /** standards-erc8183 · BitAgent ERC-8183 escrow (live) */
+    readonly bitagentErc8183: {
+        readonly chainId: 8453;
+        readonly address: "0x5009ABB3A309115a4a682C66BAf3BC9E0329BaB7";
+        readonly block: 48395723;
+    };
+};

package/dist/addresses.js

@@ -0,0 +1,24 @@
+// VENDORED from an address registry (addresses.json, public subset) by scripts/vendor-addresses.mjs - do not edit here.
+// Only the contracts this SDK names; test/addresses-vendor.test.ts checks the copy against the registry.
+export const REGISTRY_ADDRESSES = {
+    /** jev · JevAnswerLog (devnet) (devnet-only) */
+    devnetAnswerLog: { chainId: 36927, address: '0xD8c1d8188Fc8EE388792f6EB3B3dbd4f341Ba8e3', block: 1106754 },
+    /** jev · JevDecisionLog (devnet) (devnet-only) */
+    devnetDecisionLog: { chainId: 36927, address: '0x1D622511862DD7DEffB8fEeBc225E0FAdA1e9A05', block: 981099 },
+    /** taifoon-assurance · JudgeAdapter (devnet) (devnet-only) */
+    devnetJudgeAdapter: { chainId: 36927, address: '0xbd4c9e797a8DBbfdde9C77bc5A5b21ACf611Db8f', block: null },
+    /** taifoon-assurance · AssuranceHook (proxy, devnet) (devnet-only) */
+    devnetAssuranceHook: { chainId: 36927, address: '0x7110C8951d17B69054395742e265bbd98259564A', block: 909786 },
+    /** jev · JevAnswerLog (live) */
+    baseAnswerLog: { chainId: 8453, address: '0x8e9B9cE86a2d55c10318607b0c815B7B8C66254d', block: 51863008 },
+    /** jev · JevAnswerLog (first deploy) (superseded) */
+    baseAnswerLogFirstDeploy: { chainId: 8453, address: '0x5bac70eb78224bbCBa83f5A36DF09D549d3f57fa', block: 51856203 },
+    /** jev · JevDecisionLog (live) */
+    baseDecisionLog: { chainId: 8453, address: '0x209490d6A0FFC5368A42b0c2208BDCda853f6a92', block: 51856200 },
+    /** standards-erc8183 · Virtuals ACP v3 (ERC-8183) (live) */
+    virtualsErc8183: { chainId: 8453, address: '0x238E541BfefD82238730D00a2208E5497F1832E0', block: 44427013 },
+    /** standards-erc8183 · memo-ACP router (live) */
+    virtualsMemoAcpRouter: { chainId: 8453, address: '0xa6C9BA866992cfD7fd6460ba912bfa405adA9df0', block: 36786061 },
+    /** standards-erc8183 · BitAgent ERC-8183 escrow (live) */
+    bitagentErc8183: { chainId: 8453, address: '0x5009ABB3A309115a4a682C66BAf3BC9E0329BaB7', block: 48395723 },
+};

package/dist/contracts.d.ts

@@ -15,7 +15,7 @@ export declare const CONTRACTS: Readonly<{
         };
         /** JudgeAdapter: posts a verdict (with the decision digest) to the devnet assurance hook */
         readonly judgeAdapter: "0xbd4c9e797a8DBbfdde9C77bc5A5b21ACf611Db8f";
-        readonly assuranceHook: "0x7110c8951d17b69054395742e265bbd98259564a";
+        readonly assuranceHook: string;
     };
     /** Base (8453): both logs are live. Only the KMS recorder 0xe9F0E71e7Fc66864126C0aE5588a7858b25dE51D is `trusted` on the answer log. */
     readonly base: {

package/dist/contracts.js

@@ -1,31 +1,33 @@
 // Where the records and the evaluator seats live. Every address here was read from the chain or from its deploy
-// broadcast; nothing is deployed by this package.
+// broadcast; nothing is deployed by this package. The contract addresses come from the address registry (src/addresses.ts,
+// vendored by scripts/vendor-addresses.mjs); the recorder and the BitAgent evaluator are accounts, not registry contracts.
+import { REGISTRY_ADDRESSES as R } from './addresses.js';
 export const CONTRACTS = Object.freeze({
     /** the public devnet the logs live on: chain 36927, free gas; anyone may send */
     devnet: {
         chainId: 36927,
         rpc: 'https://rpc.taifoon.dev',
         /** JevAnswerLog: append-only, no owner. Recorders fixed at deploy are `trusted`; any other sender is logged with trusted = false */
-        answerLog: { address: '0xD8c1d8188Fc8EE388792f6EB3B3dbd4f341Ba8e3', fromBlock: 1_106_754 },
+        answerLog: { address: R.devnetAnswerLog.address, fromBlock: R.devnetAnswerLog.block },
         /** JevDecisionLog: append-only, no owner, no upgrade; the recorder is msg.sender */
-        decisionLog: { address: '0x1D622511862DD7DEffB8fEeBc225E0FAdA1e9A05', fromBlock: 981_099 },
+        decisionLog: { address: R.devnetDecisionLog.address, fromBlock: R.devnetDecisionLog.block },
         /** JudgeAdapter: posts a verdict (with the decision digest) to the devnet assurance hook */
-        judgeAdapter: '0xbd4c9e797a8DBbfdde9C77bc5A5b21ACf611Db8f',
-        assuranceHook: '0x7110c8951d17b69054395742e265bbd98259564a',
+        judgeAdapter: R.devnetJudgeAdapter.address,
+        assuranceHook: R.devnetAssuranceHook.address.toLowerCase(),
     },
     /** Base (8453): both logs are live. Only the KMS recorder 0xe9F0E71e7Fc66864126C0aE5588a7858b25dE51D is `trusted` on the answer log. */
     base: {
         chainId: 8453,
         rpc: 'https://mainnet.base.org',
         /** JevAnswerLog, redeployed 2026-09-27 (tx 0xeb7d2dac…ae87); supersedes 0x5bac70eb78224bbCBa83f5A36DF09D549d3f57fa */
-        answerLog: { address: '0x8e9B9cE86a2d55c10318607b0c815B7B8C66254d', fromBlock: 51_863_008 },
+        answerLog: { address: R.baseAnswerLog.address, fromBlock: R.baseAnswerLog.block },
         /** JevDecisionLog, deployed 2026-09-27 (tx 0x0e6300c0…4fc7); the recorder is msg.sender */
-        decisionLog: { address: '0x209490d6A0FFC5368A42b0c2208BDCda853f6a92', fromBlock: 51_856_200 },
+        decisionLog: { address: R.baseDecisionLog.address, fromBlock: R.baseDecisionLog.block },
         /** the one trusted recorder of the Base answer log */
         answerRecorder: '0xe9F0E71e7Fc66864126C0aE5588a7858b25dE51D',
-        virtualsErc8183: '0x238E541BfefD82238730D00a2208E5497F1832E0',
-        virtualsMemoAcpRouter: '0xa6C9BA866992cfD7fd6460ba912bfa405adA9df0',
-        bitagentErc8183: '0x5009ABB3A309115a4a682C66BAf3BC9E0329BaB7',
+        virtualsErc8183: R.virtualsErc8183.address,
+        virtualsMemoAcpRouter: R.virtualsMemoAcpRouter.address,
+        bitagentErc8183: R.bitagentErc8183.address,
         bitagentEvaluator: '0x4302e523D982f3b89Cfc43cE4530C012b495Ec11',
     },
 });

package/dist/pipeline.js

@@ -5,7 +5,7 @@
 // (https://coord.taifoon.dev by default) the job comes from /v1/judge/queue, the pack from /v1/judge/evidence, the
 // seller's terms from /v1/pools/quote, and — only with a relayer key — the answers are recorded on the layer through
 // /v1/judge/answers/record. Nothing here signs a transaction.
-import { premium as wilsonPremium, wilson } from '@taifoon/jev-wilson';
+import { premium as wilsonPremium, wilson } from './wilson.js';
 import { facts as runFacts } from './facts.js';
 import { grade } from './grade.js';
 import { record } from './record.js';

package/dist/wilson.d.ts

@@ -0,0 +1,49 @@
+/** z for a two-sided 95% interval, as the layer pins it. */
+export declare const Z = 1.959963984540054;
+/** The layer's pool rule: no pool covers above this premium ratio. */
+export declare const MAX_PREMIUM_RATIO = 0.3;
+/** The premium ratio is rounded to millionths before it multiplies the price. */
+export declare const RATIO_SCALE = 1000000;
+/** The Wilson score interval for `successes` of `n`. [0, 1] when n = 0. Same operations, same order as the layer. */
+export declare function wilson(successes: number, n: number, z?: number): [number, number];
+/** u_F: the upper Wilson bound on the failure rate, n - k failed of n. This is the layer's π ratio. */
+export declare function wilsonUpperFailure(k: number, n: number, z?: number): number;
+/** floor(price × round(ratio × 1e6) / 1e6), exactly as the layer's pool-quote computes it. */
+export declare function premiumAmount(price: bigint, ratio: number): bigint;
+export type SellerRecord = {
+    k: number;
+    n: number;
+};
+export type PremiumOpts = {
+    /** floor on the ratio; default 0 (the layer has none) */
+    min?: number;
+    /** cover only when ratio <= max; default 0.30 (the layer's pool rule) */
+    max?: number;
+    /** price in the token's smallest unit; when given, `amount` is computed */
+    price?: bigint | number | string;
+    /** z for the record form; default Z */
+    z?: number;
+};
+export type Premium = {
+    insurable: false;
+    reason: 'UNKNOWN';
+    ratio: null;
+    amount: null;
+    covered: false;
+    basis: 'record';
+} | {
+    insurable: true;
+    ratio: number;
+    amount: bigint | null;
+    covered: boolean;
+    basis: 'record' | 'p_L';
+};
+/**
+ * The premium for the next job.
+ *
+ * premium({ k, n }, opts)  prices from the record: ratio = u_F, bit-for-bit with the layer.
+ * premium(pL, opts)        prices from a lower bound you already hold: ratio = 1 - p_L. Equal in real
+ *                          arithmetic, but 1 - p_L can differ from u_F in the last bits of a double.
+ *                          Use the record form when you need the layer's number to the last digit.
+ */
+export declare function premium(input: number | SellerRecord, opts?: PremiumOpts): Premium;

package/dist/wilson.js

@@ -0,0 +1,66 @@
+// GENERATED from @taifoon/jev-wilson 0.1.0 (src/wilson.ts) by scripts/vendor-wilson.mjs. Do not edit here.
+// The pricing half only: z, the Wilson interval, the premium. Same numbers as the layer's /v1/pools/quote.
+/** z for a two-sided 95% interval, as the layer pins it. */
+export const Z = 1.959963984540054;
+/** The layer's pool rule: no pool covers above this premium ratio. */
+export const MAX_PREMIUM_RATIO = 0.3;
+/** The premium ratio is rounded to millionths before it multiplies the price. */
+export const RATIO_SCALE = 1_000_000;
+function checkRecord(k, n) {
+    if (!Number.isInteger(k) || !Number.isInteger(n) || k < 0 || n < 0 || k > n) {
+        throw new RangeError(`need integers 0 <= k <= n, got k=${k}, n=${n}`);
+    }
+}
+/** The Wilson score interval for `successes` of `n`. [0, 1] when n = 0. Same operations, same order as the layer. */
+export function wilson(successes, n, z = Z) {
+    if (n <= 0)
+        return [0, 1];
+    const p = successes / n, z2 = z * z;
+    const d = 1 + z2 / n;
+    const c = p + z2 / (2 * n);
+    const s = z * Math.sqrt((p * (1 - p) + z2 / (4 * n)) / n);
+    return [Math.max(0, (c - s) / d), Math.min(1, (c + s) / d)];
+}
+/** u_F: the upper Wilson bound on the failure rate, n - k failed of n. This is the layer's π ratio. */
+export function wilsonUpperFailure(k, n, z = Z) {
+    checkRecord(k, n);
+    return wilson(n - k, n, z)[1];
+}
+/** JavaScript Math.round, kept explicit so the Python twin can match it. */
+const roundHalfUp = (x) => Math.round(x);
+/** floor(price × round(ratio × 1e6) / 1e6), exactly as the layer's pool-quote computes it. */
+export function premiumAmount(price, ratio) {
+    if (price <= 0n)
+        throw new RangeError('price must be a positive integer in the token’s smallest unit');
+    return (price * BigInt(roundHalfUp(ratio * RATIO_SCALE))) / BigInt(RATIO_SCALE);
+}
+/**
+ * The premium for the next job.
+ *
+ * premium({ k, n }, opts)  prices from the record: ratio = u_F, bit-for-bit with the layer.
+ * premium(pL, opts)        prices from a lower bound you already hold: ratio = 1 - p_L. Equal in real
+ *                          arithmetic, but 1 - p_L can differ from u_F in the last bits of a double.
+ *                          Use the record form when you need the layer's number to the last digit.
+ */
+export function premium(input, opts = {}) {
+    const min = opts.min ?? 0;
+    const max = opts.max ?? MAX_PREMIUM_RATIO;
+    let raw;
+    let basis;
+    if (typeof input === 'number') {
+        if (!(input >= 0 && input <= 1))
+            throw new RangeError(`p_L must be in [0, 1], got ${input}`);
+        raw = 1 - input;
+        basis = 'p_L';
+    }
+    else {
+        checkRecord(input.k, input.n);
+        if (input.k <= 0)
+            return { insurable: false, reason: 'UNKNOWN', ratio: null, amount: null, covered: false, basis: 'record' };
+        raw = wilsonUpperFailure(input.k, input.n, opts.z ?? Z);
+        basis = 'record';
+    }
+    const ratio = raw < min ? min : raw;
+    const amount = opts.price === undefined ? null : premiumAmount(BigInt(opts.price), ratio);
+    return { insurable: true, ratio, amount, covered: ratio <= max, basis };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taifoon/jev",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "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",
@@ -70,6 +70,7 @@
     "access": "public"
   },
   "devDependencies": {
+    "@taifoon/jev-wilson": "^0.1.0",
     "@types/node": "^25.9.2",
     "typescript": "5.9.2",
     "viem": "2.52.2",
@@ -78,8 +79,5 @@
   "bin": {
     "jev": "bin/jev.mjs",
     "taifoon-jev": "bin/jev.mjs"
-  },
-  "dependencies": {
-    "@taifoon/jev-wilson": "^0.1.0"
   }
 }