An open, multi-modal framework for cryptographically-attested social graphs that work for humans, AI agents, and organizations.
A Grid is a profile built from typed, signed fields ("cells"), each carrying a verifiable attestation chain. A consumer with only (grid_id, public_key, attestation) can prove who said what, when, and under which key — no sink, server, or vault required.
All 15 BRIEF §16 steps complete. ~270 tests across TypeScript, Python, and Foundry — all green. Spec-first, tests-first, no mock data.
| Area | State |
|---|---|
Specs (specs/) |
✅ Grid model, attestation envelope, key registry, EIP-712 types, canonicalization, OpenAPI 3.1 |
@gridz/core + Python gridz |
✅ JCS, EIP-712, merkle, signers, verifier — cross-runtime byte-identical signatures |
@gridz/sinks + Python gridz_sinks |
✅ Sink interface, Memory + ENS + SQLite (real) + Postgres/MySQL/Mongo/Redis/Neo4j/S3 (docker-gated); SNS preview |
@gridz/server |
✅ Fastify + OpenAPI 3.1, attestation-validated writes, no key custody |
@gridz/sdk + Python client |
✅ typed clients; cross-language integration (Python-signed grid round-trips the TS server) |
@gridz/cli |
✅ init/validate/build/verify/publish + bootstrap templates (shape only) |
@gridz/mcp + Python gridz_mcp |
✅ FastMCP servers; no server-side signing |
@gridz/react / vue / svelte / element |
✅ renderers with verification badges |
@gridz/oneclaw + Python gridz_oneclaw |
✅ optional 1claw HSM adapter |
contracts/ |
✅ GridzResolver.sol — ENSIP-10 wildcard over EAS, 100% coverage |
examples/, docs/ |
✅ minimal-cli, oneclaw-quickstart, next-app, scaffold-agent-grid; Vocs docs |
This is the superproject. The component repos are git submodules under the Gridz-Protocol org:
| Path (submodule) | Repo | Contents |
|---|---|---|
packages/ |
gridz-js | @gridz/* TypeScript packages |
python/ |
gridz-py | Python packages |
contracts/ |
gridz-contracts | Foundry resolver (forge-std is itself a submodule) |
docs/ |
gridz-docs | Vocs site |
examples/ |
gridz-examples | example apps |
The superproject keeps the shared sources: specs/ (the source of truth),
tests/cross-runtime/, templates/, root config, and governance. Develop here —
the packages share the superproject's specs, fixtures, and base tsconfig.
git clone --recurse-submodules https://github.com/Gridz-Protocol/gridz.git
cd gridz
pnpm install
pnpm -w run check # lint + typecheck + test + build across all packages
pnpm -w run check:nomock # no-mock-data guardAlready cloned without submodules? git submodule update --init --recursive.
gridz.bio publishes on Base mainnet (chain 8453). Contract addresses:
specs/deployments.md.
pnpm install
pnpm -w run check # turbo: lint + typecheck + test + build- Spec first — the schemas in
specs/are the product; SDKs are written against them. - No bespoke crypto — EIP-712 / EAS, JWS, COSE, audited libraries only.
- No custodied keys — bring your own signer (local wallet, passkey, or 1claw HSM).
- Sinks are projections, not sources of truth — the signed attestation is authoritative.
- No mock data — fixtures are deterministic and seed-derived; see
DESIGN_NOTES.md.
Licensed under MIT.