Centram › DocumentationCentram › ドキュメンテーション

Centram Documentation

Centram ドキュメンテーション

Welcome to the Centram documentation. This guide covers everything from initial setup to advanced configuration, economic incentives, and policies.

Centram ドキュメンテーションへようこそ。本ガイドは初期セットアップから高度な設定、経済的インセンティブ、ポリシーまでをカバーします。

What is Centram? Centram is a peer-to-peer decentralized storage system. You encrypt files on your device, split them into chunks, and distribute them across a network of peers. No central server ever holds your unencrypted data.
Centram とは? Centram はピアツーピア分散型ストレージシステムです。デバイス上でファイルを暗号化し、チャンクに分割して、ピアのネットワークに分散させます。中央サーバが平文データを保持することは一切ありません。

System Requirements

システム要件

PlatformプラットフォームMinimum最小Recommended推奨
Desktop4 GB RAM, 2 GB free diskRAM 4 GB、空きディスク 2 GB8 GB RAM, 50+ GB shareableRAM 8 GB、共有可能 50 GB 以上
AndroidAndroid 8.0+ (API 26)Android 12+ with 4 GB RAMAndroid 12+ / RAM 4 GB
iOSiOS 14.0+iOS 16+ with 4 GB RAMiOS 16+ / RAM 4 GB
Web MonitorWeb モニターAny modern browserモダンブラウザ全般Chrome, Safari, Firefox
Storage Note By default, Centram reserves 50 GB of disk space for the operating system. Only space beyond this reserve is available for sharing with the network.
ストレージに関する注意 デフォルトで Centram はオペレーティングシステム用に 50 GB のディスクを確保します。この確保分を超える領域のみがネットワーク共有に利用可能です。

Installation

インストール

Desktop

デスクトップ

Download the latest release for your platform:

お使いのプラットフォーム用の最新リリースをダウンロードしてください:

OSFormat
macOSDMG or ZIP
WindowsInstaller (NSIS) or Portable
LinuxAppImage or DEB

Mobile

モバイル

Install from your device's app store or sideload the APK / IPA directly from the releases page.

デバイスのアプリストアからインストールするか、リリースページから APK / IPA を直接サイドロードしてください。

From Source

ソースからビルド

1

Clone the repository

リポジトリをクローン

git clone https://github.com/centram/centram.git
cd centram
2

Install dependencies

依存関係をインストール

npm install
3

Install the daemon

デーモンをインストール

cd daemon
pip install -e .
4

Build the C++ core (optional, for native crypto)

C++ コアをビルド(オプション、ネイティブ暗号用)

cd core
mkdir build && cd build
cmake ..
make

Quick Start

クイックスタート

1

Start the daemon

デーモンを起動

The daemon is the backend service that handles storage, P2P networking, and blockchain operations.

デーモンはストレージ、P2P ネットワーキング、ブロックチェーン処理を担うバックエンドサービスです。

centram-daemon

You should see output confirming the API is listening and the P2P node is active.

API が待ち受け状態になり、P2P ノードがアクティブになったことを示す出力が表示されるはずです。

2

Launch a client

クライアントを起動

Open whichever client you prefer. All clients connect to the daemon running on your machine.

お好みのクライアントを開いてください。すべてのクライアントは、お使いのマシンで動作しているデーモンに接続します。

# Desktop (Electron)
npm run start:electron

# Desktop (JavaFX)
cd desktop && ./gradlew run

# Web Monitor
cd web-monitor/frontend && npm run dev

# Android
npm run build:android && npm run open:android
3

Upload a file

ファイルをアップロード

Navigate to the Files tab, choose a file, and enter a passphrase. Centram will encrypt, chunk, and distribute it automatically.

ファイルタブに移動し、ファイルを選んでパスフレーズを入力してください。Centram が自動で暗号化、チャンク化、分散を行います。

Daemon Configuration

デーモン設定

The daemon reads its configuration from ~/.centram/config.json. If the file doesn't exist, defaults are used.

デーモンは設定を ~/.centram/config.json から読み込みます。ファイルが存在しない場合はデフォルト値が使われます。

Default Configuration

デフォルト設定

{
  "api_host": "127.0.0.1",
  "api_port": 9740,
  "p2p_port": 9741,
  "data_dir": "~/.centram",
  "reserved_gb": 50,
  "node_type": "storage",
  "subscription_cost": 0.0,
  "accept_24_7_policy": false,
  "bluetooth_fallback": false,
  "bootstrap_peers": []
}

Configuration Options

設定オプション

KeyDefaultDescription
api_port9740Port for the REST API and WebSocket
p2p_port9741Port for peer-to-peer connections
reserved_gb50Disk space reserved for the OS (not shared)
node_type"storage"Node role: "storage", "server", or "database"
subscription_cost0.0Price you charge per GB/month for storage
accept_24_7_policyfalseRequired for server/database nodes
bootstrap_peers[]List of "host:port" peers to connect to on startup

Node Types

ノードタイプ

Every Centram node operates as one of three types. Your node type affects allocation priority, trust rewards, and uptime requirements.

Centram のノードはすべて 3 タイプのいずれかとして動作します。ノードタイプは割り当て優先度、信頼報酬、稼働時間要件に影響します。

Storage (Default)

ストレージ(デフォルト)

Casual participants. Share unused disk space when your device is online. No uptime commitment required. Lowest allocation priority but easiest to run.

カジュアル参加者向け。デバイスがオンライン中に未使用ディスク領域を共有します。稼働時間のコミットメント不要。割り当て優先度は最低ですが運用が最も簡単です。

Server

サーバー

Always-on hosting nodes with highest allocation priority. Server nodes commit to the 24/7 Uptime Policy and must remain online at all times. Downtime results in trust score penalties. Best for dedicated machines or VPS instances.

常時稼働のホスティングノード。最高の割り当て優先度を持ちます。サーバーノードは 24/7 稼働ポリシーにコミットし、常時オンライン必須。ダウンタイムは信頼スコアにペナルティをもたらします。専用マシンや VPS インスタンスに最適。

Database

データベース

Persistent data nodes with medium allocation priority. Like servers, database nodes require the 24/7 policy. Designed for nodes that store large volumes of indexed data.

永続データノード。中程度の割り当て優先度を持ちます。サーバーと同様、24/7 ポリシーが必要。大量のインデックス済みデータを保持するノード向け。

Changing Node Type You can change your node type at any time via the Cloud/Node settings in any client or the API. Switching to Server or Database requires accepting the 24/7 Uptime Policy.
ノードタイプの変更 ノードタイプはいつでも、各クライアントの Cloud/Node 設定または API から変更可能です。Server または Database への切替には 24/7 稼働ポリシーへの同意が必要です。

Storage Configuration

ストレージ設定

Data Directory

データディレクトリ

All Centram data is stored under ~/.centram/ by default:

Centram の全データはデフォルトで ~/.centram/ 配下に保存されます:

~/.centram/
  chunks/               Encrypted file chunks (256-way fan-out)
  chain/                Blockchain data
  trust_scores.json     Peer trust records
  config.json           Your configuration

Chunk Storage

チャンクストレージ

Files are split into 4 MB chunks, encrypted individually, and stored in a fan-out directory structure. The first two hex characters of each chunk's SHA-256 hash determine the subdirectory (256 possible directories), ensuring efficient file system lookup.

ファイルは 4 MB チャンクに分割され、個別に暗号化されてファンアウトディレクトリ構造に保存されます。各チャンクの SHA-256 ハッシュの最初の 2 桁が(256 通りの)サブディレクトリを決定し、効率的なファイルシステム検索を実現します。

Reserved Space

予約領域

The reserved_gb setting (default: 50 GB) tells Centram how much disk space to leave free for the operating system and other applications. Only space beyond this reserve is available for the network.

reserved_gb 設定(デフォルト 50 GB)は、OS や他アプリのために空けておくディスク容量を Centram に伝えます。この予約分を超えた領域のみがネットワーク提供に使われます。

Replication

レプリケーション

Every chunk is replicated to 3 independent peers. The replication manager checks for under-replicated chunks every 60 seconds and automatically repairs them by pushing copies to new peers.

すべてのチャンクは独立した 3 ピアにレプリケーションされます。レプリケーションマネージャは 60 秒ごとに不足チャンクを検出し、新規ピアへコピーを送信して自動修復します。

Networking

ネットワーキング

Connecting to Peers

ピアとの接続

Centram discovers peers through:

Centram は次の方法でピアを発見します:

Firewall

ファイアウォール

If you're behind a firewall or NAT, ensure port 9741 (P2P) is open for incoming connections. The API port (9740) only needs to be accessible from localhost.

ファイアウォールや NAT の背後にある場合、受信接続用にポート 9741(P2P)を開放してください。API ポート(9740)は localhost からのアクセスのみで十分です。

Relay Support If direct connections aren't possible, Centram can relay data through other peers using the circuit relay protocol. This is handled automatically.
リレーサポート 直接接続できない場合、Centram はサーキットリレープロトコルで他ピア経由のデータ中継を行います。自動処理されます。

CenTrust Score

CenTrust スコア

CenTrust is Centram's reputation system. Every peer starts with a score of 50 (range: 0–100). Your score reflects your reliability on the network.

CenTrust は Centram のレピュテーションシステムです。各ピアはスコア 50(範囲 0~100)からスタートします。スコアはネットワーク上での信頼性を反映します。

How Your Score Changes

スコアの変動要因

EventEffectDescription
Storage proof success+0.5You proved you hold a chunk when challenged
Storage proof failure-5.0You failed to prove chunk possession
Uptime tick (per hour)+0.1Earned for each hour your node stays online
Downtime penalty (per hour)-2.024/7 nodes only — when your node goes offline
Successful transfer+0.2You completed a chunk transfer to another peer
Failed transfer-1.0A transfer to/from your node failed

Trust Levels

信頼レベル

ScoreLevelGas Discount
80 – 100Trusted40% – 50%
60 – 79Reliable30% – 39%
40 – 59Normal20% – 29%
0 – 39Low0% – 19%

Benefits of High Trust

高信頼スコアの恩恵

Gas Fees

ガス手数料

Every storage transaction incurs a 5% base gas fee. This fee is paid to the block miner who validates the transaction.

すべてのストレージトランザクションには 5% の基本ガス手数料がかかります。これはトランザクションを検証するブロックマイナーに支払われます。

How Gas is Calculated

ガス計算方法

Base gas rate:       5%
Trust discount:      (your_score / 100) × 50%
Effective rate:      5% × (1 - trust_discount)

Example (trust score = 80):
  Trust discount  = (80 / 100) × 50% = 40%
  Effective rate  = 5% × (1 - 0.40) = 3%
  On a 100 unit tx: gas = 3 units, you pay 97
Maximize Savings Stay online, complete transfers reliably, and pass storage proofs to build trust and minimize your gas costs. A perfect score of 100 gives you a 50% discount (2.5% effective rate).
節約を最大化 常時オンラインを保ち、転送を確実に完了し、ストレージ証明をパスして信頼を積み、ガスコストを最小化してください。スコア 100 満点なら 50% 割引(実効レート 2.5%)。

Subscription Pricing

サブスクリプション料金

As a storage sharer, you set your own price per GB per month. This is the amount peers pay you for storing their data on your node.

ストレージ提供者として、自分で GB あたり月額料金を設定します。これはピアがあなたのノードにデータを保存するために支払う金額です。

Setting Your Price

価格の設定

Pricing Strategy

価格戦略

Price Discovery The marketplace shows all active sharers with their pricing, trust score, and available capacity. Peers can compare options before choosing where to store.
価格の発見 マーケットプレイスは、稼働中の全提供者の価格、信頼スコア、利用可能容量を表示します。ピアは保存先を選ぶ前に選択肢を比較できます。

Marketplace

マーケットプレイス

The Centram marketplace lists all peers offering storage. It's accessible through the web monitor or any client's Economics section.

Centram マーケットプレイスはストレージを提供する全ピアを掲載します。Web モニターまたは各クライアントのエコノミクスセクションからアクセス可能です。

Each listing shows:

各リスティングには次の情報が表示されます:

Encryption

暗号化

Centram uses a multi-layered envelope encryption scheme to ensure only you can access your files. Even the computer storing your data cannot read it.

Centram は多層エンベロープ暗号化方式を採用し、ファイルにアクセスできるのは本人だけになるよう保証します。データを保管するコンピュータでさえ読み取れません。

Key Hierarchy

鍵の階層

Passphrase
  ↓ PBKDF2-SHA256 (100,000 iterations + random salt)
Master Key (256-bit)
  ↓ HKDF-SHA256 (per-file info)
KEK (Key Encryption Key) — wraps the DEK
  ↓
DEK (Data Encryption Key) — random per file, encrypts chunks
  ↓ HKDF-SHA256 (per-chunk index)
Per-Chunk Key — unique AES-256-GCM key for each chunk

Encryption Pipeline

暗号化パイプライン

  1. Key Derivation — Your passphrase is run through PBKDF2-SHA256 (100,000 iterations) with a random salt to produce a 256-bit master key.
  2. Envelope Creation — Each file gets a random DEK (Data Encryption Key). The DEK is wrapped (encrypted) by a KEK derived from your master key. The wrapped DEK is stored as a KeyEnvelope alongside the file metadata.
  3. Per-Chunk Keys — Each chunk gets its own key, derived from the DEK using HKDF-SHA256 with the chunk index. This provides defense-in-depth: compromising one chunk key does not compromise others.
  4. Encryption — Each chunk is encrypted with AES-256-GCM using a random 12-byte nonce. Output: [Nonce (12B) | Ciphertext | Auth Tag (16B)]
  5. Integrity Hash — A BLAKE3 hash of each sealed chunk is computed. Storage nodes use this to verify integrity without decrypting.
Your Passphrase is Everything Centram never stores your passphrase or encryption keys. If you lose your passphrase, your files are permanently unrecoverable. There is no "forgot password" option. Back up your wallet or passphrase securely.
パスフレーズが全て Centram はパスフレーズや暗号鍵を一切保存しません。パスフレーズを失うとファイルは永久に復元不能になります。「パスワードを忘れた」のオプションはありません。ウォレットまたはパスフレーズは安全にバックアップしてください。

Secure Memory Handling

セキュアメモリ取扱

All key material uses SecureKey types that are automatically zeroized in memory when dropped. Keys never persist in plaintext beyond their scope.

すべての鍵素材は SecureKey 型を使用し、ドロップ時にメモリ上で自動的にゼロ化されます。鍵がスコープ外で平文として残ることはありません。

Zero-Knowledge Storage

ゼロ知識ストレージ

Centram is zero-knowledge by design. Storage nodes hold encrypted chunks but have absolutely no ability to decrypt them — even the operator of the storage node cannot read the data on their own computer.

Centram は設計上ゼロ知識です。ストレージノードは暗号化チャンクを保持しますが、それらを復号する能力は一切ありません ─ ストレージノードの運用者でさえ、自分のコンピュータ上のデータを読めません。

How It Works

仕組み

  1. Client-side encryption — All encryption happens on the file owner's device before chunks are sent to the network.
  2. No key transmission — Encryption keys are never sent to storage nodes. Nodes receive only ciphertext + integrity hashes.
  3. Envelope separation — The KeyEnvelope (wrapped DEK) is stored separately from chunk data. Even with both, you need the master key to unwrap the DEK.
  4. Storage node verification — Nodes can verify chunk integrity via BLAKE3 hashes without any access to plaintext or keys.

What Storage Nodes See

A storage node receives a SealedChunk containing: encrypted ciphertext (random-looking bytes), a chunk index, a BLAKE3 hash for integrity, and the original size for quota accounting. No plaintext, no keys, no file metadata.

Tamper Detection

Every sealed chunk includes a BLAKE3 integrity hash. If a storage node (or attacker) modifies even a single byte of the ciphertext, the hash check fails, and the AES-GCM authentication tag will also reject the data. Tampering is detected at two independent layers.

Key Sharing (X25519)

鍵共有 (X25519)

Centram uses X25519 Elliptic Curve Diffie-Hellman for secure file sharing between users, without ever exposing encryption keys to the network.

Centram はユーザ間のセキュアなファイル共有に X25519 楕円曲線 Diffie-Hellman を使用し、暗号鍵をネットワークに露出させません。

How File Sharing Works

ファイル共有の仕組み

  1. Every Centram user has an X25519 keypair (public + secret key).
  2. When Alice wants to share a file with Bob, she computes a shared secret: ECDH(Alice_secret, Bob_public)
  3. Alice wraps the file's DEK with the shared secret using AES-256-GCM, creating a KeyGrant.
  4. The KeyGrant is sent to Bob (can be transmitted publicly — only Bob can unwrap it).
  5. Bob computes the same shared secret: ECDH(Bob_secret, Alice_public) and recovers the DEK.
No Key Server Required Key sharing is peer-to-peer. The shared secret is computed independently by both parties using Diffie-Hellman. No central key server or certificate authority is involved.
鍵サーバ不要 鍵共有はピアツーピアで行われます。共有秘密は Diffie-Hellman により両者が独立に計算します。中央鍵サーバや認証局は介在しません。

Key Grants

鍵グラント

A KeyGrant contains: the wrapped DEK, the sender's public key, the file ID, and an optional expiry timestamp. Grants can be revoked by the file owner by re-encrypting the file with a new DEK.

KeyGrant にはラップ済み DEK、送信者の公開鍵、ファイル ID、オプションの有効期限タイムスタンプが含まれます。ファイル所有者は新しい DEK で再暗号化することでグラントを失効できます。

Wallet Integration

ウォレット連携

Centram nodes can derive their cryptographic identity from existing cryptocurrency wallets, linking your blockchain address to your Centram node.

Centram ノードは既存の暗号資産ウォレットから暗号学的アイデンティティを導出でき、ブロックチェーンアドレスと Centram ノードをリンクできます。

Supported Wallets

対応ウォレット

WalletChainConnection Method
MetaMaskEthereum / EVMBrowser extension or WalletConnect
Trust WalletEthereum / EVMWalletConnect
Coinbase WalletEthereum / EVMWalletConnect
LedgerEthereum / EVMUSB / Bluetooth
PhantomSolanaBrowser extension
WalletConnectMulti-chainQR code / deep link

How Wallet Linking Works

ウォレット連携の仕組み

  1. The Centram app presents a deterministic message for signing.
  2. You sign the message with your wallet (no funds are transferred).
  3. The signature is used as seed material for HKDF, deriving three Centram keys:
    • X25519 key — for file sharing and key exchange
    • Ed25519 key — for node identity and signing
    • Master key — for envelope encryption
  4. Your Ethereum/Solana address is linked to your Centram node identity.
Wallet Security No private keys are ever extracted from your wallet. Only the signature of a specific message is used. The same wallet always produces the same Centram identity, so you can restore your node on any device.
ウォレットセキュリティ ウォレットから秘密鍵を抽出することは一切ありません。特定メッセージの署名のみを使用します。同じウォレットは常に同じ Centram アイデンティティを生成するため、どのデバイスでもノードを復元できます。

Supported Chains

対応チェーン

Ethereum Mainnet (1), Polygon (137), Arbitrum (42161), Optimism (10), Base (8453), BSC (56), and Solana.

Ethereum Mainnet (1)、Polygon (137)、Arbitrum (42161)、Optimism (10)、Base (8453)、BSC (56)、Solana。

Node Tiers

ノード階層

Every Centram node is automatically classified into a tier based on its hardware specifications. Higher tiers can store more data types, share more bandwidth, and earn higher rewards.

すべての Centram ノードはハードウェアスペックに基づき自動的に階層分類されます。上位階層ほど多種のデータタイプを保管でき、帯域提供量が多く、報酬倍率も高くなります。

TierCPU CoresRAMFree DiskNetworkMax CPU UsageReward Multiplier
Light1+4 GB10 GB10 Mbps≤ 95%1x
Standard4+8 GB100 GB50 Mbps≤ 85%2x
Power8+16 GB500 GB100 Mbps≤ 75%4x
Enterprise16+32 GB1 TB500 Mbps≤ 60%8x

Content Type Restrictions

コンテンツタイプ制限

Tiers are re-evaluated in real time based on system metrics. Your tier may change as your CPU load, available disk space, or network conditions change.

階層はシステムメトリクスに基づきリアルタイムで再評価されます。CPU 負荷、空きディスク容量、ネットワーク状態の変化により階層も変わります。

Category Quotas

カテゴリ別クォータ

To prevent any single data type from dominating a node's storage, Centram enforces per-category quotas. Each of the 12 content categories has a maximum percentage of a node's total capacity.

単一データタイプがノードストレージを支配しないよう、Centram はカテゴリ別クォータを強制します。12 のコンテンツカテゴリそれぞれに、ノード総容量の最大割合が設定されています。

CategoryMax ShareDescription
Video30%Largest files, capped to prevent domination
Images25%Common uploads, moderate cap
Datasets20%AI/ML training data
ML Models20%Trained model weights
Archives20%ZIP/tar bundles
Audio15%Music, podcasts, recordings
Documents15%PDFs, office files
CDN Cache15%Edge-cached content
Text10%Plain text, code, logs
Config5%Configuration files
Metadata5%File and chunk metadata
Relay10%Relay traffic buffering

When a category reaches its quota, new chunks of that type are routed to other nodes with available capacity. The node continues to accept other categories normally.

あるカテゴリがクォータに達すると、そのタイプの新規チャンクは余裕のある他ノードへルーティングされます。ノードは他カテゴリを通常通り受け入れ続けます。

Anti-Concentration Placement

集中防止配置

Centram's placement engine prevents data from concentrating on a small number of nodes, ensuring network resilience and fair distribution.

Centram の配置エンジンは、データが少数ノードに集中しないようにし、ネットワークのレジリエンスと公平な分散を保証します。

Placement Algorithm

配置アルゴリズム

  1. Filter — Exclude nodes that cannot accept the chunk (quota full, category disallowed, or node holds >10% of network data).
  2. Score — Rank remaining nodes: lower fill ratio (35%), lower category fill (35%), higher trust score (20%), higher tier (10%).
  3. Diversify — Select top nodes from different network segments first, then fill remaining slots regardless of segment.
  4. Replicate — Ensure minimum replication factor per category (critical data: 5 copies, standard: 3–4 copies).

Network Share Limit

ネットワークシェア上限

No single node may hold more than 10% of the network's total chunks. Nodes exceeding this limit are flagged for redistribution, with overloaded chunks migrated to emptier nodes.

単一ノードはネットワーク総チャンクの 10% を超えて保有できません。この上限を超えたノードは再配置対象となり、過負荷チャンクは空きのあるノードへ移行されます。

Replication Factors

レプリケーション係数

CategoryMin Replicas
Text, Metadata, Config5
Documents, Datasets, ML Models4
Images, Archives, Audio, Video3
Relay, CDN Cache2

Storage Proofs

ストレージ証明

Centram uses Proof of Storage (PoSt) to verify that peers actually hold the data they claim. This prevents free-riding and ensures data integrity.

Centram は Proof of Storage (PoSt) を使用し、ピアが主張通りのデータを実際に保有していることを検証します。これによりフリーライドを防ぎ、データ整合性を保証します。

How It Works

  1. A challenge is derived from the previous block hash and a chunk hash
  2. The challenged node must produce a proof by hashing the challenge with the actual chunk data
  3. The proof is verified by miners and recorded on the blockchain
  4. Successful proofs increase your trust score; failures decrease it

Blockchain

ブロックチェーン

Centram's blockchain is a lightweight chain optimized for storage operations. It records all allocations, storage proofs, trust updates, and economic transactions.

Centram のブロックチェーンは、ストレージ操作に最適化された軽量チェーンです。すべての割当、ストレージ証明、信頼更新、経済トランザクションを記録します。

Consensus

コンセンサス

Blocks are mined using Proof of Storage rather than Proof of Work. This means mining rewards go to nodes that prove they store data, not nodes that waste energy on hash puzzles.

ブロックは Proof of Work ではなく Proof of Storage でマイニングされます。マイニング報酬は、ハッシュパズルにエネルギーを費やすノードではなく、データ保管を証明するノードに支払われます。

What Gets Recorded On-Chain

オンチェーンに記録される内容

Decentralized Cybersecurity Force

分散型サイバーセキュリティ部隊

Centram includes a fully decentralized cybersecurity system where network peers collectively detect, vote on, and block malicious actors. All security actions are recorded on a SHA-256 hash chain, creating an immutable audit trail.

Centram には完全分散型のサイバーセキュリティシステムが組み込まれており、ネットワークピアが協力して悪意あるアクターを検出、投票、ブロックします。すべてのセキュリティアクションは SHA-256 ハッシュチェーンに記録され、不変の監査証跡を構成します。

How It Works

  1. Detection — Sentinel nodes monitor peer connections in real time, analyzing connection rates, subnet density, and disconnection patterns to identify threats (DDoS, Sybil attacks, Eclipse attacks, etc.).
  2. Reporting — Detected threats are broadcast to the network and recorded on the security blockchain with a SHA-256 hash linking each block to the previous.
  3. Voting — Peers with sufficient trust scores vote to block or unblock suspicious nodes. Consensus is required before any peer is blocked network-wide.
  4. Defense — When a node is attacked, nearby nodes in the same region automatically form a defense coalition, lending bandwidth and processing power to absorb the threat.

Threat Types Detected

検出可能な脅威タイプ

Security Blockchain

セキュリティブロックチェーン

Every security action (threat report, vote result, peer block/unblock, sentinel reward) is recorded as a block on a dedicated security chain. Each block contains:

すべてのセキュリティアクション(脅威レポート、投票結果、ピアブロック/解除、センチネル報酬)は専用セキュリティチェーンのブロックとして記録されます。各ブロックには以下が含まれます:

Block {
  blockHash:        SHA-256(prevHash + action + target + consensus + timestamp + nonce)
  prevBlockHash:    SHA-256 hash of the previous block
  actionType:       "threat_report" | "block_peer" | "unblock_peer" | "vote_result" | ...
  target:           Peer ID or IP address
  consensusPercent: Percentage of voters who agreed
  timestamp:        Unix timestamp (ms)
  nonce:            Random nonce for hash uniqueness
}

Sentinel Nodes

センチネルノード

A Sentinel Node is a specialized node role focused on network security. Sentinels earn rewards for accurate threat detection and participate in community voting.

センチネルノードはネットワークセキュリティに特化した専門役割です。センチネルは正確な脅威検出で報酬を獲得し、コミュニティ投票に参加します。

Sentinel Node Role

Enable Sentinel mode in the Security → Sentinel tab of any Centram client. Requires a stake of 400 credits and 24/7 uptime for optimal detection.

Detection Sensitivity

検出感度

Sentinel nodes support three sensitivity levels that control how aggressively threats are flagged:

センチネルノードは脅威フラグの積極性を制御する 3 段階の感度レベルをサポートします:

Real-Time System Monitoring

リアルタイムシステム監視

The security system reads real system resources from the host machine:

セキュリティシステムはホストマシンの実システムリソースを読み取ります:

Collective Defense

集団防衛

When a node is attacked, other nodes in the same blockchain region automatically rally to defend it. This is Centram's "immune system" — decentralized, automatic, and proportional to the threat.

あるノードが攻撃を受けると、同じブロックチェーン領域内の他ノードが自動的に集結して防衛します。これが Centram の「免疫系」 ─ 分散型・自動的・脅威の規模に比例した動作です。

How Coalitions Form

連合の形成方法

  1. A threat is detected targeting a specific node
  2. The threat report is broadcast via gossipsub to regional peers
  3. Nearby sentinel nodes evaluate the threat and join the defense coalition
  4. Each defender contributes bandwidth (Mbps) and processing power (%)
  5. The coalition absorbs the attack traffic until the threat is mitigated or the attacker is blocked via consensus vote

Resource Contribution

リソース提供

Each defending node contributes based on its available resources, read directly from the host system:

各防衛ノードはホストシステムから直接読み取った利用可能リソースに基づいて貢献します:

Rewards Sentinel nodes that participate in successful defense coalitions earn credit rewards proportional to their contribution. Accurate threat reports also earn rewards, while false positives may reduce trust score.
報酬 防衛連合の成功に参加したセンチネルノードは、貢献に比例したクレジット報酬を獲得します。正確な脅威レポートにも報酬がありますが、誤検出は信頼スコアを下げる可能性があります。

Privacy Policy

プライバシーポリシー

Data We Never Collect

収集しないデータ

Data That Exists on the Network

ネットワーク上に存在するデータ

Encryption Guarantee

暗号化の保証

All file data is encrypted client-side before leaving your device. No peer, relay, or server on the network can read your files. Even if every other node on the network colluded, they could not access your data without your passphrase.

すべてのファイルデータはデバイスから出る前にクライアント側で暗号化されます。ネットワーク上のどのピア、リレー、サーバもファイルを読めません。ネットワーク上の他全ノードが結託しても、パスフレーズなしではデータにアクセスできません。

Terms of Use

利用規約

Acceptable Use

許容される利用

By using Centram, you agree to:

Centram を利用することで、以下に同意したものとみなします:

Liability

免責事項

Centram is open-source software. The developers are not responsible for data loss, service interruption, or any damages arising from the use of this software. You are solely responsible for your passphrase and data backups.

Centram はオープンソースソフトウェアです。開発者は本ソフトウェアの利用に起因するデータ損失、サービス中断、その他の損害に対して責任を負いません。パスフレーズおよびデータバックアップは利用者の責任です。

Data Responsibility

データ責任

As a storage sharer, you store encrypted chunks on behalf of other peers. You cannot see or access the content of these chunks. You are not responsible for their content.

ストレージ提供者として、他ピアに代わり暗号化チャンクを保管します。これらのチャンクの内容は閲覧・アクセスできません。利用者はその内容について責任を負いません。

24/7 Uptime Policy

24/7 稼働ポリシー

Server and Database nodes must accept the 24/7 Uptime Policy. This is a commitment to keep your node online at all times.

Server および Database ノードは 24/7 稼働ポリシーに同意する必要があります。これはノードを常時オンラインに保つことへのコミットメントです。

Requirements

要件

Penalties

ペナルティ

Opting Out

オプトアウト

You can switch back to a Storage node at any time, which removes the 24/7 requirement. However, this also reduces your allocation priority.

いつでも Storage ノードへ戻すことができ、24/7 要件は解除されます。ただし割当優先度も低下します。

API Reference

API リファレンス

The daemon exposes a REST API at http://127.0.0.1:9740. All endpoints are prefixed with /api.

デーモンは http://127.0.0.1:9740 で REST API を公開します。すべてのエンドポイントは /api プレフィックスを持ちます。

Status & Info

ステータス & 情報

MethodEndpointDescription
GET/api/statusNode status, peer count, chain height, trust
GET/api/storageDisk usage stats
GET/api/peersConnected peers list
GET/api/filesLocal file chunks

Node Configuration

ノード設定

MethodEndpointDescription
GET/api/node/typeCurrent node type and policy
POST/api/node/typeSet node type + accept policy
GET/api/node/subscriptionCurrent subscription price
POST/api/node/subscriptionSet subscription price

Trust & Economics

信頼 & エコノミクス

MethodEndpointDescription
GET/api/trust/selfYour trust score and gas discount
GET/api/trust/{peer_id}A peer's trust info
GET/api/trust/leaderboardTop trusted peers
GET/api/gas/estimate?amount=XGas fee estimate
GET/api/economics/summaryFull economics overview
GET/api/marketplace/sharersBrowse sharers

Blockchain

ブロックチェーン

MethodEndpointDescription
GET/api/blockchain/statusChain height and validity
GET/api/blockchain/blocksPaginated block list
GET/api/blockchain/block/{n}Single block by height
POST/api/uploadUpload file (multipart + passphrase)

WebSocket

WebSocket

Real-time events are available at ws://127.0.0.1:9740/ws.

リアルタイムイベントは ws://127.0.0.1:9740/ws で利用可能です。

Ports & Endpoints

ポート & エンドポイント

PortServiceBindingNotes
9740REST API + WebSocketlocalhostClient-daemon communication
9741P2P Node0.0.0.0Open this port for incoming peer connections

FAQ

FAQ

Can I recover my files if I lose my passphrase?

パスフレーズを失った場合、ファイルは復元できますか?

No. Centram is zero-knowledge by design. Your passphrase is never stored anywhere. Without it, your encryption keys cannot be derived and your files are permanently lost.

いいえ。Centram は設計上ゼロ知識です。パスフレーズはどこにも保存されません。それなしでは暗号鍵を導出できず、ファイルは永久に失われます。

What happens if peers storing my data go offline?

データを保管しているピアがオフラインになった場合は?

Every chunk is replicated to 3 peers. If one goes offline, the replication manager automatically detects the under-replication and pushes the chunk to a new peer. Your data is safe as long as at least one copy remains available.

すべてのチャンクは 3 ピアにレプリケーションされます。1 つがオフラインになると、レプリケーションマネージャが自動的に不足を検出し、新規ピアへチャンクを送信します。少なくとも 1 コピーが残っている限りデータは安全です。

Can storage nodes read my files?

No. All chunks are encrypted with AES-256-GCM using per-chunk keys derived from your personal master key. Storage nodes only hold sealed ciphertext + BLAKE3 integrity hashes. Even the node operator cannot decrypt the data on their own machine.

How much can I earn by sharing storage?

Earnings depend on your subscription price, available capacity, trust score, and network demand. You set your own price and the marketplace determines how competitive it is.

Do I need a static IP address?

No. Centram supports relay connections for peers behind NAT or firewalls. However, a static IP or open port 9741 will improve your connectivity and peer discovery.

Is there a minimum storage requirement?

No. You can share as little or as much as you want. The reserved_gb setting ensures your OS always has enough space.

Can I use my existing crypto wallet?

Yes. Centram supports MetaMask, Trust Wallet, Coinbase Wallet, Ledger, Phantom (Solana), and any WalletConnect-compatible wallet. Your wallet signs a message to derive your Centram identity — no funds are transferred and no private keys leave your wallet.

How do I share an encrypted file with someone?

Centram uses X25519 key exchange. You create a KeyGrant that wraps the file's encryption key with a shared secret derived from your key and the recipient's public key. Only the intended recipient can unwrap it. No central key server is needed.


Need help? Check the GitHub issues page or join the community. Centram is open source and community-driven.