Quick Start

Get Frontier Pulse running locally in under 5 minutes.

Prerequisites

•Node.js 20+ (LTS recommended)
•npm 10+ (comes with Node.js)
•Git
•Sui CLI (optional, for smart contract deployment)

Installation

Terminal

# Clone the repository
git clone https://github.com/EzraNahumury/Frontier-Pulse.git
cd frontier-pulse

# Install frontend dependencies
cd fe_frontierpulse
npm install

# Install oracle backend dependencies
cd ../oracle_backend
npm install

Environment Variables

The oracle backend requires a .env file. Copy the example and configure:

oracle_backend/.env

# Sui Network
SUI_NETWORK=testnet
SUI_PRIVATE_KEY=your_private_key_here

# Smart Contract IDs (already deployed)
PACKAGE_ID=0x661842e6994fa10da8182c752711dd313895f8cf0dcc94eba6764beb6f43bbc9
PULSE_REGISTRY_ID=0x945f1d589bae9c60e95b99c0f02a7fffb814db3772cb16467e5c683ea0bd32c4
ADMIN_CAP_ID=0x2adb35c6ececb66b28fd178d246d3ef1b4f8c65fa5a3a7583192df91605da797
ORACLE_CAP_ID=           # Set after running npm run oracle:init

# EVE Frontier
WORLD_API_BASE=https://world-api-stillness.live.tech.evefrontier.com

# Scheduling
CRON_SCHEDULE=*/10 * * * *   # Every 10 minutes
BATCH_SIZE=50                # Systems per transaction batch
MAX_SYSTEMS_PER_CYCLE=500    # Max systems processed per cycle

Private Key

Never commit your SUI_PRIVATE_KEY to version control. The oracle wallet needs SUI tokens for gas on testnet.

The frontend uses hardcoded constants and does not require a .env file:

Constant	File	Value
World API Base	`lib/worldApi.ts`	`https://world-api-stillness.live.tech.evefrontier.com`
Sui RPC URL	`lib/suiReader.ts`	`https://fullnode.testnet.sui.io:443`
PulseRegistry ID	`lib/suiReader.ts`	`0x945f...32c4`

Running Locally

Frontend

Terminal

cd fe_frontierpulse
npm run dev
# → http://localhost:3000

The frontend works standalone — it reads live data from the World API and falls back to deterministic hash-based scoring when on-chain data is unavailable.

Oracle Backend

Terminal

cd oracle_backend

# First-time setup: create OracleCap
npm run oracle:init

# Start cron scheduler (runs every 10 minutes)
npm run dev

# Or run a single cycle then exit
npm run dev -- --once

Standalone Mode

You don't need to run the oracle to use the dashboard. The frontend will render the galaxy and compute vitals locally. The oracle adds on-chain persistence and trust scores.

Deployment

Frontend → Vercel

Terminal

cd fe_frontierpulse && vercel --prod

Oracle → Any Node.js Host

Terminal

cd oracle_backend
npm run build && npm start

Smart Contract

The contract is already deployed to Sui Testnet. To redeploy:

Terminal

cd smartcontract_FP
sui client publish --gas-budget 100000000