Merge branch 'unstable' into cayman/ssz-api

.dockerignore

@@ -46,11 +46,11 @@ packages/beacon-node/mainnet_pubkeys.csv
 # Autogenerated docs
 packages/**/docs
 packages/**/typedocs
-docs/packages
-docs/contributing.md
-docs/assets
-docs/reference/cli.md
-/site
+docs/pages/**/*-cli.md
+docs/pages/assets
+docs/pages/api/api-reference.md
+docs/pages/contribution/getting-started.md
+docs/site
 
 # Lodestar artifacts
 .lodestar

.github/workflows/docs.yml

@@ -4,21 +4,41 @@ on:
   push:
     branches:
       - stable
+  workflow_dispatch:
+    inputs:
+      ref:
+        description: 'Ref to deploy, defaults to `unstable`'
+        required: false
+        default: 'unstable'
+        type: string
 
 jobs:
   docs:
     runs-on: buildjet-4vcpu-ubuntu-2204
+    env:
+      DEPLOY_REF: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.ref || 'stable' }}
     steps:
-      # <common-build> - Uses YAML anchors in the future
+      # Log out the ref being deployed
+      - name: Log Deployment Ref
+        if: github.event_name == 'workflow_dispatch'
+        run: |
+          echo "Deploying ref: $DEPLOY_REF"
+
+      # Checkout the correct ref being deployed
       - uses: actions/checkout@v3
+        with:
+          ref: ${{ env.DEPLOY_REF }}
+
       - uses: actions/setup-node@v3
         with:
           node-version: 20
           check-latest: true
           cache: yarn          
+
       - name: Node.js version
         id: node
         run: echo "v8CppApiVersion=$(node --print "process.versions.modules")" >> $GITHUB_OUTPUT
+
       - name: Restore dependencies
         uses: actions/cache@master
         id: cache-deps
@@ -27,13 +47,14 @@ jobs:
             node_modules
             packages/*/node_modules
           key: ${{ runner.os }}-${{ steps.node.outputs.v8CppApiVersion }}-${{ hashFiles('**/yarn.lock', '**/package.json') }}
+
       - name: Install & build
         if: steps.cache-deps.outputs.cache-hit != 'true'
         run: yarn install --frozen-lockfile && yarn build
+
       - name: Build
         run: yarn build
         if: steps.cache-deps.outputs.cache-hit == 'true'
-      # </common-build>
 
       - name: Build and collect docs
         run: yarn build:docs
@@ -45,15 +66,17 @@ jobs:
         uses: actions/setup-python@v1
 
       - name: Install dependencies
+        working-directory: docs
         run: |
           python -m pip install --upgrade pip
-          pip install -r docs/requirements.txt
+          pip install -r requirements.txt
 
       - name: Build docs
-        run: mkdocs build --site-dir site -v --clean
+        working-directory: docs
+        run: mkdocs build --verbose --clean --site-dir site
 
       - name: Deploy
         uses: peaceiris/actions-gh-pages@v3
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./site
+          publish_dir: ./docs/site

.github/workflows/test.yml

@@ -270,7 +270,10 @@ jobs:
             packages/*/.git-data.json
           key: ${{ runner.os }}-node-${{ matrix.node }}-${{ github.sha }}
           fail-on-cache-miss: true
-
+      - name: Install Chrome browser
+        run: npx @puppeteer/browsers install chromedriver@latest --path /tmp          
+      - name: Install Firefox browser
+        run: npx @puppeteer/browsers install firefox@latest --path /tmp
       - name: Browser tests
         run: |
           export DISPLAY=':99.0'

.gitignore

@@ -40,11 +40,15 @@ packages/api/oapi-schemas
 # Autogenerated docs
 packages/**/docs
 packages/**/typedocs
-docs/assets
-docs/packages
-docs/reference
-docs/contributing.md
-/site
+docs/pages/**/*-cli.md
+docs/pages/assets
+docs/pages/images
+docs/pages/security.md
+docs/pages/lightclient-prover/lightclient.md
+docs/pages/lightclient-prover/prover.md
+docs/pages/api/api-reference.md
+docs/pages/contribution/getting-started.md
+docs/site
 
 # Testnet artifacts
 .lodestar

.wordlist.txt

@@ -1,14 +1,19 @@
 APIs
+Andreas
+Antonopoulos
 AssemblyScript
 BLS
 BeaconNode
 Besu
+Buterin
 CLA
 CLI
 CTRL
+Casper
 Chai
 ChainSafe
 Customizations
+DPoS
 Discv
 DockerHub
 Dockerized
@@ -19,22 +24,33 @@ ENR
 ENRs
 ESLint
 ETH
+Edgington
 Erigon
 EthStaker
+EtherScan
 Ethereum
+EthereumJS
+FINDNODE
 FX
 Flamegraph
 Flamegraphs
+Geth
 Github
 Gossipsub
 Grafana
 HackMD
+Homebrew
+IPFS
 IPv
 Infura
 JSON
+JSObjects
 JWT
+KDE
 LGPL
 LGPLv
+LMD
+LPoS
 LTS
 Lerna
 MEV
@@ -45,10 +61,12 @@ NVM
 Nethermind
 NodeJS
 NodeSource
+OSI
 PR
 PRs
 Plaintext
 PoS
+Prysm
 Quickstart
 RPC
 SHA
@@ -57,64 +75,102 @@ SSZ
 Stakehouse
 TOC
 TTD
+Teku
 TypeScript
 UI
 UID
+UPnP
 UTF
 VM
 Vitalik
 Wagyu
 api
 async
+backfill
 beaconcha
+blockchain
 bootnode
 bootnodes
 chainConfig
 chainsafe
+chiado
 cli
 cmd
+codebase
 config
 configs
 const
 constantish
 coreutils
 cors
+cryptocurrency
 cryptographic
 dApp
 dApps
+ddos
 decrypt
 deserialization
+dev
 devnet
 devnets
+devtools
+eg
+enodes
 enum
+env
 envs
+ephemery
 flamegraph
 flamegraphs
+gnosis
 goerli
+heapdump
+heaptrack
+holesky
 interop
+js
 keypair
 keystore
 keystores
+libp
 lightclient
 linter
+lldb
+llnode
 lockfile
 mainnet
+malloc
 mdns
 merkle
 merkleization
 monorepo
+multiaddr
+multifork
 namespace
 namespaced
 namespaces
 nodemodule
+orchestrator
+osx
 overriden
 params
+pid
 plaintext
+pre
+premined
 produceBlockV
+protolambda
 prover
+repo
+repos
 req
 reqresp
+responder
+ropsten
 runtime
+scalability
+secp
+sepolia
 sharding
 ssz
 stakers
@@ -131,4 +187,6 @@ utils
 validator
 validators
 wip
+xcode
 yaml
+yamux