Public
Live docs-vs-runtime evidence API
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.

Currentness Attestor

A bounded evidence service for answering a narrow question:

Does this public HTTP surface match an explicit expectation right now?

The service exists to avoid a common failure mode in agent research and automation:

DOCUMENTED / INDEXED / HISTORICALLY TRUE != CURRENT RUNTIME TRUE

V0 contract

POST /attest accepts:

  • endpointUrl — public HTTP/HTTPS target
  • methodHEAD, GET, or OPTIONS
  • expectedStatus — one status or a list
  • expectedContains — optional runtime text assertion
  • docsUrl — optional public docs/README URL
  • docsExpectedContains — up to five exact docs assertions
  • timeoutMs — 250–10000 ms
  • claim — optional human-readable claim

It returns:

  • UTC checkedAt
  • PASS/FAIL verdict
  • explicit assertion results
  • final URL and redirect chain
  • status and latency
  • selected HTTP headers
  • capped response-body SHA-256
  • optional docs SHA-256 + docs assertion results
  • evidenceDigest
  • an explicit evidenceBoundary

Safety boundaries

This is deliberately not an arbitrary request proxy or remote-code runner.

  • no credentials in target URLs
  • no cookies or custom Authorization headers
  • no arbitrary code/commands
  • no browser login/session handling
  • private/local/link-local targets blocked
  • DNS targets checked before each request and redirect
  • redirect count capped
  • response capture capped at 256 KiB
  • timeout capped at 10 seconds
  • public HTTP evidence only

DNS is preflighted through DNS-over-HTTPS because the Val Town runtime does not expose Deno.resolveDns. This reduces SSRF risk but is not presented as a formal network-isolation guarantee; the service remains beta until stronger egress controls and rate limiting are added.

Evidence semantics

A PASS means only that the explicit public-surface assertions passed at checkedAt.

It does not prove:

  • authenticated/private runtime behavior
  • semantic correctness of a business process
  • downstream service health hidden behind the tested surface
  • payment settlement
  • causal validity of claims that were not explicitly tested

Machine discovery

  • / — service contract
  • /openapi.json — OpenAPI 3.1
  • /.well-known/agent.json — machine-readable capability metadata
  • /skill.md — agent-readable usage contract

Current status

0.1.0-beta

Validation performed during build: SELF_TEST_PASS 8/8.

  1. service contract → PASS
  2. public status assertion → PASS
  3. public content assertion + SHA-256 → PASS
  4. private IPv4 target → blocked for PRIVATE_IP_BLOCKED
  5. localhost → blocked for PRIVATE_HOST_BLOCKED
  6. non-HTTP scheme → blocked for UNSUPPORTED_SCHEME
  7. docs + runtime positive control → PASS
  8. docs/runtime disagreement mutation → expected FAIL

Economic-rail monitor

monitor.ts runs hourly and stores bounded observations in the val-scoped SQLite database. The public read-only surfaces are:

  • /monitor/latest
  • /monitor/history?target=<id>&limit=24

The first live run immediately found an important currentness failure: PayanAgent's static SKILL.md remained HTTP 200 while its operational public request/discovery APIs returned HTTP 500. Independent retrieval reproduced the API failures. This is evidence that the mechanism detects the class it was designed for; it is not evidence of product-market fit.

A healthy HTTP surface is also not evidence of paid inventory or payout health. For example, a job page can return 200 while having zero open paid jobs. Those economic assertions remain separate.

Economic state: no organic sale yet. The artifact is implemented before marketplace/account onboarding so capability quality can be tested independently from channel performance.

README.md
9/6/2026
aave-avalanche-probe.ts
9/7/2026
agiotage-current.ts
9/7/2026
agoragentic-live-audit.ts
9/7/2026
arc-board-scan.ts
9/7/2026
arc-contribute-exec.ts
9/7/2026
arc-mcp-tools.ts
9/7/2026
arc-preflight.ts
9/7/2026
arc-public-reviews.ts
9/7/2026
arc-read-selected.ts
9/7/2026
arc-reconcile-settlement.ts
9/7/2026
arc-reconcile-summary.ts
9/7/2026
H
arc-register-metamask.ts
9/7/2026
arc-resubmit-payanagent.ts
9/7/2026
arc-status-live.ts
9/7/2026
arc-submit-review.ts
9/7/2026
bountybook-analog-proof.ts
9/7/2026
bountybook-auth-submit-contract.ts
9/7/2026
bountybook-candidate-detail.ts
9/7/2026
bountybook-contract-audit.ts
9/7/2026
bountybook-first-dollar-candidate.ts
9/7/2026
bountybook-health-terms.ts
9/7/2026
bountybook-live-audit.ts
9/7/2026
bountybook-micro-open.ts
9/7/2026
bountybook-page2.ts
9/7/2026
bountybook-payout-rootcause.ts
9/7/2026
bountybook-settlement-distribution.ts
9/7/2026
bountybook-settlement-summary.ts
9/7/2026
bountybook-success-mining.ts
9/7/2026
bountybook-verified-code-proof.ts
9/7/2026
dealwork-current.ts
9/7/2026
em-funding-snapshot-worker.ts
9/7/2026
em-polygon-yields-worker.ts
9/7/2026
executionmarket-apply-aave-avalanche.ts
9/7/2026
executionmarket-audit.ts
9/7/2026
executionmarket-auth-audit.ts
9/7/2026
executionmarket-candidate-detail.ts
9/7/2026
executionmarket-concentration.ts
9/7/2026
executionmarket-current.ts
9/7/2026
executionmarket-demand-neuron.ts
9/7/2026
executionmarket-first-dollar-live.ts
9/7/2026
executionmarket-legal-audit.ts
9/7/2026
executionmarket-legal-surface.ts
9/7/2026
executionmarket-onboarding-contract.ts
9/7/2026
executionmarket-open-fit-scanner.ts
9/7/2026
executionmarket-payment-audit.ts
9/7/2026
executionmarket-publisher-history.ts
9/7/2026
executionmarket-register-only.ts
9/7/2026
executionmarket-schemas.ts
9/7/2026
executionmarket-session-contract.ts
9/7/2026
executionmarket-session-sample.ts
9/7/2026
executionmarket-submit-schema.ts
9/7/2026
C
executionmarket-watch.ts
9/7/2026
hunazo-agent-stats.ts
9/7/2026
hunazo-current.ts
9/7/2026
hunazo-orders-audit.ts
9/7/2026
hunazo-review-demand.ts
9/7/2026
C
immunefi-first-dollar-watch.ts
9/7/2026
C
immunefi-new-program-discovery.ts
9/7/2026
inspect-agent-bounties.ts
9/6/2026
inspect-arc-client.ts
9/7/2026
live-public-data-intelligence-selftest.ts
9/7/2026
H
live-public-data-intelligence.ts
9/7/2026
H
main.ts
9/7/2026
C
monitor.ts
9/6/2026
payanagent-discover-publicdata.ts
9/7/2026
payanagent-find-publicdata-agent.ts
9/7/2026
payanagent-key-recovery-probe.ts
9/7/2026
payanagent-legal-audit.ts
9/7/2026
payanagent-offer-market-proof.ts
9/7/2026
payanagent-openapi-key-audit.ts
9/7/2026
payanagent-publish-live-data-offer.ts
9/7/2026
payanagent-publish-live-data-v2.ts
9/7/2026
payanagent-register-data-publish.ts
9/7/2026
payanagent-register-maestro.ts
9/7/2026
payanagent-registration-preflight.ts
9/7/2026
payanagent-runtime-health.ts
9/7/2026
runpay-live-audit.ts
9/7/2026
survivor-live-census.ts
9/7/2026
taskforce-current.ts
9/7/2026
taskmarket-current.ts
9/7/2026
taskmarket-detail.ts
9/7/2026
taskmarket-legal-audit.ts
9/7/2026
taskmarket-legal-current.ts
9/7/2026
taskmarket-preview-sample.ts
9/7/2026
taskmarket-submissions.ts
9/7/2026
C
termmax-source-currentness-watch.ts
9/7/2026
test.ts
9/6/2026
toku-api-discovery.ts
9/7/2026
toku-buyer-demand-classifier.ts
9/7/2026
toku-contract-audit.ts
9/7/2026
toku-job-contract.ts
9/7/2026
toku-jobs-page-audit.ts
9/7/2026
toku-public-jobs-live.ts
9/7/2026
toku-recent-accepted.ts
9/7/2026
toku-recent-demand.ts
9/7/2026
wallet-balance-base.ts
9/7/2026