# Welcome to Alvara

Alvara Protocol is a decentralized asset management platform built on the Basket Token Standard (ERC-7621). It enables anyone to create, manage, and invest in tokenized investment portfolios (called BSKTs) without intermediaries, custody risk, or barriers to entry.

**What you can do with Alvara:**

* **Invest** in curated portfolios managed by on-chain fund managers
* **Create** your own BSKT and earn management fees
* **Stake** ALVA tokens to earn veALVA voting power
* **Govern** the protocol through gauge weight voting
* **Earn** rewards for participating in DAO governance

## Quick Links

| Resource         | Link                                                                           |
| ---------------- | ------------------------------------------------------------------------------ |
| Launch App       | [app.alvara.xyz](https://app.alvara.xyz)                                       |
| Governance Forum | [governance.alvara.xyz](https://governance.alvara.xyz)                         |
| Snapshot Voting  | [snapshot.org/#/s:bskt.eth](https://snapshot.org/#/s:bskt.eth)                 |
| White Paper      | [docs.alvara.xyz/resources/whitepaper](/resources/whitepaper)                  |
| Discord          | [discord.com/invite/alvaraprotocol](https://discord.com/invite/alvaraprotocol) |
| Telegram         | [t.me/alvaraprotocol](https://t.me/alvaraprotocol)                             |
| X (Twitter)      | [@AlvaraProtocol](https://x.com/AlvaraProtocol)                                |

## New to Alvara?

Start with [What is Alvara Protocol?](/getting-started/what-is-alvara) for a high-level overview, or jump straight to [Core Concepts](/getting-started/core-concepts) to understand the key building blocks.

If you already know your way around, head to the section that matches what you want to do:

* **I want to invest:** [Investing in a BSKT](/bskts/investing-in-a-bskt)
* **I want to create a fund:** [Creating a BSKT](/bskt-lab/creating-a-bskt)
* **I want to stake and vote:** [What is veALVA?](/staking-and-vealva/what-is-vealva)
* **I want to claim rewards:** [Claiming DAO Rewards](/dao-governance/claiming-dao-rewards)


# What is Alvara Protocol?

Alvara Protocol is a decentralized platform that brings fund management on-chain. It allows anyone to create tokenized investment portfolios (BSKTs), manage them transparently on-chain, and earn fees, all without intermediaries, custodians, or high capital requirements.

## The Problem

Traditional fund management is exclusive. Starting a hedge fund or investment vehicle requires regulatory licenses, legal infrastructure, custodial arrangements, and significant capital. Even in DeFi, building and managing an on-chain portfolio for others requires deep technical knowledge and custom smart contracts.

Investors, meanwhile, face limited transparency. They trust managers with capital but have little real-time insight into what's happening with their money.

## The Alvara Solution

Alvara removes these barriers through four interconnected components:

### BSKT Lab

A factory for creating tokenized investment portfolios. Any wallet can deploy a basket of ERC-20 tokens with custom weightings. No coding required. The minimum deployment cost is 0.1 ETH, and the creator automatically becomes the fund manager with full rebalancing control.

### Fund Manager System

Managers earn fees on assets under management and can rebalance their BSKT's allocation at any time. A public leaderboard ranks managers by performance, so the best managers rise to the top. Management rights are represented as NFTs, meaning they can be transferred or sold.

### Staking & veALVA

Users lock ALVA tokens to receive veALVA, the protocol's governance and voting token. Longer locks earn more veALVA. This vote-escrowed model aligns long-term incentives: the people with the most say in governance are those most committed to the protocol's future.

### DAO Governance

veALVA holders participate in gauge weight voting each epoch, directing ALVA rewards toward specific BSKTs. This creates a feedback loop: managers compete for votes, voters earn rewards, and high-performing BSKTs attract more capital.

## How It All Connects

1. **Managers** create BSKTs in the BSKT Lab and compete on the leaderboard
2. **Investors** deposit into BSKTs they believe in, receiving LP tokens
3. **Stakers** lock ALVA for veALVA, gaining voting power
4. **Voters** direct gauge weight rewards to BSKTs each epoch
5. **Rewards** flow to stakers and to LP holders of BSKTs that receive gauge-weight emissions


# Core Concepts

Before using the platform, here are the key building blocks of the Alvara ecosystem.

## BSKT (Basket Token)

A BSKT is a tokenized investment portfolio built on the ERC-7621 standard. Each BSKT holds a basket of ERC-20 tokens in defined proportions and is managed by a single wallet address (the Manager).

When you invest in a BSKT, you receive **LP tokens** representing your proportional share of the basket's underlying assets. These LP tokens can be redeemed at any time for ETH or for the underlying tokens directly.

**Key properties:**

* Fully on-chain and non-custodial
* Manager controls allocation but cannot access investor funds
* Any ERC-20 token on supported chains can be included
* Including ALVA in the allocation unlocks reduced platform fees (currently mandatory on Ethereum, becoming optional with Base deployment)

## Manager

A Manager is the wallet that created a BSKT. Managers have exclusive control over their basket's allocation. They can rebalance token weights, trigger emergency controls, and earn management fees.

Managers do not have custody of depositor funds. They can only change what the basket holds, not withdraw other people's capital.

Management rights are represented as an NFT, meaning they can be transferred or sold on the BSKT Marketplace.

## ALVA

ALVA is the native ERC-20 utility token of the Alvara Protocol. It serves three core functions:

1. **Governance:** Lock ALVA to receive veALVA voting power
2. **Fee Reduction:** Including ALVA in a BSKT unlocks reduced platform fees
3. **Staking Rewards:** Stakers earn ALVA rewards funded by ALVA bought back from a percentage of platform fees

ALVA has a fixed maximum supply and is deflationary: tokens locked forever in the staking contract are permanently removed from circulating supply.

## veALVA (Vote-Escrowed ALVA)

veALVA is the governance token of the Alvara DAO. You receive veALVA by locking ALVA tokens in the staking contract. The amount of veALVA you receive depends on:

* **How much** ALVA you lock
* **How long** you lock it for

Longer commitments earn disproportionately more veALVA. veALVA is non-transferable. It can only be earned through staking.

## Epoch

An epoch is a recurring governance cycle (typically one week) during which veALVA holders cast gauge weight votes. At the end of each epoch, votes are tallied and ALVA rewards are allocated to BSKTs based on the voting results.

## Gauge Weight Voting

The mechanism by which veALVA holders direct ALVA rewards. Each epoch, voters allocate their voting power to specific BSKTs. The BSKTs that receive the most votes earn a larger share of the epoch's reward pool. This incentivizes managers to create high-performing baskets and voters to identify the best strategies.

## LP Token

When you invest in a BSKT, you receive LP (Liquidity Provider) tokens. These represent your share of the basket's total value. LP tokens can be:

* **Redeemed for ETH:** Sell your share back for ETH at current market value
* **Redeemed for underlying tokens:** Receive the basket's constituent tokens in proportion to your share
* **Held:** Continue holding exposure to the manager's strategy


# Connecting Your Wallet

Alvara Protocol is a decentralized application (dApp). To interact with it, you need a Web3 wallet.

## Supported Wallets

Alvara uses RainbowKit for wallet connections, which supports all major wallets including:

* MetaMask
* Coinbase Wallet
* WalletConnect-compatible wallets
* Rainbow
* And many others

## How to Connect

1. Navigate to [app.alvara.xyz](https://app.alvara.xyz)
2. Click the **Connect** button in the top-right corner of the navigation bar
3. Select your preferred wallet from the modal
4. Approve the connection in your wallet

Once connected, your wallet address will appear in the navigation bar. You can view your portfolio, create BSKTs, stake ALVA, and participate in governance.

## Network Switching

Alvara operates across multiple networks depending on the action you're performing:

| Action                         | Network          |
| ------------------------------ | ---------------- |
| Exploring & investing in BSKTs | Ethereum         |
| Creating & managing BSKTs      | Ethereum         |
| Staking ALVA for veALVA        | Ethereum Mainnet |
| Claiming DAO rewards           | Ethereum Mainnet |

The app will prompt you to switch networks when needed. Your wallet will ask you to confirm the network switch.

## Disconnecting

Click your wallet address in the navigation bar and select **Disconnect** to end your session.

## Geo-Compliance

Alvara enforces regional compliance requirements. Users in restricted jurisdictions may not be able to access the platform. A legal notice must be accepted on first use.


# Supported Networks

Alvara Protocol operates across multiple blockchain networks.

## Ethereum Mainnet

* Creating BSKTs in the BSKT Lab
* Depositing into and redeeming from BSKTs
* Rebalancing BSKT allocations
* Claiming management fees
* Staking ALVA to earn veALVA
* Claiming DAO gauge weight rewards
* Governance-related contract interactions

The dApp and all BSKT operations are live on Ethereum mainnet.

## Base (Coming Q1 2026)

* Creating BSKTs in the BSKT Lab
* Depositing into and redeeming from BSKTs
* Rebalancing BSKT allocations
* Claiming management fees

Base support is planned for launch by end of March 2026, offering low transaction costs and fast confirmation times.

## Avalanche

The ALVA token is also available on Avalanche C-Chain. Your cross-chain ALVA balance is displayed in your portfolio.

## Automatic Network Switching

When you attempt an action that requires a different network than the one your wallet is currently connected to, the app will display a prompt asking you to switch. Confirm the switch in your wallet to proceed.


# What is a BSKT?

A BSKT (pronounced "basket") is a tokenized investment portfolio on the blockchain. Each BSKT holds a collection of ERC-20 tokens in defined proportions, managed by a single on-chain fund manager.

## How BSKTs Work

A BSKT works like an on-chain index fund or ETF. A manager selects a set of tokens and assigns each a target weight (e.g., 40% ETH, 30% LINK, 25% AAVE, 5% ALVA). Investors can deposit ETH into the BSKT, which is automatically converted into the basket's constituent tokens according to those weights.

In return, investors receive **LP tokens:** fungible tokens representing their proportional share of the basket. These LP tokens can be redeemed at any time.

## Key Properties

### Non-Custodial

The BSKT smart contract holds all underlying assets. The manager can change the basket's allocation (rebalance), but cannot withdraw investor funds. Only LP token holders can redeem their own share.

### Transparent

Every BSKT's allocation, performance, and transaction history is fully visible on-chain. The Alvara app displays real-time data including current holdings, price history, and manager activity.

### ALVA Allocation

On Ethereum, every BSKT currently includes a minimum percentage of ALVA in its allocation, creating organic demand for the ALVA token and connecting every basket to the broader Alvara ecosystem. With the upcoming Base deployment, this becomes a variable parameter — including ALVA unlocks reduced platform fees rather than being a strict requirement.

### Manager-Controlled

Each BSKT has a single manager who controls the investment strategy. Managers can:

* Rebalance token allocations at any time
* Trigger emergency controls if needed
* Earn management fees on assets under management

### Open to All

Anyone with a Web3 wallet and 0.1 ETH can create a BSKT. There are no applications, licenses, or minimum track records required.

## BSKT vs. Traditional Funds

| Feature                   | Traditional Fund                        | BSKT                           |
| ------------------------- | --------------------------------------- | ------------------------------ |
| Minimum to start managing | $100K+ and legal setup                  | 0.1 ETH                        |
| Custody                   | Third-party custodian                   | Smart contract (non-custodial) |
| Transparency              | Quarterly reports                       | Real-time, on-chain            |
| Investor redemption       | Lock-up periods common                  | Instant, any time              |
| Fees                      | 2% management + 20% performance typical | Set by protocol                |
| Regulatory overhead       | Extensive                               | Permissionless                 |


# Exploring BSKTs

The Alvara app provides several ways to discover and evaluate BSKTs before investing.

## Explore Page

The main Explore page displays all BSKTs on the platform. You can:

* **Search** by BSKT name or ticker
* **Sort** by TVL, performance, price, or other metrics
* **Filter** to find baskets that match your criteria

Each BSKT card shows key information at a glance: name, ticker, current price, TVL (Total Value Locked), and recent performance.

## BSKT Detail Page

Click on any BSKT to view its full detail page, which includes:

### Price Chart

Historical price data displayed as an interactive chart. View performance across multiple timeframes to understand how the basket has performed over time.

### Token Breakdown

A visual breakdown of the basket's current allocation: which tokens it holds and their respective weights. This updates in real-time as token prices fluctuate.

### Performance Metrics

Key performance indicators including returns over various timeframes (24h, 7d, 30d, all-time), helping you evaluate the manager's track record.

### Risk Ratings

BSKTs display third-party risk ratings (powered by Xerberus) for constituent tokens. These credit-style ratings (AAA to D) provide an independent assessment of the underlying asset risk.

### Manager Information

Details about the BSKT's manager, including their wallet address, linked social profiles, and Gitcoin Passport score (a measure of identity verification).

### Activity Feed

A chronological record of all transactions related to the BSKT: deposits, redemptions, rebalances, and other events.

### Manager Notes

Managers can publish notes explaining their strategy, recent decisions, or market outlook. This provides context beyond the raw on-chain data.

## Manager Leaderboard

The Leaderboard ranks all BSKT managers by performance and assets under management. Use it to identify top-performing managers and evaluate their track records across multiple BSKTs.

Key metrics shown:

* Number of BSKTs managed
* Total AUM (combined TVL across all managed baskets)
* Average performance
* Best-performing BSKT


# Investing in a BSKT

Investing in a BSKT means depositing ETH into a tokenized portfolio managed by an on-chain fund manager. In return, you receive LP tokens representing your share of the basket.

## How to Invest

1. **Find a BSKT:** Browse the Explore page or Leaderboard to find a basket that aligns with your investment thesis
2. **Open the BSKT detail page:** Click on the BSKT to view its full details
3. **Enter your deposit amount:** Use the deposit widget on the detail page to specify how much ETH you want to invest
4. **Confirm the transaction:** Review the details and confirm in your wallet

Your ETH is automatically converted into the basket's constituent tokens according to the current allocation weights. You receive LP tokens representing your proportional share.

## What You Receive

After depositing, you hold **LP tokens** for that specific BSKT. These tokens:

* Represent your share of the basket's total value
* Fluctuate in value as the underlying tokens move
* Can be redeemed at any time (see [Redeeming Your Position](/bskts/redeeming-your-position))
* Are standard ERC-20 tokens held in your wallet

## MEV Protection

All deposits are protected against MEV (Maximal Extractable Value) attacks. The protocol uses a backend signing service to compute optimal swap routes and prevent front-running or sandwich attacks on your transaction. This happens automatically. No action required on your part.

## Things to Consider

**Manager risk:** The BSKT manager controls the basket's allocation. If the manager makes poor rebalancing decisions, the basket's value may decline. Review the manager's track record on the Leaderboard before investing. A manager can also extract TVL by adding a honeypot or a token they have provided LP for and then removing the LP from DEX. It is important to carry out DD on your manager and invest at your own risk.

**Smart contract risk:** Your assets are held by the BSKT smart contract. While the contracts have been audited, all smart contract interactions carry inherent risk.

**Token risk:** The underlying tokens in a BSKT are subject to their own market risks. A basket holding volatile tokens will itself be volatile. Check the risk ratings on the BSKT detail page.

**Network:** BSKT deposits are currently available on Ethereum, with Base support coming soon. Ensure your wallet is connected to the correct network and that you have ETH on the correct chain for the deposit and gas fees.


# Redeeming Your Position

You can exit a BSKT position at any time by redeeming your LP tokens. There are no lock-up periods or withdrawal queues.

## Two Redemption Options

### Redeem for ETH

Your LP tokens are burned, the basket's underlying tokens are sold for ETH, and you receive ETH back to your wallet. This is the most common redemption method.

**When to use:** You want a single asset (ETH) returned and don't want to manage multiple tokens.

### Redeem for Underlying Tokens

Your LP tokens are burned and you receive each of the basket's constituent tokens in proportion to your share. No swaps are performed.

**When to use:** You want to keep exposure to specific tokens in the basket, or you want to avoid any swap slippage.

## How to Redeem

1. Navigate to the BSKT detail page for the basket you're invested in
2. Open the redemption interface
3. Enter the amount of LP tokens you want to redeem (or select "Max")
4. Choose your redemption method (ETH or underlying tokens)
5. Confirm the transaction in your wallet

## MEV Protection

ETH redemptions involve token swaps and are protected against MEV attacks using the same backend signing service as deposits. Underlying token redemptions do not involve swaps and therefore do not require MEV protection.

## Important Notes

* Redemptions are processed instantly on-chain
* You can redeem a partial amount of your LP tokens. You don't have to exit the full position
* Gas fees on the respective network are required for the redemption transaction
* The value you receive is based on the current market prices of the underlying tokens at the time of redemption


# Understanding Performance

The Alvara platform provides several metrics to help you evaluate BSKT performance and make informed investment decisions.

## Key Metrics

### Price

The current price of one LP token, derived from the total value of the basket's underlying assets divided by the total LP token supply. Price changes reflect both market movements of constituent tokens and any rebalancing actions by the manager.

### TVL (Total Value Locked)

The total USD value of all assets held in the BSKT. Higher TVL generally indicates greater investor confidence, but is not a guarantee of future performance.

### Returns

Performance measured over standard timeframes:

* **24h:** Short-term price movement
* **7d:** Weekly performance
* **30d:** Monthly performance
* **All-time:** Since the BSKT was created

Returns account for changes in underlying token prices and any rebalancing activity.

### Token Allocation

The current breakdown of which tokens the BSKT holds and their respective weights. This may differ from the target weights if token prices have moved since the last rebalance.

## Risk Ratings

BSKTs display third-party risk ratings powered by Xerberus for each constituent token. Ratings range from **AAA** (lowest risk) to **D** (highest risk) and are based on independent analysis of token fundamentals, liquidity, and market data.

These ratings provide an additional data point for evaluating the risk profile of a basket, but should not be the sole basis for investment decisions.

## Activity History

Every BSKT maintains a complete, on-chain transaction history including:

* **Deposits:** When investors add capital
* **Redemptions:** When investors withdraw
* **Rebalances:** When the manager changes the allocation
* **Emergency events:** If the manager triggers emergency controls

This history is fully transparent and verifiable on-chain.

## Evaluating a Manager

Beyond individual BSKT performance, consider the manager's broader track record:

* How many BSKTs do they manage?
* What is their combined AUM?
* How consistent is their performance across baskets?
* How frequently do they rebalance?
* Have they linked a verified identity (X profile, Gitcoin Passport)?

The Manager Leaderboard aggregates these data points to help you compare managers.


# Creating a BSKT

The BSKT Lab is where you create new tokenized investment portfolios. Any wallet can create a BSKT. There are no applications, approvals, or minimum track records required.

## Overview

Creating a BSKT is a three-step process:

1. **Compose:** Select tokens and assign allocation weights
2. **Design:** Name your BSKT, choose a ticker, and add branding
3. **Fund:** Deposit the initial capital to deploy the basket on-chain

Once deployed, you become the BSKT's manager with full control over its allocation strategy.

## Requirements

* A Web3 wallet connected to the Ethereum network
* Minimum 0.1 ETH to seed the basket
* Additional ETH for Ethereum gas fees

## What Happens When You Create a BSKT

When you deploy a BSKT:

1. Your ETH is converted into the tokens you selected, according to your specified weights
2. A new BSKT smart contract is created on Ethereum
3. You receive **LP tokens** representing your initial investment (your personal capital)
4. You receive the **management NFT**, granting you manager rights over the basket
5. Your BSKT appears on the Explore page and Leaderboard

## Important Notes

* The manager can only rebalance the basket's allocation. They cannot withdraw other investors' funds.
* Your initial ETH is used to purchase the underlying tokens according to your allocation weights. LP tokens are minted to represent your contribution — this is your personal investment in the basket, not a fee.
* A creation fee (percentage of the initial deposit) applies and is defined by the protocol.
* On Ethereum, every BSKT must currently include a minimum ALVA allocation (see [Composing Your Allocation](/bskt-lab/composing-your-allocation)). This requirement is changing with the upcoming Base deployment.

## Draft Saving

If you start the creation process but don't complete it, your progress is automatically saved as a draft in your browser. You can resume where you left off within 24 hours.

See the following pages for detailed guidance on each step:

* [Composing Your Allocation](/bskt-lab/composing-your-allocation)
* [Designing Your BSKT](/bskt-lab/designing-your-bskt)
* [Funding & Deployment](/bskt-lab/funding-and-deployment)


# Composing Your Allocation

The first step in creating a BSKT is selecting which tokens to include and how much weight each should have.

## Selecting Tokens

Search for and add ERC-20 tokens available on the Ethereum network (Base and other networks coming soon). The token list is sourced from validated registries, so you only see legitimate tokens.

For each token you add, you assign a **weight:** the percentage of the basket's total value that should be allocated to that token.

## ALVA Allocation

Currently, every BSKT on Ethereum must include ALVA as part of its allocation. The minimum ALVA percentage is set by the protocol and is enforced automatically. This requirement:

* Creates consistent demand for the ALVA token
* Connects every basket to the Alvara ecosystem
* Ensures all BSKTs contribute to the protocol's tokenomics

The remaining allocation is entirely up to you.

> **Note:** With the upcoming Base deployment, the mandatory ALVA minimum will become a variable parameter. Including ALVA in your allocation will unlock reduced platform fees rather than being a strict requirement.

## Weight Rules

* All weights must add up to exactly **100%**
* Each token must have a weight greater than 0%
* The ALVA allocation requirement must be met (see above)
* There is no maximum number of tokens, but larger baskets may incur higher gas costs

## Token Tax Detection

Some tokens have built-in buy or sell taxes. The platform automatically detects these taxes during the composition step and adjusts slippage settings per-token to ensure transactions complete successfully.

If a token has a detected tax, you'll see it noted in the interface. You can also manually adjust per-token slippage if needed.

## Tips for Good Allocation Design

* **Diversification:** Spreading across multiple tokens reduces the impact of any single token's decline
* **Conviction weighting:** Assign higher weights to tokens you have the most confidence in
* **Liquidity awareness:** Tokens with very low liquidity may experience higher slippage during rebalancing
* **Rebalancing frequency:** Consider how often you plan to rebalance when choosing the number of tokens. More tokens means more complexity.


# Designing Your BSKT

The second step in creating a BSKT is giving it an identity: a name, ticker symbol, description, and logo.

## Name & Ticker

Choose a name and ticker symbol for your BSKT. These will be displayed across the platform: on the Explore page, Leaderboard, and BSKT detail page.

* **Name:** A descriptive name for your basket (e.g., "DeFi Blue Chips")
* **Ticker:** A short symbol, typically 3-6 characters (e.g., "DEFI")

Names are filtered for inappropriate content. Choose something professional and descriptive that helps investors understand your strategy at a glance.

## Description

Write a brief description explaining your basket's investment thesis. What tokens does it focus on? What's the strategy? This appears on the BSKT detail page and helps investors understand your approach.

## Logo

Upload a logo image for your BSKT. This is stored on IPFS (decentralized storage) and displayed alongside your basket across the platform.

A distinctive logo helps your BSKT stand out on the Explore page and builds recognition over time.

## Metadata Storage

Your BSKT's metadata (name, ticker, description, and logo) is stored on IPFS as a JSON document. The IPFS hash is recorded on-chain as the BSKT's `tokenURI`, so the metadata is permanent and decentralized.


# Funding & Deployment

The final step in creating a BSKT is providing the initial capital and deploying the basket on-chain.

## Initial Funding

Enter the amount of ETH you want to seed the basket with. This ETH will be:

1. Split according to your allocation weights
2. Converted into the constituent tokens via DEX swaps
3. Deposited into the new BSKT smart contract

You receive LP tokens representing your initial contribution. This is your personal stake in the basket, not a fee.

### Minimum Deposit

The minimum initial funding is **0.1 ETH**. The basket needs enough liquidity to function from launch.

### Creation Fee

A small creation fee (a percentage of the initial deposit) is charged by the protocol. This fee is displayed clearly before you confirm the transaction.

## Deployment

Once you confirm and sign the transaction in your wallet:

1. The BSKT smart contract is deployed on Ethereum
2. Your ETH is swapped into the basket's tokens
3. LP tokens are minted to your wallet
4. The management NFT is minted to your wallet
5. Your BSKT goes live on the platform

The entire process happens in a single transaction.

## MEV Protection

The deployment process uses the protocol's MEV protection system. Before your transaction goes on-chain, the backend computes optimal swap routes and signs the transaction data. This prevents front-running and sandwich attacks that could result in worse execution prices for your initial swaps.

## After Deployment

Your BSKT is immediately visible on:

* The **Explore** page for all users to discover
* The **Leaderboard** where your performance will be tracked
* Your **Portfolio** under "Created BSKTs"

You can begin managing your basket right away. See [Rebalancing](/fund-managers/rebalancing) and [Manager Overview](/fund-managers/overview) for next steps.


# Manager Overview

A Manager is any wallet that has created a BSKT. As a manager, you have exclusive control over your basket's investment strategy and earn fees on assets under management.

## What Managers Can Do

| Action               | Description                                                         |
| -------------------- | ------------------------------------------------------------------- |
| **Rebalance**        | Change the basket's token allocation at any time                    |
| **Emergency Stable** | Convert the basket entirely to stablecoins in an emergency          |
| **Revert Emergency** | Restore the basket from emergency state to its normal allocation    |
| **Claim Fees**       | Collect accumulated management fees                                 |
| **Update Notes**     | Publish strategy notes visible to investors on the BSKT detail page |

## What Managers Cannot Do

* **Withdraw investor funds:** Only LP token holders can redeem their own share
* **Freeze redemptions:** Investors can always exit
* **Mint additional LP tokens:** LP supply is determined by deposits and redemptions only

This separation of powers ensures the system is non-custodial. Managers control the strategy; investors control their capital.

## Manager Dashboard

Access your management dashboard via the BSKT management page. This is a separate page from the BSKT detail page, accessible only to the manager wallet. You can find a link to it in your Portfolio page and on the BSKT detail page (visible only when your manager wallet is connected). The dashboard provides:

* Current allocation breakdown
* TVL and performance metrics
* Pending fee earnings
* Rebalance and emergency controls
* Manager notes editor

## Management Rights as NFTs

Your manager rights are represented as an ERC-721 NFT. This means:

* Management rights can be transferred to another wallet
* Rights could be sold on the BSKT Marketplace (a secondary market for management positions)
* Whoever holds the management NFT controls the basket

This creates a market for fund management positions. Successful managers with large AUM and strong track records hold a valuable asset.

## Building Your Reputation

The Alvara platform tracks manager performance transparently:

* **Leaderboard ranking** based on performance and AUM
* **Public profile** showing all BSKTs you manage
* **Identity verification** via X (Twitter) OAuth and Gitcoin Passport
* **Performance history** across all your baskets

A strong track record helps attract more investors and can earn you more gauge weight votes (and thus more ALVA rewards for your depositors).


# Rebalancing

Rebalancing allows managers to change their BSKT's token allocation. This is the core tool for executing an investment strategy: rotating into new positions, adjusting weights, or responding to market conditions.

## How Rebalancing Works

Rebalancing is a two-phase process:

### Phase 1: Initialize

The basket's current tokens are sold into an intermediate asset (WETH). This liquidates the existing allocation in preparation for the new one.

### Phase 2: Rebalance

The intermediate WETH is used to purchase the new tokens according to the updated allocation weights. The basket now holds the new portfolio.

Both phases happen as separate on-chain transactions. The manager must complete both phases for the rebalance to finish.

## When to Rebalance

Common reasons to rebalance:

* **Conviction change:** You've identified better opportunities and want to rotate the portfolio
* **Risk management:** Market conditions have changed and you want to reduce exposure to certain assets
* **Weight drift:** Token price movements have caused the actual weights to diverge significantly from your target weights
* **New tokens:** You want to add tokens that weren't in the original allocation

## MEV Protection

Like all BSKT operations, rebalancing is MEV-protected. The protocol's backend computes optimal swap routes and signs the transaction data before it goes on-chain. This prevents front-running and ensures better execution prices for the swaps involved.

## Important Considerations

* **Slippage:** Large rebalances involving low-liquidity tokens may experience slippage. The protocol accounts for this automatically, but be mindful of the size of your swaps relative to available liquidity.
* **Gas costs:** Each rebalance requires gas on whichever network the BSKT is deployed on. More tokens in the basket means more swaps and higher gas costs.
* **Investor impact:** Rebalancing changes the composition of every LP token holder's position. Rebalance thoughtfully and consider publishing manager notes explaining your rationale.
* **Frequency:** There's no limit on how often you can rebalance, but frequent rebalancing incurs gas costs and may erode investor confidence if changes appear erratic.


# Emergency Controls

Managers have access to emergency controls that allow them to quickly de-risk a BSKT in adverse market conditions.

## Emergency Stables

The Emergency Stables function converts the entire basket into approximately 95% USDT and 5% ALVA. The 5% ALVA allocation is retained to ensure the basket continues to hold at least two assets, avoiding single-asset composition which could raise regulatory classification concerns. This is designed for situations where:

* Constituent tokens are experiencing extreme volatility
* A token in the basket has a critical vulnerability
* Market conditions require immediate de-risking

When triggered, the BSKT enters a suspended state where normal operations (deposits, rebalancing) are paused. LP token holders retain their LP tokens, but the underlying assets are now held as stablecoins.

## Revert Emergency

Once conditions stabilize, the manager can revert the emergency and restore the basket to its previous token allocation (or a new one). This re-enables normal operations.

The revert process works similarly to a rebalance: stablecoins are swapped back into the target tokens according to the specified allocation.

## When to Use Emergency Controls

Emergency controls are a last resort. They should be used when:

* **Immediate action is required** and a standard rebalance would be too slow
* **A constituent token is compromised** (exploit, depegging, rug pull)
* **Extreme market conditions** make holding the current allocation dangerously risky

They should **not** be used for routine portfolio adjustments. Use standard rebalancing for that.

## Impact on Investors

* LP tokens remain valid during emergency state
* The basket's value is preserved in stablecoins
* Redemptions may still be available depending on the contract state
* The manager should communicate via manager notes why the emergency was triggered


# Claiming Fees

Managers earn fees on the assets under management in their BSKTs. These fees accrue over time and can be claimed at the manager's discretion.

## How Fees Work

Management fees are collected as additional LP tokens minted at each deposit into the BSKT. The fee is taken from the basket's net asset value (NAV). The fee structure is defined at the protocol level.

Fees accrue with each deposit and are tracked by the smart contract. They do not need to be claimed at any specific interval. Managers can claim whenever they choose.

## How to Claim

1. Navigate to your BSKT's management page
2. View your pending fee earnings
3. Click **Claim Fees**
4. Confirm the transaction in your wallet

Fees are paid out in ETH to your manager wallet.

## MEV Protection

Fee claiming involves converting accrued fees into ETH, which requires token swaps. Like all swap operations in the protocol, this is protected against MEV attacks through the backend signing service.

## Important Notes

* Fees can only be claimed by the wallet holding the management NFT
* There is no minimum claim amount
* Claiming fees does not affect the basket's TVL or LP token value. Fees are tracked separately from investor capital
* If a constituent token has been delisted or is no longer tradeable, the claim process handles this automatically


# Manager Leaderboard

The Manager Leaderboard is a public ranking of all fund managers on the Alvara platform. It provides a transparent, data-driven way for investors to evaluate and compare managers.

## Ranking Criteria

Managers are ranked based on a combination of:

* **Total AUM:** Combined TVL across all BSKTs they manage
* **Performance:** Weighted average returns across their baskets
* **Number of BSKTs:** How many baskets the manager operates
* **Best performer:** Their top-performing BSKT

## Manager Profile

Each manager has a public profile page showing:

* **Wallet address** with optional ENS name
* **Verified identity:** Linked X (Twitter) profile and Gitcoin Passport score
* **All managed BSKTs** with individual performance data
* **Aggregate statistics:** Total AUM, average performance, creation history
* **Activity feed:** Recent management actions across all baskets

## Identity Verification

Managers can optionally verify their identity through:

### X (Twitter) Verification

Link your X account via OAuth to display your social identity alongside your wallet address. This helps investors identify who is behind a BSKT.

### Gitcoin Passport

Connect your Gitcoin Passport to display a humanity score. Higher scores earn tiered badges:

| Score | Badge  |
| ----- | ------ |
| 15+   | Bronze |
| 25+   | Silver |
| 35+   | Gold   |

These verification methods are optional but recommended. Verified managers tend to attract more investor confidence.

## Why the Leaderboard Matters

The leaderboard creates a meritocratic environment where:

* Good managers rise to the top based on real performance data
* Investors can make informed decisions about where to deploy capital
* Track records are permanent and on-chain. They cannot be fabricated
* Gauge weight voters can identify high-performing BSKTs to direct ALVA rewards toward


# Manager Identity

Alvara provides optional identity verification tools that help managers build trust with investors. While all management activity is transparent on-chain, connecting off-chain identity signals helps build credibility.

## X (Twitter) Verification

Link your X account to your Alvara profile:

1. Navigate to your Portfolio page
2. Click the X verification option
3. Complete the OAuth flow to authorize the connection
4. Your X profile name and handle will display on your manager profile

You can unlink your X account at any time from the same interface.

## Gitcoin Passport

Gitcoin Passport is a decentralized identity verification tool. It aggregates multiple identity signals (social accounts, on-chain activity, biometric checks) into a single humanity score.

To connect:

1. Create a Passport at [app.passport.xyz](https://app.passport.xyz)
2. Complete verification stamps to build your score
3. Your score is automatically detected when you use the Alvara platform

### Passport Score Badges

| Score | Badge  | Meaning                        |
| ----- | ------ | ------------------------------ |
| 15+   | Bronze | Basic identity verification    |
| 25+   | Silver | Moderate identity verification |
| 35+   | Gold   | Strong identity verification   |

## Viewing Other Profiles

Any wallet's portfolio and manager profile is publicly viewable. Navigate to `/portfolio/{walletAddress}` to view any address's holdings, managed BSKTs, and identity information.

This transparency is intentional. In a permissionless system, reputation is built through verifiable on-chain actions and optional identity signals.


# What is veALVA?

veALVA (vote-escrowed ALVA) is the governance and rewards token of the Alvara Protocol. You receive veALVA by locking ALVA tokens in the staking contract on Ethereum mainnet.

## Why veALVA Exists

veALVA aligns incentives between token holders and the protocol's long-term health. By requiring users to lock their ALVA to gain governance power, the protocol ensures that those with the most influence are also the most committed.

Short-term speculators who buy ALVA without locking have no voting power. Long-term participants who lock for extended periods gain outsized influence.

## What veALVA Gives You

### Voting Power

veALVA is your voting weight in gauge weight voting. Each epoch, veALVA holders direct ALVA rewards to specific BSKTs. More veALVA means more influence over reward allocation.

### Staking Rewards

Stakers earn ALVA rewards proportional to their lock commitment. Longer locks receive a higher share of the Staking Rewards Vault (measured by SRV percentage).

### DAO Participation

veALVA is required to participate in Alvara DAO governance. Proposals on Snapshot are weighted by veALVA balance.

## How veALVA is Calculated

The amount of veALVA you receive depends on two factors:

1. **How much ALVA** you lock
2. **How long** you lock it for

| Lock Period | veALVA Multiplier |
| ----------- | ----------------- |
| 1 Week      | 0.01x             |
| 1 Month     | 0.05x             |
| 3 Months    | 0.2x              |
| 6 Months    | 0.5x              |
| 12 Months   | 1.0x              |
| 18 Months   | 2.0x              |
| 24 Months   | 4.0x              |
| 36 Months   | 8.0x              |
| 48 Months   | 10.0x             |
| Forever     | 2.0x              |

**Example:** Locking 1,000 ALVA for 12 months gives you 1,000 veALVA. Locking the same amount for 48 months gives you 10,000 , ten times the governance power.

## Key Properties

* **Non-transferable:** veALVA cannot be sent, sold, or traded. It is bound to the wallet that locked the ALVA.
* **Decay (time locks):** For time-based locks, veALVA decays linearly as the lock approaches expiry. At expiry, veALVA reaches zero and the ALVA can be withdrawn.
* **No decay (forever locks):** Forever locks maintain their veALVA balance permanently. The locked ALVA is effectively removed from circulating supply.


# Lock Types

Alvara offers two types of ALVA locks, each with different tradeoffs between flexibility and rewards.

## Time Lock

Lock your ALVA for a fixed duration. When the lock expires, you can withdraw your ALVA.

**Available periods:** 1 Week, 1 Month, 3 Months, 6 Months, 12 Months, 18 Months, 24 Months, 36 Months, 48 Months

### How Time Locks Work

1. Choose a lock period and deposit ALVA
2. Receive veALVA based on the lock multiplier
3. veALVA decays linearly over the lock period
4. When the lock expires, withdraw your ALVA

### veALVA Decay

Time lock veALVA decays as the lock approaches expiry. At the midpoint of a 12-month lock, you have roughly half your initial veALVA. At expiry, your veALVA balance reaches zero.

This decay mechanism creates an ongoing incentive to either:

* **Renew** your lock to reset the veALVA balance
* **Increase** your locked amount to boost veALVA

### Extending and Increasing

You can:

* **Add more ALVA** to an existing time lock, increasing your veALVA
* **Renew** a time lock to reset the duration and restore decayed veALVA

Both actions refresh your veALVA balance based on the new total locked amount and duration.

## Forever Lock

Permanently lock your ALVA. The tokens can never be withdrawn.

### How Forever Locks Work

1. Deposit ALVA into the forever lock pool
2. Receive veALVA at the 2.0x multiplier
3. veALVA never decays. Your governance power is permanent
4. Locked ALVA is permanently removed from circulating supply

### Why Lock Forever?

* **Maximum staking rewards:** Forever locks receive the highest SRV (Staking Rewards Vault) percentage at 50%
* **Permanent governance power:** No decay means your voting power remains constant
* **Deflationary:** Forever-locked ALVA is effectively burned, reducing total circulating supply

### The Tradeoff

Forever locks offer the highest reward rates and permanent governance power, but the locked ALVA can never be recovered. Consider this carefully before committing.

## Staking Rewards Vault (SRV) Rates

The SRV determines what share of the staking reward pool you're eligible for:

| Lock Period | SRV Rate |
| ----------- | -------- |
| 1 Week      | 0%       |
| 1 Month     | 0%       |
| 3 Months    | 0.5%     |
| 6 Months    | 1.25%    |
| 12 Months   | 2.75%    |
| 18 Months   | 4.5%     |
| 24 Months   | 8.5%     |
| 36 Months   | 12.5%    |
| 48 Months   | 20%      |
| Forever     | 50%      |

Note: 1-week and 1-month locks do not earn staking rewards. So only meaningful commitments are rewarded.

## Choosing the Right Lock

| Priority                          | Recommended Lock              |
| --------------------------------- | ----------------------------- |
| Maximum rewards + governance      | Forever                       |
| Strong rewards with eventual exit | 24-48 Months                  |
| Moderate commitment               | 6-18 Months                   |
| Short-term voting participation   | 3-6 Months                    |
| Testing the system                | 1 Week / 1 Month (no rewards) |


# How to Stake

Staking ALVA tokens earns you veALVA governance power and staking rewards. All staking happens on Ethereum mainnet.

## Prerequisites

* ALVA tokens on Ethereum mainnet
* ETH on Ethereum mainnet for gas fees
* A connected Web3 wallet

## Staking Steps

### 1. Navigate to the Lock Page

Go to the **Lock** page in the navigation bar.

### 2. Choose Your Lock Type

Select either the **Time Lock** or **Forever Lock** tab.

### 3. Configure Your Lock

**For Time Locks:**

* Select a lock duration from the available periods
* Enter the amount of ALVA to lock
* Review the veALVA you'll receive and the SRV rate

**For Forever Locks:**

* Enter the amount of ALVA to lock
* Review the veALVA you'll receive
* Understand that this is permanent and irreversible

### 4. Approve & Confirm

* First, approve the staking contract to spend your ALVA (one-time per amount increase)
* Then confirm the staking transaction
* Wait for the transaction to be confirmed on Ethereum mainnet

### 5. Verify

Once confirmed, your veALVA balance will update. You can see your lock details, veALVA balance, and staking history on the Lock page.

## Managing an Existing Lock

### Add More ALVA

Increase your locked amount by depositing additional ALVA into an existing lock. This increases your veALVA balance.

### Renew a Time Lock

Extend your lock duration to reset veALVA decay. Your veALVA is recalculated based on the total locked amount and the new duration.

### Withdraw (Time Locks Only)

Once a time lock expires, a **Withdraw** option becomes available. Withdrawing returns your ALVA and reduces your veALVA to zero.

## Network Requirement

Staking requires your wallet to be connected to **Ethereum mainnet**. If you're on a different network (e.g., Base), the app will prompt you to switch before proceeding.

## Real-Time Notifications

The app provides real-time notifications for all staking events (stake, increase, renew, withdraw, claim, compound) so you can track the status of your transactions.


# Staking Rewards

Stakers earn ALVA rewards proportional to their lock commitment. The longer and larger your lock, the greater your share of the reward pool.

Staking rewards are funded by ALVA bought back from a percentage of platform fees. Previously, the Staking Rewards Vault was subsidized by the Alvara Foundation with ALVA allocations, but going forward all rewards come from protocol fee buybacks.

## How Rewards Accrue

Staking rewards are distributed continuously based on your SRV (Staking Rewards Vault) rate. Your SRV rate is determined by your lock period:

* Short locks (1 week, 1 month) earn **no staking rewards**
* Medium locks (3-12 months) earn **moderate rewards**
* Long locks (24-48 months) earn **significant rewards**
* Forever locks earn the **maximum reward rate** at 50% SRV

Rewards accumulate automatically. You don't need to take any action for them to accrue.

## Claiming Rewards

1. Navigate to the **Lock** page
2. View your pending reward balance
3. Click **Claim Rewards**
4. Confirm the transaction in your wallet

Claimed ALVA is sent directly to your wallet.

## Compounding Rewards

Instead of claiming ALVA to your wallet, you can compound your rewards directly into your existing lock:

1. Navigate to the **Lock** page
2. Click **Compound Rewards**
3. Choose whether to compound into your time lock or forever lock
4. Confirm the transaction

Compounding increases your locked ALVA amount, which in turn increases your veALVA balance and future rewards. This creates a compounding effect over time.

## Reward Eligibility

Not all locks are eligible for staking rewards:

| Lock Period | Reward Eligible |
| ----------- | --------------- |
| 1 Week      | No              |
| 1 Month     | No              |
| 3 Months+   | Yes             |
| Forever     | Yes             |

Short locks (under 3 months) provide veALVA governance power but do not earn staking rewards. So the reward pool goes to stakers with real protocol commitment.


# How the DAO Works

The Alvara DAO is the decentralized governance body of the protocol. It is governed by veALVA holders who participate in gauge weight voting, directing ALVA rewards to BSKTs each epoch.

## Governance Model

Alvara's governance includes a **gauge weight voting** mechanism, similar to protocols like Curve and Balancer. As well as voting on individual proposals for protocol changes, veALVA holders vote on how to allocate reward emissions across BSKTs.

This creates a feedback loop:

1. **Managers** create high-performing BSKTs to attract gauge weight votes
2. **Voters** direct rewards to BSKTs they believe in
3. **Depositors** in rewarded BSKTs earn additional ALVA
4. **More capital** flows into well-performing BSKTs

## Voting Power

Your voting power equals your veALVA balance. More veALVA means more influence over reward allocation.

* veALVA is earned by locking ALVA (see [What is veALVA?](/staking-and-vealva/what-is-vealva))
* No minimum veALVA is required to vote
* Each veALVA equals one vote
* Voting power is proportional. If you hold 1% of all veALVA, you control 1% of the gauge weight allocation

## Proposals

For protocol-level governance decisions (beyond gauge weight voting):

* **Viewing**: Anyone can view proposals on [Snapshot](https://snapshot.org/#/s:bskt.eth)
* **Creating**: Requires 3,000 veALVA minimum
* **Voting**: No minimum veALVA required
* **Pass threshold**: 51% of votes cast, with a 20% quorum of total veALVA

## Where Governance Happens

| Activity             | Platform                                             |
| -------------------- | ---------------------------------------------------- |
| Gauge weight voting  | Alvara app (DAO page)                                |
| Governance proposals | [Snapshot](https://snapshot.org/#/s:bskt.eth)        |
| Discussion & debate  | [Governance Forum](https://governance.alvara.xyz/)   |
| Community chat       | [Discord](https://discord.com/invite/alvaraprotocol) |


# Gauge Weight Voting

Gauge weight voting is a core governance mechanism of the Alvara DAO. Each epoch, veALVA holders vote to direct ALVA reward emissions toward specific BSKTs.

## How It Works

1. An epoch begins (typically one week)
2. veALVA holders cast their votes, allocating their voting weight across BSKTs
3. At the end of the epoch, votes are tallied
4. ALVA rewards for the next period are distributed proportionally based on the vote results

BSKTs that receive more votes earn a larger share of the reward pool. This reward flows to the depositors (LP holders) of those BSKTs.

## Why It Matters

Gauge weight voting is the mechanism that connects governance to capital allocation:

* **For investors:** BSKTs with more gauge weight earn more ALVA rewards, making them more attractive to deposit into
* **For managers:** Attracting gauge weight votes increases the rewards for their depositors, which in turn attracts more capital (higher TVL)
* **For voters:** Directing rewards to well-performing BSKTs supports the ecosystem and rewards effective capital allocation

## Viewing Voting Results

The **Gauge Weight** tab on the DAO page displays:

* **Vote distribution:** A visual breakdown of how votes were allocated across BSKTs for any epoch
* **Results table:** Token-by-token breakdown showing vote counts and percentages
* **Epoch history:** Navigate between past epochs to see how voting patterns have evolved

## Voting Strategy

When deciding where to direct your gauge weight:

* **Performance:** BSKTs with strong track records may attract more capital and benefit the ecosystem
* **Manager quality:** Consider the manager's track record, identity verification, and communication
* **Ecosystem value:** Some BSKTs may align with broader protocol goals or fill gaps in the ecosystem
* **Self-interest:** If you hold LP tokens in a BSKT, voting for it increases the ALVA rewards you receive as a depositor


# Epochs

An epoch is a recurring governance cycle in the Alvara DAO. Each epoch represents one round of gauge weight voting and reward distribution.

## Epoch Cycle

1. **Voting period:** veALVA holders cast gauge weight votes via Snapshot
2. **Tallying:** Votes are counted at the end of the epoch
3. **Reward allocation:** ALVA rewards are calculated based on voting results
4. **Distribution:** Rewards become claimable for eligible participants
5. **Next epoch begins:** The cycle repeats

## Epoch Duration

Epochs typically run for one week, though this can be adjusted through governance.

## Epoch History

The DAO page on the Alvara app shows the complete history of all epochs. You can:

* View vote distributions for any past epoch
* Compare how voting patterns have changed over time
* See which BSKTs have consistently attracted the most votes
* Track your own voting and reward history

## Rewards Per Epoch

Each epoch distributes a set amount of ALVA rewards. The total reward per epoch is determined by the protocol's emission schedule. These rewards are split among BSKTs based on gauge weight vote results.

Rewards become claimable after the epoch ends. See [Claiming DAO Rewards](/dao-governance/claiming-dao-rewards).


# Claiming DAO Rewards

After each epoch, eligible veALVA holders can claim ALVA rewards based on their voting participation. Claims are processed on Ethereum mainnet.

## How Claims Work

DAO rewards use a **merkle proof** system:

1. At the end of each epoch, the protocol computes reward amounts for each eligible address
2. A merkle tree is generated and its root is published on-chain
3. Each eligible address receives a merkle proof that can be used to claim their ALVA

This system is gas-efficient. It allows batch reward distribution without requiring individual on-chain transactions for each recipient.

## How to Claim

1. Navigate to the **DAO** page in the app
2. Select the **Claim Rewards** tab
3. Ensure your wallet is connected and on **Ethereum mainnet**
4. You'll see a list of epochs with pending rewards and the ALVA amount for each
5. Click **Claim** on any individual epoch, or use **Claim All** to batch-claim all pending rewards
6. Confirm the transaction in your wallet

## Batch Claiming

If you have rewards from multiple epochs, you can claim them all in a single transaction using the **Claim All Rewards** button. This saves gas compared to claiming each epoch individually.

## Network Requirement

DAO reward claims happen on **Ethereum mainnet**. If your wallet is connected to a different network, the app will prompt you to switch before you can claim.

## Checking Your Rewards

The Claim Rewards tab shows:

* **Per-epoch breakdown:** Reward amount for each epoch
* **Total pending:** Sum of all unclaimed rewards
* **Claim status:** Whether each epoch's rewards have been claimed

The **My DAO Profile** tab (available when your wallet is connected) provides a summary of your total unclaimed DAO rewards alongside your veALVA balance and voting power.

## Important Notes

* You must have participated in gauge weight voting during an epoch to be eligible for that epoch's rewards
* Claims do not expire. You can claim rewards from past epochs at any time
* Claimed ALVA is sent directly to your wallet on Ethereum mainnet


# Token Overview

ALVA is the native utility token of the Alvara Protocol. It serves as the foundation for governance, staking, and the BSKT ecosystem.

## Core Functions

### 1. Governance

Lock ALVA to receive veALVA, the protocol's governance token. veALVA holders vote in gauge weight elections each epoch, directing ALVA rewards to BSKTs. veALVA is also used for Snapshot governance proposals.

### 2. BSKT Fee Reduction

Including ALVA in a BSKT's allocation unlocks reduced platform fees. On Ethereum, a minimum ALVA percentage is currently required. With the upcoming Base deployment, this becomes a variable parameter — including ALVA is incentivized through fee reductions rather than being mandatory.

### 3. Staking Rewards

Stakers earn ALVA rewards proportional to their lock duration and amount. Rewards are funded by ALVA bought back from a percentage of platform fees. The reward system incentivizes long-term commitment to the protocol.

## Token Properties

| Property       | Detail                                                      |
| -------------- | ----------------------------------------------------------- |
| Standard       | ERC-20                                                      |
| Maximum Supply | Fixed cap (not mintable beyond max supply)                  |
| Burnable       | Yes, forever-locked ALVA is effectively removed from supply |
| Inflationary   | No, supply is capped and deflationary via burning/locking   |

## Multi-Chain Availability

ALVA is available on multiple chains:

* **Ethereum Mainnet:** BSKT Lab, staking platform, governance, and DAO reward claims
* **Base:** ALVA trading and DEX liquidity available; BSKT Lab deployment planned Q1 2026
* **Avalanche:** ALVA trading and DEX liquidity available

ALVA can be bridged between Ethereum, Base and Avalanche via cross-chain bridges (Axelar / Squidrouter). DEX liquidity for ALVA is available on each supported chain. Your total ALVA balance across all chains is displayed in your Portfolio.

## Deflationary Mechanics

ALVA has multiple deflationary forces:

1. **Forever locks:** ALVA locked permanently in the staking contract is removed from circulating supply
2. **BSKT allocation:** ALVA locked inside BSKTs reduces available supply
3. **Fixed cap:** No additional ALVA can be minted beyond the maximum supply

Over time, the effective circulating supply decreases as more ALVA is locked in staking contracts and BSKTs.


# Tokenomics

ALVA has a fixed maximum supply of **200,000,000 tokens**. No additional tokens can be minted.

## Key Figures

| Metric                   | Value            |
| ------------------------ | ---------------- |
| Total Supply             | 200,000,000 ALVA |
| Listing Price            | $0.30            |
| Fully Diluted Market Cap | $60,000,000      |
| Target Raise             | $6,175,000       |
| Unlocked at Listing      | 12,000,000 (6%)  |
| Market Cap at TGE        | $3,600,000       |

## Allocation

| Distribution                 | %        | Tokens          | Token Price | Total Raise    |
| ---------------------------- | -------- | --------------- | ----------- | -------------- |
| Stage 1 - Seed Round         | 4.0%     | 8,000,000       | $0.150      | $1.2M          |
| Stage 2 - Private Round      | 4.0%     | 8,000,000       | $0.200      | $1.6M          |
| Stage 3 - Strategic Partners | 2.0%     | 4,000,000       | $0.244      | $975K          |
| Stage 4 - Public Round       | 4.0%     | 8,000,000       | $0.300      | $2.4M          |
| Stage 6 - Airdrop            | 2.0%     | 4,000,000       | $0.300      | -              |
| Team & Contributors          | 15.0%    | 30,000,000      | -           | -              |
| Grants & Builder Rewards     | 5.0%     | 10,000,000      | -           | -              |
| Foundation                   | 10.0%    | 20,000,000      | -           | -              |
| Affiliate & Marketing        | 5.0%     | 10,000,000      | -           | -              |
| DEX/CEX Liquidity            | 5.0%     | 10,000,000      | -           | -              |
| BSKT Incentives              | 44.0%    | 88,000,000      | -           | -              |
| **Total**                    | **100%** | **200,000,000** |             | **$6,175,000** |

## Vesting Schedule

| Distribution                 | Cliff (Months) | Vesting (Months) | Unlock at TGE |
| ---------------------------- | -------------- | ---------------- | ------------- |
| Stage 1 - Seed Round         | 6              | 24               | 0%            |
| Stage 2 - Private Round      | 3              | 18               | 0%            |
| Stage 3 - Strategic Partners | 3              | 14               | 0%            |
| Stage 4 - Public Round       | 0              | 4                | 25%           |
| Stage 6 - Airdrop            | 1              | 1                | 0%            |
| Team & Contributors          | 12             | 33               | 0%            |
| Grants & Builder Rewards     | DAO            | DAO              | 0%            |
| Foundation                   | 6              | 12               | 0%            |
| Affiliate & Marketing        | 1              | 12               | 0%            |
| DEX/CEX Liquidity            | 0              | 0                | 100%          |
| BSKT Incentives              | DAO            | 372              | 0%            |

## TGE Circulating Supply

| Source                            | Tokens         |
| --------------------------------- | -------------- |
| Public Round (25% TGE unlock)     | 2,000,000      |
| DEX/CEX Liquidity (100% unlocked) | 10,000,000     |
| **Total**                         | **12,000,000** |

All other allocations, including Strategic Partners, were fully locked at TGE with their respective cliff and vesting schedules.

## Value Accrual

ALVA captures value through several mechanisms:

### BSKT Demand

On Ethereum, every BSKT currently includes a minimum ALVA allocation. Including ALVA in a BSKT's allocation unlocks reduced platform fees, incentivizing organic demand for the token that scales with protocol adoption. With the upcoming Base deployment, the ALVA allocation becomes a variable parameter rather than a strict requirement.

### Staking Lock-Up

ALVA locked in staking contracts (especially forever locks) permanently removes tokens from circulation. As more participants stake, the effective circulating supply decreases.

### Gauge Weight Incentives

The gauge weight voting system incentivizes ALVA acquisition and staking. Users who want to influence reward allocation must hold veALVA, which requires locking ALVA.

## Token Utility Flow

```
ALVA → Lock → veALVA → Vote on Gauge Weights → Direct Rewards to BSKTs
                  ↓
            Earn Staking Rewards (ALVA)
                  ↓
            Compound or Claim
```

This creates a cycle:

1. Lock ALVA to earn veALVA
2. Use veALVA to vote and earn rewards
3. Compound rewards back into the lock
4. Increased veALVA earns more rewards


# ERC-7621 Standard

ERC-7621 is the Basket Token , a new Ethereum token standard that enables the creation and management of tokenized investment portfolios on-chain. It is the technical foundation on which all BSKTs are built.

## What is ERC-7621?

ERC-7621 defines a standard interface for basket tokens: composite tokens that represent a weighted collection of underlying ERC-20 tokens. It is a smart contract standard for on-chain index funds.

The standard was proposed by the Alvara Protocol team and is documented as an Ethereum Improvement Proposal (EIP).

**EIP Reference:** [EIP-7621](https://eips.ethereum.org/EIPS/eip-7621)

## Why a New Standard?

Before ERC-7621, creating a tokenized portfolio on-chain required custom smart contracts, bespoke logic, and significant development effort. There was no standardized way to:

* Represent a basket of tokens as a single tradeable unit
* Define and enforce token weightings
* Handle deposits, redemptions, and rebalancing in a consistent way
* Represent management rights as transferable assets

ERC-7621 solves these problems by providing a standard interface that any protocol can implement.

## Key Capabilities

### Portfolio Representation

Each ERC-7621 token represents a basket of underlying ERC-20 tokens with defined weights. The token's value is derived from the sum of its constituent assets.

### Manager Rights

ERC-7621 includes the concept of a , a privileged address that can modify the basket's allocation. Management rights are represented as an NFT, making them transferable and tradeable.

### Deposit & Redemption

The standard defines how users can deposit capital into a basket (receiving LP tokens) and redeem LP tokens for underlying assets.

### Rebalancing

Managers can update the basket's token allocation through a standardized rebalancing interface.

## Cross-Chain Potential

ERC-7621 is an EVM standard, meaning it can be deployed on any EVM-compatible blockchain. Alvara currently operates on Ethereum mainnet, with Base deployment planned for Q1 2026. The standard itself is chain-agnostic and is designed to support multi-chain baskets in the future (see the Development Roadmap in the White Paper).

## Building on ERC-7621

The ERC-7621 standard is publicly documented as an EIP. Developers interested in the standard can review the specification at the link above. As the protocol moves toward open-source, additional developer resources will be published.


# MCP Server Overview

The Alvara MCP Server lets AI assistants such as Claude, ChatGPT, and Cursor read data from the Alvara protocol and prepare basket transactions on a user's behalf. It is open source, self-hostable, and non-custodial.

## What MCP Is

Model Context Protocol (MCP) is an open standard created by Anthropic for connecting AI assistants to external tools and data. An MCP server exposes a set of tools; any MCP-compatible client can call those tools during a conversation. The Alvara MCP Server exposes seventeen tools covering the full basket lifecycle.

Because MCP is an open standard, one integration reaches every client that supports it. Users can bring their preferred assistant rather than being locked to a specific AI platform.

## What It Enables

With the Alvara MCP Server connected, an AI assistant can:

* Discover baskets, fetch current composition, and summarise performance
* Read price history, TVL, NAV, and activity for any basket
* Surface a user's portfolio positions across the platform
* Build contribute, redeem, and rebalance transactions
* Run pre-flight safety checks before any transaction is signed
* Authenticate the user through their existing wallet

The assistant does the reasoning. The MCP server provides the structured interface to Alvara.

## Non-Custodial by Design

The server never holds private keys. Write operations return unsigned transaction data and a server signature. The user's wallet signs and submits the transaction on-chain. The server is stateless and cannot move funds on its own.

This model keeps control with the user. An AI assistant can prepare a rebalance, but the user must approve it in their wallet before anything happens on-chain.

## Architecture

```
AI assistant + user's wallet
          |
          | MCP protocol (stdio)
          v
Alvara MCP Server (runs locally)
          |
          | HTTPS
          v
    Alvara REST API
          |
          v
User signs and submits transaction on Ethereum or Base
```

The server is a thin translation layer. Reads go through the public Alvara API. Writes return transaction data for the user to sign. No database, no custodial infrastructure, no dependency on Alvara hosting anything beyond the existing public API.

## Networks

Alvara is live on both Ethereum mainnet and Base. The MCP server supports either. Point `ALVARA_API_URL` at the endpoint for the chain you want to work with.

| Network          | API endpoint                  |
| ---------------- | ----------------------------- |
| Ethereum mainnet | `https://web1-api.alvara.xyz` |
| Base             | `https://base-api.alvara.xyz` |

See [Connecting Your AI](/agents-and-mcp/connecting) for configuration.

## Who This Is For

* **End users** who want to interact with Alvara baskets through a conversational interface
* **Power users** who want to build personal automations across their portfolio
* **Developers** who want to create agents that manage baskets for others
* **Strategy builders** who want to construct autonomous fund management systems on top of Alvara

## Open Source

The server is MIT licensed and available on GitHub. Any developer can clone the repository and run their own instance. No approval, no whitelist, no API keys to request for public endpoints.

## Getting Started

See [Connecting Your AI](/agents-and-mcp/connecting) for setup instructions with Claude Desktop, Cursor, and other MCP clients.


# Connecting Your AI

Instructions for connecting the Alvara MCP Server to common AI clients.

## Prerequisites

* Node.js 20 or later
* An MCP-compatible client (Claude Desktop, Cursor, Continue, etc.)
* A wallet on Ethereum mainnet or Base for write operations

## Install the Server

Clone the repository and build:

```bash
git clone https://github.com/Alvara-Protocol/alvara-mcp.git
cd alvara-mcp
npm install
npm run build
```

The compiled server lives at `dist/index.js`.

## Claude Desktop

Open your Claude Desktop config file.

* **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

Add the Alvara server:

```json
{
  "mcpServers": {
    "alvara": {
      "command": "node",
      "args": ["/absolute/path/to/alvara-mcp/dist/index.js"],
      "env": {
        "ALVARA_API_URL": "https://web1-api.alvara.xyz"
      }
    }
  }
}
```

Set `ALVARA_API_URL` to the endpoint for the chain you want to work with (see the table below). Restart Claude Desktop after editing. The Alvara tools appear in the tools menu.

## Cursor

Edit `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "alvara": {
      "command": "node",
      "args": ["/absolute/path/to/alvara-mcp/dist/index.js"]
    }
  }
}
```

## Other MCP Clients

Any client supporting stdio transport can connect. Point it at `node /path/to/dist/index.js`. The server reads environment variables from the process, so set them in the client config.

## Environment Variables

| Variable         | Required | Description                                                                                               |
| ---------------- | -------- | --------------------------------------------------------------------------------------------------------- |
| `ALVARA_API_URL` | Yes      | API base URL. Set to `https://web1-api.alvara.xyz` for Ethereum or `https://base-api.alvara.xyz` for Base |
| `ALVARA_JWT`     | No       | Pre-authenticated session token. If unset, read-only tools still work                                     |

### Switching networks

The MCP server talks to one API at a time, determined by `ALVARA_API_URL`. If you want to work with both Ethereum and Base from the same AI client, run two copies of the server under different names:

```json
{
  "mcpServers": {
    "alvara-eth": {
      "command": "node",
      "args": ["/absolute/path/to/alvara-mcp/dist/index.js"],
      "env": { "ALVARA_API_URL": "https://web1-api.alvara.xyz" }
    },
    "alvara-base": {
      "command": "node",
      "args": ["/absolute/path/to/alvara-mcp/dist/index.js"],
      "env": { "ALVARA_API_URL": "https://base-api.alvara.xyz" }
    }
  }
}
```

## Authenticating

Some tools require authentication with an Alvara session token. The authentication flow is wallet-based:

1. The assistant calls `alvara_get_nonce` with your wallet address
2. You sign the returned nonce in your wallet
3. You paste the signature back into the conversation
4. The assistant calls `alvara_authenticate` with the signature
5. The session token is stored in the server process for the duration of the session

The session token expires after two hours. If you have an existing token from another session, set it as the `ALVARA_JWT` environment variable to skip the signing step.

## Verifying the Connection

Ask the assistant:

> List the top five Alvara baskets by TVL.

If the server is connected, the assistant calls `alvara_list_baskets` and returns a formatted list. If nothing happens, check that the path in your config is absolute and points to the compiled `dist/index.js`.

## Next Steps

* Review the full [Tool Reference](/agents-and-mcp/tool-reference) for everything the assistant can do
* See [Example Prompts](/agents-and-mcp/example-prompts) for ideas on what to ask


# Tool Reference

Complete list of tools exposed by the Alvara MCP Server, grouped by purpose.

## Authentication

Used to obtain a session token for authenticated endpoints.

### `alvara_get_nonce`

Generates a signing nonce tied to a wallet address. The user must sign this nonce with their wallet before calling `alvara_authenticate`. Nonces expire after five minutes.

### `alvara_authenticate`

Exchanges a wallet signature for a session token. The token is stored in the server process and used automatically for subsequent calls. Expires after two hours.

## Observation

Read-only tools for discovering baskets, checking state, and analysing performance.

### Public (no authentication required)

| Tool                  | Purpose                                                                         |
| --------------------- | ------------------------------------------------------------------------------- |
| `alvara_list_baskets` | Paginated list of all baskets, searchable and sortable                          |
| `alvara_get_basket`   | Full detail for one basket: constituents, weights, TVL, price, performance      |
| `alvara_get_nav`      | Current NAV and TVL for a basket, or total platform TVL                         |
| `alvara_get_activity` | Transaction history for a basket: deposits, redemptions, rebalances, fee claims |
| `alvara_get_ohlcv`    | Candlestick price history with configurable intervals                           |
| `alvara_get_fees`     | Platform fee configuration                                                      |

### Authenticated

| Tool                   | Purpose                                                          |
| ---------------------- | ---------------------------------------------------------------- |
| `alvara_get_tokens`    | Available ERC-20 tokens for basket creation and rebalancing      |
| `alvara_get_trending`  | Trending baskets by volume and performance                       |
| `alvara_get_manager`   | Fund manager profile and their baskets                           |
| `alvara_get_portfolio` | A user's basket positions: open, closed, created, or contributed |

## Intent

Tools that prepare on-chain transactions. Each returns unsigned transaction data and a server signature. The user's wallet signs and submits the transaction.

All intent tools require authentication.

### `alvara_rebalance_liquidate`

Phase 1 of a rebalance. Liquidates the basket's current constituents to WETH. Call this first, then call `alvara_rebalance_acquire` after the transaction confirms.

### `alvara_rebalance_acquire`

Phase 2 of a rebalance. Swaps WETH into the new target allocation. Must be called after `alvara_rebalance_liquidate` has been submitted on-chain.

### `alvara_emergency_rebalance`

Liquidates the basket into safe assets (ALVA and USDC). Requires explicit confirmation via a `confirm=true` parameter to prevent accidental triggers. Use only in genuine emergencies.

### `alvara_contribute`

Prepares a deposit of ETH into a basket. The ETH is swapped into the basket's constituents according to current weights.

### `alvara_redeem`

Prepares a withdrawal of LP tokens from a basket. The basket's tokens are swapped back to ETH for the user.

## Advisory

Optional safety checks that run before any transaction.

### `alvara_check_rebalance`

Pre-flight checks for a proposed rebalance. Surfaces warnings for:

* **Concentration:** single-token weights above 50% (warning) or 80% (critical)
* **Weight sum:** weights that do not sum to 10000 basis points
* **Turnover:** portfolio turnover above 80% (high swap costs)
* **Slippage:** tolerance above 2% (warning) or 5% (critical)
* **Low TVL:** baskets where gas costs may exceed the rebalance benefit

Warnings are advisory. The agent decides whether to proceed.

## Return Format

All tools return JSON. Errors are returned as MCP error responses with a human-readable message. The assistant surfaces these to the user.

Reads return the raw API response. Intent tools return a subset of the API response containing the fields a wallet needs to sign and submit the transaction: `swapData`, `signature`, `deadline`, `tokenAddresses`, `tokenWeights`.

## Rate Limits

Public endpoints follow the Alvara API's standard rate limits. Authenticated endpoints are scoped to the session token.


# Example Prompts

Once your AI client is connected to the Alvara MCP Server, you can ask it to do anything the tools support. These examples show the kinds of requests that work well.

## Discovery

> List the top ten Alvara baskets by TVL and summarise what each one holds.

> Show me baskets with more than 50% exposure to ETH and a 24-hour performance above 5%.

> Which Alvara managers have the best 30-day performance?

## Analysis

> What is the current composition of basket 69b853736e181528926f81ca? Include constituent weights and recent price changes.

> Pull the 30-day OHLCV for this basket and summarise the trend. Is the price range tightening or widening?

> Compare the performance of basket A and basket B over the last 7 days. Which had higher volatility?

## Portfolio

> Show me all baskets I have contributed to and my current position in each. Address: 0x...

> What is my total P\&L across open Alvara positions?

> List the baskets I have created and their fee earnings so far.

## Planning a Rebalance

> I want to rebalance my basket to 60% ETH and 40% USDC with 0.5% slippage tolerance. Run the safety checks first and show me any warnings before we proceed.

> This basket is currently 80% in one token. Propose a more diversified allocation and explain the trade-offs.

> What would a rebalance cost me in gas and slippage if I rotate this basket into a momentum-weighted allocation?

## Executing a Rebalance

Once you are ready to rebalance, the assistant calls the intent tools in sequence:

> Good, the warnings look fine. Build the liquidation transaction.

The assistant returns the transaction data. You sign it in your wallet and submit it. After it confirms:

> The liquidation transaction confirmed. Now build the acquisition phase with the allocation we discussed.

## Contribute and Redeem

> I want to contribute 0.1 ETH to basket 69b853736e181528926f81ca with 0.5% slippage. Prepare the transaction.

> Redeem 50% of my LP tokens from this basket. Show me what I will receive before I sign.

## Strategy Conversations

> Based on the last 30 days of price action across my Alvara baskets, which positions should I consider rebalancing?

> I am running a momentum strategy. Review my current baskets and suggest rotations based on 14-day returns.

> Monitor this basket's drift from my target weights and tell me when it exceeds 5%.

## Tips for Good Prompts

* Be specific about slippage and size when asking for transactions
* Ask the assistant to run `alvara_check_rebalance` before executing a rebalance
* Provide wallet addresses when asking about portfolios
* Use basket IDs (the 24-character hex strings) for precision; names work but are ambiguous

## What the Assistant Cannot Do

* Sign or submit transactions on your behalf. Every write goes through your wallet.
* Move funds without your explicit approval in your wallet.
* Access private keys or seed phrases.
* See anything about your wallet beyond what you share in the conversation.

The assistant is a planning and execution assistant. You remain in control of every on-chain action.


# Smart Contract Audits

Alvara Protocol's smart contracts have been independently audited by three security firms: CertiK, QuillAudits, and Adevar Labs.

## Completed Audits

### CertiK — Staking & BSKT Contracts

Full security assessment of the staking platform and BSKT core contracts, covering BSKT.sol, Factory.sol, and BSKTPair.sol. Methods included formal verification, manual review, and static analysis.

**Auditor:** [CertiK](https://www.certik.com/) **Date:** June 12, 2025 **Scope:** Staking, BSKT Factory, BSKT, BSKTPair (EVM Compatible) **Findings:** 18 total — 14 resolved, 4 acknowledged. 1 critical (resolved), 2 major (1 resolved, 1 acknowledged), 4 medium (all resolved), 8 minor (6 resolved, 2 acknowledged), 2 informational (all resolved). **Report:** [CertiK Audit Report (PDF)](https://github.com/Alvara-Protocol/Docs/blob/main/Alvara%20Protocol%20Security%20Assessment%20-%20CertiK.pdf)

### QuillAudits — BSKT Factory & BSKT Contracts

The core BSKT creation and management contracts have been audited. This covers the factory contract, basket token logic, deposit/redemption mechanics, and rebalancing functionality.

**Auditor:** [QuillAudits](https://www.quillaudits.com/) **Report:** [BSKT Factory Audit Report (PDF)](https://github.com/Alvara-Protocol/Docs/blob/main/Alvara%20BTS%20+%20Factory%20Smart%20Contracts%20Audit%20Report%20-%20QuillAudits.pdf)

### QuillAudits — Staking Contract

The ALVA staking contract (time locks, forever locks, veALVA calculation, reward distribution) has been audited.

**Auditor:** [QuillAudits](https://www.quillaudits.com/) **Report:** [Staking Audit Report (PDF)](https://github.com/Alvara-Protocol/Docs/blob/main/Alvara%20Staking%20Smart%20Contract%20Audit%20Report%20-%20QuillAudits.pdf)

### QuillAudits — ALVA Token (Avalanche)

The ALVA token deployment on Avalanche C-Chain has been audited.

**Auditor:** [QuillAudits](https://www.quillaudits.com/) **Report:** [ALVA Token AVAX Audit Report (PDF)](https://github.com/Alvara-Protocol/Docs/blob/main/Alvara%20Token%20-%20AVAX%20Smart%20Contract%20Audit%20Report%20-%20QuillAudits%20.pdf)

### Adevar Labs — 1inch Integration (After Fix Review)

Security assessment focused on the 1inch swap integration, covering BSKT.sol, Factory.sol, BSKTPair.sol, and BSKTUtils.sol. Reviewed partial-fill handling, LP token accounting, fee calculation logic, and ETH recovery mechanisms.

**Auditor:** [Adevar Labs](https://www.adevar.io/) **Date:** January 29, 2026 **Scope:** 1inch integration — BSKT, Factory, BSKTPair, BSKTUtils contracts **Findings:** 6 total — 3 high (2 resolved, 1 partially resolved), 2 medium (2 partially resolved), 1 low (resolved). 2 enhancement opportunities noted. **Report:** [Adevar Labs 1inch Integration Audit Report (PDF)](https://github.com/Alvara-Protocol/Docs/blob/main/Alvara%201inch%20Integration%20Audit%20Report%20-%20Adevar%20Labs.pdf)

## Audit Scope

The audits collectively cover:

* Smart contract logic and correctness
* Access control and permission models
* Reentrancy and common vulnerability checks
* Flashloan and price manipulation vectors
* Economic attack vectors (inflation, reserve manipulation)
* Centralization risks
* Gas optimization

## Important Note

Audits reduce risk but do not eliminate it. Smart contracts are complex software and may contain undiscovered vulnerabilities. All interactions with Alvara Protocol carry inherent smart contract risk. See [Risk Disclosures](/security/risk-disclosures) for more information.


# MEV Protection

All token swap operations in the Alvara Protocol are protected against MEV (Maximal Extractable Value) attacks.

## What is MEV?

MEV refers to the profit that can be extracted by reordering, inserting, or censoring transactions within a block. Common MEV attacks include:

* **Front-running:** An attacker sees your pending swap and places their own transaction before yours, moving the price against you
* **Sandwich attacks:** An attacker places transactions both before and after yours, profiting from the price movement they create
* **Back-running:** An attacker places a transaction immediately after yours to capture arbitrage opportunities

These attacks can result in worse execution prices for your transactions.

## How Alvara Protects You

Alvara uses a backend signing service to protect against MEV:

1. When you initiate a swap operation (deposit, redeem, rebalance, etc.), the transaction details are sent to the protocol's backend
2. The backend computes the optimal swap route
3. The backend signs the transaction data with a deadline
4. The signed transaction is submitted on-chain with MEV protection

This process happens automatically. You don't need to take any action or configure anything.

## Protected Operations

The following operations involve token swaps and are MEV-protected:

| Operation        | Description                                     |
| ---------------- | ----------------------------------------------- |
| BSKT creation    | Initial ETH → token swaps                       |
| Deposits         | ETH → basket token swaps                        |
| ETH redemptions  | Basket tokens → ETH swaps                       |
| Rebalancing      | Selling old tokens, buying new tokens           |
| Fee claiming     | Converting fee tokens to ETH                    |
| Emergency stable | Converting to stablecoins                       |
| Revert emergency | Converting stablecoins back to portfolio tokens |

**Note:** Redeeming for underlying tokens (instead of ETH) does not involve swaps and therefore does not require MEV protection.

## Deadlines

Every signed transaction includes a deadline. If the transaction isn't confirmed on-chain within the deadline window, it reverts. This prevents stale transactions from executing at outdated prices.


# Risk Disclosures

Interacting with Alvara Protocol involves multiple types of risk. This page outlines the key risks you should understand before using the platform.

## Smart Contract Risk

All DeFi protocols rely on smart contracts (code deployed on the blockchain). Despite audits and testing, smart contracts may contain undiscovered vulnerabilities that could result in loss of funds. Alvara Protocol's smart contracts have been independently audited by CertiK, QuillAudits, and Adevar Labs. Audit scope varies by component and deployment; see the [Audits](/security/audits) page for full report details. Audits reduce risk without eliminating it.

## Market Risk

The value of tokens held in BSKTs fluctuates with market conditions. A BSKT's value can decrease if the underlying tokens lose value. Past performance does not guarantee future results.

## Manager Risk

BSKT managers control the allocation of basket assets. Poor management decisions, such as rebalancing into underperforming tokens or failing to respond to market events, can result in losses for LP token holders. Evaluate a manager's track record carefully before investing.

## Liquidity Risk

Some tokens within a BSKT may have limited liquidity. This can cause slippage during deposits, redemptions, or rebalancing. In extreme cases, a constituent token may become illiquid, making it difficult to exit a position at fair value.

## Regulatory Risk

Regulation around DeFi and cryptocurrency is evolving. Changes in laws or regulations in your jurisdiction may affect your ability to use the platform or the value of tokens you hold.

## Bridge and Multi-Chain Risk

ALVA exists on multiple chains. Cross-chain interactions involve bridge protocols, which carry their own set of risks including bridge exploits and delayed transactions.

## Impermanent Loss

Providing liquidity to BSKTs involves exposure to the relative price movements of the basket's constituent tokens. Significant divergence in token prices can result in impermanent loss compared to simply holding the tokens directly.

## Protocol Risk

As with any decentralized protocol, risks include:

* Governance attacks if voting power becomes concentrated
* Economic exploits targeting the reward or fee mechanisms
* Dependencies on external services (oracles, DEX routers, RPCs)

## Mitigation

While risks cannot be eliminated, you can mitigate them by:

* Diversifying across multiple BSKTs and protocols
* Researching managers and their track records
* Starting with small positions to understand the mechanics
* Monitoring your positions regularly
* Understanding the lock terms before staking (especially forever locks)

**This information is for educational purposes only and does not constitute financial advice. You are solely responsible for your own investment decisions.**


# Whitepaper

The Alvara Protocol White Paper covers the technical architecture, token economics, protocol design, and long-term vision for ERC-7621 and the BSKT ecosystem.

## Download

{% file src="/files/BGchYVzgVNd6dDH5wXsX" %}
English (PDF)
{% endfile %}

{% file src="/files/YXRH0e1sn4emX2Pta8CQ" %}
中文简体 / Chinese (PDF)
{% endfile %}

{% file src="/files/0l68nInjZVlEtesh93C8" %}
한국어 / Korean (PDF)
{% endfile %}

{% file src="/files/Z01KsHDb3XElCf0YHlKt" %}
日本語 / Japanese (PDF)
{% endfile %}

{% file src="/files/DQHz7WPXaH7i7Q4sFzNE" %}
Русский / Russian (PDF)
{% endfile %}

{% file src="/files/gw7Ozt17s4vkevDoInAB" %}
Türkçe / Turkish (PDF)
{% endfile %}

{% file src="/files/h3VCyWQeXADYw6ddFOZS" %}
Tiếng Việt / Vietnamese (PDF)
{% endfile %}

{% file src="/files/DUxpII9jKDbhjz0u2eix" %}
Português / Portuguese (PDF)
{% endfile %}

{% file src="/files/qJh8NywNTLUu03Q1x9i0" %}
Español / Spanish (PDF)
{% endfile %}

## Summary

The whitepaper covers:

* **ERC-7621 Standard**: Design rationale, architecture, and interface specification for the basket token standard
* **Protocol Architecture**: Smart contract structure, factory pattern, and composability model
* **Tokenomics**: ALVA token distribution, vesting schedules, and value accrual mechanisms
* **Governance**: DAO structure, gauge-weight voting, and epoch-based reward distribution
* **Security Model**: Audit strategy, MEV protection, and risk management framework

## Related Resources

* [Tokenomics](/alva-token/tokenomics)
* [ERC-7621 Standard](/alva-token/erc-7621)
* [Smart Contract Audits](/security/audits)


# Tokenomics Overview

A visual overview of the ALVA token allocation, vesting schedule, and key figures.

## Download

{% file src="/files/miASVJG6wBEYV7onD5Fx" %}
Alvara Tokenomics Overview (SVG)
{% endfile %}

## Highlights

* **Total Supply:** 200,000,000 ALVA (fixed, no additional minting)
* **Listing Price:** $0.30
* **Fully Diluted Market Cap:** $60,000,000
* **Market Cap at TGE:** $750,000
* **Unlocked at Listing:** 12,500,000 (6.25%)
* **Target Raise:** $6,175,000

## Related Resources

* [Tokenomics Detail](/alva-token/tokenomics)
* [Whitepaper](/resources/whitepaper)
* [Token Overview](/alva-token/overview)


# Brand Kit

Official Alvara Protocol brand assets for media, partners, and integrations.

## Brand Guide

The complete brand guidelines covering strategy, logo usage, colour palette, typography, iconography, and graphic assets.

{% file src="/files/3D9kmYMqlBIiZ0A5DeWR" %}
Alvara Brand Guide (PDF)
{% endfile %}

## Logo Pack

Alvara and BSKT logos in SVG and PNG formats — colour, monochrome, light and dark variants.

{% file src="/files/ipqcuWFfXCoggRjSeUtf" %}
Alvara Logo Pack (ZIP)
{% endfile %}

## Usage Guidelines

* Do not modify the logos or change the brand colours
* Maintain clear space around logos
* Use the appropriate logo variant for light and dark backgrounds
* Refer to the Brand Guide for detailed usage rules

## Full Brand Assets

For the complete brand kit including imagery, patterns, icons, banners, and font files, contact the team:

* [Discord](https://discord.gg/alvara)
* [Telegram](https://t.me/alvaraprotocol)


# FAQ

## General

**What is Alvara Protocol?** Alvara is a decentralized asset management platform where anyone can create, manage, and invest in tokenized investment portfolios (BSKTs) on-chain. It combines permissionless fund creation with gauge weight governance to create an open, competitive fund management ecosystem.

**Do I need to sign up or create an account?** No. Alvara is a decentralized application. You only need a Web3 wallet (MetaMask, Coinbase Wallet, etc.) to interact with the platform. No email, KYC, or registration required.

**Which chains does Alvara support?** BSKTs, staking, and DAO governance all operate on Ethereum mainnet. Base support is planned for Q1 2026. ALVA is also available on Avalanche.

***

## BSKTs

**What is a BSKT?** A BSKT is a tokenized portfolio of ERC-20 tokens, built on the ERC-7621 standard. It functions like an on-chain index fund or ETF, managed by a single wallet address.

**Can I lose money investing in a BSKT?** Yes. BSKTs hold volatile crypto assets whose value can decrease. The manager's allocation decisions may not always perform well. Only invest what you can afford to lose.

**Can the manager steal my funds?** No. BSKTs are non-custodial. The manager can change the basket's token allocation (rebalance), but cannot withdraw investor funds. Only you can redeem your LP tokens.

**Can I withdraw at any time?** Yes. There are no lock-up periods for BSKT investments. You can redeem your LP tokens for ETH or underlying tokens at any time.

**Why do BSKTs include ALVA?** On Ethereum, BSKTs currently require a minimum ALVA allocation, which connects every basket to the Alvara ecosystem and creates organic demand for the token. With the upcoming Base deployment, including ALVA becomes optional but incentivized through reduced platform fees.

***

## Creating & Managing BSKTs

**How much does it cost to create a BSKT?** The minimum seed capital is 0.1 ETH, plus a small creation fee (percentage of the deposit) and Ethereum gas fees.

**Can I manage multiple BSKTs?** Yes. There is no limit on the number of BSKTs a single wallet can create and manage.

**Can I transfer management rights?** Yes. Management rights are represented as an NFT and can be transferred to another wallet.

***

## Staking & veALVA

**What is veALVA?** veALVA (vote-escrowed ALVA) is the governance token earned by locking ALVA. It provides voting power in gauge weight elections and earns staking rewards.

**Can I unlock my staked ALVA early?** For time locks: No. You must wait until the lock period expires to withdraw. For forever locks: No. Forever locks are permanent and irreversible.

**Does veALVA decay?** For time locks, yes, veALVA decays linearly as the lock approaches expiry. For forever locks, no, veALVA is permanent.

**Which locks earn staking rewards?** Locks of 3 months or longer earn staking rewards. 1-week and 1-month locks provide veALVA governance power but no staking rewards.

**Can I add more ALVA to an existing lock?** Yes. You can increase the locked amount at any time, which increases your veALVA balance.

***

## DAO & Governance

**How does gauge weight voting work?** Each epoch, veALVA holders vote to allocate ALVA rewards across BSKTs. BSKTs that receive more votes earn a larger share of rewards, which flow to their depositors.

**How often are epochs?** Typically one week per epoch.

**How do I claim DAO rewards?** Navigate to the DAO page in the app, select the Claim Rewards tab, and claim per-epoch or batch-claim all pending rewards. Claims happen on Ethereum mainnet.

**Do I need a minimum veALVA to vote?** No minimum is required to vote. However, creating governance proposals requires more than 2,000 veALVA.

***

## Security

**Have the contracts been audited?** Yes. Alvara Protocol's smart contracts have been independently audited by CertiK, QuillAudits, and Adevar Labs. Audit scope varies by component and deployment; see the [Audits](/security/audits) page for full report details.

**What is MEV protection?** MEV protection prevents front-running and sandwich attacks on your transactions. All swap operations in Alvara are MEV-protected automatically.


# Glossary

**ALVA** The native ERC-20 utility token of the Alvara Protocol. Used for governance (via veALVA staking), BSKT fee reduction, and staking rewards.

**AUM (Assets Under Management)** The total value of assets managed by a specific manager across all their BSKTs.

**BSKT (Basket Token)** A tokenized investment portfolio built on the ERC-7621 standard. Each BSKT holds a collection of ERC-20 tokens in defined proportions.

**BSKT Lab** The interface for creating new BSKTs. A three-step process: Compose (select tokens), Design (name and brand), Fund (seed and deploy).

**Epoch** A recurring governance cycle (typically one week) during which veALVA holders cast gauge weight votes. At the end of each epoch, rewards are calculated and distributed.

**ERC-7621** The Basket Token , an Ethereum Improvement Proposal defining how tokenized investment portfolios can be implemented as smart contracts.

**Forever Lock** A permanent ALVA staking option where tokens can never be withdrawn. Provides a 2.0x veALVA multiplier and 50% SRV rate. Effectively burns the locked ALVA.

**Gauge Weight Voting** The governance mechanism by which veALVA holders direct ALVA reward emissions to specific BSKTs each epoch.

**LP Token (Liquidity Provider Token)** A token representing proportional ownership of a BSKT's underlying assets. Received when depositing into a BSKT, redeemable for ETH or underlying tokens.

**Manager** The wallet address that created a BSKT. Has exclusive control over the basket's allocation (rebalancing) and earns management fees.

**Management NFT** An ERC-721 token representing management rights over a BSKT. Whoever holds this NFT controls the basket. Can be transferred or sold.

**Merkle Proof** A cryptographic proof used to verify eligibility for DAO reward claims without storing all claim data on-chain. Enables gas-efficient batch reward distribution.

**MEV (Maximal Extractable Value)** Profit extracted by reordering or inserting transactions within a block. Common MEV attacks include front-running and sandwich attacks. Alvara protects against MEV through its backend signing service.

**Rebalancing** The process by which a manager changes a BSKT's token allocation. Involves selling existing tokens and purchasing new ones according to updated weights.

**SRV (Staking Rewards Vault)** A percentage that determines a staker's share of the staking reward pool. Higher SRV rates are earned by longer lock periods.

**Time Lock** A temporary ALVA staking option where tokens are locked for a fixed period (1 week to 48 months). veALVA decays linearly until expiry, at which point the ALVA can be withdrawn.

**TVL (Total Value Locked)** The total USD value of all assets held within a BSKT or across the protocol.

**veALVA (Vote-Escrowed ALVA)** The non-transferable governance token received by locking ALVA. Used for gauge weight voting and qualifying for staking rewards. Amount determined by lock size and duration.

**Xerberus Risk Rating** A third-party credit-style risk rating system (AAA to D) that evaluates the risk profile of individual tokens within BSKTs.


# Community & Links

## Official Channels

| Platform    | Link                                                                           | Purpose                                |
| ----------- | ------------------------------------------------------------------------------ | -------------------------------------- |
| Discord     | [discord.com/invite/alvaraprotocol](https://discord.com/invite/alvaraprotocol) | Community chat, support, announcements |
| Telegram    | [t.me/alvaraprotocol](https://t.me/alvaraprotocol)                             | Community discussions                  |
| X (Twitter) | [@AlvaraProtocol](https://x.com/AlvaraProtocol)                                | News, updates, announcements           |

## Governance

| Platform         | Link                                                           | Purpose                        |
| ---------------- | -------------------------------------------------------------- | ------------------------------ |
| Governance Forum | [governance.alvara.xyz](https://governance.alvara.xyz)         | Proposal discussion and debate |
| Snapshot         | [snapshot.org/#/s:bskt.eth](https://snapshot.org/#/s:bskt.eth) | On-chain governance voting     |

## Resources

| Resource      | Link                                                                       |
| ------------- | -------------------------------------------------------------------------- |
| App           | [app.alvara.xyz](https://app.alvara.xyz)                                   |
| Website       | [alvara.xyz](https://alvara.xyz)                                           |
| DAO           | [dao.alvara.xyz](https://dao.alvara.xyz)                                   |
| Medium Blog   | [alvaraprotocol.medium.com](https://alvaraprotocol.medium.com/)            |
| Bug Bounty    | [alvara.xyz/bug-bounty](https://alvara.xyz/bug-bounty)                     |
| White Paper   | [docs.alvara.xyz/resources/whitepaper](/resources/whitepaper)              |
| Audit Reports | [GitHub Repository](https://github.com/Alvara-Protocol/Docs)               |
| ERC-7621 EIP  | [eips.ethereum.org/EIPS/eip-7621](https://eips.ethereum.org/EIPS/eip-7621) |
| Contact       | <contact@alvara.xyz>                                                       |

## Getting Help

* **General questions**: Ask in Discord or Telegram
* **Bug reports**: Report in Discord
* **Governance proposals**: Start a discussion on the Governance Forum before submitting to Snapshot
* **Security issues**: Contact the team directly via Discord (do not disclose publicly)


# Privacy Policy

*Last updated: March 2026*

## Overview

Alvara Protocol ("we", "us", "our") is committed to protecting user privacy. This policy explains what data we collect, how we use it, and your rights.

## What We Collect

### On-Chain Data

All interactions with Alvara Protocol smart contracts are recorded on public blockchains. This includes wallet addresses, transaction amounts, and contract interactions. This data is inherently public and not controlled by us.

### Website Analytics

Our website may collect anonymous usage data including:

* Pages visited and time spent
* Browser type and device information
* Referring URLs
* Country-level geographic data

We do not use cookies for tracking. Any analytics are privacy-preserving and do not collect personally identifiable information.

### Support & Communication

If you contact us through our support channels, we may collect:

* Your email address
* The content of your communications
* Any information you voluntarily provide

## What We Do Not Collect

* We do not collect personal identity information through the protocol
* We do not require KYC for protocol interactions
* We do not track individual wallet activity beyond what is publicly available on-chain
* We do not sell, share, or rent personal data to third parties

## Third-Party Services

Our website and dApp may integrate third-party services (e.g. RPC providers, analytics, wallet connectors). These services operate under their own privacy policies. We encourage users to review the privacy practices of any third-party tools they interact with.

## Data Retention

We retain support communications for as long as necessary to resolve issues and improve our services. Anonymous analytics data may be retained indefinitely in aggregate form.

## Your Rights

You may:

* Request information about data we hold related to you
* Request deletion of any personal data we hold
* Opt out of analytics tracking by using browser privacy tools

## Changes to This Policy

We may update this policy from time to time. Changes will be reflected on this page with an updated date.

## Contact

For privacy-related enquiries, reach us through:

* [Discord](https://discord.gg/alvara)
* [Telegram](https://t.me/alvaraprotocol)


# Disclaimer

## General Notice

This documentation is provided for informational purposes only. Nothing contained herein constitutes financial, investment, legal, or tax advice. You should consult your own professional advisors before making any financial decisions.

## No Investment Advice

Alvara Protocol and its contributors do not endorse, recommend, or advise buying, selling, or holding any cryptocurrency, token, or digital asset. Any information provided about tokens, yields, rewards, or returns is purely informational and should not be interpreted as investment advice or a guarantee of future performance.

## Risk Acknowledgment

Interaction with Alvara Protocol involves significant risks including but not limited to:

* **Smart contract risk:** Loss of funds due to software vulnerabilities
* **Market risk:** Volatility and potential total loss of token value
* **Regulatory risk:** Changes in laws that may affect token legality or platform access
* **Manager risk:** Poor allocation decisions by BSKT managers
* **Liquidity risk:** Inability to exit positions at fair value
* **Technology risk:** Network congestion, failed transactions, or protocol downtime

Users assume full responsibility for evaluating these risks before interacting with the protocol.

## No Warranties

The protocol, documentation, and all associated services are provided "as is" without warranty of any kind, express or implied. The Alvara Protocol team makes no representations or warranties regarding the accuracy, completeness, or reliability of any information provided.

## Token Classification

ALVA is a utility token. It is not intended to be, and should not be construed as, a security, investment contract, or any form of regulated financial instrument. ALVA provides functional utility within the Alvara ecosystem as described in this documentation.

## Jurisdictional Compliance

Users are solely responsible for ensuring that their use of Alvara Protocol complies with all applicable laws and regulations in their jurisdiction. The platform enforces regional compliance measures, and access may be restricted in certain jurisdictions.

## Due Diligence

Participants should perform their own research and due diligence before interacting with the protocol, investing in BSKTs, staking tokens, or participating in governance. Past performance of BSKTs or managers is not indicative of future results.

## Limitation of Liability

To the maximum extent permitted by applicable law, the Alvara Protocol team, its contributors, and affiliates shall not be liable for any direct, indirect, incidental, special, consequential, or exemplary damages arising from the use of the protocol or reliance on this documentation.


