implement mollusk conformance testing (#26)

Author: buffalojoec

.github/workflows/main.yml

@@ -140,6 +140,37 @@ jobs:
             echo "CU usage has changed. Please run `cargo bench` and commit the new results.";
             exit 1;
           fi
+  
+  conformance:
+    name: Conformance Test
+    runs-on: ubuntu-latest
+    needs: build_programs
+    steps:
+      - name: Git Checkout
+        uses: actions/checkout@v4
+      
+      - name: Setup Environment
+        uses: ./.github/actions/setup
+        with:
+          cargo-cache-key: cargo-program-conformance
+          cargo-cache-fallback-key: cargo-programs
+          solana: true
+      
+      - name: Install System Dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libudev-dev pkg-config
+          command -v mollusk >/dev/null 2>&1 || cargo install mollusk-svm-cli
+      
+      - name: Restore Program Builds
+        uses: actions/cache/restore@v4
+        with:
+          path: ./**/*.so
+          key: ${{ runner.os }}-builds-${{ github.sha }}
+      
+      - name: Conformance Test
+        shell: bash
+        run: pnpm zx ./scripts/ci/conformance.mjs
 
   generate_idls:
     name: Check IDL Generation

scripts/ci/conformance.mjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env zx
+
+// Mollusk conformance testing of this Core BPF Feature Gate program against
+// the version running on mainnet-beta.
+
+import 'zx/globals';
+import { getProgramId, getProgramSharedObjectPath, workingDirectory } from '../utils.mjs';
+
+const programId = getProgramId('program');
+const programBinaryPath = getProgramSharedObjectPath('program');
+const baseBinaryDirPath = path.join(workingDirectory, 'target', 'dump-solana');
+const baseBinaryPath = path.join(baseBinaryDirPath, 'base.so');
+const molluskFixturesPath = path.join(workingDirectory, 'program', 'fuzz', 'blob');
+
+// Clone the program from mainnet-beta.
+await $`mkdir -p ${baseBinaryDirPath}`;
+await $`solana program dump -um ${programId} ${baseBinaryPath}`;
+
+// Test this program against the cloned program for conformance with Mollusk.
+let output = await $`mollusk run-test \
+    --proto firedancer --ignore-compute-units \
+    ${baseBinaryPath} ${programBinaryPath} \
+    ${molluskFixturesPath} ${programId}`;
+
+// The last line of output should exactly match the following:
+// [DONE][TEST RESULT]: 0 failures
+if (!output.stdout.includes("[DONE][TEST RESULT]: 0 failures")) {
+    throw new Error(`Error: mismatches detected.`);
+}

scripts/utils.mjs

@@ -70,6 +70,27 @@ export function getAllProgramFolders() {
   );
 }
 
+export function getProgramId(folder) {
+  return getCargoMetadata(folder)?.solana?.['program-id'];
+}
+
+export function getProgramName(folder) {
+  return getCargo(folder).package?.name;
+}
+
+export function getProgramSharedObjectName(folder) {
+  return `${getProgramName(folder).replace(/-/g, '_')}.so`;
+}
+
+export function getProgramSharedObjectPath(folder) {
+  return path.join(
+    workingDirectory,
+    'target',
+    'deploy',
+    getProgramSharedObjectName(folder),
+  );
+}
+
 export function getCargo(folder) {
   return parseToml(
     fs.readFileSync(