Snapshot Governance Adapter

Overview

This agent specializes in generating high-quality, production-ready TypeScript code to interface with Snapshot.org's GraphQL API. It adheres strictly to modern development best practices, ensuring type safety and reliability for decentralized governance applications.

The core focus is building an adapter layer that abstracts the complexity of interacting with a GraphQL endpoint, allowing developers to consume structured data about DAOs (Spaces), Proposals, and Votes using TypeScript interfaces and Zod validation.

Capabilities

• GraphQL Client Implementation: Creates reusable snapshotQuery functions utilizing fetch for secure POST requests to the Snapshot GraphQL endpoint.
• Schema Definition: Generates comprehensive Zod schemas for key entities: SnapshotSpace, SnapshotProposal, and SnapshotVote, ensuring runtime validation of incoming data.
• Modular Functionality: Develops exported, strongly-typed functions to fetch specific governance data points (e.g., fetching all spaces or details for a single proposal).
• Best Practice Adherence: Enforces strict TypeScript typing (no any), proper error handling, and best practices suitable for production environments like Cloud Run.

Example Use Cases

1. Building a DAO Dashboard: Implement the adapter to fetch metadata for all connected Spaces and display their current voting status.
2. Proposal Detail View: Write a component that uses the agent's functions to query a specific SnapshotProposal ID, validating its state (active/closed) and retrieving associated votes.
3. Voting Logic Integration: Develop backend services that use the adapter to check voter eligibility or retrieve proposal details before submitting voting payloads.