From dbc2e7c3279d8cd173605ecd30524b9c3e30886d Mon Sep 17 00:00:00 2001
From: Daniil Polyakov <arjentix@gmail.com>
Date: Tue, 17 Mar 2026 23:08:33 +0300
Subject: [PATCH 1/2] feat: run `publish_images` workflow on release tags

---
 .github/workflows/{publish_image.yml => publish_images.yml} | 4 ++++
 1 file changed, 4 insertions(+)
 rename .github/workflows/{publish_image.yml => publish_images.yml} (96%)

diff --git a/.github/workflows/publish_image.yml b/.github/workflows/publish_images.yml
similarity index 96%
rename from .github/workflows/publish_image.yml
rename to .github/workflows/publish_images.yml
index 457a98d0..619a6209 100644
--- a/.github/workflows/publish_image.yml
+++ b/.github/workflows/publish_images.yml
@@ -2,6 +2,9 @@ name: Publish Docker Images
 
 on:
   workflow_dispatch:
+  push:
+    tags:
+      - "v*"
 
 jobs:
   publish:
@@ -42,6 +45,7 @@ jobs:
         with:
           images: ${{ secrets.DOCKER_REGISTRY }}/${{ github.repository }}/${{ matrix.name }}
           tags: |
+            type=ref,event=tag
             type=ref,event=branch
             type=ref,event=pr
             type=semver,pattern={{version}}

From 2dbacdaff11c56b6f86e97b380edb0e169a7a01c Mon Sep 17 00:00:00 2001
From: Daniil Polyakov <arjentix@gmail.com>
Date: Tue, 17 Mar 2026 23:08:48 +0300
Subject: [PATCH 2/2] doc: add versioning documentation

---
 README.md | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index b0086f4a..5c3a698f 100644
--- a/README.md
+++ b/README.md
@@ -73,6 +73,16 @@ This design keeps public transactions as fast as any RISC-V–based VM and makes
 ---
 ---
 
+# Versioning
+
+We release versions as git tags (e.g. `v0.1.0`). If no critical issues with version is found you can expect it to be immutable. All further features and fixes will be a part of the next tag. As the project is in active development we don't provide backward compatibility yet.
+For each tag we publish docker images of our services.
+If you depend on this project you can pin your rust dependency to a git tag like this:
+
+```toml
+nssa_core = { git = "https://github.com/logos-blockchain/logos-execution-zone.git", tag = "v0.1.0" }
+```
+
 # Install dependencies
 ### Install build dependencies
 
@@ -141,12 +151,12 @@ The sequencer and logos blockchain node can be run locally:
     - `./scripts/setup-logos-blockchain-circuits.sh`
     - `cargo build --all-features`
     - `./target/debug/logos-blockchain-node --deployment nodes/node/standalone-deployment-config.yaml nodes/node/standalone-node-config.yaml`
-    
+
  - Alternatively (WARNING: This node is outdated) go to `logos-blockchain/lssa/` repo and run the node from docker:
     - `cd bedrock`
     - Change line 14 of `docker-compose.yml` from `"0:18080/tcp"` into `"8080:18080/tcp"`
     - `docker compose up`
-     
+
  2. On another terminal go to the `logos-blockchain/lssa` repo and run indexer service:
       - `RUST_LOG=info cargo run -p indexer_service indexer/service/configs/indexer_config.json`