# XEND3 XRPL Wallet

[![Chrome Web Store](https://img.shields.io/badge/Chrome-Web%20Store-blue.svg)](https://chrome.google.com/webstore)
[![Made by CROAKWORKS](https://img.shields.io/badge/Made%20by-CROAKWORKS-blue.svg)](https://croak.work)
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@%***%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%**#@@@@@@@@@
@@@@@@@**#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@***@@@@@@@@
@@@@@@%**@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*+@@@@@@@@
@@@@@@%**@@@%::==:.*@:.--:.=@@*.:==::%@@@%: *@@@+:%@%-:%@.+@@%..%@@*.%@=.-=-.-@@* :--::@@:=@@*:+@%.:==::@@@*+@@@@@@@@
@@@@@@***@@%:=@@@@@@@::@@@*.#*.#@@@@* @@@:=+:%@@+:%=:#@@@+:%@=:==@@:=@::@@@@@-:@* %@@%:=@:=%:-@@@-:%@@@@@@@*+*@@@@@@@
@@@@***%@@@% %@@@@@@@:.::::+@=:@@@@@%.*@=.*%:=@@+ .::%@@@@:*%:%%:%*.@@.=@@@@@* @* :::.=@@: : =@@@@*=:.=%@@@@#+*+@@@@@
@@@@@@***@@@:=@@@@@@@::@@=:@@*.#@@@@+.@#.=**+.*@+:%@* #@@@+.==@@=::+@@-:%@@@@--@* %@*.%@@:=@@::@@@@@@@* *@@*+*@@@@@@@
@@@@@@%**@@@%-.--::#@::@@@=.%@#::--.:%@:=@@@@+.%+:%@@# =@@%:.%@@@ :%@@@+.:--.=@@* %@@*.*@.=@@@=.#*.:=-.=@@@**%@@@@@@@
@@@@@@%**@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*+@@@@@@@@
@@@@@@@**#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#+*@@@@@@@@
@@@@@@@@***%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%+**@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
A secure, feature-rich Chrome extension wallet for the XRP Ledger with comprehensive NFT support, multi-network connectivity, and advanced transaction management.

**Developed by [CROAKWORKS](https://croak.work)** - Professional blockchain development and cryptocurrency solutions.

## 🚀 Features

### Core Wallet Functionality
- **🔐 Secure Wallet Management**: Create and import XRPL wallets with AES-256 encrypted local storage
- **💸 XRP Transactions**: Send and receive XRP with real-time balance updates and fee estimation
- **🏷️ Destination Tags**: Full support for destination tags and memo fields
- **📱 QR Code Integration**: Generate and scan QR codes for seamless address sharing

### NFT & Digital Assets
- **🎨 NFT Support**: View, manage, and display XRPL NFTs with rich metadata
- **🖼️ Image Display**: Automatic loading of NFT images from IPFS, Arweave, and HTTP sources
- **📊 Collection Management**: Organize and browse your digital asset collection

### Network & Connectivity
- **🌐 Multi-Network Support**: Seamless switching between Mainnet, Testnet, and Devnet
- **⚡ Real-time Updates**: Live balance and transaction status monitoring
- **🔄 Auto-reconnection**: Robust network error handling and automatic reconnection

### Analytics & History
- **📈 Transaction Charts**: Interactive visualizations of your transaction history
- **📋 Detailed History**: Comprehensive transaction logs with search and filter capabilities
- **💹 Balance Tracking**: Historical balance changes and trend analysis

### MIMO Encrypted Messaging
- **🔐 Secure Messaging**: Send and receive encrypted messages using MIMO protocol
- **🆓 Free on Testnet**: No additional fees for encrypted messaging on testnet
- **🔒 End-to-End Encryption**: Messages are encrypted before transmission and stored locally
- **📱 Cross-Platform**: Compatible with other MIMO-enabled wallets and applications

## 💰 Fee Structure

### Development Fee
- **Amount**: 0.01 XRP per transaction
- **Purpose**: Supports ongoing development, maintenance, and security updates
- **Transparency**: Clearly displayed before each transaction confirmation
- **Recipients**: 
  - Primary: `rJtHqKPpHub7EU725Svp4PXZzfPtEGtgWs`
  - Alternate: `rw2ciyaNshpHe7bCHo4bRWq6pqqynnWKQg`

### Network Fees
- **XRPL Network Fee**: ~0.000012 XRP (dynamically calculated)
- **Total Additional Cost**: ~0.010024 XRP per transaction

## 🛠️ Installation

### Method 1: Chrome Web Store (Recommended)
*Coming Soon* - The extension will be available for one-click installation.

### Method 2: Manual Installation (Developer Mode)

1. **Download the Extension**:
   ```bash
   git clone https://github.com/
   cd 
   ```

2. **Load in Chrome**:
   - Open Chrome and navigate to `chrome://extensions/`
   - Enable "Developer mode" (toggle in top-right corner)
   - Click "Load unpacked" and select the extension directory
   - The XEND3 wallet icon will appear in your Chrome toolbar

3. **Verify Installation**:
   - Click the XEND3 icon to open the wallet
   - Check that all features load correctly

## 📖 Usage Guide

### Initial Setup

1. **First Launch**:
   - Click the XEND3 icon in your Chrome toolbar
   - Choose your preferred network (Mainnet recommended for live transactions)

2. **Create New Wallet**:
   - Click "Create New Wallet"
   - **IMPORTANT**: Securely write down your 12-word seed phrase
   - Set a strong password for local encryption
   - Confirm your seed phrase to complete setup

3. **Import Existing Wallet**:
   - Click "Import Wallet"
   - Enter your seed phrase or private key
   - Set a password for local encryption

### Daily Operations

#### Sending XRP
1. Navigate to the "Send" tab
2. Enter recipient address (or scan QR code)
3. Specify amount in XRP
4. Add destination tag if required
5. Review transaction details and fees
6. Confirm with your password

#### Receiving XRP
1. Navigate to the "Receive" tab
2. Share your address or QR code
3. Provide destination tag if needed
4. Monitor incoming transactions in real-time

#### Managing NFTs
1. Navigate to the "NFTs" tab
2. Browse your collection with automatic metadata loading
3. Click any NFT for detailed information
4. View transaction history for each asset

#### Transaction History
1. Navigate to the "History" tab
2. View chronological transaction list
3. Use search and filter options
4. Click transactions for detailed information
5. Export data for record-keeping

#### MIMO Encrypted Messaging
1. Navigate to the "Messages" tab
2. Enter recipient's XRPL address
3. Type your message (automatically encrypted)
4. Send message (free on testnet, small fee on mainnet)
5. View received messages with automatic decryption
6. Message history stored locally and encrypted

## 🔒 Security Best Practices

### Critical Security Measures
- **🔑 Seed Phrase**: Write down and store your 12-word seed phrase offline in multiple secure locations
- **🚫 Never Share**: Never share your seed phrase, private keys, or passwords with anyone
- **✅ Verify Addresses**: Always double-check recipient addresses before sending transactions
- **🔐 Strong Passwords**: Use unique, strong passwords for wallet encryption
- **💻 Trusted Devices**: Only use the extension on devices you trust and control

### Additional Security Features
- **Local Storage**: All sensitive data remains on your device, never transmitted to servers
- **Encryption**: AES-256 encryption for all stored wallet data
- **Auto-lock**: Automatic wallet locking after inactivity
- **Transaction Confirmation**: Multiple confirmation steps for all transactions

## 🛡️ Privacy Policy

### Data We DON'T Collect
- Personal information or browsing data
- Private keys or seed phrases
- Transaction details or wallet balances
- Analytics or usage statistics

### Local Data Only
- All wallet data stored locally using Chrome's secure storage API
- Encrypted with your password before storage
- No server-side storage or data transmission

For complete privacy details, see [PRIVACY_POLICY.md](PRIVACY_POLICY.md)

## ⚖️ Terms of Service

By using XEND3 XRPL Wallet, you agree to our terms including:
- Development fee structure
- Risk acknowledgments
- User responsibilities
- Limitation of liability

For complete terms, see [TERMS_OF_SERVICE.md](TERMS_OF_SERVICE.md)

## 🔧 Technical Details

### Built With
- **Frontend**: Vanilla JavaScript, HTML5, CSS3
- **Blockchain**: XRPL.js library for XRP Ledger integration
- **Messaging**: MIMO protocol for encrypted messaging
- **Storage**: Chrome Extension Storage API with AES-256 encryption
- **Charts**: Chart.js for transaction visualizations
- **QR Codes**: QRCode.js for address sharing

### Browser Compatibility
- Chrome 88+ (Manifest V3 support required)
- Chromium-based browsers (Edge, Brave, etc.)

### Network Requirements
- Internet connection for XRPL network access
- CORS proxy for NFT image loading
- IPFS/Arweave access for decentralized content

## 🐛 Troubleshooting

### Common Issues

**Connection Problems**:
- Check internet connection
- Try switching networks (Mainnet ↔ Testnet)
- Refresh the extension popup

**Transaction Failures**:
- Verify sufficient XRP balance (including fees)
- Check destination address format
- Ensure destination tag is correct if required

**NFT Loading Issues**:
- Images may take time to load from IPFS/Arweave
- Some NFTs may have broken metadata links
- Try refreshing the NFTs tab

**Performance Issues**:
- Clear transaction history if it becomes large
- Restart Chrome if extension becomes unresponsive
- Check for extension updates

### Getting Help
- 📧 Email: cryptoprx@gmail.com
- 🌐 Website: [CROAKWORKS](https://croak.work)
- 🐛 GitHub: [Repository](https://github.com/cryptoprx)

## 🤝 About CROAKWORKS

**CROAKWORKS** is a professional development team specializing in blockchain technology and cryptocurrency solutions. Visit [croak.work](https://croak.work) to learn more about our services and projects.

### Development by CROAKWORKS
- Professional blockchain development
- Cryptocurrency wallet solutions
- Smart contract development
- DeFi protocol implementation

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- XRP Ledger Foundation for the robust blockchain infrastructure
- XRPL.js team for the excellent JavaScript library
- Chrome Extensions team for the secure platform
- **CROAKWORKS** development team for creating this professional wallet solution

## ⚠️ Disclaimer

**Important**: Cryptocurrency transactions involve significant financial risk. This software is provided "as is" without warranties. Users are responsible for:
- Securing their seed phrases and private keys
- Verifying all transaction details
- Understanding the risks of cryptocurrency
- Complying with applicable laws and regulations

**Never invest more than you can afford to lose.**

---

**Made with ❤️ by [CROAKWORKS](https://croak.work) for the XRP Community**

## Project Structure

- `popup.html`: Main extension popup interface
- `popup.js`: Core wallet functionality and UI logic
- `background.js`: Background service worker for notifications and XRPL operations
- `styles.css`: Styling for the wallet interface
- `manifest.json`: Chrome extension configuration
- `xrpl.js`: XRPL JavaScript library for blockchain interactions

## Core Features

### Wallet Management
- Create new XRPL wallets with secure key generation
- Import existing wallets using private keys or seeds
- Secure local storage of wallet credentials
- Account balance checking and updates

### Transaction Handling
- Send XRP to any valid XRPL address
- Support for destination tags
- Transaction history viewing
- Real-time balance updates

### MIMO Messaging
- Send and receive encrypted messages
- End-to-end encryption using MIMO protocol
- Free messaging on testnet
- Cross-platform compatibility
- Local encrypted message storage

### Network Support
- Mainnet for production transactions
- Testnet for development and testing
- Devnet for experimental features
- Automatic network detection and switching

### Security Features
- Private keys never leave your device
- Encrypted local storage
- Secure transaction signing
- Address validation and verification

## Technical Implementation

### XRPL Integration
The wallet uses the official XRPL JavaScript library (v2.7.0) for:
- Wallet generation and management
- Transaction creation and submission
- Account information retrieval
- Network connectivity

### Chrome Extension Architecture
- **Popup Interface**: Main user interface for wallet operations
- **Background Service**: Handles notifications and background tasks
- **Content Security**: Strict CSP policies for enhanced security
- **Storage API**: Secure local storage for wallet data

## Development Setup

1. Clone the repository
2. Load the extension in Chrome developer mode:
   - Open `chrome://extensions/`
   - Enable "Developer mode"
   - Click "Load unpacked" and select the project folder
3. The extension will be available in your browser toolbar

## Testing

For testing purposes:
- Use the Testnet network option
- Generate test wallets within the extension
- Use XRPL testnet faucets for test XRP
- Verify transactions on testnet explorers

## ⚠️ Important Notices

### Transaction Fees
- **Development Fee**: 0.01 XRP per transaction for development support
- **Network Fee**: ~0.000012 XRP (standard XRPL fee)
- **Total Cost**: ~0.010024 XRP per transaction

### MIMO Messaging Fees
- **Testnet**: Free encrypted messaging
- **Mainnet**: Standard XRPL memo transaction fee (~0.000012 XRP)
- **Development Fee**: No additional development fee for messaging

### Supported Networks
- **Mainnet**: Production XRPL network
- **Testnet**: For testing purposes
- **Devnet**: Development network

## 🔒 Privacy & Security

- No data is transmitted to external servers
- Private keys stored locally in Chrome storage
- Open source code available for audit
- Uses official XRPL JavaScript library

## 🐛 Troubleshooting

### Common Issues
- **NFT Loading**: Some NFTs may require CORS proxy for display
- **Network Connectivity**: Switch networks if transactions fail
- **Balance Updates**: May take 4-6 seconds to reflect

### Support
- 🌐 Website: [CROAKWORKS](https://croak.work)
- 📧 Email: cryptoprx@gmail.com
- 🐛 GitHub: [Repository](https://github.com/cryptoprx)

## License

MIT