Skip to content

README.md

Latest commit

 

History

History
114 lines (74 loc) · 2.69 KB

README.md

File metadata and controls

114 lines (74 loc) · 2.69 KB

DogeGB

Game Boy's Cold Storage Wallet for Dogecoin, Pepecoin, and Bellscoin!

Features

  • Generate BIP39 mnemonic phrases
  • Create Dogecoin, Pepecoin, & Bellscoin wallet addresses
  • QR Address Display
  • Built-in Entropy Generation via Minigame
  • Optional 6-Button PIN
  • Duress Silent Delete Code (PIN Backwards)
  • Encrypted Save Data
  • ROM Integrity Verification
  • Runtime Automated Test Suite

Security Considerations

DogeGB is built to be used on Air-Gapped Devices only, meaning no internet.

Before using DogeGB to store crypto it is recommended to run the built-in test suite to verify the platform.

Sensitive save data is encrypted using the PIN but it is only meant to keep out the overly curious and novice attackers.

Deleting data may not prevent forensic recovery (flash cartridges are a black box).

On certain emulators DogeGB may automatically increase Minigame play time to account for low input resolution.

Healthy Practices

Treat this like a paper wallet.

That means:

  • Keep it physically secure
  • Keep cameras away from sensitive information
  • For flash cartridges, use a dedicated SD Card that never gets plugged into a computer again!

Building

Requirements:

To build DogeGB.gb

make

The default coin mode on startup is Dogecoin, but the app can be built to default to Pepecoin or Bellscoin:

To build PepeGB.gb

make pepe

To build BellsGB.gb

make bells

To build all three:

make all

Building on WSL (Windows)

Install WSL:

wsl --install Debian

In project directory with linux gbdk:

sudo apt-get update
sudo apt-get install python3 python3-mnemonic python3-base58 python3-bip32utils gcc make
make

Unique Build-Time Entropy

If you are concerned about runtime entropy generation being insufficient, you can add build-time entropy yourself by running:

make entropy && make

Testing

You can run crypto validation tests against python3's implimentation by running:

make test

To test ROM integrity checks, you can corrupt a ROM (flip a random bit) by running:

python3 tools/corrupt_rom.py ./build/DogeGB.gb

Disclaimer: DogeGB is an independent, open-source project made using GBDK and is not affiliated with, endorsed by, or licensed by Nintendo. No Nintendo assets were used in its creation. "Game Boy" and "Game Boy Color" are registered trademarks of Nintendo. All trademarks are the property of their respective owners.