DogecoinArcade

A sidecar Omni-style meta-layer for Dogecoin-family chains.

Pepecoin Dogecoin M2 — core state complete

What it is

DogecoinArcade reads blocks from an unmodified node and maintains token, NFT and exchange state in its own database. It is not a fork of the node, and it never holds private keys — transactions are funded and signed by the node's own wallet.

The protocol is a descendant of the Omni Layer, whose wire format has run on Bitcoin since 2013. Payload encoding is byte-identical to Omni Core's, verified against that project's own published test vectors.

Both chains, identically

Pepecoin is a Dogecoin fork, and every constant this protocol depends on is the same in both — the same values at the same source lines.

ConstantValueSource
MAX_OP_RETURN_RELAY83script/standard.h:30
DEFAULT_PERMIT_BAREMULTISIGtruevalidation.h:143
x-of-3 bare multisig standardyespolicy/policy.cpp:41
RECOMMENDED_MIN_TX_FEECOIN/100policy/policy.h:23
hard dust limitDUST/10policy/policy.h:81
block spacing60 schainparams.cpp

Only chain identity differs — address versions and ports — and those live in configuration as data, not code.

Data capacity

Two carriers, both standard on mainnet:

CarrierBytes per transaction
Class C — OP_RETURN72
Class B — bare multisig7,646

Class B carries just over a hundred times more per transaction, and because each multisig output embeds the sender's own redeeming key, the dust it uses stays spendable by the sender rather than being burned.

Install

One installer, one file, standard library only — it runs on a machine that has nothing but Python 3.10 or newer. It downloads Pepecoin Core (or Dogecoin Core, it asks which), verifies its SHA-256 against two independent sources and checks its GPG signature, writes both node configs, registers services, installs the application and opens your browser. Any verification failure stops the install.

Linux

curl -O https://dogecoinarcade.com/install.py
python3 install.py

Binaries go in ~/.local/bin, which is already on PATH on most distributions. Nodes and the web interface are registered as systemd user services, so they start when you log in. Nothing outside your home directory is touched and it never asks for administrator rights.

macOS

curl -O https://dogecoinarcade.com/install.py
python3 install.py

If python3 is missing, macOS will offer to install the Command Line Tools — accept, then run it again. Services are registered as launchd agents. Note that the macOS Pepecoin release contains no headless daemon, only the Qt wallet, so each node opens a window; it serves the same RPC interface, so the application works either way.

Windows

curl.exe -O https://dogecoinarcade.com/install.py
py install.py

Run it in PowerShell. py rather than python: the launcher is on your PATH whether or not you ticked “Add python.exe to PATH”, which is the box everybody misses. Install Python from python.org — the one from the Microsoft Store is a stub that opens the Store instead of running anything, and if python install.py opened the Store, that is what happened. If PowerShell cannot find curl.exe either, use Invoke-WebRequest https://dogecoinarcade.com/install.py -OutFile install.py. Files go in %LOCALAPPDATA%\DogecoinArcade, and the installer puts its commands on your PATH, so open a new terminal before running dogecoinarcade. Windows has no systemd, so the nodes are not registered to start on their own — you launch them yourself each time. That is the one real gap on Windows and it is listed below.

Look before you run it

This is a script that downloads software from the internet and runs it on your machine. You should be able to see what it intends to touch before you let it. Add --dry-run and it prints every step and changes nothing — no downloads, no files, no services:

python3 install.py --dry-run

Every line begins with “would”. The installer asks which chain you want — Pepecoin, Dogecoin, or both — unless you tell it with --coin.

Update

Updating touches only the code. Never your wallet, your messages, your address book or your chain data. It also brings your node service definitions up to date and puts any command an older installation is missing on your PATH, such as arcade-rpc for bots.

Linux and macOS

dogecoinarcade-update

If that is not found, your bin directory is not on PATH. Use the full path instead:
~/.local/bin/dogecoinarcade-update

Windows

dogecoinarcade-update

Or the full path:
%LOCALAPPDATA%\DogecoinArcade\bin\dogecoinarcade-update.cmd

See what it would do

dogecoinarcade-update --dry-run
dogecoinarcade-update --check

--check only reports whether a newer version exists and changes nothing. --dry-run prints every step it would take.

If a command says No module named 'arcade'

The environment is there and the application is not. pip removes the old version before it unpacks the new one, so an install or an update that fails in between leaves exactly that — and from there every command is a traceback, the updater included, because it lives inside the package it would have reinstalled.

Current installations repair themselves: the commands reinstall from ~/.dogecoinarcade/src before they run. An installation that is already in this state has nothing on it that knows how, so run the installer again. It keeps your wallet, your messages and your chain data, and --skip-core tells it to leave the node alone:

Linux and macOS

curl -O https://dogecoinarcade.com/install.py
python3 install.py --skip-core

Windows

curl.exe -O https://dogecoinarcade.com/install.py
py install.py --skip-core
Your wallet is the only thing you need to keep. There is no passphrase and nothing to write down — your messaging identity is derived from your wallet, so a copy of wallet.dat restores your coins and your conversations together. The Backup page in the application will save one for you, print your private keys, or restore from a copy.

Platform status

Stated plainly. An installer that half-works silently is worse than one that tells you it cannot.

PlatformStatusNotes
Linux x86_64 Tested Verified end to end, including signature checking.
Linux ARM64 (aarch64) Tested Installed and updated repeatedly on an aarch64 machine, including messaging end to end against an x86_64 node. ARMv7 remains untested.
Windows x64 Untested Installs, but does not register services — Windows has no systemd, so the nodes will not start on their own yet.
macOS (Intel & Apple Silicon) Untested Mounts the .dmg, installs Pepecoin-Qt.app and registers launchd agents. Note that the macOS release contains no headless daemon — only the Qt wallet — so each node opens a window. Pepecoin-Qt serves the same RPC interface, so the application works either way.
Verify the installer itself. It is a script that downloads and executes software, so check it before running:
sha256sum install.py should give 70e4e7c66f6eb2921a676109079b55c2d87c4afc7550b3743f243069fc703b16

Source

The repository is served directly from this domain.

git clone https://dogecoinarcade.com/repo

Python 3.12, pinned dependencies, 181 tests. Run them with pytest — they spin up a throwaway regtest node in a temporary directory and never touch mainnet data.

Documentation

The full design record is published: every decision, why it was taken, and what it invalidated — including the corrections. Every factual claim about node behaviour cites a source file and line.

Read the documentation →

Bugs

Found something broken? Several platforms above are marked untested, and reports are how they stop being untested.

Report a bug or read existing reports →

Design rules

The messaging component is testnet-only, permanently, and that rule is enforced in code rather than configuration.