README added

Author: miniusercoder

.github/workflows/ci.yml

@@ -22,14 +22,16 @@ jobs:
         with:
           go-version: "1.22"
 
-      - name: Install cmake
-        run: sudo apt-get install -y cmake
+      - name: Install build dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y cmake make
 
-      - name: Build bee2 static library
-        run: bash scripts/build_bee2.sh
+      - name: Prepare project
+        run: make setup
 
       - name: go vet
         run: go vet ./...
 
       - name: Run tests
-        run: go test ./... -v -count=1
+        run: make test

.gitignore

@@ -0,0 +1,2 @@
+.idea/
+.vscode/

Makefile

@@ -0,0 +1,31 @@
+SHELL := /usr/bin/env bash
+
+.PHONY: help setup deps build-bee2 test run clean
+
+help:
+	@echo "Available targets:"
+	@echo "  make setup      - init submodules and build bee2 static library"
+	@echo "  make test       - run full test suite"
+	@echo "  make run        - run demo application"
+	@echo "  make clean      - remove bee2 build artifacts"
+
+deps:
+	@command -v go >/dev/null || (echo "go not found" && exit 1)
+	@command -v cmake >/dev/null || (echo "cmake not found" && exit 1)
+	@command -v git >/dev/null || (echo "git not found" && exit 1)
+
+setup: deps
+	git submodule update --init --recursive
+	bash scripts/build_bee2.sh
+
+build-bee2:
+	bash scripts/build_bee2.sh
+
+test: build-bee2
+	go test ./... -v -count=1
+
+run: build-bee2
+	go run ./cmd/demo
+
+clean:
+	rm -rf bee2/build

README.md

@@ -0,0 +1,166 @@
+# bee2go
+
+Go-обертки для [bee2](https://github.com/agievich/bee2) — C-реализации белорусских криптографических стандартов.
+
+Пакет предоставляет высокоуровневые обертки для:
+- `bash`: хеш и псевдослучайный генератор
+- `belt`: хеш, блочные режимы, MAC, AEAD, HMAC, PBKDF2 и обертка ключей
+- `bign`: параметры, генерация ключей, DH, подписи, транспорт ключей и подписи на основе идентичности
+- `bake`: аутентифицированная выработка ключа BSTS
+- `brng`: детерминированные генераторы случайных данных
+
+## Требования
+
+- Go 1.22+
+- Тулчейн C-компилятора
+- CMake
+- Исходники `bee2` доступны как git submodule в `./bee2`
+
+## Быстрый старт
+
+### 1. Клонирование
+
+```bash
+git clone --recurse-submodules https://github.com/miniusercoder/bee2go.git
+cd bee2go
+```
+
+Если репозиторий уже был клонирован без submodule:
+
+```bash
+git submodule update --init --recursive
+```
+
+### 2. Установил-запустил (одной командой)
+
+```bash
+make setup
+make run
+```
+
+Это:
+- подтянет submodule,
+- соберет статическую библиотеку `bee2`,
+- запустит демонстрационное приложение `cmd/demo`.
+
+### 3. Запуск тестов
+
+```bash
+make test
+```
+
+### 4. Ручной режим (без Makefile)
+
+Сборка статической библиотеки bee2:
+
+```bash
+bash scripts/build_bee2.sh
+```
+
+Запуск тестов:
+
+```bash
+go test ./... -v
+```
+
+## Установка
+
+Текущий поддерживаемый формат установки: работа из исходников репозитория с локальной сборкой `bee2`.
+
+Используйте шаги из раздела «Быстрый старт»:
+- `make setup`
+- `make run`
+- `make test`
+
+## Команды Makefile
+
+- `make setup` — подготовить проект к работе
+- `make run` — запустить demo (`cmd/demo`)
+- `make test` — запустить все тесты
+- `make clean` — удалить артефакты сборки `bee2/build`
+
+## Использование
+
+### Рекомендуемый UX для сторонних разработчиков: Go Workspace (`go work`)
+
+Этот вариант не требует правок `go.mod` вашего приложения и удобен для локальной разработки.
+
+1. Разместите ваш проект и `bee2go` рядом:
+
+```text
+workspace/
+  my-app/
+  bee2go/
+```
+
+2. Подготовьте `bee2go`:
+
+```bash
+cd bee2go
+make setup
+```
+
+3. Создайте workspace из каталога приложения:
+
+```bash
+cd ../my-app
+go work init . ../bee2go
+```
+
+4. Добавьте импорт в коде приложения:
+
+```go
+import "github.com/miniusercoder/bee2go"
+```
+
+5. Минимальный пример использования (belt-hash):
+
+```go
+package main
+
+import (
+	"fmt"
+	"log"
+
+	"github.com/miniusercoder/bee2go"
+)
+
+func main() {
+	digest, err := bee2go.BeltHash([]byte("hello"))
+	if err != nil {
+		log.Fatal(err)
+	}
+	fmt.Printf("belt-hash: %X\n", digest)
+}
+```
+
+6. Запустите приложение обычной командой `go run` или `go build`.
+
+## Стратегия тестирования
+
+В репозитории есть:
+- тесты с известными ответами (KAT), полученные из векторов upstream `bee2`
+- round-trip тесты для API шифрования/дешифрования и wrap/unwrap
+- тесты порчи данных и негативных сценариев для проверки аутентичности и подписей
+- тесты валидации аргументов: nil, размерные и форматные ограничения
+- интеграционные тесты для выработки ключа BSTS
+
+## CI
+
+Workflow GitHub Actions:
+- выполняет checkout репозитория с submodule
+- собирает статическую библиотеку `bee2`
+- запускает `go vet ./...`
+- запускает `make test`
+
+См. `.github/workflows/ci.yml`.
+
+## Замечания по безопасности
+
+- Большинство объектов-оберток хранят нативное C-состояние и небезопасны для конкурентного использования из нескольких goroutine.
+- Всегда вызывайте `Free()` для долгоживущих объектов, выделяющих память в C.
+- Не используйте демонстрационные ключи из примеров в production.
+
+## Лицензия
+
+Проект распространяется по лицензии, указанной в `LICENCE`.

bake_test.go

@@ -2,6 +2,8 @@ package bee2go
 
 import (
 	"bytes"
+	"fmt"
+	"sync"
 	"testing"
 )
 
@@ -75,39 +77,78 @@ func TestBakeBSTSRoundTrip(t *testing.T) {
 	}
 	defer stB.Free()
 
-	// ── Protocol flow ──────────────────────────────────────────────────────
-	//   B → A: M1  (B's ephemeral point)
-	//   A → B: M2  (A's ephemeral point + A's cert + A's key confirm)
-	//   B → A: M3  (B's cert + B's key confirm, validates A's cert)
-	//   A:          validates B's cert (Step5)
+	// ── Protocol flow with two concurrent parties ──────────────────────────
+	//   B goroutine: Step2 -> recv M2 -> Step4 -> StepG
+	//   A goroutine: recv M1 -> Step3 -> recv M3 -> Step5 -> StepG
+	m1Ch := make(chan []byte, 1)
+	m2Ch := make(chan []byte, 1)
+	m3Ch := make(chan []byte, 1)
+	keyACh := make(chan []byte, 1)
+	keyBCh := make(chan []byte, 1)
+	errCh := make(chan error, 2)
+
+	var wg sync.WaitGroup
+	wg.Add(2)
+
+	go func() {
+		defer wg.Done()
+		m1, err := stB.Step2()
+		if err != nil {
+			errCh <- fmt.Errorf("Step2: %w", err)
+			return
+		}
+		m1Ch <- m1
 
-	m1, err := stB.Step2()
-	if err != nil {
-		t.Fatal("Step2:", err)
-	}
+		m2 := <-m2Ch
+		m3, err := stB.Step4(m2, valFn)
+		if err != nil {
+			errCh <- fmt.Errorf("Step4: %w", err)
+			return
+		}
+		m3Ch <- m3
 
-	m2, err := stA.Step3(m1)
-	if err != nil {
-		t.Fatal("Step3:", err)
-	}
+		keyB, err := stB.StepG()
+		if err != nil {
+			errCh <- fmt.Errorf("StepG B: %w", err)
+			return
+		}
+		keyBCh <- keyB
+	}()
+
+	go func() {
+		defer wg.Done()
+		m1 := <-m1Ch
+		m2, err := stA.Step3(m1)
+		if err != nil {
+			errCh <- fmt.Errorf("Step3: %w", err)
+			return
+		}
+		m2Ch <- m2
 
-	m3, err := stB.Step4(m2, valFn)
-	if err != nil {
-		t.Fatal("Step4:", err)
-	}
+		m3 := <-m3Ch
+		if err := stA.Step5(m3, valFn); err != nil {
+			errCh <- fmt.Errorf("Step5: %w", err)
+			return
+		}
 
-	if err := stA.Step5(m3, valFn); err != nil {
-		t.Fatal("Step5:", err)
+		keyA, err := stA.StepG()
+		if err != nil {
+			errCh <- fmt.Errorf("StepG A: %w", err)
+			return
+		}
+		keyACh <- keyA
+	}()
+
+	wg.Wait()
+	close(errCh)
+	for err := range errCh {
+		if err != nil {
+			t.Fatal(err)
+		}
 	}
 
-	keyA, err := stA.StepG()
-	if err != nil {
-		t.Fatal("StepG A:", err)
-	}
-	keyB, err := stB.StepG()
-	if err != nil {
-		t.Fatal("StepG B:", err)
-	}
+	keyA := <-keyACh
+	keyB := <-keyBCh
 
 	if !bytes.Equal(keyA, keyB) {
 		t.Fatalf("session keys differ:\nA: %X\nB: %X", keyA, keyB)

cmd/demo/main.go

@@ -0,0 +1,17 @@
+package main
+
+import (
+	"fmt"
+	"log"
+
+	"github.com/miniusercoder/bee2go"
+)
+
+func main() {
+	digest, err := bee2go.BeltHash([]byte("hello bee2go"))
+	if err != nil {
+		log.Fatalf("belt hash failed: %v", err)
+	}
+
+	fmt.Printf("belt-hash(\"hello bee2go\") = %X\n", digest)
+}

go.mod

@@ -1,3 +1,3 @@
-module github.com/bee2-go/bee2go
+module github.com/miniusercoder/bee2go
 
 go 1.22