Skip to content

AyushmanGupta21/Parallax

Repository files navigation

Parallax Logo

Parallax — The Universal Stellar Oracle

A premium decentralized application for real-time wallet management and XLM transfers on the Stellar Network.

Stellar Testnet Next.js Tailwind CSS Framer Motion MIT License


What is Parallax?

Parallax is a modern, high-performance DApp built on top of the Stellar blockchain. It bridges the gap between complex blockchain data and everyday usability — delivering real-time wallet insights, seamless XLM transactions, and live network price feeds inside a single refined interface.

Built as a Level 1 Stellar Mastery project for the Rise In Stellar program, Parallax demonstrates core Stellar blockchain integrations: non-custodial wallet authentication, native asset transfers on Testnet, and real-time transaction tracking.


Features

Feature Description
Wallet Integration Secure, non-custodial connection via Freighter with auto-reconnect on reload
Live Balance Real-time XLM balance with USD equivalent, fetched via Stellar Horizon API
Transaction History Scrollable, live list of your recent incoming/outgoing payments
Send XLM Custom amount input, recipient address, real-time signing and hash tracking
Price Ticker Animated, infinite-scroll banner of live Stellar asset pairs (XLM/USDC, AQUA/XLM, etc.)
ScrollSpy Nav Navbar active state shifts dynamically between sections as you scroll

App Preview

Landing page with Freighter wallet connected, showing the Testnet Active status and account key in the navbar.

Parallax Landing

Dashboard view with live XLM balance, USD equivalent, the Send Transaction form, and full transaction history. The transaction hash is displayed below the form upon a successful testnet payment.

Parallax Dashboard


Tech Stack

Layer Technology
Framework Next.js 16 (App Router)
Language TypeScript
Styling Tailwind CSS v4
Animations Framer Motion v12
Wallet API @stellar/freighter-api
Blockchain SDK stellar-sdk
Network Stellar Testnet via Horizon API

Getting Started

Prerequisites

  • Node.js v18 or higher — Download
  • Freighter Wallet browser extension — Install
    • Make sure it is configured for Testnet mode inside the extension settings

Installation

# 1. Clone the repository
git clone https://github.com/AyushmanGupta21/Parallax.git
cd Parallax

# 2. Install dependencies
npm install

# 3. Start the development server
npm run dev

Then open http://localhost:3000 in your browser.


Usage

Connecting Your Wallet

  1. Click "Connect Wallet" in the top-right navbar.
  2. Approve the connection request in the Freighter popup.
  3. Your public key, XLM balance, and transaction history will load automatically.

Need testnet XLM? Use the Stellar Friendbot to fund your testnet account for free.

Sending XLM

  1. Connect your Freighter wallet and scroll to the Dashboard section.
  2. Enter the amount of XLM to send.
  3. Paste the recipient's Stellar address in the "To Address" field.
  4. Click "Confirm XLM Send" and approve the transaction in Freighter.
  5. The transaction hash will appear below the form upon success.

License

This project is licensed under the MIT License.

About

Parallax: The Universal Prices API and Oracle Indexer for the Stellar Network. A full-stack dApp providing real-time aggregated asset feeds, seamless portfolio management, and smart contract interactions powered by Soroban, Account Abstraction, and zero-fee transactions.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors