User guidelines
Research framing
CADASORA is a geospatial land-record management and verification prototype. Blockchain provides a trust and audit layer; GIS provides spatial identity; IPFS holds sealed evidence; smart contracts enforce process rules. It complements — does not replace — legal land administration.
Required before Confirm mint: seal working survey evidence so NFT metadata includes a content-addressed evidence_uri (not a stub). Owners/holders then retrieve a wrapped DEK and decrypt the plan. A mint without sealed evidence fails with EVIDENCE_NOT_SEALED.
Earlier stub-minted tokens (null evidence_uri on-chain) cannot rewrite their URI; remint a fresh parcel after seal-before-mint.
Secure handshake vs advanced cryptography
Evidence access uses a practical handshake: AES-256-GCM DEK for the plan, X25519+HKDF wraps to owner/surveyor/authority, IPFS evidence_uri, and holder retrieve of a wrapped DEK only. Blockchain audits events; it does not store plans or create legal title.
Not claimed: post-quantum crypto, ZK proofs, FHE, or “exponential security.” The thesis contribution is architectural binding of space ↔ sealed documents ↔ keys ↔ audit — using mainstream crypto, not exotic schemes.
This guide explains how to use CADASORA. Maps, hashes, sheets, and NFTs are technical research records. They do not issue statutory land title.
1. Purpose
CADASORA is a geospatially enabled prototype. It connects boundary geometry, survey metadata, quality checks, optional encrypted evidence, and optional tokens on Polygon Amoy. See About for the architecture.
2. Intended users
- Licensed surveyors evaluating digital field-to-record workflows
- Academic examiners reviewing the demonstration
- Developers integrating WebGIS or blockchain land-record prototypes
3. Recommended workflow
- Sign in to the Workspace.
- Enter boundary stations clockwise (editable beacon IDs), optional control, or import a file.
- Select the source CRS that produced those numbers.
- Push to Map / Globe to preview. Projected CRS values are transformed to WGS 84 via
/api/crs/preview, then stored as a local draft only. - Create and Save when you intend a database record. Query My jobs to open it. Resume / Edit reloads source CRS and source stations, not the working UTM copy.
- Leave Mint / pipeline folded unless you intend an Amoy token. Create does not mint.
4. Coordinate reference system
Do not assume easting/northing is WGS 84 UTM. Garmin / Minna Mid Belt jobs use EPSG:26392, not EPSG:32632 or EPSG:26332. The Platform will not silently guess a CRS from the numbers.
After Create, WebGIS and the Globe must show the transformed WGS 84 geometry, not raw metres as degrees. Map north on Leaflet/Globe is display north, not Nigeria National North.
5. Draft versus saved job
- Draft (GL-PORTAL-…) — browser preview. No parcel id. No token.
- Saved job (IM-…) — Create wrote a PostGIS row. Listed under My jobs.
- Minted — optional later step. Not implied by Create.
If you leave declared area at 0, My jobs should show the computed UTM area after the geometry is stored. A positive declared area is kept and shown separately.
6. Maps and quality checks
- Green — existing or accepted parcel
- Amber — candidate under review
- Red — inter-parcel overlap
Areas on the globe may be a spherical display estimate. Cadastral computation uses working UTM area. M5 Showcase is a demo loaded only when you press that button; do not confuse it with your job.
7. Adjustment and sheets
Apply GL internal adjustment is optional. It needs a projected CRS and a closed ring. It seals gl_adjustment.applied, always raw_hash, and adjusted_hash when applied. It is not a SURCON statutory correction.
Computation and adjustment sheets can be previewed locally. They are stored on the create/mint evidence path only when that pipeline runs.
8. Review inbox
The header bell shows unread notices. The badge sits on the bell, not the light/dark control. Open the inbox for a half-height sheet on the right. Scroll the list. Use Load more and Clear / Read all. Tap outside the sheet (or the bell again) to close it. Opening a notice marks it read and jumps to that parcel.
9. Authority review
Submit a DRAFT from My jobs. Authority staff Claim review explicitly. They may Release or Take over. Opening a parcel in the queue does not claim it. Office has no Wallet / NFT.
10. Ownership transfer
A minted Layout or Plot NFT is soulbound. To change the recognised holder: the current owner requests a transfer in My Parcels, Authority reviews, and only a State Surveyor General operator may Approve. That does not move legal land title. The original surveyor is notified. Do not treat Approve as a discretionary “move any NFT” power.
11. Good practice
- Use Amoy for experiments.
- Do not retry Create solely because the portal showed 500 — check My jobs first.
- Do not change field coordinates just to pass a zone check.
- Treat a connected wallet as a retrieve tool, not proof of title.
- Hard-refresh after a deploy if the inbox still looks full-screen.