Skip to main content

Introduction

Welcome to Equillar, an open-source fintech platform powered by Soroban smart contracts. Use it to learn blockchain development through hands-on practice, or as a local development foundation for prototyping your organization's blockchain solutions.

What is Equillar?​

Equillar is a PHP/Symfony-based fintech platform that serves dual purposes: as an educational resource for learning blockchain development, and as a local/test environment foundation that organizations can use for prototyping and experimentation. Through this investment platform built on Stellar blockchain, you'll learn how to integrate smart contracts, handle blockchain transactions, and create modern web applications that interact with distributed ledgers.

⚠️ Important: Equillar provides a local development and testing foundation. It's designed for learning, prototyping, and experimentation. Organizations should treat it as a starting point requiring thorough customization and security auditing before any production use.

What You'll Learn​

  • 🔗 Blockchain Integration: How to interact with Stellar blockchain and Soroban smart contracts from a web application
  • 💻 Full-Stack Development: Build complete applications combining PHP/Symfony backend, React frontend, and smart contracts
  • 🛠️ Development Patterns: Study code patterns for wallet integration, transaction handling, and state management
  • 🔐 Smart Contract Development: Understand how to write, deploy, and interact with Soroban contracts in Rust
  • 📊 DApp Architecture: Learn the patterns and practices for building decentralized applications

How to Use This Project​

  1. Explore the Code: Browse the GitHub repository to understand the architecture
  2. Run Locally: Follow the installation guide to set up your development environment
  3. Study the Components: Examine how the tech stack works together
  4. Experiment: Modify the code, deploy your own contracts, and learn by doing
  5. Read the Blog: Check out technical articles explaining key concepts and implementation details

What's Inside​

Equillar uses an investment platform as the teaching example, allowing you to learn through a realistic use case. You'll explore how:

  • Companies create fundraising projects with smart contract-backed terms
  • Investors connect Stellar wallets and invest in projects using stellar-testnet stablecoins (USDC, EURC)
  • Smart Contracts manage funds, automate payments, and ensure transparency
  • Web Application provides an intuitive interface for all blockchain interactions

By studying this investment platform scenario, you'll understand how to build complete DApps with real business logic.

Technology Stack​

Learn modern blockchain development with:

  • Backend: PHP 8.x with Symfony 7.3 framework
  • Frontend: React 18 with TypeScript and Material UI
  • Blockchain: Soroban smart contracts written in Rust
  • Database: PostgreSQL for off-chain data
  • Integration: Stellar SDK, Freighter wallet integration

Getting Started​

Ready to start learning? Follow these guides:

Learning Path​

Whether you're new to blockchain or an experienced developer, Equillar provides a structured way to learn:

  1. Beginners: Start with the installation guide and explore how the application works
  2. Backend Developers: Study the Symfony integration and how to interact with Stellar SDK
  3. Frontend Developers: Examine the React components and wallet integration patterns
  4. Blockchain Developers: Deep dive into the smart contract code and Soroban development

Open Source & Community​

Equillar is completely open source and ready for local development. All code is available on GitHub for you to study, modify, and build upon. Use it as:

  • 📚 Learning Resource: Study real-world blockchain development patterns
  • 🧪 Prototyping Foundation: Use as a local testing base for your organization's fintech ideas
  • 💡 Integration Reference: See how PHP/Symfony integrates with Soroban smart contracts
  • 🚀 Development Starting Point: Begin your blockchain project with working local code

Happy learning! 🚀