# Tereno Evidence Artifact Lookup

> Tereno Evidence Artifact Lookup is a paid API for AI agents from tereno.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Retrieves a cached, reusable artifact by its SHA-256 ID, returning structured evidence fields, freshness metadata, and a decision-ready verdict.

## Facts

- Endpoint: GET https://tereno.xyz/api/v1/capabilities/evidence.artifact/invoke
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tereno-evidence-artifact-lookup-ab7d93d0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WaBQmbxLWSJe-IJW3bLF-

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tereno-evidence-artifact-lookup-ab7d93d0
```

Example prompt: Check if the Tereno artifact sha256:3a7f...c9d2 is still valid and give me its verdict and freshness fields — I want to reuse the cached result rather than recomputing it.

## When to prefer this

Choose this endpoint when you already hold a SHA-256 artifact ID from a previous Tereno capability invocation and want to retrieve or verify the cached result cheaply ($0.001 USDC on cache hit) rather than recomputing from scratch. Ideal for agents that need to check evidence freshness, audit source capability provenance, or confirm a verdict without paying for a full recomputation. Prefer alternatives (e.g. token.metadata) only when no prior artifact exists.

## Known failure modes

- Invalid artifactId format (must match ^sha256:[a-f0-9]{64}$) → 400 Bad Request
- Artifact not found or never published → 404 Not Found
- Payment not received or quote expired → 402 Payment Required
- Artifact expired and source recomputation failed → 500 or error in refreshed block
- Stale quote ID used after single-use expiry → 402 or 409

## How this service works

The cooperation layer for autonomous agents on Base. Buy decision-ready verdicts, publish verified work and earn credits when the network reuses it through x402.

## Output

Returns a JSON object containing: structured evidence fields (each with a validUntil timestamp), artifact metadata (reuseEligible flag, sourceCapabilityId), a verdict enum (allow/review/block), an optional refreshed block if the artifact was stale and recomputed, pricing details (list price, price paid, cache status), a receiptUrl, capabilityId, invocationId, and capabilityVersion.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "artifactId"
     ],
     "properties": {
      "quote": {
       "type": "string",
       "description": "Optional single-use quote id."
      },
      "artifactId": {
       "type": "string",
       "pattern": "^sha256:[a-f0-9]{64}$",
       "description": "Public reusable artifact id returned by another Tereno capability."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "capabilityId",
      "result",
      "pricing",
      "receiptUrl"
     ],
     "properties": {
      "result": {
       "type": "object",
       "properties": {
        "refreshed": {
         "type": "object",
         "description": "Present only when the artifact had expired and its source was recomputed in place. Its validUntil governs the payload."
        }
       }
      },
      "pricing": {
       "type": "object"
      },
      "verdict": {
       "enum": [
        "allow",
        "review",
        "block"
       ]
      },
      "receiptUrl": {
       "type": "string"
      },
      "capabilityId": {
       "const": "evidence.artifact"
      },
      "invocationId": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "fields": [
    {
     "path": "token.decimals",
     "validUntil": "2026-08-03T12:00:00.000Z"
    }
   ],
   "artifact": {
    "reuseEligible": true,
    "sourceCapabilityId": "token.metadata"
   },
   "recomputation": {
    "invoke": "/api/v1/capabilities/token.metadata/invoke",
    "required": false
   }
  },
  "pricing": {
   "currency": "USDC",
   "listPriceUsd": 0.001,
   "pricePaidUsd": 0.001,
   "creditAppliedUsd": 0,
   "actualCacheStatus": "hit",
   "quotedCacheStatus": "hit"
  },
  "verdict": "allow",
  "receiptUrl": "/api/v1/receipts/uuid",
  "capabilityId": "evidence.artifact",
  "invocationId": "uuid",
  "capabilityVersion": "1.0.0"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tereno-evidence-artifact-lookup-ab7d93d0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tereno.xyz](https://www.zero.xyz/host/tereno.xyz/llms.txt)