@jinn-network/client 0.1.2 → 0.1.3-canary.24b69ea4

package/dist/erc8004/abis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abis.js","sourceRoot":"","sources":["../../src/erc8004/abis.ts"],"names":[],"mappings":"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"}

package/dist/erc8004/addresses.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Canonical ERC-8004 registry addresses, keyed by chainId.
+ *
+ * Single source of truth for the three deployed registries Jinn touches:
+ *
+ *   - IdentityRegistry  — minted operator agent NFTs + per-execution `setMetadata`.
+ *   - ReputationRegistry — evaluator → harness feedback (DR §4.3).
+ *   - ValidationRegistry — Phase 1b challenge mechanism (DR §4.4).
+ *
+ * Cross-checked against `subgraph/networks.json` and the canonical
+ * `erc-8004/erc-8004-contracts` reference. Mainnets and their respective
+ * testnets share vanity prefixes (0x8004…); the chains 1/8453 vs 11155111/84532
+ * pair accordingly.
+ *
+ * IdentityRegistry addresses live alongside the staking contract config in
+ * `client/src/earning/contracts.ts` (since the bootstrap reads them at mint
+ * time); we duplicate the lookup here for the consolidated ERC-8004 surface.
+ *
+ * If you add a chain, update all three maps + `subgraph/networks.json`.
+ */
+import type { Address } from 'viem';
+/**
+ * Canonical 0x8004… ReputationRegistry deployments.
+ */
+export declare const REPUTATION_REGISTRY_ADDRESSES: Record<number, Address>;
+/**
+ * Resolve the ReputationRegistry address for a chainId, or `null` if the
+ * chain is not known.
+ */
+export declare function getReputationRegistryAddress(chainId: number): Address | null;
+/**
+ * Canonical 0x8004… ValidationRegistry deployments. Source of truth:
+ * `subgraph/networks.json` (populated by `jinn-mono-fud`).
+ */
+export declare const VALIDATION_REGISTRY_ADDRESSES: Record<number, Address>;
+/**
+ * Resolve the ValidationRegistry address for a chainId, or `null` if the
+ * chain is not known.
+ */
+export declare function getValidationRegistryAddress(chainId: number): Address | null;

package/dist/erc8004/addresses.js

@@ -0,0 +1,64 @@
+/**
+ * Canonical ERC-8004 registry addresses, keyed by chainId.
+ *
+ * Single source of truth for the three deployed registries Jinn touches:
+ *
+ *   - IdentityRegistry  — minted operator agent NFTs + per-execution `setMetadata`.
+ *   - ReputationRegistry — evaluator → harness feedback (DR §4.3).
+ *   - ValidationRegistry — Phase 1b challenge mechanism (DR §4.4).
+ *
+ * Cross-checked against `subgraph/networks.json` and the canonical
+ * `erc-8004/erc-8004-contracts` reference. Mainnets and their respective
+ * testnets share vanity prefixes (0x8004…); the chains 1/8453 vs 11155111/84532
+ * pair accordingly.
+ *
+ * IdentityRegistry addresses live alongside the staking contract config in
+ * `client/src/earning/contracts.ts` (since the bootstrap reads them at mint
+ * time); we duplicate the lookup here for the consolidated ERC-8004 surface.
+ *
+ * If you add a chain, update all three maps + `subgraph/networks.json`.
+ */
+// ── ReputationRegistry ────────────────────────────────────────────────────────
+/**
+ * Canonical 0x8004… ReputationRegistry deployments.
+ */
+export const REPUTATION_REGISTRY_ADDRESSES = {
+    // Base mainnet
+    8453: '0x8004BAa17C55a88189AE136b182e5fdA19dE9b63',
+    // Base Sepolia
+    84532: '0x8004B663056A597Dffe9eCcC1965A193B7388713',
+    // Ethereum mainnet (shares Base mainnet vanity)
+    1: '0x8004BAa17C55a88189AE136b182e5fdA19dE9b63',
+    // Ethereum Sepolia (shares Base Sepolia vanity)
+    11155111: '0x8004B663056A597Dffe9eCcC1965A193B7388713',
+};
+/**
+ * Resolve the ReputationRegistry address for a chainId, or `null` if the
+ * chain is not known.
+ */
+export function getReputationRegistryAddress(chainId) {
+    return REPUTATION_REGISTRY_ADDRESSES[chainId] ?? null;
+}
+// ── ValidationRegistry ────────────────────────────────────────────────────────
+/**
+ * Canonical 0x8004… ValidationRegistry deployments. Source of truth:
+ * `subgraph/networks.json` (populated by `jinn-mono-fud`).
+ */
+export const VALIDATION_REGISTRY_ADDRESSES = {
+    // Base mainnet
+    8453: '0x8004Cc8439f36fd5F9F049D9fF86523Df6dAAB58',
+    // Base Sepolia
+    84532: '0x8004Cb1BF31DAf7788923b405b754f57acEB4272',
+    // Ethereum mainnet (shares Base mainnet vanity)
+    1: '0x8004Cc8439f36fd5F9F049D9fF86523Df6dAAB58',
+    // Sepolia (shares Base Sepolia vanity)
+    11155111: '0x8004Cb1BF31DAf7788923b405b754f57acEB4272',
+};
+/**
+ * Resolve the ValidationRegistry address for a chainId, or `null` if the
+ * chain is not known.
+ */
+export function getValidationRegistryAddress(chainId) {
+    return VALIDATION_REGISTRY_ADDRESSES[chainId] ?? null;
+}
+//# sourceMappingURL=addresses.js.map

package/dist/erc8004/addresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.js","sourceRoot":"","sources":["../../src/erc8004/addresses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,iFAAiF;AAEjF;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAA4B;IACpE,eAAe;IACf,IAAI,EAAE,4CAA4C;IAClD,eAAe;IACf,KAAK,EAAE,4CAA4C;IACnD,gDAAgD;IAChD,CAAC,EAAE,4CAA4C;IAC/C,gDAAgD;IAChD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAe;IAC1D,OAAO,6BAA6B,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;AACxD,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAA4B;IACpE,eAAe;IACf,IAAI,EAAE,4CAA4C;IAClD,eAAe;IACf,KAAK,EAAE,4CAA4C;IACnD,gDAAgD;IAChD,CAAC,EAAE,4CAA4C;IAC/C,uCAAuC;IACvC,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAe;IAC1D,OAAO,6BAA6B,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;AACxD,CAAC"}

package/dist/erc8004/identity.d.ts

@@ -0,0 +1,273 @@
+/**
+ * ERC-8004 IdentityRegistry surface.
+ *
+ * Two complementary capabilities live here:
+ *
+ *   1. `IdentityPublisher` — per-execution `setMetadata` writes that anchor
+ *      envelope/evaluation commitments under the operator's agent NFT. Implements
+ *      the v1 ABI-encoded payload tuple specified in
+ *      `docs/superpowers/specs/2026-04-27-erc-8004-payload-schema.md` §3.1:
+ *
+ *        abi.encode(
+ *            uint8   version,             // = 1
+ *            uint8   tier,                // 0..4
+ *            bytes32 manifestHash,        // = JinnRouter evidenceHash
+ *            bytes   attestationQuoteCid, // raw multibase-decoded CID bytes; 0x for tier < 3
+ *            bytes32 sourceMeasurement    // 0x00...00 for tier < 3
+ *        )
+ *
+ *      The encoded payload is passed to
+ *          IdentityRegistry.setMetadata(agentId, "<kind>:<cid>", payload)
+ *
+ *      per the entity-model decision in §4.2 of
+ *      `docs/superpowers/specs/2026-04-27-erc-8004-entity-model-design.md` —
+ *      one operator agent NFT per Safe; per-execution commitments anchor under it.
+ *
+ *      This module ONLY publishes — it does not mint the agent NFT (`jinn-mono-j07`),
+ *      call `setAgentWallet` (`jinn-mono-aev`), or write reputation/validation
+ *      registries (`jinn-mono-2ff` / `jinn-mono-9jg`).
+ *
+ *   2. `resolveAgentIdForManifest` — evaluator-side lookup of the harness's
+ *      `agentId` from a manifest's `evidenceHash`. Per DR §4.3, the evaluator
+ *      must call `ReputationRegistry.giveFeedback(harnessAgentId, ...)` keyed
+ *      on the harness's ERC-8004 agent NFT id — but the on-chain `claimDelivery`
+ *      payload only carries the `requestId` and `evidenceHash`, not the
+ *      harness's agentId.
+ *
+ *      Resolution paths:
+ *
+ *        (b) Subgraph: `Execution { operator { agentId } where manifestHash: $h }`
+ *            — the Jinn subgraph already indexes envelope publishes joined to the
+ *            operator. This is the recommended path: O(1) and aligned with the
+ *            rest of the discovery surface.
+ *        (c) On-chain `IdentityRegistry.Registered` event scan filtered by the
+ *            harness's Safe address — cheaper than a global scan, but still O(n)
+ *            in registered-events. Documented as a fallback only.
+ *
+ *      This module implements (b). The fallback is intentionally **not** wired in
+ *      yet: the resolver returns `null` cleanly when the subgraph URL is undefined
+ *      or the query has no match, and the caller (the feedback hook) treats that
+ *      as a no-op (DR §4.3: "skip but don't fail — claimDelivery is authoritative").
+ */
+import { type Hex, type PublicClient, type WalletClient } from 'viem';
+import { IDENTITY_REGISTRY_SET_METADATA_ABI, PAYLOAD_TUPLE, PAYLOAD_TUPLE_V2 } from './abis.js';
+export { IDENTITY_REGISTRY_SET_METADATA_ABI, PAYLOAD_TUPLE, PAYLOAD_TUPLE_V2 };
+/**
+ * Evidence tier on the canonical ladder.
+ *
+ * V1 admits only `{0=self-signed, 1=committed, 3=attested}` — aligned with
+ * `EvidenceTierSchema` in `client/src/types/envelope.ts` (PR #37 commit
+ * 44cc949b stripped V2+ tiers `consensus`=2 and `proved`=4 from V1). The
+ * gap at 2 and the absent 4 are intentional: future schema-version bumps
+ * re-admit them. See payload-schema §5.
+ */
+export type ExecutionTier = 0 | 1 | 3;
+/** Metadata key prefix. See payload-schema §6.1. */
+export type ContentKind = 'envelope' | 'evaluation' | 'capture';
+/**
+ * v1 payload as caller-friendly hex strings. The encoder validates and
+ * ABI-encodes per §3.1. `version` is fixed at 1 — this is the only schema
+ * version this module emits.
+ */
+export interface ExecutionPayload {
+    version: 1;
+    tier: ExecutionTier;
+    /** 32-byte hex (= JinnRouter evidenceHash). */
+    manifestHash: Hex;
+    /** Raw multibase-decoded CID bytes hex. `"0x"` for tier < 3. */
+    attestationQuoteCid: Hex;
+    /** 32-byte hex enclave measurement. All-zero for tier < 3. */
+    sourceMeasurement: Hex;
+}
+export interface IdentityPublisherConfig {
+    identityRegistryAddress: `0x${string}`;
+    agentId: bigint;
+    walletClient: WalletClient;
+    publicClient: PublicClient;
+}
+export interface PublishContentArgs {
+    kind: ContentKind;
+    /** Textual CID embedded in the metadataKey (`<kind>:<cid>`). */
+    cid: string;
+    payload: ExecutionPayload;
+}
+export interface PublishContentV2Args {
+    kind: ContentKind;
+    /** Textual CID embedded in the metadataKey (`<kind>:<cid>`). */
+    cid: string;
+    payload: ExecutionPayloadV2;
+}
+/** Thrown when an `ExecutionPayload` violates §5 strict-mode validity rules. */
+export declare class PayloadValidationError extends Error {
+    readonly tier: ExecutionTier;
+    readonly reason: string;
+    constructor(tier: ExecutionTier, reason: string);
+}
+/**
+ * Validate `payload` against the strict-mode per-tier rules in payload-schema §5.
+ * Throws `PayloadValidationError` on mismatch; otherwise returns the payload.
+ *
+ * Rules:
+ *   - V1 admits only tiers {0=self-signed, 1=committed, 3=attested}. Tiers 2
+ *     (consensus) and 4 (proved) are V2+ and rejected here.
+ *   - tier ∈ {0,1}: attestationQuoteCid MUST be empty, sourceMeasurement MUST be zero.
+ *   - tier === 3:  attestationQuoteCid MUST be non-empty, sourceMeasurement MUST be non-zero.
+ *   - version MUST equal 1 (this module only emits v1).
+ */
+export declare function validatePayload(payload: ExecutionPayload): ExecutionPayload;
+/**
+ * ABI-encode the v1 payload per payload-schema §3.1.
+ *
+ * Validates first; throws `PayloadValidationError` on mismatch. Never silently
+ * produces malformed bytes.
+ */
+export declare function encodeExecutionPayload(payload: ExecutionPayload): Hex;
+/** Mode flag: 0 = train, 1 = frozen. */
+export type ExecutionModeFlag = 0 | 1;
+/**
+ * v2 payload as caller-friendly hex strings + plain TS values.
+ *
+ * - `codeDigest` is the 32-byte raw bytes of the executor's implStateDir hash
+ *   (NOT the textual `sha256:` prefix). All-zero is the legitimate "no digest"
+ *   value used by callers that opt into v2 but don't yet produce harness
+ *   identity (e.g. setMetadata callers without a fence-attached run).
+ * - `implName` is the harness implementation name, e.g. "claude-code-learner".
+ *   Empty string is permitted as the "no harness identity" value.
+ * - `modeFlag` is 0 (train) or 1 (frozen).
+ */
+export interface ExecutionPayloadV2 {
+    version: 2;
+    tier: ExecutionTier;
+    /** 32-byte hex (= JinnRouter evidenceHash). */
+    manifestHash: Hex;
+    /** Raw multibase-decoded CID bytes hex. `"0x"` for tier < 3. */
+    attestationQuoteCid: Hex;
+    /** 32-byte hex enclave measurement. All-zero for tier < 3. */
+    sourceMeasurement: Hex;
+    /**
+     * 32-byte raw codeDigest hex. Strip the `sha256:` prefix from
+     * `executor.codeDigest` and hex-decode before constructing this field.
+     * All-zero when no digest is available.
+     */
+    codeDigest: Hex;
+    /** Harness implementation name. Empty string when no harness identity. */
+    implName: string;
+    /** 0 = train, 1 = frozen. See HarnessExecutionMode. */
+    modeFlag: ExecutionModeFlag;
+}
+/** Convert a textual `sha256:<hex>` codeDigest to the 32-byte raw hex form. */
+export declare function codeDigestSha256ToBytes32(textual: string | null | undefined): Hex;
+/** Convert a HarnessExecutionMode string to the v2 numeric flag. */
+export declare function modeStringToFlag(mode: 'train' | 'frozen'): ExecutionModeFlag;
+/**
+ * Validate `payload` against v2 strict-mode rules.
+ *
+ * Same per-tier rules as v1 (admit only {0,1,3}; tier ≥ 3 requires non-empty
+ * quote + non-zero measurement). Adds modeFlag ∈ {0,1} and 32-byte codeDigest
+ * shape checks. `implName` may be any string including empty.
+ */
+export declare function validatePayloadV2(payload: ExecutionPayloadV2): ExecutionPayloadV2;
+/**
+ * ABI-encode a v2 payload per payload-schema §3.
+ *
+ * Validates first; throws `PayloadValidationError` on mismatch.
+ */
+export declare function encodeExecutionPayloadV2(payload: ExecutionPayloadV2): Hex;
+/** Build the `<kind>:<cid>` metadata key per payload-schema §6.1. */
+export declare function buildMetadataKey(kind: ContentKind, cid: string): string;
+/**
+ * Per-execution `setMetadata` client.
+ *
+ * Stateless beyond config. Each `publishContent()` call validates the payload,
+ * ABI-encodes it, and submits a single `setMetadata(agentId, key, value)`
+ * transaction. Returns the on-chain tx hash. Failures are surfaced to the
+ * caller — the engine catches and logs them as non-fatal.
+ */
+export declare class IdentityPublisher {
+    private readonly identityRegistryAddress;
+    private readonly agentId;
+    private readonly walletClient;
+    private readonly publicClient;
+    constructor(config: IdentityPublisherConfig);
+    /** The agentId this publisher anchors metadata under. */
+    get agent(): bigint;
+    /** The IdentityRegistry contract this publisher writes to. */
+    get registry(): `0x${string}`;
+    /**
+     * Publish a per-execution commitment under the operator's agent NFT.
+     *
+     * Calls `IdentityRegistry.setMetadata(agentId, "<kind>:<cid>", encode(payload))`.
+     * Returns the on-chain tx hash. Throws on encode/validation/network failure.
+     */
+    publishContent(args: PublishContentArgs): Promise<Hex>;
+    /**
+     * Publish a per-execution commitment using the v2 payload tuple.
+     *
+     * Identical write path to `publishContent` — the only difference is the
+     * encoder. Use this when the caller has `codeDigest`, `implName`, and
+     * `mode` in hand and wants the subgraph to index harness identity directly
+     * from the on-chain bytes.
+     *
+     * Legacy callers without harness identity should keep using `publishContent`
+     * (v1) — the subgraph decoder handles both versions and treats v1 as
+     * `mode='train'` with empty `codeDigest`/`implName`.
+     */
+    publishContentV2(args: PublishContentV2Args): Promise<Hex>;
+    private _writeMetadata;
+}
+/**
+ * Inputs for `resolveAgentIdForManifest`.
+ *
+ * `manifestHash` is the keccak256 of the harness's signed manifest — i.e.
+ * the `evidenceHash` JinnRouter records on `claimDelivery`. The subgraph
+ * indexes this as `Execution.manifestHash` (see `subgraph/schema.graphql`
+ * § Execution).
+ *
+ * `subgraphUrl` is optional: when undefined, the resolver returns `null`
+ * without attempting the query. This lets the call site stay terse —
+ * `await resolveAgentIdForManifest({ manifestHash, subgraphUrl: cfg.subgraphUrl })`
+ * — without conditional plumbing.
+ */
+export interface ResolveAgentIdArgs {
+    manifestHash: `0x${string}`;
+    /** GraphQL endpoint URL. When undefined, returns null without querying. */
+    subgraphUrl?: string;
+    /**
+     * Optional override for `fetch`. Production passes nothing (uses global
+     * `fetch`); tests pass a stub that captures the GraphQL query/variables.
+     */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Resolved record for a manifest hash. The agentId is the primary signal
+ * the feedback hook needs; the optional `manifestCid` is a convenience —
+ * the subgraph already knows it from indexing the operator's envelope
+ * publish, so returning it here saves the caller from re-deriving it.
+ */
+export interface ResolvedAgent {
+    agentId: bigint;
+    /**
+     * The manifest CID indexed alongside this manifestHash, when the
+     * subgraph has it. Useful for the feedback `manifestRef` body without
+     * a second round-trip.
+     */
+    manifestCid: string | null;
+}
+/**
+ * Resolve the operator `agentId` for a given manifest hash.
+ *
+ * Returns `null` when:
+ *   - `subgraphUrl` is undefined (no on-chain fallback wired yet — see
+ *     module-level comment).
+ *   - The subgraph has no `Execution` indexed for this `manifestHash` (the
+ *     harness hasn't published an envelope yet, or the subgraph is behind
+ *     head).
+ *   - The query fails or returns malformed data. This is intentional: a
+ *     transient subgraph failure must NOT block the evaluator's
+ *     `claimDelivery` settlement, so the resolver fails closed (no
+ *     feedback) rather than throwing.
+ *
+ * Errors are logged via `console.warn` so a flaky subgraph surface is
+ * observable without rerouting through the engine's logger.
+ */
+export declare function resolveAgentIdForManifest(args: ResolveAgentIdArgs): Promise<ResolvedAgent | null>;