Frankie/core#v0.3.0.rc 1

.github/workflows/test.yaml

@@ -12,9 +12,10 @@ on:
 jobs:
   build_test_lint:
     name: Build, test, and lint
+    runs-on: ubuntu-22.04
+    timeout-minutes: 45
     permissions:
       contents: read
-    runs-on: ubuntu-22.04
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
@@ -33,6 +34,6 @@ jobs:
           password: ${{ secrets.DOCKER_HUB_CI_TOKEN }}
       - name: Add TSS server host mappings
         run: |
-          echo "127.0.0.1 alice-tss-server bob-tss-server" | sudo tee -a /etc/hosts
+          echo "127.0.0.1 alice-tss-server bob-tss-server charlie-tss-server dave-tss-server" | sudo tee -a /etc/hosts
       - name: Test
         run: yarn run test

CHANGELOG.md

@@ -14,22 +14,26 @@ Version header format: `[version] Name - year-month-day (entropy-core compatibil
 
 ### Added
   - `configurationSchema` & `auxiliaryDataSchema` to `ProgramInterface`
-
+  - added new testing function `jumpStartNetwork(entropy: Entropy) => Promise<undefined>` This function must be called now with a funded key to kick off the network. **It will not work for networks with less then 4 validators**
+  - added new docker script for four nodes
+  - `spinNetworkDown` now has an access to the env var `ENTROPY_DONT_KILL` which will preserve the network
+    the initial though for this was to look at network logs for debugging
 
 ### Fixed
 
-### Changed
+### Breaking Changes
   - util function rename: `hex2buf` -> `hexStringToBuffer`
   - massive changes to `entropy.programs.dev`: (Look at documentation for more details)
     - `getProgramInfo` -> `get` and bytecode is returned as a buffer. not a Uint8buffer to match what was deployed
     - you now get owned programs for an address using `getByDeployer`.
     - interface name change: `ProgramInfo` -> `ProgramInterface`
-### Broke
 
-### Dev
-
-### Meta
+### Removed
+  - `dev/docker-scripts/two-nodes.yaml`
 
+### Dev
+  - update core version: v0.3.0
+  -
 
 ## [0.2.3] Cybele - 2024-07-24 (entropy-core compatibility: 0.2.0)
 

README.md

@@ -298,7 +298,6 @@ A promise indicating the completion of the registration process.
 
 await entropy.register({
   // insert address to specify ProgramModAccount
-  keyVisibility: 'Permissioned',
   initialPrograms: [programData],
   programModAccount: '5Gw3s7q9...',
 })

dev/README.md

@@ -33,6 +33,8 @@ For the tests to run you **must** edit your `/etc/hosts` file, adding:
 ```
 127.0.0.1   alice-tss-server
 127.0.0.1   bob-tss-server
+127.0.0.1   charlie-tss-server
+127.0.0.1   dave-tss-server
 ```
 
 ### Gotcha 1 - dirty docker
@@ -45,13 +47,13 @@ that program is already deployed boo").
 Have a look what's running:
 
 ```bash
-docker ps
+docker container list
 ```
 
 You can close them down like this:
 
 ```bash
-docker compose --file dev/docker-scripts/two-nodes.yaml down
+docker compose --file dev/docker-scripts/four-nodes.yaml down
 ```
 
 ### Gotcha 2 - ports still in use?
@@ -80,7 +82,7 @@ export ENTROPY_CORE_VERSION=latest
 If you must do this you should run
 
 ```bash
-docker compose --file dev/docker-scripts/two-nodes.yaml pull
+docker compose --file dev/docker-scripts/four-nodes.yaml pull
 ```
 
 ## When updating core version:
@@ -91,9 +93,9 @@ docker compose --file dev/docker-scripts/two-nodes.yaml pull
    directly from the root directory and then call the generate types script and
    then the spin down script:
 
-- `dev/bin/spin-up.sh two-nodes`
+- `dev/bin/spin-up.sh four-nodes`
 - `dev/bin/generate-types.sh`
-- `dev/bin/spin-down.sh two-nodes`
+- `dev/bin/spin-down.sh four-nodes`
 
 2. run `yarn tsc` just to make sure that went "okay" or as okay as it can be.
    generated types are ignored in tsc check but are used in project (kind of not

dev/bin/ENTROPY_CORE_VERSION.sh

@@ -1,3 +1,3 @@
 #! /usr/bin/env bash
 
-export ENTROPY_CORE_VERSION=release-v0.2.0
+export ENTROPY_CORE_VERSION=release-v0.3.0

dev/bin/remove-db.sh

@@ -0,0 +1,5 @@
+#! /usr/bin/env bash
+
+rm -rf .entropy
+docker compose --file dev/docker-scripts/four-nodes.yaml down 2> /dev/null
+docker compose --file dev/docker-scripts/one-node-no-tss.yaml down 2> /dev/null

dev/docker-scripts/four-nodes.yaml

@@ -0,0 +1,152 @@
+# Docker Compose file for making an Entropy blockchain network.
+# Currently, it's intended for LOCAL DEVNET FUNCTIONALITY ONLY.
+# Things will get better and more generic, but for the moment
+# this iteration is for simplifying the dogfooding and testing
+# workflows our engineers use, and trying to cut down on some
+# of the more complicated test code that spins up this kind of
+# environment for their tests. Eventually, we will converge on
+# a more canonical set of environments and configuration files.
+---
+name: entropy-devnet-local-4-nodes
+
+services:
+  alice-tss-server:
+    # This pulls from Docker Hub,  so you can replace the image tag name
+    # (the string after the `:` in the `image` key) with chatCharlier tag
+    # name you'd like to use. Each Docker image is built from a specific
+    # commit in the `entropy-core` repository. Refer to the wiki page at
+    # https://github.com/entropyxyz/meta/wiki/Git#conventions for details
+    # about how Git tags, branches, and commits refer to image tags here.
+    image: entropyxyz/entropy-tss:${ENTROPY_CORE_VERSION:-latest}
+    ports:
+      - "127.0.0.1:3001:3001/tcp"
+    command:
+      - "--alice"
+      - "--threshold-url"
+      - "0.0.0.0:3001"
+      - "--chain-endpoint"
+      - "ws://alice-chain-node:9944"
+      - "--no-sync"
+
+  alice-chain-node:
+    image: entropyxyz/entropy:${ENTROPY_CORE_VERSION:-latest}
+    ports:
+      - "127.0.0.1:9944:9944/tcp"
+    volumes:
+      - ${PWD}/dev:/srv/entropy/dev
+    command:
+      - "--chain"
+      - "devnet-local"
+      - "--alice"
+      - "--base-path"
+      - ".entropy/alice"
+      - "--rpc-port"
+      - "9944"
+      - "--rpc-cors"
+      - "all"
+      - "--unsafe-rpc-external" # Intentional, for TSS's access.
+      - "--node-key=0000000000000000000000000000000000000000000000000000000000000001"
+      - "--tss-server-endpoint"
+      - "http://alice-tss-server:3001"
+
+  bob-tss-server:
+    image: entropyxyz/entropy-tss:${ENTROPY_CORE_VERSION:-latest}
+    ports:
+      - "127.0.0.1:3002:3002/tcp"
+    command:
+      - "--bob"
+      - "--threshold-url"
+      - "0.0.0.0:3002"
+      - "--chain-endpoint"
+      - "ws://bob-chain-node:9944"
+      - "--no-sync"
+
+  # "Bob's chain node."
+  bob-chain-node:
+    image: entropyxyz/entropy:${ENTROPY_CORE_VERSION:-latest}
+    ports:
+      - "127.0.0.1:9945:9944/tcp"
+    volumes:
+      - ${PWD}/dev:/srv/entropy/dev
+    command:
+      - "--chain"
+      - "devnet-local"
+      - "--bob"
+      - "--base-path"
+      - ".entropy/bob"
+      - "--rpc-port"
+      - "9944"
+      - "--rpc-cors"
+      - "all"
+      - "--unsafe-rpc-external" # Intentional, for TSS's access.
+      - "--bootnodes"
+      - "/dns4/alice-chain-node/tcp/30333/p2p/12D3KooWEyoppNCUx8Yx66oV9fJnriXwCcXwDDUA2kj6vnc6iDEp"
+      - "--tss-server-endpoint"
+      - "http://bob-tss-server:3002"
+
+  charlie-tss-server:
+    image: entropyxyz/entropy-tss:${ENTROPY_CORE_VERSION:-latest}
+    ports:
+      - "127.0.0.1:3003:3003/tcp"
+    command:
+      - "--charlie"
+      - "--threshold-url"
+      - "0.0.0.0:3003"
+      - "--chain-endpoint"
+      - "ws://charlie-chain-node:9944"
+      - "--no-sync"
+
+  charlie-chain-node:
+    image: entropyxyz/entropy:${ENTROPY_CORE_VERSION:-latest}
+    ports:
+      - "127.0.0.1:9946:9944/tcp"
+    volumes:
+      - ${PWD}/dev:/srv/entropy/dev
+    command:
+      - "--chain"
+      - "devnet-local"
+      - "--charlie"                 # Shortcut for `--name Charlie --validator`
+      - "--base-path"
+      - ".entropy/charlie"
+      - "--rpc-port"
+      - "9944"
+      - "--rpc-cors"
+      - "all"
+      - "--unsafe-rpc-external" # Intentional, for TSS's access.
+      - "--bootnodes"
+      - "/dns4/alice-chain-node/tcp/30333/p2p/12D3KooWEyoppNCUx8Yx66oV9fJnriXwCcXwDDUA2kj6vnc6iDEp"
+      - "--tss-server-endpoint"
+      - "http://charlie-tss-server:3003"
+  dave-tss-server:
+    image: entropyxyz/entropy-tss:${ENTROPY_CORE_VERSION:-latest}
+    ports:
+      - "127.0.0.1:3004:3004/tcp"
+    command:
+      - "--dave"
+      - "--threshold-url"
+      - "0.0.0.0:3004"
+      - "--chain-endpoint"
+      - "ws://dave-chain-node:9944"
+      - "--no-sync"
+
+  dave-chain-node:
+    image: entropyxyz/entropy:${ENTROPY_CORE_VERSION:-latest}
+    ports:
+      - "127.0.0.1:9947:9944/tcp"
+    volumes:
+      - ${PWD}/dev:/srv/entropy/dev
+    command:
+      - "--chain"
+      - "devnet-local"
+      - "--dave"                 # Shortcut for `--name Dave --validator`
+      - "--base-path"
+      - ".entropy/dave"
+      - "--rpc-port"
+      - "9944"
+      - "--rpc-cors"
+      - "all"
+      - "--unsafe-rpc-external" # Intentional, for TSS's access.
+      - "--bootnodes"
+      - "/dns4/alice-chain-node/tcp/30333/p2p/12D3KooWEyoppNCUx8Yx66oV9fJnriXwCcXwDDUA2kj6vnc6iDEp"
+      - "--tss-server-endpoint"
+      - "http://dave-tss-server:3004"

dev/docker-scripts/one-node-no-tss.yaml

@@ -14,13 +14,22 @@ name: entropy-devnet-local
 
 services:
   alice-chain-node:
-    image: entropyxyz/entropy:$ENTROPY_CORE_VERSION
+    image: entropyxyz/entropy:${ENTROPY_CORE_VERSION:-latest}
     ports:
-      - "127.0.0.1:9944:9944/tcp"   # "RPC Port."
+      - "127.0.0.1:9944:9944/tcp"
+    volumes:
+      - ${PWD}/dev:/srv/entropy/dev
     command:
       - "--chain"
       - "devnet-local"
+      - "--alice"
+      - "--base-path"
+      - ".entropy/alice"
       - "--rpc-port"
       - "9944"
       - "--rpc-cors"
       - "all"
+      - "--unsafe-rpc-external" # Intentional, for TSS's access.
+      - "--node-key=0000000000000000000000000000000000000000000000000000000000000001"
+      - "--tss-server-endpoint"
+      - "http://alice-tss-server:3001"