# UNO Competitive Wallet

Android NFC wallet fork for U.S. Gamer competitive UNO events. The first silo
holds isolated UNO Credits game value. Bitcoin and Ethereum remain separate
self-custody mainnet wallet silos.

## Install identity

- Application ID: `org.usgamer.unowallet`
- Display name: `UNO Competitive Wallet`
- Version: `1.0.1` (`versionCode 2`)
- Parent U.S. Gamer package: `com.digitaldebit.gtavi.ps5wallet`

The distinct application ID, app-data namespace, signing identity, and NFC AID
allow this fork and the parent U.S. Gamer app to be installed on the same Android
device.

## UNO Credits isolation

- Starts at `0.00`; tournament-bank mode loads `300.00` and resets to `0.00`.
- Uses HCE AID `F0554E4F43524544` and protocol family `UNOCRED-HCE/1`.
- Uses UNO-specific preferences, balance storage, transaction history, MIME
  identity, and NFC packet prefixes.
- Rejects Bitcoin, Ethereum, parent-app game value, and unrelated transports.
- Represents game value only and has no real-world monetary value.

## Security

- Strong biometric confirmation gates wallet access and approvals on supported
  devices.
- Android Keystore-backed key material and encrypted local wallet storage.
- Recovery-phrase QR import for supported blockchain wallet recovery.
- Bitcoin, Ethereum, and UNO Credits maintain separate transaction paths.

## Build

```bash
export JAVA_HOME="$HOME/Library/Java/JavaVirtualMachines/corretto-21.0.2/Contents/Home"
export ANDROID_HOME="$HOME/Library/Android/sdk"
./gradlew test assembleRelease bundleRelease --no-daemon
```

Release signing material is intentionally stored outside this source tree.
