adimiuprix/faucet-fire

Modern Laravel package for FaucetPay API integration - Send cryptocurrency payments, check balances, and manage transactions with elegant syntax

dev-main 2026-08-24 06:07 UTC

Requires

• php: ^8.5
• guzzlehttp/guzzle: ^7.0
• illuminate/support: ^10.0|^11.0|^12.0

Requires (Dev)

• orchestra/testbench: ^8.0|^9.0
• phpunit/phpunit: ^10.0

MIT

• adimiuprix

• payment
• crypto
• laravel
• bitcoin
• cryptocurrency
• faucetpay

Published on Packagist.org on 2026-08-24 06:07 UTC

README

Modern, elegant Laravel package untuk integrasi FaucetPay API dengan PHP 8.5+

✨ Features

• 🚀 Modern PHP 8.5 syntax dengan typed properties & readonly
• 💎 Clean & concise code - "magical" yet maintainable
• 🎯 Type-safe dengan strict types
• 🧪 Fully tested dengan PHPUnit
• 🔄 Auto-discovery Laravel service provider
• 🎨 Facade support untuk syntax yang elegan

📦 Installation

composer require adimiuprix/faucet-fire

⚙️ Configuration

Publish konfigurasi (opsional):

php artisan vendor:publish --tag=faucetpay-config

Tambahkan credentials ke .env:

FAUCETPAY_API_KEY=your_api_key_here
FAUCETPAY_DEFAULT_CURRENCY=BTC

🎯 Usage

Via Facade (Recommended)

use Adimiuprix\FaucetFire\Facades\FaucetPay;

// Get balance
$balance = FaucetPay::getBalance();
$btcBalance = FaucetPay::getBalance('BTC');

// Send payment
$result = FaucetPay::send([
    'to' => '[e-mail]',
    'amount' => 1000,
    'currency' => 'BTC',
]);

// Get transaction history
$payouts = FaucetPay::getPayouts(count: 100);

// Check payment status
$status = FaucetPay::checkPayment('payment-id-here');

// Get supported currencies
$currencies = FaucetPay::getCurrencies();

Via Dependency Injection

use Adimiuprix\FaucetFire\FaucetPayClient;

class PaymentController extends Controller
{
    public function __construct(
        private readonly FaucetPayClient $faucetpay
    ) {}

    public function withdraw(Request $request)
    {
        $result = $this->faucetpay->send([
            'to' => $request->user()->faucetpay_email,
            'amount' => $request->amount,
            'currency' => 'BTC',
        ]);

        return response()->json($result);
    }

    public function balance()
    {
        return $this->faucetpay->getBalance();
    }
}

Via Container Alias

$client = app('faucetpay');
$balance = $client->getBalance();

📚 Available Methods

Method	Parameters	Description
getBalance(?string $currency)	Currency code (opsional)	Mendapatkan saldo akun
send(array $params)	to, amount, currency	Mengirim pembayaran
getPayouts(int $count)	Jumlah record (default: 50)	Riwayat pembayaran
checkPayment(string $id)	Payment ID	Cek status pembayaran
getCurrencies()	-	Daftar currency yang didukung

🎨 Supported Cryptocurrencies

BTC, ETH, LTC, DOGE, BCH, DASH, DGB, TRX, USDT, FEY, ZEC, BNB

🧪 Testing

composer test

📝 Requirements

• PHP ^8.5
• Laravel ^10.0|^11.0|^12.0
• GuzzleHTTP ^7.0

🤝 Contributing

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

📄 License

The MIT License (MIT). Please see License File for more information.