midnight-tooling:midnight-ci

Midnight CI/​CD Setup

Configure continuous integration for Midnight smart contract projects using GitHub Actions.

Overview

CI for Midnight projects should:

1. Verify contract compilation
2. Run TypeScript/​JavaScript tests
3. Validate version consistency
4. Optionally run integration tests with proof server

Quick Start

Copy the appropriate workflow template to your project:

mkdir -p .github/​workflows

# For contract compilation
cp ${CLAUDE_PLUGIN_ROOT}/​skills/​midnight-ci/​templates/​github-workflows/​compile-contracts.yml .github/​workflows/

# For full dApp testing
cp ${CLAUDE_PLUGIN_ROOT}/​skills/​midnight-ci/​templates/​github-workflows/​test-dapp.yml .github/​workflows/

Available Templates

Workflow Configuration

Environment Setup

All workflows need these tools:

• Node.js 18+
• Compact developer tools and compiler
• Docker (for proof server tests)

Compact Installation in CI

- name: Install Compact developer tools
  run: |
    curl --proto '=https' --tlsv1.2 -LsSf \
      https://github.com/​midnightntwrk/​compact/​releases/​latest/​download/​compact-installer.sh | sh
    echo "$HOME/​.compact/​bin" >> $GITHUB_PATH

- name: Install Compact compiler
  run: compact update

Caching

Cache Compact compiler for faster builds:

- name: Cache Compact compiler
  uses: actions/​cache@v4
  with:
    path: ~/​.compact
    key: compact-${{ runner.os }}-${{ hashFiles('.compact-version') }}
    restore-keys: |
      compact-${{ runner.os }}-

Create .compact-version file:

0.26.0

Version Pinning

For reproducible CI, pin the compiler version:

- name: Install specific compiler version
  run: |
    compact update 0.26.0
    compact compile --version  # Verify

Template Details

compile-contracts.yml

Minimal workflow for contract compilation:

name: Compile Contracts
on: [push, pull_request]

jobs:
  compile:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/​checkout@v4

      - name: Setup Node.js
        uses: actions/​setup-node@v4
        with:
          node-version: '20'

      - name: Install Compact
        run: |
          curl --proto '=https' --tlsv1.2 -LsSf \
            https://github.com/​midnightntwrk/​compact/​releases/​latest/​download/​compact-installer.sh | sh
          echo "$HOME/​.compact/​bin" >> $GITHUB_PATH
          compact update

      - name: Compile contracts
        run: compact compile contracts/​*.compact build/

test-dapp.yml

Full testing with proof server:

name: Test dApp
on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    services:
      proof-server:
        image: midnightnetwork/​proof-server:latest
        ports:
          - 6300:6300
        options: >-
          --health-cmd "curl -f http://localhost:6300/​health || exit 1"
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5

    steps:
      # ... setup steps ...

      - name: Run tests
        run: npm test
        env:
          PROOF_SERVER_URL: http://localhost:6300

Best Practices

1. Pin All Versions

env:
  NODE_VERSION: '20'
  COMPACT_VERSION: '0.26.0'
  PROOF_SERVER_TAG: '4.0.0'

2. Use npm ci

- name: Install dependencies
  run: npm ci

3. Cache Dependencies

- name: Cache node modules
  uses: actions/​cache@v4
  with:
    path: node_modules
    key: npm-${{ hashFiles('package-lock.json') }}

4. Fail Fast on Version Mismatch

Add a version check step:

- name: Verify version consistency
  run: |
    COMPILER_VERSION=$(compact compile --version)
    EXPECTED="0.26.0"
    if [[ "$COMPILER_VERSION" != *"$EXPECTED"* ]]; then
      echo "Version mismatch: expected $EXPECTED, got $COMPILER_VERSION"
      exit 1
    fi

5. Artifact Upload

Save compiled contracts:

- name: Upload compiled contracts
  uses: actions/​upload-artifact@v4
  with:
    name: contracts
    path: build/
    retention-days: 7

Troubleshooting CI

Compact not found

Ensure PATH is updated:

echo "$HOME/​.compact/​bin" >> $GITHUB_PATH

Proof server unhealthy

Increase startup time:

options: >-
  --health-retries 10
  --health-start-period 30s

Node version issues

Specify exact version:

node-version: '20.10.0'

Cache invalidation

Include version in cache key:

key: compact-${{ env.COMPACT_VERSION }}-${{ runner.os }}

Additional Resources

• templates/​github-workflows/ - Ready-to-use workflow files
• references/​ci-best-practices.md - Detailed CI guidance

For local environment setup, see the midnight-setup skill.