Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
28 commits
Select commit Hold shift + click to select a range
5493351
Bite args to set parachain cores and collators (#39)
andrzejSulkowski Sep 28, 2026
79bf6a7
Run a TURN/STUN relay for DUB (#38)
mordamax Sep 28, 2026
b80738d
Reset HRMP&DMP on every bite (#40)
andrzejSulkowski Oct 1, 2026
d298d26
Add `ppn version` and rewrite the README around use cases (#37)
mordamax Oct 2, 2026
3e206c9
DUB to v0.6.0 (#49)
Zebedeusz Oct 8, 2026
c2dd703
dub: keep Postgres dynamic shared memory under PGDATA (#50)
mordamax Oct 13, 2026
2f6d0eb
Give custom processes the run's workspace, network and data directory…
HadiKhai Oct 15, 2026
fc31fa7
Stop a network as its own process group and refuse occupied ports ins…
HadiKhai Oct 16, 2026
3cd0d78
Pass zombie-cli's `--node-verifier` through `ppn start` (#43)
HadiKhai Oct 16, 2026
6087b5c
DUB to v0.7.0 (#52)
mordamax Oct 19, 2026
41c43c8
Check secrets files against config/secrets.env.example (#48)
mordamax Oct 19, 2026
0004226
Fix secrets.env.example lookup (#53)
csmnprschv Oct 19, 2026
6baf740
Find secrets.env.example by the file itself (#55)
mordamax Oct 21, 2026
b037482
Give a previewnet fork's collators the workspace's bin directory (#56)
HadiKhai Oct 21, 2026
934522c
Grant the identity backend's attester a DotnsGateway allowance (#58)
mordamax Oct 23, 2026
e11792b
Publish the network's Trinity stack descriptor and light specs (#57)
mordamax Oct 23, 2026
fac30bf
Tell instances apart in the dashboard title (#59)
mordamax Oct 26, 2026
562439a
Attestation signatures with context (#51)
Zebedeusz Oct 28, 2026
1897931
Publish the dotNS addresses in the Trinity stack descriptor (#60)
mordamax Nov 2, 2026
5a64e61
Publish previewnet's payment asset, Coinage and web gateway in its de…
mordamax Nov 2, 2026
0a26878
switch bulletin collators to slot-based (#62)
RafalMirowski1 Nov 2, 2026
fbd8c52
Forward the query string through the dashboard proxy (#63)
mordamax Nov 3, 2026
6ead9ad
chore(dotns): boot previewnet on dotNS v1.1.0 (#64)
re-gius Nov 5, 2026
a8683fd
Merge remote-tracking branch 'origin/main' into polkadot-test-trinity
mordamax Nov 10, 2026
6027f65
Read a fork's source blocks from the source when its bundle lacks them
mordamax Nov 10, 2026
8f9340a
Find a fork's dotNS registry through Asset Hub's dispatcher when the …
mordamax Nov 10, 2026
8f99b7d
Point the Polkadot fork's descriptor at PCF's
mordamax Nov 10, 2026
bb1f454
polkadot-test: add PPN_PROFILE to the secrets file ppn start now checks
mordamax Nov 10, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -239,6 +239,15 @@ jobs:
- name: List bin contents
run: ls -la bin/

# The CLI in the image reports the version these package.json files carry.
- name: Stamp the release version
env:
TAG: ${{ needs.prepare.outputs.tag }}
run: |
for pkg in . packages/network-config packages/cli; do
(cd "$pkg" && npm pkg set version="${TAG#v}")
done

- name: Set up Docker Buildx
uses: docker/setup-buildx-action@v4

Expand Down
34 changes: 34 additions & 0 deletions .github/workflows/zombienet-tests.yml
Original file line number Diff line number Diff line change
Expand Up @@ -113,6 +113,40 @@ jobs:
grep -q "increase_attestation_allowance $PPN_ALLOWANCE_SS58 1000" /tmp/dot-calls.txt \
|| { echo "allowance not granted to PPN_ALLOWANCE_SS58:"; cat /tmp/dot-calls.txt; exit 1; }

- name: DotnsGateway allowance script — deployable without PPN_ALLOWANCE_SS58 hard-fails
env:
PPN_PROFILE: deployable
run: |
if bash scripts/increase-dotns-attestation-allowance.sh 2>/dev/null; then
echo "expected non-zero exit when PPN_ALLOWANCE_SS58 missing"; exit 1
fi

- name: DotnsGateway allowance script — grants to PPN_ALLOWANCE_SS58, never Alice
env:
PPN_PROFILE: deployable
PPN_ALLOWANCE_SS58: 5ERKU2mm7E9o9mLcMGkPMNSPStFT51U5d1SS4YXCafe6riPA
ALLOWANCE_ACCOUNT: 5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY
WAIT_SECONDS: 0
run: |
# The stub reads the allowance back as 0 until a sudo call is made, then 1000,
# so the script's read-back loop ends.
mkdir -p /tmp/stub-dotns
cat > /tmp/stub-dotns/dot <<'STUB'
#!/usr/bin/env bash
echo "$@" >> /tmp/dotns-calls.txt
case "$1" in
*.query.DotnsGateway.AttestationAllowance)
if grep -q "Sudo.sudo" /tmp/dotns-calls.txt; then echo 1000; else echo 0; fi ;;
esac
STUB
sed -i 's/^ //' /tmp/stub-dotns/dot
chmod +x /tmp/stub-dotns/dot
PATH=/tmp/stub-dotns:$PATH bash scripts/increase-dotns-attestation-allowance.sh
grep -q "increase_attestation_allowance $PPN_ALLOWANCE_SS58 1000" /tmp/dotns-calls.txt \
|| { echo "allowance not granted to PPN_ALLOWANCE_SS58:"; cat /tmp/dotns-calls.txt; exit 1; }
! grep -q 5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY /tmp/dotns-calls.txt \
|| { echo "granted to Alice:"; cat /tmp/dotns-calls.txt; exit 1; }

# Smoke test: run the install magic link end-to-end, then start the network
# Install the published packages the way a user would, into a workspace that is not a
# checkout, and start a network from it.
Expand Down
2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,8 @@ fork-bundle*/
# A generated fork config normally lives inside the bundle; a manual
# `ppn fork toml <bundle> fork.toml` drops one wherever the shell stood.
fork.toml
# What `ppn start` spawns: the config above with each custom process's environment (lib/spawn-env.ts)
*.spawn.toml

# Working notes, kept locally rather than in the repo
docs/issues-drafts/
Expand Down
9 changes: 8 additions & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,8 +64,12 @@ make start FORK=1 NETWORK=devnet # Fork a different network (networks/*.json)
make start FORK=1 FRESH_BITE=1 # Fork, biting production now instead of using a bundle
make start FORK=1 CLEAN=1 # Fork, back at its bite block (a stopped fork otherwise resumes)
make bite NETWORK=polkadot UPGRADES="people=<wasm>" # Bite with a runtime authorized at import (no-sudo networks)
make start FORK=1 FRESH_BITE=1 CORES=people=3 COLLATORS=people=5 # Bite with People on 3 cores and 5 collators
```

`CORES`/`COLLATORS` are bite-time: the authority sets and the core layout are state inside the
bundle, so they need a fresh bite, and the relay grows to one validator per core (max 10).

Fork mode continues from a real block rather than resetting to genesis, so contracts,
registrations and balances are already present. A fork that is started again resumes where it
stopped, as long as the data came from the bundle being spawned. See `docs/FORK.md`.
Expand Down Expand Up @@ -131,6 +135,7 @@ docs/
├── POLKADOT-FORK.md # Runbook: fork Polkadot with the fellowship runtimes on a dedicated machine
├── PROFILES.md # dev/prod profiles: funded accounts, sudo, signing keys
├── RUNTIME-UPGRADE.md # Upgrade the runtime of a running chain
├── TRINITY-STACK.md # The network's Trinity stack descriptor and light specs
└── TURN.md # TURN/STUN relay (eturnal) behind DUB's turn-api

bin/ # Output directory (gitignored except ppn.mjs)
Expand Down Expand Up @@ -159,13 +164,15 @@ scripts/ # Shell launchers zombienet execs; the logic lives
├── pin-bulletin-products.sh # Launcher over `ppn service pin-bulletin-products`
├── force-open-hrmp.sh # Force-open HRMP channels
├── patch-bootnodes.sh # Patch bootnode addresses
├── trinity-stack.sh # Launcher over `ppn service trinity-stack`: descriptor and light specs
├── enact-upgrades.sh # Launcher over `ppn service enact-upgrades`: applies what a bite authorized
├── grant-invites.sh # Grants the backend's inviter account invites (both dims)
├── increase-people-lite-attestation-allowance.sh # Attestation allowance config
├── increase-dotns-attestation-allowance.sh # The same attester's DotnsGateway allowance on Asset Hub
├── docker-entrypoint.sh # Docker container entrypoint
├── ensure-dot-cli.sh # Installs dot CLI tool
├── install.sh # Installation script
├── kill-port.sh # Kill processes on specific ports
├── require-free-ports.sh # Refuse ports something already listens on (never kills)
├── validate-ports.sh # Port configuration validator
├── run-tests.sh # Integration test runner
└── dub/ # device-uniqueness-backend (see docs/DEVICE-UNIQUENESS-BACKEND.md)
Expand Down
3 changes: 3 additions & 0 deletions Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -101,5 +101,8 @@ HEALTHCHECK --interval=30s --timeout=10s --start-period=120s --retries=3 \
-d '{"jsonrpc":"2.0","method":"system_health","params":[],"id":1}' \
http://localhost:10000 || exit 1

# The CLI reads its install type from this, because the image has no .git or dist manifest.
ENV PPN_INSTALL=docker

# Start network via entrypoint script (prints info, handles regenerate)
ENTRYPOINT ["/ppn/scripts/docker-entrypoint.sh"]
11 changes: 9 additions & 2 deletions Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -85,6 +85,9 @@ FORK_TOML := $(FORK_DIR)/fork.toml
# Runtimes a bite authorizes at import, for a network without sudo: UPGRADES="<chain>=<wasm> ..."
# becomes one `--upgrade` per entry on `ppn bite` (or `ppn start` when it bites).
UPGRADE_FLAGS := $(foreach u,$(UPGRADES),--upgrade $(u))
# How a bite lays the network out: CORES="<chain>=<n> ..." COLLATORS="<chain>=<n> ...". Fixed at
# bite time like UPGRADES, so a published bundle needs FRESH_BITE=1 to take them.
TOPOLOGY_FLAGS := $(foreach c,$(CORES),--cores $(c)) $(foreach c,$(COLLATORS),--collators $(c))

ifeq ($(FORK),1)
TOML_FILE := $(FORK_TOML)
Expand Down Expand Up @@ -153,7 +156,8 @@ start: build-spawner
$(if $(filter 1,$(EPHEMERAL)),--ephemeral,) \
$(if $(filter 1,$(REGENERATE)),--regenerate,) \
$(if $(filter 1,$(FRESH_BITE)),--fresh-bite,) \
$(UPGRADE_FLAGS)
$(if $(NODE_VERIFIER),--node-verifier $(NODE_VERIFIER),) \
$(UPGRADE_FLAGS) $(TOPOLOGY_FLAGS)

kill:
@node $(CURDIR)/bin/ppn.mjs kill
Expand Down Expand Up @@ -185,7 +189,7 @@ show-network: build-spawner
# build: fork.toml is generated by @ppn/network-config, which shares its
# ports and per-chain flags with the genesis config generator.
bite: build-spawner ensure-binaries
@node $(CURDIR)/bin/ppn.mjs bite "$(FORK_DIR)" $(UPGRADE_FLAGS)
@node $(CURDIR)/bin/ppn.mjs bite "$(FORK_DIR)" $(UPGRADE_FLAGS) $(TOPOLOGY_FLAGS)
@node $(CURDIR)/bin/ppn.mjs fork toml "$(FORK_DIR)" "$(FORK_TOML)"

# Make sure a bundle + config exist before a FORK=1 start.
Expand Down Expand Up @@ -351,6 +355,9 @@ help:
@echo " Only previewnet starts from genesis; the rest are fork-only."
@echo " FRESH_BITE=1 With FORK=1: bite the live network now, not a published bundle"
@echo " UPGRADES=... With a bite: authorize runtimes at import, \"<chain>=<wasm> ...\" (no-sudo networks)"
@echo " CORES=... With a bite: cores per parachain, \"<chain>=<n> ...\" (validators grow to match)"
@echo " COLLATORS=... With a bite: collators per parachain, \"<chain>=<n> ...\""
@echo " NODE_VERIFIER= metric (zombie-cli's default) or none: none leaves node readiness to you"
@echo ""
@echo "Examples:"
@echo " make start Start with persistence (default)"
Expand Down
Loading
Loading