Tatum Dev Wallet

A PHP-based development wallet interface for interacting with multiple blockchains using the Tatum API. This application provides a user-friendly interface for creating wallets, checking balances, and managing addresses across various blockchain networks.

Supported Blockchains

• Ethereum (Sepolia Testnet)
• Bitcoin (Testnet)
• Polygon (Mumbai Testnet)
• Algorand
• XRP
• Tron (Shasta Testnet)

Features

• Create new wallets for supported blockchains
• Check account balances
• Derive addresses from xpub (where supported)
• Show private keys from mnemonics (where supported)
• View transaction history (last 5 actions per chain)
• Chain-specific warnings and requirements
• Secure API key management using environment variables

Prerequisites

• PHP 8.0 or higher
• SQLite3 extension for PHP
• Composer for dependency management

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/tatum-php-devwallet.git
   cd tatum-php-devwallet

2. Install dependencies:

   composer install

3. Create a .env file in the root directory:

   cp .env.example .env

4. Edit the .env file and add your Tatum API key:

   TATUM_API_KEY=your_api_key_here
   

Security Considerations

• The application uses environment variables to store sensitive information like API keys
• Never commit your .env file to version control
• The .env file is included in .gitignore to prevent accidental commits
• API keys are loaded securely through environment variables
• SQLite database is used for local storage of transaction history

Usage

1. Start the PHP development server:

   php -S localhost:8000

2. Open your browser and navigate to http://localhost:8000

3. Select a blockchain from the dropdown menu

4. Use the available actions:

   • Create New Wallet
   • Check Balance
   • Create Address from xpub (where supported)
   • Show Private Key from Mnemonic (where supported)

Chain-Specific Notes

XRP

• New XRP addresses require a minimum of 10 XRP to be activated
• Without this initial deposit, the address will not be usable
• API calls may return errors for unactivated addresses

TRON

• New TRON addresses require a minimum of 0.1 TRX to be activated
• Without this initial deposit, the address will not be usable
• API calls may return errors for unactivated addresses

Algorand and XRP

• These chains do not support xpub derivation
• Private key derivation from mnemonics is not available for XRP

Database

The application uses SQLite to store the last 5 actions for each chain. The database file (wallet_history.db) is created automatically in the root directory.

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Tatum API for providing the blockchain API services
• Tailwind CSS for the UI styling