Creating a Stream
1
Connect your Freighter wallet
Open the Aven dashboard and click Connect Wallet in the top navigation. Approve the connection in the Freighter popup. Make sure Freighter is set to Stellar Testnet before proceeding.
2
Navigate to Streams → Create New Stream
From the dashboard, click the + New Stream button in the top-right of the streams list.
3
Fill in the stream parameters
Complete the creation form with the following details:
- Title — a label for your own reference (required)
- Recipient address — the worker’s Stellar public key (
G...format) - Total amount — total funds to lock, in USDC or XLM
- Asset — choose USDC or XLM
- Duration — total stream length in days (the dashboard converts this to ledgers automatically)
- Category — Freelance, Salary, Bounty, Grant, AgentTask, or Subscription
4
Click 'Initialize Stream on Stellar'
Freighter pops up and asks you to review and sign the transaction. Confirm to broadcast it to the Stellar Testnet.
5
Stream is now Active
Once the transaction is confirmed, funds are locked in the stream contract and the stream status becomes Active. Share the stream ID with your worker so they can start logging sessions against it.
Stream Parameters
The worker’s Stellar public key in
G... format. Must be a valid 56-character Stellar address.Total funds to lock in the stream, denominated in USDC or XLM. Must be greater than zero and covered by your available balance plus transaction fees.
Total stream duration in days. The dashboard converts this value to Stellar ledgers (approximately 5 seconds per ledger on Testnet) and uses it to calculate the per-second payout rate.
The payment token for this stream. Choose
USDC for a USD-denominated stream or XLM for native Stellar tokens. USDC streams require a USDC trustline on both the sender and recipient accounts.The work category. This label feeds into the worker’s on-chain reputation score, so it is worth choosing the most accurate option. Defaults to
Freelance.A human-readable label for the stream, visible to both you and the worker in the dashboard. For example:
"Smart Contract Audit – Phase 1".Stream Status
Stream Controls
Only the stream sender (client) can use these controls. Actions are signed with Freighter and executed as on-chain transactions.- Pause — Temporarily halts the stream. Time stops accruing while the stream is paused. The worker can still submit pending work sessions for review, but no new earnings accumulate until you resume.
- Resume — Reactivates a paused stream. Time begins accruing again from the point of resumption.
- Cancel — Permanently terminates the stream. Any unearned funds (the portion of the locked balance not yet released to the worker) are returned to your account. Sessions that have already been approved and released remain valid and are not reversed.
Once a stream is cancelled, it cannot be reactivated. If you need to continue working with the same recipient, create a new stream.
Stream Detail View
Clicking any stream card opens the stream detail page, which shows:- Stream ID, status badge, and category label
- Sender and recipient Stellar addresses
- Total deposited, total withdrawn, and a visual progress bar
- Rate per ledger and total duration in ledgers
- Available, pending review, release-eligible, and disputed amounts broken out by work session status
- All submitted work sessions with their individual statuses, timing, and git statistics
- A link to the Stellar Expert on-chain explorer for the stream contract