OTORI Vision Dashboard

A Next.js application for managing and tracking the OTORI Vision Token (OVT), a transparent and efficient on-chain VC fund.

Features

• Real-time NAV (Net Asset Value) tracking and visualization
• Bitcoin wallet integration for buying and selling OVT
• Portfolio performance monitoring
• Transparent fund management

Prerequisites

• Node.js 16.x or later
• npm 7.x or later
• A Bitcoin wallet (e.g., Xverse, Unisat, or Leather)
• Rust and Cargo
• Linux environment (tested on Manjaro)
• Access to Bitcoin network (regtest for development)
• Arch Network CLI tools

Development Environment Setup

1. System Dependencies

# For Manjaro/Arch Linux
sudo pacman -S base-devel clang llvm rocksdb snappy zlib bzip2

2. Bitcoin Core Setup

# Install Bitcoin Core
sudo pacman -S bitcoin

# Create Bitcoin configuration
mkdir -p ~/.bitcoin
echo "regtest=1
server=1
rpcuser=bitcoin
rpcpassword=bitcoinpass
rpcallowip=0.0.0.0/0
rpcbind=0.0.0.0" > ~/.bitcoin/bitcoin.conf

# Start Bitcoin daemon in regtest mode
bitcoind -regtest -daemon

3. Electrs Setup

# Create directory for Arch tools
mkdir -p ~/Coding/arch-tools
cd ~/Coding/arch-tools

# Clone and build Electrs
git clone https://github.com/Arch-Network/electrs.git
cd electrs
cargo build --release

4. Arch Validator Setup

# Create project directory
mkdir -p ~/Coding/OTORI-Vision-Testnet
cd ~/Coding/OTORI-Vision-Testnet

# Initialize validator directory
mkdir -p .arch-validator

Running the Development Environment

1. Start Bitcoin Core (if not already running):

bitcoind -regtest -daemon -rpcuser=bitcoin -rpcpassword=bitcoinpass -rpcallowip=0.0.0.0/0 -rpcbind=0.0.0.0 -server=1

2. Run Electrs (in a separate terminal):

cd ~/Coding/arch-tools/electrs
cargo run --release --bin electrs -- -vvvv --daemon-dir ~/.bitcoin --network regtest --cookie bitcoin:bitcoinpass --main-loop-delay 0

3. Start Arch validator (in another terminal):

cd ~/Coding/OTORI-Vision-Testnet
arch-cli validator-start

4. Start the frontend development server:

npm run dev

Development Approaches

Option 1: Frontend with Mocked Backend

1. Configure mock environment:

# Copy the example env file
cp .env.local.example .env.local

# Update with mock values for development
NEXT_PUBLIC_PROGRAM_ID=mock_program_id
NEXT_PUBLIC_TREASURY_ADDRESS=mock_treasury_address
NEXT_PUBLIC_ARCH_ENDPOINT=http://localhost:8000
NEXT_PUBLIC_MOCK_MODE=true

2. Run the development server:

npm run dev

Option 2: Full Stack Development

Requirements:

• Running Bitcoin Core in regtest mode
• Running Electrs indexer
• Running Arch validator
• Hardware wallet for treasury management (production only)

Project Structure

ovt-fund/               # Next.js frontend application
├── components/         # React components
├── pages/             # Next.js pages
├── public/            # Static assets
├── src/
│   ├── hooks/         # Custom React hooks
│   ├── lib/           # Utility functions and clients
│   └── utils/         # Helper functions
├── styles/            # CSS styles
└── types/             # TypeScript type definitions

ovt-program/           # Rust program for Arch Network
├── src/
│   ├── lib.rs         # Main program logic
│   ├── client.rs      # Arch Network program client
│   ├── runes_client.rs # Bitcoin Runes protocol client
│   └── error.rs       # Error definitions
└── tests/             # Integration tests

docs/                  # Project documentation
└── BACKLOG.md         # Development backlog

Stopping the Development Environment

1. Stop Bitcoin Core:

bitcoin-cli -regtest stop

2. Stop Electrs and Arch validator:

• Use Ctrl+C in their respective terminals

Contributing

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

License

This project is licensed under the MIT License - see the LICENSE file for details.