Installation

System Requirements

Node.js

Version 20 or higher

Package Manager

pnpm (recommended) or npm

Database

Supabase account

Wallet

Cronos Testnet with CRO and USDC

Installation Steps

Clone Repository

git clone https://github.com/winsznx/relaycore.git
cd relaycore

Install Dependencies

Using pnpm (recommended):

pnpm install

Or using npm:

npm install

Environment Configuration

Copy the example environment file:

cp .env.example .env

Edit .env with your credentials:

# Supabase
VITE_SUPABASE_URL=https://your-project.supabase.co
VITE_SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key

# WalletConnect
VITE_WALLETCONNECT_PROJECT_ID=your-project-id

# Wallet Keys
WALLET_PRIVATE_KEY=your-private-key
RELAY_PRIVATE_KEY=your-relay-wallet-key

# Contracts
ESCROW_CONTRACT_ADDRESS=0x9D340a67ddD4Fcf5eC590b7B67e1fE8d020F7D61

# Cronos
VITE_CRONOS_RPC_URL=https://evm-t3.cronos.org
CRONOS_RPC_URL=https://evm-t3.cronos.org

# USDC Token
VITE_USDCE_CONTRACT=0x...

# x402
VITE_X402_FACILITATOR_URL=https://facilitator.cronos.org

Database Setup

Run migrations in order:

pnpm db:migrate

Or manually execute SQL files:

supabase/migrations/001_relay_core_schema.sql
supabase/migrations/002_complete_schema.sql
supabase/migrations/012_escrow_sessions.sql
supabase/migrations/013_rwa_settlement.sql
supabase/migrations/20260119_rwa_state_machine.sql
supabase/migrations/20260122_fix_schema_gaps.sql

Start Services

Open three terminal windows:Terminal 1 - Frontend

pnpm dev

Runs on http://localhost:5173Terminal 2 - GraphQL API

pnpm dev:graphql

Runs on http://localhost:4000Terminal 3 - Indexers

pnpm dev:indexers

Background cron jobs

MCP Server (Optional)

cd mcp-server
npm install
npm run build
npm run dev

Verification

Frontend
GraphQL
Database

Navigate to http://localhost:5173You should see the Relay Core dashboard. Connect your wallet to verify integration.

Navigate to http://localhost:4000/graphqlGraphQL Playground should load. Try this query:

query {
  services(limit: 5) {
    id
    name
    category
  }
}

Troubleshooting

Port Already in Use

If port 5173 or 4000 is already in use:

# Kill process on port 5173
lsof -ti:5173 | xargs kill -9

# Kill process on port 4000
lsof -ti:4000 | xargs kill -9

Database Connection Failed

Verify Supabase credentials in .env:

Check VITE_SUPABASE_URL matches your project URL
Verify VITE_SUPABASE_ANON_KEY is correct
Ensure Row Level Security policies are configured

Wallet Connection Issues

Ensure you’re on Cronos Testnet (Chain ID 338)
Verify VITE_WALLETCONNECT_PROJECT_ID is set
Check browser console for errors

Build Errors

Clear cache and reinstall:

rm -rf node_modules pnpm-lock.yaml
pnpm install
pnpm build

Getting Started

Core Concepts

Guides

Smart Contracts

CLI Reference

Deployment

System Requirements

Node.js

Package Manager

Database

Wallet

Installation Steps

Verification

Troubleshooting

Next Steps

Quick Start

Environment Variables

​System Requirements

Node.js

Package Manager

Database

Wallet

​Installation Steps

​Verification

​Troubleshooting

​Next Steps

Quick Start

Environment Variables

System Requirements

Installation Steps

Verification

Troubleshooting

Next Steps