> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syncgovhub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Proposal Explorer

> A guide to using the Proposal Explorer

<Note>
  **AI-Powered Analysis**: The Proposal Explorer features a chat interface that allows you to ask questions about governance proposals and receive detailed AI-generated analysis.
</Note>

## What is the Proposal Explorer?

The Proposal Explorer is an interactive tool for browsing and analyzing Cardano governance proposals. It features an AI assistant that can answer questions about proposal content, technical details, voting outcomes, and implications.

## Key Features

<CardGroup cols={2}>
  <Card title="Proposal Browsing" icon="list" color="#2091ff">
    Browse proposals by type, status, and date
  </Card>

  <Card title="AI Chat Interface" icon="message-bot" color="#2091ff">
    Ask questions about proposals in natural language
  </Card>

  <Card title="Semantic Search" icon="magnifying-glass" color="#2091ff">
    Find proposals based on content and context
  </Card>

  <Card title="Voting Analytics" icon="chart-pie" color="#2091ff">
    View detailed voting breakdowns
  </Card>
</CardGroup>

## How to Use the Proposal Explorer

<Steps>
  <Step title="Browse and Select a Proposal">
    Use the proposal list to browse and select a specific governance proposal.

    You can filter proposals by:

    * Proposal type (Parameter Change, Treasury Withdrawal, etc.)
    * Status (Active, Ratified, Enacted, etc.)
    * Date range
  </Step>

  <Step title="View Proposal Details">
    Once you select a proposal, you can view its details including the proposal text, metadata, and voting results.

    The details page includes:

    * Proposal title and description
    * Proposer information
    * Status and lifecycle dates
    * Technical details (for parameter changes)
    * Voting results by stakeholder group
  </Step>

  <Step title="Ask Questions with the AI Assistant">
    Use the chat interface to ask questions about the proposal and receive AI-generated analysis.

    **Example Questions:**

    * "What are the main objectives of this proposal?"
    * "How does this parameter change affect staking rewards?"
    * "What were the arguments for and against this proposal?"
    * "What impact will this have on the Cardano ecosystem?"
  </Step>

  <Step title="Explore Voting Analytics">
    Analyze the voting patterns and outcomes for the proposal across different stakeholder groups.

    The voting analytics show:

    * Vote distribution (yes, no, abstain) for each stakeholder group
    * Participation rates
    * Voting power distribution
    * Threshold achievements
  </Step>
</Steps>

## AI Assistant Capabilities

<Info>
  **Comprehensive Understanding**: The AI assistant analyzes the full proposal content, related documents, and voting data to provide detailed insights.
</Info>

The AI assistant can answer questions about:

### Content Analysis

* Explain proposal objectives and rationale
* Analyze technical details of parameter changes
* Summarize key points and implications
* Compare different sections of a proposal

### Contextual Information

* Explain a proposal's relationship to the Cardano ecosystem
* Provide background on proposal types and purposes
* Analyze historical context for proposals

### Vote Analysis

* Explain vote outcomes and distribution
* Analyze stakeholder participation and consensus
* Explore implications of voting results

## Cross-Proposal Analysis

You can also use the AI assistant to analyze patterns across multiple proposals. Simply start a new chat without selecting a specific proposal.

**Example Cross-Proposal Questions:**

* "What are common patterns in parameter change proposals?"
* "How have treasury withdrawal proposals evolved over time?"
* "What factors contribute to proposal success or failure?"
* "What are the voting trends for governance proposals in the last six months?"

## API Integration

For developers who want to integrate the Proposal Explorer capabilities into their own applications, the API provides programmatic access to the same functionality.

<CodeGroup>
  ```bash API Example theme={null}
  curl -X POST https://api.syncgovhub.com/api/proposal/ai \
    -H "Content-Type: application/json" \
    -H "x-api-key: YOUR_API_KEY" \
    -d '{
      "query": "What are the main objectives and implications of this parameter change?",
      "govaction_id": "gov1x8jkz74"
    }'
  ```

  ```javascript JavaScript Example theme={null}
  fetch('https://api.syncgovhub.com/api/proposal/ai', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      query: 'What are the main objectives and implications of this parameter change?',
      govaction_id: 'gov1x8jkz74'
    })
  })
  .then(response => response.json())
  .then(data => console.log(data));
  ```
</CodeGroup>

## Best Practices

* **Ask Focused Questions**: Specific questions yield more detailed and accurate responses
* **Explore Key Aspects**: Ask about objectives, technical details, implications, and voting outcomes
* **Use Follow-up Questions**: Build on previous answers to explore topics in greater depth
* **Verify Information**: Use the source references to verify information in the original documents
* **Compare Proposals**: Use cross-proposal analysis to identify patterns and trends