README

🚀 Introduction

HopekellDev Laravel Tatum.io is a modern, lightweight, and developer-friendly Laravel SDK for selected Tatum.io APIs.

Built specifically for:

⚡ Laravel 10, 11, 12 & 13
🧠 PHP 8.2+
⛓ Blockchain infrastructure
💰 Virtual accounts
🪙 Smart contracts
🔥 NFT & token operations
🛡 KMS security operations
📦 Laravel auto-discovery

This package provides a clean Laravel-style fluent API structure for interacting with Tatum blockchain infrastructure.

✨ Features

✅ Laravel auto-discovery
✅ Modern fluent API structure
✅ Blockchain RPC support
✅ NFT smart contract support
✅ ERC-20 token support
✅ ERC-1155 token support
✅ Marketplace support
✅ Auction support
✅ Gas Pump support
✅ Virtual Accounts support
✅ Blockchain utility helpers
✅ KMS security endpoints
✅ Standardized API responses
✅ Built-in exception handling
✅ Easily extendable architecture

📦 Installation

composer require hopekelldev/laravel-tatum-io

Publish config:

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

⚙️ Configuration

Add your Tatum credentials to .env

TATUM_API_KEY=your_api_key
TATUM_BASE_URL=https://api.tatum.io
TATUM_TIMEOUT=30
TATUM_THROW_EXCEPTIONS=true

🧪 Quick Usage

use HopekellDev\Tatum\Facades\Tatum;

$response = Tatum::blockchainRpc()
    ->bitcoin()
    ->generateWallet();

return $response;

📘 Documentation

⛓ Blockchain RPC

Supported chains:

Bitcoin
Ethereum
BNB Smart Chain
Polygon
Tron
Solana
Litecoin
Dogecoin
XRP

Bitcoin Wallet

Tatum::blockchainRpc()
    ->bitcoin()
    ->generateWallet();

Ethereum Balance

Tatum::blockchainRpc()
    ->ethereum()
    ->getBalance($address);

🪙 Smart Contracts

NFT Minting

Tatum::smartContracts()
    ->nft()
    ->mint($data);

ERC-20 Token Transfer

Tatum::smartContracts()
    ->fungibleTokens()
    ->transfer($data);

Marketplace Listing

Tatum::smartContracts()
    ->marketplace()
    ->createListing($data);

🏦 Virtual Accounts

Create Virtual Account

Tatum::virtualAccounts()
    ->account()
    ->create($data);

Create Customer

Tatum::virtualAccounts()
    ->customer()
    ->create($data);

Create Withdrawal

Tatum::virtualAccounts()
    ->withdrawal()
    ->create($data);

🔔 Blockchain Notifications

Tatum::blockchainNotifications()
    ->subscriptions()
    ->all();

🛡 Security

KMS Sign Transaction

Tatum::security()
    ->keyManagementSystem()
    ->sign($data);

🧰 Utilities

Broadcast Transaction

Tatum::utils()
    ->blockchainUtils()
    ->broadcast($data);

📚 Covered Modules

✅ Blockchain RPC

Bitcoin
Ethereum
BSC
Polygon
Tron
Solana
Litecoin
Dogecoin
XRP

✅ Smart Contracts

NFT (ERC-721)
Fungible Tokens (ERC-20)
Multi Tokens (ERC-1155)
Marketplace
Auction
Gas Pump

✅ Security

Key Management System

✅ Virtual Accounts

Account
Transaction
Customer
Virtual Currency
Order Book
Blockchain Addresses
Blockchain Operations
Blockchain Fees
Deposit
Withdrawal

✅ Blockchain Notifications

Subscriptions
Notifications

✅ Utilities

Blockchain Utilities
Service Utilities

⚠️ Error Handling

use HopekellDev\Tatum\Facades\Tatum;
use HopekellDev\Tatum\Exceptions\TatumException;

try {

    $wallet = Tatum::blockchainRpc()
        ->bitcoin()
        ->generateWallet();

} catch (TatumException $e) {

    return $e->getMessage();

}

🧱 Package Architecture

Tatum
├── Services
│   ├── BlockchainNotifications
│   ├── BlockchainRpc
│   ├── SmartContracts
│   ├── Security
│   ├── VirtualAccounts
│   └── Utils
├── Helpers
│   ├── Http Client
│   └── Response Formatter
└── Exceptions

🤝 Contributing

Contributions are welcome.

You can help by:

Adding more Tatum endpoints
Improving documentation
Writing tests
Improving blockchain coverage
Improving developer experience

🔥 Roadmap

Webhook signature verification
Retry middleware
Logging support
Pest test suite
GitHub Actions CI
Mock responses for testing

🛡 License

This package is open-sourced software licensed under the MIT License.

👨‍💻 Author

HopekellDev

Building scalable fintech, blockchain, SaaS, and backend systems.

GitHub: https://github.com/HopekellDev
Email: hopekelltech@gmail.com

⭐ Support

If this package helps you, please support it by:

Starring the repository
Sharing with Laravel developers
Reporting bugs
Suggesting improvements
Contributing code

Built for Laravel developers who need a clean, modern, and extendable Tatum.io SDK.

hopekelldev / laravel-tatum-io

Maintainers

Package info

Statistics

Security