Most people who encounter Verus see a blockchain with CPU mining and decentralized identities. That's like looking at an aircraft carrier and seeing a boat. What's actually under the hood is one of the most feature-complete decentralized protocols ever built — and most of it is barely documented.
This page exists because we went digging. Deep into the C++ source code, through every RPC command, into hidden functions and undocumented systems. What we found changes the picture of what Verus actually is.
#
What People Think Verus Is
- A CPU-mineable cryptocurrency
- A blockchain with on-chain identities (VerusID)
- A system for launching tokens
That's the surface. Here's what's actually there.
#
What Verus Actually Is
#
A Decentralized File Storage Protocol
Verus has a complete on-chain file storage system built into the identity layer. The signdata command can take multiple files, build a Merkle Mountain Range (MMR) for integrity verification, optionally encrypt everything to a Sapling z-address, and store it all on-chain.
When data exceeds ~6KB, the protocol automatically splits it into chunks across multiple transaction outputs using CNotaryEvidence::BreakApart(). A single transaction can hold up to 2MB of data — an entire block's worth. For larger files, data is spread across multiple blocks and automatically reassembled via getidentitycontent.
There's no IPFS dependency. No external storage layer. No centralized pinning service. The data lives on-chain, permanently, with cryptographic proof of authorship.
Key commands: signdata, updateidentity, getidentitycontent
Deep dive: On-Chain File Storage
#
A Private Data Vault
Every piece of data stored on a VerusID can be encrypted to a Sapling z-address. Only the holder of the incoming viewing key can decrypt it. Individual sub-objects within a dataset can have unique symmetric keys, enabling granular access control — share one piece of data without exposing everything else.
This isn't a feature request or a roadmap item. It's built, deployed, and functional today.
#
A Cross-Chain Data Reference System
The CCrossChainDataRef system supports three types of data pointers:
This means data on one chain can be cryptographically referenced from another chain. An identity on Chain A can point to data stored on Chain B, with hash verification ensuring integrity. That's native cross-chain data availability — no bridges or oracles required for the reference layer.
#
A Decentralized Reputation System
Hidden in the wallet layer are setidentitytrust and setcurrencytrust — commands that let you rate identities and currencies, then configure your wallet's sync behavior:
- Mode 0: Open — sync everything
- Mode 1: Allow-list — only sync content from identities you've rated as approved
- Mode 2: Block-list — sync everything except identities you've blocked
This is protocol-level content moderation. No central authority decides what's trusted — each node operator makes their own choices. For an agent marketplace, this means wallets could automatically filter out bad actors based on local or shared trust ratings.
#
A Complete Identity Recovery System
VerusID's revocation and recovery authorities aren't just account recovery — they're a full key rotation and identity protection system:
- Revoke instantly freezes an identity (funds safe, just frozen)
- Recover assigns entirely new keys and reactivates
- Authorities can be separate identities on separate devices or held by trusted third parties
- Only the revocation authority can change the revocation authority (same for recovery)
- Works across PBaaS chains
This is the kind of system that enterprises need for key management and that individuals need for "I lost my phone" scenarios. It's been live and working since PBaaS activation.
Deep dive: How to Revoke and Recover a VerusID
#
A Namespace-Scoped Schema System
VDXF (Verus Data Exchange Format) isn't just key-value storage. It's a namespaced, hierarchical data schema system:
- Keys are scoped to namespaces (different namespaces produce different key IDs)
DefinedKeyentries on namespace identities provide human-readable labels for schema keysDataDescriptorwraps values with metadata (hash, encryption, MIME type, labels)CMMRDescriptororganizes multiple objects into a verified Merkle tree
A wallet reading a VerusID can look up the parent namespace identity, find DefinedKey entries, and automatically decode what each contentmultimap key means — without any external registry.
#
An On-Chain Marketplace
The makeoffer, takeoffer, getoffers, listopenoffers, and closeoffers commands implement a native decentralized marketplace. You can make and take offers for identities, currencies, and tokens — all on-chain, all non-custodial.
#
Multi-Currency DeFi Primitives
Fractional reserve basket currencies enable:
- Automated market making (AMM) with up to 10 reserve currencies
- Conversion fees of 0.025% (basket↔reserve) and 0.05% (reserve↔reserve)
- Price discovery through reserve ratios
- Liquidity provision via reserve deposits
This is DeFi without smart contracts — the conversion logic is in the consensus layer itself.
During our source code audit, we found commands that don't appear in help output:
And one command that exists in the code but was deliberately disabled:
The fact that the devs disabled signhash for security rather than leaving it accessible says something about the care that went into this codebase.
#
Why Is This All Undocumented?
Verus was built by developers, for the protocol. The focus was on getting the technology right — and they nailed it. What's missing is the bridge between "it exists in C++" and "here's how you use it."
That's what this wiki is for.
Every page here is written from hands-on testing. Every command was run on testnet before being documented. Every claim was cross-referenced against the source code and official documentation. When we found discrepancies, we fixed them.
#
The Bottom Line
Verus isn't competing with where other blockchains are today. It's competing with where they're trying to get to:
- Decentralized identity — Verus has it, with revocation, recovery, and namespaces
- On-chain storage — Verus has it, with encryption and cross-chain references
- DeFi — Verus has it, at the consensus layer without smart contract risk
- Cross-chain interoperability — Verus has it, via PBaaS with native bridge infrastructure
- CPU-accessible mining — Verus has it, with 50/50 PoW/PoS and no ASIC advantage
- Privacy — Verus has it, with Sapling shielded transactions and encrypted identity data
- Reputation — Verus has it, with wallet-level trust ratings
All of this is live. Not on a roadmap. Not in a whitepaper. Not in testnet-only.
The protocol is waiting for the world to catch up to what it can do.
Every finding on this page was verified against the VerusCoin source code. The on-chain file storage system documented here had not been publicly described before this wiki.