Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ concurrency:
group: ci-${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true

# Per-push gate: the web app + the TS FORGE_RULES_V1 conformance suite (the
# Per-push gate: the web app + the TS FORGE_RULES_V2 conformance suite (the
# cross-client parity contract). The Rust workspace pulls in the Dash Platform SDK
# (a git dependency pinned to an immutable tag in Cargo.toml); building that
# dependency tree does not fit a fast per-push job, so Rust is gated by `rust.yml`
Expand Down
6 changes: 3 additions & 3 deletions .github/workflows/mirror-action.yml
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ name: Mirror Action
on:
workflow_dispatch:
schedule:
# Monday midday: well clear of testnet-nightly (06:00), which signs as the same
# Monday midday: well clear of the Devnet Nightly (06:00), which signs as the same
# OWNER identity; two jobs signing at once can collide on identity nonces.
- cron: "41 12 * * 1"
pull_request:
Expand Down Expand Up @@ -61,7 +61,7 @@ jobs:
run: bash action/test.sh

# A separate probe job so the live job's CONCLUSION is literally `skipped` when the
# fixture identity is absent (see testnet-nightly.yml for why that matters).
# fixture identity is absent (see nightly.yml for why that matters).
fixtures:
name: fixture identity configured?
if: github.event_name != 'pull_request'
Expand Down Expand Up @@ -94,7 +94,7 @@ jobs:
persist-credentials: false

# Pinned modern protoc: Ubuntu's 3.21 breaks the tenderdash proto build
# (testnet-nightly.yml has the details).
# (nightly.yml has the details).
- name: Install protoc
env:
PROTOC_VERSION: '28.3'
Expand Down
Original file line number Diff line number Diff line change
@@ -1,57 +1,63 @@
name: Testnet Nightly
name: Devnet Nightly

# Nightly certification against LIVE Dash Platform testnet.
# Nightly certification against LIVE devnet moutai, where forge-v2 (Platform protocol 14) is
# deployed. Testnet and mainnet still run protocol 13 and have no forge-v2 deployment;
# testnet runs resume here once protocol 14 reaches testnet and forge-v2 is deployed there.
#
# The suites this drives are implemented and live in the repo:
# * forge-web/e2e/ — Playwright: read paths, fallback browse, zero-backend, a11y
# * e2e/cli/run.sh — 12 CLI scenarios on devnet moutai (forge-v2): clone/push
# round-trip, non-ff, ref delete, revoked-writer push, non-member
# push, third-party verify, depth+filter, issue lifecycle, PR from
# a fork with a real merge, release asset (SKIPs: no MinIO on the
# runner), star/unstar; plus a testnet v1 read-compat clone
# The suites this drives:
# * forge-web/e2e/ — Playwright on a moutai build: v2 read paths, fallback browse,
# zero-backend, a11y, against the forge-v2 read fixture
# * e2e/cli/run.sh — 11 CLI scenarios on moutai: clone/push round-trip, non-ff,
# ref delete, revoked-writer push, non-member push, third-party
# verify, depth+filter, issue lifecycle, PR from a fork with a
# real merge, release asset (SKIPs: no MinIO on the runner),
# star/unstar
#
# They split by what they need:
# * READ-ONLY specs need only a network path to testnet DAPI and the read fixture repo
# (seeded by `seed-read-fixture` when the secrets exist; e2e/README.md reserves it), so
# they run unconditionally and their failure fails this workflow.
# * The CLI suite and the write specs need FUNDED fixture identities, which cannot live in
# a fork's PR context. A separate `fixtures` probe job decides whether they run, so when
# the secrets are absent the suite job's conclusion is literally `skipped` rather than a
# green job with everything gated out — a distinction any badge or alert rule can see.
# * The READ-ONLY browser specs need only a network path to moutai DAPI and the read
# fixture (`forge-v2-demo`, seeded by forge-contracts/scripts/seed-v2-fixture.mjs;
# e2e/README.md reserves it), so they run unconditionally and their failure fails this
# workflow. The seed job runs first when the fixture secrets exist; it is idempotent (an
# existing fixture is left alone).
# * The CLI suite needs FUNDED fixture identities, which cannot live in a fork's PR
# context. A separate `fixtures` probe job decides whether it runs, so when the secrets
# are absent the suite job's conclusion is literally `skipped` rather than a green job
# with everything gated out — a distinction any badge or alert rule can see.
# * The browser WRITE specs (v2-writes, v2-auth) spend real devnet funds and v2-auth needs
# the devnet faucet key; they run by hand (`E2E_WRITE=1`, see forge-web/e2e/).
#
# Fixture identity secrets (e2e/cli/config.sh names the roles):
# FORGE_MOUTAI_IDENTITY_OWNER - owns the forge-v2 e2e-cli repo, adds/removes members
# FORGE_MOUTAI_IDENTITY_COLLAB - added as a writer, then removed (scenario 04)
# FORGE_MOUTAI_IDENTITY_CONTRIB - never a member (scenario 05)
# FORGE_TEST_IDENTITY_CONTRIB - any testnet identity, for the v1 read-compat clone (08)
# FORGE_TEST_IDENTITY_DEPLOYER - testnet: owns the browser specs' read fixture (v1),
# verified by the seed job
# FORGE_MOUTAI_IDENTITY_OWNER - owns the e2e-cli repo and the read fixture's demo repo
# FORGE_MOUTAI_IDENTITY_MAINTAINER - maintainer of the demo repo, owner of forge-v2-empty
# FORGE_MOUTAI_IDENTITY_COLLAB - added as a writer, then removed (scenario 04)
# FORGE_MOUTAI_IDENTITY_CONTRIB - never a member (scenario 05)
# Each holds the bridge-format identity JSON that `dg` reads from
# ~/.config/dash-forge/test-identities/devnet-moutai/<ROLE>.identity.json (moutai) or
# ~/.config/dash-forge/test-identities/<ROLE>.identity.json (testnet).
# ~/.config/dash-forge/test-identities/devnet-moutai/<ROLE>.identity.json.

on:
workflow_dispatch:
schedule:
- cron: "0 6 * * *"

concurrency:
group: testnet-nightly
group: devnet-nightly
cancel-in-progress: false

jobs:
web-read-paths:
name: playwright (read-only, live testnet)
# Reads the dedicated read fixture (e2e/README.md), so it waits for the seed job — but
# still runs when that job is skipped (no secrets: the fixture is read as it stands) or
# failed (the specs then say what is wrong with it).
name: playwright (read-only, live devnet moutai)
# Reads the read fixture (e2e/README.md), so it waits for the seed job — but still runs
# when that job is skipped (no secrets: the fixture is read as it stands) or failed (the
# specs then say what is wrong with it).
needs: seed-read-fixture
if: ${{ !cancelled() }}
runs-on: ubuntu-latest
timeout-minutes: 30
defaults:
run:
working-directory: forge-web
env:
E2E_DEVNET: moutai
steps:
- uses: actions/checkout@v5
- uses: pnpm/action-setup@v5
Expand All @@ -64,14 +70,17 @@ jobs:
cache-dependency-path: forge-web/pnpm-lock.yaml
- run: pnpm install --frozen-lockfile
- run: pnpm exec playwright install --with-deps chromium
- run: pnpm build
# auth-write needs a funded identity; everything else is a read against live testnet.
- name: Build for devnet moutai
env:
NEXT_PUBLIC_NETWORK: devnet
NEXT_PUBLIC_DEVNET_NAME: moutai
run: pnpm build
# E2E_SKIP_BUILD reuses the `out/` just built — the Playwright webServer would
# otherwise run `pnpm build` a second time before serving it.
- name: Playwright read-path + a11y specs
env:
E2E_SKIP_BUILD: '1'
run: pnpm exec playwright test read-paths.spec.ts fallback-browse.spec.ts zero-backend.spec.ts a11y.spec.ts
run: pnpm exec playwright test v2-reads.spec.ts fallback-browse.spec.ts zero-backend.spec.ts a11y.spec.ts
- uses: actions/upload-artifact@v6
if: always()
with:
Expand All @@ -88,27 +97,27 @@ jobs:
runs-on: ubuntu-latest
outputs:
present: ${{ steps.probe.outputs.present }}
# The read-fixture seeder signs with DEPLOYER alone.
deployer: ${{ steps.probe.outputs.deployer }}
# The read-fixture seeder signs with all four roles.
seeder: ${{ steps.probe.outputs.seeder }}
steps:
- name: Probe
id: probe
env:
FORGE_MOUTAI_IDENTITY_OWNER: ${{ secrets.FORGE_MOUTAI_IDENTITY_OWNER }}
FORGE_MOUTAI_IDENTITY_MAINTAINER: ${{ secrets.FORGE_MOUTAI_IDENTITY_MAINTAINER }}
FORGE_MOUTAI_IDENTITY_COLLAB: ${{ secrets.FORGE_MOUTAI_IDENTITY_COLLAB }}
FORGE_MOUTAI_IDENTITY_CONTRIB: ${{ secrets.FORGE_MOUTAI_IDENTITY_CONTRIB }}
FORGE_TEST_IDENTITY_CONTRIB: ${{ secrets.FORGE_TEST_IDENTITY_CONTRIB }}
FORGE_TEST_IDENTITY_DEPLOYER: ${{ secrets.FORGE_TEST_IDENTITY_DEPLOYER }}
run: |
if [ -n "$FORGE_TEST_IDENTITY_DEPLOYER" ]; then
echo "deployer=true" >> "$GITHUB_OUTPUT"
if [ -n "$FORGE_MOUTAI_IDENTITY_OWNER" ] && [ -n "$FORGE_MOUTAI_IDENTITY_MAINTAINER" ] \
&& [ -n "$FORGE_MOUTAI_IDENTITY_COLLAB" ] && [ -n "$FORGE_MOUTAI_IDENTITY_CONTRIB" ]; then
echo "seeder=true" >> "$GITHUB_OUTPUT"
else
echo "deployer=false" >> "$GITHUB_OUTPUT"
echo "seeder=false" >> "$GITHUB_OUTPUT"
fi
missing=()
# Report the SECRET names an operator has to create, not internal aliases.
for name in FORGE_MOUTAI_IDENTITY_OWNER FORGE_MOUTAI_IDENTITY_COLLAB \
FORGE_MOUTAI_IDENTITY_CONTRIB FORGE_TEST_IDENTITY_CONTRIB; do
FORGE_MOUTAI_IDENTITY_CONTRIB; do
[ -z "${!name}" ] && missing+=("$name")
done
if [ "${#missing[@]}" -ne 0 ]; then
Expand All @@ -118,8 +127,8 @@ jobs:
echo
echo "Missing repository secrets: \`${missing[*]}\`."
echo
echo "These identities must exist and be funded (moutai; testnet for 08) for the CLI suite"
echo "to run. The suite job below reports SKIPPED — it is **not** a passing"
echo "These identities must exist and be funded on devnet moutai for the CLI"
echo "suite to run. The suite job below reports SKIPPED — it is **not** a passing"
echo "run. See \`e2e/cli/config.sh\` for the role pool and"
echo "\`docs/testing/e2e-test-plan.md\` for provisioning."
} >> "$GITHUB_STEP_SUMMARY"
Expand All @@ -128,58 +137,56 @@ jobs:
echo "present=true" >> "$GITHUB_OUTPUT"
fi

# Make the browser specs' read fixture exist and hold exactly the expected commit. It is
# its own repo, written only by this job, so nothing the CLI suite or an ad-hoc storage run
# stores can reach what the browser reads (e2e/README.md). Idempotent: a no-op once seeded.
# Make sure the browser specs' read fixture exists. It is its own pair of repos, written only
# by this job, so nothing the CLI suite or an ad-hoc storage run stores can reach what the
# browser reads (e2e/README.md). Idempotent: a no-op once the fixture is on chain.
seed-read-fixture:
name: seed the read fixture
needs: fixtures
if: needs.fixtures.outputs.deployer == 'true'
if: needs.fixtures.outputs.seeder == 'true'
runs-on: ubuntu-latest
timeout-minutes: 45
env:
ID_DEPLOYER_JSON: ${{ secrets.FORGE_TEST_IDENTITY_DEPLOYER }}
timeout-minutes: 20
steps:
- uses: actions/checkout@v5
- name: Install protoc
env:
PROTOC_VERSION: '28.3'
run: |
curl -sSLo /tmp/protoc.zip \
"https://github.com/protocolbuffers/protobuf/releases/download/v${PROTOC_VERSION}/protoc-${PROTOC_VERSION}-linux-x86_64.zip"
sudo unzip -q -o /tmp/protoc.zip -d /usr/local bin/protoc 'include/*'
sudo chmod +x /usr/local/bin/protoc
- uses: dtolnay/rust-toolchain@stable
- uses: Swatinem/rust-cache@v2
- uses: actions/setup-node@v5
with:
shared-key: e2e-cli
- name: Materialize the DEPLOYER identity
node-version: 22
cache: npm
cache-dependency-path: forge-contracts/sdk-v2/package-lock.json
- run: npm ci --ignore-scripts
working-directory: forge-contracts/sdk-v2
# The keys live only in this step's environment, not the job's.
- name: Materialize the fixture identities
env:
ID_OWNER_JSON: ${{ secrets.FORGE_MOUTAI_IDENTITY_OWNER }}
ID_MAINTAINER_JSON: ${{ secrets.FORGE_MOUTAI_IDENTITY_MAINTAINER }}
ID_COLLAB_JSON: ${{ secrets.FORGE_MOUTAI_IDENTITY_COLLAB }}
ID_CONTRIB_JSON: ${{ secrets.FORGE_MOUTAI_IDENTITY_CONTRIB }}
run: |
dir="${HOME}/.config/dash-forge/test-identities"
dir="${HOME}/.config/dash-forge/test-identities/devnet-moutai"
mkdir -p "$dir" && chmod 700 "$dir"
printf '%s' "$ID_DEPLOYER_JSON" > "$dir/DEPLOYER.identity.json"
# harness_init checks for the whole role set; only DEPLOYER signs here.
for r in COLLAB CONTRIB; do cp "$dir/DEPLOYER.identity.json" "$dir/$r.identity.json"; done
printf '%s' "$ID_OWNER_JSON" > "$dir/OWNER.identity.json"
printf '%s' "$ID_MAINTAINER_JSON" > "$dir/MAINTAINER.identity.json"
printf '%s' "$ID_COLLAB_JSON" > "$dir/COLLAB.identity.json"
printf '%s' "$ID_CONTRIB_JSON" > "$dir/CONTRIB.identity.json"
chmod 600 "$dir"/*.identity.json
- name: Build CLI binaries
timeout-minutes: 30
run: cargo build --locked -p dg -p git-remote-dash
- name: Seed
timeout-minutes: 12
run: bash e2e/cli/seed-read-fixture.sh
timeout-minutes: 15
run: node forge-contracts/scripts/seed-v2-fixture.mjs --network devnet --devnet-name moutai

cli-suite:
name: cli e2e (live devnet moutai)
needs: fixtures
if: needs.fixtures.outputs.present == 'true'
# After the seed job: both sign as OWNER, and two signers on one identity at once
# collide on its contract nonce.
needs: [fixtures, seed-read-fixture]
if: ${{ !cancelled() && needs.fixtures.outputs.present == 'true' }}
runs-on: ubuntu-latest
# checkout + protoc + toolchain + cache (~3 min), build (≤30), suite (≤45).
timeout-minutes: 85
env:
ID_OWNER_JSON: ${{ secrets.FORGE_MOUTAI_IDENTITY_OWNER }}
ID_COLLAB_JSON: ${{ secrets.FORGE_MOUTAI_IDENTITY_COLLAB }}
ID_CONTRIB_JSON: ${{ secrets.FORGE_MOUTAI_IDENTITY_CONTRIB }}
ID_TESTNET_JSON: ${{ secrets.FORGE_TEST_IDENTITY_CONTRIB }}
steps:
- uses: actions/checkout@v5

Expand Down Expand Up @@ -210,8 +217,7 @@ jobs:
printf '%s' "$ID_OWNER_JSON" > "$dir/devnet-moutai/OWNER.identity.json"
printf '%s' "$ID_COLLAB_JSON" > "$dir/devnet-moutai/COLLAB.identity.json"
printf '%s' "$ID_CONTRIB_JSON" > "$dir/devnet-moutai/CONTRIB.identity.json"
printf '%s' "$ID_TESTNET_JSON" > "$dir/CONTRIB.identity.json"
chmod 600 "$dir"/*.identity.json "$dir"/devnet-moutai/*.identity.json
chmod 600 "$dir"/devnet-moutai/*.identity.json

# Built in its own step so a slow (cache-miss) build cannot eat into the suite's time
# budget below; run.sh picks the binaries up from target/debug.
Expand Down
12 changes: 11 additions & 1 deletion .github/workflows/pages.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,11 @@
name: Deploy forge-web to Pages

# The hosted build (forge.dashhq.org) targets devnet moutai: forge-v2 needs Platform
# protocol 14, which only the devnet runs today. The network is a build-time choice
# (NEXT_PUBLIC_NETWORK / NEXT_PUBLIC_DEVNET_NAME); override it with the repository variables
# PAGES_NETWORK / PAGES_DEVNET_NAME (e.g. PAGES_NETWORK=testnet once forge-v2 is deployed
# there) without editing this file. The header badge names the network the build reads.

on:
push:
branches: [master]
Expand Down Expand Up @@ -36,7 +42,11 @@ jobs:
cache: pnpm
cache-dependency-path: forge-web/pnpm-lock.yaml
- run: pnpm install --frozen-lockfile
- run: pnpm build
- name: Build (${{ vars.PAGES_NETWORK || 'devnet' }})
env:
NEXT_PUBLIC_NETWORK: ${{ vars.PAGES_NETWORK || 'devnet' }}
NEXT_PUBLIC_DEVNET_NAME: ${{ (vars.PAGES_NETWORK || 'devnet') == 'devnet' && (vars.PAGES_DEVNET_NAME || 'moutai') || '' }}
run: pnpm build
- uses: actions/configure-pages@v5
- uses: actions/upload-pages-artifact@v3
with:
Expand Down
5 changes: 2 additions & 3 deletions .github/workflows/rust.yml
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,8 @@ on:
- 'rustfmt.toml'
# Compiled into every binary by the crates' build.rs (`--version` stamping).
- 'build-support/**'
# Compiled into the binaries, not just test data: forge-core include_str!s
# templates/repo-v1.json and embeds every deployments/*.json (build.rs), and the
# conformance test loads vectors/.
# Compiled into the binaries, not just test data: forge-core embeds every
# deployments/*.json (build.rs), and the conformance test loads vectors/.
- 'forge-contracts/**'
- '.github/workflows/rust.yml'
push:
Expand Down
2 changes: 2 additions & 0 deletions EXECUTION.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Dash Forge — Execution Tracker

> **Historical.** This is the build log of forge-v1 (a global registry contract plus one contract per repository, with WRITE/MAINTAIN token access control). forge-v1 was removed on 2026-09-26 with no backwards compatibility: the registry, the `repo-v1` template, the token ACLs and the testnet deployments named below no longer exist in the code. The current plan is [docs/roadmap.md](docs/roadmap.md); the current design is [forge-v2](docs/contracts/forge-v2.md). The log below is kept as written.

Session-continuity anchor. Docs in `docs/` are the spec; this file tracks build state. Update every session.

> **2026-09-24:** this log records the July build. "Complete" below means *demonstrated on testnet*, not *usable by real users*. Forward planning now lives in [docs/roadmap.md](docs/roadmap.md).
Expand Down
11 changes: 6 additions & 5 deletions Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -54,17 +54,18 @@ infra-up:
infra-down:
docker compose -f $(COMPOSE_FILE) down -v

## e2e: run the CLI end-to-end suite (LIVE devnet moutai, forge-v2; scenario 08 reads a
## testnet v1 repo) against the OWNER-owned e2e-cli repo (created on first run).
## e2e: run the CLI end-to-end suite (LIVE devnet moutai, forge-v2) against the
## OWNER-owned e2e-cli repo (created on first run).
## Builds the binaries if needed, then drives real git push/clone through the
## dash:// helper. See e2e/cli/README-less run.sh header for env knobs
## (RUN_ID, E2E_TIMEOUT, E2E_NO_CLEANUP, subset args). Exits non-zero on any FAIL.
e2e: build-rust
@bash e2e/cli/run.sh

## e2e-fixture: seed the browser specs' read fixture (idempotent; see e2e/README.md).
e2e-fixture: build-rust
@bash e2e/cli/seed-read-fixture.sh
## e2e-fixture: seed the browser specs' forge-v2 read fixture on DEVNET (idempotent; needs
## `npm ci` in forge-contracts/sdk-v2 and the devnet OWNER/MAINTAINER/COLLAB/CONTRIB fixtures).
e2e-fixture:
@node forge-contracts/scripts/seed-v2-fixture.mjs --network devnet --devnet-name $(DEVNET)

## devnet-identities: mint (or resume) the 9-role identity pool on a devnet,
## funded from the devnet's faucet wallet key, then verify every identity on
Expand Down
Loading
Loading