diff --git a/CIP-????/README.md b/CIP-????/README.md new file mode 100644 index 0000000000..2b8605a98f --- /dev/null +++ b/CIP-????/README.md @@ -0,0 +1,207 @@ +--- +CIP: XXXX +Title: On-Chain Surveys and Polls +Category: Metadata +Status: Proposed +Authors: + - Thomas Lindseth +Implementors: [] +Discussions: + - https://github.com/cardano-foundation/CIPs/pull/1107 +Created: 2025-10-28 +License: CC-BY-4.0 +--- + +## Abstract + +This proposal defines a **generic, standardized metadata structure** for creating and responding to on-chain surveys and polls. It uses the **CIP-0068** metadata standard (via the **674** label) to allow any entity to publish a survey in a machine-readable format without requiring governance deposits or formal registration. + +The specification provides a minimal, interoperable format for survey definition and response — enabling wallets, explorers, and dApps across the Cardano ecosystem to reliably create, display, and aggregate poll data. + +Optionally, a survey may **reference a governance action** by transaction ID and action index, allowing it to be contextually linked to an on-chain proposal while remaining independent. + +## Motivation: why is this CIP necessary? + +Formal Cardano governance actions are intentionally restrictive and structured, but this rigidity limits the ability to gather **informal or exploratory community sentiment**. Off-chain tools (e.g., Google Forms, Typeform) have been used for this purpose, but they fragment data and trust. + +This CIP proposes a **unified, lightweight survey metadata format** that can be used by anyone to: +- Collect feedback. +- Gauge sentiment. +- Display aggregated results. + +By allowing an **optional reference to a governance action**, this model supports both: +- **Standalone surveys** (e.g., community temperature checks). +- **Governance-linked surveys** (e.g., feedback on a specific proposal or Info Action). + +This separation of concerns provides: +- **Clarity:** Surveys are not mistaken for governance actions. +- **Flexibility:** No deposits, time limits, or procedural constraints. +- **Discoverability:** Metadata is consistent, indexed, and linkable. + +## Specification + +This specification uses **CIP-0068** label **674** and defines two payload types: +`surveyDetails` (definition) and `surveyResponse` (vote). + +### Survey Definition Payload + +This metadata is included in any transaction that defines a survey. +It can be completely independent or optionally reference an existing governance action. + +```json +{ + "674": { + "msg": [""], + "surveyDetails": { + "specVersion": "1.0", + "type": "single-choice", + "question": "", + "description": "", + "options": [ + "