@quantabit/faucet-sdk

QuantaBit Faucet SDK - Request test assets and native gas for newbie onboarding.

Installation

npm install @quantabit/faucet-sdk @quantabit/sdk-config

Features

• Direct API Client: Request test tokens and get real-time claim status/cooldown parameters.
• React Hook: useFaucet for managing requests, statuses, and multi-language support.
• Premuim UI Component: FaucetRequestButton with vibrant styles, glassmorphism, countdown timers, and built-in error states.
• i18n Ready: Seamless localization supporting English, Chinese, Japanese, and Korean.

Usage

1. Unified React Component

import React from 'react';
import { FaucetRequestButton } from '@quantabit/faucet-sdk';

export default function App() {
  const walletAddress = "HuM99k8A...your_address";
  
  return (
    <div style={{ padding: '20px', maxWidth: '400px' }}>
      <FaucetRequestButton 
        address={walletAddress}
        onSuccess={(res) => console.log('Claim success:', res)}
        onError={(err) => console.error('Claim error:', err)}
      />
    </div>
  );
}

2. Low-Level API & Hooks

import { useFaucet } from '@quantabit/faucet-sdk';

const { loading, status, claim, refreshStatus } = useFaucet({
  address: "HuM99k8A...",
  onSuccess: (res) => alert('Received ' + res.amount + ' QBT!')
});

License

MIT