Stellar Testnet Faucet

A Modern, Reliable Alternative to Stellar Friendbot

View Demo • Report Bug • Request Feature

📋 Table of Contents

• Overview
• Features
• System Architecture
• Getting Started
• Usage
• API Reference
• Deployment
• Contributing
• License
• Contact
• Acknowledgements

🌟 Overview

The Stellar Testnet Faucet is a web application developed by Acachete Labs that provides free test tokens (XLM) for Stellar blockchain development. It serves as a reliable alternative to the official Stellar Friendbot with enhanced features and improved reliability.

graph LR
    A[Developer] -->|Requests Tokens| B[Stellar Testnet Faucet]
    B -->|Distributes Test XLM| C[Developer's Stellar Account]
    B -->|Uses| D[Stellar Network API]
    D -->|Confirms Transaction| B
    style B fill:#08B5E5,stroke:#333,stroke-width:2px

Loading

✨ Features

• Multi-Network Support: Distribute tokens on both Testnet and Futurenet
• Higher Distribution Limits: More tokens than the official Friendbot
• Transaction Tracking: View transaction IDs and status
• Modern UI/UX: Clean, responsive interface with dark mode support
• SEO Optimized: Enhanced discoverability for developers

🏗️ System Architecture

flowchart TD
    subgraph Client
        UI[User Interface] --> Form[Faucet Form]
        Form --> Validation[Input Validation]
        Validation --> Request[API Request]
    end
    
    subgraph Server
        Request --> Handler[Request Handler]
        Handler --> StellarSDK[Stellar SDK]
        StellarSDK --> Network[Stellar Network]
    end
    
    Network --> Response[Transaction Response]
    Response --> UI

Loading

Technology Stack

Component	Technology	Description
Frontend	Next.js 15.5.2	React framework with App Router
Styling	Tailwind CSS 4.x	Utility-first CSS framework
UI Components	shadcn/ui	Accessible component system
Blockchain Integration	Stellar SDK 14.1.1	Official Stellar JavaScript SDK
Deployment	Vercel	Edge-optimized hosting platform

🚀 Getting Started

Prerequisites

• Node.js 18.x or higher
• Bun or npm

Installation

1. Clone the repository

   git clone https://github.com/salazarsebas/acachete-faucet.git
   cd acachete-faucet

2. Install dependencies

   bun install

3. Start the development server

   bun dev

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

💻 Usage

Click to view usage instructions

Step 1: Select Network

Choose between Testnet or Futurenet based on your development needs.

Step 2: Enter Stellar Address

Provide your public Stellar address (starting with 'G').

Step 3: Request Tokens

Click the "Get Test Tokens" button to receive XLM.

Step 4: View Transaction

After successful funding, you'll see the transaction ID and confirmation.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

Distributed under the MIT License. See LICENSE for more information.

📬 Contact

Acachete Labs - @salazarsebas

Project Link: https://github.com/salazarsebas/acachete-faucet

🙏 Acknowledgements

• Stellar Development Foundation
• Next.js
• Tailwind CSS
• shadcn/ui

---

Made with ❤️ by Acachete Labs