flesh404/laravel-kaspa-address

Laravel package for validating and analyzing Kaspa addresses

Maintainers

Package info

github.com/flesh404/laravel-kaspa-address

pkg:composer/flesh404/laravel-kaspa-address

Statistics

Installs: 1

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v1.0.0 2026-02-08 14:42 UTC

Requires

Requires (Dev)

MIT 97514a28e4a32a2b734a1cd3ed262ef7bfc8ba81

This package is auto-updated.

Last update: 2026-03-08 15:07:31 UTC

README

Laravel package for validating, analyzing and generating Kaspa addresses.

Disclaimer:
This project is not officially affiliated with, endorsed by, or connected to Kaspa or the Kaspa Foundation.

Features

  • Validate Kaspa addresses (mainnet / testnet / devnet / simnet)
  • Extract prefix and network information
  • Kaspa-specific Bech32 checksum verification
  • Generate valid Kaspa addresses (testing & tooling)
  • Artisan commands for validation and generation
  • Based on the official Kaspa Go / Rust reference implementations
  • Zero dependencies

Installation

composer require flesh404/laravel-kaspa-address

Laravel will auto-discover the service provider.

Usage

Validate an address

use Flesh404\Kaspa\Laravel\Address\KaspaAddress;

KaspaAddress::isValid('kaspa:...');

Returns true or false.

Parse and inspect an address

use Flesh404\Kaspa\Laravel\Address\KaspaAddress;

$address = KaspaAddress::parse('kaspa:qp...');

$address->prefix()->value;   // "kaspa"
$address->network()->value;  // "mainnet"

Throws InvalidKaspaAddress if invalid.

Analyzer (recommended for APIs & checker websites)

The KaspaAddressAnalyzer never throws and always returns a structured result.

use Flesh404\Kaspa\Laravel\Address\Support\KaspaAddressAnalyzer

$result = KaspaAddressAnalyzer::analyze('kaspa:qp...');

Result format

[
    'valid'   => true,
    'prefix'  => 'kaspa',
    'network' => 'mainnet',
    'errors'  => [],
]

For invalid addresses:

[
    'valid'  => false,
    'errors' => [
        [
            'code' => 'address.invalid',
            'message' => 'Invalid Kaspa address.'
        ],
        [
            'code' => 'bech32.checksum_invalid',
            'message' => 'Invalid Bech32 checksum.'
        ]
    ],
]

Address Generator

The KaspaAddressGenerator provides a convenient way to generate valid random Kaspa addresses for testing and development purposes.

use Flesh404\Kaspa\Laravel\Address\Support\KaspaAddressGenerator;
use Flesh404\Kaspa\Laravel\Address\Enums\KaspaPrefix;

$address = KaspaAddressGenerator::generate(KaspaPrefix::Mainnet);

(string) $address;          // "kaspa:qp..."
$address->prefix()->value;  // "kaspa"
$address->network()->value; // "mainnet"

You can also generate addresses for other networks:

KaspaAddressGenerator::generate(KaspaPrefix::Testnet);
KaspaAddressGenerator::generate(KaspaPrefix::Devnet);
KaspaAddressGenerator::generate(KaspaPrefix::Simnet);

Note: The generator is intended for testing, fixtures, and tooling. It does not derive keys or represent real wallet ownership.

Artisan Commands

The package ships with a CLI command for validating & generating Kaspa addresses.

Validate an Address

php artisan kaspa:address kaspa:qp...

Example Output:

✔ Address is valid

Prefix:   kaspa
Network:  mainnet

For invalid addresses:

✘ Address is invalid
 - Invalid Kaspa address. (address.invalid)
 - Invalid Bech32 checksum. (bech32.checksum_invalid)

Exit codes:

  • 0 → valid
  • 1 → invalid

Generate an address

Generate a random valid Kaspa address for a given network:

php artisan kaspa:address:generate

Defaults to mainnet (kaspa).

Generate for a specific network:

php artisan kaspa:address:generate kaspatest
php artisan kaspa:address:generate kaspadev
php artisan kaspa:address:generate kaspasim

Output:

kaspa:qp...

Exit codes:

  • 0 → valid
  • 1 → invalid

Laravel Validation Rule

The package provides a Laravel validation rule for Kaspa addresses.

It validates that a value is:

  • a valid Kaspa address
  • optionally restricted to specific Kaspa networks

Basic usage (allow all networks):

use Flesh404\Kaspa\Laravel\Address\Support\Rules\KaspaAddressRule;

$request->validate([
    'address' => ['required', new KaspaAddressRule()],
]);

Restrict to a specific network:

use Flesh404\Kaspa\Laravel\Address\Support\Rules\KaspaAddressRule;
use Flesh404\Kaspa\Laravel\Address\Enums\KaspaPrefix;

$request->validate([
    'address' => ['required', new KaspaAddressRule(KaspaPrefix::Mainnet)],
]);

Allow multiple networks:

$request->validate([
    'address' => [
        'required',
        new KaspaAddressRule([
            KaspaPrefix::Mainnet,
            KaspaPrefix::Testnet,
        ]),
    ],
]);

Validation error messages are currently hardcoded and do not require Laravel translation files.

Supported Networks & Prefixes

Network Prefix
Mainnet kaspa
Testnet kaspatest
Devnet kaspadev
Simnet kaspasim

Testing

./vendor/bin/phpunit

Includes:

  • Bech32 encoding & decoding tests
  • Address parsing tests
  • Generator tests
  • Analyzer tests
  • Artisan command tests

References