Apache 2.0 v0.3-draft · RFC-0001 to RFC-0028

The property
data
protocol.

OpenTwin is the open standard that lets any property share its data — maintenance records, financial history, IoT devices, residents — with any authorised application, in one canonical shape.

28
RFCs
7
Entity types
20
Consent scopes
4
Cert levels
Live wire · GET /opentwin/twin/{homeId}
{
  "opentwinVersion": "0.3.0",
  "home": {
    "nestCode": "hin:v1:IN:7e3cf2a148b9d0c4",
    "propertyType":  "apartment",
    "builtUpAreaSqft": 1240,
    "maintenanceScore": 100,
    "riskScore":       72
  },
  "assets":     […4],
  "devices":    […7],
  "documents":  […12],
  "people":     […3 residents],
  "gateLog":    […48 events],
  "governance": { "activePoll": true },
  "parking":    […2 bays]
}
Authorization: Bearer opn_… live
RFC-0008 NestCode Identity
RFC-0010 Consent & Data Exchange
RFC-0011 AI / MCP Tools
RFC-0014 Home Financial Protocol
RFC-0016 Lifecycle Events
RFC-0021 Rental & Tenancy
RFC-0023 Society Governance
RFC-0024 Facility Booking
RFC-0025 Gate Pass Protocol
RFC-0026 Parcel & Delivery
RFC-0027 Emergency & Safety
RFC-0028 Vehicle Registry
RFC-0008 NestCode Identity
RFC-0010 Consent & Data Exchange
RFC-0011 AI / MCP Tools
RFC-0014 Home Financial Protocol
RFC-0016 Lifecycle Events
RFC-0021 Rental & Tenancy
RFC-0023 Society Governance
RFC-0024 Facility Booking
RFC-0025 Gate Pass Protocol
RFC-0026 Parcel & Delivery
RFC-0027 Emergency & Safety
RFC-0028 Vehicle Registry
Core schema · RFC-0001 to RFC-0007

Seven entity classes.
One canonical shape.

Any compliant platform produces this schema. Any authorised consumer reads it. The owner controls every access decision via EdDSA-signed consent tokens.

RFC-0001
Home Twin
The root entity. Anchors all sub-entities. Contains the NestCode identifier, property metadata, aggregate scores, and the consent token registry.
hin: "hin:v1:IN:7e3cf2a1…"
type: "apartment"
sqft: 1240
risk: 72
01
RFC-0002
Assets
HVAC, lifts, generators, water tanks — with last-service date, next-service date, and warranty expiry.
02
RFC-0004
Documents
Sale deeds, EC, RERA registration, NOCs, insurance policies. Expiry tracking. W3C VC-compatible attestations. SHA-256 hash anchors.
type: "sale_deed"
hash: "sha256:ab3f…"
exp: null
04
RFC-0003
Devices
IoT sensors, cameras, smart locks, EV chargers. Energy readings. Health status. W3C WoT-aligned.
03
RFC-0005
People
Residents, tenants, authorised contacts. PII gated by dedicated consent scope. Tenant data isolated from owner consent.
05
RFC-0006 · RFC-0014
Financial Aggregates
Maintenance compliance score, credit score (0–850), mortgage balance, outstanding dues. ISO 20022 payment message alignment.
06
RFC-0016
Lifecycle Log
HMAC-chained immutable event log. 7 states. 12 event types. Tamper-evident.
07
RFC-0010 · Consent architecture

The owner approves every access request — individually, forever.

A consent token names who gets what data, for which purpose, for how long. EdDSA-signed. 24-hour default expiry. Revocation in 60 seconds. No implicit inheritance — owner consent does not extend to tenant PII.

20 named consent scopes — read:twin, read:assets, read:documents, read:financial, opentwin.people.tenant.read, opentwin.ai_context.read, and 14 more. Each scope is independently grantable and revocable.
Bank
POST /consent/request — read:twin, read:documents
›
Platform
Platform
owner approval notification
›
Owner
Owner
POST /consent/grant → EdDSA JWT signed
›
Platform
Platform
JWT delivered to bank
›
Bank
Bank
GET /opentwin/twin/{id} + Bearer JWT
›
Data
REVOKE: POST /consent/revoke → propagates within 60 seconds across all subscribers
SYN-DEV-002 · NestBrain ML

Risk scores from real data, not form fields.

NestBrain is a proprietary ML model that scores property health from 0–100 across six measurable factors. Updated in real time as the property's data changes — not recalculated annually from a questionnaire.

Score bands: very_low → −15% insurance premium (pilot). Banks qualify mortgages in hours for high-compliance properties. The score is available in the OpenTwin wire under read:twin scope.
MAINTENANCE_COMPLIANCE
100
UTILITY_PAYMENT_HISTORY
94
DOCUMENT_COMPLETENESS
82
ASSET_CONDITION
76
FINANCIAL_OBLIGATIONS
70
INSURANCE_COVERAGE
48
72
OVERALL SCORE
BAND: MEDIUM (61–80)
MODEL: nestbrain-v1 · v0.3.0
RFC-0023 · Society Governance Protocol · NEW

Polls, elections, AGMs — as verifiable on-chain events.

OpenTwin RFC-0023 standardises the data schema for housing society governance: resident polls, board elections, AGM proceedings, bylaw amendments, and quorum tracking. Results are anchored to the community twin's HMAC-chained lifecycle log.

Surfaces in OpenTwin wire under governance.* scope. A regulator querying maintenance compliance can also verify that the maintenance budget was voted in by a quorum — end-to-end accountability.
// RFC-0023 Governance schema fragment
interface SocietyPoll {
  pollId:       string;        // UUID
  question:    string;
  pollType:    'resolution' | 'election'
               | 'agm_motion' | 'bylaw_amendment';
  quorumPct:   number;         // Required %
  status:      'open' | 'closed' | 'passed' | 'failed';
  votes:       { yes: number, no: number, abstain: number };
  lifecycleRef: string;        // HMAC-chain anchor
}
RFC-0025 · Gate Pass Protocol · NEW

Every visitor entry, standardised and verifiable offline.

RFC-0025 defines the canonical gate pass schema — pre-authorised QR codes, real-time approval flows, delivery authorisation, and a 20-minute AES-256-GCM offline cache. Any access control hardware vendor can implement it once.

Three pass types: resident_auth (permanent), pre_approved (time-bounded QR), delivery_one_time (single-use, parcel-linked). Compatible with the SYN-DEV-004 Access Control SDK. Offline cache survives connectivity loss for the guard kiosk workflow.
// RFC-0025 Gate pass schema fragment
interface GatePass {
  passId:      string;
  passType:    'resident_auth' | 'pre_approved'
               | 'delivery_one_time' | 'service_visit';
  homeId:      string;          // NestCode / HIN
  validFrom:   ISODate;
  validUntil:  ISODate | null;
  qrPayload:   string;          // AES-GCM, 20min TTL
  consentScope: 'opentwin.gate.pass.read';
}
Full corpus

28 RFCs. One coherent model.

Apache 2.0. Public GitHub. New RFCs via pull request. RFCs 0023–0028 are newly drafted, grounded in live SeekYourNest features.

Core Schema

RFC-0001–0007
Home Twin, Assets, Devices, Documents, People, Financial Aggregates, Passport
Base
Final

Identity & Privacy

RFC-0008
NestCode / Home Identity Number — SHA-256 address hash, hin:// URI
Identity
Draft
RFC-0010
Consent & Data Exchange — EdDSA tokens, 20-scope vocab, 60s revocation
Privacy
Draft
RFC-0012
Security Model — Ed25519, AES-256-GCM, HKDF, ISO 27001 Annex A
Security
Draft
RFC-0015
Verifiable Credentials — did:opentwin DID method, W3C VC 2.0, SD-JWT, EUDI Wallet
Identity
Draft
RFC-0019
Anti-Fraud & Duplicate NestCode Resolution — three conflict classes, arbiter protocol
Trust
Draft

Operations & Events

RFC-0016
Home Lifecycle — 7 states, 12 events, HMAC-chained log
History
Draft
RFC-0020
Webhook Event Subscription — HMAC-signed push, 14-event catalog, retry
Events
Draft
RFC-0025
Gate Pass Protocol — visitor auth, QR, offline cache, delivery auth
Access
New
RFC-0026
Parcel & Delivery Management — carrier integration, one-time pass, locker schema
Ops
New
RFC-0027
Emergency & Safety Protocol — SOS, evacuation, first-responder data feed
Safety
New

Society & Community

RFC-0018
Community Twin — housing society, shared infrastructure, machine-readable bylaws
Community
Draft
RFC-0021
Rental & Tenancy — lifecycle, tenant PII isolation, portable rental credit score
Tenancy
Draft
RFC-0023
Society Governance Protocol — polls, elections, AGM, quorum, bylaw amendments
Governance
New
RFC-0024
Facility & Amenity Booking — pool, gym, hall, time slots, capacity, cancellation
Facilities
New
RFC-0028
Vehicle Registry & Parking — resident vehicles, visitor parking, EV charging, bay assignment
Mobility
New

Finance & Commercial

RFC-0014
Home Financial Protocol — credit score 0–850, mortgage, ISO 20022 payment messages
Finance
Draft

AI, Developer & Platform

RFC-0011
MCP Tool Registry — 10 standard AI tool shapes, works with Claude, GPT-4o, Gemini
AI
Draft
RFC-0017
OpenTwin Query Language (OQL) — declarative JSON queries, 11 operators, date variables
Query
Draft
RFC-0022
Smart City Aggregate API — k-anonymity ≥50, differential privacy, municipality OAuth
Urban
Draft
Who integrates

Every participant in the
property chain.

Banks & Housing Finance

Approve in hours, not weeks.

Maintenance compliance, valuation history, ownership chain — one API call. The same code works across every compliant platform.

RFC-0014 · RFC-0016 · RFC-0010
Insurance

Price from live risk data.

NestBrain score + IoT device health + maintenance records, updated in real time. Pilot: very_low band → −15% premium.

RFC-0006 · RFC-0003 · SYN-DEV-002
AI Agents & Assistants

Real context, not guesses.

RFC-0011 MCP tools. One implementation works on every compliant platform — Claude, GPT-4o, Gemini all use the same schema.

RFC-0011 · RFC-0017 · RFC-0010
PropTech Startups

Build on the network.

Implement OpenTwin once. Your product reads every compliant platform's data. Level 1 cert is free and self-attested.

Level 1 free · Apache 2.0
Government Registries

Connect deeds to the digital twin.

Add NestCode as a secondary column. Print it on title deeds. Three adoption tiers from a SQL ALTER TABLE to W3C Verified Issuer.

RFC-0008 · RFC-0019 · RFC-0022
Access Control Vendors

One gate pass protocol for every building.

RFC-0025 defines the canonical visitor auth schema. Build hardware once — it works in any OpenTwin-compliant society management system.

RFC-0025 · SYN-DEV-004 · RFC-0010
The standard
is being
written now.

28 RFCs in draft. Conformance suite live. Every adopter shapes what v1.0 looks like. Apache 2.0.

Read the RFC corpus → Get API access
opentwin.seekyournest.com · Apache 2.0 · BIS India / ISO JTC 1 submission roadmap
© 2026 SeekYourNest Technologies Pvt. Ltd. Apache 2.0