dashpay · shumkov · Jul 23, 2026 · Jul 23, 2026 · Jul 23, 2026 · Jul 23, 2026
@@ -34,7 +34,7 @@ runs:
           ${{ env.HOME }}/.dashmate
           **/.env
           dashmate_volumes_dump
-        key: local-network-volumes/${{ steps.dashmate-fingerprint.outputs.sha }}
+        key: local-network-volumes/${{ steps.dashmate-fingerprint.outputs.sha }}/${{ hashFiles('.github/actions/local-network/action.yaml', 'packages/dapi/.env.example', 'packages/rs-drive-abci/.env.local', 'scripts/setup_local_network.sh', 'scripts/configure_test_suite.sh', 'scripts/configure_dotenv.sh', 'scripts/dashmate/volumes/**') }}
 
     - name: Restore dashmate volumes
       run: ./scripts/dashmate/volumes/restore.sh
@@ -69,7 +69,7 @@ runs:
           ${{ env.HOME }}/.dashmate
           **/.env
           dashmate_volumes_dump
-        key: local-network-volumes/${{ steps.dashmate-fingerprint.outputs.sha }}
+        key: ${{ steps.local-network-data.outputs.cache-primary-key }}
       if: steps.local-network-data.outputs.cache-hit != 'true'
 
     - name: Configure pre-built docker images

@@ -18,7 +18,8 @@ jobs:
   dashmate-test:
     name: Run ${{ inputs.name }} tests
     runs-on: ubuntu-24.04
-    timeout-minutes: 15
+    # Cold helper-image pulls can consume most of 15 minutes before tests start.
+    timeout-minutes: 30
     steps:
       - name: Check out repo
         uses: actions/checkout@v4
@@ -90,7 +91,7 @@ jobs:
             ${{ env.HOME }}/.dashmate
             **/.env
             dashmate_volumes_dump
-          key: local-network-volumes/${{ steps.dashmate-fingerprint.outputs.sha }}
+          key: local-network-volumes/${{ steps.dashmate-fingerprint.outputs.sha }}/${{ hashFiles('.github/actions/local-network/action.yaml', 'packages/dapi/.env.example', 'packages/rs-drive-abci/.env.local', 'scripts/setup_local_network.sh', 'scripts/configure_test_suite.sh', 'scripts/configure_dotenv.sh', 'scripts/dashmate/volumes/**') }}
         if: inputs.restore_local_network_data == true
 
       - name: Restore dashmate volumes
@@ -110,7 +111,7 @@ jobs:
         env:
           DEBUG: 1
           DASHMATE_E2E_TESTS_SKIP_IMAGE_BUILD: true
-        if: steps.local-network-data.outputs.cache-hit == 'false'
+        if: steps.local-network-data.outputs.cache-hit != 'true'
 
       - name: Show Docker logs
         if: ${{ failure() }}

@@ -5,7 +5,8 @@ jobs:
   test-functional:
     name: Run functional tests
     runs-on: ubuntu-24.04
-    timeout-minutes: 15
+    # Cold helper-image pulls can consume most of 15 minutes before tests start.
+    timeout-minutes: 30
     env:
       ECR_HOST: ${{ secrets.AWS_ACCOUNT_ID }}.dkr.ecr.${{ vars.AWS_REGION }}.amazonaws.com
     steps:

@@ -23,7 +23,8 @@ jobs:
   test-suite:
     name: Run ${{ inputs.name }}
     runs-on: ubuntu-24.04
-    timeout-minutes: 15
+    # Cold helper-image pulls can consume most of 15 minutes before tests start.
+    timeout-minutes: 30
     env:
       ECR_HOST: ${{ secrets.AWS_ACCOUNT_ID }}.dkr.ecr.${{ vars.AWS_REGION }}.amazonaws.com
     steps:

@@ -50,6 +50,7 @@ jobs:
       doctests-changed: ${{ steps.override.outputs.doctests-changed || steps.filter-doctests.outputs.doctests-changed }}
       swift-sdk-changed: ${{ steps.override.outputs.swift-sdk-changed || steps.filter-swift-sdk.outputs.swift-sdk-changed }}
       version-changed: ${{ steps.override.outputs.version-changed || steps.filter-version.outputs.version-changed }}
+      e2e-tests-changed: ${{ steps.override.outputs.e2e-tests-changed || steps.filter-e2e.outputs.e2e-tests-changed }}
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -89,6 +90,37 @@ jobs:
               - .github/workflows/tests.yml
               - .github/scripts/check-wallet-closure.py
 
+      - uses: dorny/paths-filter@v4
+        id: filter-e2e
+        if: ${{ github.event_name != 'workflow_dispatch' }}
+        with:
+          filters: |
+            e2e-tests-changed:
+              - packages/platform-test-suite/**
+              - packages/dashmate/**
+              - packages/js-dapi-client/**
+              - packages/js-dash-sdk/**
+              - packages/wallet-lib/**
+              - packages/wasm-sdk/**
+              - packages/dapi/.env.example
+              - packages/rs-drive-abci/.env.local
+              - .github/actions/aws_ecr_login/**
+              - .github/actions/docker/**
+              - .github/actions/local-network/**
+              - .github/actions/nodejs/**
+              - .github/actions/rust/**
+              - .github/actions/sccache/**
+              - .github/workflows/tests.yml
+              - .github/workflows/tests-build-js.yml
+              - .github/workflows/tests-build-image.yml
+              - .github/workflows/tests-test-suite.yml
+              - .github/workflows/tests-packges-functional.yml
+              - .github/workflows/tests-dashmate.yml
+              - scripts/setup_local_network.sh
+              - scripts/configure_test_suite.sh
+              - scripts/configure_dotenv.sh
+              - scripts/dashmate/volumes/**
+
       - name: Check for platform version change
         id: filter-version
         if: ${{ github.event_name != 'workflow_dispatch' }}
@@ -187,6 +219,7 @@ jobs:
         with:
           filters: |
             swift-sdk-changed:
+              - .github/workflows/swift-sdk-build.yml
               - packages/swift-sdk/**
               - packages/dapi-grpc/**
               - packages/dashpay-contract/**
@@ -265,12 +298,13 @@ jobs:
           echo 'doctests-changed=true' >> "$GITHUB_OUTPUT"
           echo 'swift-sdk-changed=true' >> "$GITHUB_OUTPUT"
           echo 'version-changed=true' >> "$GITHUB_OUTPUT"
+          echo 'e2e-tests-changed=true' >> "$GITHUB_OUTPUT"
 
   build-js:
     name: Build JS packages
     needs:
       - changes
-    if: ${{ needs.changes.outputs.js-packages != '[]' || needs.changes.outputs.version-changed == 'true' || github.event_name == 'schedule' || github.event_name == 'workflow_dispatch' }}
+    if: ${{ needs.changes.outputs.js-packages != '[]' || needs.changes.outputs.version-changed == 'true' || needs.changes.outputs.e2e-tests-changed == 'true' || github.event_name == 'schedule' || github.event_name == 'workflow_dispatch' }}
     secrets: inherit
     uses: ./.github/workflows/tests-build-js.yml
 
@@ -279,10 +313,10 @@ jobs:
     needs:
       - check-secrets
       - changes
-    # Build Docker images on version change, nightly schedule, or manual dispatch
+    # Build Docker images for platform E2E changes, version changes, nightly schedules, or manual dispatches
     if: >-
       needs.check-secrets.outputs.has_ecr == 'true' &&
-      (needs.changes.outputs.version-changed == 'true' || github.event_name == 'schedule' || github.event_name == 'workflow_dispatch')
+      (needs.changes.outputs.version-changed == 'true' || needs.changes.outputs.e2e-tests-changed == 'true' || github.event_name == 'schedule' || github.event_name == 'workflow_dispatch')
     secrets: inherit
     strategy:
       fail-fast: false
@@ -374,8 +408,9 @@ jobs:
     uses: ./.github/workflows/tests-js-package.yml
     with:
       package: ${{ matrix.js-package }}
-      test-command: ${{ matrix.js-package == 'dashmate' && 'test:unit' || 'test' }}
-      skip-tests: ${{ contains(matrix.js-package, 'platform-test-suite') }}
+      # The platform test suite's default command drives a live network, so it
+      # runs from the E2E jobs. Its unit tests need nothing and run here.
+      test-command: ${{ (matrix.js-package == 'dashmate' || contains(matrix.js-package, 'platform-test-suite')) && 'test:unit' || 'test' }}
       direct-packages: ${{ needs.changes.outputs.js-packages-direct }}
 
   js-deps-versions:
@@ -426,8 +461,9 @@ jobs:
     if: >-
       always() &&
       needs.check-secrets.outputs.has_ecr == 'true' &&
+      needs.build-js.result == 'success' &&
       needs.build-images.result == 'success' &&
-      (needs.changes.outputs.version-changed == 'true' || github.event_name == 'schedule' || github.event_name == 'workflow_dispatch')
+      (needs.changes.outputs.version-changed == 'true' || needs.changes.outputs.e2e-tests-changed == 'true' || github.event_name == 'schedule' || github.event_name == 'workflow_dispatch')
 
   test-suite:
     name: Test Suite
@@ -442,7 +478,7 @@ jobs:
       needs.check-secrets.outputs.has_ecr == 'true' &&
       needs.build-js.result == 'success' &&
       needs.build-images.result == 'success' &&
-      (needs.changes.outputs.version-changed == 'true' || github.event_name == 'schedule' || github.event_name == 'workflow_dispatch')
+      (needs.changes.outputs.version-changed == 'true' || needs.changes.outputs.e2e-tests-changed == 'true' || github.event_name == 'schedule' || github.event_name == 'workflow_dispatch')
     strategy:
       fail-fast: false
       matrix:
@@ -479,5 +515,5 @@ jobs:
       needs.check-secrets.outputs.has_ecr == 'true' &&
       needs.build-js.result == 'success' &&
       needs.build-images.result == 'success' &&
-      (needs.changes.outputs.version-changed == 'true' || github.event_name == 'schedule' || github.event_name == 'workflow_dispatch')
+      (needs.changes.outputs.version-changed == 'true' || needs.changes.outputs.e2e-tests-changed == 'true' || github.event_name == 'schedule' || github.event_name == 'workflow_dispatch')
     uses: ./.github/workflows/tests-packges-functional.yml
@@ -1,5 +1,59 @@
 const DAPIAddress = require('@dashevo/dapi-client/lib/dapiAddressProvider/DAPIAddress');
 
+/**
+ * `WasmSdkError.name` for a transition family whose proof cannot bind the
+ * execution of one specific transition.
+ *
+ * @type {string}
+ */
+const EXECUTION_NOT_PROVED = 'ExecutionNotProved';
+
+/**
+ * Read the error's kind without assuming it survives the WASM boundary.
+ *
+ * @param {*} error
+ * @returns {string|undefined}
+ */
+function readErrorName(error) {
+  try {
+    return error && error.name;
+  } catch (readError) {
+    // A WASM error object whose memory is already released throws on access.
+    return undefined;
+  }
+}
+
+/**
+ * Convert a WASM SDK error into a plain `Error`.
+ *
+ * These are wasm-bindgen class instances rather than `Error`s, and they carry
+ * their kind and message on prototype getters. Mocha runs the suite in
+ * parallel workers and serializes a failure by copying the error's own
+ * properties, so an unconverted one arrives with nothing in it and the run
+ * reports a test that failed for no stated reason.
+ *
+ * @param {*} error
+ * @returns {Error}
+ */
+function toReportableError(error) {
+  if (error instanceof Error) {
+    return error;
+  }
+
+  const name = readErrorName(error) || 'UnknownError';
+  let message;
+  try {
+    message = (error && error.message) || String(error);
+  } catch (readError) {
+    message = 'error details are unavailable';
+  }
+
+  const reportable = new Error(`${name}: ${message}`);
+  reportable.name = name;
+
+  return reportable;
+}
+
 /**
  * Shared EvoSDK instance. One per process: the verifier is stateless and the
  * underlying WASM SDK multiplexes concurrent requests.
@@ -134,17 +188,25 @@ async function getEvoSdkForNetwork(callNetwork) {
 
 /**
  * Create an `IPlatformProofVerifier` for `Dash.Client`, backed by the
- * Rust/WASM SDK, which authenticates every result end to end: GroveDB proof
- * verification plus the Tenderdash quorum signature over the root hash.
+ * Rust/WASM SDK. Its proved re-query authenticates an execution result or
+ * affected-state snapshot end to end: GroveDB proof verification plus the
+ * Tenderdash quorum signature over the root hash.
  *
  * Verification re-queries Platform through the WASM SDK's proved paths rather
- * than re-checking the exact bytes the JS transport received: the returned
- * data (and the absence of a consensus error) is quorum-authenticated, so the
- * unverified DAPI response is never the source of truth.
+ * than re-checking the exact bytes the JS transport received. Execution proof
+ * is required wherever the transition family can produce one. The families
+ * that cannot fall back to a height-pinned snapshot of the affected state,
+ * which is not evidence that this exact transition executed; the caller
+ * handles consensus errors from the original response before invoking this
+ * verifier.
  *
+ * @param {Object} [dependencies]
+ * @param {Function} [dependencies.getEvoSdkForNetwork]
  * @returns {Object} IPlatformProofVerifier
  */
-function createPlatformProofVerifier() {
+function createPlatformProofVerifier({
+  getEvoSdkForNetwork: loadEvoSdkForNetwork = getEvoSdkForNetwork,
+} = {}) {
   return {
     /**
      * @param {Object} input
@@ -153,16 +215,31 @@ function createPlatformProofVerifier() {
      * @returns {Promise<void>}
      */
     async verifyStateTransitionResult({ serializedStateTransition, network }) {
-      const { evo, sdk } = await getEvoSdkForNetwork(network);
+      const { evo, sdk } = await loadEvoSdkForNetwork(network);
 
       const stateTransition = evo.StateTransition.fromBytes(
         new Uint8Array(serializedStateTransition),
       );
 
-      // Waits on the proved endpoint and verifies the execution proof and
-      // quorum signature inside the Rust SDK; throws unless the transition
-      // was executed (or yielded a consensus error, which also throws).
-      await sdk.stateTransitions.waitForResponse(stateTransition);
+      try {
+        await sdk.stateTransitions.waitForResponse(stateTransition);
+      } catch (error) {
+        // Balance top-ups, credit transfers and withdrawals, address funds
+        // movements, shields and no-history token operations have no proof
+        // that binds one specific transition, so the SDK reports that the
+        // execution was not proved rather than that anything failed. Their
+        // authenticated affected-state snapshot is the strongest result
+        // available; every other family keeps failing closed here.
+        if (readErrorName(error) !== EXECUTION_NOT_PROVED) {
+          throw toReportableError(error);
+        }
+
+        try {
+          await sdk.stateTransitions.waitForAffectedState(stateTransition);
+        } catch (affectedStateError) {
+          throw toReportableError(affectedStateError);
+        }
+      }
     },
 
     /**
@@ -183,7 +260,7 @@ function createPlatformProofVerifier() {
         );
       }
 
-      const { sdk } = await getEvoSdkForNetwork(network);
+      const { sdk } = await loadEvoSdkForNetwork(network);
 
       const history = await sdk.contracts.getHistory({
         dataContractId: new Uint8Array(contractId),

@@ -65,6 +65,12 @@ function isValidBlockHeader(newHeader, previousHeaders, network = 'mainnet') {
     return false;
   }
 
+  // Dash Core disables difficulty retargeting on regtest.
+  if (network === 'regtest' && normalizedPreviousHeaders.length > 0) {
+    const previousHeader = normalizedPreviousHeaders[normalizedPreviousHeaders.length - 1];
+    return normalizedHeader.bits === previousHeader.bits;
+  }
+
   // A trusted checkpoint may contain fewer than a full DGW window. Proof of
   // work, the network pow limit, and timestamp rules still apply immediately;
   // exact difficulty validation begins as soon as the required history exists.

@@ -159,6 +159,27 @@ describe('Block header consensus validation', () => {
     consensus.isValidBlockHeader(nextHeader, wrongHistory, 'mainnet')
       .should.equal(false);
   });
+
+  it('should accept fast-mined regtest headers when Core retargeting is disabled', () => {
+    const previousHeaders = [new Blockchain('regtest').genesis];
+
+    while (previousHeaders.length < 24) {
+      previousHeaders.push(utils.createBlock(previousHeaders.at(-1), 0x207fffff));
+    }
+
+    const nextHeader = utils.createBlock(previousHeaders.at(-1), 0x207fffff);
+
+    consensus.isValidBlockHeader(nextHeader, previousHeaders, 'regtest')
+      .should.equal(true);
+  });
+
+  it('should reject a changed regtest target before the DGW history window', () => {
+    const { genesis } = new Blockchain('regtest');
+    const changedTargetHeader = utils.createBlock(genesis, 0x2070ffff);
+
+    consensus.isValidBlockHeader(changedTargetHeader, [genesis], 'regtest')
+      .should.equal(false);
+  });
 });
 
 describe('SPV-DASH (addHeaders) add many headers for testnet', () => {

@@ -47,6 +47,7 @@ import waitForConfirmations from './core/waitForConfirmations.js';
 import generateBlsKeys from './core/generateBlsKeys.js';
 import activateCoreSpork from './core/activateCoreSpork.js';
 import waitForCorePeersConnected from './core/waitForCorePeersConnected.js';
+import waitForNodesToHaveTheSameHeight from './core/waitForNodesToHaveTheSameHeight.js';
 
 import createNewAddress from './core/wallet/createNewAddress.js';
 import generateBlocks from './core/wallet/generateBlocks.js';
@@ -256,6 +257,7 @@ export default async function createDIContainer(options = {}) {
     generateBlsKeys: asValue(generateBlsKeys),
     activateCoreSpork: asValue(activateCoreSpork),
     waitForCorePeersConnected: asValue(waitForCorePeersConnected),
+    waitForNodesToHaveTheSameHeight: asValue(waitForNodesToHaveTheSameHeight),
   });
 
   /**