Initial commit: snapshot of spesmilo/electrumx 2.0.0

Unmodified source tree of upstream commit 280cb339aa158e099eb936033eecd15719770651
("Merge pull request #389 from SomberNight/202607_release_2_0",
https://github.com/spesmilo/electrumx, release 2.0.0, 3 July 2026).

All Palladium-specific changes are in the commits that follow.

contrib/sdist/Dockerfile

@@ -0,0 +1,30 @@
+FROM debian:bookworm@sha256:b877a1a3fdf02469440f1768cf69c9771338a875b7add5e80c45b756c92ac20a
+
+ENV LC_ALL=C.UTF-8 LANG=C.UTF-8
+ENV DEBIAN_FRONTEND=noninteractive
+
+RUN apt-get update -q && \
+    apt-get install -qy \
+        git \
+        python3 \
+        python3-pip \
+        python3-setuptools \
+        python3-venv \
+        python3-build \
+        && \
+    rm -rf /var/lib/apt/lists/* && \
+    apt-get autoremove -y && \
+    apt-get clean
+
+# create new user to avoid using root; but with sudo access and no password for convenience.
+ARG UID=1000
+ENV USER="user"
+ENV HOME_DIR="/home/${USER}"
+ENV WORK_DIR="${HOME_DIR}/wspace" \
+    PATH="${HOME_DIR}/.local/bin:${PATH}"
+RUN useradd --uid $UID --create-home --shell /bin/bash ${USER}
+RUN usermod -append --groups sudo ${USER}
+RUN echo "%sudo ALL=(ALL) NOPASSWD: ALL" >> /etc/sudoers
+WORKDIR ${WORK_DIR}
+RUN chown --recursive ${USER} ${WORK_DIR}
+USER ${USER}

contrib/sdist/README.md

@@ -0,0 +1,29 @@
+# Source tarballs
+
+✓ _These tarballs should be reproducible, meaning you should be able to generate
+   distributables that match the official releases._
+
+This assumes an Ubuntu (x86_64) host, but it should not be too hard to adapt to another
+similar system.
+
+
+## Build steps
+
+1. Install Docker
+
+    See [`docker_notes.md`](https://github.com/spesmilo/electrum/blob/master/contrib/docker_notes.md).
+
+    (worth reading even if you already have docker)
+
+2. Build tarball
+
+    ```
+    $ ./contrib/sdist/build.sh
+    ```
+    If you want reproducibility, try instead e.g.:
+    ```
+    $ ELECBUILD_COMMIT=HEAD ELECBUILD_NOCACHE=1 ./contrib/sdist/build.sh
+    ```
+
+3. The generated distributables are in `./dist`.
+

contrib/sdist/build.sh

@@ -0,0 +1,70 @@
+#!/bin/bash
+#
+# env vars:
+# - ELECBUILD_NOCACHE: if set, forces rebuild of docker image
+# - ELECBUILD_COMMIT: if set, do a fresh clone and git checkout
+
+set -e
+
+PROJECT_ROOT="$(dirname "$(readlink -e "$0")")/../.."
+PROJECT_ROOT_OR_FRESHCLONE_ROOT="$PROJECT_ROOT"
+CONTRIB="$PROJECT_ROOT/contrib"
+CONTRIB_SDIST="$CONTRIB/sdist"
+DISTDIR="$PROJECT_ROOT/dist"
+BUILD_UID=$(/usr/bin/stat -c %u "$PROJECT_ROOT")
+
+export SOURCE_DATE_EPOCH=1530212462
+export PYTHONHASHSEED=22
+
+
+DOCKER_BUILD_FLAGS=""
+if [ ! -z "$ELECBUILD_NOCACHE" ] ; then
+    echo "ELECBUILD_NOCACHE is set. forcing rebuild of docker image."
+    DOCKER_BUILD_FLAGS="--pull --no-cache"
+fi
+
+if [ -z "$ELECBUILD_COMMIT" ] ; then  # local dev build
+    DOCKER_BUILD_FLAGS="$DOCKER_BUILD_FLAGS --build-arg UID=$BUILD_UID"
+fi
+
+echo "building docker image."
+docker build \
+    $DOCKER_BUILD_FLAGS \
+    -t electrumx-builder-img \
+    "$CONTRIB_SDIST"
+
+# maybe do fresh clone
+if [ ! -z "$ELECBUILD_COMMIT" ] ; then
+    echo "ELECBUILD_COMMIT=$ELECBUILD_COMMIT. doing fresh clone and git checkout."
+    FRESH_CLONE="/tmp/electrumx_build/fresh_clone/electrumx"
+    rm -rf "$FRESH_CLONE" 2>/dev/null || ( echo "we need sudo to rm prev FRESH_CLONE." && sudo rm -rf "$FRESH_CLONE" )
+    umask 0022
+    git clone "$PROJECT_ROOT" "$FRESH_CLONE"
+    cd "$FRESH_CLONE"
+    git checkout "$ELECBUILD_COMMIT"
+    PROJECT_ROOT_OR_FRESHCLONE_ROOT="$FRESH_CLONE"
+else
+    echo "not doing fresh clone."
+fi
+
+echo "building binary..."
+# check uid and maybe chown. see #8261
+if [ ! -z "$ELECBUILD_COMMIT" ] ; then  # fresh clone (reproducible build)
+    if [ $(id -u) != "1000" ] || [ $(id -g) != "1000" ] ; then
+        echo "need to chown -R FRESH_CLONE dir. prompting for sudo."
+        sudo chown -R 1000:1000 "$FRESH_CLONE"
+    fi
+fi
+docker run -it \
+    --name electrumx-builder-cont \
+    -v "$PROJECT_ROOT_OR_FRESHCLONE_ROOT":/opt/electrumx \
+    --rm \
+    --workdir /opt/electrumx/contrib/sdist \
+    electrumx-builder-img \
+    ./make_sdist.sh
+
+# make sure resulting binary location is independent of fresh_clone
+if [ ! -z "$ELECBUILD_COMMIT" ] ; then
+    mkdir --parents "$DISTDIR/"
+    cp -f "$FRESH_CLONE/dist"/* "$DISTDIR/"
+fi

contrib/sdist/make_sdist.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+
+set -e
+
+PROJECT_ROOT="$(dirname "$(readlink -e "$0")")/../.."
+CONTRIB="$PROJECT_ROOT/contrib"
+CONTRIB_SDIST="$CONTRIB/sdist"
+BUILDDIR="$CONTRIB_SDIST/build"
+DISTDIR="$PROJECT_ROOT/dist"
+
+cd "$PROJECT_ROOT"
+
+rm -rf "$BUILDDIR"
+mkdir -p "$BUILDDIR" "$DISTDIR"
+
+
+git_status=$(git status --porcelain)
+if [ ! -z "$git_status" ]; then
+    echo "$git_status"
+    echo "git repo not clean, aborting"
+    exit 1
+fi
+
+
+cd "$PROJECT_ROOT"
+python3 -m build --sdist . --outdir "$BUILDDIR/dist1"
+
+
+# the initial tar.gz is not reproducible, see https://github.com/pypa/setuptools/issues/2133
+# so we untar, fix timestamps, and then re-tar
+DISTNAME=$(find "$BUILDDIR/dist1/" -type f -name 'e_x-*.tar.gz' -printf "%f\\n")
+DIST_BASENAME=$(basename --suffix ".tar.gz" "$DISTNAME")
+mkdir -p "$BUILDDIR/dist2"
+cd "$BUILDDIR/dist2"
+tar -xzf "$BUILDDIR/dist1/$DISTNAME"
+find -exec touch -h -d '2000-11-11T11:11:11+00:00' {} +
+GZIP=-n tar --sort=name -czf "$DISTNAME" "$DIST_BASENAME/"
+mv "$DISTNAME" "$DISTDIR/$DISTNAME"
+