A geospatially enabled blockchain application for land-record management
What is CADASORA?
CADASORA is a geospatially enabled land-record management and verification system that uses blockchain as a trust and audit layer — not merely a “blockchain land registry.”
It links where the land is (GIS geometry) with what is recorded (survey metadata and sealed documents) and what happened over time (tamper-evident transaction history).
Four technologies
- GIS / geospatial data — parcel location, boundaries, and spatial relationships.
- Blockchain — immutable, auditable record of important events and integrity proofs.
- IPFS / content-addressed storage — sealed survey evidence off-chain; the chain retains cryptographic references (
evidence_uri). - Smart contracts / application logic — enforce mint, transfer, and verification rules.
Purpose
Design and implement a geospatially enabled blockchain-based application for secure, verifiable, and traceable land-record management — integrating geospatial parcel data, land-record metadata, digital documents, cryptographic integrity verification, and blockchain-based audit trails. Blockchain complements, rather than replaces, existing legal and institutional land-administration processes.
Research contribution
Sealed encrypted evidence (DEK wraps) with holder retrieve / reveal / decrypt from a content-addressed URI is central: a mint without evidence_uri is incomplete for this thesis.
Owner setup before mint: in My Parcels, the NFT recipient connects MetaMask and signs once (CADASORA evidence encryption identity; EIP-712 domain name CADASORA, version 1; purpose still “evidence encryption identity v1”). Same wallet + same network + same card re-derives the same X25519 key. A domain cutover requires a new Sign or Import of the previous backup. The browser deterministically derives an X25519 key from that signature (HKDF), keeps the private key local, and auto-registers the public key. Optional file export remains for advanced backup. Without registration, seal/mint is blocked (OWNER_ENC_REQUIRED). The server never stores Owner private keys.
What CADASORA is not
- A replacement for government land registries
- A system that automatically determines legal ownership
- An NFT marketplace for land
- A claim that putting a document on a blockchain makes it legally valid
Not statutory land title. Tokenised identity of a validated survey record only.
Secure handshake of information
CADASORA’s evidence path is a deliberate secure information handshake between the parcel’s spatial identity, sealed documents, authorized principals, content-addressed storage, and the blockchain audit layer — not a claim of exotic or “exponential” cryptography.
Mechanism (what we actually use)
- Per-evidence DEK — document bytes encrypted with
AES-256-GCM. - Principal key wraps — the DEK is wrapped to owner, surveyor, and authority via
X25519ECDH,HKDF, and AES-GCM (x25519-hkdf-aes256-gcm). Each authorized party receives a wrap they alone can open. - Content-addressed storage — ciphertext (and references) on IPFS; NFT metadata carries
evidence_uri+ integrity hash, not the plan bytes. - Holder retrieve — API returns a wrapped DEK (“Wrapped key for you. Not a raw DEK.”), never the raw key from the server.
- Blockchain — trust and audit layer for mint/transfer events and hashes; not a document store and not statutory title.
Compared with advanced cryptography
This stack is modern mainstream cryptography (X25519 / AES-GCM), chosen for implementability, auditability, and thesis defensibility. CADASORA does not claim post-quantum / lattice schemes, zero-knowledge proofs, fully homomorphic encryption, or marketing notions of “exponential security.” The research contribution is the integrated handshake: geospatial parcel ↔ sealed evidence ↔ principal-specific wraps ↔ IPFS URI ↔ on-chain audit — complementary to legal land administration.
CADASORA investigates how surveying, GIS, spatial databases, QA/QC, cryptographic integrity, distributed storage, and blockchain can support digital representations of land parcels — without replacing statutory land administration.
1. Overview
A land parcel is a geographic object: coordinates, a coordinate reference system, boundaries, jurisdiction, and evidence. CADASORA treats that geospatial work as authoritative. Blockchain and spatial NFTs are a later, optional commitment layer.
Core principle. Geospatial data establishes what and where the parcel is. Validation decides whether it may persist. The ledger and hashes establish provenance. Blockchain is an external commitment. An NFT is an optional digital representation — not a Certificate of Occupancy.
Source coordinates are never rewritten merely to fit another CRS. The system does not identify an unknown CRS from numbers alone. The surveyor declares the source CRS. CADASORA can warn when that CRS produces an implausible location.
2. Architecture
Layers are separate on purpose. The chain is not a spatial database.
Portal / WebGIS / Globe
↓
FastAPI (auth, parcels, jobs, QA, CRS, NFT)
↓
Geospatial engine (CRS, topology, area, jurisdiction)
↓
PostgreSQL + PostGIS (Supabase)
├─ Evidence (object store / IPFS)
└─ Polygon Amoy via QuickNode → optional spatial NFT
Large geometries, field observations, QA internals, and survey documents stay off-chain. On-chain objects hold hashes, identifiers, and references.
3. CRS and three geometries
The same easting and northing mean different places under EPSG:32632 (WGS 84 UTM 32N), EPSG:26332 (Minna UTM 32N), and EPSG:26392 (Minna / Nigeria Mid Belt).
Source
The surveyor’s observations and declared CRS. Example: EPSG:26392, E 502804, N 156649. These numbers are not rewritten to pass another zone.
Working
Canonical projected geometry for area, distance, topology, and inter-parcel checks. Imo case study: EPSG:32632 / UTM-32N, stored as geom_utm.
Display
WGS 84 geographic geometry (geom_wgs84, EPSG:4326) for Leaflet and the globe. Maps must never treat source metres as degrees.
Source CRS (explicit)
↓ PROJ / PostGIS
Working UTM (geom_utm)
↓ ST_Transform
Display WGS84 (geom_wgs84)
4. Jurisdiction and multi-zone parcels
Declared state is not enough. After transformation, the architecture can ask: Nigeria → state → LGA → UTM zone — and report crossings.
If six vertices fall in two states or two UTM zones, CADASORA must not split the parcel, switch CRS per vertex, or fabricate a second source CRS. It reports the crossing and uses one declared canonical working CRS.
Infrastructure is intended to be national. The MSc case study and current tests remain Imo and Rivers.
5. QA/QC and parcel lifecycle
Create is gated: explicit CRS, closed polygon, surveyor–state licence, R1–R4, inter-parcel overlap, endorsements, then PostGIS persist and audit.
Draft (GL-PORTAL-…)
↓ CRS + geometry + jurisdiction
Create → IM-… persisted job
├─ resume edit (if unminted, unsealed)
├─ computation / adjustment / correction
└─ mint → optional NFT
A saved job stays editable until mint or a sealed computation/adjustment/correction. Declared area and computed UTM area are stored separately. Zero or blank declared area displays the computed area; a positive declared value is never overwritten.
6. Data and infrastructure
| Layer | Technology | Role |
|---|---|---|
| Portal | HTML / CSS / JS | Survey workspace |
| API | Python, FastAPI | Auth, create, jobs, mint |
| Spatial store | PostgreSQL / PostGIS on Supabase | Parcels, audit, SRIDs |
| CRS | PROJ, pyproj, PostGIS | Transform, not guess |
| Maps | Leaflet, Cesium globe | Display geom_wgs84 only |
| Host | Render | experiment Render host (geoledger.onrender.com) |
| Chain | Polygon Amoy, QuickNode | Commitment / NFT |
| Evidence | Object store, Pinata / IPFS | Plans and sheets off-chain |
Database-level audit records events such as PARCEL_CREATE. Geometry comparison uses spatial operators (ST_Equals), not generic inequality.
7. Blockchain and spatial NFTs
Polygon Amoy is downstream of a valid PostGIS record. Experiment collection CadasoraSurveyNFT (0x3771fbee34c1e4306fba9956d30e4975e836fc16) is named CADASORA Survey Record / CADASORA. Mint uses EIP-712 MintAuthorization with domain CADASORA Survey NFT / 1. A 10-plot estate is 10 NFTs (not 11): first plot surveyor quota, remaining nine office (OFFICE_LAYOUT_PLOT). Roads are not minted. Tokens are soulbound: ordinary ERC-721 transfer is rejected. A correction mints a new NFT for a new observation version; the previous token stays immutable. CADASORAParcel is not deployed. Historical Cadasora tokens (including token 2) stay on the old contracts.
An NFT is a digital representation of a validated CADASORA survey record — not statutory ownership, SURCON seal, or a Certificate of Occupancy. Legal cadastral title, a CADASORA record, a token, and any virtual-world representation remain different things.
8. WebGIS and Globe
Push to Map / Globe writes a local draft only. My jobs reads the database and must plot geom_wgs84. Layout roads and CLOSE are parent features for later map layers. On-chain track lists the surveyor’s own minted jobs so a selected mint can be opened on Amoy.
9. Current prototype
The experiment workspace (September 2026) is a surveyor workspace with Authority review, DEK retrieve, a holder/owner view, and optional Amoy NFTs. Create saves one closed ring. A layout import with two or more plots becomes a parent layout: each plot is its own parcel with local P1…Pn; roads, CLOSE, ACCESS ROAD, and unallocated X stay on the parent and are not minted.
Sketch plans attach on Create. Extra evidence is chosen from the surveyor’s unminted jobs. Appearance follows light and dark. The Review Inbox bell sits in the header (unread badge on the bell, not the theme toggle). Opening the inbox shows a half-height sheet with scroll, Load more, and Clear / Read all; tap outside to close.
10. Authority, inbox, transfers
Submitted parcels enter the Authority Review Queue. Claim is explicit (opening GET does not claim). Concurrent claim: one operator wins; the other receives 409. The holder may Release (back to SUBMITTED) or another staff member may Take over with an audit event. Notifications fan out to ACTIVE office operators; each inbox is personal.
Ownership of a minted NFT is not a free market transfer. The current holder requests a transfer (proposed wallet + reason). Authority reviews. Only a State Surveyor General privilege (TRANSFER_APPROVER) can Approve. The contract then requires a specific EIP-712 TransferAuthorization; TRANSFERRER_ROLE executes that authorisation only. Ordinary office staff cannot discretionary-move tokens. The original surveyor is notified (no veto). Ownership history is not a new survey observation. Office accounts have no Wallet / NFT / MetaMask.
Evidence key recovery is dual-control re-wrap: the Owner files a request with a new wallet-derived enc pubkey; two distinct Office officers Claim/Approve; the host then unwraps the institutional authority wrap (if CADASORA_AUTHORITY_ENC_PRIVATE (or GEOLEDGER_AUTHORITY_ENC_PRIVATE) is configured) and immediately re-wraps the DEK to the new Owner pubkey, emitting immutable audit events. The API never returns plaintext or a DEK to the browser — there is no junior “download the plan” path. Surveyor wrap remains notify/audit only. M-of-N / HSM custody is later.
11. What CADASORA is not
- An independent statutory land registry
- A replacement for SURCON or a State Surveyor-General
- A blockchain system that transfers legal title by minting
- A tool that can deduce any CRS from coordinate numbers alone
- A tool that should alter field observations to satisfy a boundary
Preserve the observation, understand its CRS, validate the geometry, establish provenance, and only then create cryptographic or blockchain representations.