Gridz

FAQ

Common questions about claiming, publishing, and verifying profiles on gridz.bio. For full guides see Docs; for the normative spec see Specification.

What is Gridz?

Gridz is an open framework for cryptographically-attested profiles. Your identity lives at you.gridz.eth on Base; your public page lives at you.gridz.bio. Every field (name, bio, links, widgets) is signed by your wallet, so anyone can verify it came from you — not from a platform database.

Do I need ETH to claim a profile?

No ETH is required for standard claims. You connect your wallet and sign with EIP-712; gridz.bio covers registrar gas on Base when you publish. You never send a transaction yourself for a normal claim flow.

What is the difference between gridz.eth and gridz.bio?

They name the same profile. kevin.gridz.eth is your on-chain ENS identity, resolved via GridzResolver on Base. kevin.gridz.bio is the same data as a normal website URL for sharing. The JSON API at /api/profile/kevin.gridz.eth returns the same Grid for apps and bots.

What is draft vs on-chain?

Draft edits are saved in your browser only (localStorage). No wallet prompts; other people and the API cannot see them. On-chain means you signed and published — EAS attestations on Base linked via GridzResolver. Then your profile is public everywhere. See Using gridz.bio.

I published but it still says Draft — what do I do?

Uploading an avatar or clicking Save draft does not publish — you must click Sign & publish to ENS (or Sign & claim) and approve the wallet signature(s). If publish succeeded, the badge should switch to On-chain after a moment. If you still see Draft:

  • Check for a red error under the publish button — common fixes: switch wallet to Base, retry publish.
  • Confirm the success message listed on-chain writes (not "nothing new reached the chain").
  • Hard-refresh the page, or open your profile in a private window to confirm it is public via the JSON API.
  • Use the same browser where you published — drafts are per-browser only.

Does Gridz hold my private key?

No. You sign in the browser with your own wallet (or via 1Claw HSM for agents). The gridz.bio registrar submits its own transactions to link your already-signed attestations — it cannot impersonate you or sign on your behalf.

What does the verified badge mean?

When every on-chain cell passes cryptographic verification (hashes, signatures, and EAS cross-checks), the profile header shows ✓ Verified. Use the toolbar Verify profile button for a per-field breakdown. See Verification.

Can I use Gridz without gridz.bio?

Yes. Gridz is an open spec and toolkit — TypeScript, Python, CLI, MCP, and sink adapters for Postgres, SQLite, Neo4j, S3, and more. gridz.bio is one projection of a signed Grid, not the only output. See Sinks & projections and Toolkit.

How do AI agents use Gridz?

Agents read profiles via GET /api/profile/…, verify offline with @gridz/core, and can publish via MCP or 1Claw HSM signing. Start at For AI or llms.txt.

Can I change my alias after claiming?

Your ENS subname (alias.gridz.eth) is fixed at claim time. You can edit any field on your profile — bio, links, widgets — by publishing updated signed cells. To use a different alias, claim a new name if it is available.

Where do I get help?