Avalon Real World Asset Platform

A Next.js-based platform for tokenizing and trading real-world assets on the Solana blockchain.

Prerequisites

• Node.js 18+ or 20+
• pnpm 10.10.0 or higher
• Solana CLI (optional, for Solana program development)
• Docker (optional, for containerized deployment)

Installation

Clone the repository and install dependencies:

pnpm install

Environment Configuration

Copy the example environment file and configure as needed:

cp .env.local.example .env.local

Required Environment Variables

Edit .env.local with your configuration:

# Solana Network Configuration
NEXT_PUBLIC_SOLANA_NETWORK=devnet          # Options: devnet, testnet, mainnet-beta
NEXT_PUBLIC_SOLANA_RPC_ENDPOINT=https://api.devnet.solana.com

# Optional Analytics
NEXT_PUBLIC_GA_MEASUREMENT_ID=             # Google Analytics
NEXT_PUBLIC_CLARITY_PROJECT_ID=            # Microsoft Clarity

Development

Run the development server:

pnpm dev

Open http://localhost:3000 in your browser.

Development on Custom Host

To run the dev server on a specific IP address:

pnpm host

This will start the server on 192.168.100.7 (configured in package.json).

Build

Build the application for production:

pnpm build

Start the production server:

pnpm start

Linting

Run ESLint to check code quality:

pnpm lint

Docker Deployment

Build and run using Docker:

# Build the image
docker build -t avalon-platform .

# Run the container
docker-compose up -d

Solana Program Development

The project includes an Anchor-based Solana program in the solana_program/ directory.

Setup Solana Development Environment

1. Start a local validator:

solana-test-validator --reset

2. Navigate to the Solana program directory:

cd solana_program

3. Install dependencies:

yarn install

4. Run tests:

anchor test

Deploying the Program

View and manage program buffers:

solana program show --buffers
solana program close --buffers

For more details, see solana_program/README.md.

Tech Stack

• Next.js 14
• React 18
• TypeScript
• Tailwind CSS
• Chakra UI
• Redux Toolkit
• Solana Web3.js
• Anchor Framework
• Chart.js