The .nota File Format
A universal, cryptographically verifiable container for blockchain resource sharing. Chain-agnostic. Human-readable. Under 2KB.
Protocol Architecture
How Notareum secures and distributes digital assertions across networks.
Resource Wrapping
Standard data is encapsulated into the verifiable .nota format via local SDK.
Verification Network
Nodes reach consensus on signature validity before state transition.
Safe Execution
Receiving dApps natively decode and trust the assertion without middleman logic.
Built on five principles
Chain Agnostic
Ethereum, Bitcoin, Solana, Cosmos, L2s, and any future chain. One format covers all.
Human Readable
JSON-based structure that both machines and humans can parse and inspect.
Cryptographically Verifiable
Digital signatures prove ownership and authenticity of every resource.
Extensible
Schema versioning and optional fields allow upgrades without breaking compatibility.
Lightweight
Typical .nota files are 1 to 2KB. Share via messaging apps, email, QR codes, or NFC.
Inside a .nota file
Every .nota file is a JSON object with four top-level sections: chain identification, resource details, verification status, and a cryptographic signature. The format is human-readable and machine-parseable with no binary dependencies.
- ●version: Schema version for forward compatibility
- ●chain: Network and chain ID identification
- ●resource: The actual blockchain resource and metadata
- ●verification: On-chain proof and validator list
- ●signature: ECDSA or EdDSA proof of authenticity
{
"version": "1.0",
"type": "address",
"chain": {
"name": "ethereum",
"chainId": 1,
"network": "mainnet"
},
"resource": {
"identifier": "0x1a2b3c...def",
"name": "Notareum Treasury",
"alias": "treasury.nota",
"description": "Official protocol treasury wallet"
},
"verification": {
"status": "verified",
"level": "institutional",
"validators": ["0xval1...", "0xval2...", "0xval3..."],
"proofHash": "0xabc123..."
},
"signature": {
"algorithm": "ECDSA",
"curve": "secp256k1",
"address": "0xsigner...",
"timestamp": 1709251200
}
}One format, many resource types
| Type | Description | Example |
|---|---|---|
| address | Wallet or account address | 0x... ETH wallet |
| contract | Smart contract reference | Uniswap V3 Router |
| transaction | Transaction receipt | Payment confirmation |
| nft | Non-fungible token | CryptoPunk #1234 |
| ipfs | IPFS content identifier | Document, media, data |
| metadata | Arbitrary structured data | KYC attestation |
Decentralized verification you can trust
How verification works
Notareum uses a staking-based verification model. Validators lock $NOTA tokens as collateral and verify that blockchain resources match their claimed metadata. If a validator approves a fraudulent resource, their stake is slashed. Honest validators earn rewards.
A resource achieves "verified" status when a supermajority (>66%) of assigned validators approve it. Disputed resources enter arbitration, where a larger validator pool reviews the case.
Automated on-chain existence check. Confirms the address or contract exists on the specified chain. No human review.
Community validator review. Multiple validators independently verify the resource against external data (project websites, social profiles, contract source code).
KYC-linked verification. The resource owner provides identity documentation reviewed by accredited validators. Suitable for regulated entities.
How clients render verification badges
Example of how wallets, explorers, and dApps display each verification level to end users.
Every chain. One standard.
+ More chains added continuously
Ready to integrate the .nota format?
Check out the developer documentation and SDKs to get started.