Cross-Platform Installation Guide¶

Overview¶

Add a brief overview of this document here.

Table of Contents¶

Section 1
Section 2

Anya now supports cross-platform installation using Dart SDK, making it easier to deploy and run on any operating system.

Prerequisites¶

Windows¶

## Install Chocolatey (if not installed)
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

## Install Dart SDK
choco install dart-sdk -y

macOS¶

## Install using Homebrew
brew tap dart-lang/dart
brew install dart

Linux (Ubuntu/Debian)¶

## Add Google's apt repository
sudo apt-get update
sudo apt-get install apt-transport-https
wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor -o /usr/share/keyrings/dart.gpg
echo 'deb [signed-by=/usr/share/keyrings/dart.gpg arch=amd64] https://storage.googleapis.com/download.dartlang.org/linux/debian stable main' | sudo tee /etc/apt/sources.list.d/dart_stable.list

## Install Dart SDK
sudo apt-get update
sudo apt-get install dart

Installing Anya¶

Once Dart SDK is installed, you can install Anya using:

dart pub global activate anya

Verifying Installation¶

Verify your installation:

anya --version

Configuration¶

Create a new Anya project:

anya init my_project
cd my_project

Configure your Bitcoin network settings in config.yaml:

network:
  type: mainnet  # or testnet
  rpc_url: "http://localhost:8332"
  rpc_user: "your_username"
  rpc_password: "your_password"

web5:
  enabled: true
  did_method: "key"  # or "ion"

Running Anya¶

Start the Anya service:

anya serve

Development Setup¶

For development, you'll need additional tools:

## Install development dependencies
dart pub get

## Run tests
dart test

## Build for production
dart compile exe bin/anya.dart

Troubleshooting¶

Common Issues¶

Dart SDK not found

# Add Dart to PATH
export PATH="$PATH:/usr/lib/dart/bin"  # Linux
# or
refreshenv  # Windows (after Chocolatey installation)

Permission Issues

# Linux/macOS
sudo chown -R $(whoami) ~/.pub-cache

Network Configuration

# Test Bitcoin RPC connection
anya test-connection

Next Steps¶

Last updated: 2025-06-02