SHA256
17 12 25
Промежуточная версия
This commit is contained in:
AidarKC
@@ -7,128 +7,98 @@ import java.util.Arrays;
|
||||
import java.util.Objects;
|
||||
|
||||
/**
|
||||
* ============================================================================
|
||||
* HeaderBody — тело записи типа 0 (заглавие блокчейна)
|
||||
* ============================================================================
|
||||
*.
|
||||
* 🧩 Назначение:
|
||||
* Первый блок каждой пользовательской цепочки (.bch) — это "заголовок".
|
||||
* Он хранит базовую информацию о владельце, версии и публичном ключе.
|
||||
*.
|
||||
* Этот блок всегда имеет:
|
||||
* • recordType = 0
|
||||
* • recordNumber = 0
|
||||
* • recordTypeVersion = 1
|
||||
*.
|
||||
* ----------------------------------------------------------------------------
|
||||
* 🔹 Формат body (без общих 20 байт заголовка блока BchBlock)
|
||||
*.
|
||||
* | Смещение | Размер | Поле | Формат | Описание |
|
||||
* |-----------|--------|--------------------|---------|-----------|
|
||||
* | 0x00 | 8 | tag | ASCII | Статическая сигнатура "SHiNE001" |
|
||||
* | 0x08 | 8 | blockchainId | long BE | Уникальный идентификатор цепочки |
|
||||
* | 0x10 | 1 | userLoginLength=N | uint8 | Длина логина пользователя |
|
||||
* | 0x11 | N | userLogin | UTF-8 | Логин пользователя |
|
||||
* | 0x11+N | 4 | blockchainType | int BE | Зарезервировано (всегда 0) |
|
||||
* | 0x15+N | 4 | blockchainNumber | int BE | Зарезервировано (всегда 0) |
|
||||
* | 0x19+N | 2 | versionUserBch | short BE| Версия формата (всегда 1) |
|
||||
* | 0x1B+N | 8 | prevUserBchId | long BE | Зарезервировано (всегда 0) |
|
||||
* | 0x23+N | 32 | publicKey32 | raw | Публичный ключ (Ed25519, 32 байта) |
|
||||
*.
|
||||
* ----------------------------------------------------------------------------
|
||||
* 💡 Пример структуры в байтах:
|
||||
*.
|
||||
* 0000: 53 48 69 4E 45 30 30 31 "SHiNE001"
|
||||
* 0008: 00 00 00 00 01 23 45 67 blockchainId
|
||||
* 0010: 05 userLoginLength = 5
|
||||
* 0011: 41 69 64 61 72 userLogin = "Aidar"
|
||||
* 0016: 00 00 00 00 blockchainType = 0
|
||||
* 001A: 00 00 00 00 blockchainNumber = 0
|
||||
* 001E: 00 01 versionUserBch = 1
|
||||
* 0020: 00 00 00 00 00 00 00 00 prevUserBchId = 0
|
||||
* 0028: [32 байта публичного ключа]
|
||||
*.
|
||||
* ----------------------------------------------------------------------------
|
||||
* 📘 Замечания:
|
||||
* • Поля blockchainType, blockchainNumber, versionUserBch, prevUserBchId
|
||||
* зарезервированы для будущего расширения формата.
|
||||
* • На данный момент все они принимают фиксированные значения:
|
||||
* blockchainType = 0
|
||||
* blockchainNumber = 0
|
||||
* versionUserBch = 1
|
||||
* prevUserBchId = 0
|
||||
*.
|
||||
* ============================================================================
|
||||
* HeaderBody_new — type=0, version=1.
|
||||
*
|
||||
* Полный bodyBytes:
|
||||
* [2] type=0
|
||||
* [2] version=1
|
||||
* [payload...]
|
||||
*
|
||||
* Payload (как у текущего HeaderBody):
|
||||
* [8] tag ASCII "SHiNE001"
|
||||
* [8] blockchainId (long BE)
|
||||
* [1] loginLength=N (uint8)
|
||||
* [N] userLogin UTF-8
|
||||
* [4] blockchainType (int BE) (резерв)
|
||||
* [4] blockchainNumber (int BE) (резерв)
|
||||
* [2] versionUserBch (short BE) (резерв)
|
||||
* [8] prevUserBchId (long BE) (резерв)
|
||||
* [32] publicKey32 (raw)
|
||||
*/
|
||||
public final class HeaderBody implements BodyRecord {
|
||||
|
||||
public static final short TYPE = 0;
|
||||
public static final short VER = 1;
|
||||
|
||||
public static final String TAG = "SHiNE001";
|
||||
public static final int PUBKEY_LEN = 32;
|
||||
|
||||
public final String tag; // всегда "SHiNE001"
|
||||
public final String tag; // "SHiNE001"
|
||||
public final long blockchainId;
|
||||
public final String userLogin; // UTF-8
|
||||
public final int blockchainType; // пока 0
|
||||
public final int blockchainNumber; // пока 0
|
||||
public final short versionUserBch; // пока 1
|
||||
public final long prevUserBchId; // пока 0
|
||||
public final byte[] publicKey32; // 32 байта
|
||||
public final String userLogin;
|
||||
public final int blockchainType;
|
||||
public final int blockchainNumber;
|
||||
public final short versionUserBch;
|
||||
public final long prevUserBchId;
|
||||
public final byte[] publicKey32;
|
||||
|
||||
// ------------------------------------------------------------
|
||||
// Конструктор №1 — из массива байт (для парсинга существующего блока)
|
||||
// ------------------------------------------------------------
|
||||
public HeaderBody(byte[] body) {
|
||||
Objects.requireNonNull(body, "body == null");
|
||||
if (body.length < 8 + 8 + 1 + 2 + 4 + 4 + 8 + 32)
|
||||
throw new IllegalArgumentException("HeaderBody слишком короткое");
|
||||
/**
|
||||
* Десериализация из полного bodyBytes (ВКЛЮЧАЯ первые 4 байта type/version).
|
||||
*/
|
||||
public HeaderBody(byte[] bodyBytes) {
|
||||
Objects.requireNonNull(bodyBytes, "bodyBytes == null");
|
||||
if (bodyBytes.length < 4) throw new IllegalArgumentException("HeaderBody_new too short");
|
||||
|
||||
ByteBuffer buf = ByteBuffer.wrap(body).order(ByteOrder.BIG_ENDIAN);
|
||||
ByteBuffer bb = ByteBuffer.wrap(bodyBytes).order(ByteOrder.BIG_ENDIAN);
|
||||
short type = bb.getShort();
|
||||
short ver = bb.getShort();
|
||||
if (type != TYPE || ver != VER)
|
||||
throw new IllegalArgumentException("Not HeaderBody_new: type=" + type + " ver=" + ver);
|
||||
|
||||
// Теперь bb стоит на payload
|
||||
if (bb.remaining() < 8 + 8 + 1 + 4 + 4 + 2 + 8 + 32)
|
||||
throw new IllegalArgumentException("Header payload too short");
|
||||
|
||||
// [8] тег
|
||||
byte[] tagBytes = new byte[8];
|
||||
buf.get(tagBytes);
|
||||
String tag = new String(tagBytes, StandardCharsets.US_ASCII);
|
||||
if (!TAG.equals(tag))
|
||||
throw new IllegalArgumentException("Неверный тег: " + tag);
|
||||
this.tag = tag;
|
||||
bb.get(tagBytes);
|
||||
String t = new String(tagBytes, StandardCharsets.US_ASCII);
|
||||
if (!TAG.equals(t)) throw new IllegalArgumentException("Bad tag: " + t);
|
||||
this.tag = t;
|
||||
|
||||
// [8] blockchainId
|
||||
this.blockchainId = buf.getLong();
|
||||
this.blockchainId = bb.getLong();
|
||||
|
||||
// [1] длина логина
|
||||
int loginLen = Byte.toUnsignedInt(buf.get());
|
||||
if (loginLen == 0 || buf.remaining() < loginLen + 4 + 4 + 2 + 8 + 32)
|
||||
throw new IllegalArgumentException("Некорректная длина логина");
|
||||
int loginLen = Byte.toUnsignedInt(bb.get());
|
||||
if (loginLen <= 0 || bb.remaining() < loginLen + 4 + 4 + 2 + 8 + 32)
|
||||
throw new IllegalArgumentException("Bad login length");
|
||||
|
||||
// [N] логин
|
||||
byte[] loginBytes = new byte[loginLen];
|
||||
buf.get(loginBytes);
|
||||
bb.get(loginBytes);
|
||||
this.userLogin = new String(loginBytes, StandardCharsets.UTF_8);
|
||||
|
||||
// Остальные поля
|
||||
this.blockchainType = buf.getInt();
|
||||
this.blockchainNumber = buf.getInt();
|
||||
this.versionUserBch = buf.getShort();
|
||||
this.prevUserBchId = buf.getLong();
|
||||
this.blockchainType = bb.getInt();
|
||||
this.blockchainNumber = bb.getInt();
|
||||
this.versionUserBch = bb.getShort();
|
||||
this.prevUserBchId = bb.getLong();
|
||||
|
||||
this.publicKey32 = new byte[PUBKEY_LEN];
|
||||
buf.get(this.publicKey32);
|
||||
bb.get(this.publicKey32);
|
||||
}
|
||||
|
||||
// ------------------------------------------------------------
|
||||
// Конструктор №2 — из параметров (для создания нового заголовка)
|
||||
// ------------------------------------------------------------
|
||||
public HeaderBody(long blockchainId, String userLogin,
|
||||
int blockchainType, int blockchainNumber,
|
||||
short versionUserBch, long prevUserBchId,
|
||||
/**
|
||||
* Создание “вручную” (для генерации первого блока).
|
||||
*/
|
||||
public HeaderBody(long blockchainId,
|
||||
String userLogin,
|
||||
int blockchainType,
|
||||
int blockchainNumber,
|
||||
short versionUserBch,
|
||||
long prevUserBchId,
|
||||
byte[] publicKey32) {
|
||||
|
||||
Objects.requireNonNull(userLogin, "userLogin == null");
|
||||
Objects.requireNonNull(publicKey32, "publicKey32 == null");
|
||||
|
||||
if (publicKey32.length != PUBKEY_LEN)
|
||||
throw new IllegalArgumentException("Публичный ключ должен состоять из 32 байт");
|
||||
throw new IllegalArgumentException("publicKey32 must be 32 bytes");
|
||||
|
||||
this.tag = TAG;
|
||||
this.blockchainId = blockchainId;
|
||||
@@ -140,17 +110,17 @@ public final class HeaderBody implements BodyRecord {
|
||||
this.publicKey32 = Arrays.copyOf(publicKey32, PUBKEY_LEN);
|
||||
}
|
||||
|
||||
// ------------------------------------------------------------
|
||||
// Проверка и сериализация
|
||||
// ------------------------------------------------------------
|
||||
@Override public short type() { return TYPE; }
|
||||
@Override public short version() { return VER; }
|
||||
|
||||
@Override
|
||||
public HeaderBody check() {
|
||||
if (userLogin == null || userLogin.isBlank())
|
||||
throw new IllegalArgumentException("Логин не может быть пустым");
|
||||
throw new IllegalArgumentException("Login is blank");
|
||||
if (!userLogin.matches("^[A-Za-z0-9_]+$"))
|
||||
throw new IllegalArgumentException("Логин может содержать только латиницу, цифры и _");
|
||||
throw new IllegalArgumentException("Login must match ^[A-Za-z0-9_]+$");
|
||||
if (publicKey32 == null || publicKey32.length != PUBKEY_LEN)
|
||||
throw new IllegalArgumentException("Публичный ключ должен быть 32 байта");
|
||||
throw new IllegalArgumentException("publicKey32 must be 32 bytes");
|
||||
return this;
|
||||
}
|
||||
|
||||
@@ -158,34 +128,28 @@ public final class HeaderBody implements BodyRecord {
|
||||
public byte[] toBytes() {
|
||||
byte[] loginUtf8 = userLogin.getBytes(StandardCharsets.UTF_8);
|
||||
if (loginUtf8.length > 255)
|
||||
throw new IllegalArgumentException("Логин слишком длинный (>255 байт)");
|
||||
throw new IllegalArgumentException("Login too long (>255 bytes)");
|
||||
|
||||
int cap = 8 + 8 + 1 + loginUtf8.length + 4 + 4 + 2 + 8 + 32;
|
||||
ByteBuffer buf = ByteBuffer.allocate(cap).order(ByteOrder.BIG_ENDIAN);
|
||||
int payloadCap = 8 + 8 + 1 + loginUtf8.length + 4 + 4 + 2 + 8 + 32;
|
||||
int cap = 4 + payloadCap;
|
||||
|
||||
buf.put(TAG.getBytes(StandardCharsets.US_ASCII)); // [8]
|
||||
buf.putLong(blockchainId); // [8]
|
||||
buf.put((byte) loginUtf8.length); // [1]
|
||||
buf.put(loginUtf8); // [N]
|
||||
buf.putInt(blockchainType); // [4]
|
||||
buf.putInt(blockchainNumber); // [4]
|
||||
buf.putShort(versionUserBch); // [2]
|
||||
buf.putLong(prevUserBchId); // [8]
|
||||
buf.put(publicKey32); // [32]
|
||||
ByteBuffer bb = ByteBuffer.allocate(cap).order(ByteOrder.BIG_ENDIAN);
|
||||
|
||||
return buf.array();
|
||||
// [type/version]
|
||||
bb.putShort(TYPE);
|
||||
bb.putShort(VER);
|
||||
|
||||
// payload
|
||||
bb.put(TAG.getBytes(StandardCharsets.US_ASCII)); // [8]
|
||||
bb.putLong(blockchainId); // [8]
|
||||
bb.put((byte) loginUtf8.length); // [1]
|
||||
bb.put(loginUtf8); // [N]
|
||||
bb.putInt(blockchainType); // [4]
|
||||
bb.putInt(blockchainNumber); // [4]
|
||||
bb.putShort(versionUserBch); // [2]
|
||||
bb.putLong(prevUserBchId); // [8]
|
||||
bb.put(publicKey32); // [32]
|
||||
|
||||
return bb.array();
|
||||
}
|
||||
|
||||
@Override
|
||||
public String toString() {
|
||||
return "HeaderBody{" +
|
||||
"id=" + blockchainId +
|
||||
", login='" + userLogin + '\'' +
|
||||
", type=" + blockchainType +
|
||||
", num=" + blockchainNumber +
|
||||
", ver=" + versionUserBch +
|
||||
", prev=" + prevUserBchId +
|
||||
", pubkey32=" + Arrays.toString(Arrays.copyOf(publicKey32, 4)) + "..." +
|
||||
'}';
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user