Quick Start
Set up your wallet, create your first stream, and run your first CLI session in minutes.
How It Works
Understand the full lifecycle from stream creation to reputation score.
CLI Guide
Install and use the
aven-stellar npm package to track and submit work sessions.Core Concepts
Learn about payment streams, attestations, and the reputation system.
Dashboard
Manage streams, review sessions, and track payments from the Aven web app.
Smart Contracts
Explore the on-chain contracts powering atomic payments and attestations.
How Aven Works
1
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.
2
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.3
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.4
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.
5
Build Reputation
Every verified attestation contributes to the worker’s on-chain reputation score, categorized by work type: Freelance, Bounty, Grant, AgentTask, and more.
Key Features
Streaming Payments
Clients pay per second of verified work — no upfront risk, no payment delays.
Atomic Guarantees
Payment and attestation are unified in one transaction. Either both happen or neither does.
Privacy-First Tracking
The CLI collects only Git statistics and timing — never file contents, keystrokes, or secrets.
On-Chain Reputation
Portable, category-based reputation scores that workers own and verifiers can trust.
AI Agent Ready
Non-interactive CLI flags let autonomous agents track work and claim payments without human input.
USDC & XLM Native
Fund streams with Stellar’s native token or USDC — both are first-class citizens.
Deployed Contracts (Testnet)
Aven’s smart contracts are live on Stellar Testnet:Aven is currently running on Stellar Testnet. Use a Freighter wallet configured for Testnet with a funded account to interact with the protocol.