The Scenario

A parcel becomes a Property becomes a Unit.
1.78 joules.

APN 044-238-021, 1,840 sqft, year built 1976, last assessed 2024. Smart meter registered, solar interconnect on file. Pulled in 0.4 joules.

Start the walkthrough Skip to the artifact
01
APN Lookup
TerraOS
0.12 J

Sarah pastes the listing URL; TerraOS resolves APN 044-238-021.

The county GIS layer answers in 84 ms with a polygon (WKT, EPSG:4326), lot size 7,200 sqft, zoning R-1, and last-recorded instrument 2024-118394. The APN becomes the canonical Parcel.id for every receipt downstream.

JWP ReceiptPayload
kind "terra.parcel.resolve"
apn 044-238-021
lat_ms 84
joules 0.12
cite "TerraOS Parcel schema v1 §2.3 · county GIS WFS 2.0"
sig "ed25519:0x4f...c1a"
02
Address
USPS WebTools
0.07 J

The mailing address is standardized to USPS Publication 28.

Free-form input "218 Acacia St, Apt B, Davis CA" normalizes to ZIP+4 95616-2271, ZIP carrier route C014, DPV confirmed Y. The standardized form is the only string TerraOS will accept as Parcel.address from this point on.

JWP ReceiptPayload
kind "terra.address.normalize"
zip4 95616-2271
dpv Y
joules 0.07
cite "USPS Pub. 28 · USPS Standardized Address API v4"
sig "ed25519:0x4f...c1a"
03
Recorder
Yolo County Recorder
0.34 J

Deed instrument 2024-118394 is fetched and hashed.

The grant deed PDF (3 pages, 412 KB) is pulled by instrument number, OCR'd, and committed as Parcel.chain[0] with SHA-256 8f3a...91d2. The chain walker will follow grantor→grantee links from here.

JWP ReceiptPayload
kind "terra.deed.ingest"
instrument 2024-118394
sha256 8f3a...91d2
joules 0.34
cite "Yolo County Recorder API · TerraOS Chain schema v1 §4.1"
sig "ed25519:0x4f...c1a"
04
Property
TerraOS
0.21 J

The structure on the parcel materializes as Property.

Assessor record + permit history collapse into one typed Property: 1,840 sqft, year built 1976, 3 BR / 2 BA, last permit P-2023-0814 (re-roof). Property.id mints as a v5 UUID over (Parcel.id, structure_polygon_hash).

JWP ReceiptPayload
kind "terra.property.materialize"
sqft 1840
year_built 1976
joules 0.21
cite "TerraOS Property schema v1 §3.2 · assessor roll 2024"
sig "ed25519:0x4f...c1a"
05
Unit
TerraOS
0.18 J

The conveyed Unit is carved out of Property.

Single-family conveyance creates one Unit covering 100% of Property with airspace 0–28 ft AGL. For the future ADU permit (P-2025-0117 pending), TerraOS reserves Unit-002 in the same Property — it just stays unbound until the cert-of-occupancy receipt lands.

JWP ReceiptPayload
kind "terra.unit.create"
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"
06
Sub-meter
PG&E AMI
0.41 J

Smart-meter SP-1009742 is bound to Unit U-7a14.

The utility's AMI returns service-point SP-1009742 with 15-minute interval data going back to 2019-03-11. ANSI X12 814 enrollment ties Unit→service-point so every kWh from this meter falls into the right Unit's energy ledger.

JWP ReceiptPayload
kind "terra.submeter.bind"
service_point SP-1009742
interval 15m
joules 0.41
cite "ANSI X12 814 v005010 · CA Rule 21 §H · TerraOS Submeter v1"
sig "ed25519:0x4f...c1a"
07
Interconnect
NEM 3.0
0.29 J

The 7.84 kW DC solar array is verified under NEM 3.0.

PG&E PTO letter dated 2024-09-02, inverter Enphase IQ8M ×24, AC nameplate 6.72 kW. NEM 3.0 net-billing tariff schedule attaches to the Unit; export compensation drops from the legacy NEM 2.0 retail rate to the Avoided Cost Calculator value (avg $0.082/kWh).

JWP ReceiptPayload
kind "terra.interconnect.verify"
ac_kw 6.72
tariff E-ELEC + NBT
joules 0.29
cite "CA PUC NEM 3.0 (D.22-12-056) · IEEE 1547-2018 · PG&E PTO 2024-09-02"
sig "ed25519:0x4f...c1a"
08
EV Circuit
TerraOS
0.16 J

A 48A Level-2 charger is registered as a metered load.

Wallbox Pulsar Plus on a 60A breaker, NEC 625.42 continuous-load rated to 48A. Sub-circuit SM-2 mirrors charger draw at 1-minute resolution and tags every kWh ev=true so the IRS §30C credit projection has a clean numerator.

JWP ReceiptPayload
kind "terra.evcircuit.register"
amps_cont 48
tag ev=true
joules 0.16
cite "NEC 2023 Art. 625 · SAE J1772 · IRC §30C(e)(6)"
sig "ed25519:0x4f...c1a"

TerraOS, in one line

1.78 joules. One receipt.

TerraOS handles asset as a typed, signed, energy-metered operation. The whole pillar is one shape: take a claim, do the work, sign the receipt.

Open the artifact → See the receipt format →