Kaspa P2P File Storage v7.1.3

📖 Guide

What is Kaspa P2P File Storage?

Kaspa P2P File Storage is a decentralized file storage system built on the Kaspa blockchain. Files are encrypted and stored directly on the blockchain using transaction payloads.

Decentralized: No central server - files stored on blockchain
Encrypted: AES-256-GCM encryption with password protection
Permanent: Once uploaded, files remain on blockchain forever
Networks: Supports Mainnet (production) and Testnet-10 (testing)

Quick Start: Download

Check Status tab - Network connection is established automatically on page load
Go to Download tab
Enter download info: TxID:BlockID:Password
Click Verify → Click Download

Download Availability by Connection Type:

Full Node: Recent files (~30 hours, before pruning)
Archive Node: Files up to displayed retention period
api.kaspa.org: All files (Community service - please minimize load)
kas.fyi: All files (Recommended - Enterprise-grade service)

💡 Recommended: Use kas.fyi to reduce load on community-run api.kaspa.org service. Requires API key from kas.fyi.

No wallet required for downloading files.

Quick Start: Upload

Check Status tab - Confirm Full Node is connected (required for upload)
Go to Settings tab → Enter your private key → Connect wallet
Go to Upload tab → Select file → Set password
Click Upload → Save the TxID:BlockID:Password

Requires Full Node connection and wallet with KAS balance for transaction fees.

FAQ (Frequently Asked Questions)

💰 How much does upload cost?

Upload cost is miner fees only (approximately 1 KAS per 100MB uncompressed).
• Actual cost: Only transaction fees (~0.0003 KAS per 20KB chunk)
• Transaction amount returns to yourself - only fees are consumed
• With compression (if applicable): Cost can be further reduced
• Rewards go to miners only - Kaspa currently has no rewards for archive nodes

📥 Is download free?

Yes, download is completely free.
No wallet or KAS balance required for downloading files.

📊 What is the maximum file size? Can I upload large files?

Yes, large files are supported - basically unlimited with chunked upload system:

How it works:
• Files are split into chunks (~22KB per chunk)
• Progress is automatically saved
• Resume from last checkpoint if interrupted

Size limits:
• When using MetaTxID: Limited to 25,600 transactions
→ Approximately 560MB maximum data size (25,600 × 22KB)
• For larger files: Use multiple MetaTxIDs or alternative methods

Recommended: Consolidate UTXOs before uploading files >1MB

🏗️ Is this an L2 service?

No, this is a Layer 1 (L1) service.
• All communication and data storage are on Kaspa L1 blockchain
• Files are stored directly in transaction payloads on-chain
• API services (api.kaspa.org, kas.fyi) are third-party services for convenience
• Core functionality operates purely on Kaspa blockchain

📄 What is the file format specification?

The complete file format specification is documented in:
KASPA_FILE_FORMAT.md

Includes details on:
• Metadata structure (KENV format)
• Transaction payload format
• Chunk organization and boundaries
• Directory structure format

📊 Status

🌐 Network Connection Status

Full Node: Not Connected

Node: -

Used for file uploads and downloading recent data before pruning

Archive Node: Not Connected

Status: -

Connections: 0/5

Server: -

Version: -

Blocks: -

Dedicated nodes with extended block history. Required for downloading old files.
Display days and actual storage duration differ - maintains longer history than shown.

api.kaspa.org (REST API) Fallback: Not Checked

Endpoint: -

Response: -

Alternative when Kaspa network is unavailable. Community service.

kas.fyi (Kaspa Developer Platform) Priority Fallback: Not Configured

API Key: Not Set

Alternative when Kaspa network is unavailable.
Enterprise-grade service by kas.fyi. Requires API key from kas.fyi.

💰 Wallet Status

This service writes data to the transaction payload during self-transfer of $KAS, recording data in the blockchain. Wallet connection and $KAS are only required for uploads. Upload cost is miner fees only. For download-only usage, wallet connection is not required.

Status: Disconnected

Address: -

Balance: -

⚙️ Please connect wallet from Settings tab

📁 Workspace

Workspace: Not Set (Browser Storage)

📂 File Management

	Icon	File Name ↑	Size	MetaTxID	Date
	📄	sample.txt	1.2 KB	Qm...	a1b2c3...	kaspa:...	12/25	12/25
	📁	docs	5.3 MB	Qm...	-	kaspa:...	12/24	12/24

📁 File Upload

📁 Select File
or drag & drop

🔑 Password (8+ characters)

📥 Download

📋 Supported formats (File/Directory):
• Recommended: TxID:BlockID:Password (fastest, no API needed)
• Alternative: TxID:BlockID (fast, password entered separately)
• Fallback: TxID only (slower, uses REST API)

─ or ─

🔗 Restore from MetaTxID (Legacy)

📌 Supported Formats:

TxID:BlockID:Password format (password auto-filled)
TxID:BlockID format (Recommended, no REST API needed)
TxID only (REST API required)

📁 Drop or click to load .kaspa file

🛠️ Directory Builder

📥 Import

Directory Name:

Add Entry (TxID:BlockID:Password):

※ Automatically detects metadata type

Directory Structure:

🌳 { }

📄 Files: 0 📁 Directories: 0 💾 Total Size: 0 MB

Password Protection (Required):

⚙️ Settings

🚀 Session Setup

💰 Wallet & UTXO Management

Private Key

Status: Disconnected

Address:

-

Balance: -

📁 Workspace Settings

Workspace: Not Set (Browser Storage) ❓

Setting a workspace allows automatic saving of progress files and continuation of work even after closing the browser.

🗄️ Archive Node Discovery

Archive Monitor | - | -

Network: -

Threshold: M blocks

(0.864M = 1 day)

Max Consecutive Failures: times

(Stops on consecutive non-archive node detection)

Search: Not Started
Connect: [-----] 0/5 | Avg: -
Checking: Waiting

Waiting for connection...

Recent events:

No events

⚙️ Preferences

🎨 Theme Settings

Theme

Switch application appearance

Network Settings

Network Node Type

REST API Settings

Enable REST API

⚠️ REST API is third-party. Disabling will use only Kaspa L1.
Privacy-conscious users should disable it.

Status: Enabled

🔐 Privacy Settings

Save passwords for automatic download

When disabled, you'll need to enter the password each time you download a file. This provides better security but less convenience.

⚠️ This will permanently remove all saved passwords from all entries. This action cannot be undone.

🔧 Kaspa Developer Platform (kas.fyi)

Enterprise-grade API for fast transaction data retrieval. No need to run your own node. When configured, serves as priority fallback for downloading files. Get your API key at docs.kas.fyi

API Key (kdp_...)

💸 Transaction Amount Settings

Transaction Amount (KAS)

KAS

⚠️ Amount for recording data on blockchain.
Recommended: 0.2-1 KAS (Too small will cause errors)
Actual cost: Only fees (about 0.0003 KAS per 20KB)
※ Amount returns to yourself, only fees are consumed

Current setting: 1 KAS

📊 WebSocket Configuration

📊 WebSocket Statistics

Retry Count Confirmation Timeout (seconds) Maximum wait time for transaction confirmation (Default: 300 seconds)

Download Settings

Parallel Download (Experimental)
Use 8 parallel connections for files with 10+ chunks

REST API Test Mode
Skip RPC and download via REST API

Force Archive Node
Searching for archive nodes...

🔄 Kaspa System Restart

Restart WASM SDK and Kaspa core.js for a clean state.
Try this when you have connection errors or malfunctions.

📤 Upload Settings

Chunk Size

Use MetaTxID (Recommended: Easy to share from history)

Use Random CID (Censorship Resistance)

🐛 Debug Log

🔐 WASM SDK Security Features Investigation

Investigate available security methods in Kaspa WASM SDK for protecting Private Keys

Click buttons above to investigate WASM SDK capabilities...

🛡️ CSP Violation Monitor

Monitors Content Security Policy violations (Report-Only mode)

Violations: 0

No CSP violations detected yet...

🔌 Multiple WebSocket Test (Experimental)

Test feature to listen for Block-added events on multiple nodes to improve BlockID detection speed

Status: Disconnected

🚫 Block Event Filter

⚠️ Maintains WebSocket connection while ignoring only BlockID events

Filter Enabled

Target Nodes (empty = all nodes):

Main RPC Auxiliary RPC-1 Auxiliary RPC-2 Auxiliary RPC-3 Auxiliary RPC-4

Filtered: 0 items

Last filter: -

🔪 REST API Kill Switch

⚠️ Temporarily disable REST API (for debugging)

Status: ● Enabled

Skip count: 0

Last skip: -

🧪 MetaTxID Chunk Limit (Test Feature)

Adjust the number of chunks per MetaTxID for testing purposes (Production: 160)

Chunks per MetaTxID: Current: 160 (Production)

Effect Examples:

160 (Production): 16MB file = Regular meta only
10 (Test): 16MB file = 16 intermediate metas + 1 super meta
2 (Minimum): 4MB file = 2 intermediate metas + 1 super meta

⚠️ Warning: This is for testing only. Smaller values create more MetaTxIDs, which increases upload time and blockchain costs. Always use 160 for production.

📖 Guide

What is Kaspa P2P File Storage?

Quick Start: Download

Quick Start: Upload

FAQ (Frequently Asked Questions)

💰 How much does upload cost?

📥 Is download free?

📊 What is the maximum file size? Can I upload large files?

🏗️ Is this an L2 service?

📄 What is the file format specification?

📊 Status

🌐 Network Connection Status

💰 Wallet Status

📁 Workspace

📂 File Management

📁 File Upload

✅ Resume Ready

📥 Download

🔗 Restore from MetaTxID (Legacy)

File Information

🛠️ Directory Builder

📥 Import

⚙️ Settings

🚀 Session Setup

💰 Wallet & UTXO Management

📁 Workspace Settings

🗄️ Archive Node Discovery

⚙️ Preferences

🎨 Theme Settings

Network Settings

REST API Settings

🔐 Privacy Settings

🔧 Kaspa Developer Platform (kas.fyi)

💸 Transaction Amount Settings

📊 WebSocket Configuration

Download Settings

🔄 Kaspa System Restart

📤 Upload Settings

🐛 Debug Log

🔐 WASM SDK Security Features Investigation

🛡️ CSP Violation Monitor

🔌 Multiple WebSocket Test (Experimental)

🚫 Block Event Filter

🔪 REST API Kill Switch

🧪 MetaTxID Chunk Limit (Test Feature)