> ## 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.

# Stellar Testnet Account Setup Guide for Aven Users

> Configure Freighter, fund your Testnet account, add a USDC trustline, and request test USDC to start creating streams and running Aven work sessions.

Aven runs on Stellar Testnet. Before you can create streams or run work sessions, you need a funded Testnet account with the Freighter wallet installed. This guide walks you through every step — from installing the wallet to getting testnet USDC — so you can start using Aven without spending real money.

## What You Need

* [Freighter](https://www.freighter.app/) browser wallet, configured for Testnet
* A funded Testnet Stellar account (free via Friendbot)
* USDC testnet balance (for USDC streams)
* Node.js v20+ (for the CLI)

## Step 1: Install and Configure Freighter

<Steps>
  <Step title="Download Freighter">
    Install the [Freighter](https://www.freighter.app/) extension for your browser. It is available for Chrome, Firefox, and Brave.
  </Step>

  <Step title="Create or import an account">
    Open Freighter and create a new account, or import an existing one using your secret recovery phrase.
  </Step>

  <Step title="Switch to Testnet">
    Click the network selector at the top of the Freighter UI and switch to **Testnet**. Never use Mainnet while working with the current Aven deployment.
  </Step>

  <Step title="Copy your public key">
    Your Testnet public key (beginning with `G...`) is displayed in the wallet UI. Copy it — you will need it in the next steps.
  </Step>
</Steps>

## Step 2: Fund Your Account

Stellar accounts must hold a minimum XLM reserve and pay a small fee for every transaction. Use Friendbot to fund your new Testnet account for free.

```bash theme={null}
curl "https://friendbot.stellar.org?addr=YOUR_PUBLIC_KEY"
```

Alternatively, use the web interface: [Stellar Laboratory — Account Creator](https://laboratory.stellar.org/#account-creator?network=test). Paste your public key and click **Get test network lumens**. Your account will be funded with 10,000 test XLM.

## Step 3: Add a USDC Trustline

Stellar requires you to opt in to each asset you want to hold. To receive or stream USDC, your account must have a USDC trustline. Skip this step if you only plan to use XLM streams.

1. Open [Stellar Lab](https://laboratory.stellar.org)
2. Go to **Account** → **Add Trustline**
3. Add a trustline for the following asset:
   * **Asset code:** `USDC`
   * **Issuer:** `GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5`
4. Sign the transaction with Freighter when prompted

## Step 4: Get Testnet USDC

Once your trustline is active, request free Testnet USDC from Circle's faucet:

1. Visit [Circle's testnet faucet](https://faucet.circle.com/)
2. Select **Stellar Testnet** from the network dropdown
3. Enter your Testnet public key
4. Click **Request** — USDC will appear in your Freighter wallet within seconds

## Testnet Contract Addresses

These are the deployed Aven smart contract addresses on Stellar Testnet. Use them when verifying transactions or querying contract state directly.

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

## Exploring Transactions

Once you have started using Aven, you can inspect every on-chain action using these tools:

* View your account balance, transaction history, and minted attestations on [Stellar Expert (Testnet)](https://stellar.expert/explorer/testnet)
* Search for contract events and simulate invocations on [Stellar Lab](https://laboratory.stellar.org)

<Warning>
  Testnet accounts and funds have no real-world value. Never use Mainnet accounts or real USDC with the current Aven deployment.
</Warning>

<Note>
  Testnet may be reset periodically by the Stellar Development Foundation. If transactions stop working or your balance disappears, re-fund your account with Friendbot and re-add your USDC trustline.
</Note>