Core Concepts
Xandeum Greenpaper
the xandeum transformation 1\ introduction and motivation try storing a few gigabytes of data directly on any blockchain, and watch the costs soar into the stratosphere yet, web2 apps run on massive datasets every day without breaking a sweat enter xandeum a new approach that merges solanaâs lightning fast consensus with an infinitely scalable storage layer âenabling sedapps (storage enabled dapps) that rival (and even surpass) traditional centralized services building truly decentralized applications requires more than just trustless computation and state (account) managementâit demands scalable, cost effective, and random access data storage that's 100% integrated into the smart contract platform while protocols like filecoin and arweave have made strides in decentralized storage, they prioritize "whole file" (s3 like) and/or archival use cases over fast, granular reads and writes with read/write heads that can be set to any position meanwhile, storing significant data on chain (e g , within solanaâs account model) is expensive and limited in capacity this disconnect is at the core of what we call the blockchain storage trilemma balancing decentralization, cost, and efficient random access has proven notoriously difficult xandeum resolves this challenge by extending solanaâs native account model with an integrated storage layer that implements the âfile systemâ model to developers while still maintaining on chain verifiability in other words, solana dapp devs get fine grained, random access data operationsâbacked by a decentralized networkâwithout sacrificing performance or affordability by allowing data to flow seamlessly between standard solana accounts and xandeumâs scalable file system, we remove the friction that limits what decentralized apps (dapps) can achieve this unified approach sets the stage for a â cambrian explosion â of innovative projects ported from web2 and entirely new categories of sedapps (storage enabled decentralized applications) from large scale social platforms to data heavy research hubs and open knowledge repositories, xandeum empowers developers to operate at web2 efficiency and scale, all under the trust guarantees of a blockchain in the following chapters, we will explore the architectural principles behind xandeumâs storage layer, discuss how developers can build and deploy sedapps, and illustrate real world use cases that exemplify the transformative potential of this technology 2\ xandeum fundamentals xandeumâs core innovation is its scalable, file system based storage layer that integrates seamlessly with solanaâs high throughput blockchain by treating data as files and folders rather than merely on chain accounts, developers gain flexible, random access capabilitiesâwithout compromising on decentralization or performance this file system architecture, with their limited set of primitives but including important possibilities called read() , write() and seek() in unix, has been proven over decades to facilitate a plethora of classes of apps core architecture extended solana account model solana handles the trustless execution of smart contracts, while xandeum manages large data sets in an off chain but cryptographically verifiable, blockchain grade environment developers can use specific xandeum transactions (xtransactions), sent to xandeum aware rpc nodes, to copy data from solana accounts to a given position within a (mostly larger) xandeum file inside a xandeum file system and vice versa that way, the solana accounts act as the "ram" of the world computer (solana in this case), and the xandeum scalable storage layer as the (so far missing) "disk" distributed storage nodes xandeum relies on a set of storage nodes that collectively maintain and replicate files, ensuring high availability and fault tolerance while being tamper proof , censorship resistant and crytographically verifiable , hence the term blockchain grade storage data is split into pages (borrowed from unix memory management) and encrypted, so no single node holds a complete plaintext copy this deters censorship and preserves user privacy random access protocol rather than storing data in âwrite onceâ layers, xandeumâs architecture allows for granular reads and writes , similar to a traditional file system this innovation underpins the blockchain storage trilemma solution, enabling cost effective, rapid data queries without large overhead or complex retrieval processes key protocols & security pnode stake consensus (bft light) xandeumâs storage is maintained by provider nodes (pnodes) , each of which stakes tokens or collateral to participate a lightweight byzantine fault tolerance (bft) mechanism ensures that honest pnodes can continue serving dataâeven if a subset becomes malicious or fails this partial consensus avoids excessive overhead by leveraging solana for primary trust anchoring, focusing pnode consensus on storage correctness and availability paging, replication & self repair files are paged and erasure coded across multiple pnodes, so that data can be reconstructed even if some nodes lose or corrupt their pieces we're borrowing from both unix memory management for the paging as well as zfs for the redundancy mechanisms the pnode network maintains the configurable redundancy level as set by the storage enabled dapp (sedapp) a self repair protocol continuously monitors data distribution if redundancy drops below a safe threshold, new replicas are automatically generated and reassigned to maintain reliability threshold signature schemes (tss) xandeum uses tss for cryptographic operations that require joint authorization (e g , validating data integrity or performing privileged network tasks) rather than relying on a single signer, tss splits signing authority among multiple pnodes, reducing the attack surface and strengthening network security periodic storage challenges similar to filecoinâs proof of storage and proof of space time (post) concepts, pnodes must respond to periodic challenges from a set of validators âproving they still hold the correct data shards the difference xandeum reduces overhead by anchoring these proofs on solana rather than running resource intensive verifications entirely on the storage layer validators verify challenge responses and can penalize pnodes that fail or refuse to produce valid proofs, ensuring persistent data availability anchoring to solanaâs ledger each file operation (create, update, delete) and key network event is still anchored to solana for finality and verifiability this hybrid approach unites pnode level checks (ensuring actual data availability) with solana âs trust guarantees (ensuring tamper proof records of changes) by combining these protocolsâ pnode stake consensus , erasure coding , tss , periodic challenges , and on chain anchoring âxandeum delivers blockchain grade reliability, availability, and integrity for large scale file storage developers can trust that their data is continuously secured by the network, while enjoying the random access performance and ease of use made possible by xandeumâs file system based approach developer experience familiar file system interface rather than forcing developers to grapple with raw storage opcodes, xandeumâs apis abstract data interactions into straightforward file and folder operations this reduces the cognitive load for teams transitioning from web2 infrastructures transparent integration with solana developers can use standard solana tooling (such as the solana program library, cli tools, and popular frameworks) to orchestrate on chain logic data writes and reads in xandeum are triggered by simple function calls, creating a unified workflow flexibility for sedapps by offering storage at scale plus rapid state transitions , sedapps can adopt new user experiences once reserved for centralized platforms this paves the way for the cambrian explosion of decentralized services xandeum seeks to ignite with these fundamentals, xandeum balances security, cost efficiency, and random access performanceâultimately enabling a new class of storage enabled dapps (sedapps) to thrive on solana and beyond in the next chapter, weâll explore how developers can harness these capabilities to build, deploy, and manage sedapps in practice 3\ building sedapps on xandeum developing storage enabled dapps (sedapps) on xandeum combines the speed and familiarity of solana âs account based architecture with a file system based storage interface that scales to meet real world data demands this chapter offers a high level view of how to build, test, and deploy sedappsâwhile highlighting best practices for leveraging xandeumâs integrated storage layer guiding principles embrace solanaâs core strengths solana handles high throughput, robust consensus, and standard tooling for transaction settlement and on chain logic your dapp logic remains centered around smart contracts (programs) and accounts, just as it would on solana alone offload data to xandeum whenever you need to store large or frequently accessed datasets, shift that data to xandeumâs file system based layer instead of bloating on chain accounts this keeps your application fast and economical, while giving you granular , random access operations maintain trust anchoring leverage solana (and potentially other blockchains) for data anchoring each critical file operation references a hash or merkle root stored on chain, ensuring immutability and transparency without storing bulky content directly on the ledger prioritize user experience sedapps are designed to feel smooth and invitingâsimilar to web2 solutionsâbut underpinned by blockchain grade trust whether youâre building a wiki or an online game, simplify the process of reading and writing data so end users barely notice the decentralized mechanics behind the scenes developer workflow set up your environment install solanaâs tooling https //docs solana com/getstarted for smart contract compilation, deployment, and testing configure access to xandeumâs developer environment (devnet) and sdk, which expose file storage operations in a structure akin to directories and files design data schemas map out which elements of your dapp should remain in solana accounts versus which belong in xandeumâs storage layer for instance small counters or user balances might be on chain large documents or media attachments, databases (see demo applications below), extensive customer data go into xandeum define the app's redundancy level , e g 7 or 43 that means you'll require to always have 7 pnodes to store pages of your data this is one of the key factors why xandeum storage is scalable we're not bound to solana account's "redundancy level is 3,000, period" approach, assuming there are 3,000 validators is the cluster implement smart contracts (solana programs) write or adapt existing programs to reference xandeum file locations, storing hashes or pointers in the on chain state ensure that any critical transactions (like file creation or updates) emit events and update these pointers for auditability handle file operations use xandeum âs apis to create, peek (read) , poke (update), or delete files just as you would in a web2 file system we're peeking and poking our way through data, an homage to those glorious, spaghetti coded days of basic each operation triggers cryptographic proof generation, which can be anchored to solana , preserving trust and audit trails testing and debugging deploy your program to solana devnet and interact with xandeum âs storage devnet confirm that file hashes match the values stored on chain, ensuring consistent integration between the two layers deployment and scaling once your sedapp is tested, deploy it to the xandeum solana mainnet (when available) or continue to refine on devnet plan for horizontal scaling as your data volume grows xandeum âs storage layer handles large datasets and surges in traffic without compromising performance working with the scalable storage layer granular file access peek and poke files in small chunks, rather than dealing with entire blobs or "objects" as in objectstore solutions this flexibility is key for real time applications , collaborative documents or large structured, interconnected and dynamically generated content optional versioning for use cases that require detailed historical tracking (e g , collaborative docs, governance records), xandeum can log file updates as âversions â each version is tied to a verifiable proof, which can be anchored on chain at intervals or on demand developers who donât need a full edit history can skip version logging to minimize overhead integration patterns direct reference store file references in solana accounts, updated by your program whenever a user uploads or modifies data off chain index for large datasets, maintain an index in xandeum âs file tree that links to specific file shards or directories anchor periodic merkle roots on chain for transparent auditing looking ahead by combining the solana account model with a decentralized, random access file system based approach, xandeum unlocks a wealth of possibilities for sedapps this workflow and architecture will feel familiar to developers whoâve built on web2 or traditional dapp frameworksânow enhanced by blockchain grade properties and tight integration into solana , supervised, overseen, and challenged by the validators, and massively reducing the cost of storage by minimizing redundancy in a configurable way in a broader sense, by eliminating the storage bottleneck that has prevented large scale web2 apps from becoming trustless and decentralized, xandeum paves the way for a new wave of sedapps âultimately propelling us closer to a self determined future where any application can operate without sacrificing speed, usability, or freedom in the next chapter, weâll spotlight demo applications that illustrate these principles from a fast paced binary guessing game ( iknowit live ) to an open, community driven wiki ( info wiki ), weâll show how xandeum âs scalable storage layer can power data intensive dapps at scale 4\ demo applications to demonstrate how xandeumâs scalable storage layer expands the possibilities for decentralized apps, weâre unveiling two early sedapp prototypes iknowit live shows off the real time, interactive potential of offloading data intensive operations to xandeum, while info wiki highlights how massive public data sets can be collaboratively managed and governed on chain both demo apps are to be released open source to showcase the ease with which storage enabled dapps (sedapps) can built on xandeum iknowit live a binary guessing game currently under development, aiming to launch live at iknowit live later this year inspired by popular âthink of a character, the app guesses who it isâ games, iknowit live takes a collaborative twist players co create and refine the knowledge base behind the game, adding or updating the distinguishing questions that help narrow down the correct answer over time, the knowledge tree grows deeper and more nuanced, giving the platform a sense of collective âintelligence â gameplay & mechanics yes/no questions players think of a person, object, or concept the game asks a series of binary (yes/no) questions to make its guess community driven knowledge if the game fails or struggles, players can help enrich the database by suggesting new questions or revising existing ones this collaborative model ensures the knowledge grows organically transparency & co creation unlike an opaque ai model, iknowit live allows the community to inspect, edit, and expand the underlying knowledge base directly, creating a shared sense of ownership and discovery why it matters solana for speed the core game logicâlike generating questions, accepting answers, and updating immediate stateârelies on solana itâs fast, just like ram , handling near real time interactions with minimal latency xandeum for capacity iknowit live stores its ever growing knowledge base in xandeum , analogous to disk storage this approach ensures large data sets remain affordable and scalable , so the game can keep evolving without skyrocketing costs avoiding on chain bloat left to solana alone, storing every userâs contributions and the full knowledge tree would be prohibitively expensive âand potentially technically impossible if it grows to terabytes of data xandeum solves that by offloading the biggest storage burdens timeline & growth development in progress work is underway to build out the core mechanics and user interface, with an alpha version targeted for release soon projected expansion as the knowledge base matures and user numbers soar, the data volume could become massiveâpotentially reaching gigabytes (or more) xandeum ensures this growth stays feasible proof of concept & beyond though itâs âjust a game,â iknowit live illustrates how any data rich dapp can exceed the practical limits of on chain storage alone with xandeum , developers gain capacity to store significant, ever expanding data sets while retaining the trust guarantees of solana key takeaways massive, blockchain grade data, readily accessible to solana programs large user bases and deep data sets remain practical through xandeum âs file system based storage cost efficiency high speed operations still happen on solana , while xandeum handles archival and bulk data needs without incurring exorbitant fees endless scalability the game can add new questions, track detailed stats, and expand to new domains over time without hitting a storage wallâunlocking a truly limitless knowledge driven dapp info wiki a community driven knowledge repository âinspired by wikipediaâfueling a new wave of open, fully decentralized collaboration by leveraging xandeum âs storage approach, info wiki can handle massive datasets while maintaining on chain verifiability and governance concept start with wikipediaâs openly licensed database of articles (roughly 250gb without media) store this data on xandeum for random access reads and writes, while solana anchors updates and community decisions over time, new articles and edits are published under info wiki âs own license, requiring only that the source wikipedia content remains properly attributed key features massive data capacity info wiki demonstrates how high volume storage becomes practical in a decentralized setting by offloading article text and revision histories onto xandeum , we avoid the high costs typically associated with on chain data version control & history each edit to an article is captured in a merkle based versioning structure, ensuring a tamper evident revision history periodic anchors on solana guarantee transparency and trust in the editorial process community driven curation edits, article creations, and reorganizations can be governed by a dedicated community wiki token stake weighted proposals determine content disputes, editorial guidelines, and other governance matters governance model community wiki token distributed to early contributors, editors, and those who help maintain the platformâs health token holders can vote on community proposals (e g , new editorial policies, software improvements, or curation rules) on chain anchoring all governance proposals and decisions live on solana , ensuring transparent polling and results major structural changes (like rewriting a significant chunk of the wiki) anchor new file states to solana for verifiability roadmap summer / late summer 2025 initial launch of info wiki , seeded with the wikipedia dataset open invitations for community governance participation, content updates, and feature requests scalability & beyond explore multi chain anchoring as the platform grows, potentially tapping into other networks for added security or specialized user communities introduce advanced editorial features and expansions (e g , media file storage) via xandeum âs evolving capabilities why these demos matter both iknowit live and info wiki bring to life xandeum âs defining advantage combining solana âs high speed, low latency consensus with a file system based storage solution capable of handling massive amounts of data while iknowit live demonstrates how even a knowledge driven, user generated gaming experience can grow without hitting on chain storage limits, info wiki explores the far reaching potential of large scale collaborative editing on a decentralized knowledge platform these examples underscore a central theme with xandeum , developers can offload big data requirementsâeverything from user contributed content to gargantuan public datasetsâonto a secure yet cost efficient layer that means greater freedom to innovate and scale , and less time spent wrestling with the prohibitive economics or technical hurdles of storing everything on chain as a result, sedapps on xandeum can rival (and often surpass) their web2 counterparts in functionality, all while retaining trust , transparency , and decentralization by solving the storage bottleneck, xandeum paves the way for a genuine cambrian explosion of new and ported applicationsâultimately moving us closer to a future where every app can be self determined and free from centralized gatekeepers in the next chapter, weâll explore xandeum âs roadmap , including how developers, token holders, and ecosystem partners can help shape the platform as it progresses toward mainnet and broad adoption 5\ conclusion & outlook from iknowit live âs real time interactivity to info wiki âs large scale, community curated knowledge base, xandeum demonstrates that decentralized applications no longer need to sacrifice performance for trust by coupling solana âs high throughput blockchain with a file system based storage layer, we enable sedapps to operate at scales and speeds once considered unthinkable on chain the blockchain storage trilemma is tackled through random access data operations, anchored in secure, decentralized proofs this fundamental shift paves the way for a cambrian explosion of innovative appsâwhether theyâre reimagined from web2 or entirely new concepts that leverage decentralized infrastructures at scale we invite you to explore, build, and collaborate within the xandeum ecosystem join our community channels, contribute to the codebase, and experiment with devnet today together, we can forge a future where sedapps harness the full potential of blockchain technologyâwithout compromising on speed, user experience, or the richness developers have come to expect from modern applications