PHPackages                             bytefederal/byteauth-laravel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication & Authorization](/categories/authentication)
4. /
5. bytefederal/byteauth-laravel

ActiveLibrary[Authentication & Authorization](/categories/authentication)

bytefederal/byteauth-laravel
============================

Byte Federal's fast authentication system built on bitcoin cryptographic standards for Laravel applications.

2531Blade

Since Mar 12Pushed 1y agoCompare

[ Source](https://github.com/bytefederal/byteauth-laravel)[ Packagist](https://packagist.org/packages/bytefederal/byteauth-laravel)[ RSS](/packages/bytefederal-byteauth-laravel/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

[![ByteAuth-Laravel Logo](byteauth-laravel.png)](byteauth-laravel.png)

ByteAuth-Laravel
================

[](#byteauth-laravel)

Description
-----------

[](#description)

ByteAuth-Laravel is a plug and play Laravel package that integrates Byte Federal's fast authentication system into your Laravel application, leveraging bitcoin cryptographic (ECDSA/SHA256) standards. This advanced package not only offers a seamless way to onboard users and enable secure sign-in functionalities, akin to the Webauthn standard, but it also introduces several groundbreaking features:

- It ensures that cryptographic keys are backed up for added security,
- Operates independently of the user's operating system and instead uses a smart-phone as universal access key,
- Incorporates a user identity check to thwart fraudulent users including a liveness check to verify the presence of real human beings during authentication.
- Additionally, it furnishes users with a wallet that supports lightning and bitcoin transactions, enhancing the overall user experience (LNUrl, micropayments, etc).

By integrating ByteAuth-Laravel, you can easily implement a state-of-the-art, comprehensive authentication system in your Laravel projects, harnessing the robustness and security of bitcoin's cryptographic infrastructure.

[Learn more about ByteAut / Fast Login](https://fast.bytefederal.com).

[Learn more about ByteWallet](https://www.bytefederal.com/bytewallet).

Features
--------

[](#features)

- **Fast Authentication**: Utilize Byte Federal's rapid authentication process to enhance user experience.
- **Bitcoin Cryptographic Standards**: Benefit from the high security of bitcoin cryptographic practices.
- **Easy Integration**: Seamlessly integrate with Laravel applications, providing a Livewire component for both front-end and back-end operations.
- **Sample Login Page**: Get started quickly with a sample login landing page tailored for Laravel applications.
- **Webhook Support**: Includes a `WebhookController` for handling authentication callbacks.

Installation
------------

[](#installation)

This package requires `simplesoftwareio/simple-qrcode`. If it's not already installed, you can install it by running:

```
composer require simplesoftwareio/simple-qrcode
```

To install ByteAuth-Laravel, run the following command in your Laravel project:

```
composer require bytefederal/byteauth-laravel
```

After installing the byteauth-laravel package, you may publish the QR Code's configuration file using:

```
php artisan vendor:publish --provider="SimpleSoftwareIO\QrCode\QrCodeServiceProvider"
```

Configuration
-------------

[](#configuration)

After installation, publish the package's configuration file by running:

```
php artisan vendor:publish --provider="ByteFederal\\ByteAuthLaravel\\ByteAuthServiceProvider"
```

This will publish the ByteAuth-Laravel configuration file to your project's config directory. Edit this file as needed to match your application's requirements.

Additionally, to customize the domain used by the QR code generation process:

### Publish the Configuration:

[](#publish-the-configuration)

```
php artisan vendor:publish --tag=byteauth-config
```

This command publishes the ByteAuth-Laravel configuration file to your Laravel project's config directory.

### Edit the Configuration File:

[](#edit-the-configuration-file)

Open the published config/byteauth.php in your project and set the domain value to your website's domain, your api key and your website's dashboard path for the redirect after successful login.

```
return [
    'domain' => env('BYTEAUTH_DOMAIN_REGISTERED', 'my.example.com'),
    'api_key' => env('BYTEAUTH_API_KEY', 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'),
    'home' => env("BYTEAUTH_HOME_REDIRECT", "/home"),
];
```

Make sure to register your domain in the API section [on ByteFederal](https://wallet.bytefederal.com/web/login).

### Utilize Configuration in Your Component:

[](#utilize-configuration-in-your-component)

Update your Livewire component or other parts of your application to use this configuration value when generating QR codes or making related API calls.

```
php artisan vendor:publish --tag=byteauth-views
```

This setup enables your application to use and potentially customize the included sample login page.

Make sure to add the following three routes to your `routes/api.php` file:

```
use ByteFederal\ByteAuthLaravel\Controllers\WebhookController;
...
//backend webhook endpoints
Route::post('/webhook/registration', [WebhookController::class, 'handleRegistration']);
Route::post('/webhook/login', [WebhookController::class, 'handleLogin']);
```

While the above routes do not require session information and will be called from the relay server, the following endpoints DO need session information and should thus be set up in your `routes/web.php` file:

```
use ByteFederal\ByteAuthLaravel\Controllers\WebhookController;
...
//frontend session handling endpoints
Route::get('/api/check', [WebhookController::class, 'check']);
Route::get('/api/bwauth', [WebhookController::class, 'bwauth']);
//sample login page
Route::get('/byte', [WebhookController::class, 'sample']);
```

or guest Route section. Make sure CORS rules allow the WebhookController to receive incoming posts.

Troubleshooting
---------------

[](#troubleshooting)

You may have to install `imagick` to enable the QR code generation on your server. Look out for messages like this:

```
[previous exception] [object] (BaconQrCode\\Exception\\RuntimeException(code: 0): You need to install the imagick extension to use this back end at /var/www/laravel/vendor/bacon/bacon-qr-code/src/Renderer/Image/ImagickImageBackEnd.php:64)
```

Simply install imagick and add its php module:

```
sudo apt-get install php8.2-imagick
sudo phpenmod imagick
sudo systemctl restart apache2
```

Usage
-----

[](#usage)

To use ByteAuth-Laravel in your application, follow these steps:

- Route Setup: Import the package routes in your routes/api.php file.
- Use the sample landing page at a route of your convenience. It will offer your users a way to log into your site or register using ByteWallet
- To register your domain for free for this service go to wallet.bytefederal.com/web/login and register your domain, webhook url and API key.
- Enjoy a biometrically secured passwordless authentication system

Refer to the [documentation](https://fast.bytefederal.com/docs/PlugNPlay/byteauth-laravel) for detailed usage instructions.

Happy coding!

Contributing
------------

[](#contributing)

Contributions to ByteAuth-Laravel are welcome.

License ByteAuth-Laravel is open-sourced software licensed under the MIT license.

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity15

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/e7af3b109b25162c674b2b7c6ca2cf7adc926858fb5709abb58c8c87971750a1?d=identicon)[novalis78](/maintainers/novalis78)

---

Top Contributors

[![novalis78](https://avatars.githubusercontent.com/u/190390?v=4)](https://github.com/novalis78 "novalis78 (43 commits)")

### Embed Badge

![Health badge](/badges/bytefederal-byteauth-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/bytefederal-byteauth-laravel/health.svg)](https://phpackages.com/packages/bytefederal-byteauth-laravel)
```

###  Alternatives

[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k2.9M88](/packages/bezhansalleh-filament-shield)[gesdinet/jwt-refresh-token-bundle

Implements a refresh token system over Json Web Tokens in Symfony

70516.4M35](/packages/gesdinet-jwt-refresh-token-bundle)[illuminate/auth

The Illuminate Auth package.

9327.3M1.0k](/packages/illuminate-auth)[beatswitch/lock

A flexible, driver based Acl package for PHP 5.4+

870304.7k2](/packages/beatswitch-lock)[amocrm/amocrm-api-library

amoCRM API Client

182728.5k6](/packages/amocrm-amocrm-api-library)[vonage/jwt

A standalone package for creating JWTs for Vonage APIs

424.1M4](/packages/vonage-jwt)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)