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

# Aven: Decentralized Streaming Payments & On-Chain Reputation

> Aven is a Stellar-based protocol that streams payments to workers in real time, mints verifiable attestations, and builds portable on-chain reputation.

Aven connects clients, workers, and AI agents through a trustless payment layer on Stellar. Clients stream USDC or XLM to workers as progress is made. Every verified work session is permanently recorded as an on-chain attestation, and those attestations roll up into a portable reputation score that workers own forever.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Set up your wallet, create your first stream, and run your first CLI session in minutes.
  </Card>

  <Card title="How It Works" icon="diagram-project" href="/how-it-works">
    Understand the full lifecycle from stream creation to reputation score.
  </Card>

  <Card title="CLI Guide" icon="terminal" href="/cli/overview">
    Install and use the `aven-stellar` npm package to track and submit work sessions.
  </Card>

  <Card title="Core Concepts" icon="book-open" href="/concepts/payment-streams">
    Learn about payment streams, attestations, and the reputation system.
  </Card>

  <Card title="Dashboard" icon="gauge" href="/dashboard/streams">
    Manage streams, review sessions, and track payments from the Aven web app.
  </Card>

  <Card title="Smart Contracts" icon="file-contract" href="/contracts/overview">
    Explore the on-chain contracts powering atomic payments and attestations.
  </Card>
</CardGroup>

## How Aven Works

<Steps>
  <Step title="Create a Payment Stream">
    A client locks USDC or XLM into the Aven stream contract, setting a total amount, duration, and per-second rate. Funds are safely escrowed on Stellar.
  </Step>

  <Step title="Track Your Work Session">
    The worker runs `npx aven-stellar start` inside any Git repository. Aven monitors active time and Git statistics — never reading file contents or uploading source code.
  </Step>

  <Step title="Submit & Verify">
    When work is done, `npx aven-stellar stop` generates a session report and submits it to the Aven dashboard. A verifier cryptographically validates the session before any funds move.
  </Step>

  <Step title="Atomic Payout + Attestation">
    Payment is transferred to the worker and an attestation is minted on Stellar in a single atomic transaction. Both succeed or both revert — no partial states.
  </Step>

  <Step title="Build Reputation">
    Every verified attestation contributes to the worker's on-chain reputation score, categorized by work type: Freelance, Bounty, Grant, AgentTask, and more.
  </Step>
</Steps>

## Key Features

<CardGroup cols={3}>
  <Card title="Streaming Payments" icon="wave-square">
    Clients pay per second of verified work — no upfront risk, no payment delays.
  </Card>

  <Card title="Atomic Guarantees" icon="link">
    Payment and attestation are unified in one transaction. Either both happen or neither does.
  </Card>

  <Card title="Privacy-First Tracking" icon="shield-halved">
    The CLI collects only Git statistics and timing — never file contents, keystrokes, or secrets.
  </Card>

  <Card title="On-Chain Reputation" icon="star">
    Portable, category-based reputation scores that workers own and verifiers can trust.
  </Card>

  <Card title="AI Agent Ready" icon="robot">
    Non-interactive CLI flags let autonomous agents track work and claim payments without human input.
  </Card>

  <Card title="USDC & XLM Native" icon="coins">
    Fund streams with Stellar's native token or USDC — both are first-class citizens.
  </Card>
</CardGroup>

## Deployed Contracts (Testnet)

Aven's smart contracts are live on Stellar Testnet:

| Contract                 | Address                                                    |
| ------------------------ | ---------------------------------------------------------- |
| **Stream Contract**      | `CAZSE5UHSWNF62K26OZKOL7BSFB2647CXRPOICHUDCUJ5EKS4NCOA6ZA` |
| **Attestation Contract** | `CD22NZLAI53Y2LZB2GNLVITQXZWGZ3AQ6QKVKNUDKWABIIQIDEFSPQCG` |
| **Reputation Contract**  | `CANK4E7GOFZT4D3U57RNT7QLQTNFGY7QNL6TQTWWKYBNHX7J6U54HO7E` |

<Note>
  Aven is currently running on **Stellar Testnet**. Use a Freighter wallet configured for Testnet with a funded account to interact with the protocol.
</Note>