Files
SHiNE-server/docs/Blockchain/42_Public_Content_Identifiers.md
T

3.2 KiB

Публичные идентификаторы содержимого SHiNE (15.11.2026)

  • Публичные вложения и новые аватарки: 32-байтный BitTorrent v2 Pieces Root, текстовая форма — канонический Bitcoin Base58. Это не обычный SHA-256 файла для файлов больше 16 КиБ. Блоки/корень считаются по правилам BitTorrent v2. Base58 чувствителен к регистру: запрещено .toLowerCase().
  • Хранилище: все публичные объекты, включая аватарки, в корне одной R2 корзины shine-files: ключ <PR>, URL https://files.shineup.me/<PR>. Папок avatars/ нет. Прямая загрузка браузером через POST /api/files/prepare + presigned PUT. Подготовка аватара: WebP/JPEG, максимум 768 px, затем вычисление PR от фактически загружаемых байтов.
  • User profile avatar: <S:ava;v=2;sz=12345;pr=<Base58>>; channel avatar: тот же тег в метаданных. В случае Arweave добавляется ;ar=<original Arweave TX ID>. Arweave TX ID не перекодируется (остается Base64URL).
  • Старый аватар SHA-256/hex (v=1) не поддерживается и не переносится. Старые аватары перестанут отображаться без повторной загрузки/перепубликации профиля. Старые каналы не удаляются: старый тег аватара при перестроении индекса пропускается.
  • DM: зашифрованные объекты — SHA-256/Base58 в своей корзине. Никаких изменений в этом патче.
  • На будущее для SHA-256-ID: если вновь вводится публичный объект, идентифицируемый обычным SHA-256, его текстовая форма — Base58(SHA-256(bytes)), без hex; тип хеша обозначается отдельно (sha256 против btv2-pr). SHA-256 и Merkle PR нельзя путать даже при одинаковой длине.
  • База данных: колонка channel_names_state.ava_sha256 переименовывается в ava_pr в миграции v41, прежние значения очищаются; необходим бэкап БД перед выкладкой. Старые поля API avaSha256 / avatarSha256 заменены на avaPr / avatarPr.
  • Безопасность: одно имя <PR> не означает, что Cloudflare самостоятельно проверил Merkle-корень: при работе с недоверенным загрузчиком требуется независимо проверять соответствие содержимого PR. В существующей системе presigned PUT проверяет авторизацию, но не доказывает PR содержимого.