Skip to main content
The Artifact

Schema browser — Parcel · Property · Unit.

Click any field. See the source authority (county recorder, USPS, NEM 3.0). Hover any field for its standard.

P/0
Dimension
Parcel
0.05–0.4 J
per call

the polygon, the APN, the chain

Parcel is the legal ground. WKT polygon in EPSG:4326, APN as the canonical id, lot size from the assessor roll, and a chain[] of recorder instruments. Every downstream record inherits Parcel.id as its anchor.

Sample receipt
JWP ReceiptPayload
kind "terra.parcel.read"
apn 044-238-021
srid EPSG:4326
joules 0.12
cite "TerraOS Parcel schema v1 §2"
sig "ed25519:0x4f...c1a"
Anatomy — operational specs
schema
TerraOS Parcel v1
id_scheme
APN (county-namespaced)
geometry
WKT polygon, EPSG:4326
chain_links
recorder instrument numbers
P/1
Dimension
Property
0.1–0.6 J
per call

the structure on the ground

Property is what stands on the Parcel. Assessor sqft, year built, bed/bath, plus a permit[] array fed from the jurisdiction's building department. Property.id is a v5 UUID over (Parcel.id, structure_polygon_hash) so a torn-down rebuild gets a new id, not a mutated one.

Sample receipt
JWP ReceiptPayload
kind "terra.property.read"
sqft 1840
permits P-2023-0814 + 11 prior
joules 0.21
cite "TerraOS Property schema v1 §3 · assessor roll 2024"
sig "ed25519:0x4f...c1a"
Anatomy — operational specs
id_scheme
UUIDv5(Parcel.id, polygon_hash)
sources
assessor + permit + Pictometry
links
1..n Units, 0..n Submeters
U
Dimension
Unit
0.05–0.8 J
per call

the conveyable share

Unit is what gets sold, leased, or financed. Carries airspace bounds, share-of-Property (1.0000 for SFR, fractional for condos), and a status enum (unbound, occupied, listed, escrow). Multiple Units can stack inside one Property — useful for ADUs, condo conversions, and air-rights deals.

Sample receipt
JWP ReceiptPayload
kind "terra.unit.read"
unit_id U-7a14
share 1.0000
joules 0.18
cite "TerraOS Unit schema v1 §5 · ANSI/BOMA Z65.1-2017"
sig "ed25519:0x4f...c1a"
Anatomy — operational specs
share_precision
1e-4 (basis points)
airspace
AGL min/max in feet
status
unbound | occupied | listed | escrow
kWh
Dimension
Submeter
0.2–1.2 J
per call

the energy ledger per Unit

Submeter ties an ANSI X12 814 enrollment to a Unit and ingests 15-minute interval data from the utility's AMI. Loads can be tagged (ev=true, hvac=true) so credits, tariffs, and CSRD scope-2 disclosures all stand on the same series. The series IS the source of truth — bills are a projection of it.

Sample receipt
JWP ReceiptPayload
kind "terra.submeter.read"
service_point SP-1009742
interval 15m
joules 0.41
cite "ANSI X12 814 v005010 · CA Rule 21 §H"
sig "ed25519:0x4f...c1a"
Anatomy — operational specs
transport
Green Button Connect / utility AMI
cadence
15-minute intervals
tags
ev | hvac | pool | tenant_x
PV
Dimension
Interconnect
0.1–0.9 J
per call

the export contract with the grid

Interconnect records the PTO letter, the inverter list, the AC nameplate, and the tariff schedule that governs export compensation. Under NEM 3.0 + NBT the export price is hourly Avoided Cost Calculator rather than retail, so the export forecast is a function of ACC × generation profile.

Sample receipt
JWP ReceiptPayload
kind "terra.interconnect.read"
ac_kw 6.72
tariff E-ELEC + NBT
joules 0.29
cite "CA PUC NEM 3.0 (D.22-12-056) · IEEE 1547-2018"
sig "ed25519:0x4f...c1a"
Anatomy — operational specs
standards
IEEE 1547-2018 · UL 1741-SB
tariff_models
NEM 2.0 (legacy) | NEM 3.0 NBT
pto_evidence
utility PDF + SHA-256

TerraOS, in one line

asset, made inspectable.

Click anything. The same primitives that compose the rest of the Transaction Science family — receipts, joules, signed transport — show up here too. The family is one system.