Skip to content

Atharva ReFi is a Solana-based regenerative finance protocol that enables non-custodial SOL staking with transparent, on-chain yield streaming to verified conservation organizations.

Notifications You must be signed in to change notification settings

devwraithe/atharva-refi

Repository files navigation

Atharva ReFi Protocol

Stake SOL. Earn yields. Fund conservation. All on-chain.

Solana Anchor Status


What is Atharva ReFi?

Atharva ReFi turns your SOL into a force for conservation; without giving up your capital.

Stake SOL into species-specific pools (like Ranthambore Tigers). Your SOL earns mSOL yields through Marinade Finance. You keep 80% of yields and can withdraw anytime. The other 20% automatically streams to verified conservation organizations—transparently, continuously, on-chain.

No donations. No intermediaries. No trust required. Just verifiable impact.


How It Works

For Supporters

Simple steps:

  1. Choose a species pool (e.g., Ranthambore Tigers)
  2. Stake SOL through the protocol
  3. Receive ARFI LP tokens (proof of your stake)
  4. Earn mSOL yields—80% yours, 20% streams to conservation
  5. Withdraw whenever you want

Example: Stake 10 SOL at 6.5% APY

  • You keep: 0.52 mSOL/year (80%)
  • Conservation: 0.13 mSOL/year (20%, auto-streamed)

For Conservation Organizations

  1. Submit application with verification documents
  2. Get approved and receive your dedicated pool
  3. Your verified wallet receives continuous yield streams
  4. All funding is publicly auditable on Solana Explorer

Key Features

Feature What It Means
Non-Custodial You control your funds, always
Auto-Streaming Conservation funding happens automatically
Transparent Every transaction visible on-chain
No Lock-ups Withdraw anytime, no penalties
Liquid Staking Your SOL earns yield via Marinade
Verifiable Impact Track exactly where your yields go

Architecture

Scoped MVP

An end-to-end view of the Atharva ReFi protocol, showing how supporter SOL deposits flow through staking, yield generation, and automated on-chain distribution to verified conservation organizations.

Scoped MVP

Admin Creates Pool For Organization

The onboarding and verification flow for conservation organizations, where an admin creates a species-specific pool, initializes program-derived accounts, and links a verified organization treasury to receive yield.

Pool Creation

Supporter Deposits And Stakes SOL

The deposit lifecycle for supporters, illustrating how SOL is deposited into a pool vault, staked via Marinade to generate mSOL, and how LP tokens are minted to represent the supporter’s proportional ownership.

Supporter Deposit

Auto-Stream Yields To Organization

The automated yield realization and distribution process, where staking rewards are periodically calculated, 20% is streamed on-chain to the organization’s verified wallet, and the remaining 80% accrues to supporters.

Yield Streaming


Tech Stack

  • Solana
  • Rust
  • Anchor Framework
  • Marinade Finance (Liquid Staking)
  • MagicBlock (Stream Automation)

Getting Started

Quick Setup

# Clone and install
git clone https://github.com/yourusername/atharva-refi.git
cd atharva-refi
npm install

# Build the program
anchor build

# Run tests
anchor test

Local Development

# Start local Solana validator
solana-test-validator

# Deploy to localnet
anchor deploy

# Run tests against localnet
anchor test --skip-local-validator

Project Structure

atharva-refi/
├── programs/
│   └── atharva-refi/            # Anchor program
│       ├── src/
│       │   ├── lib.rs           # Program entry point
│       │   ├── constants.rs     # Global constants
│       │   ├── errors.rs        # Custom program error definitions
│       │   ├── events.rs        # Anchor events for indexing & analytics
│       │   ├── utilities.rs     # Shared helpers and validation logic
│       │   ├── marinade/        # Marinade Finance CPI helpers
│       │   ├── instructions/    # Instruction handlers (deposit, withdraw, stream)
│       │   └── state/           # Account structs (Pool)
├── tests/                       # Anchor integration tests
├── app/                         # Frontend (coming soon)
└── docs/                        # Documentation & architecture diagrams

Documentation

Resource Purpose
User Stories Real-world usage scenarios
Letter of Intent Project vision and mission
Architecture Diagrams Technical system design

Security

⚠️ This is an MVP under active development. Not audited. Do not use with real funds.

Known Issues

Priority Issue Mitigation Plan
🔴 Critical Hardcoded admin pubkey Moving to multisig config
🟠 High Reentrancy protection Implementing CEI pattern
🟠 High Organization wallet validation Adding withdrawal constraints
🟡 Medium Input validation Adding comprehensive checks

Contributing

We welcome contributions from developers, conservationists, and anyone passionate about transparent impact.

How to Contribute

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

🌿 Building transparent conservation finance, one stake at a time

About

Atharva ReFi is a Solana-based regenerative finance protocol that enables non-custodial SOL staking with transparent, on-chain yield streaming to verified conservation organizations.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published