User Guide - Dogecoin Wallet

Welcome to the most advanced Dogecoin wallet for Android! This guide will help you get started and make the most of all features.

Getting Started

First Launch

When you first open the app, you'll be guided through:

Wallet Backup

Important: Always backup your wallet! Write down your recovery phrase and store it safely. Without a backup, you cannot recover your funds if you lose your device.

Basic Operations

Sending Dogecoin

  1. Tap "Send" on the main screen
  2. Enter the recipient's address or scan QR code
  3. Enter the amount to send
  4. Review and confirm the transaction

Receiving Dogecoin

  1. Tap "Receive" on the main screen
  2. Share your address or QR code
  3. Wait for the transaction to be confirmed

Family Mode

Create child wallets for family members:

  1. Open the main wallet menu (tap the three-dot menu icon)
  2. Select "Family Mode" (this menu item can be enabled/disabled in Settings → Configuration → Show Family Mode Menu)
  3. Add a new family member
  4. Share the QR code with them
  5. Monitor their transactions and balance

Digital Signing

Prove authenticity and verify integrity of any document, photo, or text using cryptographic signatures tied to your Dogecoin address.

What is Digital Signing?

Digital Signing uses your Dogecoin private key to create a cryptographic signature that proves:

How It Works

Technical Process:
  1. Content is hashed using SHA-256 to create a unique fingerprint
  2. Your private key signs the hash using ECDSA cryptography (secp256k1 curve)
  3. The signature is encoded in Base64 format
  4. Your Dogecoin address is included for verification
  5. Anyone can verify the signature without exposing your private key

What Can You Sign?

Text Documents: Sign emails, contracts, agreements, or any text content
Files: Sign PDFs, images, videos, or any file type by generating its SHA-256 hash
Photos: Take a photo with the camera and sign it instantly to prove authenticity and timestamp

Use Cases

Digital Signatures vs NFTs / DRC-20 / Doginals / Ordinals

Comparing digital signatures with blockchain-based attestations:

Digital Signatures - Advantages:
NFTs / DRC-20 / Doginals / Ordinals - Limitations:

How Digital Signatures Help the Blockchain

Digital signatures provide a better approach to content verification:

How to Use Digital Signing

  1. Enable Digital Signature Menu (if needed): Go to Settings → Configuration → Show Digital Signature Menu to enable/disable this menu item
  2. Open Tools: Navigate to the Tools menu in your wallet (tap the three-dot menu icon)
  3. Select Digital Signing: Choose the digital signing option
  4. Choose Content: Enter text, select a file, or take a photo
  5. Generate Signature: Create your unique cryptographic signature
  6. Share: Share the signed content with anyone for verification
  7. Verify: Recipients can verify the signature using your Dogecoin address

Managing Saved Signatures

All your digital signatures are saved in a database for easy access and management:

Download Original Files: When viewing a file or photo signature, you can download the original file using the Download button. This allows you to share the original document, photo, or video that was signed, separate from the signature data.

Verification Process

How to Verify a Signature:
  1. Hash the original content using SHA-256
  2. Decode the Base64 signature
  3. Recover the public key from the signature
  4. Derive the Dogecoin address from the public key
  5. Verify it matches the claimed signer's address

Best Practices

Pro Tip: Digital signatures are perfect for proving authorship, authenticity, and integrity without bloating the blockchain with data. Think of it as cryptographic proof that your Dogecoin address "approved" the content at a specific moment in time.

Use Doge - Discover Stores That Accept Dogecoin

Use Doge is a powerful feature that helps you discover stores, businesses, and locations that accept Dogecoin near you! It displays an interactive GPS-enabled map with store listings from community-contributed sources.

How It Works

Use Doge uses an interactive map powered by Leaflet to display stores that accept Dogecoin:

  1. GPS Location: The map automatically detects your GPS location and zooms to your current position
  2. Store Markers: Yellow Dogecoin markers (Ð) show stores on the map
  3. Store Listings: Browse stores in a scrollable list below the map
  4. Filter & Search: Filter stores by name or category using the search bar
  5. Store Details: Tap on a store marker or list item to view detailed information
  6. Multiple Sources: Loads stores from multiple JSON sources for comprehensive coverage

Accessing Use Doge

  1. Open the main wallet menu (tap the three-dot menu icon)
  2. Select "Use Doge" (this menu item can be enabled/disabled in Settings → Configuration → Menu Options → Use Doge)
  3. Grant location permission when prompted (required for GPS location)
  4. The map will load and zoom to your current location

Using the Map

Map Features:

Store Information

Each store listing includes:

Sharing Store Information

You can share store information with others:

  1. Tap on a store marker or list item to view details
  2. Tap the "Share" button in the store details dialog
  3. Choose how to share (messaging, email, social media, etc.)
  4. The shared information includes:
    • Store name and category
    • Description and address
    • Contact information (phone, email, website)
    • Google Maps link with coordinates (format: https://www.google.com/maps?q=40.7128,-74.0060)
Note: Only fields with data are included in the share. Empty or null fields are automatically excluded for cleaner sharing.

Adding JSON Sources

You can add custom JSON sources to load stores from different providers:

  1. Open Use Doge from the main menu
  2. Tap the configuration button (gear icon) in the top-right corner
  3. Tap "Add Source" to add a new JSON source URL
  4. Enter the JSON source URL (must be publicly accessible)
  5. Tap "Save" to add the source
  6. Stores from all sources will be loaded and displayed on the map
Default Source:

The app includes a default community source: https://raw.githubusercontent.com/qlpqlp/dogecoin-stores/main/doge-stores.json

JSON Store Format

Stores must be provided in JSON format as an array of store objects. Each store object should follow this structure:

[
  {
    "lat": 40.7128,
    "lon": -74.0060,
    "category": "Restaurant",
    "name": "Doge Pizza",
    "description": "Delicious pizza accepting Dogecoin payments",
    "address": "123 Main Street",
    "postal": "10001",
    "location": "New York",
    "country": "United States",
    "email": "info@dogepizza.com",
    "phone": "+1-555-123-4567",
    "website": "https://dogepizza.com",
    "social": [
      "https://x.com/dogepizza",
      "https://facebook.com/dogepizza"
    ]
  }
]

Field Descriptions

Contributing Stores

There are several ways to contribute stores to the community database:

Option 1: Contribute to the Community Repository

The default source is maintained at: https://github.com/qlpqlp/dogecoin-stores

  1. Fork the repository on GitHub
  2. Add your store(s) to the doge-stores.json file following the JSON format above
  3. Submit a pull request with your additions
  4. Once merged, your stores will be available to all users via the default source

Option 2: Create Your Own JSON Source

You can host your own JSON file and add it as a custom source:

  1. Create a JSON file following the store format above
  2. Host it on a web server or GitHub (using raw GitHub URLs)
  3. Ensure the URL is publicly accessible
  4. Add the URL as a custom source in the app
Example GitHub Hosting:

Create a file my-stores.json in your GitHub repository and use the raw URL:

https://raw.githubusercontent.com/yourusername/yourrepo/main/my-stores.json

Privacy & Permissions

Location Permission:

Use Doge requires location permission to show your GPS position on the map. Your location is only used locally on your device and is never transmitted to any server. The app only uses your location to center the map on your position.

Troubleshooting

Map Not Showing Stores

Location Not Working

Custom Source Not Loading

Recurring Payments

Schedule automatic payments:

  1. Enable Recurring Payments Menu (if needed): Go to Settings → Configuration → Show Recurring Payments Menu to enable/disable this menu item
  2. Open Tools: Navigate to the Tools menu in your wallet (tap the three-dot menu icon)
  3. Select Recurring Payments: Choose the recurring payments option
  4. Create a New Payment Schedule: Tap "Add Payment" button
  5. Set Payment Details: Set amount, frequency, destination address, and optional reference
  6. Enable/Disable: Use the toggle switch on each payment to enable or disable it as needed

Recurring Payments Features

Flexible Scheduling: Set up monthly or one-time payments with automatic execution.
Easy Management: Enable or disable individual payments without deleting them.
Edit & Delete: Edit payment details or delete payments you no longer need using the edit and delete icons.

Accounting Reports & Transaction Analytics

Generate comprehensive reports of all your wallet transactions for accounting, tax purposes, or personal financial tracking.

What are Accounting Reports?

Accounting Reports provide detailed analysis of all your Dogecoin transactions with professional formatting and multiple export options. This feature is perfect for:

How to Access Accounting Reports

  1. Open the main wallet screen
  2. Tap the menu button (three dots) in the top-right corner
  3. Select "Accounting Reports" from the menu

Using the Reports Feature

Step 1: Select Date Range

Choose the time period for your report:

Step 2: Load Transaction Data

After selecting your date range:

  1. Tap "Load Data" to process all transactions in the selected period
  2. Wait for the data to load (this may take a moment for large date ranges)
  3. View the transaction timeline chart showing your activity over time

Step 3: Export Your Report

Choose from three professional export formats:

CSV Export: Perfect for importing into Excel, Google Sheets, or accounting software. Contains all transaction data in comma-separated format with 8 decimal precision for amounts and fees.
JSON Export: Machine-readable format ideal for developers or custom analysis tools. Contains structured data with all transaction details and metadata.
PDF Export: Professional landscape-formatted report with Dogecoin branding, pagination, and modern styling. Perfect for official documentation or sharing with accountants.

Understanding Transaction Data

Each transaction in your report includes:

Transaction Type Explanations

Send Transactions:
Receive Transactions:
Internal Transactions:

Visual Timeline Chart

The interactive chart shows:

Professional PDF Reports

The PDF export includes:

Sharing Your Reports

After generating a report:

  1. Tap the export button (CSV, JSON, or PDF)
  2. Wait for the file to be generated
  3. Choose your sharing method from the Android share menu
  4. Send via email, cloud storage, messaging apps, or save to device

Best Practices for Accounting Reports

Tips for Better Reports:

Troubleshooting Reports

No Data Loading

If no transactions appear in your selected date range:

Export Issues

If export fails:

Write a Check

Create time-locked Dogecoin payments just like traditional bank checks! The "Write a Check" feature allows you to create virtual checks with recipient information, future dates, amounts, memos, and signatures. Each check uses advanced P2SH CLTV (Pay-to-Script-Hash with CheckLockTimeVerify) addresses that lock funds until a specified date, making it perfect for rent payments, gifts, scheduled payments, or any scenario where you need to send funds that can only be spent in the future.

What is Write a Check?

Write a Check transforms your Dogecoin Wallet into a digital checkbook system. Unlike traditional bank checks, Dogecoin checks use blockchain technology to create cryptographically secure, time-locked payments. Each check generates a unique P2SH CLTV address that can receive funds immediately but cannot be spent until the specified timelock date. This provides the same functionality as post-dated checks but with the security and transparency of blockchain technology.

P2SH CLTV Addresses: Each check creates a Pay-to-Script-Hash address with a CheckLockTimeVerify script. The address can receive funds immediately, but spending is locked until the check date. This is enforced at the blockchain level, not just in the wallet.

Creating a Check

To create a new check:

  1. Open the main menu (three dots in top-right corner)
  2. Select "Write a Check" (if visible - can be hidden in Settings → Configuration)
  3. Tap the "+" button to create a new check
  4. Fill in the check details:
    • Pay To: The recipient's name or identifier
    • Date: The date when the check can be spent (timelock date)
    • Expiration Date: Optional expiration date for the check
    • Amount: The amount of Dogecoin to send
    • Memo: Optional note or message
    • Signature: Your name or "Anonymous"
  5. Tap "Issue Check" to create and send the check

Check Status

Checks can have the following statuses:

Managing Checks

From the Write a Check screen, you can:

Printing Checks

Each check can be printed as a PDF document that includes:

The PDF can be saved to your device and printed or shared digitally.

Sweeping a Check

To redeem a check (sweep funds into your wallet):

  1. Open Settings → Sweep Paper Wallet
  2. Scan the QR code from the check PDF
  3. The wallet will automatically detect it's a P2SH CLTV check
  4. Confirm the sweep transaction
  5. Funds will be transferred to your wallet after the timelock date

Check Cancellation

You can cancel a check and return funds to your wallet, but only after the timelock date has been reached:

Transaction Labels

When a check is deposited or canceled, the transaction is automatically labeled in your transaction list:

This makes it easy to identify check-related transactions in your wallet history.

Real-World Use Cases

Best Practices

Important Security Note: The PDF check contains the private key (WIF format) in a QR code. Treat it with the same security as cash or a physical check. Once the recipient has the private key, they can access the funds after the timelock date. Never share checks with untrusted parties. The timelock prevents early spending, but once the date arrives, anyone with the private key can sweep the funds.
Advantages Over Traditional Checks:
Pro Tip: Use checks for post-dated payments, gift cards, or any scenario where you want funds to be locked until a specific date. The timelock ensures funds cannot be spent before the intended date, providing security and control over payment timing.

Blockchain Sync Checkpoints

Reset blockchain synchronization with custom checkpoints to speed up initial sync. This feature allows you to start blockchain synchronization from a specific block height instead of syncing from the beginning.

What are Blockchain Checkpoints?

Blockchain checkpoints are known good states of the blockchain at specific block heights. By starting sync from a checkpoint, you can:

When to Use Checkpoints

Use blockchain checkpoints when:

Using Custom Checkpoints

To reset blockchain with a custom checkpoint:

  1. Open Settings → Advanced Tools
  2. Select "Reset Block Chain"
  3. Choose "Reset with Custom Checkpoint"
  4. Select a checkpoint from the list (loaded from checkpoints-custom.txt)
  5. Confirm the reset
  6. Wallet will restart and begin syncing from the selected checkpoint

Checkpoint Data

Custom checkpoints are loaded from the checkpoints-custom.txt asset file. Each checkpoint includes:

Standard vs Custom Checkpoints

Standard Checkpoints: The wallet includes built-in checkpoints for known good blockchain states. These are used automatically during normal sync.
Custom Checkpoints: You can add your own checkpoints to the checkpoints-custom.txt file for specific block heights you trust. This is useful for advanced users who want to start from a specific point.
Important: Only use checkpoints from trusted sources. Using an incorrect checkpoint could result in an invalid blockchain state. Always verify checkpoint data before using.

Custom Transaction Fees

Configure your default transaction fee category to automatically apply to all transactions. This ensures consistent fee selection across sending coins, sweeping wallets, and canceling checks.

What are Transaction Fee Categories?

The wallet supports three fee categories:

Current Fee Rates

All fee categories currently use the same rate: 0.01 DOGE per KB (1,000,000 satoshis per KB). This is configurable via the fees.txt asset file.

The actual fee you pay depends on:

Setting Default Fee Category

To configure your default transaction fee category:

  1. Open Settings → Configuration
  2. Scroll to "Default Transaction Fees"
  3. Select your preferred category:
    • Economic: Lower cost option. When there are too many pending transactions in the mempool, it can take a little longer to confirm.
    • Normal: Standard fees that can be faster than Economic. When there are too many transactions in the mempool, it may take longer to confirm. (Recommended)
    • Priority: Will be the fastest option when there are too many transactions in the mempool, ensuring quicker confirmation during high network activity.
  4. The setting is saved automatically

Where Default Fees Are Applied

Your default fee category is automatically used for:

Fee Calculation

Transaction fees are calculated based on:

  1. Transaction Size: The size of your transaction in bytes (inputs, outputs, scripts)
  2. Fee Rate: The fee per KB for your selected category
  3. Calculation: (Transaction Size / 1000) × Fee Rate
  4. Buffer: A 20% buffer is added to account for actual size differences

Example Fee Calculation

For a typical transaction (~500 bytes) with Normal fee category (0.01 DOGE per KB):

Changing Fees Per Transaction

While your default fee category is used automatically, you can still change the fee category for individual transactions:

Pro Tip: Set your default fee category to "Normal" for most use cases. This provides a good balance between confirmation speed and cost. Use "Economic" when you want to save on fees and don't mind waiting a bit longer during high network activity. Use "Priority" when you need the fastest confirmation, especially during periods of high mempool activity.

Settings Menu

The Settings menu provides access to configuration options, wallet management tools, and important information. Access Settings by tapping the menu button (three dots) in the top-right corner and selecting "Settings".

Settings Menu Structure

The Settings menu is organized into the following sections:

Configuration

Access general wallet settings and preferences including:

Wallet Management

Manage your wallet security and backup:

Information & Documentation

Access important guidelines and technical documentation:

Advanced Tools

Additional features and utilities:

Important Settings Features

Set Spending PIN: Located in Settings → Set Spending PIN. This PIN is required whenever you send Dogecoin transactions. It provides an additional layer of security beyond your device PIN or biometric authentication.
Back Up Wallet: Located in Settings → Back Up Wallet. Create encrypted backups of your wallet that can be restored on any device. Always keep your backup password secure and store backups in multiple safe locations.
Restore Wallet: Located in Settings → Restore Wallet. Restore your wallet from a backup file created previously. This is essential when setting up on a new device or recovering from wallet issues.
Sweep Paper Wallet: Located in Settings → Sweep Paper Wallet. Move funds from paper wallets or private keys into your main wallet. This is useful when receiving paper wallet funds or consolidating wallets.
Safety Notes: Located in Settings → Safety Notes. Read important safety guidelines and best practices for securely using your Dogecoin wallet, especially before storing significant amounts.
Technical Notes: Located in Settings → Technical Notes. Access technical documentation about the wallet's architecture, features, and implementation details for advanced users and developers.

Advanced Features

Network Monitor

Monitor your connection to the Dogecoin network and view discovered nodes worldwide. Access via Settings → Network Monitor.

Address Book

Save frequently used addresses for quick access when sending payments.

Exchange Rates

View real-time Dogecoin prices in various fiat currencies. Access via Settings → Exchange Rates.

DogeConnect - Wallet Integration

DogeConnect is a protocol developed by the Dogecoin Foundation that enables secure payment envelopes for transactions. Your wallet can parse and process DogeConnect payment envelopes from merchants and services, enabling seamless integration with compatible platforms. Learn more at connect.dogecoin.org.

What is DogeConnect?

DogeConnect is a secure wallet integration protocol that enables the Dogecoin Wallet to communicate with external services and dApps through encrypted envelopes, providing a seamless and safe user experience.

How DogeConnect Works

  1. Service Connection: Services connect to your wallet using the DogeConnect protocol
  2. Secure Envelope: Data is packaged in encrypted envelopes for secure transmission
  3. Wallet Processing: Your wallet processes the request and generates appropriate responses
  4. Response Delivery: Results are sent back to the requesting service

Features

Secure Communication: All data is transmitted in encrypted envelopes for maximum security.
Easy Integration: Connect with dogecoin.org and other compatible platforms seamlessly.
Fast Transactions: Quick and efficient transaction processing through direct wallet connection.

Using DogeConnect

When a service wants to initiate a Dogecoin payment or transaction through DogeConnect:

  1. The service creates a DogeConnect envelope with transaction details
  2. Your wallet receives the envelope and prompts you to review
  3. You confirm or reject the transaction
  4. The wallet processes the transaction and sends the response back to the service

All communication is encrypted and secure, ensuring your private keys never leave your device.

Payment Terminal Mode

Payment Terminal Mode is a secure, PIN-protected full-screen mode perfect for Point of Sale (POS) systems and merchant environments. It provides a kiosk-like experience for displaying payment QR codes and monitoring incoming payments.

What is Payment Terminal Mode?

Payment Terminal Mode locks the wallet into a secure payment interface with full-screen display, QR code generation for payment requests, and PIN-protected exit. This makes it ideal for merchants, businesses, and any scenario where you need a dedicated payment terminal.

How to Enable Payment Terminal Mode

  1. Open Settings in the Dogecoin Wallet
  2. Navigate to Configuration
  3. Find "Payment Terminal Mode" option
  4. Tap to enable terminal mode
  5. Set a secure PIN when prompted
  6. The wallet will automatically switch to terminal mode

Using Payment Terminal Mode

Generating Payment Requests

  1. Enter the amount you want to receive
  2. Tap "Generate QR Code"
  3. Display the QR code to customers
  4. Monitor for incoming payments

Features

PIN Protection: Terminal mode cannot be exited without entering the correct PIN. This ensures unauthorized users cannot access your wallet.
Full Screen Kiosk Mode: Terminal mode displays in full-screen, preventing users from switching apps or accessing other features.
QR Code Display: Large, clear QR codes perfect for scanning with mobile devices.
Payment Monitoring: Real-time monitoring for incoming payments with instant notifications.
HTTP API: Integration with POS systems via HTTP API for automated payment processing.
Secure Exit: Exit requires PIN authentication and automatically disables terminal mode to prevent unauthorized access.

Exiting Payment Terminal Mode

  1. Tap "Exit Terminal Mode" at the bottom of the screen
  2. Enter your PIN when prompted
  3. Confirm exit
  4. The wallet will return to normal mode and terminal mode will be disabled
Security Note: When you exit terminal mode with the correct PIN, the mode is automatically disabled and the PIN is cleared. You will need to set a new PIN when activating terminal mode again.

Best Practices for Payment Terminal Mode

Payment Terminal HTTP API

Payment Terminal Mode includes a built-in HTTP API server for POS integration. The API runs on localhost:6900 and provides endpoints for generating payment requests programmatically.

Endpoints

GET /payment-request

Generate a new payment request without a specific amount.

GET http://localhost:6900/payment-request

Response:
{
  "success": true,
  "address": "DBxx...",
  "message": "Payment request generated"
}
POST /payment-request

Create a payment request for a specific amount in DOGE.

POST http://localhost:6900/payment-request
Content-Type: application/json

Request Body:
{
  "amount": 1.5
}

Response:
{
  "success": true,
  "address": "DBxx...",
  "amount": 1.5,
  "message": "Payment request generated"
}
GET /status

Check the status of the payment terminal service.

GET http://localhost:6900/status

Response:
{
  "success": true,
  "running": true,
  "port": 6900,
  "message": "Payment Terminal API is running"
}

API Usage Examples

Integrate with your POS system using these commands:

JavaScript Example
// Generate payment request for 10 DOGE
fetch('http://localhost:6900/payment-request', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ amount: 10 })
})
.then(response => response.json())
.then(data => {
  console.log('Payment address:', data.address);
  console.log('Amount:', data.amount);
});
cURL Example
# Generate payment request
curl -X POST http://localhost:6900/payment-request \
  -H "Content-Type: application/json" \
  -d '{"amount": 5.0}'

# Check status
curl http://localhost:6900/status
Python Example
import requests

# Create payment request
response = requests.post(
    'http://localhost:6900/payment-request',
    json={'amount': 2.5}
)

data = response.json()
print(f"Address: {data['address']}")
print(f"Amount: {data['amount']} DOGE")

Troubleshooting Payment Terminal Mode

Can't Exit Terminal Mode

If you forgot your PIN:

QR Code Not Displaying

If the QR code doesn't appear:

API Not Responding

If the API is not accessible:

Point of Sale (POS) System

Point of Sale Mode is a complete e-commerce solution that allows merchants and businesses to manage products, categories, and inventory while providing customers with a beautiful web-based storefront accessible from any browser on the local network. Customers can browse products, select quantities, and make payments using QR codes with real-time payment detection.

What is Point of Sale Mode?

Point of Sale Mode transforms your Dogecoin Wallet into a complete POS system for merchants. You can manage products with categories, images, prices, and inventory tracking. Customers access your storefront from any browser on your local network, browse products by category, select quantities, and make payments using unique QR codes. The system automatically detects payments and manages inventory in real-time.

How to Enable Point of Sale Mode

  1. Open Settings in the Dogecoin Wallet
  2. Navigate to Configuration
  3. Find "Point of Sale Mode" option
  4. Toggle the switch to enable Point of Sale Mode
  5. The "Point of Sale Mode" menu option will appear in the main wallet menu

Managing Products and Categories

Adding a Product

  1. Open the main wallet menu (tap the three-dot menu icon)
  2. Select "Point of Sale Mode"
  3. Tap "Add Product" button
  4. Fill in the product details:
    • Category: Select an existing category from the dropdown or add a new one by tapping the "+" button
    • Name: Enter the product or service name
    • Description: Enter a detailed description of the product or service
    • Weight: (Optional) Enter product weight
    • Image: Tap "Select Image" to choose from gallery or "Camera Options" to take a photo. The image will be automatically resized to fit the POS system
    • Quantity: Enter stock quantity (leave empty for unlimited stock)
    • Price: Enter the price in DOGE
  5. Tap "Save" to add the product

Editing a Product

  1. In the Point of Sale Mode screen, find the product you want to edit
  2. Tap the "Edit" icon (pencil icon) on the product card
  3. Modify any product details as needed
  4. Tap "Save" to update the product

Deleting a Product

  1. In the Point of Sale Mode screen, find the product you want to delete
  2. Tap the "Delete" icon (trash icon) on the product card
  3. Confirm deletion when prompted

Filtering Products by Category

  1. In the Point of Sale Mode screen, you'll see a filter icon at the top
  2. Tap the filter icon to open the category dropdown
  3. Select a category to filter products, or select "All" to show all products
  4. The product list will update to show only products from the selected category

Accessing Your POS Storefront

Once Point of Sale Mode is enabled and you have products added, you can access your storefront from any browser on your local network:

  1. In the Point of Sale Mode screen, you'll see a message "Access POS online: http://[IP_ADDRESS]:4200"
  2. Make sure your device and the browser are on the same Wi-Fi network
  3. Open a web browser (Chrome, Firefox, Safari, Edge, etc.) on any device (computer, tablet, phone)
  4. Enter the URL shown in the app (e.g., http://192.168.1.100:4200)
  5. Your storefront will load, showing all product categories
Important: Make sure your device is connected to the same Wi-Fi network as the device running the wallet app. The POS web server runs on port 4200 by default.

POS Server Background Mode

Point of Sale Mode includes a background service feature that allows the web server to run continuously even when the app is closed or the phone is turned off. This ensures your POS storefront remains accessible and payments are monitored at all times.

How to Enable Background Mode

  1. Open the Point of Sale Mode screen (Menu → Point of Sale Mode)
  2. You'll see a toggle switch labeled "Run in background (monitor payments when phone is off)"
  3. Toggle the switch to enable background mode
  4. A notification will appear confirming that the background service has started

What Background Mode Does

Continuous Web Server: The POS web server continues running in the background, allowing customers to access your storefront even when the app is closed or the phone screen is off.
Payment Monitoring: The background service continuously monitors the mempool for incoming payments, automatically detecting when customers pay for products.
Always On: The service runs as a foreground service with a persistent notification, ensuring it continues operating even when the device is in sleep mode or the app is closed.
Automatic Inventory Management: When payments are detected, product quantities are automatically deducted, and empty categories are automatically removed.

Background Mode Warning Banner

When background mode is enabled, a warning banner appears at the bottom of the main wallet screen:

Disabling Background Mode

  1. Open the Point of Sale Mode screen
  2. Toggle the "Run in background" switch to the off position
  3. The background service will stop, and the web server will only run when the app is open
  4. The warning banner will disappear from the main wallet screen
Note: When background mode is enabled, the web server and payment monitoring continue running even if you close the app or turn off the phone screen. The service will only stop when you explicitly disable the toggle or uninstall the app.

Best Practices for Background Mode

Using the Web Storefront

Browsing Products

  1. On the main POS webpage, you'll see all available product categories
  2. Tap on a category to view all products in that category
  3. Products are displayed in cards with images, names, descriptions, prices, and stock information
  4. Products with 0 quantity are automatically hidden
  5. Products with unlimited stock show "Unlimited" for quantity

Selecting Quantity and Making Payment

  1. Tap on a product to view its details
  2. On the product detail page, you'll see:
    • Product image (large and visible)
    • Product name and description
    • Price per unit
    • Stock availability
    • Quantity selector with + and - buttons
    • Total amount to pay
  3. Use the + and - buttons or enter a quantity in the input field
  4. Tap "Pay in Doge" button to generate a payment QR code
  5. A unique Dogecoin address is generated for this specific product and quantity
  6. A QR code is displayed that can be scanned with any Dogecoin wallet
  7. The payment page automatically checks every 3 seconds for incoming payments

Payment Confirmation

  1. When a payment is detected, the page will display a success message
  2. A celebratory Dogecoin words animation will play
  3. After 5 seconds, the page will automatically redirect to the main categories page
  4. The product quantity will be automatically deducted (if not unlimited)
  5. If the quantity reaches 0, the product will be hidden from display

Key Features

Product Management: Complete CRUD operations for products with categories, images, prices, and inventory tracking.
Category Organization: Organize products into categories for easy browsing and management. Select existing categories or create new ones.
Product Images: Add product images via camera or gallery. Images are automatically resized to fit the POS system.
Inventory Management: Track product quantities with automatic deduction on payment. Set products to unlimited stock for services or digital goods.
Web-Based Storefront: Access your POS from any browser on your local network. No installation required on customer devices.
QR Code Payments: Generate unique payment addresses with QR codes for each product and quantity combination.
Real-Time Payment Detection: Automatic payment monitoring with instant confirmation. Checks every 3 seconds for incoming payments.
Mobile Responsive: Fully responsive design that works perfectly on desktop, tablet, and mobile browsers.
Modern UI: Dark theme matching Dogecoin Wallet design with professional styling and smooth animations.
Category Filtering: Filter products by category with an intuitive icon-based interface in the app.
Touch-Friendly: Large + and - buttons for quantity selection on touch screens.

Best Practices for Point of Sale Mode

Troubleshooting Point of Sale Mode

Cannot Access Web Storefront

Products Not Showing on Web Page

Payment Not Detected

Images Not Displaying

QR Code Not Showing

RadioDoge - Offline Transactions

Send Dogecoin transactions without internet using LoRa technology powered by RadioDoge V3 from Dogecoin Foundation.

What is RadioDoge?

RadioDoge is a revolutionary technology that enables Dogecoin transactions to be sent without an internet connection using LoRa (Long Range) radio technology. This is perfect for remote areas or emergency situations where internet connectivity is not available.

How RadioDoge Works

  1. Create Transaction: Create a Dogecoin transaction in the wallet as you normally would
  2. Sign Transaction: The transaction is signed with your private key, creating a signed transaction
  3. Transmit via LoRa: The signed transaction is transmitted using LoRa radio to nearby RadioDoge nodes
  4. Relay to Network: RadioDoge nodes relay the transaction to the Dogecoin network when internet connectivity is available

Setting Up RadioDoge

  1. Enable RadioDoge: Go to Settings → Configuration → Enable RadioDoge
  2. Connect LoRa Device: Connect a compatible LoRa device such as KeyChain LoRa
  3. Configure Settings: Set up your RadioDoge node preferences and transmission parameters

Using RadioDoge for Transactions

Offline Transactions: Send Dogecoin even when you have no internet connection. Perfect for remote areas or emergency situations.
Secure & Private: Transactions are signed locally and transmitted securely via LoRa radio waves.
Long Range: LoRa technology provides long-range communication, reaching RadioDoge nodes kilometers away.
Low Power: LoRa devices consume minimal power, making them ideal for portable and battery-operated setups.

Compatible Devices

Safety & Best Practices

Important Safety Notes:

Security Tips

Troubleshooting

Transaction Not Confirming

Check your internet connection and wait for network confirmation. Large transactions may take longer.

App Not Syncing

Go to your device's Settings → Battery Optimization and disable it for the wallet app.

Lost Device

If you have a backup, you can restore your wallet on a new device using the recovery phrase.

Support

Need help? Contact us:

Much features, very wow! Enjoy using your Dogecoin Wallet!