From ff9301eddb660a221958fe358cdced87fb386a8fa8d983138431d1ec1ab89837 Mon Sep 17 00:00:00 2001 From: AidarKC Date: Thu, 4 Dec 2025 12:20:47 +0300 Subject: [PATCH] =?UTF-8?q?=D0=A1=D1=82=D0=B0=D1=80=D1=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitignore | 43 +++ .idea/.gitignore | 8 + .idea/artifacts/server_jar.xml | 10 + .idea/gradle.xml | 23 ++ .idea/misc.xml | 10 + .idea/vcs.xml | 6 + META-INF/MANIFEST.MF | 3 + build.gradle | 72 ++++ gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 60756 bytes gradle/wrapper/gradle-wrapper.properties | 6 + gradlew | 234 ++++++++++++ gradlew.bat | 89 +++++ settings.gradle | 8 + shine-server-blockchain/build.gradle | 33 ++ shine-server-config/build.gradle | 25 ++ .../src/main/java/utils/config/AppConfig.java | 58 +++ shine-server-db/build.gradle | 26 ++ shine-server-db/concat_to_file.sh | 16 + .../java/shine/db/DatabaseInitializer.java | 126 +++++++ .../java/shine/db/SqliteDbController.java | 82 ++++ .../java/shine/db/dao/ActiveSessionsDAO.java | 116 ++++++ .../java/shine/db/dao/SolanaUsersDAO.java | 119 ++++++ .../main/java/shine/db/dao/UserParamsDAO.java | 136 +++++++ .../java/shine/db/entities/ActiveSession.java | 98 +++++ .../java/shine/db/entities/SolanaUser.java | 76 ++++ .../java/shine/db/entities/UserParam.java | 87 +++++ .../src/main/java/Описание таблиц в БД.md | 44 +++ shine-server-net-protocol/build.gradle | 35 ++ shine-server-net-protocol/concat_to_file.sh | 16 + .../ws_protocol/JSON/ConnectionContext.java | 137 +++++++ .../ws_protocol/JSON/JsonHandlerRegistry.java | 49 +++ .../JSON/JsonInboundProcessor.java | 158 ++++++++ .../Auth/NetAuthSessionNewStep1Request.java | 14 + .../Auth/NetAuthSessionNewStep1Response.java | 14 + .../Auth/NetSessionRefreshRequest.java | 34 ++ .../Auth/NetSessionRefreshResponse.java | 12 + .../ws_protocol/JSON/entyties/NetEvent.java | 41 ++ .../JSON/entyties/NetExceptionResponse.java | 14 + .../ws_protocol/JSON/entyties/NetRequest.java | 29 ++ .../JSON/entyties/NetResponse.java | 34 ++ .../tempToTest/NetAddUserRequest.java | 76 ++++ .../tempToTest/NetAddUserResponse.java | 11 + .../JSON/handlers/JsonMessageHandler.java | 19 + .../JSON/handlers/auth/NetAddUserHandler.java | 98 +++++ .../auth/NetAuthSessionNewStep1Handler.java | 79 ++++ .../auth/NetSessionRefreshHandler.java | 94 +++++ .../ws_protocol/JSON/Описание протокола.md | 52 +++ .../server/logic/ws_protocol/WireCodes.java | 102 +++++ ...ини памятка по классам джисон протокола.md | 29 ++ shine-server-net-server/build.gradle | 36 ++ src/TestJsonWsClient2 | 0 src/main/docs/Запуск на сервере.txt | 10 + src/main/docs/План работ до мвп/ДАО.md | 13 + src/main/docs/План работ до мвп/Инвестиции.md | 67 ++++ .../Правила получения новых акаунтов.md | 4 + .../План работ до мвп/Функции в Solana.md | 29 ++ .../Кто есть сияющие(5 пунктов).md | 27 ++ .../Описанией записей/Начало блокчейна.md | 45 +++ .../Смена Пароля/сама схема смены цп.md | 49 +++ .../docs/Формат блоков/Что пишем в solana.md | 27 ++ .../структура блока/Запись в блокчейн.txt | 66 ++++ .../структура блока/типы субблокченов.md | 13 + src/main/java/CreateNewDatabase.java | 9 + src/main/java/TestJsonWsClient.java | 106 ++++++ src/main/java/TestJsonWsClient2.java | 119 ++++++ src/main/java/WsTestClient.java | 356 ++++++++++++++++++ .../server/logic/InboundMessageProcessor.java | 66 ++++ .../binary/handlers/AddBlockHandler.java | 250 ++++++++++++ .../binary/handlers/GetBlockchainHandler.java | 53 +++ .../handlers/GetLastBlockInfoHandler.java | 66 ++++ .../binary/handlers/MessageHandler.java | 11 + .../binary/handlers/PingHandler.java | 16 + .../binary/handlers/SearchUsersHandler.java | 59 +++ .../java/server/ws/BlockchainWsEndpoint.java | 141 +++++++ src/main/java/server/ws/README.md | 85 +++++ src/main/java/server/ws/WsServer.java | 48 +++ src/main/resources/application.properties | 5 + src/main/resources/logback.xml | 33 ++ src/test_ws.html | 145 +++++++ 79 files changed, 4655 insertions(+) create mode 100644 .gitignore create mode 100644 .idea/.gitignore create mode 100644 .idea/artifacts/server_jar.xml create mode 100644 .idea/gradle.xml create mode 100644 .idea/misc.xml create mode 100644 .idea/vcs.xml create mode 100644 META-INF/MANIFEST.MF create mode 100644 build.gradle create mode 100644 gradle/wrapper/gradle-wrapper.jar create mode 100644 gradle/wrapper/gradle-wrapper.properties create mode 100755 gradlew create mode 100644 gradlew.bat create mode 100644 settings.gradle create mode 100644 shine-server-blockchain/build.gradle create mode 100644 shine-server-config/build.gradle create mode 100644 shine-server-config/src/main/java/utils/config/AppConfig.java create mode 100644 shine-server-db/build.gradle create mode 100755 shine-server-db/concat_to_file.sh create mode 100644 shine-server-db/src/main/java/shine/db/DatabaseInitializer.java create mode 100644 shine-server-db/src/main/java/shine/db/SqliteDbController.java create mode 100644 shine-server-db/src/main/java/shine/db/dao/ActiveSessionsDAO.java create mode 100644 shine-server-db/src/main/java/shine/db/dao/SolanaUsersDAO.java create mode 100644 shine-server-db/src/main/java/shine/db/dao/UserParamsDAO.java create mode 100644 shine-server-db/src/main/java/shine/db/entities/ActiveSession.java create mode 100644 shine-server-db/src/main/java/shine/db/entities/SolanaUser.java create mode 100644 shine-server-db/src/main/java/shine/db/entities/UserParam.java create mode 100644 shine-server-db/src/main/java/Описание таблиц в БД.md create mode 100644 shine-server-net-protocol/build.gradle create mode 100755 shine-server-net-protocol/concat_to_file.sh create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/ConnectionContext.java create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/JsonHandlerRegistry.java create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/JsonInboundProcessor.java create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/Auth/NetAuthSessionNewStep1Request.java create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/Auth/NetAuthSessionNewStep1Response.java create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/Auth/NetSessionRefreshRequest.java create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/Auth/NetSessionRefreshResponse.java create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/NetEvent.java create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/NetExceptionResponse.java create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/NetRequest.java create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/NetResponse.java create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/tempToTest/NetAddUserRequest.java create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/tempToTest/NetAddUserResponse.java create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/JsonMessageHandler.java create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/NetAddUserHandler.java create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/NetAuthSessionNewStep1Handler.java create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/NetSessionRefreshHandler.java create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/Описание протокола.md create mode 100644 shine-server-net-protocol/src/main/java/server/logic/ws_protocol/WireCodes.java create mode 100644 shine-server-net-protocol/src/main/java/Мини памятка по классам джисон протокола.md create mode 100644 shine-server-net-server/build.gradle create mode 100644 src/TestJsonWsClient2 create mode 100644 src/main/docs/Запуск на сервере.txt create mode 100644 src/main/docs/План работ до мвп/ДАО.md create mode 100644 src/main/docs/План работ до мвп/Инвестиции.md create mode 100644 src/main/docs/План работ до мвп/Правила получения новых акаунтов.md create mode 100644 src/main/docs/План работ до мвп/Функции в Solana.md create mode 100644 src/main/docs/Принципы сияния/Кто есть сияющие(5 пунктов).md create mode 100644 src/main/docs/Формат блоков/Описанией записей/Начало блокчейна.md create mode 100644 src/main/docs/Формат блоков/Смена Пароля/сама схема смены цп.md create mode 100644 src/main/docs/Формат блоков/Что пишем в solana.md create mode 100644 src/main/docs/Формат блоков/структура блока/Запись в блокчейн.txt create mode 100644 src/main/docs/Формат блоков/структура блока/типы субблокченов.md create mode 100644 src/main/java/CreateNewDatabase.java create mode 100644 src/main/java/TestJsonWsClient.java create mode 100644 src/main/java/TestJsonWsClient2.java create mode 100644 src/main/java/WsTestClient.java create mode 100644 src/main/java/server/logic/InboundMessageProcessor.java create mode 100644 src/main/java/server/logic/ws_protocol/binary/handlers/AddBlockHandler.java create mode 100644 src/main/java/server/logic/ws_protocol/binary/handlers/GetBlockchainHandler.java create mode 100644 src/main/java/server/logic/ws_protocol/binary/handlers/GetLastBlockInfoHandler.java create mode 100644 src/main/java/server/logic/ws_protocol/binary/handlers/MessageHandler.java create mode 100644 src/main/java/server/logic/ws_protocol/binary/handlers/PingHandler.java create mode 100644 src/main/java/server/logic/ws_protocol/binary/handlers/SearchUsersHandler.java create mode 100644 src/main/java/server/ws/BlockchainWsEndpoint.java create mode 100644 src/main/java/server/ws/README.md create mode 100644 src/main/java/server/ws/WsServer.java create mode 100644 src/main/resources/application.properties create mode 100644 src/main/resources/logback.xml create mode 100644 src/test_ws.html diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..39eea9c --- /dev/null +++ b/.gitignore @@ -0,0 +1,43 @@ +.gradle +build/ +!gradle/wrapper/gradle-wrapper.jar +!**/src/main/**/build/ +!**/src/test/**/build/ +.kotlin + +### IntelliJ IDEA ### +.idea/modules.xml +.idea/jarRepositories.xml +.idea/compiler.xml +.idea/libraries/ +*.iws +*.iml +*.ipr +out/ +!**/src/main/**/out/ +!**/src/test/**/out/ + +### Eclipse ### +.apt_generated +.classpath +.factorypath +.project +.settings +.springBeans +.sts4-cache +bin/ +!**/src/main/**/bin/ +!**/src/test/**/bin/ + +### NetBeans ### +/nbproject/private/ +/nbbuild/ +/dist/ +/nbdist/ +/.nb-gradle/ + +### VS Code ### +.vscode/ + +### Mac OS ### +.DS_Store \ No newline at end of file diff --git a/.idea/.gitignore b/.idea/.gitignore new file mode 100644 index 0000000..c2083d3 --- /dev/null +++ b/.idea/.gitignore @@ -0,0 +1,8 @@ +# Default ignored files +/shelf/ +/workspace.xml +# Editor-based HTTP Client requests +/httpRequests/ +# Datasource local storage ignored files +/dataSources/ +/dataSources.local.xml diff --git a/.idea/artifacts/server_jar.xml b/.idea/artifacts/server_jar.xml new file mode 100644 index 0000000..a890428 --- /dev/null +++ b/.idea/artifacts/server_jar.xml @@ -0,0 +1,10 @@ + + + $PROJECT_DIR$/out/artifacts/server_jar + + + + + + + \ No newline at end of file diff --git a/.idea/gradle.xml b/.idea/gradle.xml new file mode 100644 index 0000000..bf9f39a --- /dev/null +++ b/.idea/gradle.xml @@ -0,0 +1,23 @@ + + + + + + + \ No newline at end of file diff --git a/.idea/misc.xml b/.idea/misc.xml new file mode 100644 index 0000000..a19bb71 --- /dev/null +++ b/.idea/misc.xml @@ -0,0 +1,10 @@ + + + + + + + + + + \ No newline at end of file diff --git a/.idea/vcs.xml b/.idea/vcs.xml new file mode 100644 index 0000000..321f217 --- /dev/null +++ b/.idea/vcs.xml @@ -0,0 +1,6 @@ + + + + + + \ No newline at end of file diff --git a/META-INF/MANIFEST.MF b/META-INF/MANIFEST.MF new file mode 100644 index 0000000..c76d1ec --- /dev/null +++ b/META-INF/MANIFEST.MF @@ -0,0 +1,3 @@ +Manifest-Version: 1.0 +Main-Class: server.ws.WsServer + diff --git a/build.gradle b/build.gradle new file mode 100644 index 0000000..bf9e86f --- /dev/null +++ b/build.gradle @@ -0,0 +1,72 @@ +plugins { + id 'java' + id 'application' + id 'com.github.johnrengelman.shadow' version '8.1.1' +} + +group = 'shine' +version = '1.0' + +tasks.jar { + enabled = false // это что бы не создавала обычный джар, а будет только толстый джар +} + +repositories { + mavenCentral() +} + +dependencies { + implementation 'org.eclipse.jetty:jetty-server:11.0.20' + implementation 'org.eclipse.jetty:jetty-servlet:11.0.20' + implementation 'org.eclipse.jetty.websocket:websocket-jetty-server:11.0.20' + implementation 'org.bouncycastle:bcprov-jdk18on:1.78.1' // шифрование + implementation 'com.fasterxml.jackson.core:jackson-databind:2.17.1' // json + + implementation 'org.slf4j:slf4j-api:2.0.9' + implementation 'ch.qos.logback:logback-classic:1.5.6' + + testImplementation platform('org.junit:junit-bom:5.10.0') + testImplementation 'org.junit.jupiter:junit-jupiter' + + + implementation project(':shine-server-config') // модуль настроек из application.properties + implementation project(':shine-server-crypto') // модуль сервера для работы с криптографией + implementation project(':shine-server-blockchain') // модуль для работы с блокчейном + implementation project(':shine-server-db') // модуль для работы с БД содержит и сущности из БД и саму работу с БД + + implementation project(':shine-server-net-protocol') // Модуль отвечающий за протокол (классы Net..Request/Response + implementation project(':shine-server-net-server') // Хэндлеры для обработки сетевых запросов + + +} + +application { + // 👇 класс с методом main + mainClass = 'server.ws.WsServer' +} + + +java { + toolchain { + languageVersion = JavaLanguageVersion.of(17) + } +} + + +shadowJar { + // создаём 1 файл без постфиксов + archiveBaseName.set('shine-server') + archiveClassifier.set('') + archiveVersion.set('') + mergeServiceFiles() + + manifest { + attributes( + 'Main-Class': 'server.ws.WsServer' + ) + } +} + +test { + useJUnitPlatform() +} diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000000000000000000000000000..e06f1edcaa3f16f442e6eb7798fa8434a8f1c19fd263a5d1cf63704be7231a2f GIT binary patch literal 60756 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 '} + case $link in #( + /*) app_path=$link ;; #( + *) app_path=$APP_HOME$link ;; + esac +done + +APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit + +APP_NAME="Gradle" +APP_BASE_NAME=${0##*/} + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"' + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD=maximum + +warn () { + echo "$*" +} >&2 + +die () { + echo + echo "$*" + echo + exit 1 +} >&2 + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +nonstop=false +case "$( uname )" in #( + CYGWIN* ) cygwin=true ;; #( + Darwin* ) darwin=true ;; #( + MSYS* | MINGW* ) msys=true ;; #( + NONSTOP* ) nonstop=true ;; +esac + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD=$JAVA_HOME/jre/sh/java + else + JAVACMD=$JAVA_HOME/bin/java + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD=java + which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." +fi + +# Increase the maximum file descriptors if we can. +if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then + case $MAX_FD in #( + max*) + MAX_FD=$( ulimit -H -n ) || + warn "Could not query maximum file descriptor limit" + esac + case $MAX_FD in #( + '' | soft) :;; #( + *) + ulimit -n "$MAX_FD" || + warn "Could not set maximum file descriptor limit to $MAX_FD" + esac +fi + +# Collect all arguments for the java command, stacking in reverse order: +# * args from the command line +# * the main class name +# * -classpath +# * -D...appname settings +# * --module-path (only if needed) +# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables. + +# For Cygwin or MSYS, switch paths to Windows format before running java +if "$cygwin" || "$msys" ; then + APP_HOME=$( cygpath --path --mixed "$APP_HOME" ) + CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" ) + + JAVACMD=$( cygpath --unix "$JAVACMD" ) + + # Now convert the arguments - kludge to limit ourselves to /bin/sh + for arg do + if + case $arg in #( + -*) false ;; # don't mess with options #( + /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath + [ -e "$t" ] ;; #( + *) false ;; + esac + then + arg=$( cygpath --path --ignore --mixed "$arg" ) + fi + # Roll the args list around exactly as many times as the number of + # args, so each arg winds up back in the position where it started, but + # possibly modified. + # + # NB: a `for` loop captures its iteration list before it begins, so + # changing the positional parameters here affects neither the number of + # iterations, nor the values presented in `arg`. + shift # remove old arg + set -- "$@" "$arg" # push replacement arg + done +fi + +# Collect all arguments for the java command; +# * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of +# shell script including quotes and variable substitutions, so put them in +# double quotes to make sure that they get re-expanded; and +# * put everything else in single quotes, so that it's not re-expanded. + +set -- \ + "-Dorg.gradle.appname=$APP_BASE_NAME" \ + -classpath "$CLASSPATH" \ + org.gradle.wrapper.GradleWrapperMain \ + "$@" + +# Use "xargs" to parse quoted args. +# +# With -n1 it outputs one arg per line, with the quotes and backslashes removed. +# +# In Bash we could simply go: +# +# readarray ARGS < <( xargs -n1 <<<"$var" ) && +# set -- "${ARGS[@]}" "$@" +# +# but POSIX shell has neither arrays nor command substitution, so instead we +# post-process each arg (as a line of input to sed) to backslash-escape any +# character that might be a shell metacharacter, then use eval to reverse +# that process (while maintaining the separation between arguments), and wrap +# the whole thing up as a single "set" statement. +# +# This will of course break if any of these variables contains a newline or +# an unmatched quote. +# + +eval "set -- $( + printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" | + xargs -n1 | + sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' | + tr '\n' ' ' + )" '"$@"' + +exec "$JAVACMD" "$@" diff --git a/gradlew.bat b/gradlew.bat new file mode 100644 index 0000000..9a51268 --- /dev/null +++ b/gradlew.bat @@ -0,0 +1,89 @@ +@rem +@rem Copyright 2015 the original author or authors. +@rem +@rem Licensed under the Apache License, Version 2.0 (the "License"); +@rem you may not use this file except in compliance with the License. +@rem You may obtain a copy of the License at +@rem +@rem https://www.apache.org/licenses/LICENSE-2.0 +@rem +@rem Unless required by applicable law or agreed to in writing, software +@rem distributed under the License is distributed on an "AS IS" BASIS, +@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +@rem See the License for the specific language governing permissions and +@rem limitations under the License. +@rem + +@if "%DEBUG%" == "" @echo off +@rem ########################################################################## +@rem +@rem Gradle startup script for Windows +@rem +@rem ########################################################################## + +@rem Set local scope for the variables with windows NT shell +if "%OS%"=="Windows_NT" setlocal + +set DIRNAME=%~dp0 +if "%DIRNAME%" == "" set DIRNAME=. +set APP_BASE_NAME=%~n0 +set APP_HOME=%DIRNAME% + +@rem Resolve any "." and ".." in APP_HOME to make it shorter. +for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi + +@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m" + +@rem Find java.exe +if defined JAVA_HOME goto findJavaFromJavaHome + +set JAVA_EXE=java.exe +%JAVA_EXE% -version >NUL 2>&1 +if "%ERRORLEVEL%" == "0" goto execute + +echo. +echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:findJavaFromJavaHome +set JAVA_HOME=%JAVA_HOME:"=% +set JAVA_EXE=%JAVA_HOME%/bin/java.exe + +if exist "%JAVA_EXE%" goto execute + +echo. +echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:execute +@rem Setup the command line + +set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar + + +@rem Execute Gradle +"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %* + +:end +@rem End local scope for the variables with windows NT shell +if "%ERRORLEVEL%"=="0" goto mainEnd + +:fail +rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of +rem the _cmd.exe /c_ return code! +if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 +exit /b 1 + +:mainEnd +if "%OS%"=="Windows_NT" endlocal + +:omega diff --git a/settings.gradle b/settings.gradle new file mode 100644 index 0000000..9988e51 --- /dev/null +++ b/settings.gradle @@ -0,0 +1,8 @@ +rootProject.name = 'shine-server-server' + +include 'shine-server-config' +include 'shine-server-crypto' +include 'shine-server-blockchain' +include 'shine-server-db' +include 'shine-server-net-protocol' +include 'shine-server-net-server' \ No newline at end of file diff --git a/shine-server-blockchain/build.gradle b/shine-server-blockchain/build.gradle new file mode 100644 index 0000000..0bf3de5 --- /dev/null +++ b/shine-server-blockchain/build.gradle @@ -0,0 +1,33 @@ +plugins { + id 'java' +} + +group = 'shine' +version = '1.0.0' + +java { + toolchain { + languageVersion = JavaLanguageVersion.of(17) + } +} + +repositories { + mavenCentral() +} + +dependencies { + // модуль блокчейна использует крипту + implementation project(':shine-server-crypto') + + // JSON (BchInfoManager) + implementation 'com.fasterxml.jackson.core:jackson-databind:2.18.1' + + // логгер + implementation 'org.slf4j:slf4j-api:2.0.16' + + testImplementation 'org.junit.jupiter:junit-jupiter:5.11.0' +} + +test { + useJUnitPlatform() +} diff --git a/shine-server-config/build.gradle b/shine-server-config/build.gradle new file mode 100644 index 0000000..0b7c42a --- /dev/null +++ b/shine-server-config/build.gradle @@ -0,0 +1,25 @@ +plugins { + id 'java' +} + +group = 'shine' +version = '1.0.0' + +repositories { + mavenCentral() +} + +java { + toolchain { + languageVersion = JavaLanguageVersion.of(17) + } +} + +dependencies { + // обычно тут пусто, максимум логгер и тесты + testImplementation 'org.junit.jupiter:junit-jupiter:5.11.0' +} + +test { + useJUnitPlatform() +} diff --git a/shine-server-config/src/main/java/utils/config/AppConfig.java b/shine-server-config/src/main/java/utils/config/AppConfig.java new file mode 100644 index 0000000..934afbf --- /dev/null +++ b/shine-server-config/src/main/java/utils/config/AppConfig.java @@ -0,0 +1,58 @@ +package utils.config; + + +import java.io.IOException; +import java.io.InputStream; +import java.util.Properties; + +public final class AppConfig { + + private static volatile AppConfig instance; + private final Properties properties = new Properties(); + + private AppConfig() { + load(); + } + + public static AppConfig getInstance() { + if (instance == null) { + synchronized (AppConfig.class) { + if (instance == null) { + instance = new AppConfig(); + } + } + } + return instance; + } + + private void load() { + try (InputStream in = getClass().getClassLoader() + .getResourceAsStream("application.properties")) { + + if (in == null) { + throw new RuntimeException("Config file application.properties not found"); + } + + properties.load(in); + + } catch (IOException e) { + throw new RuntimeException("Failed to load application.properties", e); + } + } + + /** Вернёт значение строки или null, если параметр не найден */ + public String getParam(String name) { + return properties.getProperty(name); + } + + /** Можно добавить методы для удобства */ + public int getInt(String name, int defaultValue) { + String v = properties.getProperty(name); + return v == null ? defaultValue : Integer.parseInt(v); + } + + public boolean getBoolean(String name, boolean defaultValue) { + String v = properties.getProperty(name); + return v == null ? defaultValue : Boolean.parseBoolean(v); + } +} diff --git a/shine-server-db/build.gradle b/shine-server-db/build.gradle new file mode 100644 index 0000000..ce1a117 --- /dev/null +++ b/shine-server-db/build.gradle @@ -0,0 +1,26 @@ +plugins { + id 'java' +} + +group = 'shine' +version = '1.0.0' + +java { + toolchain { + languageVersion = JavaLanguageVersion.of(17) + } +} + +repositories { + mavenCentral() +} + +dependencies { + implementation 'org.xerial:sqlite-jdbc:3.47.0.0' + implementation project(':shine-server-config') // модуль с настройками +} + +java { + sourceCompatibility = JavaVersion.VERSION_17 + targetCompatibility = JavaVersion.VERSION_17 +} diff --git a/shine-server-db/concat_to_file.sh b/shine-server-db/concat_to_file.sh new file mode 100755 index 0000000..901712c --- /dev/null +++ b/shine-server-db/concat_to_file.sh @@ -0,0 +1,16 @@ +#!/usr/bin/env bash +set -euo pipefail + +OUTFILE="all_files.txt" + +# очищаем или создаём файл +: > "$OUTFILE" + +# собрать только *.java файлы и вывести их содержимое в файл +find . -type f -name "*.java" | sort | while read -r f; do + cat "$f" >> "$OUTFILE" + echo >> "$OUTFILE" # пустая строка-разделитель +done + +echo "Готово! Все .java файлы собраны в $OUTFILE" + diff --git a/shine-server-db/src/main/java/shine/db/DatabaseInitializer.java b/shine-server-db/src/main/java/shine/db/DatabaseInitializer.java new file mode 100644 index 0000000..72a2ba1 --- /dev/null +++ b/shine-server-db/src/main/java/shine/db/DatabaseInitializer.java @@ -0,0 +1,126 @@ +package shine.db; + + +import utils.config.AppConfig; + +import java.io.BufferedReader; +import java.io.IOException; +import java.io.InputStreamReader; +import java.nio.file.*; +import java.sql.Connection; +import java.sql.DriverManager; +import java.sql.SQLException; +import java.sql.Statement; + +public class DatabaseInitializer { + + public static void createNewDB(String[] args) { + AppConfig config = AppConfig.getInstance(); + String dbPath = config.getParam("db.path"); + + if (dbPath == null || dbPath.isBlank()) { + System.err.println("Параметр db.path не задан в application.properties"); + return; + } + + Path dbFile = Paths.get(dbPath); + try { + // создаём директорию, если нужно + Path parent = dbFile.getParent(); + if (parent != null && !Files.exists(parent)) { + Files.createDirectories(parent); + } + + if (Files.exists(dbFile)) { + System.out.println("Файл базы данных уже существует: " + dbFile.toAbsolutePath()); + System.out.print("Пересоздать БД (СТАРАЯ БУДЕТ УДАЛЕНА)? [y/N]: "); + + BufferedReader reader = new BufferedReader(new InputStreamReader(System.in)); + String answer = reader.readLine(); + if (!"y".equalsIgnoreCase(answer) && !"yes".equalsIgnoreCase(answer)) { + System.out.println("Операция отменена. БД не изменена."); + return; + } + + Files.delete(dbFile); + System.out.println("Старый файл БД удалён."); + } + + createSchema("jdbc:sqlite:" + dbPath); + System.out.println("Новая БД успешно создана по пути: " + dbFile.toAbsolutePath()); + + } catch (IOException e) { + System.err.println("Ошибка работы с файлом БД: " + e.getMessage()); + } catch (SQLException e) { + System.err.println("Ошибка создания схемы БД: " + e.getMessage()); + } + } + + private static void createSchema(String jdbcUrl) throws SQLException { + try { + Class.forName("org.sqlite.JDBC"); + } catch (ClassNotFoundException e) { + throw new RuntimeException("SQLite JDBC driver not found", e); + } + + try (Connection conn = DriverManager.getConnection(jdbcUrl); + Statement st = conn.createStatement()) { + + // включаем внешние ключи на этом соединении (для инициализации тоже) + st.execute("PRAGMA foreign_keys = ON"); + + // 1. Таблица solana_users + st.executeUpdate(""" + CREATE TABLE IF NOT EXISTS solana_users ( + login TEXT NOT NULL, + loginId INTEGER NOT NULL PRIMARY KEY, + bchId INTEGER NOT NULL, + pubkey0 TEXT, + pubkey1 TEXT, + bchLimit INTEGER -- может быть NULL + ); + """); + + st.executeUpdate(""" + CREATE INDEX IF NOT EXISTS idx_solana_users_login + ON solana_users (login); + """); + + // 2. Таблица active_sessions + st.executeUpdate(""" + CREATE TABLE IF NOT EXISTS active_sessions ( + sessionId INTEGER NOT NULL PRIMARY KEY, + session_pwd TEXT NOT NULL, + loginId INTEGER NOT NULL, + time_ms INTEGER NOT NULL, + pubkey_num INTEGER NOT NULL, + push_endpoint TEXT, + push_p256dh_key TEXT, + push_auth_key TEXT, + FOREIGN KEY (loginId) REFERENCES solana_users(loginId) + ); + """); + + // 3. Таблица users_params + // Важно: пара (loginId, param) должна быть уникальна + st.executeUpdate(""" + CREATE TABLE IF NOT EXISTS users_params ( + loginId INTEGER NOT NULL, + param TEXT NOT NULL, + bch_channel_id INTEGER NOT NULL DEFAULT 0, + value TEXT, + time_ms INTEGER NOT NULL, + pubkey_num INTEGER NOT NULL, + signature TEXT, + FOREIGN KEY (loginId) REFERENCES solana_users(loginId), + UNIQUE (loginId, param) + ); + """); + + st.executeUpdate(""" + CREATE INDEX IF NOT EXISTS idx_users_params_loginId + ON users_params (loginId); + """); + } + } +} diff --git a/shine-server-db/src/main/java/shine/db/SqliteDbController.java b/shine-server-db/src/main/java/shine/db/SqliteDbController.java new file mode 100644 index 0000000..11399be --- /dev/null +++ b/shine-server-db/src/main/java/shine/db/SqliteDbController.java @@ -0,0 +1,82 @@ +package shine.db; + +import shine.db.dao.ActiveSessionsDAO; +import utils.config.AppConfig; + +import java.nio.file.Files; +import java.nio.file.Path; +import java.nio.file.Paths; +import java.sql.Connection; +import java.sql.DriverManager; +import java.sql.SQLException; +import java.sql.Statement; + +public final class SqliteDbController { + + private static volatile SqliteDbController instance; + private final Connection connection; + + private SqliteDbController() { + try { + // Подгружаем драйвер SQLite + Class.forName("org.sqlite.JDBC"); + } catch (ClassNotFoundException e) { + throw new RuntimeException("SQLite JDBC driver not found", e); + } + + String dbPath = AppConfig.getInstance().getParam("db.path"); + + if (dbPath == null || dbPath.isBlank()) { + throw new RuntimeException("Config param 'db.path' is not set in application.properties"); + } + + Path dbFile = Paths.get(dbPath); + + // 👉 Если файла БД нет — создаём новую БД через DatabaseInitializer + if (!Files.exists(dbFile)) { + System.out.println("[DB] Файл БД не найден: " + dbFile.toAbsolutePath()); + System.out.println("[DB] Создаём новую БД с помощью DatabaseInitializer..."); + + // можно передать пустой массив аргументов + DatabaseInitializer.createNewDB(new String[0]); + } + + String url = "jdbc:sqlite:" + dbPath; + + try { + this.connection = DriverManager.getConnection(url); + this.connection.setAutoCommit(true); + + // ВАЖНО: включаем поддержку внешних ключей для этого соединения + try (Statement st = this.connection.createStatement()) { + st.execute("PRAGMA foreign_keys = ON"); + } + + } catch (SQLException e) { + throw new RuntimeException("Failed to connect to SQLite database: " + url, e); + } + } + + public static SqliteDbController getInstance() { + if (instance == null) { + synchronized (SqliteDbController.class) { + if (instance == null) { + instance = new SqliteDbController(); + } + } + } + return instance; + } + + public Connection getConnection() { + return connection; + } + + public void close() { + try { + connection.close(); + } catch (SQLException e) { + // логировать по необходимости + } + } +} diff --git a/shine-server-db/src/main/java/shine/db/dao/ActiveSessionsDAO.java b/shine-server-db/src/main/java/shine/db/dao/ActiveSessionsDAO.java new file mode 100644 index 0000000..cd9603b --- /dev/null +++ b/shine-server-db/src/main/java/shine/db/dao/ActiveSessionsDAO.java @@ -0,0 +1,116 @@ +package shine.db.dao; + +import shine.db.SqliteDbController; +import shine.db.entities.ActiveSession; + +import java.sql.*; + +/** Здесь мы хрним данные об активных сессиях пользователя (для wss соединений) */ + +public final class ActiveSessionsDAO { + + private static volatile ActiveSessionsDAO instance; + private final SqliteDbController db = SqliteDbController.getInstance(); + + private ActiveSessionsDAO() { + } + + public static ActiveSessionsDAO getInstance() { + if (instance == null) { + synchronized (ActiveSessionsDAO.class) { + if (instance == null) { + instance = new ActiveSessionsDAO(); + } + } + } + return instance; + } + + public void insert(ActiveSession session) throws SQLException { + String sql = """ + INSERT INTO active_sessions ( + sessionId, + session_pwd, + loginId, + time_ms, + pubkey_num, + push_endpoint, + push_p256dh_key, + push_auth_key + ) VALUES (?, ?, ?, ?, ?, ?, ?, ?) + """; + + try (PreparedStatement ps = db.getConnection().prepareStatement(sql)) { + ps.setLong(1, session.getSessionId()); + ps.setString(2, session.getSessionPwd()); + ps.setLong(3, session.getLoginId()); + ps.setLong(4, session.getTimeMs()); + ps.setInt(5, session.getPubkeyNum()); + ps.setString(6, session.getPushEndpoint()); + ps.setString(7, session.getPushP256dhKey()); + ps.setString(8, session.getPushAuthKey()); + ps.executeUpdate(); + } + } + + public ActiveSession getBySessionId(long sessionId) throws SQLException { + String sql = """ + SELECT + sessionId, + session_pwd, + loginId, + time_ms, + pubkey_num, + push_endpoint, + push_p256dh_key, + push_auth_key + FROM active_sessions + WHERE sessionId = ? + """; + + try (PreparedStatement ps = db.getConnection().prepareStatement(sql)) { + ps.setLong(1, sessionId); + try (ResultSet rs = ps.executeQuery()) { + if (!rs.next()) { + return null; + } + return mapRow(rs); + } + } + } + + /** + * Удаление записи по sessionId. + * Если записи нет — просто ничего не удалит (0 строк). + */ + public void deleteBySessionId(long sessionId) throws SQLException { + String sql = "DELETE FROM active_sessions WHERE sessionId = ?"; + + try (PreparedStatement ps = db.getConnection().prepareStatement(sql)) { + ps.setLong(1, sessionId); + ps.executeUpdate(); + } + } + + private ActiveSession mapRow(ResultSet rs) throws SQLException { + long sessionId = rs.getLong("sessionId"); + String sessionPwd = rs.getString("session_pwd"); + long loginId = rs.getLong("loginId"); + long timeMs = rs.getLong("time_ms"); + short pubkeyNum = (short) rs.getInt("pubkey_num"); + String pushEndpoint = rs.getString("push_endpoint"); + String pushP256dhKey = rs.getString("push_p256dh_key"); + String pushAuthKey = rs.getString("push_auth_key"); + + return new ActiveSession( + sessionId, + sessionPwd, + loginId, + timeMs, + pubkeyNum, + pushEndpoint, + pushP256dhKey, + pushAuthKey + ); + } +} diff --git a/shine-server-db/src/main/java/shine/db/dao/SolanaUsersDAO.java b/shine-server-db/src/main/java/shine/db/dao/SolanaUsersDAO.java new file mode 100644 index 0000000..a379dd9 --- /dev/null +++ b/shine-server-db/src/main/java/shine/db/dao/SolanaUsersDAO.java @@ -0,0 +1,119 @@ +package shine.db.dao; + +import shine.db.SqliteDbController; +import shine.db.entities.SolanaUser; + +import java.sql.*; +import java.util.ArrayList; +import java.util.List; + +/** Здесь храним данные об пользователях - локальная копия того что есть в солане */ + +public final class SolanaUsersDAO { + + private static volatile SolanaUsersDAO instance; + private final SqliteDbController db = SqliteDbController.getInstance(); + + private SolanaUsersDAO() {} + + public static SolanaUsersDAO getInstance() { + if (instance == null) { + synchronized (SolanaUsersDAO.class) { + if (instance == null) { + instance = new SolanaUsersDAO(); + } + } + } + return instance; + } + + public void insert(SolanaUser user) throws SQLException { + String sql = """ + INSERT INTO solana_users (login, loginId, bchId, pubkey0, pubkey1, bchLimit) + VALUES (?, ?, ?, ?, ?, ?) + """; + + try (PreparedStatement ps = db.getConnection().prepareStatement(sql)) { + ps.setString(1, user.getLogin()); + ps.setLong(2, user.getLoginId()); + ps.setLong(3, user.getBchId()); + ps.setString(4, user.getPubkey0()); + ps.setString(5, user.getPubkey1()); + + if (user.getBchLimit() != null) { + ps.setInt(6, user.getBchLimit()); + } else { + ps.setNull(6, Types.INTEGER); + } + + ps.executeUpdate(); + } + } + + public SolanaUser getByLoginId(long loginId) throws SQLException { + String sql = """ + SELECT login, loginId, bchId, pubkey0, pubkey1, bchLimit + FROM solana_users + WHERE loginId = ? + """; + + try (PreparedStatement ps = db.getConnection().prepareStatement(sql)) { + ps.setLong(1, loginId); + + try (ResultSet rs = ps.executeQuery()) { + if (!rs.next()) return null; + return mapRow(rs); + } + } + } + + public SolanaUser getByLogin(String login) throws SQLException { + String sql = """ + SELECT login, loginId, bchId, pubkey0, pubkey1, bchLimit + FROM solana_users + WHERE LOWER(login) = LOWER(?) + """; + + try (PreparedStatement ps = db.getConnection().prepareStatement(sql)) { + ps.setString(1, login); + + try (ResultSet rs = ps.executeQuery()) { + if (!rs.next()) return null; + return mapRow(rs); + } + } + } + + public List searchByLoginPrefix(String prefix) throws SQLException { + String sql = """ + SELECT login, loginId, bchId, pubkey0, pubkey1, bchLimit + FROM solana_users + WHERE LOWER(login) LIKE ? + ORDER BY login + LIMIT 5 + """; + + List result = new ArrayList<>(); + + try (PreparedStatement ps = db.getConnection().prepareStatement(sql)) { + ps.setString(1, prefix.toLowerCase() + "%"); + + try (ResultSet rs = ps.executeQuery()) { + while (rs.next()) result.add(mapRow(rs)); + } + } + + return result; + } + + private SolanaUser mapRow(ResultSet rs) throws SQLException { + return new SolanaUser( + rs.getLong("loginId"), + rs.getString("login"), + rs.getLong("bchId"), + rs.getString("pubkey0"), + rs.getString("pubkey1"), + rs.getObject("bchLimit") != null ? rs.getInt("bchLimit") : null + ); + } +} diff --git a/shine-server-db/src/main/java/shine/db/dao/UserParamsDAO.java b/shine-server-db/src/main/java/shine/db/dao/UserParamsDAO.java new file mode 100644 index 0000000..3afdf32 --- /dev/null +++ b/shine-server-db/src/main/java/shine/db/dao/UserParamsDAO.java @@ -0,0 +1,136 @@ +package shine.db.dao; + +import shine.db.SqliteDbController; +import shine.db.entities.UserParam; + +import java.sql.*; +import java.util.ArrayList; +import java.util.List; + +/** Здесь зраним сохранённые параметры пользователей (в основном до каково сообщения просмотрены ленты) */ + +public final class UserParamsDAO { + + private static volatile UserParamsDAO instance; + private final SqliteDbController db = SqliteDbController.getInstance(); + + private UserParamsDAO() { + } + + public static UserParamsDAO getInstance() { + if (instance == null) { + synchronized (UserParamsDAO.class) { + if (instance == null) { + instance = new UserParamsDAO(); + } + } + } + return instance; + } + + /** + * UPSERT методом ON CONFLICT — одним SQL-запросом. + * Если запись существует -> обновляем поля. + * Если нет -> вставляем новую запись. + */ + public void upsert(UserParam param) throws SQLException { + String sql = """ + INSERT INTO users_params ( + loginId, + param, + bch_channel_id, + value, + time_ms, + pubkey_num, + signature + ) VALUES (?, ?, ?, ?, ?, ?, ?) + ON CONFLICT(loginId, param) + DO UPDATE SET + bch_channel_id = excluded.bch_channel_id, + value = excluded.value, + time_ms = excluded.time_ms, + pubkey_num = excluded.pubkey_num, + signature = excluded.signature + """; + + try (PreparedStatement ps = db.getConnection().prepareStatement(sql)) { + ps.setLong(1, param.getLoginId()); + ps.setString(2, param.getParam()); + ps.setLong(3, param.getBchChannelId()); + ps.setString(4, param.getValue()); + ps.setLong(5, param.getTimeMs()); + ps.setInt(6, param.getPubkeyNum()); + ps.setString(7, param.getSignature()); + ps.executeUpdate(); + } + } + + /** + * Получить параметр по loginId + param. + */ + public UserParam getByUserIdAndParam(long loginId, String paramName) throws SQLException { + String sql = """ + SELECT + loginId, + param, + bch_channel_id, + value, + time_ms, + pubkey_num, + signature + FROM users_params + WHERE loginId = ? AND param = ? + """; + + try (PreparedStatement ps = db.getConnection().prepareStatement(sql)) { + ps.setLong(1, loginId); + ps.setString(2, paramName); + try (ResultSet rs = ps.executeQuery()) { + if (!rs.next()) return null; + return mapRow(rs); + } + } + } + + /** + * Получить все параметры пользователя. + */ + public List getByUserId(long loginId) throws SQLException { + String sql = """ + SELECT + loginId, + param, + bch_channel_id, + value, + time_ms, + pubkey_num, + signature + FROM users_params + WHERE loginId = ? + ORDER BY time_ms DESC + """; + + List result = new ArrayList<>(); + + try (PreparedStatement ps = db.getConnection().prepareStatement(sql)) { + ps.setLong(1, loginId); + try (ResultSet rs = ps.executeQuery()) { + while (rs.next()) result.add(mapRow(rs)); + } + } + + return result; + } + + private UserParam mapRow(ResultSet rs) throws SQLException { + return new UserParam( + rs.getLong("loginId"), + rs.getString("param"), + rs.getLong("bch_channel_id"), + rs.getString("value"), + rs.getLong("time_ms"), + (short) rs.getInt("pubkey_num"), + rs.getString("signature") + ); + } +} diff --git a/shine-server-db/src/main/java/shine/db/entities/ActiveSession.java b/shine-server-db/src/main/java/shine/db/entities/ActiveSession.java new file mode 100644 index 0000000..4a541e7 --- /dev/null +++ b/shine-server-db/src/main/java/shine/db/entities/ActiveSession.java @@ -0,0 +1,98 @@ +package shine.db.entities; + +public class ActiveSession { + + private long sessionId; + private String sessionPwd; + private long loginId; + private long timeMs; // время в мс + private short pubkeyNum; + private String pushEndpoint; + private String pushP256dhKey; + private String pushAuthKey; + + public ActiveSession() { + } + + public ActiveSession(long sessionId, + String sessionPwd, + long loginId, + long timeMs, + short pubkeyNum, + String pushEndpoint, + String pushP256dhKey, + String pushAuthKey) { + this.sessionId = sessionId; + this.sessionPwd = sessionPwd; + this.loginId = loginId; + this.timeMs = timeMs; + this.pubkeyNum = pubkeyNum; + this.pushEndpoint = pushEndpoint; + this.pushP256dhKey = pushP256dhKey; + this.pushAuthKey = pushAuthKey; + } + + public long getSessionId() { + return sessionId; + } + + public void setSessionId(long sessionId) { + this.sessionId = sessionId; + } + + public String getSessionPwd() { + return sessionPwd; + } + + public void setSessionPwd(String sessionPwd) { + this.sessionPwd = sessionPwd; + } + + public long getLoginId() { + return loginId; + } + + public void setLoginId(long loginId) { + this.loginId = loginId; + } + + public long getTimeMs() { + return timeMs; + } + + public void setTimeMs(long timeMs) { + this.timeMs = timeMs; + } + + public short getPubkeyNum() { + return pubkeyNum; + } + + public void setPubkeyNum(short pubkeyNum) { + this.pubkeyNum = pubkeyNum; + } + + public String getPushEndpoint() { + return pushEndpoint; + } + + public void setPushEndpoint(String pushEndpoint) { + this.pushEndpoint = pushEndpoint; + } + + public String getPushP256dhKey() { + return pushP256dhKey; + } + + public void setPushP256dhKey(String pushP256dhKey) { + this.pushP256dhKey = pushP256dhKey; + } + + public String getPushAuthKey() { + return pushAuthKey; + } + + public void setPushAuthKey(String pushAuthKey) { + this.pushAuthKey = pushAuthKey; + } +} diff --git a/shine-server-db/src/main/java/shine/db/entities/SolanaUser.java b/shine-server-db/src/main/java/shine/db/entities/SolanaUser.java new file mode 100644 index 0000000..ab6ae99 --- /dev/null +++ b/shine-server-db/src/main/java/shine/db/entities/SolanaUser.java @@ -0,0 +1,76 @@ +package shine.db.entities; + +public class SolanaUser { + + private long loginId; + private String login; + private long bchId; + private String pubkey0; + private String pubkey1; + private Integer bchLimit; // может быть null + + public SolanaUser() { + } + + public SolanaUser(long loginId, + String login, + long bchId, + String pubkey0, + String pubkey1, + Integer bchLimit) { + this.loginId = loginId; + this.login = login; + this.bchId = bchId; + this.pubkey0 = pubkey0; + this.pubkey1 = pubkey1; + this.bchLimit = bchLimit; + } + + public long getLoginId() { + return loginId; + } + + public void setLoginId(long loginId) { + this.loginId = loginId; + } + + public String getLogin() { + return login; + } + + public void setLogin(String login) { + this.login = login; + } + + public long getBchId() { + return bchId; + } + + public void setBchId(long bchId) { + this.bchId = bchId; + } + + public String getPubkey0() { + return pubkey0; + } + + public void setPubkey0(String pubkey0) { + this.pubkey0 = pubkey0; + } + + public String getPubkey1() { + return pubkey1; + } + + public void setPubkey1(String pubkey1) { + this.pubkey1 = pubkey1; + } + + public Integer getBchLimit() { + return bchLimit; + } + + public void setBchLimit(Integer bchLimit) { + this.bchLimit = bchLimit; + } +} diff --git a/shine-server-db/src/main/java/shine/db/entities/UserParam.java b/shine-server-db/src/main/java/shine/db/entities/UserParam.java new file mode 100644 index 0000000..0e6195a --- /dev/null +++ b/shine-server-db/src/main/java/shine/db/entities/UserParam.java @@ -0,0 +1,87 @@ +package shine.db.entities; + +public class UserParam { + + private long loginId; + private String param; + private long bchChannelId; // новый канал, 8 байт, может быть 0 + private String value; + private long timeMs; // время в мс + private short pubkeyNum; + private String signature; + + public UserParam() { + } + + public UserParam(long loginId, + String param, + long bchChannelId, + String value, + long timeMs, + short pubkeyNum, + String signature) { + this.loginId = loginId; + this.param = param; + this.bchChannelId = bchChannelId; + this.value = value; + this.timeMs = timeMs; + this.pubkeyNum = pubkeyNum; + this.signature = signature; + } + + public long getLoginId() { + return loginId; + } + + public void setLoginId(long loginId) { + this.loginId = loginId; + } + + public String getParam() { + return param; + } + + public void setParam(String param) { + this.param = param; + } + + public long getBchChannelId() { + return bchChannelId; + } + + public void setBchChannelId(long bchChannelId) { + this.bchChannelId = bchChannelId; + } + + public String getValue() { + return value; + } + + public void setValue(String value) { + this.value = value; + } + + public long getTimeMs() { + return timeMs; + } + + public void setTimeMs(long timeMs) { + this.timeMs = timeMs; + } + + public short getPubkeyNum() { + return pubkeyNum; + } + + public void setPubkeyNum(short pubkeyNum) { + this.pubkeyNum = pubkeyNum; + } + + public String getSignature() { + return signature; + } + + public void setSignature(String signature) { + this.signature = signature; + } +} diff --git a/shine-server-db/src/main/java/Описание таблиц в БД.md b/shine-server-db/src/main/java/Описание таблиц в БД.md new file mode 100644 index 0000000..4960b56 --- /dev/null +++ b/shine-server-db/src/main/java/Описание таблиц в БД.md @@ -0,0 +1,44 @@ +# Структура БД SHiNE (кратко) + +## Таблица `solana_users` +Локальная копия данных о пользователях из Solana. + +Поля: +- `login` (TEXT) — логин пользователя. +- `loginId` (INTEGER, PK) — ID пользователя, основной ключ. +- `bchId` (INTEGER) — ID блокчейна пользователя. +- `pubkey0` (TEXT) — первый публичный ключ. +- `pubkey1` (TEXT) — второй публичный ключ. +- `bchLimit` (INTEGER, NULL) — произвольный лимит для пользователя (опционально). + +--- + +## Таблица `active_sessions` +Активные сессии пользователей (WebSocket/WSS + Web Push). + +Поля: +- `sessionId` (INTEGER, PK) — ID сессии, генерируется приложением. +- `session_pwd` (TEXT) — секрет/пароль сессии. +- `loginId` (INTEGER, FK → solana_users.loginId) — владелец сессии. +- `time_ms` (INTEGER) — время создания/активности сессии (мс от эпохи). +- `pubkey_num` (INTEGER) — номер ключа пользователя, которым подписывались данные. +- `push_endpoint` (TEXT, NULL) — endpoint Web Push. +- `push_p256dh_key` (TEXT, NULL) — p256dh-ключ Web Push. +- `push_auth_key` (TEXT, NULL) — auth-ключ Web Push. + +--- + +## Таблица `users_params` +Сохранённые параметры и состояния пользователя (например, до какого сообщения прочитана лента). + +Поля: +- `loginId` (INTEGER, FK → solana_users.loginId) — пользователь. +- `param` (TEXT) — имя параметра (ключ). +- `bch_channel_id` (INTEGER, DEFAULT 0) — ID канала/ленты который просмотрен. +- `value` (TEXT, NULL) — значение параметра (строка). +- `time_ms` (INTEGER) — время последнего обновления (мс от эпохи). +- `pubkey_num` (INTEGER) — номер ключа, которым подписано значение. +- `signature` (TEXT, NULL) — подпись значения. + +Ограничения: +- `UNIQUE(loginId, param)` — у одного пользователя каждый `param` только один раз. diff --git a/shine-server-net-protocol/build.gradle b/shine-server-net-protocol/build.gradle new file mode 100644 index 0000000..f7c4f3a --- /dev/null +++ b/shine-server-net-protocol/build.gradle @@ -0,0 +1,35 @@ +plugins { + id 'java' +} + +group = 'shine' +version = '1.0.0' + +java { + toolchain { + languageVersion = JavaLanguageVersion.of(17) + } +} + +repositories { + mavenCentral() +} + +dependencies { + implementation 'com.fasterxml.jackson.core:jackson-databind:2.17.1' // json + + implementation 'org.slf4j:slf4j-api:2.0.9' + implementation 'ch.qos.logback:logback-classic:1.5.6' + + implementation project(':shine-server-config') // модуль с настройками + implementation project(':shine-server-db') // модуль для работы с БД содержит и сущности из БД и саму работу с БД + +} + +java { + sourceCompatibility = JavaVersion.VERSION_17 + targetCompatibility = JavaVersion.VERSION_17 +} + + + diff --git a/shine-server-net-protocol/concat_to_file.sh b/shine-server-net-protocol/concat_to_file.sh new file mode 100755 index 0000000..901712c --- /dev/null +++ b/shine-server-net-protocol/concat_to_file.sh @@ -0,0 +1,16 @@ +#!/usr/bin/env bash +set -euo pipefail + +OUTFILE="all_files.txt" + +# очищаем или создаём файл +: > "$OUTFILE" + +# собрать только *.java файлы и вывести их содержимое в файл +find . -type f -name "*.java" | sort | while read -r f; do + cat "$f" >> "$OUTFILE" + echo >> "$OUTFILE" # пустая строка-разделитель +done + +echo "Готово! Все .java файлы собраны в $OUTFILE" + diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/ConnectionContext.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/ConnectionContext.java new file mode 100644 index 0000000..80adc00 --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/ConnectionContext.java @@ -0,0 +1,137 @@ +package server.logic.ws_protocol.JSON; + +/** + * ConnectionContext — контекст состояния одного WebSocket-соединения. + * Живёт ровно столько же, сколько живёт подключение. + */ +public class ConnectionContext { + + // Статусы аутентификации + public static final int AUTH_STATUS_NONE = 0; // ананимный или не авторизованный пользователь + public static final int AUTH_STATUS_USER = 1; // авторизованный пользователь +// public static final int AUTH_STATUS_ANON = 2; // анонимный (зарезервировано на будущее) + + private String login; + private Long loginId; + + private Long sessionId; + private String sessionPwd; + + // Данные пользователя / блокчейна + private Long bchId; + private String pubkey0; + private String pubkey1; + private Integer bchLimit; + + private int authenticationStatus = AUTH_STATUS_NONE; + + // --- getters / setters --- + + public String getLogin() { + return login; + } + + public void setLogin(String login) { + this.login = login; + } + + public Long getLoginId() { + return loginId; + } + + public void setLoginId(Long loginId) { + this.loginId = loginId; + } + + public Long getSessionId() { + return sessionId; + } + + public void setSessionId(Long sessionId) { + this.sessionId = sessionId; + } + + public String getSessionPwd() { + return sessionPwd; + } + + public void setSessionPwd(String sessionPwd) { + this.sessionPwd = sessionPwd; + } + + public Long getBchId() { + return bchId; + } + + public void setBchId(Long bchId) { + this.bchId = bchId; + } + + public String getPubkey0() { + return pubkey0; + } + + public void setPubkey0(String pubkey0) { + this.pubkey0 = pubkey0; + } + + public String getPubkey1() { + return pubkey1; + } + + public void setPubkey1(String pubkey1) { + this.pubkey1 = pubkey1; + } + + public Integer getBchLimit() { + return bchLimit; + } + + public void setBchLimit(Integer bchLimit) { + this.bchLimit = bchLimit; + } + + public int getAuthenticationStatus() { + return authenticationStatus; + } + + public void setAuthenticationStatus(int authenticationStatus) { + this.authenticationStatus = authenticationStatus; + } + + public boolean isAuthenticatedUser() { + return authenticationStatus == AUTH_STATUS_USER; + } + + public boolean isAnonymous() { + return authenticationStatus == AUTH_STATUS_NONE; + } + + public void reset() { + login = null; + loginId = null; + sessionId = null; + sessionPwd = null; + + bchId = null; + pubkey0 = null; + pubkey1 = null; + bchLimit = null; + + authenticationStatus = AUTH_STATUS_NONE; + } + + @Override + public String toString() { + return "ConnectionContext{" + + "login='" + login + '\'' + + ", loginId=" + loginId + + ", sessionId=" + sessionId + + ", bchId=" + bchId + + ", pubkey0='" + pubkey0 + '\'' + + ", pubkey1='" + pubkey1 + '\'' + + ", bchLimit=" + bchLimit + + ", authenticationStatus=" + authenticationStatus + + '}'; + } +} diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/JsonHandlerRegistry.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/JsonHandlerRegistry.java new file mode 100644 index 0000000..1d0dfc3 --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/JsonHandlerRegistry.java @@ -0,0 +1,49 @@ +package server.logic.ws_protocol.JSON; + +import server.logic.ws_protocol.JSON.entyties.*; +import server.logic.ws_protocol.JSON.entyties.Auth.NetAuthSessionNewStep1Request; +import server.logic.ws_protocol.JSON.entyties.Auth.NetSessionRefreshRequest; +import server.logic.ws_protocol.JSON.handlers.*; +import server.logic.ws_protocol.JSON.entyties.tempToTest.NetAddUserRequest; +import server.logic.ws_protocol.JSON.handlers.auth.NetAddUserHandler; +import server.logic.ws_protocol.JSON.handlers.auth.NetAuthSessionNewStep1Handler; +import server.logic.ws_protocol.JSON.handlers.auth.NetSessionRefreshHandler; + +import java.util.Map; + +/** + * JsonHandlerRegistry — единое место, где руками регистрируются + * JSON-операции: op → handler и op → requestClass. + * + * Если нужно добавить новый запрос: + * 1) создаёшь класс NetXXXRequest / NetXXXResponse, + * 2) создаёшь JsonMessageHandler (NetXXXHandler), + * 3) добавляешь оп в HANDLERS и REQUEST_TYPES. + */ +public final class JsonHandlerRegistry { + + private static final Map HANDLERS = Map.of( + "SessionRefresh", new NetSessionRefreshHandler(), + "AddUser", new NetAddUserHandler(), + "AuthSessionNewStep1", new NetAuthSessionNewStep1Handler() + // сюда потом добавишь другие операции + ); + + private static final Map> REQUEST_TYPES = Map.of( + "SessionRefresh", NetSessionRefreshRequest.class, + "AddUser", NetAddUserRequest.class, + "AuthSessionNewStep1", NetAuthSessionNewStep1Request.class + ); + + private JsonHandlerRegistry() { + // utility + } + + public static Map getHandlers() { + return HANDLERS; + } + + public static Map> getRequestTypes() { + return REQUEST_TYPES; + } +} diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/JsonInboundProcessor.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/JsonInboundProcessor.java new file mode 100644 index 0000000..4a4993d --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/JsonInboundProcessor.java @@ -0,0 +1,158 @@ +package server.logic.ws_protocol.JSON; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.node.ObjectNode; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import server.logic.ws_protocol.JSON.entyties.NetRequest; +import server.logic.ws_protocol.JSON.entyties.NetResponse; +import server.logic.ws_protocol.JSON.handlers.JsonMessageHandler; +import server.logic.ws_protocol.WireCodes; + +import java.util.Map; + +/** + * JsonInboundProcessor — отдельный класс для обработки JSON-сообщений. + * + * 1) Парсит общий пакет (op, requestId, payload). + * 2) По op выбирает класс запроса и хэндлер. + * 3) Маппит JSON → NetRequest через ObjectMapper. + * 4) Вызывает хэндлер, получает NetResponse. + * 5) Собирает JSON-ответ и возвращает строкой. + */ +public final class JsonInboundProcessor { + private static final Logger log = LoggerFactory.getLogger(JsonInboundProcessor.class); + + private static final ObjectMapper JSON_MAPPER = new ObjectMapper(); + + /** + * op → хэндлер. + * Регистрация вынесена в JsonHandlerRegistry. + */ + private static final Map JSON_HANDLERS = + JsonHandlerRegistry.getHandlers(); + + /** + * op → класс запроса. + */ + private static final Map> JSON_REQUEST_TYPES = + JsonHandlerRegistry.getRequestTypes(); + + private JsonInboundProcessor() {} + + /** + * Обработка входящего JSON-сообщения. + * + * @param json исходная строка от клиента + * @param ctx контекст текущего WebSocket-соединения + * @return JSON-строка ответа + */ + public static String processJson(String json, ConnectionContext ctx) { + try { + if (json == null || json.isBlank()) { + return buildErrorJson(null, null, WireCodes.Status.BAD_REQUEST, + "EMPTY_JSON", "Пустое JSON-сообщение"); + } + + // 1. Парсим общий пакет как дерево + JsonNode root = JSON_MAPPER.readTree(json); + + // 2. Берём op и requestId + String op = getTextOrNull(root, "op"); + if (op == null || op.isEmpty()) { + return buildErrorJson(null, null, WireCodes.Status.BAD_REQUEST, + "NO_OP", "Поле 'op' отсутствует или пустое"); + } + + String requestId = getTextOrNull(root, "requestId"); + + JsonMessageHandler handler = JSON_HANDLERS.get(op); + Class reqClass = JSON_REQUEST_TYPES.get(op); + + if (handler == null || reqClass == null) { + return buildErrorJson(op, requestId, WireCodes.Status.BAD_REQUEST, + "UNKNOWN_OP", "Неизвестная операция: " + op); + } + + // 3. Маппим весь JSON в конкретный класс запроса + NetRequest request = JSON_MAPPER.treeToValue(root, reqClass); + + // 4. Вызываем хэндлер, передавая контекст + NetResponse response = handler.handle(request, ctx); + + // На всякий случай: если хэндлер не выставил op/requestId + if (response.getOp() == null) { + response.setOp(op); + } + if (response.getRequestId() == null) { + response.setRequestId(requestId); + } + + // 5. Собираем JSON-ответ + ObjectNode out = JSON_MAPPER.createObjectNode(); + out.put("op", response.getOp()); + out.put("requestId", response.getRequestId()); + out.put("status", response.getStatus()); + + if (response.getPayload() != null) { + out.set("payload", JSON_MAPPER.valueToTree(response.getPayload())); + } else { + out.putNull("payload"); + } + + return JSON_MAPPER.writeValueAsString(out); + + } catch (Exception e) { + log.error("Ошибка при обработке JSON-сообщения", e); + return buildErrorJson("Unknown", null, WireCodes.Status.INTERNAL_ERROR, + "INTERNAL_ERROR", "Внутренняя ошибка сервера"); + } + } + + // --- helper'ы --- + + private static String getTextOrNull(JsonNode node, String field) { + if (node == null || !node.has(field) || node.get(field).isNull()) return null; + return node.get(field).asText(); + } + + /** + * Генерация JSON-ошибки в формате ответа: + * { + * "op": op, + * "requestId": requestId, + * "status": status, + * "payload": { + * "code": errorCode, + * "message": errorMessage + * } + * } + */ + private static String buildErrorJson(String op, + String requestId, + int status, + String errorCode, + String errorMessage) { + try { + ObjectNode root = JSON_MAPPER.createObjectNode(); + + if (op != null) root.put("op", op); else root.putNull("op"); + if (requestId != null) root.put("requestId", requestId); else root.putNull("requestId"); + + root.put("status", status); + + ObjectNode payload = root.putObject("payload"); + payload.put("code", errorCode); + payload.put("message", errorMessage); + + return JSON_MAPPER.writeValueAsString(root); + } catch (Exception e) { + return "{\"op\":\"" + (op != null ? op : "") + + "\",\"requestId\":\"" + (requestId != null ? requestId : "") + + "\",\"status\":" + status + + ",\"payload\":{\"code\":\"" + errorCode + + "\",\"message\":\"" + errorMessage + "\"}}"; + } + } +} diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/Auth/NetAuthSessionNewStep1Request.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/Auth/NetAuthSessionNewStep1Request.java new file mode 100644 index 0000000..3407c8a --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/Auth/NetAuthSessionNewStep1Request.java @@ -0,0 +1,14 @@ +package server.logic.ws_protocol.JSON.entyties.Auth; + +import server.logic.ws_protocol.JSON.entyties.NetRequest; + +public class NetAuthSessionNewStep1Request extends NetRequest { + private String login; + + public String getLogin() { + return login; + } + public void setLogin(String login) { + this.login = login; + } +} diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/Auth/NetAuthSessionNewStep1Response.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/Auth/NetAuthSessionNewStep1Response.java new file mode 100644 index 0000000..d865037 --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/Auth/NetAuthSessionNewStep1Response.java @@ -0,0 +1,14 @@ +package server.logic.ws_protocol.JSON.entyties.Auth; + +import server.logic.ws_protocol.JSON.entyties.NetResponse; + +public class NetAuthSessionNewStep1Response extends NetResponse { + private String sessionPwd; + + public String getSessionPwd() { + return sessionPwd; + } + public void setSessionPwd(String sessionPwd) { + this.sessionPwd = sessionPwd; + } +} diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/Auth/NetSessionRefreshRequest.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/Auth/NetSessionRefreshRequest.java new file mode 100644 index 0000000..81f6d4f --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/Auth/NetSessionRefreshRequest.java @@ -0,0 +1,34 @@ +package server.logic.ws_protocol.JSON.entyties.Auth; + +import server.logic.ws_protocol.JSON.entyties.NetRequest; + +/** + * Запрос SessionRefresh. + * + * JSON (payload): + * { + * "sessionId": 123, + * "sessionPwd": "abcd..." + * } + */ +public class NetSessionRefreshRequest extends NetRequest { + + private long sessionId; + private String sessionPwd; + + public long getSessionId() { + return sessionId; + } + + public void setSessionId(long sessionId) { + this.sessionId = sessionId; + } + + public String getSessionPwd() { + return sessionPwd; + } + + public void setSessionPwd(String sessionPwd) { + this.sessionPwd = sessionPwd; + } +} diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/Auth/NetSessionRefreshResponse.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/Auth/NetSessionRefreshResponse.java new file mode 100644 index 0000000..2e45a26 --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/Auth/NetSessionRefreshResponse.java @@ -0,0 +1,12 @@ +package server.logic.ws_protocol.JSON.entyties.Auth; + +import server.logic.ws_protocol.JSON.entyties.NetResponse; + +/** + * Успешный ответ на SessionRefresh. + * + * Дополнительных полей нет, достаточно status=200 и (опционально) пустого payload. + */ +public class NetSessionRefreshResponse extends NetResponse { + // Ничего дополнительного, вся информация в status. +} diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/NetEvent.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/NetEvent.java new file mode 100644 index 0000000..b5d53ca --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/NetEvent.java @@ -0,0 +1,41 @@ +package server.logic.ws_protocol.JSON.entyties; + +/** + * Базовый класс для всех событий (event). + * Общие поля: op и payload. + * + * Формат JSON (event): + * { + * "op": "...", + * "payload": { ... } + * } + */ +public abstract class NetEvent { + + /** Имя операции / события (op). */ + private String op; + + /** + * Произвольные данные. + * В JSON это поле "payload". + */ + private Object payload; + + // --- getters / setters --- + + public String getOp() { + return op; + } + + public void setOp(String op) { + this.op = op; + } + + public Object getPayload() { + return payload; + } + + public void setPayload(Object payload) { + this.payload = payload; + } +} diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/NetExceptionResponse.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/NetExceptionResponse.java new file mode 100644 index 0000000..af80a82 --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/NetExceptionResponse.java @@ -0,0 +1,14 @@ +package server.logic.ws_protocol.JSON.entyties; + +/** + * Ответ с ошибкой (любой отказ). + * + * В payload лежит: + * { + * "code": "...", + * "message": "..." + * } + */ +public class NetExceptionResponse extends NetResponse { + // Ничего дополнительного: код/текст ошибки лежат в payload (Map или DTO). +} diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/NetRequest.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/NetRequest.java new file mode 100644 index 0000000..432c4e5 --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/NetRequest.java @@ -0,0 +1,29 @@ +package server.logic.ws_protocol.JSON.entyties; + +/** + * Базовый класс для всех запросов (client → server). + * + * Наследуется от NetEvent и добавляет requestId. + * + * Формат JSON (request): + * { + * "op": "...", + * "requestId": "...", + * "payload": { ... } + * } + */ +public abstract class NetRequest extends NetEvent { + + /** Идентификатор запроса, чтобы связать запрос и ответ. */ + private String requestId; + + // --- getters / setters --- + + public String getRequestId() { + return requestId; + } + + public void setRequestId(String requestId) { + this.requestId = requestId; + } +} diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/NetResponse.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/NetResponse.java new file mode 100644 index 0000000..0120e8d --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/NetResponse.java @@ -0,0 +1,34 @@ +package server.logic.ws_protocol.JSON.entyties; + +/** + * Базовый класс для всех ответов (server → client). + * + * Наследуется от NetRequest и добавляет status. + * + * Формат JSON (response): + * { + * "op": "...", + * "requestId": "...", + * "status": 200, + * "payload": { ... } // и для успеха, и для ошибки + * } + */ +public abstract class NetResponse extends NetRequest { + + /** Статус результата (200 — успех, любое другое значение — ошибка). */ + private int status; + + // --- getters / setters --- + + public int getStatus() { + return status; + } + + public void setStatus(int status) { + this.status = status; + } + + public boolean isOk() { + return status == 200; + } +} diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/tempToTest/NetAddUserRequest.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/tempToTest/NetAddUserRequest.java new file mode 100644 index 0000000..1bd25c2 --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/tempToTest/NetAddUserRequest.java @@ -0,0 +1,76 @@ +package server.logic.ws_protocol.JSON.entyties.tempToTest; + +import server.logic.ws_protocol.JSON.entyties.NetRequest; + +/** + * Запрос AddUser. + * + * Ожидаемый JSON: + * { + * "op": "AddUser", + * "requestId": "...", + * "login": "...", + * "loginId": 123, + * "bchId": 456, + * "pubkey0": "...", + * "pubkey1": "...", + * "bchLimit": 1000 + * } + */ +public class NetAddUserRequest extends NetRequest { + + private String login; + private long loginId; + private long bchId; + private String pubkey0; + private String pubkey1; + private Integer bchLimit; + + public String getLogin() { + return login; + } + + public void setLogin(String login) { + this.login = login; + } + + public long getLoginId() { + return loginId; + } + + public void setLoginId(long loginId) { + this.loginId = loginId; + } + + public long getBchId() { + return bchId; + } + + public void setBchId(long bchId) { + this.bchId = bchId; + } + + public String getPubkey0() { + return pubkey0; + } + + public void setPubkey0(String pubkey0) { + this.pubkey0 = pubkey0; + } + + public String getPubkey1() { + return pubkey1; + } + + public void setPubkey1(String pubkey1) { + this.pubkey1 = pubkey1; + } + + public Integer getBchLimit() { + return bchLimit; + } + + public void setBchLimit(Integer bchLimit) { + this.bchLimit = bchLimit; + } +} diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/tempToTest/NetAddUserResponse.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/tempToTest/NetAddUserResponse.java new file mode 100644 index 0000000..6d500c7 --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/entyties/tempToTest/NetAddUserResponse.java @@ -0,0 +1,11 @@ +package server.logic.ws_protocol.JSON.entyties.tempToTest; + +import server.logic.ws_protocol.JSON.entyties.NetResponse; + +/** + * Успешный ответ на AddUser. + * Дополнительных полей нет — достаточно status=200. + */ +public class NetAddUserResponse extends NetResponse { + // Можно потом добавить какие-то данные, если понадобится. +} diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/JsonMessageHandler.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/JsonMessageHandler.java new file mode 100644 index 0000000..1d7403f --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/JsonMessageHandler.java @@ -0,0 +1,19 @@ +package server.logic.ws_protocol.JSON.handlers; + +import server.logic.ws_protocol.JSON.ConnectionContext; +import server.logic.ws_protocol.JSON.entyties.NetRequest; +import server.logic.ws_protocol.JSON.entyties.NetResponse; + +/** + * Общий интерфейс для всех JSON-хэндлеров. + */ +public interface JsonMessageHandler { + + /** + * Обработать запрос и вернуть ответ. + * + * @param request распарсенный запрос + * @param ctx контекст текущего WebSocket-соединения + */ + NetResponse handle(NetRequest request, ConnectionContext ctx) throws Exception; +} diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/NetAddUserHandler.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/NetAddUserHandler.java new file mode 100644 index 0000000..cfe5c6c --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/NetAddUserHandler.java @@ -0,0 +1,98 @@ +package server.logic.ws_protocol.JSON.handlers.auth; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import server.logic.ws_protocol.JSON.ConnectionContext; +import server.logic.ws_protocol.JSON.entyties.tempToTest.NetAddUserRequest; +import server.logic.ws_protocol.JSON.entyties.tempToTest.NetAddUserResponse; +import server.logic.ws_protocol.JSON.entyties.NetExceptionResponse; +import server.logic.ws_protocol.JSON.entyties.NetRequest; +import server.logic.ws_protocol.JSON.entyties.NetResponse; +import server.logic.ws_protocol.JSON.handlers.JsonMessageHandler; +import server.logic.ws_protocol.WireCodes; +import shine.db.dao.SolanaUsersDAO; +import shine.db.entities.SolanaUser; + +import java.sql.SQLException; +import java.util.Map; + +/** + * Временный Хэндлер AddUser. Используется для тестовой регистрации!!!!!!!! + * + * Логика: + * - берём login, loginId, bchId, pubkey0, pubkey1, bchLimit; + * - создаём SolanaUser и вставляем через SolanaUsersDAO; + * - если всё ОК → NetAddUserResponse со статусом 200; + * - если ошибка БД или некорректные данные → NetExceptionResponse. + */ +public class NetAddUserHandler implements JsonMessageHandler { + + private static final Logger log = LoggerFactory.getLogger(NetAddUserHandler.class); + + @Override + public NetResponse handle(NetRequest baseRequest, ConnectionContext ctx) throws Exception { + NetAddUserRequest req = (NetAddUserRequest) baseRequest; + + // Минимальная валидация входных данных + if (req.getLogin() == null || req.getLogin().isBlank()) { + return buildError(req, WireCodes.Status.BAD_REQUEST, + "BAD_LOGIN", "Пустой логин"); + } + if (req.getPubkey0() == null || req.getPubkey0().isBlank() + || req.getPubkey1() == null || req.getPubkey1().isBlank()) { + return buildError(req, WireCodes.Status.BAD_REQUEST, + "BAD_PUBKEY", "Публичные ключи не указаны"); + } + if (req.getBchLimit() == null) { + return buildError(req, WireCodes.Status.BAD_REQUEST, + "BAD_BCH_LIMIT", "Не указан лимит блокчейна"); + } + + try { + SolanaUsersDAO dao = SolanaUsersDAO.getInstance(); + + SolanaUser user = new SolanaUser( + req.getLoginId(), + req.getLogin(), + req.getBchId(), + req.getPubkey0(), + req.getPubkey1(), + req.getBchLimit() + ); + + dao.insert(user); + + NetAddUserResponse resp = new NetAddUserResponse(); + resp.setOp(req.getOp()); + resp.setRequestId(req.getRequestId()); + resp.setStatus(WireCodes.Status.OK); + resp.setPayload(null); // можно поставить Map.of("ok", true) + log.info("✅ Пользователь добавлен: login={}, loginId={}", req.getLogin(), req.getLoginId()); + return resp; + + } catch (SQLException e) { + log.error("❌ Ошибка при вставке пользователя в БД", e); + return buildError(req, WireCodes.Status.SERVER_DATA_ERROR, + "DB_ERROR", "Ошибка доступа к базе данных"); + } catch (Exception e) { + log.error("❌ Неожиданная ошибка в AddUser", e); + return buildError(req, WireCodes.Status.INTERNAL_ERROR, + "INTERNAL_ERROR", "Внутренняя ошибка сервера"); + } + } + + private NetExceptionResponse buildError(NetRequest req, + int status, + String code, + String message) { + NetExceptionResponse resp = new NetExceptionResponse(); + resp.setOp(req.getOp()); + resp.setRequestId(req.getRequestId()); + resp.setStatus(status); + resp.setPayload(Map.of( + "code", code, + "message", message + )); + return resp; + } +} diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/NetAuthSessionNewStep1Handler.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/NetAuthSessionNewStep1Handler.java new file mode 100644 index 0000000..a01af52 --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/NetAuthSessionNewStep1Handler.java @@ -0,0 +1,79 @@ +package server.logic.ws_protocol.JSON.handlers.auth; + +import server.logic.ws_protocol.JSON.ConnectionContext; +import server.logic.ws_protocol.JSON.entyties.*; +import server.logic.ws_protocol.JSON.entyties.Auth.NetAuthSessionNewStep1Request; +import server.logic.ws_protocol.JSON.entyties.Auth.NetAuthSessionNewStep1Response; +import server.logic.ws_protocol.JSON.handlers.JsonMessageHandler; +import server.logic.ws_protocol.WireCodes; +import shine.db.dao.SolanaUsersDAO; +import shine.db.entities.SolanaUser; + +import java.security.SecureRandom; +import java.util.Map; + +public class NetAuthSessionNewStep1Handler implements JsonMessageHandler { + + private static final SecureRandom RANDOM = new SecureRandom(); + + @Override + public NetResponse handle(NetRequest baseReq, ConnectionContext ctx) throws Exception { + + NetAuthSessionNewStep1Request req = (NetAuthSessionNewStep1Request) baseReq; + + String login = req.getLogin(); + if (login == null || login.isBlank()) { + return error(req, WireCodes.Status.BAD_REQUEST, + "EMPTY_LOGIN", "Пустой логин"); + } + + // 1) Проверка: в контексте никто не авторизован + if (ctx.getLogin() != null) { + return error(req, WireCodes.Status.BAD_REQUEST, + "ALREADY_AUTHED", + "Попытка повторной авторификации для уже заданного login=" + ctx.getLogin()); + } + + // 2) Ищем пользователя в локальной БД + SolanaUser solanaUser = SolanaUsersDAO.getInstance().getByLogin(login); + + if (solanaUser == null) { + // TODO позже — запрос в Solana, если не нашли локально + return error(req, WireCodes.Status.UNVERIFIED, + "UNKNOWN_USER", "Пользователь с таким логином не найден"); + } + + // 3) Заполняем контекст полями пользователя + ctx.setLogin(solanaUser.getLogin()); + ctx.setLoginId(solanaUser.getLoginId()); + ctx.setBchId(solanaUser.getBchId()); + ctx.setPubkey0(solanaUser.getPubkey0()); + ctx.setPubkey1(solanaUser.getPubkey1()); + ctx.setBchLimit(solanaUser.getBchLimit()); + + // 4) Генерируем надёжный sessionPwd + // SecureRandom + время → достаточно + String sessionPwd = Long.toHexString(System.nanoTime()) + + Long.toHexString(RANDOM.nextLong()); + + ctx.setSessionPwd(sessionPwd); + + // 5) Формируем ответ + NetAuthSessionNewStep1Response resp = new NetAuthSessionNewStep1Response(); + resp.setOp(req.getOp()); + resp.setRequestId(req.getRequestId()); + resp.setStatus(WireCodes.Status.OK); + resp.setPayload(Map.of("sessionPwd", sessionPwd)); + + return resp; + } + + private NetExceptionResponse error(NetRequest req, int status, String code, String msg) { + NetExceptionResponse resp = new NetExceptionResponse(); + resp.setOp(req.getOp()); + resp.setRequestId(req.getRequestId()); + resp.setStatus(status); + resp.setPayload(Map.of("code", code, "message", msg)); + return resp; + } +} diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/NetSessionRefreshHandler.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/NetSessionRefreshHandler.java new file mode 100644 index 0000000..2fba372 --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/NetSessionRefreshHandler.java @@ -0,0 +1,94 @@ +package server.logic.ws_protocol.JSON.handlers.auth; + +import server.logic.ws_protocol.JSON.ConnectionContext; +import server.logic.ws_protocol.JSON.entyties.NetExceptionResponse; +import server.logic.ws_protocol.JSON.entyties.NetRequest; +import server.logic.ws_protocol.JSON.entyties.NetResponse; +import server.logic.ws_protocol.JSON.entyties.Auth.NetSessionRefreshRequest; +import server.logic.ws_protocol.JSON.entyties.Auth.NetSessionRefreshResponse; +import server.logic.ws_protocol.JSON.handlers.JsonMessageHandler; +import server.logic.ws_protocol.WireCodes; +import shine.db.dao.ActiveSessionsDAO; +import shine.db.entities.ActiveSession; + +import java.sql.SQLException; +import java.util.Map; + +/** + * Хэндлер SessionRefresh. + * + * Логика: + * - берём sessionId и sessionPwd из запроса; + * - ищем сессию в БД; + * - если не нашли или пароль не совпал → NetExceptionResponse; + * - если всё ок: + * * обновляем ConnectionContext (sessionId, sessionPwd, статус USER); + * * возвращаем NetSessionRefreshResponse со статусом 200. + */ +public class NetSessionRefreshHandler implements JsonMessageHandler { + + @Override + public NetResponse handle(NetRequest request, ConnectionContext ctx) throws Exception { + NetSessionRefreshRequest req = (NetSessionRefreshRequest) request; + + long sessionId = req.getSessionId(); + String sessionPwd = req.getSessionPwd(); + + if (sessionPwd == null || sessionPwd.isEmpty()) { + return buildError(req, WireCodes.Status.BAD_REQUEST, + "BAD_SESSION_PWD", "Пустой пароль сессии"); + } + + ActiveSessionsDAO dao = ActiveSessionsDAO.getInstance(); + ActiveSession session; + try { + session = dao.getBySessionId(sessionId); + } catch (SQLException e) { + // Ошибка БД → внутренняя ошибка сервера + return buildError(req, WireCodes.Status.SERVER_DATA_ERROR, + "DB_ERROR", "Ошибка доступа к базе данных"); + } + + if (session == null) { + return buildError(req, WireCodes.Status.UNVERIFIED, + "SESSION_NOT_FOUND", "Сессия не найдена"); + } + + String dbPwd = session.getSessionPwd(); + if (dbPwd == null || !dbPwd.equals(sessionPwd)) { + return buildError(req, WireCodes.Status.UNVERIFIED, + "SESSION_PWD_MISMATCH", "Неверный пароль сессии"); + } + + // Всё хорошо — обновляем контекст соединения + if (ctx != null) { + ctx.setSessionId(sessionId); + ctx.setSessionPwd(sessionPwd); + // Если потом добавишь в ActiveSession login / loginId — можно здесь и их проставлять + ctx.setAuthenticationStatus(ConnectionContext.AUTH_STATUS_USER); + } + + // И возвращаем OK без доп. данных + NetSessionRefreshResponse resp = new NetSessionRefreshResponse(); + resp.setOp(req.getOp()); + resp.setRequestId(req.getRequestId()); + resp.setStatus(WireCodes.Status.OK); + resp.setPayload(null); // или Map.of("ok", true) + return resp; + } + + private NetExceptionResponse buildError(NetRequest req, + int status, + String code, + String message) { + NetExceptionResponse resp = new NetExceptionResponse(); + resp.setOp(req.getOp()); + resp.setRequestId(req.getRequestId()); + resp.setStatus(status); + resp.setPayload(Map.of( + "code", code, + "message", message + )); + return resp; + } +} diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/Описание протокола.md b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/Описание протокола.md new file mode 100644 index 0000000..cd38e2e --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/Описание протокола.md @@ -0,0 +1,52 @@ +Протокол использует единый формат JSON-сообщений: клиент всегда отправляет запросы с полями op, requestId и payload, сервер отвечает тем же op и requestId, добавляя status (200 для успеха, любое другое значение — ошибка) и либо payload, либо error. + +События от сервера приходят без requestId и status, содержат только op и payload и не являются ответами на запросы. + +# Примеры JSON для SearchUsers (минимальная шпаргалка) + +## 🔵 Запрос (client → server) + +```json +{ + "op": "SearchUsers", + "requestId": "req-1", + "payload": { + "query": "ai" + } +} + +🟢 Успешный ответ (server → client) + +{ + "op": "SearchUsers", + "requestId": "req-1", + "status": 200, + "payload": { + "users": [ + { "login": "aidar" }, + { "login": "anya" } + ] + } +} + +🔴 Ошибочный ответ (server → client) + +{ + "op": "SearchUsers", + "requestId": "req-1", + "status": 403, + "error": { + "code": "SESSION_EXPIRED", + "message": "Сессия истекла" + } +} + +🟣 Событие (server → client, не ответ) + +{ + "op": "NewBlockEvent", + "payload": { + "blockchainId": 42, + "blockNumber": 101 + } +} \ No newline at end of file diff --git a/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/WireCodes.java b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/WireCodes.java new file mode 100644 index 0000000..dd743e4 --- /dev/null +++ b/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/WireCodes.java @@ -0,0 +1,102 @@ +package server.logic.ws_protocol; + +/** + * WireCodes — константы бинарного протокола поверх WebSocket. + * + * Формат входящего сообщения: + * [4] int opCode (big-endian) + * [*] payload + * + * Ответ сервера: + * ровно [4] int statusCode (big-endian) + */ +public final class WireCodes { + private WireCodes() {} + + public static final class Op { + public static final int PING = 0; + public static final int ADD_BLOCK = 1; + public static final int GET_BLOCKCHAIN = 2; + public static final int SEARCH_USERS = 30; + public static final int GET_LAST_BLOCK_INFO = 31; + private Op() {} + } + + public static final class Status { + public static final int PONG = 100; // ответ на PING +// public static final int OK = 200; // успех + + public static final int ALREADY_EXISTS = 409; // пришёл блок < N+1 + public static final int NON_SEQUENTIAL = 412; // пришёл блок > N+1 + + + private Status() {} + + + + + // ============================================================ + // 🟢 УСПЕШНЫЕ ОПЕРАЦИИ + // ============================================================ + + /** ✅ Блок успешно добавлен в цепочку. */ + public static final int OK = 200; + + /** 🌱 Создана новая цепочка (первый блок-заголовок принят). */ + public static final int CHAIN_CREATED = 201; + + /** + * 🔁 Такой блок уже существует. + * Клиент может считать это успешным ответом: + * - сервер возвращает 8 байт: [4] код (202) + [4] номер последнего блока (int) + * - клиент обновляет свой lastBlockNumber и не пересылает этот блок снова. */ + public static final int BLOCK_ALREADY_EXISTS = 202; // плюс к кодуследом возвращается номер последнего блока на сервере + + + // ============================================================ + // 🟡 ЛОГИЧЕСКИЕ / ПРОТОКОЛЬНЫЕ ОШИБКИ + // ============================================================ + + /** ⚠️ Нарушена последовательность — пришёл блок с номером > ожидаемого. + * Сервер вернёт 8 байт: [4] код (409) + [4] последний номер блока. + * Клиент должен дослать недостающие блоки. */ + public static final int OUT_OF_SEQUENCE = 409; // плюс к кодуследом возвращается номер последнего блока на сервере + + /** ❌ Некорректные или неполные данные в запросе. */ + public static final int BAD_REQUEST = 400; + + /** 🚫 Цепочка с указанным blockchainId не найдена. */ + public static final int CHAIN_NOT_FOUND = 404; + + /** 🧩 Несовпадение blockchainId между заголовком блока и телом. */ + public static final int INVALID_BLOCKCHAIN_ID = 421; + + /** ❌ Ошибка верификации блока — хэш или подпись не совпали. + * 🔐 Ошибка хэша: SHA-256(preimage) не совпал с переданным hash32. + * 🔏 Ошибка подписи Ed25519 — блок не прошёл криптографическую проверку. */ + public static final int UNVERIFIED = 422; + + + /** 🙅 Некорректный логин (пустой, неверный формат, недопустимые символы). По сути вообще не может быть, тк логин проверяют при создании в другом блокчейне*/ + public static final int BAD_LOGIN = 462; + + + // ============================================================ + // 🔴 СИСТЕМНЫЕ ОШИБКИ / ОГРАНИЧЕНИЯ + // ============================================================ + + // ============================================================ + // 🔴 СИСТЕМНЫЕ ОШИБКИ / ОГРАНИЧЕНИЯ + // ============================================================ + + /** 💾 Достигнут лимит размера блокчейна. */ + public static final int BLOCKCHAIN_FULL = 507; + + /** 🧱 Ошибка при сохранении или обновлении данных на сервере (файлы, JSON и т.п.). */ + public static final int SERVER_DATA_ERROR = 501; + + /** 💥 Общая внутренняя ошибка сервера (необработанное исключение). */ + public static final int INTERNAL_ERROR = 500; + } + +} diff --git a/shine-server-net-protocol/src/main/java/Мини памятка по классам джисон протокола.md b/shine-server-net-protocol/src/main/java/Мини памятка по классам джисон протокола.md new file mode 100644 index 0000000..5e10b9f --- /dev/null +++ b/shine-server-net-protocol/src/main/java/Мини памятка по классам джисон протокола.md @@ -0,0 +1,29 @@ +Мини-памятка по JSON-протоколу +** JsonInboundProcessor + +Центральный вход для JSON. +Принимает текст → парсит → ищет op → создаёт нужный NetRequest → вызывает хэндлер → возвращает JSON-ответ. + +** JsonHandlerRegistry + +Словарь операций. +Связывает op → requestClass и op → handler. +Любая новая операция регистрируется здесь. + +** NetEvent / NetRequest / NetResponse + +Базовые структуры JSON-протокола - от которых есть реализации для всех сущностей запросов ответов + +** ConnectionContext + +Хранит состояние текущего WebSocket-соединения: логин, sessionId, статус пользователя. +Передаётся в любой JSON-хэндлер. + +** JsonMessageHandler + +Интерфейс одного хэндлера JSON-операции: - от которого наследуются все хэндлеры обработчики запросов +handle(request, context) → NetResponse. + +** WebSocket endpoint + +BlockchainWsEndpoint.onText(...) получает строку → передаёт в JsonInboundProcessor → отправляет клиенту готовый JSON-ответ. \ No newline at end of file diff --git a/shine-server-net-server/build.gradle b/shine-server-net-server/build.gradle new file mode 100644 index 0000000..54f9b72 --- /dev/null +++ b/shine-server-net-server/build.gradle @@ -0,0 +1,36 @@ +plugins { + id 'java' +} + +group = 'shine' +version = '1.0.0' + +java { + toolchain { + languageVersion = JavaLanguageVersion.of(17) + } +} + +repositories { + mavenCentral() +} + +dependencies { + implementation project(':shine-server-config') // модуль с настройками + implementation project(':shine-server-net-protocol') + + // Jackson для JSON + implementation 'com.fasterxml.jackson.core:jackson-databind:2.17.0' + + // SLF4J API (если у тебя уже тянется из корня / других модулей, можно убрать) + implementation 'org.slf4j:slf4j-api:2.0.13' + +} + +java { + sourceCompatibility = JavaVersion.VERSION_17 + targetCompatibility = JavaVersion.VERSION_17 +} + + + diff --git a/src/TestJsonWsClient2 b/src/TestJsonWsClient2 new file mode 100644 index 0000000..473a0f4 diff --git a/src/main/docs/Запуск на сервере.txt b/src/main/docs/Запуск на сервере.txt new file mode 100644 index 0000000..6a4810b --- /dev/null +++ b/src/main/docs/Запуск на сервере.txt @@ -0,0 +1,10 @@ + +просто запустить +user@p628065:~/docker/ws-server$ java -jar ws-server.jar + + +запустить нормально что бы в фоне работал +user@p628065:~/docker/ws-server$ nohup java -jar ws-server.jar > server.log 2>&1 & + +перестартовать кадди +user@p628065:~/docker/ws-server$ docker restart caddy diff --git a/src/main/docs/План работ до мвп/ДАО.md b/src/main/docs/План работ до мвп/ДАО.md new file mode 100644 index 0000000..b75fe01 --- /dev/null +++ b/src/main/docs/План работ до мвп/ДАО.md @@ -0,0 +1,13 @@ +Для того что бы работало ДАО SHiNE.DAO + +Зарегить в дао в солане. + Что бы в нём работало голосование на + Перевод средств. + Выдача лимита раздававть бонусы. + На апдейт смарт кантрактов + И посути на запуск любой программы в сол. + + + + + diff --git a/src/main/docs/План работ до мвп/Инвестиции.md b/src/main/docs/План работ до мвп/Инвестиции.md new file mode 100644 index 0000000..10bed9f --- /dev/null +++ b/src/main/docs/План работ до мвп/Инвестиции.md @@ -0,0 +1,67 @@ +Инвестиции считаем в USDT а вносим и выносим просто в соланах поо текущему курсу из оракула + +НИКАНИХ замороженных NFT токенов валют и т.д. + +Просто записи об очереди и вызов только через наш сайт!! //(И страницу дозаписи можно сделать фикированной в ARVEAVE) + +Храним в одном пда реестре: + сколько сколько сейчас в очереди записей, + на какую сумму + адрес последней записи. + (Адрес записи-инвестиции это имя пользователя и номер записи) + а так же сколько уже выплаченно + + + + + + Создание новой записи о инвестициях. + +На каждого Пользователя-инвестора заводим вначале новый ПДА + , а если он уже есть то просто увеличиваем размер старово ПДА и делаем дозапись + +** В записи у пользователя храним. + Её номер (то есть сколько до неё), + Сумму в очереди до неё, + Флаг что выплаченно + Адрес СЛЕДУЮЩИЙ транцакции + + +** Есть акаун реестр где указано сколько уже есть записей, на какую сумму и какой номер крайнейй записи + +** И есть акаунт реестр на выплаты, в нём указано + сколько по счёту записей уже выплаченно + и на какую сумму уже выплаченно + сколько USDT надо накопить на для следующей выплаты + адрес (акаунт и номер записи) + +** И вторая очеред для самых близких + Там всё тоже самое что и в первой только суммы выплаты больше и даты непонятны + + Полуается +** добавить запись + Прочитал главный реестр, + И пда с крайней записью. + Попробывал прочитать пда в который надо писать новую запись + И дальше либо создал его или увеличил его размер на 1 запись + И записал в него данные + А в преведущую крайнюю запись добавил адрес следующей записи + Обновил данные в реестре + +** Прочитать данные для пользователя + Прочитал Все записи из его пда + Прочитал Сколько выплаченно прочитал из реестра на выплату + Прочитал Сколько сейчас уже есть денег и сколько надо до следующей выплаты + Пересчитал данные и показал пользователю в виде актуальной таблицы + +** Сама выплата + всё можно легко понять по аналогии с тем что выше написанно + + + + + + + + + \ No newline at end of file diff --git a/src/main/docs/План работ до мвп/Правила получения новых акаунтов.md b/src/main/docs/План работ до мвп/Правила получения новых акаунтов.md new file mode 100644 index 0000000..50eb935 --- /dev/null +++ b/src/main/docs/План работ до мвп/Правила получения новых акаунтов.md @@ -0,0 +1,4 @@ +(При создании новых пользователей вообще не гоним о том что может быть конфликт если два чел в раз попытаются за регистрироваться +т.к. даже при средней скорости 1 зарегистрированный чел в минуту будеит уже 43 200/мес,) + +Поэтому делаем всю регистрацию одной транзакцией!! и не тупим пока об этом !!! diff --git a/src/main/docs/План работ до мвп/Функции в Solana.md b/src/main/docs/План работ до мвп/Функции в Solana.md new file mode 100644 index 0000000..fd88fca --- /dev/null +++ b/src/main/docs/План работ до мвп/Функции в Solana.md @@ -0,0 +1,29 @@ + + + +Зарегистрироваться + + +Внести инвестиции (получить запись на бонус в 1 очередь) + +Выдать (Записать комуто) бонус 1 очереди +Выдать (Записать комуто) бонус второй очереди + +Попробывать сделать шаг выплаты по очереди + +Функции чтения + Получить данные о пользователе + Получить данные о пользователе(по логину, тоетсь по логину узнали ИД потом по ИД данные о пользователе) + Получить данные об очереди выплат пользователя + +Данные о пользователе по ИД подписанны ЦП пользователя (прямо в блокчейне!!) + + + + +На одного пользователя храниться 2-3 пда + ПДА ссылка по имени пользователя на ИД ПОльзователя + ПДА по ИД пользователя со всеми его данными + (И просто дописывать данные о каждом новом Bch пользователя иего пда по userИД) + + \ No newline at end of file diff --git a/src/main/docs/Принципы сияния/Кто есть сияющие(5 пунктов).md b/src/main/docs/Принципы сияния/Кто есть сияющие(5 пунктов).md new file mode 100644 index 0000000..6ac8809 --- /dev/null +++ b/src/main/docs/Принципы сияния/Кто есть сияющие(5 пунктов).md @@ -0,0 +1,27 @@ + 07.11.2025г. + Принципы сияющих людей. +То что в соц сети можно постаить галочку что я Сияющий или воздержаться + +1. `Не Врать / Не обманывать` + (Соответственно все данные и оценки и высказывания этого человека будут должны бытьверными) + +2. `Развиваться` + (Соответствено должны появляться записи о пройденных курсах) + +3. `Верить в духовное (что есть что то большее чем только физическое тело)` + (По этому человек соглашается (не спорит) что есть духовные практики, и проходит курсы и практики духовные) + +4. `Социальная ответственность. Понимание того что мы часть единой цивилизации` + то что человек поддерживает: экологические, социальные, светлые начинания и т.д. + (Соответственно в соц сети. Отчёты о действиях, переводы, подтверждениедругими что ты делаешь) + +5. `Отсноситься кдругим таккак ты хочешь что бы относились к тебе.` + И то что люди тебя так ценят. + (В соц сетиважно как оценивают тебя люди из твоего круга) (И можно написать как ты относишмся к людям и как хочешь что бы относились к тебе - это один пункт) + + Друзья как ты. Ты как друзья. + Друзей оценивают по тебе. Тебя оценивают по друзьям. + + + + diff --git a/src/main/docs/Формат блоков/Описанией записей/Начало блокчейна.md b/src/main/docs/Формат блоков/Описанией записей/Начало блокчейна.md new file mode 100644 index 0000000..88abf8f --- /dev/null +++ b/src/main/docs/Формат блоков/Описанией записей/Начало блокчейна.md @@ -0,0 +1,45 @@ +* ============================================================================ +* HeaderBody — тело записи типа 0 (заглавие блокчейна) +* ============================================================================ +* +* 🧩 Назначение: +* Первый блок каждой пользовательской цепочки (.bch) — это "заголовок". +* Он хранит базовую информацию о владельце, версии и публичном ключе. +* +* Этот блок всегда имеет: +* • recordType = 0 +* • recordNumber = 0 +* • recordTypeVersion = 1 +* +* ---------------------------------------------------------------------------- +* 🔹 Формат body (без общих 20 байт заголовка блока BchBlock) +* +* | Смещение | Размер | Поле | Формат | Описание | +* |-----------|--------|--------------------|---------|-----------| +* | 0x00 | 8 | tag | ASCII | Статическая сигнатура "SHiNE001" | +* +* | 0x10 | 1 | userLoginLength=N | uint8 | Длина логина пользователя | +* | 0x11 | N | userLogin | UTF-8 | Логин пользователя | + +* | 0x11+N | 4 | blockchainType | int BE | Зарезервировано (всегда 0) | + + +* | 0x08 | 8 | blockchainId | long BE | Уникальный идентификатор цепочки | +* | 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 байта публичного ключа] \ No newline at end of file diff --git a/src/main/docs/Формат блоков/Смена Пароля/сама схема смены цп.md b/src/main/docs/Формат блоков/Смена Пароля/сама схема смены цп.md new file mode 100644 index 0000000..566bc0e --- /dev/null +++ b/src/main/docs/Формат блоков/Смена Пароля/сама схема смены цп.md @@ -0,0 +1,49 @@ +Solana говорит актуальные +userLogin +userId + +Текущий номер блокчейна + +И Список Доверенных (userId, дата добавления) +.. Добавить доверенного +.. Убавить доверенного + + +------------------------ +И на каждый блокчен : +UserBlcId +UserBlcSig +UserBlcLimit лимит МБ этого блокчейна + +uerId +Какой это по счёту блокчейн у пользователя +Ид преведущего блокчейна + +----------------- + Можно в солане +Добавить доверенного +Удалить доверенного +Сменить свою подпись (приложив строки с подписью доверенных) + +И задержка на 30 дней довступления в силу +(А со старта можно и без задержки главное библиотеку для доступа к сушностям в солане на js сразу генерировать вместе с растом :)) + +и ещё создать запись для смены ( и пох если зделал то сделал откатить нельзя можнотолько что бы все остальные не голосовали) +-------------- + + +Можно делать технические записи (они совпадают с соланой) + +В самом начале блок №0 +userLogin - userId + +блок №1 +UserBlcId - UserBlcSig + + + +Это чисто записи +Добавить доверенного +Убавить доверенного +Добавить лимит + diff --git a/src/main/docs/Формат блоков/Что пишем в solana.md b/src/main/docs/Формат блоков/Что пишем в solana.md new file mode 100644 index 0000000..22ac27f --- /dev/null +++ b/src/main/docs/Формат блоков/Что пишем в solana.md @@ -0,0 +1,27 @@ +Первый это ссылка (Пда по логину, у него двва ключа "login" и сам логин пользователя (1 байт длинна + логин до 30 символов)) +В логине можно a-z 0-9 и "_" + +В нём записано + Посути нуден только UserId +А так можно ++ вначале 8 байт константа типо ПДА ++ Сам логин с заклавными буквами (не надо) ++ Цп (не надо) + + +Второй блокчен +(ПДА по двум ключам?? Ид) + + ++ вначале 8 байт константа типо ПДА ++ 1 байт - N длинна логина ++ N байт - сам логин (можно с большими буквами) + + + + + + + + + diff --git a/src/main/docs/Формат блоков/структура блока/Запись в блокчейн.txt b/src/main/docs/Формат блоков/структура блока/Запись в блокчейн.txt new file mode 100644 index 0000000..0457c92 --- /dev/null +++ b/src/main/docs/Формат блоков/структура блока/Запись в блокчейн.txt @@ -0,0 +1,66 @@ + * ============================================================================ + * BchBlockEntry — универсальная запись блокчейна SHiNE (.bch) + * ============================================================================ + * + * 🧩 Формат файла .bch: + * Каждый блок хранится последовательно, без промежутков. + * Один блок = «заголовок» (RAW) + подпись (64) + хэш (32). + * + * FULL = RAW + signature(64) + hash(32) + * + * --------------------------------------------------------------------------- + * 🔹 Структура RAW-части блока (без подписи и хэша) + * --------------------------------------------------------------------------- + * Размеры и порядок строго фиксированы (BigEndian). + * + * Порядок байтов (сверху вниз, смещения от начала RAW): + * + * ┌────────────────────────────┬────────┬───────────────────────────────┐ + * │ Поле │ Размер │ Описание │ + * ├────────────────────────────┼────────┼───────────────────────────────┤ + * │ recordSize │ 4 байта│ = M + 20 — общий размер RAW │ + * │ recordNumber │ 4 байта│ порядковый номер блока │ + * │ timestamp │ 8 байт │ UNIX time (секунды) │ + + Номер линии 2 байта линии пока просто пишутся но никак не используются + номер преведущего блока в этой линии 4 байа + + //Можно сказать что здесь уже тело пошло + * │ recordType │ 2 байта│ тип тела (0=Header, 1=Text) │ + * │ recordTypeVersion │ 2 байта│ версия структуры данного типа │ + * │ body │ M байт │ бинарное тело записи │ + * └────────────────────────────┴────────┴───────────────────────────────┘ + * + * ⇒ RAW_HEADER_SIZE = 4 + 4 + 8 + 2 + 2 = 20 байт. + * ⇒ recordSize = RAW_HEADER_SIZE + body.length + * + * --------------------------------------------------------------------------- + * 🔹 Структура FULL-блока + * --------------------------------------------------------------------------- + * + * ┌────────────────────────────┬─────────┬──────────────────────────────┐ + * │ RAW │ M+20 │ тело блока без подписи │ + * │ signature64 │ 64 │ подпись Ed25519(preimage) │ + * │ hash32 │ 32 │ SHA-256(preimage) │ + * └────────────────────────────┴─────────┴──────────────────────────────┘ + * + * ⇒ Общая длина FULL = recordSize + 96 байт. + * + * --------------------------------------------------------------------------- + * 🔹 Канонический preimage для подписи/хэша + * --------------------------------------------------------------------------- + Новый вариант преимадже без блокченй ИД !! + так как он может меняться + + * preimage = Заглавие SHiNE + * userLogin(UTF-8, без длины) + + * userId(8B, BE) + + * можно номер блока? + * prevHash32(32B) + + * rawBytes (M+20B) + * + * hash32 = SHA-256(preimage) + * signature64= Ed25519.sign(preimage, privateKey) + * + * Проверка осуществляется через {@link utils.crypto.BchCryptoVerifier}. + diff --git a/src/main/docs/Формат блоков/структура блока/типы субблокченов.md b/src/main/docs/Формат блоков/структура блока/типы субблокченов.md new file mode 100644 index 0000000..f176303 --- /dev/null +++ b/src/main/docs/Формат блоков/структура блока/типы субблокченов.md @@ -0,0 +1,13 @@ +Технический блокчен + +Блоки в солану + +Личнык данные +Связи + + +Публичные сообщения + + + +Личые письма \ No newline at end of file diff --git a/src/main/java/CreateNewDatabase.java b/src/main/java/CreateNewDatabase.java new file mode 100644 index 0000000..614c432 --- /dev/null +++ b/src/main/java/CreateNewDatabase.java @@ -0,0 +1,9 @@ +import shine.db.DatabaseInitializer; + +public class CreateNewDatabase { + + public static void main(String[] args) { + // Просто прокидываем управление в DatabaseInitializer + DatabaseInitializer.createNewDB(args); + } +} diff --git a/src/main/java/TestJsonWsClient.java b/src/main/java/TestJsonWsClient.java new file mode 100644 index 0000000..615d843 --- /dev/null +++ b/src/main/java/TestJsonWsClient.java @@ -0,0 +1,106 @@ +import java.net.URI; +import java.net.http.HttpClient; +import java.net.http.WebSocket; +import java.net.http.WebSocket.Listener; +import java.nio.charset.StandardCharsets; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.CompletionStage; +import java.util.concurrent.CountDownLatch; + +public class TestJsonWsClient { + + public static void main(String[] args) throws Exception { + String uri = "ws://localhost:7070/ws"; + + + String jsonRequestSessionRefresh = """ + { + "op": "SessionRefresh", + "requestId": "test-1", + "sessionId": 123, + "sessionPwd": "test-password" + } + """; + + String jsonRequestAddUser = """ + { + "op": "AddUser", + "requestId": "test-add-1", + "login": "anya1111", + "loginId": 100211, + "bchId": 4222, + "pubkey0": "PUB0", + "pubkey1": "PUB1", + "bchLimit": 1000000 + } + """; + + String jsonRequestAuthSessionNewStep1 = """ + { + "op": "AuthSessionNewStep1", + "requestId": "test-auth-1", + "login": "anya1111" + } + """; + + + // Тестовый JSON-пакет SessionRefresh + String jsonRequest = jsonRequestAuthSessionNewStep1; + + System.out.println("Подключаемся к " + uri); + + CountDownLatch latch = new CountDownLatch(1); + + HttpClient client = HttpClient.newHttpClient(); + + WebSocket webSocket = client.newWebSocketBuilder() + .buildAsync(URI.create(uri), new Listener() { + @Override + public void onOpen(WebSocket webSocket) { + System.out.println("✅ WebSocket подключен"); + + // Отправляем JSON сразу после подключения + System.out.println("📤 Отправляем JSON-запрос:"); + System.out.println(jsonRequest); + + webSocket.sendText(jsonRequest, true); + Listener.super.onOpen(webSocket); + } + + @Override + public CompletionStage onText(WebSocket webSocket, + CharSequence data, + boolean last) { + String message = data.toString(); + System.out.println("📥 Получен TEXT-ответ от сервера:"); + System.out.println(message); + + // После получения первого ответа — закрываем соединение + webSocket.sendClose(WebSocket.NORMAL_CLOSURE, "test done"); + latch.countDown(); + return Listener.super.onText(webSocket, data, last); + } + + @Override + public void onError(WebSocket webSocket, Throwable error) { + System.out.println("❌ Ошибка WebSocket-клиента: " + error.getMessage()); + error.printStackTrace(System.out); + latch.countDown(); + } + + + @Override + public CompletionStage onClose(WebSocket webSocket, + int statusCode, + String reason) { + System.out.println("🔚 Соединение закрыто. Код=" + statusCode + ", причина=" + reason); + latch.countDown(); + return Listener.super.onClose(webSocket, statusCode, reason); + } + }).join(); + + // Ждём, пока получим ответ/ошибку/закрытие + latch.await(); + System.out.println("Тест завершён, выходим."); + } +} diff --git a/src/main/java/TestJsonWsClient2.java b/src/main/java/TestJsonWsClient2.java new file mode 100644 index 0000000..2dedb98 --- /dev/null +++ b/src/main/java/TestJsonWsClient2.java @@ -0,0 +1,119 @@ +import java.net.URI; +import java.net.http.HttpClient; +import java.net.http.WebSocket; +import java.net.http.WebSocket.Listener; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.CompletionStage; +import java.util.concurrent.CountDownLatch; + +public class TestJsonWsClient2 { + + public static void main(String[] args) throws Exception { + String uri = "ws://localhost:7070/ws"; + + String jsonRequestSessionRefresh = """ + { + "op": "SessionRefresh", + "requestId": "test-1", + "sessionId": 123, + "sessionPwd": "test-password" + } + """; + + String jsonRequestAddUser = """ + { + "op": "AddUser", + "requestId": "test-add-1", + "login": "anya1111", + "loginId": 100211, + "bchId": 4222, + "pubkey0": "PUB0", + "pubkey1": "PUB1", + "bchLimit": 1000000 + } + """; + + String jsonRequestAuthSessionNewStep1 = """ + { + "op": "AuthSessionNewStep1", + "requestId": "test-auth-1", + "login": "anya1111" + } + """; + + // Что тестируем сейчас: + String jsonRequest = jsonRequestAuthSessionNewStep1; +// String jsonRequest = jsonRequestSessionRefresh; +// String jsonRequest = jsonRequestAddUser; + + System.out.println("Подключаемся к " + uri); + + CountDownLatch latch = new CountDownLatch(1); + + HttpClient client = HttpClient.newHttpClient(); + + WebSocket webSocket = client.newWebSocketBuilder() + .buildAsync(URI.create(uri), new Listener() { + + // 0 — ещё ничего не получили + // 1 — получили 1-й ответ, отправили повторно + // 2 — получили 2-й ответ, закрываемся + private int responsesCount = 0; + + @Override + public void onOpen(WebSocket webSocket) { + System.out.println("✅ WebSocket подключен"); + + System.out.println("📤 Отправляем JSON-запрос (1 раз):"); + System.out.println(jsonRequest); + + webSocket.sendText(jsonRequest, true); + Listener.super.onOpen(webSocket); + } + + @Override + public CompletionStage onText(WebSocket webSocket, + CharSequence data, + boolean last) { + String message = data.toString(); + responsesCount++; + + System.out.println("📥 Получен TEXT-ответ #" + responsesCount + " от сервера:"); + System.out.println(message); + + if (responsesCount == 1) { + // После первого ответа — отправляем тот же запрос ещё раз + System.out.println("📤 Отправляем JSON-запрос второй раз:"); + System.out.println(jsonRequest); + webSocket.sendText(jsonRequest, true); + } else { + // После второго ответа — закрываем соединение + webSocket.sendClose(WebSocket.NORMAL_CLOSURE, "test done"); + latch.countDown(); + } + + return Listener.super.onText(webSocket, data, last); + } + + @Override + public void onError(WebSocket webSocket, Throwable error) { + System.out.println("❌ Ошибка WebSocket-клиента: " + error.getMessage()); + error.printStackTrace(System.out); + latch.countDown(); + } + + @Override + public CompletionStage onClose(WebSocket webSocket, + int statusCode, + String reason) { + System.out.println("🔚 Соединение закрыто. Код=" + statusCode + ", причина=" + reason); + latch.countDown(); + return Listener.super.onClose(webSocket, statusCode, reason); + } + }).join(); + + // Ждём, пока получим ответ/ошибку/закрытие + latch.await(); + System.out.println("Тест завершён, выходим."); + } +} diff --git a/src/main/java/WsTestClient.java b/src/main/java/WsTestClient.java new file mode 100644 index 0000000..76a3d89 --- /dev/null +++ b/src/main/java/WsTestClient.java @@ -0,0 +1,356 @@ +import java.net.URI; +import java.net.http.HttpClient; +import java.net.http.WebSocket; +import java.nio.ByteBuffer; +import java.nio.ByteOrder; +import java.nio.charset.StandardCharsets; +import java.time.Instant; +import java.time.ZoneId; +import java.time.format.DateTimeFormatter; +import java.util.*; +import java.util.concurrent.*; + +public class WsTestClient { + + // ==== Настройки клиента ==== + static final String WS_URL = "wss://shineup.me/ws";// "ws://localhost:8080/ws"; + + // ==== Тестовые параметры ==== + static final String FIXED_PRIVATE_KEY_STRING = "SHiNE_TEST_FIXED_PRIVATE_KEY_2025"; + static final long BLOCKCHAIN_ID = 351130785469109974L;//777_000_001L; + static final int BLOCKCHAIN_TYPE = 0; + static final int BLOCKCHAIN_NUM = 0; + static final short VERSION_USER_BCH = 1; + static final long PREV_USER_BCH_ID = 0L; + static final String USER_LOGIN = "test_user"; + + // ==== Опкоды ==== + static final int OP_ADD_BLOCK = 1; + static final int OP_GET_BLOCKCHAIN = 2; + + // ==== Статусы ==== + static final int STATUS_OK = 200; + static final int STATUS_BAD_REQUEST = 400; + static final int STATUS_ALREADY_EXISTS = 409; + static final int STATUS_NON_SEQUENTIAL = 412; + static final int STATUS_UNVERIFIED = 422; + static final int STATUS_INTERNAL = 500; + + // ==== Типы блоков ==== + static final short TYPE_HEADER = 0; + static final short TYPE_TEXT = 1; + static final short RECORD_TYPE_VERSION = 1; // Новое поле + + // ==== Константы формата ==== + static final int SIGNATURE_LEN = 64; + static final int HASH_LEN = 32; + static final int RAW_HEADER_SIZE = 4 + 4 + 8 + 2 + 2; // Теперь 20 байт + + public static void main(String[] args) throws Exception { + System.out.println("=== WsTestClient v1.1 ==="); + + byte[] priv32 = HashUtil.sha256(FIXED_PRIVATE_KEY_STRING.getBytes(StandardCharsets.UTF_8)); + byte[] pub32 = Ed25519Util.derivePublicKey(priv32); + + WsBinaryCollector reader = new WsBinaryCollector(); + WebSocket ws = HttpClient.newHttpClient() + .newWebSocketBuilder() + .buildAsync(URI.create(WS_URL), reader) + .join(); + System.out.println("✅ Connected to " + WS_URL); + + // === 1. Создание заглавного блока === + byte[] headerBody = buildHeaderBody(USER_LOGIN, BLOCKCHAIN_ID, BLOCKCHAIN_TYPE, BLOCKCHAIN_NUM, + VERSION_USER_BCH, PREV_USER_BCH_ID, pub32); + + long ts = Instant.now().getEpochSecond(); + byte[] rawHeader = buildRawRecord(0, ts, TYPE_HEADER, RECORD_TYPE_VERSION, headerBody); + byte[] fullHeader = signAndPack(rawHeader, USER_LOGIN, BLOCKCHAIN_ID, new byte[32], priv32, pub32); + + byte[] addHeaderMsg = concat(beInt(OP_ADD_BLOCK), beLong(BLOCKCHAIN_ID), fullHeader); + int st1 = sendAndReadStatus(ws, addHeaderMsg, reader); + System.out.println("ADD HEADER → " + st1 + " (" + statusName(st1) + ")"); + + // === 2. Получаем всю цепочку === + ResponseWithPayload chainResp = sendAndReadPayload(ws, concat(beInt(OP_GET_BLOCKCHAIN), beLong(BLOCKCHAIN_ID)), reader); + System.out.println("GET_BLOCKCHAIN → " + chainResp.status + " (" + statusName(chainResp.status) + ")"); + if (chainResp.status != STATUS_OK) return; + + List blocks = parseAllBlocks(chainResp.payload); + System.out.println("Chain contains " + blocks.size() + " blocks:"); + + for (BlockParsed bp : blocks) { + printBlock(bp); + } + + // === 3. Добавление нового текстового блока === + Scanner sc = new Scanner(System.in, StandardCharsets.UTF_8); + System.out.print("\nВведите текст для добавления в блокчейн (Enter — пропустить): "); + String text = sc.nextLine().trim(); + if (!text.isEmpty()) { + byte[] lastHash = blocks.isEmpty() ? new byte[32] : blocks.get(blocks.size() - 1).hash32; + int nextNum = blocks.isEmpty() ? 0 : (blocks.get(blocks.size() - 1).recordNumber + 1); + + byte[] textBody = text.getBytes(StandardCharsets.UTF_8); + byte[] rawText = buildRawRecord(nextNum, Instant.now().getEpochSecond(), TYPE_TEXT, RECORD_TYPE_VERSION, textBody); + byte[] fullText = signAndPack(rawText, USER_LOGIN, BLOCKCHAIN_ID, lastHash, priv32, pub32); + + int st2 = sendAndReadStatus(ws, concat(beInt(OP_ADD_BLOCK), beLong(BLOCKCHAIN_ID), fullText), reader); + System.out.println("ADD TEXT → " + st2 + " (" + statusName(st2) + ")"); + } + + ws.sendClose(WebSocket.NORMAL_CLOSURE, "bye").join(); + System.out.println("=== Done ==="); + } + + // ============================================================== + // БЛОКИ + // ============================================================== + + static byte[] buildRawRecord(int recordNumber, long timestampSec, + short recordType, short recordTypeVersion, byte[] body) { + int recordSize = RAW_HEADER_SIZE + body.length; + ByteBuffer buf = ByteBuffer.allocate(recordSize).order(ByteOrder.BIG_ENDIAN); + buf.putInt(recordSize); + buf.putInt(recordNumber); + buf.putLong(timestampSec); + buf.putShort(recordType); + buf.putShort(recordTypeVersion); + buf.put(body); + return buf.array(); + } + + static byte[] buildHeaderBody(String userLogin, long blockchainId, int blockchainType, + int blockchainNumber, short versionUserBch, + long prevUserBchId, byte[] publicKey32) { + byte[] tag = "SHiNE001".getBytes(StandardCharsets.US_ASCII); + byte[] loginUtf8 = userLogin.getBytes(StandardCharsets.UTF_8); + if (loginUtf8.length > 255) throw new IllegalArgumentException("Логин слишком длинный"); + + int cap = 8 + 8 + 1 + loginUtf8.length + 4 + 4 + 2 + 8 + 32; + ByteBuffer buf = ByteBuffer.allocate(cap).order(ByteOrder.BIG_ENDIAN); + buf.put(tag); + buf.putLong(blockchainId); + buf.put((byte) loginUtf8.length); + buf.put(loginUtf8); + buf.putInt(blockchainType); + buf.putInt(blockchainNumber); + buf.putShort(versionUserBch); + buf.putLong(prevUserBchId); + buf.put(publicKey32); + return buf.array(); + } + + static byte[] signAndPack(byte[] rawBytes, String userLogin, long blockchainId, + byte[] prevHash32, byte[] privateKey32, byte[] publicKey32) { + byte[] preimage = buildPreimage(userLogin, blockchainId, prevHash32, rawBytes); + byte[] hash32 = HashUtil.sha256(preimage); + byte[] sig64 = Ed25519Util.sign(preimage, privateKey32); + return concat(rawBytes, sig64, hash32); + } + + // ============================================================== + // ПАРСИНГ + // ============================================================== + + static class BlockParsed { + int recordSize; + int recordNumber; + long timestamp; + short recordType; + short recordTypeVersion; + byte[] body; + byte[] signature64; + byte[] hash32; + } + + static List parseAllBlocks(byte[] file) { + List out = new ArrayList<>(); + int p = 0; + while (p + 4 <= file.length) { + int recordSize = beInt(file, p); + int total = recordSize + SIGNATURE_LEN + HASH_LEN; + if (p + total > file.length) break; + + ByteBuffer raw = ByteBuffer.wrap(file, p, recordSize).order(ByteOrder.BIG_ENDIAN); + BlockParsed bp = new BlockParsed(); + bp.recordSize = raw.getInt(); + bp.recordNumber = raw.getInt(); + bp.timestamp = raw.getLong(); + bp.recordType = raw.getShort(); + bp.recordTypeVersion = raw.getShort(); + int bodyLen = bp.recordSize - RAW_HEADER_SIZE; + bp.body = new byte[bodyLen]; + raw.get(bp.body); + bp.signature64 = Arrays.copyOfRange(file, p + recordSize, p + recordSize + SIGNATURE_LEN); + bp.hash32 = Arrays.copyOfRange(file, p + recordSize + SIGNATURE_LEN, p + recordSize + SIGNATURE_LEN + HASH_LEN); + out.add(bp); + p += total; + } + return out; + } + + static void printBlock(BlockParsed b) { + System.out.println("------------------------------------------------------------"); + String ts = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss") + .withZone(ZoneId.systemDefault()) + .format(Instant.ofEpochSecond(b.timestamp)); + System.out.printf("num=%d, type=%d, ver=%d, ts=%s, size=%d%n", + b.recordNumber, b.recordType, b.recordTypeVersion, ts, b.recordSize); + + if (b.recordType == TYPE_HEADER) + printHeaderBody(b.body); + else if (b.recordType == TYPE_TEXT) + System.out.println("TEXT: " + new String(b.body, StandardCharsets.UTF_8)); + else + System.out.println("UNKNOWN BODY (" + b.body.length + " bytes)"); + + System.out.println("hash=" + toHex(b.hash32)); + } + + static void printHeaderBody(byte[] body) { + ByteBuffer buf = ByteBuffer.wrap(body).order(ByteOrder.BIG_ENDIAN); + byte[] tag = new byte[8]; buf.get(tag); + long id = buf.getLong(); + int n = Byte.toUnsignedInt(buf.get()); + byte[] login = new byte[n]; buf.get(login); + int type = buf.getInt(); + int num = buf.getInt(); + buf.getShort(); buf.getLong(); // version + prev + byte[] pub = new byte[32]; buf.get(pub); + + System.out.println("HEADER: login=" + new String(login, StandardCharsets.UTF_8) + + ", id=" + id + ", type=" + type + ", num=" + num); + System.out.println("(pubkey first 4 bytes: " + toHex(Arrays.copyOf(pub, 4)) + "...)"); + } + + // ============================================================== + // Вебсокет и вспомогательные классы + // ============================================================== + + static int sendAndReadStatus(WebSocket ws, byte[] payload, WsBinaryCollector reader) { + ws.sendBinary(ByteBuffer.wrap(payload), true).join(); + byte[] resp = reader.collect(ws); + if (resp == null || resp.length < 4) throw new IllegalStateException("empty response"); + return beInt(resp, 0); + } + + static class ResponseWithPayload { + int status; + byte[] payload; + } + + static ResponseWithPayload sendAndReadPayload(WebSocket ws, byte[] payload, WsBinaryCollector reader) { + ws.sendBinary(ByteBuffer.wrap(payload), true).join(); + byte[] resp = reader.collect(ws); + ResponseWithPayload out = new ResponseWithPayload(); + out.status = beInt(resp, 0); + if (out.status == STATUS_OK) { + int len = beInt(resp, 4); + out.payload = Arrays.copyOfRange(resp, 8, 8 + len); + } + return out; + } + + static class WsBinaryCollector implements WebSocket.Listener { + private volatile CompletableFuture future = new CompletableFuture<>(); + private ByteBuffer acc = ByteBuffer.allocate(0); + + public synchronized byte[] collect(WebSocket ws) { + acc = ByteBuffer.allocate(0); + future = new CompletableFuture<>(); + ws.request(1); + return future.join(); + } + + @Override public void onOpen(WebSocket ws) { ws.request(1); } + @Override public CompletionStage onBinary(WebSocket ws, ByteBuffer data, boolean last) { + ByteBuffer newBuf = ByteBuffer.allocate(acc.remaining() + data.remaining()); + newBuf.put(acc); newBuf.put(data); newBuf.flip(); + acc = newBuf; + if (last) { + byte[] all = new byte[acc.remaining()]; + acc.get(all); + future.complete(all); + } + ws.request(1); + return CompletableFuture.completedFuture(null); + } + @Override public CompletionStage onText(WebSocket ws, CharSequence data, boolean last) { + if (last) future.complete(data.toString().getBytes(StandardCharsets.UTF_8)); + ws.request(1); + return CompletableFuture.completedFuture(null); + } + @Override public void onError(WebSocket ws, Throwable error) { future.completeExceptionally(error); } + } + + // ============================================================== + // Крипто и утилиты + // ============================================================== + + static byte[] buildPreimage(String userLogin, long blockchainId, byte[] prevHash32, byte[] rawBytes) { + byte[] loginUtf8 = userLogin.getBytes(StandardCharsets.UTF_8); + ByteBuffer buf = ByteBuffer.allocate(loginUtf8.length + 8 + 32 + rawBytes.length).order(ByteOrder.BIG_ENDIAN); + buf.put(loginUtf8); + buf.putLong(blockchainId); + buf.put(prevHash32); + buf.put(rawBytes); + return buf.array(); + } + + static final class HashUtil { + static byte[] sha256(byte[] data) { + org.bouncycastle.crypto.digests.SHA256Digest d = new org.bouncycastle.crypto.digests.SHA256Digest(); + d.update(data, 0, data.length); + byte[] out = new byte[32]; + d.doFinal(out, 0); + return out; + } + } + + static final class Ed25519Util { + static byte[] derivePublicKey(byte[] privateKey32) { + var priv = new org.bouncycastle.crypto.params.Ed25519PrivateKeyParameters(privateKey32, 0); + return priv.generatePublicKey().getEncoded(); + } + static byte[] sign(byte[] data, byte[] privateKey32) { + var priv = new org.bouncycastle.crypto.params.Ed25519PrivateKeyParameters(privateKey32, 0); + var signer = new org.bouncycastle.crypto.signers.Ed25519Signer(); + signer.init(true, priv); + signer.update(data, 0, data.length); + return signer.generateSignature(); + } + } + + // ==== Утилиты ==== + static byte[] concat(byte[]... parts) { + int n = Arrays.stream(parts).mapToInt(a -> a.length).sum(); + byte[] out = new byte[n]; + int off = 0; + for (byte[] p : parts) { System.arraycopy(p, 0, out, off, p.length); off += p.length; } + return out; + } + + static byte[] beInt(int v) { return ByteBuffer.allocate(4).order(ByteOrder.BIG_ENDIAN).putInt(v).array(); } + static byte[] beLong(long v) { return ByteBuffer.allocate(8).order(ByteOrder.BIG_ENDIAN).putLong(v).array(); } + static int beInt(byte[] a, int off) { return ByteBuffer.wrap(a, off, 4).order(ByteOrder.BIG_ENDIAN).getInt(); } + + static String toHex(byte[] b) { + StringBuilder sb = new StringBuilder(b.length * 2); + for (byte x : b) sb.append(String.format("%02x", x)); + return sb.toString(); + } + + static String statusName(int code) { + return switch (code) { + case STATUS_OK -> "OK"; + case STATUS_BAD_REQUEST -> "BAD_REQUEST"; + case STATUS_ALREADY_EXISTS -> "ALREADY_EXISTS"; + case STATUS_NON_SEQUENTIAL -> "NON_SEQUENTIAL"; + case STATUS_UNVERIFIED -> "UNVERIFIED"; + case STATUS_INTERNAL -> "INTERNAL_ERROR"; + default -> "UNKNOWN"; + }; + } +} + diff --git a/src/main/java/server/logic/InboundMessageProcessor.java b/src/main/java/server/logic/InboundMessageProcessor.java new file mode 100644 index 0000000..49fc13f --- /dev/null +++ b/src/main/java/server/logic/InboundMessageProcessor.java @@ -0,0 +1,66 @@ +package server.logic; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import server.logic.ws_protocol.binary.handlers.*; +import server.logic.ws_protocol.WireCodes; + +import java.nio.ByteBuffer; +import java.nio.ByteOrder; +import java.util.Map; + +/** + * Обработчик входящих сообщение на сервер. + * По коду сообщения (первые 4 байта сообщения) находи нужный хэндлер и передаёт в него сообщение + * Получает и возвращает ответ от хэндлера + */ +public final class InboundMessageProcessor { + private static final Logger log = LoggerFactory.getLogger(InboundMessageProcessor.class); + + private static final Map HANDLERS = Map.of( + WireCodes.Op.PING, new PingHandler(), + WireCodes.Op.ADD_BLOCK, new AddBlockHandler(), + WireCodes.Op.GET_BLOCKCHAIN,new GetBlockchainHandler(), + WireCodes.Op.SEARCH_USERS, new SearchUsersHandler(), + WireCodes.Op.GET_LAST_BLOCK_INFO,new GetLastBlockInfoHandler() + + ); + + private InboundMessageProcessor() {} + + public static byte[] process(byte[] msg) { + if (msg == null || msg.length < 4) + return intTo4Bytes(WireCodes.Status.BAD_REQUEST); + + int op = first4ToInt(msg); + MessageHandler h = HANDLERS.get(op); + if (h == null) { + log.warn("Неизвестная операция: {}", op); + return intTo4Bytes(WireCodes.Status.BAD_REQUEST); + } + + try { + return h.handle(msg); + } catch (Exception e) { + log.error("Ошибка при обработке операции {}", op, e); + return intTo4Bytes(WireCodes.Status.INTERNAL_ERROR); + } + } + + private static int first4ToInt(byte[] msg) { + return ByteBuffer.wrap(msg, 0, 4) + .order(ByteOrder.BIG_ENDIAN) + .getInt(); + } + + public static byte[] intTo4Bytes(int code) { + return ByteBuffer.allocate(4) + .order(ByteOrder.BIG_ENDIAN) + .putInt(code) + .array(); + } + + + +} + diff --git a/src/main/java/server/logic/ws_protocol/binary/handlers/AddBlockHandler.java b/src/main/java/server/logic/ws_protocol/binary/handlers/AddBlockHandler.java new file mode 100644 index 0000000..bb85d6c --- /dev/null +++ b/src/main/java/server/logic/ws_protocol/binary/handlers/AddBlockHandler.java @@ -0,0 +1,250 @@ +package server.logic.ws_protocol.binary.handlers; + +import blockchain.BchBlockEntry; +import blockchain.body.BodyRecord; +import blockchain.BodyRecordParser; +import blockchain.body.HeaderBody; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import server.logic.ws_protocol.WireCodes; +import utils.blockchain.BchInfoEntry; +import utils.blockchain.BchInfoManager; +import utils.crypto.BchCryptoVerifier; +import utils.files.FileStoreUtil; + +import java.nio.ByteBuffer; +import java.nio.ByteOrder; +import java.util.Arrays; + +/** + * AddBlockHandler — обработчик команды "добавить блок" (ADD_BLOCK) + * --------------------------------------------------------------- + * Принимает бинарное сообщение от клиента и добавляет новый блок в цепочку. + * + * Формат входного сообщения (msg): + * [0..3] — 4 байта: код операции (WireCodes.ADD_BLOCK) + * [4..11] — 8 байт: blockchainId (уникальный идентификатор цепочки) + * [12..] — байты полного блока .bch: + * ├── 4 байта recordSize = M + 18 + * ├── 4 байта recordNumber + * ├── 8 байт timestamp + * ├── 2 байта recordType + * ├── 2 байта recordVersion + * ├── M байт body (содержимое блока) + * ├── 64 байта signature (Ed25519) + * └── 32 байта hash (SHA-256) + * + * --------------------------------------------------------------- + * Алгоритм работы: + * + * 1️⃣ Распаковать BchBlockEntry из msg (т.е. выделить тело блока и подписи). + * 2️⃣ Найти описание цепочки (BchInfoEntry) по blockchainId. + * + * ─ Если описания нет (цепочка ещё не существует): + * • принимаем только блок типа 0 (HeaderBody) и номера 0; + * • парсим его, создаём новый BchInfoEntry на основе данных заголовка; + * • проверяем подпись и хэш; + * • проверяем корректность тела блока (check); + * • сохраняем блок и создаём новый blockchain-файл; + * • добавляем цепочку в менеджер BchInfoManager. + * (💡 временное решение: создание цепочки допустимо только через HeaderBody) + * + * ─ Если цепочка уже существует: + * • проверяем, что номер блока равен (lastBlockNumber + 1); + * • проверяем подпись и хэш; + * • проверяем тело блока (check); + * • добавляем блок в файл цепочки; + * • обновляем состояние BchInfoEntry (номер, хэш, размер). + * + * 3️⃣ Если все проверки пройдены — возвращаем статус OK. + * + * Таким образом, единственное различие между первым блоком и последующими — + * момент инициализации описания цепочки (BchInfoEntry). + * Всё остальное (валидация, подпись, добавление, обновление) выполняется одинаково. + */ +public class AddBlockHandler implements MessageHandler { + + private static final Logger log = LoggerFactory.getLogger(AddBlockHandler.class); + + @Override + public byte[] handle(byte[] msg) { + try { + // ===================================================================== + // 1️⃣ Проверка минимальной длины пакета + // ===================================================================== + int minFull = BchBlockEntry.RAW_HEADER_SIZE + BchBlockEntry.SIGNATURE_LEN + BchBlockEntry.HASH_LEN; + // (RAW_HEADER_SIZE = 18 байт, подпись = 64, хэш = 32) + if (msg.length < 4 + 8 + minFull) + return code(WireCodes.Status.BAD_REQUEST); + + // ===================================================================== + // 2️⃣ Извлекаем blockchainId (8 байт начиная с позиции 4) + // ===================================================================== + long blockchainId = ByteBuffer.wrap(msg, 4, 8) + .order(ByteOrder.BIG_ENDIAN) + .getLong(); + + // Всё, что дальше, — это бинарное содержимое блока .bch + int offset = 12; // первые 12 байт = код + blockchainId + + // ===================================================================== + // 3️⃣ Парсим блок (RAW + подпись + хэш) + // ===================================================================== + byte[] fullBlock = Arrays.copyOfRange(msg, offset, msg.length); + BchBlockEntry block = new BchBlockEntry(fullBlock); // сам распакует RAW-часть и подписи + + // ===================================================================== + // 4️⃣ Получаем текущее описание цепочки (BchInfoEntry) + // ===================================================================== + BchInfoManager info = BchInfoManager.getInstance(); + BchInfoEntry chain = info.getBchInfo(blockchainId); + + byte[] prevHash32; + int expectedNum; + String userLogin; + byte[] publicKey32; + + // ===================================================================== + // 🧩 СЦЕНАРИЙ 1: цепочка отсутствует — создаём новую + // ===================================================================== + if (chain == null) { + // Допускаем только блок-заголовок (type=0, num=0) + if (block.recordType != BchBlockEntry.TYPE_HEADER || block.recordNumber != 0) { + log.warn("Попытка создать новую цепочку без корректного заголовка (type={}, num={})", + block.recordType, block.recordNumber); + return code(WireCodes.Status.BAD_REQUEST); + } + + // Парсим тело блока → HeaderBody + BodyRecord body = BodyRecordParser.parse(block.recordType, block.recordTypeVersion, block.body).check(); + if (!(body instanceof HeaderBody)) + return code(WireCodes.Status.BAD_REQUEST); + + HeaderBody hb = (HeaderBody) body; + + // Проверяем, что blockchainId совпадает + if (hb.blockchainId != blockchainId) { + log.warn("Несовпадение blockchainId в заголовке (ожидалось {}, получено {})", + blockchainId, hb.blockchainId); + return code(WireCodes.Status.BAD_REQUEST); + } + + // Проверяем подпись и хэш первого блока (предыдущий хэш = 0) + prevHash32 = new byte[32]; + boolean verified = BchCryptoVerifier.verifyAll( + hb.userLogin, + blockchainId, + prevHash32, + block.rawBytes, + block.getSignature64(), + block.getHash32(), + hb.publicKey32 + ); + if (!verified) { + log.warn("❌ Подпись не прошла проверку при создании цепочки blockchainId={}", blockchainId); + return code(WireCodes.Status.UNVERIFIED); + } + + // ✅ Всё хорошо: создаём новую цепочку + info.addBlockchain(blockchainId, hb.userLogin, hb.publicKey32, Integer.MAX_VALUE); + info.updateBlockchainState(blockchainId, block.recordNumber, bytesToHex(block.getHash32()), fullBlock.length); + + FileStoreUtil.getInstance().addDataToBlockchain(blockchainId, fullBlock); + + log.info("✅ Создана новая цепочка blockchainId={}, user={}, blockNum={}", + blockchainId, hb.userLogin, block.recordNumber); + + return code(WireCodes.Status.OK); + } + + // ===================================================================== + // 🧩 СЦЕНАРИЙ 2: цепочка существует — добавляем новый блок + // ===================================================================== + expectedNum = chain.lastBlockNumber + 1; + + // Проверка последовательности (и отправка lastBlockNumber) + if (block.recordNumber < expectedNum) { + log.info("🔁 Блок {} уже существует, последний = {}", block.recordNumber, chain.lastBlockNumber); + ByteBuffer out = ByteBuffer.allocate(8).order(ByteOrder.BIG_ENDIAN); + out.putInt(WireCodes.Status.BLOCK_ALREADY_EXISTS); + out.putInt(chain.lastBlockNumber); + return out.array(); + } + if (block.recordNumber > expectedNum) { + log.warn("⚠️ Нарушена последовательность: получен {}, ожидался {}", block.recordNumber, expectedNum); + ByteBuffer out = ByteBuffer.allocate(8).order(ByteOrder.BIG_ENDIAN); + out.putInt(WireCodes.Status.OUT_OF_SEQUENCE); + out.putInt(chain.lastBlockNumber); + return out.array(); + } + + userLogin = chain.userLogin; + publicKey32 = chain.getPublicKey32(); + + // Хэш предыдущего блока (или 32 нуля, если это первый) + prevHash32 = (chain.lastBlockHash == null || chain.lastBlockHash.isEmpty()) + ? new byte[32] + : hexToBytes(chain.lastBlockHash); + + // Проверяем подпись и хэш + boolean verified = BchCryptoVerifier.verifyAll( + userLogin, + blockchainId, + prevHash32, + block.rawBytes, + block.getSignature64(), + block.getHash32(), + publicKey32 + ); + if (!verified) { + log.warn("❌ Подпись не прошла проверку: chainId={}, blockNum={}", blockchainId, block.recordNumber); + return code(WireCodes.Status.UNVERIFIED); + } + + // Проверяем тело блока (например, корректный UTF-8 или структура) + BodyRecord body = BodyRecordParser.parse(block.recordType, block.recordTypeVersion, block.body).check(); + + // ✅ Добавляем блок в файл цепочки + FileStoreUtil.getInstance().addDataToBlockchain(blockchainId, fullBlock); + + // Обновляем состояние цепочки (номер, хэш, размер) + int newSize = chain.blockchainSize + fullBlock.length; + info.updateBlockchainState(blockchainId, block.recordNumber, bytesToHex(block.getHash32()), newSize); + + log.info("✅ Блок добавлен: chain={}, num={}, type={}, bytes={}", + blockchainId, block.recordNumber, block.recordType, fullBlock.length); + + return code(WireCodes.Status.OK); + + } catch (Exception e) { + log.error("❌ ADD_BLOCK: внутренняя ошибка при обработке", e); + return code(WireCodes.Status.INTERNAL_ERROR); + } + } + + // ===================================================================== + // Утилиты + // ===================================================================== + + /** Преобразовать статус (int) в 4 байта BigEndian. */ + private static byte[] code(int status) { + return ByteBuffer.allocate(4).order(ByteOrder.BIG_ENDIAN).putInt(status).array(); + } + + /** Конвертация HEX → bytes (для хэшей). */ + private static byte[] hexToBytes(String hex) { + int len = hex.length(); + byte[] out = new byte[len / 2]; + for (int i = 0; i < len; i += 2) + out[i / 2] = (byte) Integer.parseInt(hex.substring(i, i + 2), 16); + return out; + } + + /** Конвертация bytes → HEX (для сохранения в BchInfo). */ + private static String bytesToHex(byte[] b) { + StringBuilder sb = new StringBuilder(b.length * 2); + for (byte x : b) sb.append(String.format("%02x", x)); + return sb.toString(); + } +} + diff --git a/src/main/java/server/logic/ws_protocol/binary/handlers/GetBlockchainHandler.java b/src/main/java/server/logic/ws_protocol/binary/handlers/GetBlockchainHandler.java new file mode 100644 index 0000000..f717c1f --- /dev/null +++ b/src/main/java/server/logic/ws_protocol/binary/handlers/GetBlockchainHandler.java @@ -0,0 +1,53 @@ +package server.logic.ws_protocol.binary.handlers; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import server.logic.ws_protocol.WireCodes; +import utils.files.FileStoreUtil; + +import java.nio.ByteBuffer; +import java.nio.ByteOrder; + +/** + * Возврат полного содержимого блокчейна (GET_BLOCKCHAIN). + */ +public class GetBlockchainHandler implements MessageHandler { + private static final Logger log = LoggerFactory.getLogger(GetBlockchainHandler.class); + + @Override + public byte[] handle(byte[] msg) { + try { + if (msg.length < 12) + return intTo4Bytes(WireCodes.Status.BAD_REQUEST); + + long id = ByteBuffer.wrap(msg, 4, 8) + .order(ByteOrder.BIG_ENDIAN) + .getLong(); + + FileStoreUtil fs = FileStoreUtil.getInstance(); + byte[] data = fs.readAllDataFromBlockchain(id); + + return packOk(data); + + } catch (IllegalStateException e) { + log.warn("GET_BLOCKCHAIN: файл не найден ({})", e.getMessage()); + return intTo4Bytes(WireCodes.Status.CHAIN_NOT_FOUND); + } catch (Exception e) { + log.error("GET_BLOCKCHAIN: ошибка", e); + return intTo4Bytes(WireCodes.Status.INTERNAL_ERROR); + } + } + + private static byte[] packOk(byte[] data) { + if (data == null) data = new byte[0]; + ByteBuffer out = ByteBuffer.allocate(8 + data.length).order(ByteOrder.BIG_ENDIAN); + out.putInt(WireCodes.Status.OK); + out.putInt(data.length); + out.put(data); + return out.array(); + } + + private static byte[] intTo4Bytes(int code) { + return ByteBuffer.allocate(4).order(ByteOrder.BIG_ENDIAN).putInt(code).array(); + } +} diff --git a/src/main/java/server/logic/ws_protocol/binary/handlers/GetLastBlockInfoHandler.java b/src/main/java/server/logic/ws_protocol/binary/handlers/GetLastBlockInfoHandler.java new file mode 100644 index 0000000..aff0e34 --- /dev/null +++ b/src/main/java/server/logic/ws_protocol/binary/handlers/GetLastBlockInfoHandler.java @@ -0,0 +1,66 @@ +package server.logic.ws_protocol.binary.handlers; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import server.logic.ws_protocol.WireCodes; +import utils.blockchain.BchInfoEntry; +import utils.blockchain.BchInfoManager; + +import java.nio.ByteBuffer; +import java.nio.ByteOrder; +import java.util.Arrays; + +/** + * Возврат информации о последнем блоке цепочки (GET_LAST_BLOCK_INFO). + */ +public class GetLastBlockInfoHandler implements MessageHandler { + private static final Logger log = LoggerFactory.getLogger(GetLastBlockInfoHandler.class); + + @Override + public byte[] handle(byte[] msg) { + try { + if (msg.length < 12) + return intTo4Bytes(WireCodes.Status.BAD_REQUEST); + + long blockchainId = ByteBuffer.wrap(msg, 4, 8) + .order(ByteOrder.BIG_ENDIAN) + .getLong(); + + BchInfoManager mgr = BchInfoManager.getInstance(); + BchInfoEntry entry = mgr.getBchInfo(blockchainId); + if (entry == null) + return intTo4Bytes(WireCodes.Status.CHAIN_NOT_FOUND); + + int lastNum = entry.lastBlockNumber; + byte[] hash = hexToBytes(entry.lastBlockHash); + + ByteBuffer out = ByteBuffer.allocate(4 + 4 + 32).order(ByteOrder.BIG_ENDIAN); + out.putInt(WireCodes.Status.OK); + out.putInt(lastNum); + out.put(hash); + return out.array(); + + } catch (Exception e) { + log.error("GET_LAST_BLOCK_INFO: ошибка", e); + return intTo4Bytes(WireCodes.Status.INTERNAL_ERROR); + } + } + + private static byte[] intTo4Bytes(int code) { + return ByteBuffer.allocate(4).order(ByteOrder.BIG_ENDIAN).putInt(code).array(); + } + + private static byte[] hexToBytes(String hex) { + if (hex == null || hex.isEmpty()) return new byte[32]; + int len = hex.length(); + byte[] out = new byte[len / 2]; + for (int i = 0; i < len; i += 2) + out[i / 2] = (byte) Integer.parseInt(hex.substring(i, i + 2), 16); + if (out.length < 32) { // добиваем нулями + byte[] full = new byte[32]; + System.arraycopy(out, 0, full, 32 - out.length, out.length); + return full; + } + return Arrays.copyOf(out, 32); + } +} diff --git a/src/main/java/server/logic/ws_protocol/binary/handlers/MessageHandler.java b/src/main/java/server/logic/ws_protocol/binary/handlers/MessageHandler.java new file mode 100644 index 0000000..ba4fb05 --- /dev/null +++ b/src/main/java/server/logic/ws_protocol/binary/handlers/MessageHandler.java @@ -0,0 +1,11 @@ +package server.logic.ws_protocol.binary.handlers; + +/** + * Общий интерфейс для всех обработчиков входящих сообщений. + */ +public interface MessageHandler { + /** + * Обработать входящее сообщение и вернуть бинарный ответ. + */ + byte[] handle(byte[] msg); +} diff --git a/src/main/java/server/logic/ws_protocol/binary/handlers/PingHandler.java b/src/main/java/server/logic/ws_protocol/binary/handlers/PingHandler.java new file mode 100644 index 0000000..7227ee2 --- /dev/null +++ b/src/main/java/server/logic/ws_protocol/binary/handlers/PingHandler.java @@ -0,0 +1,16 @@ +package server.logic.ws_protocol.binary.handlers; + +import server.logic.ws_protocol.WireCodes; + +/** + * Обработчик команды PING. + * Возвращает просто статус PONG. + */ +public class PingHandler implements MessageHandler { + @Override + public byte[] handle(byte[] msg) { + return new byte[]{ + 0, 0, 0, (byte) WireCodes.Status.PONG // проще и быстрее, можно и через ByteBuffer + }; + } +} diff --git a/src/main/java/server/logic/ws_protocol/binary/handlers/SearchUsersHandler.java b/src/main/java/server/logic/ws_protocol/binary/handlers/SearchUsersHandler.java new file mode 100644 index 0000000..31b6ef2 --- /dev/null +++ b/src/main/java/server/logic/ws_protocol/binary/handlers/SearchUsersHandler.java @@ -0,0 +1,59 @@ +package server.logic.ws_protocol.binary.handlers; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import server.logic.ws_protocol.WireCodes; +import utils.search.UserSearchService; + +import java.nio.ByteBuffer; +import java.nio.ByteOrder; +import java.nio.charset.StandardCharsets; +import java.util.List; + +/** + * Поиск пользователей по логину (SEARCH_USERS). + */ +public class SearchUsersHandler implements MessageHandler { + private static final Logger log = LoggerFactory.getLogger(SearchUsersHandler.class); + + @Override + public byte[] handle(byte[] msg) { + try { + if (msg.length < 8) + return intTo4Bytes(WireCodes.Status.BAD_REQUEST); + + int N = ByteBuffer.wrap(msg, 4, 4).order(ByteOrder.BIG_ENDIAN).getInt(); + if (N < 0 || msg.length < 8 + N) + return intTo4Bytes(WireCodes.Status.BAD_REQUEST); + + String query = new String(msg, 8, N, StandardCharsets.UTF_8); + List found = UserSearchService.getInstance().searchFirst5(query); + return pack(found); + + } catch (Exception e) { + log.error("SEARCH_USERS: ошибка", e); + return intTo4Bytes(WireCodes.Status.INTERNAL_ERROR); + } + } + + private static byte[] pack(List pairs) { + if (pairs == null) pairs = List.of(); + int total = 8; + var chunks = new java.util.ArrayList(); + for (var p : pairs) { + byte[] packed = UserSearchService.packPair(p); + chunks.add(packed); + total += packed.length; + } + + ByteBuffer out = ByteBuffer.allocate(total).order(ByteOrder.BIG_ENDIAN); + out.putInt(WireCodes.Status.OK); + out.putInt(pairs.size()); + for (var c : chunks) out.put(c); + return out.array(); + } + + private static byte[] intTo4Bytes(int code) { + return ByteBuffer.allocate(4).order(ByteOrder.BIG_ENDIAN).putInt(code).array(); + } +} diff --git a/src/main/java/server/ws/BlockchainWsEndpoint.java b/src/main/java/server/ws/BlockchainWsEndpoint.java new file mode 100644 index 0000000..2d5ae65 --- /dev/null +++ b/src/main/java/server/ws/BlockchainWsEndpoint.java @@ -0,0 +1,141 @@ +package server.ws; + +import org.eclipse.jetty.websocket.api.Session; +import org.eclipse.jetty.websocket.api.WriteCallback; +import org.eclipse.jetty.websocket.api.annotations.*; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import server.logic.InboundMessageProcessor; +import server.logic.ws_protocol.JSON.ConnectionContext; +import server.logic.ws_protocol.JSON.JsonInboundProcessor; + +import java.nio.ByteBuffer; +import java.util.concurrent.CompletableFuture; + +@WebSocket +public class BlockchainWsEndpoint { + private static final Logger log = LoggerFactory.getLogger(BlockchainWsEndpoint.class); + + private Session session; + + /** Контекст для текущего WebSocket-соединения. */ + private final ConnectionContext connectionContext = new ConnectionContext(); + + @OnWebSocketConnect + public void onConnect(Session session) { + this.session = session; + log.info("WS connected: {}", session.getRemoteAddress()); + } + + @OnWebSocketMessage + public void onBinary(byte[] payload, int offset, int length) { + byte[] msg = new byte[length]; + System.arraycopy(payload, offset, msg, 0, length); + + // Асинхронно обрабатываем входящее бинарное сообщение + CompletableFuture + .supplyAsync(() -> InboundMessageProcessor.process(msg)) + .thenAccept(resp -> { + if (resp != null && session != null && session.isOpen()) { + session.getRemote().sendBytes(ByteBuffer.wrap(resp), new WriteCallback() { + @Override + public void writeFailed(Throwable x) { + log.warn("Failed to send response", x); + } + + @Override + public void writeSuccess() { + log.debug("Response sent successfully"); + } + }); + } + }) + .exceptionally(ex -> { + log.error("Processing failed", ex); + trySendCode(500); + return null; + }); + } + + private void trySendCode(int code) { + if (session != null && session.isOpen()) { + byte[] resp = InboundMessageProcessor.intTo4Bytes(code); + session.getRemote().sendBytes(ByteBuffer.wrap(resp), new WriteCallback() { + @Override + public void writeFailed(Throwable x) { + log.warn("Failed to send error code", x); + } + + @Override + public void writeSuccess() { + log.debug("Error code {} sent", code); + } + }); + } + } + + @OnWebSocketClose + public void onClose(int statusCode, String reason) { + log.info("WS closed: {} {}", statusCode, reason); + // На всякий случай очищаем контекст + connectionContext.reset(); + } + + @OnWebSocketError + public void onError(Throwable cause) { + log.error("WS error", cause); + } + + // Обработка текстовых JSON-запросов + @OnWebSocketMessage + public void onText(String message) { + log.info("📥 Получено TEXT-сообщение от клиента: {}", message); + + CompletableFuture + .supplyAsync(() -> JsonInboundProcessor.processJson(message, connectionContext)) + .thenAccept(respJson -> { + if (respJson != null && session != null && session.isOpen()) { + + log.info("📤 Отправляем ответ клиенту: {}", respJson); + + session.getRemote().sendString(respJson, new WriteCallback() { + @Override + public void writeFailed(Throwable x) { + log.warn("⚠️ Не удалось отправить JSON-ответ клиенту: {}", x.toString()); + } + + @Override + public void writeSuccess() { + log.debug("✔ JSON-ответ успешно отправлен"); + } + }); + } + }) + .exceptionally(ex -> { + log.error("❌ Ошибка при обработке JSON-сообщения", ex); + trySendJsonError(); + return null; + }); + } + + private void trySendJsonError() { + if (session != null && session.isOpen()) { + String resp = "{\"op\":null,\"requestId\":null,\"status\":500," + + "\"payload\":{\"code\":\"INTERNAL_ERROR\",\"message\":\"Ошибка сервера\"}}"; + + log.info("📤 Отправляем клиенту ошибку JSON: {}", resp); + + session.getRemote().sendString(resp, new WriteCallback() { + @Override + public void writeFailed(Throwable x) { + log.warn("⚠️ Не удалось отправить JSON-ответ клиенту: {}", x.toString()); + } + + @Override + public void writeSuccess() { + log.debug("✔ JSON-ошибка успешно отправлена"); + } + }); + } + } +} diff --git a/src/main/java/server/ws/README.md b/src/main/java/server/ws/README.md new file mode 100644 index 0000000..9d7a10e --- /dev/null +++ b/src/main/java/server/ws/README.md @@ -0,0 +1,85 @@ +# server.ws + +Пакет `server.ws` отвечает за сетевой уровень: WebSocket-сервер и обработку соединений. + +Он принимает бинарные сообщения от клиентов, передаёт их в логику сервера и отправляет бинарные ответы обратно. + +--- + +## Классы + +### 1. `BlockchainWsEndpoint` +WebSocket-эндпоинт для одного соединения. + +Роль: +- держит сессию с конкретным клиентом, +- принимает сообщения, +- вызывает бизнес-логику, +- отправляет ответ. + +Публичные методы (Jetty WebSocket lifecycle): + +- `onConnect(Session session)` + Вызывается Jetty при подключении клиента. + Сохраняет `session`, пишет лог. + +- `onBinary(byte[] payload, int offset, int length)` + Клиент прислал бинарные данные. + Логика: + 1. Копируем полезные байты. + 2. Передаём их в `InboundMessageProcessor.process(...)`. + 3. Асинхронно отправляем ответ обратно через `session.getRemote().sendBytes(...)`. + + Ответ сервера — это либо `[4]statusCode`, либо `[4]OK + ...payload...` (в зависимости от операции). + +- `onClose(int statusCode, String reason)` + Логируем закрытие сессии. + +- `onError(Throwable cause)` + Логируем ошибку. + +Внутренние (служебные): +- `trySendCode(int code)` — отправить просто код ошибки, если что-то пошло не так. + +Замечание: сам `BlockchainWsEndpoint` не знает протокола. Он просто прокидывает байты в `InboundMessageProcessor`. + +--- + +### 2. `WsServer` +Отдельный класс-ланчер. Поднимает Jetty WebSocket сервер. + +Роль: +- стартует HTTP-сервер Jetty на порту `8080`, +- вешает WebSocket endpoint `/ws`, +- задаёт таймаут бездействия. + +Публичный метод: +- `public static void main(String[] args)` + Запуск сервера. Делает: + - `new Server(8080)` + - создаёт `ServletContextHandler` + - через `JettyWebSocketServletContainerInitializer.configure(...)` регистрирует маппинг `/ws` → `BlockchainWsEndpoint` + - `server.start(); server.join();` + +После запуска сервер слушает `ws://localhost:8080/ws`. + +--- + +## Как это стыкуется с остальной системой + +1. Клиент открывает WebSocket на `/ws`. +2. Шлёт бинарный пакет: `[4 байта opCode][дальше payload]`. +3. `BlockchainWsEndpoint.onBinary()` → `InboundMessageProcessor.process(...)`. +4. `InboundMessageProcessor` разбирает команду: + - добавить блок + - выдать блокчейн + - поиск пользователей + - ping +5. Ответ упаковывается в бинарный формат и отправляется обратно через `BlockchainWsEndpoint`. + +--- + +## Кратко + +- `WsServer` = сервер, который слушает порт и вешает `/ws`. +- `BlockchainWsEndpoint` = обработчик одного WebSocket-подключения, мост между сетью и логикой. diff --git a/src/main/java/server/ws/WsServer.java b/src/main/java/server/ws/WsServer.java new file mode 100644 index 0000000..db22130 --- /dev/null +++ b/src/main/java/server/ws/WsServer.java @@ -0,0 +1,48 @@ +package server.ws; + +import org.eclipse.jetty.server.Server; +import org.eclipse.jetty.servlet.ServletContextHandler; +import org.eclipse.jetty.websocket.server.config.JettyWebSocketServletContainerInitializer; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import shine.db.dao.SolanaUsersDAO; +import shine.db.entities.SolanaUser; +import utils.config.AppConfig; + +import java.time.Duration; + +/** + * WsServer — поднимает Jetty WS на /ws (порт 8080). + */ +public final class WsServer { + private static final Logger log = LoggerFactory.getLogger(WsServer.class); + + public static void main(String[] args) throws Exception { + AppConfig config = AppConfig.getInstance(); + int port = 7070; + try { + port = Integer.parseInt(config.getParam("server.port"),7070); + } catch (Exception e) { + log.info("Установите параметр server.port в файле настроек"); + } + + Server server = new Server(port); + + ServletContextHandler context = new ServletContextHandler(); + context.setContextPath("/"); + server.setHandler(context); + + // Инициализация контейнера WebSocket + JettyWebSocketServletContainerInitializer.configure(context, (servletContext, wsContainer) -> { + // Таймаут простоя соединения (Jetty 11 синтаксис) + wsContainer.setIdleTimeout(Duration.ofMinutes(5)); + + // Маппинг эндпоинта + wsContainer.addMapping("/ws", (req, resp) -> new BlockchainWsEndpoint()); + }); + + server.start(); + log.info("✅ WS сервер запущен на ws://localhost:{}/ws", port); + server.join(); + } +} diff --git a/src/main/resources/application.properties b/src/main/resources/application.properties new file mode 100644 index 0000000..e969f67 --- /dev/null +++ b/src/main/resources/application.properties @@ -0,0 +1,5 @@ +server.1port=7070 + + +db.path=data/shine.sqlite + diff --git a/src/main/resources/logback.xml b/src/main/resources/logback.xml new file mode 100644 index 0000000..37579bd --- /dev/null +++ b/src/main/resources/logback.xml @@ -0,0 +1,33 @@ + + + + + + + + ${LOG_FILE} + + + + ${LOG_DIR}/app.%d{yyyy-MM-dd}.log + 14 + + + + %d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n + + + + + + %highlight(%-5level) %cyan(%logger{20}) - %msg%n + + + + + + + + + + diff --git a/src/test_ws.html b/src/test_ws.html new file mode 100644 index 0000000..80524b9 --- /dev/null +++ b/src/test_ws.html @@ -0,0 +1,145 @@ + + + + + Blockchain WS Test + + + + +

🔗 WebSocket Blockchain Test

+

URL: wss://shineup.me/ws

+ + + +

+ + +

+
+ + + +