Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@

## What Nooscape is

Nooscape is a public atlas of AI agents. It reads the public agent registries on **Robinhood Chain, BNB Chain, Solana, Ethereum, Base, Arc and Monad**, keeps what it read together with the date or block it was read at, and shows it as facts. Anyone can look an agent up, see where each fact came from, and decide for themselves.
Nooscape™ is a public atlas of AI agents. It reads the public agent registries on **Robinhood Chain, BNB Chain, Solana, Ethereum, Base, Arc, Monad and Gnosis**, keeps what it read together with the date or block it was read at, and shows it as facts. Anyone can look an agent up, see where each fact came from, and decide for themselves.

It states facts and never a verdict.

Expand All @@ -36,7 +36,7 @@ It states facts and never a verdict.
- **Payment changes nothing.** A key, a payment or a claim never changes a record, a tier or an evidence level.
- **Every answer says when it was read and where from.**

On 6 November 2026 the atlas listed 61,498 agents from the chain registries (Robinhood Chain 21,496, Solana 17,996, Base 9,186, BNB Chain 6,976, Ethereum 5,216, Arc 481, Monad 147), out of many more registrations recorded, and 76 records were reviewed with signed evidence kept. The live figures are on the [home page](https://nooscape.si) and in the [API](https://nooscape.si/api/v1).
On 8 November 2026 the atlas listed 62,759 agents from the chain registries (Robinhood Chain 22,541, Solana 18,084, Base 9,214, BNB Chain 6,980, Ethereum 5,219, Arc 533, Monad 147, Gnosis 41), out of many more registrations recorded, and 302 records were reviewed with signed evidence kept. The live figures are on the [home page](https://nooscape.si) and in the [API](https://nooscape.si/api/v1).

## See it

Expand Down Expand Up @@ -82,14 +82,14 @@ curl -i -X POST https://nooscape.si/api/v1/check \
-d '{"agent":{"chain":"arc","id":"1"}}'
```

Chains are `robinhood`, `bnb`, `solana`, `ethereum`, `base`, `arc` and `monad`. Every answer carries `as_of`, `source` and `license`. Free, Builder and Pro keys raise the limits ([get a key](https://nooscape.si/developers/keys)). The full description is the [OpenAPI document](https://nooscape.si/api/v1/openapi.json), and [`/llms.txt`](https://nooscape.si/llms.txt) is the same API written for a model.
Chains are `robinhood`, `bnb`, `solana`, `ethereum`, `base`, `arc`, `monad` and `gnosis`. Every answer carries `as_of`, `source` and `license`. Free, Builder and Pro keys raise the limits ([get a key](https://nooscape.si/developers/keys)). The full description is the [OpenAPI document](https://nooscape.si/api/v1/openapi.json), and [`/llms.txt`](https://nooscape.si/llms.txt) is the same API written for a model.

## How it works

```mermaid
flowchart LR
subgraph Sources["Public sources"]
A["ERC-8004 registries<br/>Robinhood, BNB, Ethereum, Base, Arc, Monad"]
A["ERC-8004 registries<br/>Robinhood, BNB, Ethereum, Base, Arc, Monad, Gnosis"]
B["Solana agent registries"]
C["A2A cards and catalogs"]
end
Expand Down Expand Up @@ -169,7 +169,7 @@ The root of the repository also holds dated design and research notes. They reco
|---|---|
| [`AGENT_TRUST_TIER_DESIGN.md`](AGENT_TRUST_TIER_DESIGN.md) | The thesis, the dedup pipeline, trust tiers 0 to 3 and the phased build plan |
| [`INGEST_POINTS.md`](INGEST_POINTS.md) | Named ingest sources, their limits and the signals each gives |
| [`SCOPE.md`](SCOPE.md) | The v1 chain scope decided on 7 October 2026. BNB Chain, Base, Ethereum and Monad were added after it. |
| [`SCOPE.md`](SCOPE.md) | The v1 chain scope decided on 7 October 2026. BNB Chain, Base, Ethereum, Monad and Gnosis were added after it. |
| [`ARC_INGEST_RESEARCH.md`](ARC_INGEST_RESEARCH.md) | Arc: first-party evidence, source requirements and priorities |

### Independence
Expand All @@ -192,4 +192,4 @@ The code is released under the [MIT License](LICENSE). The facts and records Noo

## About this repository

This is the public home of Nooscape's source, started from a snapshot taken on 21 October 2026 and refreshed from the private repository's main on 6 November 2026. Earlier history lives in a private archive, so the pull request and commit numbers that the docs and code comments mention (for example "PR 174") refer to that archive, and a few records are withheld from this tree and replaced with a short note.
This is the public home of Nooscape's source, started from a snapshot taken on 21 October 2026 and refreshed from the private repository's main on 8 November 2026. Earlier history lives in a private archive, so the pull request and commit numbers that the docs and code comments mention (for example "PR 174") refer to that archive, and a few records are withheld from this tree and replaced with a short note.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 3 additions & 0 deletions apps/nooscape-relay/client/src/App.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,7 @@ const ArcRegistryReport20261106 = lazy(() => import("./pages/ArcRegistryReport20
const BaseRegistryReport = lazy(() => import("./pages/BaseRegistryReport"));
const EthereumRegistryReport = lazy(() => import("./pages/EthereumRegistryReport"));
const MonadRegistryReport = lazy(() => import("./pages/MonadRegistryReport"));
const GnosisRegistryReport = lazy(() => import("./pages/GnosisRegistryReport"));
const Disputes = lazy(() => import("./pages/Disputes"));
const Privacy = lazy(() => import("./pages/Privacy"));
const Terms = lazy(() => import("./pages/Terms"));
Expand All @@ -60,6 +61,7 @@ function Router() {
{featureOn("chain_base", FEATURES) && <Route path="/chains/base">{() => <ChainExplorer key="base" chain="base" />}</Route>}
{featureOn("chain_ethereum", FEATURES) && <Route path="/chains/ethereum">{() => <ChainExplorer key="ethereum" chain="ethereum" />}</Route>}
{featureOn("chain_monad", FEATURES) && <Route path="/chains/monad">{() => <ChainExplorer key="monad" chain="monad" />}</Route>}
{featureOn("chain_gnosis", FEATURES) && <Route path="/chains/gnosis">{() => <ChainExplorer key="gnosis" chain="gnosis" />}</Route>}
<Route path="/field/bnb-registry-2026-10-16" component={BnbRegistryReport} />
<Route path="/field/bnb-ratings-2026-10-16" component={BnbRatingsReport} />
<Route path="/field/solana-registries-2026-10-18" component={SolanaRegistryReport} />
Expand All @@ -69,6 +71,7 @@ function Router() {
{featureOn("chain_base", FEATURES) && <Route path="/field/base-registry-2026-10-21" component={BaseRegistryReport} />}
{featureOn("chain_ethereum", FEATURES) && <Route path="/field/ethereum-registry-2026-10-28" component={EthereumRegistryReport} />}
{featureOn("chain_monad", FEATURES) && <Route path="/field/monad-registry-2026-11-01" component={MonadRegistryReport} />}
{featureOn("chain_gnosis", FEATURES) && <Route path="/field/gnosis-registry-2026-11-06" component={GnosisRegistryReport} />}
<Route path="/developers" component={DeveloperApi} />
<Route path="/developers/keys" component={DeveloperKeys} />
<Route path="/verify" component={VerifyEvidence} />
Expand Down
157 changes: 157 additions & 0 deletions apps/nooscape-relay/client/src/components/CensusToday.test.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,157 @@
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
import { createElement } from "react";
import { renderToStaticMarkup } from "react-dom/server";
import { beforeEach, describe, expect, it, vi } from "vitest";
import type { CensusToday as Today } from "@shared/censusToday";

/**
* The Today block on a census page: the counts of the page's first table as the directory holds them now, beside the figures the report
* measured and the change between. It asks for one chain's counts in a request of its own, writes what the answer holds and nothing
* else, and fails closed to nothing: a read that has not answered, an answer with no counts, or a page rendered with no query client
* (as the report tests render it) is the report alone.
*/
const mocks = vi.hoisted(() => ({ useQuery: vi.fn() }));
vi.mock("@/lib/trpc", () => ({
trpc: { liveData: { censusToday: { useQuery: (...args: unknown[]) => mocks.useQuery(...args) } } },
ownRequest: { trpc: { context: { ownRequest: true } } },
}));

import { CensusToday } from "./CensusToday";

const FIGURES = [
["Registrations the directory counts on the chain", 10_421],
["Registrations the directory has stored", 4_327],
["Registrations the directory lists", 144],
["Registering wallets", 69],
] as const;

const answer = (overrides: Partial<Today> = {}): { data: { today: Today | null } } => ({
data: {
today: {
chain: "monad",
asOf: "2026-11-07T18:47:03.000Z",
figures: { onChain: 10_500, stored: 4_400, listed: 144, wallets: 71 },
heldOut: { noLink: 5, grouped: 4_200, numericName: 0, pending: 3 },
ratings: null,
...overrides,
},
},
});

const decode = (value: string) => value.replace(/&rsquo;/g, "’").replace(/&#x27;/g, "'").replace(/&amp;/g, "&");
const text = (markup: string) => decode(markup.replace(/<[^>]+>/g, " ")).replace(/\s+/g, " ").trim();
const render = (withClient = true, note?: string) => {
const block = createElement(CensusToday, { chain: "monad", measuredOn: "2026-11-01", figures: FIGURES, note });
return renderToStaticMarkup(withClient ? createElement(QueryClientProvider, { client: new QueryClient() }, block) : block);
};

beforeEach(() => {
mocks.useQuery.mockReset();
});

describe("the Today block", () => {
it("asks for the chain's counts in a request of its own, and not again for a while", () => {
mocks.useQuery.mockReturnValue(answer());

render();

expect(mocks.useQuery).toHaveBeenCalledTimes(1);
expect(mocks.useQuery).toHaveBeenCalledWith(
{ chain: "monad" },
expect.objectContaining({ trpc: { context: { ownRequest: true } }, staleTime: 5 * 60_000, refetchOnWindowFocus: false, retry: false })
);
});

it("shows each line of the page's table with the figure measured, the count today and the change", () => {
mocks.useQuery.mockReturnValue(answer());

const markup = render();

expect(markup).toContain('data-census-today="monad"');
const body = text(markup);
expect(body).toContain("Today");
expect(body).toContain("The report below is a measurement of 2026-11-01 and does not change.");
expect(body).toContain("after the registry pass that finished at 2026-11-07 18:47 UTC");
expect(body).toContain("What was counted 2026-11-01 Today Change");
expect(body).toContain("Registrations the directory counts on the chain 10,421 10,500 +79");
expect(body).toContain("Registrations the directory has stored 4,327 4,400 +73");
expect(body).toContain("Registrations the directory lists 144 144 no change");
expect(body).toContain("Registering wallets 69 71 +2");
});

it("leaves out a line the answer has no count for", () => {
mocks.useQuery.mockReturnValue(answer({ figures: { listed: 150 } }));

const body = text(render());

expect(body).toContain("Registrations the directory lists 144 150 +6");
expect(body).not.toContain("Registering wallets");
expect(body).not.toContain("counts on the chain");
});

it("says what is held out today, for a registry that keeps its registrations in rows, and nothing of the kind for one that does not", () => {
mocks.useQuery.mockReturnValue(answer());
expect(text(render())).toContain(
"Held out of the directory today: 5 with no usable profile link, 4,200 that share a profile link, a host name or a wallet with many others, 0 with a name that is only a number, and 3 not yet sorted."
);

mocks.useQuery.mockReturnValue(answer({ heldOut: null }));
expect(text(render())).not.toContain("Held out of the directory today");
});

it("states the ratings once the count has read the whole history, and not before", () => {
mocks.useQuery.mockReturnValue(answer({ ratings: 9_436 }));
expect(text(render())).toContain("The chain’s reputation registry holds 9,436 ratings, counted from its first block.");

mocks.useQuery.mockReturnValue(answer({ ratings: null }));
expect(text(render())).not.toContain("reputation registry");
});

it("does not say when the pass finished if the source has not finished one", () => {
mocks.useQuery.mockReturnValue(answer({ asOf: null }));

const body = text(render());

expect(body).toContain("taken from the directory as it stands now.");
expect(body).not.toContain("registry pass that finished at");
});

it("says the page's note between the table and the held-out line, and nothing of the kind when the page gives none", () => {
mocks.useQuery.mockReturnValue(answer());

const withNote = render(true, "The way the rows are kept changed on the day the report was measured.");
expect(text(withNote)).toContain("The way the rows are kept changed on the day the report was measured.");
expect(withNote.indexOf("</table>")).toBeLessThan(withNote.indexOf("The way the rows are kept changed"));
expect(withNote.indexOf("The way the rows are kept changed")).toBeLessThan(withNote.indexOf("Held out of the directory today"));

expect(text(render())).not.toContain("The way the rows are kept changed");
});

it("is nothing while the answer has not come, when it holds no counts, and when none of its counts is on the page", () => {
mocks.useQuery.mockReturnValue({ data: undefined });
expect(render()).toBe("");

mocks.useQuery.mockReturnValue({ data: { today: null } });
expect(render()).toBe("");

mocks.useQuery.mockReturnValue(answer({ figures: { profileLinks: 5 } }));
expect(render()).toBe("");
});

it("is nothing, and asks for nothing, with no query client around it", () => {
mocks.useQuery.mockReturnValue(answer());

expect(render(false)).toBe("");
expect(mocks.useQuery).not.toHaveBeenCalled();
});

it("holds counts only: no address, no long dash", () => {
mocks.useQuery.mockReturnValue(answer({ ratings: 9_436 }));

const markup = render();

expect(markup).not.toMatch(/0x[0-9a-fA-F]{6}/);
expect(markup).not.toMatch(/https?:\/\//);
expect(markup).not.toMatch(/[\u2013\u2014]/);
});
});
87 changes: 87 additions & 0 deletions apps/nooscape-relay/client/src/components/CensusToday.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
import { QueryClientContext } from "@tanstack/react-query";
import { useContext } from "react";
import type { CensusChain } from "@shared/censusToday";
import { censusTodayRows, formatAsOf, formatChange, type CensusTodayFigure } from "@/lib/censusTodayModel";
import { ownRequest, trpc } from "@/lib/trpc";
import { headingClass, textClass } from "@/components/InfoPage";

/**
* The part of a registry census page that is not dated: the counts of the page's first table as the directory holds them now, beside
* the figures the report measured, and the change between. The report below it is a measurement of its own date and does not change.
* Counts only; it fails closed to nothing, so a page whose read fails is the report alone. With no query client around it (the tests
* that render a report by itself) it renders nothing, which leaves those pages as they were.
*/
type Props = {
chain: CensusChain;
/** The date the report was measured, as the report writes it. */
measuredOn: string;
/** The counts of the report's first table. */
figures: readonly CensusTodayFigure[];
/** What a reader needs to compare today's counts with the report's, when the way the directory keeps them changed in between. */
note?: string;
};

const cellClass = "border-b border-white/[.08] py-2.5 pr-4 align-top";
const numberClass = "border-b border-white/[.08] py-2.5 pr-4 text-right align-top font-mono tabular-nums text-ns-ink";
const headClass = "border-b border-white/[.16] py-2 pr-4 text-right font-medium";
const firstHeadClass = "border-b border-white/[.16] py-2 pr-4 font-medium";
const tableClass = "w-full border-collapse text-left text-base leading-7 text-ns-ink-dim";
const n = (value: number) => value.toLocaleString("en-US");

export function CensusToday(props: Props) {
const queryClient = useContext(QueryClientContext);
if (!queryClient) return null;
return <CensusTodayBlock {...props} />;
}

function CensusTodayBlock({ chain, measuredOn, figures, note }: Props) {
const query = trpc.liveData.censusToday.useQuery({ chain }, { ...ownRequest, staleTime: 5 * 60_000, refetchOnWindowFocus: false, retry: false });
const today = query.data?.today;
if (!today) return null;
const rows = censusTodayRows(figures, today);
if (rows.length === 0) return null;
const held = today.heldOut;

return (
<section aria-labelledby="census-today" data-census-today={chain}>
<h2 id="census-today" className={headingClass}>Today</h2>
<p className={textClass}>
The report below is a measurement of {measuredOn} and does not change. This table is the same count, taken from the directory as it stands now
{today.asOf ? `, after the registry pass that finished at ${formatAsOf(today.asOf)}` : ""}.
</p>
<div className="mt-4 max-w-prose overflow-x-auto">
<table className={tableClass}>
<caption className="sr-only">The counts of the first table of the report, measured and today</caption>
<thead>
<tr className="text-sm text-ns-ink">
<th scope="col" className={firstHeadClass}>What was counted</th>
<th scope="col" className={headClass}>{measuredOn}</th>
<th scope="col" className={headClass}>Today</th>
<th scope="col" className={headClass}>Change</th>
</tr>
</thead>
<tbody>
{rows.map(row => (
<tr key={row.figure}>
<th scope="row" className={`${cellClass} font-normal text-ns-ink`}>{row.label}</th>
<td className={numberClass}>{n(row.measured)}</td>
<td className={numberClass}>{n(row.today)}</td>
<td className={numberClass}>{formatChange(row.change)}</td>
</tr>
))}
</tbody>
</table>
</div>
{note ? <p className={textClass}>{note}</p> : null}
{held ? (
<p className={textClass}>
Held out of the directory today: {n(held.noLink)} with no usable profile link, {n(held.grouped)} that share a profile link, a host name or a wallet with many others,
{" "}{n(held.numericName)} with a name that is only a number, and {n(held.pending)} not yet sorted.
</p>
) : null}
{today.ratings !== null ? (
<p className={textClass}>The chain&rsquo;s reputation registry holds {n(today.ratings)} ratings, counted from its first block.</p>
) : null}
</section>
);
}
12 changes: 12 additions & 0 deletions apps/nooscape-relay/client/src/components/chain/ChainEventRail.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,18 @@ function EmptyState({
);
}

if (chain === "gnosis" && status === "unsupported") {
return (
<div className="cw-event-empty" role="status">
<span className="cw-event-empty-kicker">Global feed unavailable</span>
<p>
No global Gnosis activity feed is published. No event is shown in
its place.
</p>
</div>
);
}

if (status === "unmeasured") {
return (
<div className="cw-event-empty" role="status">
Expand Down
Loading
Loading