From 94d4665185a163ebbfb3ad8d1d852f0f0c6766c4aa3c9633fc6399318184a21b Mon Sep 17 00:00:00 2001 From: AidarKC Date: Wed, 28 Oct 2026 12:19:19 +0300 Subject: [PATCH] =?UTF-8?q?=D0=98=D1=81=D0=BF=D1=80=D0=B0=D0=B2=D0=B8?= =?UTF-8?q?=D1=82=D1=8C=20=D1=80=D0=B5=D0=B3=D0=B8=D1=81=D1=82=D1=80=D0=B0?= =?UTF-8?q?=D1=86=D0=B8=D1=8E=20free-=D0=BF=D0=BE=D0=BB=D1=8C=D0=B7=D0=BE?= =?UTF-8?q?=D0=B2=D0=B0=D1=82=D0=B5=D0=BB=D0=B5=D0=B9=20=D0=B1=D0=B5=D0=B7?= =?UTF-8?q?=20=D1=83=D1=87=D1=91=D1=82=D0=B0=20=D1=80=D0=B5=D0=B3=D0=B8?= =?UTF-8?q?=D1=81=D1=82=D1=80=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit НЕ ПРОВЕРЕНО: учтены логины с большими и маленькими буквами. Добавлен временный devnet-смарт-контракт для очистки тестового аккаунта от старых логинов; после сброса его необходимо удалить и восстановить штатный контракт. --- .../archive/ArweaveBlockSyncService.java | 2 +- .../FreeRegistrationCertificateV1.java | 7 +- .../registration/FreeRegistrationIssuer.java | 2 +- .../FreeRegistrationWorkflow.java | 4 +- .../VerifiedFreeRegistrationImporter.java | 6 +- .../FreeRegistrationCertificateV1Check.java | 53 +++--- .../java/blockchain/ShineProtocolTags.java | 2 +- .../java/shine/db/DatabaseInitializer.java | 10 +- .../shine/db/dao/ConnectionsStateDAO.java | 4 +- .../java/shine/db/dao/SubscriptionsDAO.java | 2 +- .../main/resources/postgres/migration_v36.sql | 64 ++++++++ .../src/main/resources/postgres/schema_v1.sql | 28 ++-- .../shine-server-net-protocol/build.gradle | 1 + .../auth/SolanaUserPdaImportService.java | 54 ++----- .../main/java/sync/codec/ShineUsersCodec.java | 2 +- .../main/java/sync/util/SolanaPdaUtil.java | 4 +- .../java/sync/util/SolanaPdaUtilTest.java | 9 ++ .../src/main/resources/application.properties | 2 +- VERSION.properties | 4 +- deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md | 4 + docs/API/04_Add_Block_to_Blockchain_API.md | 4 +- docs/Blockchain/01_Common_Block_Format.md | 4 +- .../Blockchain/17_ANS104_Arweave_Transport.md | 10 +- docs/Blockchain/CASE_INSENSITIVE_LOGIN.md | 9 ++ docs/Blockchain/CHANGELOG.md | 9 ++ .../CODEX_APPLY_ANS104_TEST5590_PATCH.md | 2 +- docs/Blockchain/README.md | 8 +- docs/Blockchain/sync-between-servers.md | 2 +- .../Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md | 4 + .../MASTER_PLAN_V2_2026-10-23.md | 2 +- docs/registration-v2/PATCH_STAGES_8_9_10.md | 2 +- .../SHINE_FREE_REGISTRATION_CERTIFICATE_V1.md | 10 +- shine-UI/js/services/protocol-tags.js | 2 +- .../js/services/shine-namespace-service.js | 4 +- .../static-sites/arweave-viewer/README.md | 4 +- .../static-sites/arweave-viewer/index.html | 2 +- shine-UI/tests/arweave-app-namespace.test.mjs | 19 +++ ...gistration-case-social-projection.test.mjs | 11 ++ .../tests/registration-namespace-v2.test.mjs | 11 +- .../formats/shine-user-pda-format-v.1.2.md | 4 + .../shine/doc/programs/shine_users.md | 10 +- .../shine/programs/shine_users/src/lib.rs | 4 +- .../tools/temporary-pda-cleaner/.gitignore | 7 + .../tools/temporary-pda-cleaner/Cargo.toml | 19 +++ .../DELETE_AFTER_DEVNET_RESET.md | 15 ++ .../temporary-pda-cleaner/README_AGENT_RU.md | 151 ++++++++++++++++++ .../temporary-pda-cleaner/scripts/cleaner.mjs | 118 ++++++++++++++ .../scripts/package.json | 14 ++ .../tools/temporary-pda-cleaner/src/lib.rs | 91 +++++++++++ 49 files changed, 687 insertions(+), 129 deletions(-) create mode 100644 SHiNE-server/shine-server-db/src/main/resources/postgres/migration_v36.sql create mode 100644 docs/Blockchain/CASE_INSENSITIVE_LOGIN.md create mode 100644 shine-UI/tests/arweave-app-namespace.test.mjs create mode 100644 shine-UI/tests/registration-case-social-projection.test.mjs create mode 100644 shine-solana/shine/tools/temporary-pda-cleaner/.gitignore create mode 100644 shine-solana/shine/tools/temporary-pda-cleaner/Cargo.toml create mode 100644 shine-solana/shine/tools/temporary-pda-cleaner/DELETE_AFTER_DEVNET_RESET.md create mode 100644 shine-solana/shine/tools/temporary-pda-cleaner/README_AGENT_RU.md create mode 100644 shine-solana/shine/tools/temporary-pda-cleaner/scripts/cleaner.mjs create mode 100644 shine-solana/shine/tools/temporary-pda-cleaner/scripts/package.json create mode 100644 shine-solana/shine/tools/temporary-pda-cleaner/src/lib.rs diff --git a/SHiNE-server/shine-server-archive/src/main/java/server/archive/ArweaveBlockSyncService.java b/SHiNE-server/shine-server-archive/src/main/java/server/archive/ArweaveBlockSyncService.java index f2e869a1..c3a297a5 100644 --- a/SHiNE-server/shine-server-archive/src/main/java/server/archive/ArweaveBlockSyncService.java +++ b/SHiNE-server/shine-server-archive/src/main/java/server/archive/ArweaveBlockSyncService.java @@ -37,7 +37,7 @@ import java.time.Duration; import java.util.*; /** - * Discovers individual App=test5591 DataItems and imports the exact signed ANS-104 bytes. + * Discovers individual App=test5592 DataItems and imports the exact signed ANS-104 bytes. * The importer is transport-agnostic: a DataItem may have reached Arweave through Turbo * or inside a direct server-created ANS-104 bundle. */ diff --git a/SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/FreeRegistrationCertificateV1.java b/SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/FreeRegistrationCertificateV1.java index 31587542..270f5d7e 100644 --- a/SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/FreeRegistrationCertificateV1.java +++ b/SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/FreeRegistrationCertificateV1.java @@ -1,6 +1,7 @@ package server.archive.registration; import blockchain.Ans104DataItem; +import blockchain.ShineProtocolTags; import utils.crypto.Ed25519Util; import java.io.ByteArrayOutputStream; @@ -16,7 +17,7 @@ import java.util.Locale; public final class FreeRegistrationCertificateV1 { private static final byte[] DOMAIN = "SHiNE_FREE_REG_V1\0".getBytes(StandardCharsets.UTF_8); private static final List TAGS = List.of( - new Ans104DataItem.Tag("App", "test5591"), + new Ans104DataItem.Tag(ShineProtocolTags.APP_TAG_NAME, ShineProtocolTags.APP_TAG_VALUE), new Ans104DataItem.Tag("t", "reg"), new Ans104DataItem.Tag("Protocol", "SHiNE-Free-Registration-V1")); @@ -27,8 +28,8 @@ public final class FreeRegistrationCertificateV1 { private FreeRegistrationCertificateV1() {} public static String validateLogin(String login) { - if (login == null || !login.matches("[a-z0-9_]+@[a-z0-9_]+") || login.length() > 30) - throw new IllegalArgumentException("Full login must be lowercase ASCII, <= 30 bytes"); + if (login == null || !login.matches("[A-Za-z0-9_]+@[a-z0-9_]+") || login.length() > 30) + throw new IllegalArgumentException("Full login must use ASCII letters (any local-part case), lowercase namespace, <= 30 bytes"); return login; } diff --git a/SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/FreeRegistrationIssuer.java b/SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/FreeRegistrationIssuer.java index 9dd2a56f..29518583 100644 --- a/SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/FreeRegistrationIssuer.java +++ b/SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/FreeRegistrationIssuer.java @@ -47,7 +47,7 @@ public final class FreeRegistrationIssuer { } try (PreparedStatement ps = conn.prepareStatement( "SELECT 1 FROM user_identity_current WHERE normalized_login = ?")) { - ps.setString(1, fullLogin); + ps.setString(1, fullLogin.toLowerCase(java.util.Locale.ROOT)); try (ResultSet rs = ps.executeQuery()) { if (rs.next()) throw new IllegalArgumentException("Login is already registered"); } diff --git a/SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/FreeRegistrationWorkflow.java b/SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/FreeRegistrationWorkflow.java index c39ac9ea..59a96e0c 100644 --- a/SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/FreeRegistrationWorkflow.java +++ b/SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/FreeRegistrationWorkflow.java @@ -65,7 +65,7 @@ public final class FreeRegistrationWorkflow { } } try (PreparedStatement p=c.prepareStatement("SELECT 1 FROM user_identity_current WHERE normalized_login=?")) { - p.setString(1, login); + p.setString(1, login.toLowerCase(java.util.Locale.ROOT)); try (ResultSet rs=p.executeQuery()) { return new LoginCheck(!rs.next(),type,minimum,fee); } } } @@ -126,7 +126,7 @@ public final class FreeRegistrationWorkflow { LEFT JOIN shine_namespace_current n ON n.namespace=i.namespace WHERE i.normalized_login=? """)) { - p.setString(1,login); + p.setString(1,login.toLowerCase(java.util.Locale.ROOT)); try (ResultSet r=p.executeQuery()) { return r.next()?new State(r.getString(1),r.getString(2),r.getString(3), r.getBytes(4)==null?null:Base64.getEncoder().encodeToString(r.getBytes(4)), diff --git a/SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/VerifiedFreeRegistrationImporter.java b/SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/VerifiedFreeRegistrationImporter.java index 4d6e5152..370226aa 100644 --- a/SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/VerifiedFreeRegistrationImporter.java +++ b/SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/VerifiedFreeRegistrationImporter.java @@ -25,7 +25,7 @@ public final class VerifiedFreeRegistrationImporter { var cert = FreeRegistrationCertificateV1.verify(raw, readRegistrar(c, namespace, login)); try (PreparedStatement ps = c.prepareStatement( "SELECT free_data_item_id FROM user_identity_current WHERE normalized_login=?")) { - ps.setString(1, login); + ps.setString(1, login.toLowerCase(java.util.Locale.ROOT)); try (ResultSet rs = ps.executeQuery()) { if (rs.next() && !cert.idBase64Url().equals(rs.getString(1))) throw new IllegalArgumentException("Login is already registered"); @@ -96,11 +96,11 @@ public final class VerifiedFreeRegistrationImporter { blockchain_name, is_server, registered_at_ms, updated_at_ms) VALUES (?, ?, ?, 'ARWEAVE', 'FREE_CERT', NULL, ?, ?, ?, ?, ?, false, ?, ?) """)) { - insert.setString(1, login); insert.setString(2, login); insert.setString(3, namespace); + insert.setString(1, login); insert.setString(2, login.toLowerCase(java.util.Locale.ROOT)); insert.setString(3, namespace); insert.setString(4, id); insert.setString(5, Base58Util.encode(cert.rootKey())); insert.setString(6, Base58Util.encode(cert.clientKey())); insert.setString(7, Base58Util.encode(cert.blockchainKey())); - insert.setString(8, login + "-001"); insert.setLong(9, now); insert.setLong(10, now); + insert.setString(8, login.toLowerCase(java.util.Locale.ROOT) + "-001"); insert.setLong(9, now); insert.setLong(10, now); insert.executeUpdate(); } try (PreparedStatement insert = c.prepareStatement(""" diff --git a/SHiNE-server/shine-server-archive/src/test/java/server/archive/FreeRegistrationCertificateV1Check.java b/SHiNE-server/shine-server-archive/src/test/java/server/archive/FreeRegistrationCertificateV1Check.java index ddc3afed..96247162 100644 --- a/SHiNE-server/shine-server-archive/src/test/java/server/archive/FreeRegistrationCertificateV1Check.java +++ b/SHiNE-server/shine-server-archive/src/test/java/server/archive/FreeRegistrationCertificateV1Check.java @@ -1,42 +1,43 @@ package server.archive; import server.archive.registration.*; +import blockchain.Ans104DataItem; +import blockchain.ShineProtocolTags; import utils.crypto.Ed25519Util; -import java.nio.file.Files; -import java.nio.file.Path; import java.util.Arrays; import java.util.HexFormat; -/** Запуск: java ... server.archive.FreeRegistrationCertificateV1Check file.hex */ +/** Standalone test (no legacy signed fixture): certificate issue/verify for CURRENT App tag. */ public final class FreeRegistrationCertificateV1Check { static final HexFormat HEX = HexFormat.of(); public static void main(String[] args) throws Exception { - byte[] raw = HEX.parseHex(Files.readString(Path.of(args[0])).trim()); - byte[] pub = HEX.parseHex("174553b456dddfc6908ecab1c101fe6ab21e2baa0617795b7d43a63482993fd5"); - var result = FreeRegistrationCertificateV1.verify(raw, pub); - if (!"bob@free".equals(result.login()) || !result.idBase64Url().equals( - java.util.Base64.getUrlEncoder().withoutPadding().encodeToString( - HEX.parseHex("45ef42eda7c7e76d222ecce8a7678edb923ae63f8419ea0899701551c2466770")))) - throw new AssertionError("Wrong fixture identity / DataItem id"); - byte[] corrupted = raw.clone(); corrupted[corrupted.length-1] ^= 1; - try { FreeRegistrationCertificateV1.verify(corrupted, pub); throw new AssertionError("Email bit flip accepted"); } - catch (IllegalArgumentException expected) {} - corrupted = raw.clone(); corrupted[corrupted.length-40] ^= 1; - try { FreeRegistrationCertificateV1.verify(corrupted, pub); throw new AssertionError("Inner signature tampering accepted"); } - catch (IllegalArgumentException expected) {} - byte[] seed = Ed25519Util.generatePrivateKeyFromString("TEST-only-reg-v1-check"); + byte[] root = HEX.parseHex("03a107bff3ce10be1d70dd18e74bc09967e4d6309ba50d5f1ddc8664125531b8"); + byte[] chain = HEX.parseHex("29acbae141bccaf0b22e1a94d34d0bc7361e526d0bfe12c89794bc9322966dd7"); + byte[] client = HEX.parseHex("2543b92ff1095511476adc8369db6ddc933665a11978dda1404ee1066ca9559d"); try (var signer = new LocalRegistrarSigner(seed)) { - byte[] cert = FreeRegistrationCertificateV1.issue("bob@free", - HEX.parseHex("03a107bff3ce10be1d70dd18e74bc09967e4d6309ba50d5f1ddc8664125531b8"), - HEX.parseHex("29acbae141bccaf0b22e1a94d34d0bc7361e526d0bfe12c89794bc9322966dd7"), - HEX.parseHex("2543b92ff1095511476adc8369db6ddc933665a11978dda1404ee1066ca9559d"), - " Alice.Example+Tag@Example.COM ", signer); - var verified = FreeRegistrationCertificateV1.verify(cert, signer.publicKey32()); - if (!Arrays.equals(verified.emailSha256(), - HEX.parseHex("cbc605c49fd774ff4d9ea789d8f6bffa719e9774cb86f62d11fd244121150956"))) + byte[] cert = FreeRegistrationCertificateV1.issue("SuperMan@free", root, chain, client, + " Alice.Example+Tag@Example.COM ", signer); + var item = new Ans104DataItem(cert); + if (!item.hasTag(ShineProtocolTags.APP_TAG_NAME, ShineProtocolTags.APP_TAG_VALUE)) + throw new AssertionError("Current App tag missing"); + var result = FreeRegistrationCertificateV1.verify(cert, signer.publicKey32()); + if (!"SuperMan@free".equals(result.login()) || !Arrays.equals(result.rootKey(), root) + || !Arrays.equals(result.blockchainKey(), chain) || !Arrays.equals(result.clientKey(), client)) + throw new AssertionError("Certificate identity corrupted"); + if (!Arrays.equals(result.emailSha256(), HEX.parseHex( + "cbc605c49fd774ff4d9ea789d8f6bffa719e9774cb86f62d11fd244121150956"))) throw new AssertionError("Email normalization differs"); + byte[] bad = cert.clone(); bad[bad.length - 1] ^= 1; + try { FreeRegistrationCertificateV1.verify(bad, signer.publicKey32()); + throw new AssertionError("Email bit flip accepted"); } + catch (IllegalArgumentException expected) {} + bad = cert.clone(); bad[bad.length - 40] ^= 1; + try { FreeRegistrationCertificateV1.verify(bad, signer.publicKey32()); + throw new AssertionError("Inner signature tampering accepted"); } + catch (IllegalArgumentException expected) {} } - System.out.println("PASS: Java registrar fixture, inner+outer Ed25519, email normalization, tamper rejection"); + System.out.println("PASS: current App=" + ShineProtocolTags.APP_TAG_VALUE + + ", Java registrar inner+outer Ed25519, original case, email, tamper rejection"); } } diff --git a/SHiNE-server/shine-server-blockchain/src/main/java/blockchain/ShineProtocolTags.java b/SHiNE-server/shine-server-blockchain/src/main/java/blockchain/ShineProtocolTags.java index 1cf59970..d86da821 100644 --- a/SHiNE-server/shine-server-blockchain/src/main/java/blockchain/ShineProtocolTags.java +++ b/SHiNE-server/shine-server-blockchain/src/main/java/blockchain/ShineProtocolTags.java @@ -9,7 +9,7 @@ package blockchain; public final class ShineProtocolTags { private ShineProtocolTags() {} - public static final String NAMESPACE = "test5591"; + public static final String NAMESPACE = "test5592"; public static final String APP_TAG_NAME = "App"; public static final String APP_TAG_VALUE = NAMESPACE; public static final String CHANNEL_TAG_NAME = "c"; diff --git a/SHiNE-server/shine-server-db/src/main/java/shine/db/DatabaseInitializer.java b/SHiNE-server/shine-server-db/src/main/java/shine/db/DatabaseInitializer.java index 5fbfc212..e71cb83c 100644 --- a/SHiNE-server/shine-server-db/src/main/java/shine/db/DatabaseInitializer.java +++ b/SHiNE-server/shine-server-db/src/main/java/shine/db/DatabaseInitializer.java @@ -26,12 +26,14 @@ public final class DatabaseInitializer { public static final int SCHEMA_VERSION_33 = 33; public static final int SCHEMA_VERSION_34 = 34; public static final int SCHEMA_VERSION_35 = 35; + public static final int SCHEMA_VERSION_36 = 36; public static final String POSTGRES_SCHEMA_RESOURCE = "postgres/schema_v1.sql"; public static final String POSTGRES_MIGRATION_V31_RESOURCE = "postgres/migration_v31.sql"; public static final String POSTGRES_MIGRATION_V32_RESOURCE = "postgres/migration_v32.sql"; public static final String POSTGRES_MIGRATION_V33_RESOURCE = "postgres/migration_v33.sql"; public static final String POSTGRES_MIGRATION_V34_RESOURCE = "postgres/migration_v34.sql"; public static final String POSTGRES_MIGRATION_V35_RESOURCE = "postgres/migration_v35.sql"; + public static final String POSTGRES_MIGRATION_V36_RESOURCE = "postgres/migration_v36.sql"; private DatabaseInitializer() {} @@ -143,9 +145,13 @@ public final class DatabaseInitializer { runSqlScript(conn, POSTGRES_MIGRATION_V35_RESOURCE); currentVersion = readCurrentSchemaVersion(conn); } - if (currentVersion != SCHEMA_VERSION_35) { + if (currentVersion == SCHEMA_VERSION_35) { + runSqlScript(conn, POSTGRES_MIGRATION_V36_RESOURCE); + currentVersion = readCurrentSchemaVersion(conn); + } + if (currentVersion != SCHEMA_VERSION_36) { throw new SQLException( - "Unsupported SHiNE DB v2 schema version: expected 35, found " + currentVersion); + "Unsupported SHiNE DB v2 schema version: expected 36, found " + currentVersion); } } } diff --git a/SHiNE-server/shine-server-db/src/main/java/shine/db/dao/ConnectionsStateDAO.java b/SHiNE-server/shine-server-db/src/main/java/shine/db/dao/ConnectionsStateDAO.java index 3f980b4f..3f37a2ba 100644 --- a/SHiNE-server/shine-server-db/src/main/java/shine/db/dao/ConnectionsStateDAO.java +++ b/SHiNE-server/shine-server-db/src/main/java/shine/db/dao/ConnectionsStateDAO.java @@ -164,9 +164,9 @@ public final class ConnectionsStateDAO { """; try (PreparedStatement ps = c.prepareStatement(sql)) { - ps.setString(1, login); + ps.setString(1, login.trim().toLowerCase(java.util.Locale.ROOT)); ps.setInt(2, relType); - ps.setString(3, toLogin); + ps.setString(3, toLogin.trim().toLowerCase(java.util.Locale.ROOT)); if (toBlockNumber == null) ps.setNull(4, java.sql.Types.INTEGER); else ps.setInt(4, toBlockNumber); ps.setBytes(5, toBlockHash); ps.executeUpdate(); diff --git a/SHiNE-server/shine-server-db/src/main/java/shine/db/dao/SubscriptionsDAO.java b/SHiNE-server/shine-server-db/src/main/java/shine/db/dao/SubscriptionsDAO.java index d050a27a..bdd89051 100644 --- a/SHiNE-server/shine-server-db/src/main/java/shine/db/dao/SubscriptionsDAO.java +++ b/SHiNE-server/shine-server-db/src/main/java/shine/db/dao/SubscriptionsDAO.java @@ -111,7 +111,7 @@ public final class SubscriptionsDAO { FROM connections_state cs JOIN channel_names_state cn ON LOWER(cn.owner_login)=LOWER(cs.to_login) AND cn.channel_root_block_number=cs.to_block_number AND cn.channel_root_block_hash=cs.to_block_hash - WHERE cs.login = ? AND cs.rel_type = ? + WHERE LOWER(cs.login) = LOWER(?) AND cs.rel_type = ? UNION diff --git a/SHiNE-server/shine-server-db/src/main/resources/postgres/migration_v36.sql b/SHiNE-server/shine-server-db/src/main/resources/postgres/migration_v36.sql new file mode 100644 index 00000000..a0dc99af --- /dev/null +++ b/SHiNE-server/shine-server-db/src/main/resources/postgres/migration_v36.sql @@ -0,0 +1,64 @@ +-- v36: регистрационная запись хранит исходный регистр; все ссылки FK +-- приводятся к её точному login. Исторические строки не мигрируются. +-- На новой базе исходные имена PDA/сертификатов и FK согласованы. +BEGIN; + +CREATE OR REPLACE FUNCTION shine_canonicalize_identity_fk_login() +RETURNS TRIGGER LANGUAGE plpgsql AS $$ +DECLARE + field_name TEXT := TG_ARGV[0]; + requested_login TEXT; + canonical_login TEXT; +BEGIN + requested_login := to_jsonb(NEW)->>field_name; + IF requested_login IS NULL OR btrim(requested_login) = '' THEN + RETURN NEW; + END IF; + SELECT i.login INTO canonical_login + FROM user_identity_current i + WHERE i.normalized_login = lower(btrim(requested_login)) + LIMIT 1; + IF canonical_login IS NOT NULL THEN + -- Меняем только проекцию/связь в SQL, никогда не байты подписанного блока. + NEW := jsonb_populate_record(NEW, jsonb_build_object(field_name, canonical_login)); + END IF; + RETURN NEW; +END $$; + +DO $$ +DECLARE + tab_name TEXT; + col_name TEXT; + spec TEXT; + trigger_name TEXT; +BEGIN + FOREACH spec IN ARRAY ARRAY[ + 'user_access_servers_current:user_login', + 'user_access_servers_current:server_login', + 'active_sessions:login', + 'esp_pairing_settings:login', + 'esp_pairing_requests:login', + 'users_params:login', + 'user_settings:login', + 'channel_read_state:viewer_login', + 'test_free_avatar_uploads:login', + 'blockchain_state:login', + 'user_stats_state:login', + 'user_push_tokens:login', + 'key_rotation_sessions:login' + ] LOOP + tab_name := split_part(spec, ':', 1); + col_name := split_part(spec, ':', 2); + trigger_name := 'trg_canonical_identity_' || tab_name || '_' || col_name; + EXECUTE format('DROP TRIGGER IF EXISTS %I ON %I', trigger_name, tab_name); + EXECUTE format( + 'CREATE TRIGGER %I BEFORE INSERT OR UPDATE OF %I ON %I FOR EACH ROW EXECUTE FUNCTION shine_canonicalize_identity_fk_login(%L)', + trigger_name, col_name, tab_name, col_name + ); + END LOOP; +END $$; + +UPDATE db_schema_version SET schema_version = 36, + updated_at_ms = CAST(EXTRACT(EPOCH FROM clock_timestamp()) * 1000 AS BIGINT) +WHERE id = 1; +COMMIT; diff --git a/SHiNE-server/shine-server-db/src/main/resources/postgres/schema_v1.sql b/SHiNE-server/shine-server-db/src/main/resources/postgres/schema_v1.sql index babd8b39..5116675c 100644 --- a/SHiNE-server/shine-server-db/src/main/resources/postgres/schema_v1.sql +++ b/SHiNE-server/shine-server-db/src/main/resources/postgres/schema_v1.sql @@ -2334,11 +2334,15 @@ CREATE INDEX idx_message_views_target_v29 ON message_views_state(to_login,to_blo CREATE OR REPLACE FUNCTION shine_refresh_user_stats(p_login TEXT) RETURNS VOID LANGUAGE plpgsql AS $$ DECLARE v_now BIGINT:=CAST(EXTRACT(EPOCH FROM clock_timestamp())*1000 AS BIGINT); + v_canonical_login TEXT; BEGIN IF p_login IS NULL OR btrim(p_login)='' THEN RETURN; END IF; + -- В FK остаётся исходный регистр владельца, но поиск/сопоставления регистронезависимы. + SELECT login INTO v_canonical_login FROM user_identity_current WHERE normalized_login=lower(btrim(p_login)) LIMIT 1; + IF v_canonical_login IS NULL THEN RETURN; END IF; INSERT INTO user_stats_state(login,owned_public_channels_count,following_users_count,following_channels_count,close_friends_count,friends_count, primary_confirmations_received_count,primary_confirmations_given_count,shine_confirmations_received_count,shine_confirmations_given_count,updated_at_ms) - SELECT p_login, + SELECT v_canonical_login, (SELECT COUNT(*)::INT FROM channel_names_state cn WHERE LOWER(cn.owner_login)=LOWER(p_login) AND cn.channel_type_code=1 AND NOT cn.is_deleted), (SELECT COUNT(DISTINCT LOWER(cs.to_login))::INT FROM connections_state cs WHERE LOWER(cs.login)=LOWER(p_login) AND cs.rel_type=30 AND cs.to_block_number=0), (SELECT COUNT(*)::INT FROM connections_state cs JOIN channel_names_state cn ON LOWER(cn.owner_login)=LOWER(cs.to_login) AND cn.channel_root_block_number=cs.to_block_number AND cn.channel_root_block_hash=cs.to_block_hash WHERE LOWER(cs.login)=LOWER(p_login) AND cs.rel_type=30 AND cn.channel_type_code=1 AND NOT cn.is_deleted), @@ -2485,15 +2489,15 @@ DECLARE positive_rel_type INTEGER; channel_bch TEXT; BEGIN IF NEW.msg_type<>3 OR NEW.to_login IS NULL OR NEW.to_block_number IS NULL OR NEW.to_block_hash IS NULL THEN RETURN NEW; END IF; IF NEW.msg_sub_type IN (10,14,20,30,40,50,52,54,60,70,74,80) THEN - DELETE FROM connections_state WHERE login=NEW.login AND rel_type=NEW.msg_sub_type AND to_login=NEW.to_login AND to_block_number=NEW.to_block_number AND to_block_hash=NEW.to_block_hash; + DELETE FROM connections_state WHERE login=lower(NEW.login) AND rel_type=NEW.msg_sub_type AND to_login=lower(NEW.to_login) AND to_block_number=NEW.to_block_number AND to_block_hash=NEW.to_block_hash; INSERT INTO connections_state(login,rel_type,to_login,to_block_number,to_block_hash) - VALUES(NEW.login,NEW.msg_sub_type,NEW.to_login,NEW.to_block_number,NEW.to_block_hash); + VALUES(lower(NEW.login),NEW.msg_sub_type,lower(NEW.to_login),NEW.to_block_number,NEW.to_block_hash); ELSE positive_rel_type := CASE NEW.msg_sub_type WHEN 11 THEN 10 WHEN 15 THEN 14 WHEN 21 THEN 20 WHEN 31 THEN 30 WHEN 41 THEN 40 WHEN 51 THEN 50 WHEN 53 THEN 52 WHEN 55 THEN 54 WHEN 61 THEN 60 WHEN 71 THEN 70 WHEN 75 THEN 74 WHEN 81 THEN 80 ELSE NULL END; - IF positive_rel_type IS NOT NULL THEN DELETE FROM connections_state WHERE login=NEW.login AND rel_type=positive_rel_type AND to_login=NEW.to_login AND to_block_number=NEW.to_block_number AND to_block_hash=NEW.to_block_hash; END IF; + IF positive_rel_type IS NOT NULL THEN DELETE FROM connections_state WHERE login=lower(NEW.login) AND rel_type=positive_rel_type AND to_login=lower(NEW.to_login) AND to_block_number=NEW.to_block_number AND to_block_hash=NEW.to_block_hash; END IF; END IF; - PERFORM shine_refresh_user_stats(NEW.login); - PERFORM shine_refresh_user_stats(NEW.to_login); + PERFORM shine_refresh_user_stats(lower(NEW.login)); + PERFORM shine_refresh_user_stats(lower(NEW.to_login)); IF NEW.msg_sub_type IN (30,31) AND NEW.to_block_number>0 THEN SELECT owner_bch_name INTO channel_bch FROM channel_names_state WHERE LOWER(owner_login)=LOWER(NEW.to_login) AND channel_root_block_number=NEW.to_block_number AND channel_root_block_hash=NEW.to_block_hash LIMIT 1; IF channel_bch IS NOT NULL THEN PERFORM shine_refresh_channel_follow_stats(channel_bch,NEW.to_block_number,NEW.to_block_hash); END IF; @@ -2506,22 +2510,22 @@ DECLARE previous_sub_type INTEGER; BEGIN IF NEW.msg_type<>2 OR NEW.msg_sub_type NOT IN (1,2) THEN RETURN NEW; END IF; IF NEW.to_login IS NULL OR NEW.to_block_number IS NULL OR NEW.to_block_hash IS NULL THEN RETURN NEW; END IF; - INSERT INTO message_stats(to_login,to_block_number,to_block_hash) VALUES(NEW.to_login,NEW.to_block_number,NEW.to_block_hash) + INSERT INTO message_stats(to_login,to_block_number,to_block_hash) VALUES(lower(NEW.to_login),NEW.to_block_number,NEW.to_block_hash) ON CONFLICT(to_login,to_block_number,to_block_hash) DO NOTHING; - SELECT last_sub_type INTO previous_sub_type FROM reactions_state WHERE from_login=NEW.login AND reaction_type=1 AND to_login=NEW.to_login AND to_block_number=NEW.to_block_number AND to_block_hash=NEW.to_block_hash LIMIT 1; + SELECT last_sub_type INTO previous_sub_type FROM reactions_state WHERE from_login=lower(NEW.login) AND reaction_type=1 AND to_login=lower(NEW.to_login) AND to_block_number=NEW.to_block_number AND to_block_hash=NEW.to_block_hash LIMIT 1; IF NEW.msg_sub_type=1 AND previous_sub_type IS DISTINCT FROM 1 THEN UPDATE message_stats SET likes_count=likes_count+1, primary_likes_count=primary_likes_count+CASE WHEN shine_is_primary(NEW.login) THEN 1 ELSE 0 END, shining_likes_count=shining_likes_count+CASE WHEN shine_is_primary(NEW.login) AND shine_is_shining(NEW.login) THEN 1 ELSE 0 END - WHERE to_login=NEW.to_login AND to_block_number=NEW.to_block_number AND to_block_hash=NEW.to_block_hash; + WHERE to_login=lower(NEW.to_login) AND to_block_number=NEW.to_block_number AND to_block_hash=NEW.to_block_hash; ELSIF NEW.msg_sub_type=2 AND previous_sub_type=1 THEN UPDATE message_stats SET likes_count=GREATEST(0,likes_count-1), primary_likes_count=GREATEST(0,primary_likes_count-CASE WHEN shine_is_primary(NEW.login) THEN 1 ELSE 0 END), shining_likes_count=GREATEST(0,shining_likes_count-CASE WHEN shine_is_primary(NEW.login) AND shine_is_shining(NEW.login) THEN 1 ELSE 0 END) - WHERE to_login=NEW.to_login AND to_block_number=NEW.to_block_number AND to_block_hash=NEW.to_block_hash; + WHERE to_login=lower(NEW.to_login) AND to_block_number=NEW.to_block_number AND to_block_hash=NEW.to_block_hash; END IF; INSERT INTO reactions_state(from_login,reaction_type,to_login,to_block_number,to_block_hash,last_sub_type) - VALUES(NEW.login,1,NEW.to_login,NEW.to_block_number,NEW.to_block_hash,NEW.msg_sub_type) + VALUES(lower(NEW.login),1,lower(NEW.to_login),NEW.to_block_number,NEW.to_block_hash,NEW.msg_sub_type) ON CONFLICT(from_login,reaction_type,to_login,to_block_number,to_block_hash) DO UPDATE SET last_sub_type=EXCLUDED.last_sub_type; RETURN NEW; END $$; @@ -2532,7 +2536,7 @@ BEGIN IF NEW.msg_type<>1 OR NEW.msg_sub_type<>20 THEN RETURN NEW; END IF; IF NEW.to_login IS NULL OR NEW.to_block_number IS NULL OR NEW.to_block_hash IS NULL THEN RETURN NEW; END IF; INSERT INTO message_stats(to_login,to_block_number,to_block_hash,replies_count) - VALUES(NEW.to_login,NEW.to_block_number,NEW.to_block_hash,1) + VALUES(lower(NEW.to_login),NEW.to_block_number,NEW.to_block_hash,1) ON CONFLICT(to_login,to_block_number,to_block_hash) DO UPDATE SET replies_count=message_stats.replies_count+1; RETURN NEW; END $$; diff --git a/SHiNE-server/shine-server-net-protocol/build.gradle b/SHiNE-server/shine-server-net-protocol/build.gradle index 838da9b3..fcf8ac7b 100644 --- a/SHiNE-server/shine-server-net-protocol/build.gradle +++ b/SHiNE-server/shine-server-net-protocol/build.gradle @@ -30,6 +30,7 @@ dependencies { implementation project(':shine-server-crypto') // модуль сервера для работы с криптографией implementation project(':shine-server-blockchain') // модуль для работы с блокчейном + implementation project(':shine-server-solana-users-sync') // Нормализованный адрес PDA implementation project(':shine-server-db') // модуль для работы с БД содержит и сущности из БД и саму работу с БД implementation project(':shine-server-geo') // модуль для определения геолокации по IP diff --git a/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/SolanaUserPdaImportService.java b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/SolanaUserPdaImportService.java index 843b6136..f08044d2 100644 --- a/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/SolanaUserPdaImportService.java +++ b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/SolanaUserPdaImportService.java @@ -108,54 +108,34 @@ public final class SolanaUserPdaImportService { } private static byte[] fetchRawUserPda(String login) throws Exception { - String loginB58 = toBase58(login.getBytes(StandardCharsets.UTF_8)); - String lenB58 = toBase58(new byte[]{(byte) login.length()}); - - String reqJson = """ - { - "jsonrpc":"2.0", - "id":1, - "method":"getProgramAccounts", - "params":[ - "%s", - { - "encoding":"base64", - "filters":[ - {"memcmp":{"offset":61,"bytes":"%s"}}, - {"memcmp":{"offset":62,"bytes":"%s"}} - ] - } - ] - } - """.formatted(SolanaProgramsConfig.SHINE_USERS_PROGRAM_ID, lenB58, loginB58); - + // Запись хранит исходный регистр, но адрес PDA зависит только от lowercase. + String address = sync.util.SolanaPdaUtil.findUserPdaV2(login, SolanaProgramsConfig.SHINE_USERS_PROGRAM_ID); + String reqJson = MAPPER.writeValueAsString(Map.of( + "jsonrpc", "2.0", "id", 1, + "method", "getAccountInfo", + "params", List.of(address, Map.of("encoding", "base64", "commitment", "confirmed")))); HttpRequest req = HttpRequest.newBuilder() .uri(URI.create(SolanaProgramsConfig.SOLANA_RPC_URL)) .header("Content-Type", "application/json") .POST(HttpRequest.BodyPublishers.ofString(reqJson)) .build(); - HttpResponse resp = HTTP.send(req, HttpResponse.BodyHandlers.ofString(StandardCharsets.UTF_8)); if (resp.statusCode() < 200 || resp.statusCode() >= 300) { throw new IllegalStateException("Solana RPC HTTP status=" + resp.statusCode()); } - JsonNode root = MAPPER.readTree(resp.body()); if (root.hasNonNull("error")) { - throw new IllegalStateException("Solana RPC error: " + root.get("error").toString()); + throw new IllegalStateException("Solana RPC error: " + root.get("error")); } - - JsonNode result = root.path("result"); - if (!result.isArray() || result.isEmpty()) return null; - - for (JsonNode item : result) { - JsonNode dataNode = item.path("account").path("data"); - if (!dataNode.isArray() || dataNode.size() < 1) continue; - String b64 = dataNode.get(0).asText(""); - if (b64.isBlank()) continue; - return Base64.getDecoder().decode(b64); + JsonNode account = root.path("result").path("value"); + if (account.isMissingNode() || account.isNull()) return null; + if (!SolanaProgramsConfig.SHINE_USERS_PROGRAM_ID.equals(account.path("owner").asText())) { + throw new IllegalStateException("PDA принадлежит другой программе"); } - return null; + JsonNode data = account.path("data"); + if (!data.isArray() || data.isEmpty()) return null; + String b64 = data.get(0).asText(""); + return b64.isBlank() ? null : Base64.getDecoder().decode(b64); } private static ParsedSolanaUser parseUserPda(byte[] raw) { @@ -258,7 +238,7 @@ public final class SolanaUserPdaImportService { } if (blockchainKey32 == null || clientKey32 == null || forkCount <= 0 || forkCount > 999) return null; - String blockchainName = login + "-" + String.format(Locale.ROOT, "%03d", forkCount); + String blockchainName = normalizeLogin(login) + "-" + String.format(Locale.ROOT, "%03d", forkCount); return new ParsedSolanaUser( login, blockchainName, @@ -365,7 +345,7 @@ public final class SolanaUserPdaImportService { return out; } - // Нужен для memcmp.bytes в Solana RPC. + // Вспомогательная base58-конверсия для других совместимых полей. private static String toBase58(byte[] input) { final char[] alphabet = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz".toCharArray(); int zeros = 0; diff --git a/SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/codec/ShineUsersCodec.java b/SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/codec/ShineUsersCodec.java index 7b803adb..1c093509 100644 --- a/SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/codec/ShineUsersCodec.java +++ b/SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/codec/ShineUsersCodec.java @@ -770,7 +770,7 @@ public final class ShineUsersCodec { if (type == 2) { registrarKey = Base58Util.encode(r.readFixed(32)); serverLogin = r.readStringU8(); - if (!serverLogin.matches("[a-z0-9_]+@[a-z0-9_]+") || serverLogin.length() > 30) { + if (!serverLogin.matches("[A-Za-z0-9_]+@[a-z0-9_]+") || serverLogin.length() > 30) { throw new IllegalArgumentException("Invalid access server login"); } } diff --git a/SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/util/SolanaPdaUtil.java b/SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/util/SolanaPdaUtil.java index 77f0ece4..46ff776f 100644 --- a/SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/util/SolanaPdaUtil.java +++ b/SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/util/SolanaPdaUtil.java @@ -63,10 +63,10 @@ public final class SolanaPdaUtil { /** Новый v2 PDA. Старый двух-seed вариант оставлен только для legacy accounts. */ public static String findUserPdaV2(String fullLogin, String programId) { - if (fullLogin == null || !fullLogin.matches("[a-z0-9_]+@[a-z0-9_]+") || fullLogin.length() > 30) { + if (fullLogin == null || !fullLogin.matches("[A-Za-z0-9_]+@[a-z0-9_]+") || fullLogin.length() > 30) { throw new IllegalArgumentException("Invalid full login"); } - return findHashedPda("user_login=" + fullLogin, programId); + return findHashedPda("user_login=" + fullLogin.toLowerCase(java.util.Locale.ROOT), programId); } public static String findNamespacePda(String namespace, String programId) { diff --git a/SHiNE-server/shine-server-solana-users-sync/src/test/java/sync/util/SolanaPdaUtilTest.java b/SHiNE-server/shine-server-solana-users-sync/src/test/java/sync/util/SolanaPdaUtilTest.java index 55fe85a9..46845b4b 100644 --- a/SHiNE-server/shine-server-solana-users-sync/src/test/java/sync/util/SolanaPdaUtilTest.java +++ b/SHiNE-server/shine-server-solana-users-sync/src/test/java/sync/util/SolanaPdaUtilTest.java @@ -24,4 +24,13 @@ class SolanaPdaUtilTest { pda ); } + @Test + void mixedCaseUsesSamePdaButNamespaceMustRemainLowercase() { + String program = "SHiNEPr1APdAgNBteUyBXcNovaHctpSjUu8oH2ZJdN6"; + String lower = SolanaPdaUtil.findUserPdaV2("superman@free", program); + assertEquals(lower, SolanaPdaUtil.findUserPdaV2("SuperMan@free", program)); + assertEquals(lower, SolanaPdaUtil.findUserPdaV2("SUPERMAN@free", program)); + org.junit.jupiter.api.Assertions.assertThrows(IllegalArgumentException.class, + () -> SolanaPdaUtil.findUserPdaV2("SuperMan@FREE", program)); + } } diff --git a/SHiNE-server/src/main/resources/application.properties b/SHiNE-server/src/main/resources/application.properties index e40dba6d..9246a094 100644 --- a/SHiNE-server/src/main/resources/application.properties +++ b/SHiNE-server/src/main/resources/application.properties @@ -146,7 +146,7 @@ test.freeAvatar.walletJwkPath= # ============================================================ # Arweave per-user-block transport (ANS-104) -# Test namespace: each user DataItem is signed with App=test5591. +# Test namespace: each user DataItem is signed with App=test5592. # Channel DataItems additionally contain c=. # ============================================================ arweave.blocks.publish.enabled=false diff --git a/VERSION.properties b/VERSION.properties index ee309369..fa7c3171 100644 --- a/VERSION.properties +++ b/VERSION.properties @@ -1,2 +1,2 @@ -client.version=1.20.4 -server.version=1.16.3 +client.version=1.20.5 +server.version=1.16.4 diff --git a/deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md b/deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md index e721fd69..9c490a34 100644 --- a/deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md +++ b/deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md @@ -149,3 +149,7 @@ Migration v26 добавляет server-local поля `rotation_status` / `rota SELECT registration_status, count(*) FROM user_identity_current GROUP BY registration_status; SELECT schema_version FROM db_schema_version WHERE id=1; ``` + + +## Регистронезависимый логин (2026-10-28) +Для новых баз важно совместное обновление программы `shine_users`, Java Solana sync/архива и UI. После обновления `login` внутри PDA сохраняет регистр, а адрес и `normalized_login` используют lowercase. Перед проверкой смешанного регистра заново инициализируйте **тестовую** БД и разверните обновлённую Solana-программу в devnet; сам ZIP её не разворачивает. diff --git a/docs/API/04_Add_Block_to_Blockchain_API.md b/docs/API/04_Add_Block_to_Blockchain_API.md index ce2bd0f4..ca8d68f1 100644 --- a/docs/API/04_Add_Block_to_Blockchain_API.md +++ b/docs/API/04_Add_Block_to_Blockchain_API.md @@ -32,14 +32,14 @@ - generic Ed25519 signature type `2`; - Ed25519 signature 64 bytes; - owner 32 bytes и равен текущему blockchain public key; -- обязательный тестовый tag `App=test5591`; +- обязательный тестовый tag `App=test5592`; - для channel block — `c=`; - `TEXT_CHANNEL_DELETE (type=1/subType=92/version=1)` является обычным line-based channel block с пустым text и тем же обязательным `c=`; отдельной операции API для удаления канала нет; - `data` содержит SHiNE Frame v1 (`frameCode=1`). ## Основные ошибки -- `bad_app_tag` — отсутствует/неверен `App=test5591`; +- `bad_app_tag` — отсутствует/неверен `App=test5592`; - `bad_channel_tag` — `c` отсутствует, лишний или не совпадает с canonical slug; - `bad_signature` / `signature_verify_failed` — DataItem не подписан текущим blockchain key; - `bad_block_number` — нарушена последовательность; diff --git a/docs/Blockchain/01_Common_Block_Format.md b/docs/Blockchain/01_Common_Block_Format.md index e220a2c9..93f55746 100644 --- a/docs/Blockchain/01_Common_Block_Format.md +++ b/docs/Blockchain/01_Common_Block_Format.md @@ -74,7 +74,7 @@ blockN.back32Hash32 = (N < 32 ? ZERO_HASH_32 : HASH(block N-32)) Каждый блок: ```text -App = test5591 +App = test5592 ``` Это временное namespace-значение для разработки. Перед реальным запуском оно будет заменено отдельным изменением протокола/кода. @@ -120,7 +120,7 @@ Slug входит в подпись DataItem и не может быть изм Сервер обязан: 1. распарсить полный ANS-104 DataItem; -2. проверить `App=test5591`; +2. проверить `App=test5592`; 3. проверить `t`, если тип блока требует фиксированный индексный поток; 4. проверить `c`, если тип блока требует канал; 5. проверить ANS-104 Ed25519 подпись; diff --git a/docs/Blockchain/17_ANS104_Arweave_Transport.md b/docs/Blockchain/17_ANS104_Arweave_Transport.md index 089ce2c6..f9c4c871 100644 --- a/docs/Blockchain/17_ANS104_Arweave_Transport.md +++ b/docs/Blockchain/17_ANS104_Arweave_Transport.md @@ -1,6 +1,6 @@ # ANS-104 / Arweave transport для пользовательских блоков SHiNE -> **Текущий transport namespace:** `test5591`. Он намеренно хранится отдельно в трёх рабочих местах: сервер (`ShineProtocolTags.java`), UI (`js/services/protocol-tags.js`) и актуальный Viewer (`static-sites/arweave-viewer/index.html`). При смене тестовой эпохи эти три значения меняются синхронно. Имя канального индексного тега постоянно и не зависит от namespace: `c`. +> **Текущий transport namespace:** `test5592`. Он намеренно хранится отдельно в трёх рабочих местах: сервер (`ShineProtocolTags.java`), UI (`js/services/protocol-tags.js`) и актуальный Viewer (`static-sites/arweave-viewer/index.html`). При смене тестовой эпохи эти три значения меняются синхронно. Подписанные бесплатные сертификаты `t=reg` используют ту же серверную константу `ShineProtocolTags.APP_TAG_VALUE` (отдельного жёстко заданного App тега нет). Имя канального индексного тега постоянно и не зависит от namespace: `c`. ## Цель @@ -13,7 +13,7 @@ Для тестового контура обязательно: ```text -App=test5591 +App=test5592 ``` Для фиксированных потоков: @@ -94,7 +94,7 @@ Bundle-Version=2.0.0 Content-Type=application/octet-stream ``` -Специальный `App=test5591-batch` больше не используется. Важны вложенные user DataItems, у которых уже есть `App=test5591`. +Специальный `App=test5592-batch` больше не используется. Важны вложенные user DataItems, у которых уже есть `App=test5592`. ### `none` @@ -114,7 +114,7 @@ Content-Type=application/octet-stream Importer всегда выполняет один discovery-запрос: ```text -App=test5591 +App=test5592 ``` Он **не ищет root bundles** и не зависит от `publish.mode`. @@ -132,7 +132,7 @@ App=test5591 Поэтому importer: -1. получает `data_item_id` через GraphQL `App=test5591`; +1. получает `data_item_id` через GraphQL `App=test5592`; 2. запрашивает `GET /ar-io/offsets/{data_item_id}`; 3. получает `rootTxId`, `rootOffset`, `size`; 4. делает range-read `GET /raw/{rootTxId}` ровно по этому диапазону; diff --git a/docs/Blockchain/CASE_INSENSITIVE_LOGIN.md b/docs/Blockchain/CASE_INSENSITIVE_LOGIN.md new file mode 100644 index 00000000..f29b1362 --- /dev/null +++ b/docs/Blockchain/CASE_INSENSITIVE_LOGIN.md @@ -0,0 +1,9 @@ +# Единый идентификатор пользователя и оригинальный регистр (28.10.2026) + +- `login@namespace`: `login` разрешает ASCII `A-Z`, `a-z`, цифры, `_`; namespace только `a-z`, цифры, `_`. +- Для сравнения, поиска, авторизации, PDA и имени блокчейна (`lower(fullLogin)-001`) используем ASCII lowercase. +- Сертификат Arweave подписывает исходное, неизменяемое написание. PDA хранит исходное написание; seed PDA строится из lowercase. +- В подписанных блоках лайков, ответов и связей формат **не меняется**. `toLogin` может содержать оригинальный регистр; это не создаёт другую идентичность. +- В БД проекция статистики реакций, ответов и связей нормализует ссылки через `lower()`, не изменяя подписанное содержимое `blocks_store`. +- Для показа красивого имени UI использует исходное написание из регистрационной записи (`GetUser`), если оно ещё неизвестно по записи автора. +- Начальная установка делается на новой базе; миграция старых данных не предусмотрена. diff --git a/docs/Blockchain/CHANGELOG.md b/docs/Blockchain/CHANGELOG.md index a0ba47c7..2d3b53f8 100644 --- a/docs/Blockchain/CHANGELOG.md +++ b/docs/Blockchain/CHANGELOG.md @@ -1,3 +1,10 @@ +## 2026-10-28 — Новая тестовая эпоха Arweave `test5592` + +- Текущий ANS-104 `App` изменён с `test5591` на `test5592`: UI, Java-сервер (включая бесплатные `t=reg` сертификаты), Arweave Viewer. +- Старые Arweave DataItem остаются неизменными, но не импортируются новой тестовой эпохой. Система стартует с новой PostgreSQL БД и очищенной программой shine_users на devnet. +- `App` — **тег Arweave**, а НЕ Solana Program ID. Program ID и `c=` не изменены. +- Исторические подписанные криптографические фикстуры `test5591` не переписываются; отдельно тестируется генерация новых `test5592`. + ## 2026-10-06 18:02 +0300 — Soft-delete каналов - Базовый коммит-ориентир: `working tree`; изменение подготовлено как patch без нового git-коммита. @@ -326,3 +333,5 @@ - 2026-10-23 — регистрационные WS операции и UI для отдельного `t=reg` ANS-104 DataItem, пользовательский Frame V1/AddBlock формат не менялся. Commit hash отсутствует (не коммитировалось), перед merge заменить на реальный hash. - 2026-10-23 — исправлена валидация `HeaderBody`: кроме legacy-логинов разрешены `login@namespace` (до 30 ASCII-байт). Это устраняет `BAD_BLOCK_FORMAT` при первом AddBlock новых free/paid пользователей. Порядок байт HEADER, Frame v1, ANS-104 и API без изменений. Commit hash отсутствует (патч без git-коммита); после коммита добавить хэш. + +- 2026-10-28: регистронезависимая идентичность и социальные ссылки; бинарный формат подписанных блоков не менялся. Коммит: не создавался (ZIP-патч). diff --git a/docs/Blockchain/CODEX_APPLY_ANS104_TEST5590_PATCH.md b/docs/Blockchain/CODEX_APPLY_ANS104_TEST5590_PATCH.md index cadd6c8a..3042ccc5 100644 --- a/docs/Blockchain/CODEX_APPLY_ANS104_TEST5590_PATCH.md +++ b/docs/Blockchain/CODEX_APPLY_ANS104_TEST5590_PATCH.md @@ -1,4 +1,4 @@ -> **LEGACY / historical patch note.** Current protocol uses `App=test5591` and the permanent channel tag `c=`. Do not apply the `c_test5590` instructions below to current code. +> **LEGACY / historical patch note.** Current protocol uses `App=test5592` and the permanent channel tag `c=`. Do not apply the `c_test5590` instructions below to current code. # Применение patch: Turbo + direct Arweave для `App=test5590` diff --git a/docs/Blockchain/README.md b/docs/Blockchain/README.md index 8402b687..488fb6c8 100644 --- a/docs/Blockchain/README.md +++ b/docs/Blockchain/README.md @@ -15,7 +15,7 @@ ```text User -> создаёт Frame v1 - -> tags: App=test5591; t=tech/conn/prof для фиксированных потоков; при канале c= + -> tags: App=test5592; t=tech/conn/prof для фиксированных потоков; при канале c= -> Ed25519 подписывает ANS-104 deep-hash -> готовый DataItem -> AddBlock @@ -28,7 +28,7 @@ Server ИЛИ publish.mode=none: наружу не публиковать Other servers - -> GraphQL App=test5591 + -> GraphQL App=test5592 -> скачивают/извлекают DataItem -> verify -> PostgreSQL без повторной публикации @@ -39,7 +39,7 @@ Other servers - SHiNE `prevHash` остаётся SHA-256 предыдущего Frame v1 и не зависит от Arweave. - `data_item_id` нужен для Arweave, поиска и дедупликации. - PostgreSQL — единственное локальное хранилище пользовательских блоков. -- Тестовый namespace `App=test5591` специально отделён от будущего production namespace. +- Тестовый namespace `App=test5592` специально отделён от будущего production namespace. ## Отдельные регистрационные DataItem V1 (test only; импорт реализован в коде, E2E не пройден) @@ -47,3 +47,5 @@ Other servers Новая платформа регистрации `t=reg` использует ANS-104 Ed25519 и независимый payload, **не являющийся пользовательским AddBlock**. Формат определён в [регистрационном протоколе](../Протоколы/SHINE_FREE_REGISTRATION_CERTIFICATE_V1.md). Обычный формат пользовательских блоков не меняется. Новая регистрация отправляет `t=reg` через Turbo и отдельный импортёр, код включён только в тестовом патче; фактический Turbo/GraphQL E2E ещё не пройден. - Регистрационные Arweave ANS-104 DataItem `t=reg` (вне пользовательских блокчейнов): `../Протоколы/SHINE_FREE_REGISTRATION_CERTIFICATE_V1.md`, `../registration-v2/PATCH_STAGES_8_9_10.md`. + +- [Единая идентичность логина без учёта регистра](CASE_INSENSITIVE_LOGIN.md) — правила логинов, PDA и социальных ссылок (2026-10-28). diff --git a/docs/Blockchain/sync-between-servers.md b/docs/Blockchain/sync-between-servers.md index 60034925..508b8114 100644 --- a/docs/Blockchain/sync-between-servers.md +++ b/docs/Blockchain/sync-between-servers.md @@ -40,7 +40,7 @@ blockchain.sync.enabled=false Дополнительно каждый сервер может независимо включить `ArweaveBlockSyncScheduler`. -Он ищет child DataItems по тестовому тегу `App=test5591`, проверяет их и импортирует через ту же бизнес-проверку AddBlock. Импортированные блоки не публикуются повторно. +Он ищет child DataItems по тестовому тегу `App=test5592`, проверяет их и импортирует через ту же бизнес-проверку AddBlock. Импортированные блоки не публикуются повторно. Если блоки обнаружены не по порядку, persistent queue оставляет более поздние блоки pending до появления предыдущих. diff --git a/docs/Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md b/docs/Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md index 9a51a73f..875f8e41 100644 --- a/docs/Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md +++ b/docs/Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md @@ -616,3 +616,7 @@ Arweave/Turbo publisher обрабатывает candidate-блоки приор Для новых `login@namespace` используется `SHA256(UTF8("user_login=" + fullLogin))` как один 32-byte PDA seed; для namespace — `SHA256(UTF8("namespace=" + namespace))`. `IX_CREATE_NAMESPACE=7` читается как отдельное событие. `SolanaUsersSyncService` декодирует namespace независимо от user-PDA и сохраняет снапшоты namespaces в `shine_namespace_current`; paid user-PDA параллельно синхронизируются как прежде. При upsert Solana запись переносит логического пользователя `FREE_CERT → PAID` без изменения логина и исходной даты в `user_identity_current`; free-сертификат не превращается в фальшивый Solana PDA. Общий индекс появляется в DB v33. Миграция DB v35 консолидирует исторические `PAID_DIRECT`/`PAID_UPGRADED` в `PAID` и переопределяет Solana-trigger, чтобы все последующие PDA синхронизировались в одном платном статусе. `free_data_item_id` и `free_registration_certificate` остаются как свидетельства первоначальной бесплатной регистрации, но не создают особый статус. Standalone sync можно запускать только после применения миграций DB v33–v35 через Java-сервер. **ВНИМАНИЕ:** проверить на настоящем PostgreSQL + RPC replay до включения. Read-only economy-PDA остаётся индексом истории через `getSignaturesForAddress`, не гарантирует websocket account notification. + + +## Логин с оригинальным регистром (2026-10-28) +При чтении PDA 1.2 `login` сохраняет регистр из подписанного on-chain состояния, а `normalized_login`/имя пользовательского блокчейна формируются из ASCII lowercase. Адрес PDA рассчитывается как `find_program_address(SHA256("user_login=" + ASCII-lowercase(fullLogin)))`; это предотвращает отдельные адреса для `SuperMan@free` и `superman@free`. Никаких переименований исторических данных нет — проект стартует с новой БД. diff --git a/docs/registration-v2/MASTER_PLAN_V2_2026-10-23.md b/docs/registration-v2/MASTER_PLAN_V2_2026-10-23.md index b697bf67..18f6fd09 100644 --- a/docs/registration-v2/MASTER_PLAN_V2_2026-10-23.md +++ b/docs/registration-v2/MASTER_PLAN_V2_2026-10-23.md @@ -72,7 +72,7 @@ Внутренняя подпись нужна для последующей проверки в Solana, внешняя — для удостоверения полного DataItem при его импорте. Это **две разные подписи от разных последовательностей байтов**. -Теги DataItem следует отделять от обычных пользовательских блоков, например существующим `App=test5591` плюс отдельный тег типа `t=reg`; точный набор тегов утвердить в документе протокола, не смешивать с `t=prof|conn|tech`. +Теги DataItem следует отделять от обычных пользовательских блоков, например существующим `App=test5592` плюс отдельный тег типа `t=reg`; точный набор тегов утвердить в документе протокола, не смешивать с `t=prof|conn|tech`. ## А5. Email diff --git a/docs/registration-v2/PATCH_STAGES_8_9_10.md b/docs/registration-v2/PATCH_STAGES_8_9_10.md index 8985f0ba..082a7c5e 100644 --- a/docs/registration-v2/PATCH_STAGES_8_9_10.md +++ b/docs/registration-v2/PATCH_STAGES_8_9_10.md @@ -7,7 +7,7 @@ ## 8 — Arweave и Turbo (реализовано частично) - `VerifiedFreeRegistrationImporter` — новый отдельный путь `t=reg`, отказывается принимать пользовательский BchBlock как сертификат. Проверяет структурный АНS-104, внешнюю Ed25519 и внутреннюю подпись, подписанта из namespace-PDA через реестр, полное имя и минимальную длину, транзакционную уникальность login/email; различает `TURBO_ACCEPTED` и `ARWEAVE_CONFIRMED`; повтор того же сырого DataItem не дублирует личность. - `FreeRegistrationPublisher` предварительно проверяет сертификат и занятость имени/email до HTTP, затем отправляет уже подписанный DataItem через существующий `TurboDataItemUploader`; только после его успешного ACK вызывает тот же локальный importer. При unknown Turbo outcome не заявляет успех. -- `ArweaveBlockSyncService` распознаёт `t=reg` до обычной block queue, отдельно вычитывает GraphQL `App=test5591 AND t=reg` и хранит собственный checkpoint (`migration_v34.sql`). После появления height независимые серверы импортируют сертификат, повторное обнаружение подтверждает `ARWEAVE_CONFIRMED`. +- `ArweaveBlockSyncService` распознаёт `t=reg` до обычной block queue, отдельно вычитывает GraphQL `App=test5592 AND t=reg` и хранит собственный checkpoint (`migration_v34.sql`). После появления height независимые серверы импортируют сертификат, повторное обнаружение подтверждает `ARWEAVE_CONFIRMED`. - **Проверить в реальной сети:** Arweave gateway / GraphQL фильтрация / root-range доступность и работу с несколькими серверами. Нет фактического Turbo upload и PostgreSQL integration; нельзя считать этап завершённым. ## 9 — WS API (подготовка, публичное API не изменено) diff --git a/docs/Протоколы/SHINE_FREE_REGISTRATION_CERTIFICATE_V1.md b/docs/Протоколы/SHINE_FREE_REGISTRATION_CERTIFICATE_V1.md index d2c90b03..028c708f 100644 --- a/docs/Протоколы/SHINE_FREE_REGISTRATION_CERTIFICATE_V1.md +++ b/docs/Протоколы/SHINE_FREE_REGISTRATION_CERTIFICATE_V1.md @@ -4,7 +4,7 @@ ## Байты и нормализация -`full_login` = `localpart@namespace` — **строго ASCII lowercase**, максимум 30 байт, regex `[a-z0-9_]+@[a-z0-9_]+`. Бинарная идентичность: +`full_login` = `localpart@namespace` — **ASCII, с сохранением регистра локальной части**, максимум 30 байт, regex `[A-Za-z0-9_]+@[a-z0-9_]+`. Бинарная идентичность: ```text identity_fields = major:u8(1) || minor:u8(0) || full_login_len:u8 || full_login:utf8 @@ -22,14 +22,16 @@ payload = identity_fields || inner_signature64 || email_sha256:32 Подписанный бинарный DataItem типа Ed25519 (`signature_type=2`, `owner=registrar_pubkey`) создаётся **тем же** приватным ключом регистратора через стандартный `deepHash` ANS-104 от всех полей и всего payload. Теги в точном порядке: -1. `App=test5591` +1. `App=test5592` 2. `t=reg` 3. `Protocol=SHiNE-Free-Registration-V1` Без target/anchor в V1. Внешняя подпись удостоверяет email hash и теги; ID DataItem = `SHA256(outer_signature64)`. Она НЕ равна внутренней, поскольку подписаны разные сообщения. Проверка внешней подписи обязательна при импорте (включая Turbo ACK), хотя Solana при upgrade проверяет только inner signature по публичному ключу из namespace-PDA. Сервер должен отвергать конфликт имени/hash-email и не заменять принятую идентичность иной записью. -`FREE_CERT → PAID_UPGRADED`: при Solana-create повторно предъявляется **та же внутренняя подпись**, созданная для тех же `login`, root, blockchain, client. Клиент не должен генерировать новые ключи. `created_at_ms` новой PDA — время регистрации в Solana, первоначальная дата, история и потраченные лимиты остаются в Arweave/БД; нельзя начислить дважды бесплатный бонус. Solana программа не проверяет наличие публикации ANS-104; её проверяет доверенный сервер. Детали защиты от смены ключа регистратора в этой версии не реализуются. +`FREE_CERT → PAID`: при Solana-create повторно предъявляется **та же внутренняя подпись**, созданная для тех же `login`, root, blockchain, client. Клиент не должен генерировать новые ключи. `created_at_ms` новой PDA — время регистрации в Solana, первоначальная дата, история и потраченные лимиты остаются в Arweave/БД; нельзя начислить дважды бесплатный бонус. Solana программа не проверяет наличие публикации ANS-104; её проверяет доверенный сервер. Детали защиты от смены ключа регистратора в этой версии не реализуются. ## Тестирование -Детерминированные фикстуры: `shine-solana/shine/tests/fixtures/registration-v2.json` (в том числе полноценный signed ANS-104 DataItem, его ID, hex подписи, отрицательные тесты изменения email и тегов). Векторные ключи предназначены только для тестов. Java-подписание и проверка сертификата присутствуют в этапе 7; загрузка через Turbo и доверенный импорт — этап 8. +Детерминированные фикстуры: `shine-solana/shine/tests/fixtures/registration-v2.json` (в том числе ранее подписанный ANS-104 DataItem с историческим `App=test5591`, его ID и подписи). Этот вектор сохранён **исключительно для проверки криптографического формата**, он НЕ является актуальным тегом выпуска. Актуальный `App=test5592` проверяется выпуском нового сертификата через Java `FreeRegistrationCertificateV1Check`. Векторные ключи предназначены только для тестов. Java-подписание и проверка сертификата присутствуют в этапе 7; загрузка через Turbo и доверенный импорт — этап 8. + +Адрес PDA при upgrade вычисляется от **ASCII lowercase** полного логина, но строка логина в сертификате, его подпись и поле `login` в PDA остаются в исходном регистре. Пароль/Argon2id также используют lowercase полного логина. diff --git a/shine-UI/js/services/protocol-tags.js b/shine-UI/js/services/protocol-tags.js index bd9fc0a3..fccffc1f 100644 --- a/shine-UI/js/services/protocol-tags.js +++ b/shine-UI/js/services/protocol-tags.js @@ -1,5 +1,5 @@ // Transport namespace UI. При следующей смене тестовой эпохи менять только эту строку в UI. -export const SHINE_PROTOCOL_NAMESPACE = 'test5591'; +export const SHINE_PROTOCOL_NAMESPACE = 'test5592'; export const SHINE_APP_TAG_NAME = 'App'; export const SHINE_APP_TAG_VALUE = SHINE_PROTOCOL_NAMESPACE; diff --git a/shine-UI/js/services/shine-namespace-service.js b/shine-UI/js/services/shine-namespace-service.js index 7fbcd2fe..e0fcaf78 100644 --- a/shine-UI/js/services/shine-namespace-service.js +++ b/shine-UI/js/services/shine-namespace-service.js @@ -12,13 +12,13 @@ export function normalizeNamespace(value) { export function normalizeFullLogin(value) { const login = String(value ?? ''); const parts = login.split('@'); - if (parts.length !== 2 || !/^[a-z0-9_]+$/.test(parts[0])) throw new Error('Требуется полный login@namespace без автоматического преобразования'); + if (parts.length !== 2 || !/^[A-Za-z0-9_]+$/.test(parts[0])) throw new Error('Требуется полный login@namespace: латинские буквы любого регистра, цифры, _'); normalizeNamespace(parts[1]); if (enc.encode(login).length > 30) throw new Error('Полный логин превышает 30 байт'); return login; } export async function userPdaSeed32(fullLogin) { - return sha256Bytes(enc.encode('user_login=' + normalizeFullLogin(fullLogin))); + return sha256Bytes(enc.encode('user_login=' + normalizeFullLogin(fullLogin).toLowerCase())); } export async function namespacePdaSeed32(namespace) { return sha256Bytes(enc.encode('namespace=' + normalizeNamespace(namespace))); diff --git a/shine-UI/static-sites/arweave-viewer/README.md b/shine-UI/static-sites/arweave-viewer/README.md index 3e17ca94..1b83f399 100644 --- a/shine-UI/static-sites/arweave-viewer/README.md +++ b/shine-UI/static-sites/arweave-viewer/README.md @@ -25,14 +25,14 @@ index.html?key=&channel=books &solanaRpc=https://api.mainnet-beta.solana.com ``` -`channel` можно не передавать. Тогда viewer ищет все DataItem пользователя с `App=test5591` и строит список каналов из найденных блоков. +`channel` можно не передавать. Тогда viewer ищет все DataItem пользователя с `App=test5592` и строит список каналов из найденных блоков. ## Что делает viewer 1. Если передан `login`, вычисляет PDA `user_login=` программы `SHiNEPr1APdAgNBteUyBXcNovaHctpSjUu8oH2ZJdN6` и читает `blockchainKey`. 2. Если передан `key`, использует его напрямую и не обращается к Solana. 3. Из Ed25519/Solana public key вычисляет Arweave owner address как `base64url(SHA-256(pubkey32))`. -4. Делает Arweave GraphQL запрос по owner + `App=test5591`; `channel` применяется локально после загрузки авторского блокчейна. +4. Делает Arweave GraphQL запрос по owner + `App=test5592`; `channel` применяется локально после загрузки авторского блокчейна. 5. Загружает payload каждого DataItem через gateway `/`. 6. Разбирает payload как SHiNE Frame v1 (`frameCode=0x0001`, header 88 bytes). 7. Дедуплицирует повторно опубликованные одинаковые пользовательские блоки по SHA-256 Frame v1. diff --git a/shine-UI/static-sites/arweave-viewer/index.html b/shine-UI/static-sites/arweave-viewer/index.html index 41074cba..d8fd11d7 100644 --- a/shine-UI/static-sites/arweave-viewer/index.html +++ b/shine-UI/static-sites/arweave-viewer/index.html @@ -1100,7 +1100,7 @@ var solanaWeb3=function(exports){"use strict";function getDefaultExportFromCjs(x const BCH_FRAME_HEADER_SIZE = 88; const BCH_FRAME_CODE_V1 = 0x0001; // Transport namespace актуального standalone Viewer. - const SHINE_PROTOCOL_NAMESPACE = 'test5591'; + const SHINE_PROTOCOL_NAMESPACE = 'test5592'; const SHINE_ARWEAVE_APP_TAG = SHINE_PROTOCOL_NAMESPACE; const SHINE_ARWEAVE_CHANNEL_TAG = 'c'; const BCH_TYPE_TECH = 0; diff --git a/shine-UI/tests/arweave-app-namespace.test.mjs b/shine-UI/tests/arweave-app-namespace.test.mjs new file mode 100644 index 00000000..16d95ad3 --- /dev/null +++ b/shine-UI/tests/arweave-app-namespace.test.mjs @@ -0,0 +1,19 @@ +import test from 'node:test'; +import assert from 'node:assert/strict'; +import fs from 'node:fs'; +import { fileURLToPath } from 'node:url'; +import path from 'node:path'; +const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..'); +const read = (p) => fs.readFileSync(path.join(root, p), 'utf8'); + +test('Тестовая эпоха Arweave одинакова в UI, Server и Viewer', () => { + const ui = read('shine-UI/js/services/protocol-tags.js'); + const server = read('SHiNE-server/shine-server-blockchain/src/main/java/blockchain/ShineProtocolTags.java'); + const viewer = read('shine-UI/static-sites/arweave-viewer/index.html'); + const reg = read('SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/FreeRegistrationCertificateV1.java'); + assert.match(ui, /SHINE_PROTOCOL_NAMESPACE\s*=\s*'test5592'/); + assert.match(server, /NAMESPACE\s*=\s*"test5592"/); + assert.match(viewer, /SHINE_PROTOCOL_NAMESPACE\s*=\s*'test5592'/); + assert.match(reg, /ShineProtocolTags\.APP_TAG_VALUE/); + for (const txt of [ui, server, viewer, reg]) assert.doesNotMatch(txt, /test5591/); +}); diff --git a/shine-UI/tests/registration-case-social-projection.test.mjs b/shine-UI/tests/registration-case-social-projection.test.mjs new file mode 100644 index 00000000..6772c914 --- /dev/null +++ b/shine-UI/tests/registration-case-social-projection.test.mjs @@ -0,0 +1,11 @@ +import test from 'node:test'; +import assert from 'node:assert/strict'; +import fs from 'node:fs'; +const schema = fs.readFileSync(new URL('../../SHiNE-server/shine-server-db/src/main/resources/postgres/schema_v1.sql', import.meta.url), 'utf8'); +const current = schema.slice(schema.lastIndexOf('CREATE OR REPLACE FUNCTION shine_blocks_connection_state_ai() RETURNS TRIGGER')); +test('социальные проекции нормализуют target, не изменяя блоки', () => { + assert.match(current, /VALUES\(lower\(NEW\.login\),1,lower\(NEW\.to_login\),/); + assert.match(current, /WHERE from_login=lower\(NEW\.login\)/); + assert.match(current, /INSERT INTO message_stats\(to_login,to_block_number,to_block_hash,replies_count\)[\s\S]*?VALUES\(lower\(NEW\.to_login\),/); + assert.match(current, /VALUES\(lower\(NEW\.login\),NEW\.msg_sub_type,lower\(NEW\.to_login\),/); +}); diff --git a/shine-UI/tests/registration-namespace-v2.test.mjs b/shine-UI/tests/registration-namespace-v2.test.mjs index e2607adc..63cbc198 100644 --- a/shine-UI/tests/registration-namespace-v2.test.mjs +++ b/shine-UI/tests/registration-namespace-v2.test.mjs @@ -14,7 +14,9 @@ const bh = x => Uint8Array.from(Buffer.from(x, 'hex')); test('строгая нормализация полных логинов', () => { assert.equal(normalizeFullLogin('alice@shine'), 'alice@shine'); - for (const bad of ['alice','ALICE@shine','alice@Shine',' alice@shine','alice@@shine','alice.s@shine','a'.repeat(30)+'@a']) + assert.equal(normalizeFullLogin('ALICE@shine'), 'ALICE@shine'); + assert.equal(normalizeFullLogin('AlIcE@shine'), 'AlIcE@shine'); + for (const bad of ['alice','alice@Shine',' alice@shine','alice@@shine','alice.s@shine','a'.repeat(30)+'@a']) assert.throws(() => normalizeFullLogin(bad)); assert.notEqual(normalizeFullLogin('a_b@shine'), normalizeFullLogin('ab@shine')); }); @@ -31,6 +33,8 @@ test('SHA256 PDA seeds stable and domain separated', async () => { assert.equal(hex(await userPdaSeed32('bob@free')), props.user_bob_free_seed); assert.equal(hex(await namespacePdaSeed32('free')), props.namespace_free_seed); assert.notEqual(hex(await userPdaSeed32('bob@free')), hex(await namespacePdaSeed32('free'))); + assert.equal(hex(await userPdaSeed32('BoB@free')), hex(await userPdaSeed32('bob@free'))); + assert.equal(hex(await userPdaSeed32('BOB@free')), hex(await userPdaSeed32('bob@free'))); }); test('inner message is byte-for-byte fixture', () => { const b = buildFreeCertificateInnerMessage('bob@free', @@ -38,6 +42,11 @@ test('inner message is byte-for-byte fixture', () => { bh('29acbae141bccaf0b22e1a94d34d0bc7361e526d0bfe12c89794bc9322966dd7'), bh('2543b92ff1095511476adc8369db6ddc933665a11978dda1404ee1066ca9559d')); assert.equal(hex(b), props.inner_message_hex); + const mixed = buildFreeCertificateInnerMessage('BoB@free', + bh('03a107bff3ce10be1d70dd18e74bc09967e4d6309ba50d5f1ddc8664125531b8'), + bh('29acbae141bccaf0b22e1a94d34d0bc7361e526d0bfe12c89794bc9322966dd7'), + bh('2543b92ff1095511476adc8369db6ddc933665a11978dda1404ee1066ca9559d')); + assert.notEqual(hex(mixed), hex(b)); // Подпись сертификата включает оригинальный регистр. }); test('create instruction suffix encodes registrar signature, never promo', () => { const common = {login:'bob@free', rootKey32: new Uint8Array(32), createdAtMs:1n, diff --git a/shine-solana/shine/doc/formats/shine-user-pda-format-v.1.2.md b/shine-solana/shine/doc/formats/shine-user-pda-format-v.1.2.md index 0e6b773c..25896d25 100644 --- a/shine-solana/shine/doc/formats/shine-user-pda-format-v.1.2.md +++ b/shine-solana/shine/doc/formats/shine-user-pda-format-v.1.2.md @@ -190,3 +190,7 @@ Legacy migration в 1.2 отсутствует. После удаления те Бинарный user-PDA 1.2 **не изменён**. Меняется seed новых PDA на `SHA256(UTF8("user_login="+normalizedFullLogin))` (32 сырых байта), а полная строка `login@namespace` входит в поле `login` и в существующую подпись. Ограничение полного имени — 30 байт. `created_at_ms` в новой PDA при free→paid соответствует дате on-chain создания и не является датой первого Arweave сертификата. Историческая идентичность и потраченные лимиты остаются за логическим пользователем, их сохраняет сервер/БД последующих этапов. Существующие PDA старых логинов без namespace продолжают принимать `update_user_pda` по старому seed `user_login=` + lowercase login; новых аккаунтов такого типа создать V2 больше нельзя. Новая регистрация **не будет совместима со старым клиентом** до обновления JS/сервера. + + +### Регистронезависимая идентичность (28.10.2026) +Локальная часть полного `login@namespace` допускает латинские буквы `A–Z` и `a–z`, цифры и `_`; `namespace` допускает только нижний ASCII-регистр. Выбранный при регистрации регистр логина неизменяем. Адрес user PDA вычисляется по `SHA256(UTF8("user_login=" + ASCII-lowercase(fullLogin)))` и bump для `find_program_address`. Сама запись PDA 1.2 содержит **оригинальное** написание `login`; подписи записи и регистраторского сертификата проверяются по исходному регистру без нормализации. Это изменение правила seed, не бинарного формата PDA. diff --git a/shine-solana/shine/doc/programs/shine_users.md b/shine-solana/shine/doc/programs/shine_users.md index 483a0ec5..7885feb3 100644 --- a/shine-solana/shine/doc/programs/shine_users.md +++ b/shine-solana/shine/doc/programs/shine_users.md @@ -31,7 +31,7 @@ Legacy 1.0 считается тестовым и не мигрируется. ```text tag:u8 = 3 -login:string_u8 // полный lowercase login@namespace, <= 30 байт +login:string_u8 // исходный регистр localpart, lowercase namespace, <= 30 байт root_key:[32] created_at_ms:u64 LE // новая Solana дата в пределах +-5 мин additional_limit:u64 LE // кратно LIMIT_STEP @@ -49,14 +49,14 @@ registrar_signature_present:u8 // 0 для type 1, 1 для type 2 Accounts в неизменном порядке: 1. `payer` — signer, writable; -2. `user_pda` — writable (SHA-256 полного логина); +2. `user_pda` — writable (SHA-256 нормализованного полного логина); 3. `system_program` — read-only; 4. `shine_payments` inflow vault — writable; 5. `sysvar::instructions` — read-only; 6. `users_economy_config_pda` — **read-only**; 7. `namespace_pda` — read-only, owner `shine_users`. -Проверки: namespace реально существует в программе, `localPart >= min_localpart_len`, общая длина <= 30, обе части ASCII lowercase `[a-z0-9_]+`, PDA соответствует `SHA256("user_login="+fullLogin)`, схема v1.2, root и blockchain Ed25519 proof-of-possession. Цена = `namespace.registration_fee + additional_limit/LIMIT_STEP * economy.lamports_per_limit_step` в существующий `shine_payments` vault. На create сохраняется существующая схема starter quota из economy-PDA: при переходе free→paid внешняя БД обязана учесть уже использованный бонус и не выдать его снова. +Проверки: namespace реально существует в программе, `localPart >= min_localpart_len`, общая длина <= 30, localpart допускает ASCII `[A-Za-z0-9_]+`, namespace остаётся ASCII lowercase `[a-z0-9_]+`, PDA соответствует `SHA256("user_login="+ASCII-lowercase(fullLogin))`, схема v1.2, root и blockchain Ed25519 proof-of-possession. Цена = `namespace.registration_fee + additional_limit/LIMIT_STEP * economy.lamports_per_limit_step` в существующий `shine_payments` vault. На create сохраняется существующая схема starter quota из economy-PDA: при переходе free→paid внешняя БД обязана учесть уже использованный бонус и не выдать его снова. **Ed25519 инструкции перед opcode 3 (строго непосредственно):** @@ -170,3 +170,7 @@ forks[]: - `AccessServersBlock`: 0 или 1 сервер доступа. Позже лимиты можно увеличить без изменения структуры блоков. + + +### Регистронезависимая идентичность (28.10.2026) +Локальная часть полного `login@namespace` допускает латинские буквы `A–Z` и `a–z`, цифры и `_`; `namespace` допускает только нижний ASCII-регистр. Выбранный при регистрации регистр логина неизменяем. Адрес user PDA вычисляется по `SHA256(UTF8("user_login=" + ASCII-lowercase(fullLogin)))` и bump для `find_program_address`. Сама запись PDA 1.2 содержит **оригинальное** написание `login`; подписи записи и регистраторского сертификата проверяются по исходному регистру без нормализации. Это изменение правила seed, не бинарного формата PDA. diff --git a/shine-solana/shine/programs/shine_users/src/lib.rs b/shine-solana/shine/programs/shine_users/src/lib.rs index b2acadb0..462d2278 100644 --- a/shine-solana/shine/programs/shine_users/src/lib.rs +++ b/shine-solana/shine/programs/shine_users/src/lib.rs @@ -1086,7 +1086,7 @@ fn validate_full_login(login: &str) -> Result<&str, ProgramError> { let (local, namespace) = login.split_once('@').ok_or(ShineUsersError::InvalidLogin)?; validate_namespace_name(namespace)?; require!(!local.is_empty(), ShineUsersError::InvalidLogin); - require!(local.bytes().all(|b| b.is_ascii_lowercase() || b.is_ascii_digit() || b == b'_'), ShineUsersError::InvalidLogin); + require!(local.bytes().all(|b| b.is_ascii_alphanumeric() || b == b'_'), ShineUsersError::InvalidLogin); Ok(namespace) } @@ -1151,7 +1151,7 @@ pub fn certificate_inner_message(login: &str, root: &Pubkey, blockchain: &Pubkey } pub fn user_pda_seed(login: &str) -> [u8; 32] { - hash(format!("{}{}", settings::USER_PDA_SEED_PREFIX, login).as_bytes()).to_bytes() + hash(format!("{}{}", settings::USER_PDA_SEED_PREFIX, login.to_ascii_lowercase()).as_bytes()).to_bytes() } fn validate_server_addresses(addresses: &[ServerAddressRecordV12]) -> ProgramResult { diff --git a/shine-solana/shine/tools/temporary-pda-cleaner/.gitignore b/shine-solana/shine/tools/temporary-pda-cleaner/.gitignore new file mode 100644 index 00000000..e7fd72e5 --- /dev/null +++ b/shine-solana/shine/tools/temporary-pda-cleaner/.gitignore @@ -0,0 +1,7 @@ +node_modules/ +target/ +*.json.bak +*.so +*pdas*.json +*keypair*.json +*-authority.json diff --git a/shine-solana/shine/tools/temporary-pda-cleaner/Cargo.toml b/shine-solana/shine/tools/temporary-pda-cleaner/Cargo.toml new file mode 100644 index 00000000..eb82e742 --- /dev/null +++ b/shine-solana/shine/tools/temporary-pda-cleaner/Cargo.toml @@ -0,0 +1,19 @@ +[package] +name = "shine_users_pda_cleaner" +version = "0.1.0" +edition = "2021" +description = "Временная программа для закрытия PDA shine_users в devnet" + +[lib] +name = "shine_users" +crate-type = ["cdylib", "lib"] + +[dependencies] +solana-program = "2.1.21" + +[features] +default = [] +no-entrypoint = [] + +# Отдельный workspace: временный crate НЕ включается в основной Solana workspace. +[workspace] diff --git a/shine-solana/shine/tools/temporary-pda-cleaner/DELETE_AFTER_DEVNET_RESET.md b/shine-solana/shine/tools/temporary-pda-cleaner/DELETE_AFTER_DEVNET_RESET.md new file mode 100644 index 00000000..bc9fd72b --- /dev/null +++ b/shine-solana/shine/tools/temporary-pda-cleaner/DELETE_AFTER_DEVNET_RESET.md @@ -0,0 +1,15 @@ +# ⚠️ DEV ONLY — ОДНОРАЗОВАЯ ПАПКА. УДАЛИТЬ ПОСЛЕ ОЧИСТКИ + +**Назначение:** исключительно разработка, уничтожение ВСЕХ PDA `shine_users` **только в Solana devnet**. Не часть приложения и не предназначено для production/mainnet. + +Содержимое папки временно подменяет БАЙТКОД существующей тестовой Solana-программы `shine_users` под ТЕМ ЖЕ Program ID. Не путать с `App=test5592` — это тег Arweave, не Program ID. + +**Агенту:** +1. Отключить регистрацию/синхронизацию, удостовериться в devnet и полном праве upgrade authority. Прочитать `README_AGENT_RU.md` целиком. +2. Сделать snapshot PDA, проверить список адресов и возвраты, затем временно обновить программу, закрыть PDA по одному на devnet (невозвратимо). +3. СРАЗУ восстановить ОФИЦИАЛЬНЫЙ `shine_users` из этого патча, подтвердить работоспособность; проинициализировать economy и namespaces заново. +4. После успешной проверки **УДАЛИТЬ ВСЮ ЭТУ ПАПКУ** `shine-solana/shine/tools/temporary-pda-cleaner/` из рабочего проекта, а не только .so-файл. Не включать её в будущие production-сборки, развёртывания, Git-коммиты или release ZIP. + +Не оставлять временный контракт установленным после операции. Восстановление исходной программы в devnet — обязательный отдельный шаг. + +**Не трогать:** Solana Program ID, mainnet, реальные данные пользователей, Arweave DataItem. Удаление PDA не стирает опубликованные записи Arweave. diff --git a/shine-solana/shine/tools/temporary-pda-cleaner/README_AGENT_RU.md b/shine-solana/shine/tools/temporary-pda-cleaner/README_AGENT_RU.md new file mode 100644 index 00000000..5469f36f --- /dev/null +++ b/shine-solana/shine/tools/temporary-pda-cleaner/README_AGENT_RU.md @@ -0,0 +1,151 @@ +> **⛔ РАЗОВАЯ DEV-ПРОЦЕДУРА. ПОСЛЕ УСПЕШНОГО DEVNET RESET УДАЛИТЬ ПАПКУ `shine-solana/shine/tools/temporary-pda-cleaner/` ИЗ ПРОЕКТА. НИКОГДА НЕ ДЕПЛОИТЬ В MAINNET.** + +# SHiNE — временная очистка PDA `shine_users` (ТОЛЬКО DEVNET) + +**Статус:** исходники и сценарий для агента; на реальном devnet ничего не запускалось. **Деструктивная процедура.** + +## Ключевой принцип + +Это НЕ новая программа с новым адресом. Папка содержит **временную замену байткода существующей программы** `shine_users` под **тем же** Program ID: + +`SHiNEPr1APdAgNBteUyBXcNovaHctpSjUu8oH2ZJdN6` + +Программа с другим Program ID **не может закрыть** старые PDA, которыми владеет существующая программа. Для очистки требуется текущая `upgrade authority` этого Program ID. Устанавливать новую программу с новым ID ради очистки нельзя. + +**Работать исключительно с devnet.** Временная программа сама не умеет проверить сеть (у программ нет безопасного способа прочитать genesis hash), поэтому оператор ОБЯЗАН до deploy проверить RPC и адрес. Скрипт `cleaner.mjs` отдельно проверяет реальный genesis hash devnet при КАЖДОМ запуске. + +## Что закрываем и куда идут SOL + +`getProgramAccounts(shine_users)` находит ВСЕ аккаунты, которыми владеет программа, в том числе: + +- пользовательские PDA (включая разные версии формата); +- PDA namespaces; +- `users_economy_config` PDA; +- другие вспомогательные аккаунты программы, если они существуют. + +Временная инструкция `close` допускает **только текущую upgrade authority из ProgramData**, проверенную на цепочке. Получатель средств — **этот же кошелёк**, его нельзя подменить. В каждом вызове закрывается ровно один PDA. Возвращается **весь баланс lamports на PDA**. Это может быть не тот кошелёк, который первоначально оплачивал размещение данных. + +**Не закрываем:** исполняемый Program account, ProgramData, PDA программ `shine_payments`, `shine_login_guard` и любые чужие аккаунты. После очистки Program ID остаётся прежним. + +## Перед началом — обязательно + +1. Убедиться, что это тестовые данные, которые можно безвозвратно уничтожить. Остановить регистрацию и фоновую синхронизацию `shine_users`, которая может создавать PDA. +2. Сохранить текущий исходник и байткод развернутой программы, программу **полного обновления** из последнего патча и документировать текущие адреса. +3. Убедиться, что `solana program show -u devnet ` выводит **Upgradeable Program** и правильную `Upgrade Authority` (а не `None`). Если authority отсутствует — остановиться. +4. Перед операцией переключить Solana CLI на devnet, **но команды ниже всё равно всегда передают `-u devnet` явно**. Ключ authority никуда не копировать и не добавлять в Git. +5. Если PDA находятся не в devnet, этот скрипт НЕ использовать; никаких автоматических попыток на mainnet. + +## Шаг 1 — проверить живую программу и сохранить состояние + +```bash +PROGRAM_ID=SHiNEPr1APdAgNBteUyBXcNovaHctpSjUu8oH2ZJdN6 +AUTHORITY_JSON=/absolute/private/path/upgrade-authority.json +solana -u devnet program show "$PROGRAM_ID" +solana -u devnet program dump "$PROGRAM_ID" ./shine_users_before_clean.so +solana-keygen pubkey "$AUTHORITY_JSON" +``` + +Нужно вручную сверить authority адрес из `program show` с адресом из `solana-keygen pubkey`. + +## Шаг 2 — до обновления программы сформировать снимок PDA + +Запускать из директории `scripts/`: + +```bash +npm install +node cleaner.mjs inspect \ + --authority "$(solana-keygen pubkey "$AUTHORITY_JSON")" \ + --manifest ./devnet-pdas-before-clean.json +``` + +В снимке видны адреса и возвращаемые lamports; осмотреть **каждый** PDA. Если PDA больше 100, скрипт останавливается, пока вы не разберётесь почему. НЕ размещать снимок, ключи и приватные данные в публичных репозиториях. + +## Шаг 3 — собрать временную программу + +Из папки `temporary-pda-cleaner/`: + +```bash +cargo build-sbf +``` + +Результат: `target/deploy/shine_users.so`. Сборка требует Solana SBF toolchain; просто `cargo build` не подходит для deploy. Компиляция не проверялась в окружении подготовки архива, где Solana/Rust toolchain отсутствует. + +## Шаг 4 — временно обновить **существующую** программу + +**Сверить кластер!** Эта операция оставляет систему без обычной регистрации до восстановления основного байткода. + +```bash +solana -u devnet program deploy \ + --program-id "$PROGRAM_ID" \ + --upgrade-authority "$AUTHORITY_JSON" \ + ./target/deploy/shine_users.so + +solana -u devnet program show "$PROGRAM_ID" +``` + +Если Solana CLI требует ключ программы, использовать исходный program-id keypair из безопасного хранилища, а не генерировать новый. Команду подстроить под установленную версию CLI, не подменяя ID. + +## Шаг 5 — удалить PDA по одному, с проверками + +Из `scripts/`, только после осмотра снимка и шага 4: + +```bash +node cleaner.mjs execute \ + --manifest ./devnet-pdas-before-clean.json \ + --keypair "$AUTHORITY_JSON" \ + --confirm <КОЛИЧЕСТВО_ИЗ_СНИМКА> \ + --i-understand-irreversible + +node cleaner.mjs verify +``` + +Скрипт: + +- проверяет *genesis hash* devnet, Program ID, ProgramData и реальную upgrade authority; +- сверяет PDA с заранее сохранённым снимком (включая SOL); +- перед каждой транзакцией выполняет `simulateTransaction`; +- подтверждает транзакцию и отсутствие PDA по RPC; +- при прерывании допускает повторный `execute`: уже закрытые PDA пропускаются; +- в конце требует **ноль** оставшихся PDA в `shine_users`. + +Если возвращается ошибка, **остановиться** и разобраться. Не менять автоматически списки PDA, адрес кошелька или фильтры. + +## Шаг 6 — немедленно восстановить нормальный контракт + +**Восстанавливать надо НОВУЮ версию из актуального проекта после CASE_INSENSITIVE_LOGIN_PATCH**, а не устаревший байткод из `before_clean` (тот файл только для аварийного отката и диагностики). + +```bash +# В каталоге АКТУАЛЬНОЙ штатной программы из проекта: +cargo build-sbf +solana -u devnet program deploy \ + --program-id "$PROGRAM_ID" \ + --upgrade-authority "$AUTHORITY_JSON" \ + ./target/deploy/shine_users.so +solana -u devnet program show "$PROGRAM_ID" +``` + +После восстановление обязательно удостовериться, что программа отличается от временной и **не принимает** инструкцию `0x01` в формате временного контракта как команду на закрытие произвольного PDA. В актуальной штатной `shine_users` инструкция `0x01` означает инициализацию экономического PDA, а не очистку. + +## Шаг 7 — переинициализировать чистую систему + +- Применить новую серверную схему PostgreSQL; НЕ восстанавливать старую базу. +- Инициализировать `users_economy_config` и создать namespace PDA заново штатными командами/экраном проекта. +- Синхронизатор Solana запустить после проверки валидного кода и PDA. +- Проверить: `SuperMan@free` регистрируется; `superman@free` повторно не регистрируется; PDA вычисляется из lowercase; внутри PDA остаётся оригинальный регистр; переход из Arweave в Solana работает; лайки и ответы работают. +- Проверить, что в исходном коде UI, сервера и Rust **одинаковый Program ID**. + +## Не путать с Arweave `App=test5592` + +`test5591 → test5592` — смена **тестового тега Arweave** (`App`), а не Solana Program ID. Временная программа и штатный `shine_users` используют тот же Program ID, остальные Solana-адреса программы не меняются. Arweave-данные с предыдущим App остаются в сети, но сервер новой эпохи их не импортирует. + +## Удаление этой папки после работ + +После проверки того, что **штатный смарт-контракт восстановлен**, devnet PDA очищены и новые тестовые регистрации работают: удалить весь каталог `shine-solana/shine/tools/temporary-pda-cleaner/` из дерева проекта и из будущих release artifacts. Сам проект (UI/Java/настоящий контракт) после этого будет продолжать работать. + +## Ограничения и безопасность + +- Ни один реальный PDA здесь не удалён; on-chain вызовы, компиляция и деплой не выполнялись. +- Это техническая заготовка, обязательны предварительная ручная проверка кода агентом и тест на localnet/devnet. Нельзя запускать на mainnet. +- **Программа удаления очень опасна, пока развернута:** не оставлять её на сети после очистки. +- `getProgramAccounts` может быть недоступен на публичном RPC из-за лимитов: использовать devnet RPC с поддержкой метода. Не обходить предохранители отключением проверок. +- PDA других программ, записи Arweave, внешние хранилища и PostgreSQL этой процедурой не очищаются. diff --git a/shine-solana/shine/tools/temporary-pda-cleaner/scripts/cleaner.mjs b/shine-solana/shine/tools/temporary-pda-cleaner/scripts/cleaner.mjs new file mode 100644 index 00000000..53450ad1 --- /dev/null +++ b/shine-solana/shine/tools/temporary-pda-cleaner/scripts/cleaner.mjs @@ -0,0 +1,118 @@ +#!/usr/bin/env node +// Временная очистка PDA shine_users. Только devnet, всегда проверять genesis hash. +// Никогда не добавляйте приватный ключ или файл keypair в git/архив. +import { Connection, PublicKey, Keypair, Transaction, TransactionInstruction, sendAndConfirmTransaction, BPF_LOADER_UPGRADEABLE_PROGRAM_ID } from '@solana/web3.js'; +import { readFileSync, writeFileSync, existsSync } from 'node:fs'; + +const PROGRAM_ID = new PublicKey('SHiNEPr1APdAgNBteUyBXcNovaHctpSjUu8oH2ZJdN6'); +const DEVNET_GENESIS = 'EtWTRABZaYq6iMfeYKouRu166VU2xqa1wcaWoxPkrZBG'; +const RPC = 'https://api.devnet.solana.com'; +const MAX_ACCOUNTS = 100; // Защита от случайной массовой очистки. +const usage = ` +Команды: + node cleaner.mjs inspect --authority --manifest + node cleaner.mjs execute --manifest --keypair --confirm --i-understand-irreversible + node cleaner.mjs verify +Все команды работают ТОЛЬКО с devnet и с фиксированным Program ID: ${PROGRAM_ID.toBase58()} +`; +function arg(name) { + const i = process.argv.indexOf(name); + return i < 0 ? undefined : process.argv[i + 1]; +} +function fatal(msg) { throw new Error(msg); } +const command = process.argv[2]; +if (!['inspect', 'execute', 'verify'].includes(command)) { console.log(usage); process.exit(2); } +const c = new Connection(RPC, 'confirmed'); + +async function checkNetworkAndProgram() { + const genesis = await c.getGenesisHash(); + if (genesis !== DEVNET_GENESIS) fatal(`ОПАСНО: RPC не devnet: ${genesis}`); + const p = await c.getAccountInfo(PROGRAM_ID, 'confirmed'); + if (!p?.executable || !p.owner.equals(BPF_LOADER_UPGRADEABLE_PROGRAM_ID)) fatal('Программа не является upgradeable loader-v3. Остановка.'); + if (p.data.length < 36 || p.data.readUInt32LE(0) !== 2) fatal('Неверный loader-v3 Program account'); + const programdata = new PublicKey(p.data.subarray(4, 36)); + const pd = await c.getAccountInfo(programdata, 'confirmed'); + if (!pd || !pd.owner.equals(BPF_LOADER_UPGRADEABLE_PROGRAM_ID) || pd.data.length < 45 || pd.data.readUInt32LE(0) !== 3 || pd.data[12] !== 1) { + fatal('ProgramData не содержит активную upgrade authority'); + } + const authority = new PublicKey(pd.data.subarray(13, 45)); + return { programdata, authority }; +} +async function listOwned() { + // dataSlice устраняет скачивание всех данных PDA, получаем адрес и lamports. + const a = await c.getProgramAccounts(PROGRAM_ID, { commitment: 'confirmed', dataSlice: { offset: 0, length: 0 } }); + return a.map(x => ({ address: x.pubkey.toBase58(), lamports: x.account.lamports })) + .sort((x, y) => x.address.localeCompare(y.address)); +} +async function main() { + const { programdata, authority } = await checkNetworkAndProgram(); + const rows = await listOwned(); + console.log(`Devnet OK; Program=${PROGRAM_ID}; authority=${authority}; PDA=${rows.length}; SOL=${rows.reduce((s,x)=>s+x.lamports,0)/1e9}`); + if (rows.length > MAX_ACCOUNTS) fatal(`Найдено больше ${MAX_ACCOUNTS} PDA; скрипт намеренно прекращает работу.`); + if (command === 'verify') { + if (rows.length !== 0) fatal(`Осталось ${rows.length} PDA: ${rows.map(x => x.address).join(', ')}`); + console.log('OK: пользовательских и конфигурационных аккаунтов, принадлежащих программе, нет.'); + return; + } + if (command === 'inspect') { + const ownerString = arg('--authority'); + if (!ownerString) fatal('Укажите --authority с публичным адресом владельца.'); + if (!new PublicKey(ownerString).equals(authority)) fatal('Указанный владелец не является upgrade authority.'); + const manifest = arg('--manifest'); + if (!manifest || existsSync(manifest)) fatal('Укажите новый --manifest путь (не перезаписываем существующий файл).'); + const snapshot = { + purpose: 'destructive-devnet-shine-users-cleanup', genesis: DEVNET_GENESIS, + program: PROGRAM_ID.toBase58(), authority: authority.toBase58(), programdata: programdata.toBase58(), + createdAtUtc: new Date().toISOString(), accounts: rows, + }; + writeFileSync(manifest, JSON.stringify(snapshot, null, 2) + '\n', { flag: 'wx', mode: 0o600 }); + console.log('План сохранён:', manifest); + for (const row of rows) console.log(`${row.address} ${(row.lamports / 1e9).toFixed(9)} SOL`); + console.log('Проверьте список и суммы перед деплоем временной программы и перед execute.'); + return; + } + if (command === 'execute') { + if (!process.argv.includes('--i-understand-irreversible')) fatal('Требуется --i-understand-irreversible'); + const path = arg('--manifest'); + const keypath = arg('--keypair'); + if (!path || !keypath) fatal('Нужны --manifest и --keypair'); + const m = JSON.parse(readFileSync(path, 'utf8')); + const wallet = Keypair.fromSecretKey(Uint8Array.from(JSON.parse(readFileSync(keypath, 'utf8')))); + if (!wallet.publicKey.equals(authority)) fatal('Файл keypair не совпадает с текущей upgrade authority'); + if (m.purpose !== 'destructive-devnet-shine-users-cleanup' || m.genesis !== DEVNET_GENESIS || m.program !== PROGRAM_ID.toBase58() || m.programdata !== programdata.toBase58() || m.authority !== authority.toBase58()) fatal('План создан для другой сети, программы или владельца'); + if (!Array.isArray(m.accounts) || new Set(m.accounts.map(x=>x.address)).size !== m.accounts.length || m.accounts.length > MAX_ACCOUNTS) fatal('Неверный список PDA в плане'); + if (String(m.accounts.length) !== arg('--confirm')) fatal(`Неверный --confirm, должно быть ${m.accounts.length}`); + const currentByKey = new Map(rows.map(x => [x.address, x.lamports])); + const expectedByKey = new Map(m.accounts.map(x => [x.address, x.lamports])); + for (const row of rows) { + if (!expectedByKey.has(row.address) || row.lamports !== expectedByKey.get(row.address)) fatal('Состояние devnet отличается от плана: ' + row.address); + } + // Часть PDA может быть уже закрыта после сбоя связи: пропускаем только исчезнувшие. + const pending = m.accounts.filter(x => currentByKey.has(x.address)); + console.log(`Подтверждено ${m.accounts.length} PDA, осталось закрыть ${pending.length}.`); + for (const [i, item] of pending.entries()) { + const target = new PublicKey(item.address); + const ix = new TransactionInstruction({ + programId: PROGRAM_ID, + keys: [ + { pubkey: authority, isSigner: true, isWritable: true }, + { pubkey: PROGRAM_ID, isSigner: false, isWritable: false }, + { pubkey: programdata, isSigner: false, isWritable: false }, + { pubkey: target, isSigner: false, isWritable: true }, + ], + data: Buffer.from([1]), + }); + const tx = new Transaction().add(ix); + const sim = await c.simulateTransaction(tx, [wallet]); + if (sim.value.err) fatal(`Симуляция НЕ прошла для ${item.address}: ${JSON.stringify(sim.value.err)} ${JSON.stringify(sim.value.logs)}`); + const signature = await sendAndConfirmTransaction(c, tx, [wallet], { commitment: 'confirmed', maxRetries: 3 }); + const after = await c.getAccountInfo(target, 'confirmed'); + if (after) fatal(`Транзакция ${signature} подтверждена, но ${item.address} ещё существует. Остановка.`); + console.log(`[${i+1}/${pending.length}] ЗАКРЫТО ${item.address}; +${item.lamports/1e9} SOL → ${authority.toBase58()}; tx=${signature}`); + } + const remaining = await listOwned(); + if (remaining.length) fatal(`После очистки осталось ${remaining.length} аккаунтов`); + console.log('УСПЕХ: PDA shine_users отсутствуют. СРОЧНО ВОССТАНОВИТЕ ШТАТНЫЙ СМАРТ-КОНТРАКТ.'); + } +} +main().catch(e => { console.error('ОШИБКА:', e.message); process.exitCode = 1; }); diff --git a/shine-solana/shine/tools/temporary-pda-cleaner/scripts/package.json b/shine-solana/shine/tools/temporary-pda-cleaner/scripts/package.json new file mode 100644 index 00000000..a11bba9a --- /dev/null +++ b/shine-solana/shine/tools/temporary-pda-cleaner/scripts/package.json @@ -0,0 +1,14 @@ +{ + "name": "shine-users-devnet-cleaner-cli", + "private": true, + "type": "module", + "version": "0.1.0", + "scripts": { + "inspect": "node cleaner.mjs inspect", + "execute": "node cleaner.mjs execute", + "verify": "node cleaner.mjs verify" + }, + "dependencies": { + "@solana/web3.js": "^1.98.0" + } +} diff --git a/shine-solana/shine/tools/temporary-pda-cleaner/src/lib.rs b/shine-solana/shine/tools/temporary-pda-cleaner/src/lib.rs new file mode 100644 index 00000000..88ec3d3d --- /dev/null +++ b/shine-solana/shine/tools/temporary-pda-cleaner/src/lib.rs @@ -0,0 +1,91 @@ +//! ВРЕМЕННАЯ ОПАСНАЯ ПРОГРАММА. Только для полной очистки тестовых PDA shine_users. +//! Не использовать в mainnet. После очистки ОБЯЗАТЕЛЬНО вернуть штатную программу. +//! +//! Важно: программа деплоится как UPGRADE ПОД ТЕМ ЖЕ Program ID. +//! Отдельный Program ID НЕ МОЖЕТ списывать lamports с PDA старой программы. + +use solana_program::{ + account_info::{next_account_info, AccountInfo}, + bpf_loader_upgradeable, + entrypoint, + entrypoint::ProgramResult, + program_error::ProgramError, + pubkey::Pubkey, +}; + +solana_program::declare_id!("SHiNEPr1APdAgNBteUyBXcNovaHctpSjUu8oH2ZJdN6"); +entrypoint!(process_instruction); + +// [1] CLOSE_ONE: [authority signer writable, executable program readonly, +// ProgramData readonly, PDA writable]. +const CLOSE_ONE: u8 = 1; + +fn process_instruction( + program_id: &Pubkey, + accounts: &[AccountInfo], + data: &[u8], +) -> ProgramResult { + if *program_id != crate::id() || data != [CLOSE_ONE] { + return Err(ProgramError::InvalidInstructionData); + } + + let mut it = accounts.iter(); + let authority = next_account_info(&mut it)?; + let program = next_account_info(&mut it)?; + let programdata = next_account_info(&mut it)?; + let target = next_account_info(&mut it)?; + if it.next().is_some() { + return Err(ProgramError::InvalidArgument); + } + + // Подписант и получатель lamports — ОДИН аккаунт, всегда upgrade authority. + if !authority.is_signer || !authority.is_writable || authority.key == target.key { + return Err(ProgramError::MissingRequiredSignature); + } + if !target.is_writable || target.executable || target.owner != program_id { + return Err(ProgramError::InvalidAccountOwner); + } + + // Проверяем upgrade authority НАСТОЯЩЕЙ программы по состоянию loader-v3. + if program.key != program_id + || !program.executable + || program.owner != &bpf_loader_upgradeable::id() + || programdata.owner != &bpf_loader_upgradeable::id() + { + return Err(ProgramError::IncorrectProgramId); + } + { + let p = program.try_borrow_data()?; + // UpgradeableLoaderState::Program: u32=2, затем адрес ProgramData (32 байта). + if p.len() < 36 || p[..4] != 2u32.to_le_bytes() || p[4..36] != programdata.key.to_bytes() { + return Err(ProgramError::InvalidAccountData); + } + } + { + let p = programdata.try_borrow_data()?; + // UpgradeableLoaderState::ProgramData: u32=3; slot u64; option=1; authority pubkey. + if p.len() < 45 + || p[..4] != 3u32.to_le_bytes() + || p[12] != 1 + || p[13..45] != authority.key.to_bytes() + { + return Err(ProgramError::MissingRequiredSignature); + } + } + + let amount = target.lamports(); + if amount == 0 { + return Err(ProgramError::UninitializedAccount); + } + // Только программа-владелец списывает lamports с target. + // Сумма полностью поступает authority; исторический плательщик может быть другим. + { + let new_balance = authority.lamports() + .checked_add(amount) + .ok_or(ProgramError::ArithmeticOverflow)?; + **authority.try_borrow_mut_lamports()? = new_balance; + } + **target.try_borrow_mut_lamports()? = 0; + target.realloc(0, false)?; + Ok(()) +}