Skip to content
Zentalk Developer

Overview

ZenTalk Node API 1.0.0

Section titled “ZenTalk Node API 1.0.0”

REST API for ZenTalk’s distributed mesh storage network.

The ZenTalk Node API provides access to distributed mesh storage, network information, and node management. All data is encrypted using AES-256-GCM before storage and distributed across multiple nodes using Reed-Solomon erasure coding for fault tolerance.

Features

  • Distributed Storage: Store data across multiple nodes with redundancy
  • End-to-End Encryption: AES-256-GCM encryption with key derivation from Ethereum wallets
  • Fault Tolerance: Reed-Solomon erasure coding allows recovery from partial node failures
  • Authentication: Ethereum wallet signatures for secure access control
  • Rate Limiting: Built-in protection against abuse

Information

  • License: MIT
  • OpenAPI version: 3.0.3

Operations

Section titled “Operations”
POST
/api/v1/storage/upload
GET
/api/v1/storage/download/{userAddr}/{chunkID}
GET
/api/v1/storage/status/{userAddr}/{chunkID}
DELETE
/api/v1/storage/delete/{userAddr}/{chunkID}
GET
/api/v1/network/info
GET
/api/v1/network/peers
GET
/api/v1/network/health
GET
/api/v1/node/info
GET
/api/v1/node/stats
GET
/health
GET
/metrics

Authentication

Section titled “Authentication”

EthereumSignature

Section titled “EthereumSignature”

Ethereum wallet signature authentication. Requires X-Signature and X-Timestamp headers.

Message Format: zentalk:mesh:upload:<userAddr>:<chunkID>:<timestamp>

Example:

X-Signature: 0xabc123...
X-Timestamp: 1702234567

Security scheme type: apiKey

Header parameter name: X-Signature

LegacyECDSA

Section titled “LegacyECDSA”

Legacy ECDSA signature authentication. Requires X-Signature, X-Timestamp, X-Public-Key, and X-Nonce headers.

Message Format: <userAddr>|<chunkID>|<timestamp>|<nonce>

Example:

X-Signature: base64-signature
X-Timestamp: 2025-12-10T12:00:00Z
X-Public-Key: base64-pem-encoded-key
X-Nonce: unique-16-char-nonce

Security scheme type: apiKey

Header parameter name: X-Signature