Notareum Documentation
The Trust Layer for Web3
Open protocol for verified blockchain resource sharing. One file format. Every chain. Cryptographically verifiable.Notareum is a Universal Transfer Interface (UTI) protocol that replaces error-prone copy-paste address sharing with verifiable
.nota files: portable, cryptographically signed containers for any blockchain resource. A .nota file can represent a wallet address, smart contract, transaction hash, NFT, or IPFS content identifier. It carries chain context, verification status, and a cryptographic signature that proves the resource is exactly what it claims to be.
The protocol is secured by a decentralized network of staked validators who attest to resource authenticity, governed by the $NOTA token and its vote-escrowed counterpart veNOTA. Any wallet, exchange, or on-chain application can parse a .nota file, verify its signature, and check validator attestations before a user commits a transaction. The result is a drop-in identity layer for every chain that works without central authorities, custodians, or trusted intermediaries.
Notareum is open source. The protocol specification, smart contracts, SDKs in TypeScript, Python, and Rust, and a growing library of examples are all available on GitHub. This documentation covers the full protocol, token design, developer tooling, operator guides, and integration patterns.
Architecture at a glance
Quick links
- Quick Start: ship your first verified
.notain five minutes - What is Notareum: the core idea in plain language
- Protocol Overview: the full architecture and layers
- .nota File Format: the v1.0 JSON specification
- SDK Overview: TypeScript, Python, and Rust
- Use Cases: concrete examples
- Glossary: every term, defined
- Whitepaper: the foundational research
Who this is for
- Wallet and dapp developers integrating verified resource sharing.
- Exchange and custodian teams hardening deposit flows against phishing.
- Validator operators staking NOTA to attest to resources.
- Protocol designers studying the economic and cryptographic model.
- End users who want to understand what
.notafiles are and why they matter.
Repository map
Core principles
- Chain Agnostic. Every major blockchain, every resource type.
- Human Readable. A
.notafile is JSON you can read without tools. - Cryptographically Verifiable. Every file carries a signature.
- Extensible. Schema versioning and governance-added resource types.
- Lightweight. Typical files are 1 to 2 KB, portable over any channel.

