OrbitDB Manager

WHAT IT DOES

OrbitDB Manager is a developer tool for creating and interacting with OrbitDB databases — serverless, peer-to-peer databases built on IPFS. Create new databases (Key-Value, Document Store, or Feed), add records with key-value pairs, and query existing databases. The tool simulates OrbitDB operations and returns database addresses (e.g., /orbitdb/Qm.../database-name), record IDs, and query results. This is essential for developers building decentralized applications, exploring OrbitDB's data structures, testing database schemas, or learning how to work with IPFS-based databases.

HOW TO USE

Connect your wallet using the BGWallet bridge (MetaMask or any Web3 wallet). Select an operation: "Create database" to create a new OrbitDB database with a name and type (Key-Value, Document Store, or Feed). "Add record" to add a key-value pair to an existing database — enter the database address, key, and value. "Query records" to retrieve records from a database — enter the database address and an optional query (key or JSON path). Click "Execute" to perform the operation. Results display the operation type, status, and detailed data including database addresses, record IDs, and query results. The tool simulates OrbitDB operations since a full OrbitDB/IPFS node cannot run in the browser without additional libraries.

TECHNICAL MECHANISM

The tool simulates OrbitDB operations using deterministic, client-side logic. For database creation, it generates a random CID (Content Identifier) using a cryptographic hash simulation and constructs a database address in the format /orbitdb/{cid}/{database-name}. The database type determines the internal structure — Key-Value stores simple key-value pairs, Document Store stores JSON documents with indexed fields, and Feed stores append-only logs. For adding records, the tool stores the key-value pair in a simulated in-memory store and returns a record ID. For queries, it simulates a database query by filtering an internal sample dataset based on the provided query string. The tool uses the ethers.js library for cryptographic hash simulation and maintains state in memory. All operations are performed client-side — no data is stored permanently or transmitted to any server. The tool does not require a running OrbitDB node for simulation mode.

WHAT IT CANNOT SEE

The tool cannot guarantee data persistence without a running OrbitDB node or IPFS node — the simulated data is not actually stored on IPFS. It cannot operate without a connected IPFS node — the simulation mode does not require a real IPFS connection, but real OrbitDB operations would. It cannot perform complex queries beyond basic record retrieval (e.g., no advanced indexing, aggregation, or joins). It cannot handle large databases or high-volume writes without performance degradation — the simulation is limited to small datasets. It cannot provide encryption or privacy for database records — all data is stored in plaintext. It cannot connect to real OrbitDB networks without additional libraries and configuration. It cannot sync data with other OrbitDB nodes. The tool is read-only and does not sign any transactions.

PLEASE NOTE

This tool works exclusively with EVM-compatible chains for the wallet connection, but OrbitDB itself is chain-agnostic and works with any IPFS node. Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported for wallet connection but the simulation works regardless. The tool uses a simulation of OrbitDB operations — real OrbitDB requires running an OrbitDB node connected to an IPFS node. The database addresses generated are simulated and not actually accessible on the IPFS network. For real OrbitDB usage, install the OrbitDB library and connect to an IPFS node. The tool does not store any data — all operations are performed client-side. The tool is provided as-is with no warranty or liability. This is not a substitute for proper OrbitDB deployment.