@jinn-network/client 0.1.1 → 0.1.2-canary.66834251

package/dist/restorer/impls/prediction-v0-evaluator/index.js

@@ -0,0 +1,222 @@
+/**
+ * prediction-v0-evaluator — deterministic verifier for prediction.v0.
+ *
+ * §6 of spec/2026-04-20-prediction-v0-pis-phase-1-design.md
+ *
+ * Pipeline: availability → eligibility → integrity → spec → verdict.
+ * Score: brier.v1 scaled to 1e18 fixed-point.
+ */
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createPublicClient, http, keccak256, stringToHex } from 'viem';
+import { baseSepolia, base } from 'viem/chains';
+import { privateKeyToAccount } from 'viem/accounts';
+import { PredictionV0IntentSchema, PredictionSubmissionManifestSchema, } from '../../../types/prediction.js';
+import { oraclePriceAtResolveTs, scaleToDecimal, } from '../../../venues/chainlink/client.js';
+import { resolveGroundTruth } from './canonical-metrics.js';
+import { computeScore } from './score.js';
+import { checkOracleReachable, checkOracleRoundCoversResolveTs } from './checks/availability.js';
+import { checkSubmissionWithinWindow } from './checks/eligibility.js';
+import { checkWindowBounds, checkManifestFieldsPresent, checkManifestSignature, checkIntentRef, checkIntentRefMissingExpected, recomputeTopLevelSignatureHash, } from './checks/integrity.js';
+import { resolveExpectedRestorationIntentCid } from '../evaluation-context.js';
+import { checkQuestionKindSupported } from './checks/spec.js';
+function parseRestorationSubmissionManifest(manifestJson) {
+    const raw = JSON.parse(manifestJson);
+    const direct = PredictionSubmissionManifestSchema.safeParse(raw);
+    if (direct.success)
+        return direct.data;
+    if (raw['schemaVersion'] !== 'portfolio.v0.manifest.v1') {
+        return PredictionSubmissionManifestSchema.parse(raw);
+    }
+    const gating = raw['gating'];
+    const informational = raw['informational'];
+    const oracleSnapshot = informational?.['oracleSnapshot'];
+    const normalized = {
+        schemaVersion: 'prediction.v0.submission.v1',
+        generatedAt: raw['generatedAt'],
+        intent: raw['intent'],
+        restorer: raw['restorer'],
+        window: raw['window'],
+        prediction: {
+            probability: String(gating?.['probability'] ?? ''),
+            submittedAt: Number(gating?.['submittedAt']),
+            modelId: String(gating?.['modelId'] ?? ''),
+        },
+        ...(oracleSnapshot && typeof oracleSnapshot === 'object'
+            ? { oracleSnapshot }
+            : {}),
+        signature: raw['signature'],
+    };
+    return PredictionSubmissionManifestSchema.parse(normalized);
+}
+export class PredictionV0Evaluator {
+    config;
+    name = 'prediction-v0-evaluator';
+    version = '1.0.0';
+    constructor(config) {
+        this.config = config;
+    }
+    supports(ctx) {
+        return ctx.kind === 'prediction.v0' && ctx.type === 'evaluation';
+    }
+    async canAttempt(intent) {
+        if (intent.spec?.kind !== 'prediction.v0')
+            return { ok: false, reason: 'spec.kind is not prediction.v0' };
+        if (intent.type !== 'evaluation')
+            return { ok: false, reason: 'type is not evaluation' };
+        if (!intent.restorationRequestId)
+            return { ok: false, reason: 'restorationRequestId is required' };
+        if (typeof intent.context?.['restorationResult'] !== 'string') {
+            return { ok: false, reason: 'context.restorationResult required' };
+        }
+        return { ok: true };
+    }
+    async run(ctx) {
+        const { intent, workingDir, log } = ctx;
+        // Support _testDeps injection from ctx (test) or config (constructor).
+        const testDeps = ctx._testDeps ?? this.config._testDeps;
+        const expectedRef = resolveExpectedRestorationIntentCid(intent, testDeps);
+        // 1. Parse intent — same spec the restorer ran under
+        const predictionIntent = PredictionV0IntentSchema.parse(intent);
+        const { feed, venue } = predictionIntent.spec.oracle;
+        // 2. Parse restorer's manifest from inlined context
+        const manifestJson = intent.context['restorationResult'];
+        const rawPayload = JSON.parse(manifestJson);
+        const manifest = parseRestorationSubmissionManifest(manifestJson);
+        // 3. Fetch Chainlink spanning round
+        let spanning;
+        if (testDeps?.oraclePriceAtResolveTs) {
+            spanning = await testDeps.oraclePriceAtResolveTs(feed, predictionIntent.spec.question.resolveTs);
+        }
+        else {
+            const expectedChainId = venue === 'chainlink-base' ? 8453 : 84532;
+            const chain = venue === 'chainlink-base' ? base : baseSepolia;
+            const publicClient = createPublicClient({
+                chain,
+                transport: http(this.config.rpcUrl),
+            });
+            const actualChainId = await publicClient.getChainId();
+            if (actualChainId !== expectedChainId) {
+                throw new Error(`oracle venue mismatch: spec says ${venue} (chainId ${expectedChainId}) but RPC chainId is ${actualChainId}`);
+            }
+            spanning = await oraclePriceAtResolveTs(feed, predictionIntent.spec.question.resolveTs, publicClient);
+        }
+        // 4. Run checks (order matters: availability → eligibility → integrity → spec)
+        const checks = [];
+        // availability — oracle reachable (already fetched above; re-wrap to surface errors)
+        checks.push(await checkOracleReachable(async () => spanning));
+        checks.push(checkOracleRoundCoversResolveTs(spanning));
+        // eligibility
+        checks.push(checkSubmissionWithinWindow(manifest.prediction.submittedAt, predictionIntent.window));
+        // integrity
+        checks.push(checkWindowBounds(predictionIntent));
+        checks.push(checkManifestFieldsPresent(manifest.prediction));
+        {
+            const recomputed = recomputeTopLevelSignatureHash(rawPayload);
+            checks.push(await checkManifestSignature(recomputed, manifest.signature));
+        }
+        if (expectedRef.kind === 'missing') {
+            checks.push(checkIntentRefMissingExpected());
+        }
+        else {
+            checks.push(checkIntentRef(manifest.intent.cid, expectedRef.cid));
+        }
+        // spec
+        checks.push(checkQuestionKindSupported(predictionIntent.spec.question));
+        // 5. Derive verdict
+        const verdict = deriveVerdict(checks);
+        // 6. Derive ground truth + score
+        const priceAtResolve = scaleToDecimal(spanning.round.answer, spanning.round.decimals);
+        const groundTruth = resolveGroundTruth(predictionIntent.spec.question, priceAtResolve);
+        const { score, scoreBasis, scoreVersion } = computeScore(verdict, manifest.prediction.probability, groundTruth);
+        // 7. Assemble + sign verdict manifest
+        const evaluatorAccount = privateKeyToAccount(this.config.evaluatorPk);
+        const verdictManifestBase = {
+            schemaVersion: 'prediction.v0.verdict.v1',
+            generatedAt: Date.now(),
+            intent: manifest.intent,
+            evaluator: { safeAddress: this.config.evaluatorSafeAddress, agentEoa: evaluatorAccount.address },
+            window: predictionIntent.window,
+            verdict,
+            score,
+            scoreBasis,
+            scoreVersion,
+            oracleReading: {
+                feed: feed,
+                roundId: String(spanning.round.roundId),
+                answer: String(spanning.round.answer),
+                updatedAt: spanning.round.updatedAt,
+                ...(spanning.nextRound ? { nextRoundUpdatedAt: spanning.nextRound.updatedAt } : {}),
+            },
+            claimed: {
+                probability: manifest.prediction.probability,
+                submittedAt: manifest.prediction.submittedAt,
+                modelId: manifest.prediction.modelId,
+                // Omitted when no IPFS submission CID is available (inline / dev).
+            },
+            groundTruth,
+            checks,
+        };
+        const canonical = JSON.stringify(verdictManifestBase);
+        const hash = keccak256(stringToHex(canonical));
+        // Raw ECDSA — no EIP-191 prefix. recoverAddress (not recoverMessageAddress) on verify.
+        const sig = await evaluatorAccount.sign({ hash });
+        const verdictManifest = {
+            ...verdictManifestBase,
+            signature: { algo: 'secp256k1', signer: evaluatorAccount.address, hash, sig },
+        };
+        writeFileSync(join(workingDir, 'verdict.json'), JSON.stringify(verdictManifest, null, 2));
+        log({ level: 'info', msg: 'prediction-v0-evaluator: verdict', data: { verdict, score, groundTruth } });
+        return {
+            venueRef: { name: 'chainlink' },
+            gating: {
+                verdict,
+                score,
+                scoreBasis,
+                groundTruth,
+                checkCount: checks.length,
+                passCount: checks.filter(c => c.status === 'PASS').length,
+                failCount: checks.filter(c => c.status === 'FAIL').length,
+                skipCount: checks.filter(c => c.status === 'SKIP').length,
+            },
+            informational: {
+                claimedProbability: manifest.prediction.probability,
+                oracleReading: verdictManifestBase.oracleReading,
+            },
+            artifacts: [
+                {
+                    path: 'verdict.json',
+                    role: 'evaluation_verdict',
+                    metadata: { verdict, score, schemaVersion: 'prediction.v0.verdict.v1' },
+                    access: { kind: 'open' },
+                },
+            ],
+        };
+    }
+}
+/**
+ * Derive verdict from check statuses.
+ * Order matters: data-availability failures precede attempt-quality failures.
+ */
+function deriveVerdict(checks) {
+    // Any availability FAIL → INDETERMINATE (oracle unreachable, data gaps)
+    if (checks.some(c => c.name.startsWith('availability.') && c.status === 'FAIL'))
+        return 'INDETERMINATE';
+    // Any availability SKIP → INDETERMINATE (oracle not yet spanning)
+    if (checks.some(c => c.name.startsWith('availability.') && c.status === 'SKIP'))
+        return 'INDETERMINATE';
+    // Missing trust anchor for intent CID (e.g. legacy eval payload) → INDETERMINATE
+    if (checks.some(c => c.name.startsWith('integrity.') && c.status === 'INDETERMINATE'))
+        return 'INDETERMINATE';
+    // Any eligibility FAIL → REJECTED
+    if (checks.some(c => c.name.startsWith('eligibility.') && c.status === 'FAIL'))
+        return 'REJECTED';
+    // Any integrity or spec FAIL → FAIL
+    if (checks.some(c => c.name.startsWith('integrity.') && c.status === 'FAIL') ||
+        checks.some(c => c.name.startsWith('spec.') && c.status === 'FAIL')) {
+        return 'FAIL';
+    }
+    return 'PASS';
+}
+export default PredictionV0Evaluator;
+//# sourceMappingURL=index.js.map

package/dist/restorer/impls/prediction-v0-evaluator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/restorer/impls/prediction-v0-evaluator/index.ts"],"names":[],"mappings":"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"}

package/dist/restorer/impls/prediction-v0-evaluator/score.d.ts

@@ -0,0 +1,8 @@
+export declare const SCORE_BASIS: "brier.v1";
+export declare const SCORE_VERSION: "1";
+export type Verdict = 'PASS' | 'FAIL' | 'REJECTED' | 'INDETERMINATE';
+export declare function computeScore(verdict: Verdict, probability: string, groundTruth: 'YES' | 'NO'): {
+    score: string;
+    scoreBasis: typeof SCORE_BASIS;
+    scoreVersion: typeof SCORE_VERSION;
+};

package/dist/restorer/impls/prediction-v0-evaluator/score.js

@@ -0,0 +1,15 @@
+import { brierScore } from './canonical-metrics.js';
+export const SCORE_BASIS = 'brier.v1';
+export const SCORE_VERSION = '1';
+export function computeScore(verdict, probability, groundTruth) {
+    if (verdict !== 'PASS') {
+        return { score: '0', scoreBasis: SCORE_BASIS, scoreVersion: SCORE_VERSION };
+    }
+    const outcome = groundTruth === 'YES' ? 1 : 0;
+    return {
+        score: brierScore(probability, outcome),
+        scoreBasis: SCORE_BASIS,
+        scoreVersion: SCORE_VERSION,
+    };
+}
+//# sourceMappingURL=score.js.map

package/dist/restorer/impls/prediction-v0-evaluator/score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../../../../src/restorer/impls/prediction-v0-evaluator/score.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,CAAC,MAAM,WAAW,GAAG,UAAmB,CAAC;AAC/C,MAAM,CAAC,MAAM,aAAa,GAAG,GAAY,CAAC;AAI1C,MAAM,UAAU,YAAY,CAC1B,OAAgB,EAChB,WAAmB,EACnB,WAAyB;IAEzB,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9E,CAAC;IACD,MAAM,OAAO,GAAG,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,OAAO;QACL,KAAK,EAAE,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC;QACvC,UAAU,EAAE,WAAW;QACvB,YAAY,EAAE,aAAa;KAC5B,CAAC;AACJ,CAAC"}

package/dist/restorer/impls/prediction-v0-evaluator/types.d.ts

@@ -0,0 +1,7 @@
+export type CheckStatus = 'PASS' | 'FAIL' | 'SKIP' | 'INDETERMINATE';
+export interface Check {
+    name: string;
+    status: CheckStatus;
+    detail?: string | Record<string, unknown>;
+}
+export type Verdict = 'PASS' | 'FAIL' | 'REJECTED' | 'INDETERMINATE';

package/dist/restorer/impls/prediction-v0-evaluator/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/restorer/impls/prediction-v0-evaluator/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/restorer/impls/prediction-v0-evaluator/types.ts"],"names":[],"mappings":""}

package/dist/restorer/types.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Restorer-impl interface — §6.7 of the portfolio.v0 design spec.
+ *
+ * Pure type definitions; no runtime side effects.
+ */
+import type { DesiredState } from '../types/desired-state.js';
+import type { OutputArtifact, RationaleEntry, Snapshot } from '../types/portfolio.js';
+export interface RestorationContext {
+    intent: DesiredState;
+    /**
+     * IPFS CID of this job's desired state (from Marketplace / observe).
+     * Restorers' submission manifests should reference the same CID; evaluators
+     * compare it via integrity.intent_ref. May be an empty string when
+     * provenance is missing (dev / legacy).
+     */
+    intentCid?: string;
+    /** Persistent directory for impl-specific state. */
+    implStateDir: string;
+    /** Ephemeral working directory (cleared between attempts). */
+    workingDir: string;
+    log: (event: {
+        level: 'info' | 'warn' | 'error';
+        msg: string;
+        data?: unknown;
+    }) => void;
+    /** Fires at window.endTs. */
+    abort: AbortSignal;
+    msUntilEndTs: () => number;
+}
+export interface RestorationOutput {
+    venueRef: {
+        name: string;
+    };
+    /** Optional — evaluator impls that do not operate on a venue leave these undefined. */
+    preSnapshot?: Snapshot;
+    postSnapshot?: Snapshot;
+    fills?: unknown[];
+    /** Shape is per spec.kind convention. */
+    gating: Record<string, unknown>;
+    informational?: Record<string, unknown>;
+    artifacts?: OutputArtifact[];
+    rationale?: RationaleEntry[];
+}
+/**
+ * Context-free readiness probe. "Are this impl's external dependencies
+ * satisfied right now, regardless of any specific intent?" Used by
+ * `jinn intents list|status` and by the claim-policy gate that refuses
+ * to spend gas claiming an intent whose impl cannot execute.
+ */
+export interface ReadyStatus {
+    ready: boolean;
+    reason?: string;
+    /** Optional hint for the operator/agent on how to become ready. */
+    nextStep?: {
+        description: string;
+        cli?: string;
+        url?: string;
+    };
+}
+/**
+ * Argument a kind-specific enable flow wants from the operator, surfaced
+ * via `enableMetadata()`. The generic `jinn intents enable <kind>` verb
+ * parses these from `--key=value` flags without caring what they mean.
+ */
+export interface EnableArgDef {
+    name: string;
+    description: string;
+    required: boolean;
+}
+/**
+ * Metadata that `jinn intents list` uses to teach the operator (or agent)
+ * what's needed to enable a kind. Returned without running the flow.
+ */
+export interface IntentEnableMetadata {
+    /** Human-readable summary of what opting in to this kind entails. */
+    description: string;
+    requiredArgs?: EnableArgDef[];
+    /** External URLs the operator/agent will need (e.g. exchange UI). */
+    externalResources?: Array<{
+        name: string;
+        url: string;
+    }>;
+}
+/**
+ * Outcome of a single `jinn intents enable <kind>` invocation.
+ *
+ * The flow is idempotent: the agent reruns the same command until
+ * `status === 'ready'`. Each intermediate state carries enough info for
+ * the agent to know what to do next (show a URL, collect more args,
+ * surface an error).
+ */
+export type EnableResult = {
+    status: 'ready';
+    /** Anything the impl wants to surface (e.g. master address, wallet address). */
+    details?: Record<string, unknown>;
+} | {
+    status: 'waiting_for_external_action';
+    /** What the operator has to do out-of-band (e.g. approve an api-wallet). */
+    action: {
+        description: string;
+        url?: string;
+    };
+    details?: Record<string, unknown>;
+    /** The exact CLI the agent should re-run once the action is done. */
+    nextInvocation: {
+        cli: string;
+        purpose: string;
+    };
+} | {
+    status: 'missing_args';
+    required: EnableArgDef[];
+    example: {
+        cli: string;
+    };
+} | {
+    status: 'error';
+    message: string;
+    details?: Record<string, unknown>;
+};
+export interface RestorerImpl {
+    name: string;
+    /** semver */
+    version: string;
+    /**
+     * Return true if this impl should handle the given (kind, type) pair.
+     *
+     * `type` reflects DesiredState.type:
+     *   - 'restoration' (or undefined — legacy default): the impl runs a restoration attempt
+     *   - 'evaluation': the impl runs as an evaluator producing a verdict
+     *
+     * A restorer impl for kind=X should return true for type !== 'evaluation'.
+     * An evaluator impl for kind=X should return true for type === 'evaluation'.
+     */
+    supports(ctx: {
+        kind: string;
+        type?: 'restoration' | 'evaluation';
+    }): boolean;
+    canAttempt?(intent: DesiredState): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    run(ctx: RestorationContext): Promise<RestorationOutput>;
+    /**
+     * Context-free readiness probe. Zero-dep impls can omit this (treated
+     * as `{ ready: true }`). Impls with external deps (credentials, files,
+     * exchange approvals) report current readiness plus a `nextStep` hint.
+     */
+    isReady?(): Promise<ReadyStatus>;
+    /**
+     * Describes what `onEnable` wants from the caller. Consumed by
+     * `jinn intents list` so the agent can tell the operator what a
+     * specific kind's enable flow needs without triggering it first.
+     */
+    enableMetadata?(): IntentEnableMetadata;
+    /**
+     * Idempotent enable-state machine. Called by `jinn intents enable <kind>`.
+     *
+     * Contract:
+     *   - Zero-dep impls return `{ status: 'ready' }` on every call.
+     *   - Impls with external deps advance as far as they can without
+     *     blocking, then return a `waiting_for_external_action` envelope
+     *     the agent surfaces to the operator.
+     *   - Subsequent invocations pick up where the previous left off.
+     *   - Calling after already-enabled is a no-op that returns `ready`.
+     *
+     * `args` is the raw `--key=value` map parsed from the CLI. Impls
+     * validate and coerce as needed; missing required args should return
+     * `{ status: 'missing_args', required: [...], example: {...} }`.
+     *
+     * Impls that omit this method cannot be enabled by the generic CLI;
+     * they are either always-on (zero-dep) or require manual config.
+     */
+    onEnable?(args: Record<string, string | undefined>): Promise<EnableResult>;
+    /**
+     * Optional inverse of `onEnable`. Invoked when the operator runs
+     * `jinn intents disable <kind>`. Should NOT destroy unrecoverable
+     * state (generated key material, on-chain registrations); reserve
+     * that for explicit `jinn intents purge` or similar (out of scope
+     * for this interface).
+     */
+    onDisable?(): Promise<void>;
+}

package/dist/restorer/types.js

@@ -0,0 +1,7 @@
+/**
+ * Restorer-impl interface — §6.7 of the portfolio.v0 design spec.
+ *
+ * Pure type definitions; no runtime side effects.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/restorer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/restorer/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/store/store.d.ts

@@ -1,7 +1,51 @@
+import Database from 'better-sqlite3';
+export interface ActivityEventInput {
+    ts: string | null;
+    kind: string;
+    requestId?: string | null;
+    serviceIndex?: number | null;
+    txHash?: string | null;
+    specKind?: string | null;
+    outcome?: string | null;
+    detail?: string | null;
+}
+export interface ActivityEventRow {
+    id: number;
+    ts: string | null;
+    kind: string;
+    requestId: string | null;
+    serviceIndex: number | null;
+    txHash: string | null;
+    specKind: string | null;
+    outcome: string | null;
+    detail: string | null;
+}
+export interface RewardClaimInput {
+    ts: string;
+    serviceIndex: number;
+    serviceId?: number | null;
+    stakingProxy: string;
+    distributor: string;
+    txHash: string;
+    amountWei: string;
+    asset?: string;
+}
+export interface BalanceCacheEntry {
+    role: string;
+    address: string;
+    nativeWei?: string | null;
+    bondWei?: string | null;
+    assetExtraJson?: string | null;
+    fetchedAt: string;
+    error?: string | null;
+}
 export declare class Store {
-    private db;
+    /** Exposed for engine persistence layer — treat as package-internal. */
+    readonly db: Database.Database;
     readonly path: string;
     constructor(dbPath: string);
+    /** Idempotent: older DBs before idx_reward_claims_tx may lack the unique index. */
+    private ensureRewardClaimsTxIndex;
     recordOwnActivity(requestId: string, role: 'created' | 'claimed' | 'delivered' | 'evaluated'): void;
     isOwnActivity(requestId: string): boolean;
     setShutdownState(state: 'clean' | 'running'): void;
@@ -16,6 +60,25 @@ export declare class Store {
         requestId: string;
         role: string;
     }>;
+    recordActivityEvent(event: ActivityEventInput): void;
+    getRecentActivityEvents(limit: number, opts?: {
+        since?: string;
+        cursor?: string;
+    }): ActivityEventRow[];
+    /** Newer events first, then ascending id for `jinn logs --follow` (oldest in batch printed first in caller). */
+    getActivityEventsAfterId(afterId: number, limit: number): ActivityEventRow[];
+    getActivityCountsByKind(): Record<string, number>;
+    getLastEventAtForService(serviceIndex: number): string | null;
+    getActivityCountsForService(serviceIndex: number): Record<string, number>;
+    recordRewardClaim(claim: RewardClaimInput): void;
+    getClaimedRewardsByService(): Record<number, {
+        total: string;
+        lastAt: string;
+        lastTxHash: string;
+    }>;
+    upsertBalanceCache(entry: BalanceCacheEntry): void;
+    getBalanceCache(): BalanceCacheEntry[];
+    private backfillActivityEvents;
     getLastProcessedBlock(): bigint | null;
     setLastProcessedBlock(block: bigint): void;
     insertArtifact(artifact: {