Home / BlockHearth / BlockHearth Specification
BlockHearth
Immutable Records. Trusted Homes.
Overview
BlockHearth is an open-source, blockchain-powered property title custody, verification, and transparency platform designed to modernize how real estate ownership records are maintained, authenticated, transferred, and accessed. The platform establishes a permanent, publicly verifiable history for every registered property, documenting ownership records, deed transfers, mortgages, liens, releases, easements, encumbrances, and other significant title events. By combining blockchain-based recordkeeping, cryptographic document verification, secure digital document custody, and integration with existing government land registries, BlockHearth creates a transparent and auditable record of property ownership.
BlockHearth enables homeowners, prospective buyers, sellers, attorneys, title companies, real estate professionals, financial institutions, and participating government agencies to examine a property’s documented ownership history. Public property records provide visibility into previous and current recorded ownership, historical transactions, title changes, and associated legal instruments. Every recorded event maintains its own verification status and historical reference, ensuring that original records are not silently overwritten. BlockHearth distinguishes government-verified records from independently authenticated documents, user-submitted information, pending transactions, and disputed claims.
The platform is designed around a modular architecture with comprehensive core functionality and optional plugin modules. Its capabilities include property registration, blockchain title custody, public property history, digital deed management, ownership verification, smart contract-assisted transfers, mortgage and lien tracking, fraud detection, dispute management, government registry integration, and independent property record verification. Privacy protections ensure that sensitive personal information and confidential documents are not unnecessarily exposed on public blockchain networks.
BlockHearth seeks to establish a more transparent and trustworthy foundation for property ownership by making title histories accessible, verifiable, and independently auditable. Blockchain records provide tamper-evident evidence of recorded events, while integration with legally authoritative land registries preserves the distinction between digital verification and legally recognized property ownership.
Project Objectives
- Establish a permanent, tamper-evident digital history for registered properties.
- Make available property title histories publicly accessible and independently verifiable.
- Improve transparency throughout property ownership and transfer processes.
- Reduce opportunities for deed fraud, document manipulation, and fraudulent ownership claims.
- Preserve historical ownership and title-related records.
- Provide secure digital custody for deeds and supporting property documents.
- Integrate with existing government land registries and recording authorities.
- Provide cryptographic verification of property documents and recorded events.
- Improve access to historical property information for homeowners, buyers, and authorized professionals.
- Support legally compliant digital property transfer workflows.
- Provide transparent tracking of mortgages, liens, releases, easements, and encumbrances.
- Support property ownership held by individuals, trusts, estates, corporations, and other legal entities.
- Enable independent auditing of property records and blockchain transactions.
- Provide an extensible platform that can accommodate different jurisdictions and legal frameworks.
- Preserve public transparency while protecting confidential personal information.
Core Modules
Property Registration and Identification
- Register residential, commercial, industrial, agricultural, and undeveloped properties.
- Establish a unique digital identity for every registered property.
- Associate properties with legally recognized parcel identification numbers and cadastral references.
- Support county assessor parcel numbers, tax identification numbers, legal descriptions, lot numbers, and subdivision references.
- Associate geographic coordinates and property boundaries with registered parcels.
- Support multiple buildings, units, lots, and improvements associated with a property.
- Maintain historical parcel identifiers and documented parcel renumbering.
- Support property subdivisions, consolidations, lot splits, and boundary adjustments.
- Identify duplicate registrations and potentially conflicting property records.
- Maintain jurisdiction-specific registration requirements.
- Link registered properties to corresponding government land registries.
- Provide public property lookup and registration verification.
- Maintain property registration dates and originating record references.
- Preserve historical property identification information.
Blockchain Property Title Ledger
- Record property title events on a blockchain-based ledger.
- Establish cryptographic references for deeds, title documents, and supporting records.
- Maintain chronological ownership and transaction histories.
- Record property registration, transfers, corrections, releases, and other title-related events.
- Provide tamper-evident transaction timestamps and cryptographic signatures.
- Preserve historical ownership records without silently overwriting previous entries.
- Support public blockchain verification.
- Provide independent transaction and document hash verification.
- Maintain blockchain transaction references for every recorded event.
- Support multiple blockchain networks through interchangeable network adapters.
- Provide blockchain network monitoring and transaction confirmation tracking.
- Maintain auditable event histories for every registered property.
- Support public verification without requiring users to hold cryptocurrency.
- Distinguish finalized blockchain transactions from pending or unconfirmed transactions.
- Support blockchain-independent property identifiers.
- Preserve transaction provenance and historical references.
- Provide transparent transaction status information.
Public Property Title History
- Display the available documented history of every registered property.
- Provide chronological ownership histories from the earliest available documented record.
- Identify previous and current recorded owners where legally permissible.
- Display deed recordings, transfers, and title-related events.
- Show transaction dates, recording dates, document references, and verification statuses.
- Display recorded purchase prices when available through public records.
- Identify historical mortgages, liens, releases, easements, and encumbrances.
- Display property subdivisions, consolidations, and legal description changes.
- Provide links to publicly accessible source documents.
- Identify the originating jurisdiction and recording authority.
- Provide historical ownership timelines.
- Allow users to compare consecutive title events.
- Identify missing documentation and unexplained gaps in available records.
- Provide public, searchable property history pages.
- Support downloadable property history reports.
- Allow anyone to independently verify blockchain references.
- Distinguish verified information from unverified or incomplete historical information.
- Maintain a permanent chronological record of documented changes.
Digital Deed and Document Custody
- Provide secure digital custody for property deeds and supporting title documents.
- Store cryptographic document fingerprints on the blockchain.
- Preserve original document files in secure, redundant off-chain storage.
- Support PDF documents, scanned records, electronic deeds, surveys, and legal instruments.
- Maintain document version histories.
- Preserve original submissions alongside corrected or amended documents.
- Verify document integrity through cryptographic hash comparison.
- Support digitally signed documents.
- Maintain document submission and authentication histories.
- Support jurisdiction-specific document formats.
- Provide secure document retrieval and authorized access.
- Identify missing, incomplete, or potentially altered documents.
- Maintain document provenance and source attribution.
- Support long-term document preservation and archival policies.
- Record document expiration and replacement events where applicable.
- Maintain relationships between documents and their corresponding property title events.
- Support document classification and indexing.
- Distinguish original documents from copies, amendments, and supporting evidence.
Ownership Verification and Identity Management
- Support decentralized identity frameworks.
- Verify property owner identities through authorized identity verification providers.
- Support government-issued identity document verification.
- Support individual, organizational, corporate, trust, and estate ownership.
- Associate verified identities with property ownership records.
- Support multiple owners and joint ownership arrangements.
- Distinguish legal owners, authorized representatives, trustees, beneficiaries, and agents.
- Support ownership verification through cryptographic signatures.
- Maintain identity verification status and expiration information.
- Support multifactor authentication.
- Provide secure account recovery procedures.
- Support privacy-preserving identity verification.
- Support zero-knowledge proofs where appropriate.
- Prevent public disclosure of sensitive identity documents and private credentials.
- Maintain authorization histories.
- Support identity verification requirements that vary by jurisdiction.
- Provide clear distinctions between verified identities and unverified account holders.
Property Title Transfers and Smart Contracts
- Facilitate digitally documented property ownership transfers.
- Support seller and buyer identity verification.
- Require explicit authorization from appropriate parties.
- Support digitally signed transfer agreements.
- Validate required supporting documentation before accepting transfer submissions.
- Integrate with authorized escrow providers.
- Support conditional transaction workflows.
- Coordinate recording submissions with participating land registries.
- Track transfer initiation, authorization, submission, acceptance, rejection, and completion.
- Record finalized title events on the blockchain.
- Maintain complete historical records of previous ownership.
- Support inheritance, gifting, trust transfers, corporate transfers, and court-ordered transfers.
- Provide configurable jurisdiction-specific transfer requirements.
- Support transaction cancellation and correction procedures where legally permitted.
- Require human authorization for consequential ownership changes.
- Maintain auditable transfer approval histories.
- Prevent unauthorized transfer initiation.
- Support multi-party transaction approvals.
- Provide clear transfer status and documentation requirements.
- Distinguish smart contract execution from legally effective title registration.
- Require applicable legal execution and government recording processes before presenting a transfer as legally completed.
Mortgage, Lien, and Encumbrance Registry
- Record mortgage-related title events.
- Track recorded liens and lien releases.
- Support tax liens, judgment liens, mechanic’s liens, and other recognized encumbrances.
- Record easements, restrictive covenants, and recorded property interests.
- Maintain historical mortgage records.
- Track lien satisfaction and release documentation.
- Identify potentially outstanding encumbrances.
- Associate every recorded event with its source documentation.
- Distinguish active, released, disputed, expired, and unverified records.
- Integrate with participating public recording systems.
- Provide chronological encumbrance histories.
- Support title exception and discrepancy reporting.
- Maintain mortgage assignment and modification histories.
- Record relevant foreclosure and court-related title events when supported by authoritative documentation.
- Provide public access to legally accessible encumbrance information.
Government Land Registry Integration
- Integrate with county recorder offices and property registries.
- Support municipal, state, provincial, and national land registration systems.
- Connect to property assessor databases.
- Retrieve publicly available deed and recording information.
- Support authorized government APIs and registry data feeds.
- Provide configurable jurisdiction-specific integrations.
- Synchronize available property records.
- Track source registry updates and synchronization timestamps.
- Compare blockchain records against authoritative government records.
- Identify discrepancies between recorded deeds and blockchain references.
- Support government-authorized verification workflows.
- Provide registry integration audit logs.
- Maintain source attribution for every imported record.
- Support historical record imports where available.
- Identify unavailable, incomplete, or outdated government information.
- Maintain clear distinctions between imported records and independently verified records.
- Support registry reconciliation and correction workflows.
Title Verification and Fraud Detection
- Analyze property title histories for inconsistencies.
- Identify duplicate or conflicting ownership claims.
- Detect suspicious changes to property identifiers.
- Identify potentially forged or altered documents through available verification methods.
- Flag unusual ownership transfer patterns.
- Detect missing releases for previously recorded liens.
- Identify unexplained gaps in historical records.
- Compare document fingerprints against previously recorded versions.
- Identify conflicting submissions from multiple parties.
- Flag unauthorized or unexpected transaction attempts.
- Provide risk indicators and supporting evidence.
- Maintain transparent fraud investigation histories.
- Support human review and dispute escalation.
- Distinguish automated risk indicators from confirmed fraud findings.
- Monitor suspicious document replacement attempts.
- Identify discrepancies between government registry records and blockchain entries.
- Provide alerts for potentially fraudulent title activity.
Public Property Search and Discovery
- Search properties by street address, parcel number, legal description, and jurisdiction.
- Support map-based property discovery.
- Search historical ownership information.
- Search recorded property transactions.
- Search available deeds, liens, releases, and title events.
- Filter by property type, jurisdiction, recording date, and verification status.
- Provide property history summaries.
- Display blockchain verification references.
- Provide public document references where legally accessible.
- Support geographic information system integrations.
- Provide searchable public property records without requiring an account.
- Support accessible, mobile-friendly property search.
- Provide property identification and parcel matching tools.
- Support advanced search filters.
- Provide direct links to originating public records where available.
Property Ownership Dashboard
- Provide homeowners with a consolidated view of their registered properties.
- Display current recorded ownership information.
- Show property title history and relevant recorded events.
- Provide document custody and verification status.
- Display pending transfer activity.
- Provide alerts for new title-related events.
- Identify outstanding documentation requirements.
- Provide property-specific blockchain verification information.
- Support multiple properties under one account.
- Support joint ownership and authorized representatives.
- Allow owners to download property records and verification reports.
- Provide configurable privacy and notification settings.
- Display historical property documents.
- Provide access to ownership verification tools.
- Identify pending disputes and title discrepancies.
- Maintain a chronological activity history.
Trust, Estate, and Inheritance Ownership
- Support properties held by revocable and irrevocable trusts.
- Record trustee appointments and documented trustee changes.
- Support estate-owned properties and probate-related transfers.
- Associate authorized fiduciaries with relevant property records.
- Support inheritance-related title events.
- Maintain historical trust ownership documentation.
- Support transfers between individuals and legal entities.
- Distinguish legal titleholders from beneficiaries.
- Support multiple trustees and authorized signatories.
- Record court-authorized and fiduciary-approved transfers.
- Preserve historical ownership records through trust and estate changes.
- Support executor and personal representative authorization.
- Maintain relevant probate and estate documentation references.
- Track changes in legal ownership resulting from inheritance or trust administration.
Dispute Resolution and Title Challenges
- Allow authorized parties to submit ownership disputes.
- Record competing ownership claims.
- Support document submissions and supporting evidence.
- Maintain chronological dispute histories.
- Record court orders and legally recognized resolutions.
- Support title correction requests.
- Track dispute status and authorized reviewer decisions.
- Identify properties with unresolved title conflicts.
- Preserve disputed historical entries without erasing original records.
- Display appropriate dispute notices on public property histories.
- Provide appeal and review workflows.
- Maintain auditable dispute resolution records.
- Support authorized legal representative participation.
- Distinguish allegations from established legal findings.
- Preserve documentation associated with resolved disputes.
Public Transparency and Independent Auditing
- Provide public access to blockchain transaction histories.
- Allow independent verification of document fingerprints.
- Publish platform protocol documentation.
- Provide auditable smart contracts.
- Maintain publicly accessible system event histories.
- Provide verification APIs.
- Publish network integrity and synchronization status.
- Support third-party security audits.
- Provide open-source verification tools.
- Allow independent developers to build compatible property history viewers.
- Publish documented corrections and registry reconciliation events.
- Provide transparency reports and platform integrity statistics.
- Support independent blockchain explorers.
- Provide public verification references.
- Maintain documented verification standards.
- Enable independent examination of property title event histories.
Notifications and Property Monitoring
- Notify authorized owners of new property title events.
- Provide alerts for submitted transfer requests.
- Notify relevant parties of pending documentation requirements.
- Monitor recorded lien and mortgage events.
- Notify users of newly available government registry updates.
- Support configurable property monitoring.
- Provide alerts for disputed ownership claims.
- Notify users of verification failures.
- Support email, mobile, and API notifications.
- Maintain notification delivery histories.
- Allow users to configure alert preferences.
- Support suspicious activity notifications.
- Provide transaction status updates.
- Maintain notification histories for relevant property events.
Reporting and Property Intelligence
- Generate comprehensive property title history reports.
- Generate ownership verification reports.
- Generate deed and document integrity reports.
- Generate lien and encumbrance summaries.
- Produce property transaction timelines.
- Identify missing historical documentation.
- Compare property information across participating registries.
- Generate blockchain transaction verification reports.
- Support downloadable PDF and machine-readable reports.
- Provide jurisdiction-specific reporting formats.
- Clearly distinguish verified information from incomplete or unverified information.
- Support property document inventories.
- Generate property ownership event summaries.
- Provide historical title comparison reports.
- Include document references and verification evidence in reports.
Developer API and Integration Framework
- Provide REST API access to public property information.
- Support GraphQL property history queries.
- Provide blockchain verification endpoints.
- Support property registration and document submission APIs.
- Provide developer authentication and authorization.
- Support webhook notifications for property events.
- Provide software development kits for third-party applications.
- Support registry and title company integrations.
- Provide documented API versioning.
- Maintain API access logs and rate limits.
- Support independent property search applications.
- Provide integration testing environments.
- Support external smart contract and blockchain adapters.
- Provide public property verification endpoints.
- Maintain API documentation and compatibility standards.
Security, Privacy, and Data Governance
- Encrypt sensitive information in transit and at rest.
- Keep personally identifiable information and confidential documents off public blockchains by default.
- Publish cryptographic document fingerprints rather than private document contents.
- Implement role-based and attribute-based access controls.
- Support multifactor authentication.
- Provide secure cryptographic key management.
- Support hardware security modules and hardware-backed keys.
- Maintain immutable audit trails.
- Protect against unauthorized document replacement.
- Support data minimization and privacy-preserving verification.
- Provide secure backup and disaster recovery.
- Maintain security incident reporting.
- Support configurable data retention policies.
- Provide transparent data access and disclosure policies.
- Support applicable privacy and property-record laws.
- Provide secure account and session management.
- Support access revocation and credential rotation.
- Protect sensitive information from unauthorized public disclosure.
Blockchain Network and Interoperability
- Support public blockchain deployment.
- Support permissioned blockchain deployments for participating jurisdictions.
- Provide configurable blockchain network adapters.
- Support Ethereum-compatible networks.
- Support enterprise blockchain deployments where appropriate.
- Support cross-network verification through cryptographic proofs.
- Provide network-independent property identifiers.
- Support smart contract version management.
- Monitor transaction finality and network availability.
- Support migration and archival strategies.
- Maintain interoperability with external blockchain explorers.
- Provide blockchain-independent verification standards.
- Support multiple network configurations.
- Provide network health monitoring.
- Maintain transaction reconciliation records.
- Support independently verifiable blockchain event histories.
Administration and Platform Governance
- Provide administrative dashboards.
- Manage participating registries and institutional integrations.
- Manage identity verification providers.
- Configure jurisdiction-specific workflows.
- Manage user roles and permissions.
- Monitor blockchain network health.
- Review suspicious submissions and transaction activity.
- Manage disputes and correction requests.
- Maintain comprehensive administrative audit logs.
- Support institutional deployment configurations.
- Provide platform governance policies.
- Support community-driven protocol improvements.
- Maintain transparent software version histories.
- Provide administrative access monitoring.
- Support configurable institutional policies.
- Maintain documented approval and authorization requirements.
Optional Plugin Modules
Optional plugins extend BlockHearth without requiring modifications to the core property title ledger. Each plugin operates through documented interfaces and permissions, allowing deployments to select the integrations and capabilities appropriate for their jurisdiction and operational requirements.
GIS and Parcel Mapping Plugin
- Provide interactive property boundary maps.
- Integrate geographic information system parcel overlays.
- Support historical boundary comparisons.
- Display survey and plat map information.
- Provide geographic property search.
- Visualize property subdivisions and consolidations.
- Support geographic reference data.
- Display associated property improvements.
- Integrate public cadastral information.
- Support jurisdiction-specific mapping sources.
Title Insurance Integration Plugin
- Integrate with title insurance providers.
- Support title examination workflows.
- Maintain title insurance policy documentation.
- Track coverage and title exceptions.
- Support claims documentation.
- Associate insurance records with relevant properties.
- Provide policy verification references.
- Support authorized title insurance data exchanges.
Escrow and Settlement Plugin
- Integrate with authorized escrow providers.
- Support conditional closing workflows.
- Track payment and settlement milestones.
- Maintain settlement documentation.
- Support human-authorized transfer completion.
- Track escrow authorization status.
- Provide transaction progress notifications.
- Associate settlement events with property transfer histories.
Notary and Digital Signature Plugin
- Integrate with remote online notarization providers.
- Maintain electronic notarization records.
- Verify digital signatures.
- Provide notarial certificate custody.
- Support jurisdiction-specific notarization requirements.
- Associate notarized documents with title events.
- Maintain signature verification histories.
- Support authorized electronic document execution.
AI Property Research Plugin
- Provide AI-assisted title history analysis.
- Support natural-language property record searches.
- Summarize historical deeds.
- Identify potential title discrepancies.
- Classify and extract information from property documents.
- Provide research assistance with source citations.
- Identify missing historical documentation.
- Compare property records across available sources.
- Require human review of consequential findings.
- Distinguish extracted information from verified legal facts.
AI Fraud Intelligence Plugin
- Analyze suspicious transaction patterns.
- Identify document anomalies.
- Detect duplicate ownership claims.
- Monitor unusual transfer activity.
- Provide explainable risk assessments.
- Generate human-reviewed fraud alerts.
- Identify potentially manipulated property documents.
- Compare historical document versions.
- Detect inconsistencies between registry and blockchain records.
- Maintain supporting evidence for automated findings.
Real Estate Transaction Integration Plugin
- Integrate with real estate listing services.
- Support purchase agreement management.
- Coordinate buyer and seller workflows.
- Track closing milestones.
- Provide transaction document management.
- Associate listings with verified property records.
- Provide property history references for prospective buyers.
- Support authorized transaction status updates.
Mortgage and Lending Integration Plugin
- Integrate with mortgage lenders.
- Support lien verification workflows.
- Track mortgage recording status.
- Maintain loan-related title documentation.
- Monitor recorded mortgage releases.
- Support mortgage assignment histories.
- Provide authorized lender access.
- Associate mortgage events with relevant property histories.
Government Registry Connector Plugin
- Integrate with county recorder offices.
- Support state land registry connections.
- Connect property assessor databases.
- Integrate cadastral database information.
- Synchronize authorized public property records.
- Automate record reconciliation.
- Identify discrepancies and incomplete records.
- Maintain registry synchronization histories.
- Support jurisdiction-specific data formats.
Advanced Property Analytics Plugin
- Analyze historical property transactions.
- Provide ownership change analytics.
- Evaluate property record completeness.
- Generate jurisdiction-level transparency statistics.
- Monitor registry synchronization performance.
- Identify historical documentation gaps.
- Provide aggregated property title statistics.
- Support institutional reporting.
Multilingual and Accessibility Plugin
- Provide multilingual public property searches.
- Support accessible document presentation.
- Provide screen reader compatibility.
- Offer language translation assistance.
- Generate accessible verification reports.
- Support keyboard navigation.
- Provide accessible property history timelines.
- Support international language configurations.
Institutional Deployment Plugin
- Support private institutional environments.
- Provide consortium blockchain deployments.
- Support government-controlled infrastructure.
- Integrate enterprise identity systems.
- Provide institutional governance configurations.
- Support jurisdiction-specific deployment policies.
- Provide institutional audit reporting.
- Support configurable access and authorization policies.
Property Tax and Assessment Integration Plugin
- Integrate with property tax assessor databases.
- Display available historical property assessments.
- Track documented assessment changes.
- Associate tax-related records with registered properties.
- Support property tax lien references.
- Provide assessment history comparisons.
- Integrate authorized tax payment status information.
- Distinguish assessor valuations from independently established market values.
Land Survey and Boundary Verification Plugin
- Maintain digital survey documentation.
- Associate surveys with registered parcels.
- Preserve historical boundary records.
- Track documented boundary modifications.
- Support surveyor credentials and verification.
- Compare historical and current survey references.
- Associate approved survey updates with property histories.
- Maintain supporting boundary documentation.
International Property Registry Plugin
- Support international property registry integrations.
- Provide configurable country and jurisdiction requirements.
- Support regional property identification standards.
- Maintain multilingual property documentation references.
- Support cross-border ownership entity identification.
- Provide jurisdiction-specific title event classifications.
- Support international property record verification workflows.
User Roles and Permissions
BlockHearth supports configurable access levels based on user responsibilities and jurisdictional requirements.
Public Users
- Search publicly accessible property records.
- View available ownership histories.
- Examine recorded title events.
- Verify blockchain transaction references.
- Review publicly accessible deed references.
- Download available property history reports.
- Identify recorded liens and encumbrances.
- Submit reports concerning potential record discrepancies.
Property Owners
- Access registered property dashboards.
- Review ownership documentation.
- Submit supporting property documents.
- Monitor property title activity.
- Initiate authorized transfer workflows.
- Receive property event notifications.
- Review document verification results.
- Manage authorized representatives.
Buyers and Sellers
- Review available property title histories.
- Examine recorded ownership events.
- Verify supporting document fingerprints.
- Participate in authorized transfer workflows.
- Submit transaction documentation.
- Monitor closing and recording progress.
- Review relevant title discrepancies.
Legal and Real Estate Professionals
- Access authorized property documentation.
- Conduct title history research.
- Review liens and encumbrances.
- Submit verified legal documents.
- Coordinate authorized ownership transfers.
- Participate in dispute and correction workflows.
- Generate property title reports.
Government and Registry Authorities
- Manage authorized registry integrations.
- Submit authoritative property record updates.
- Verify recorded title events.
- Reconcile government records with blockchain entries.
- Review conflicting submissions.
- Maintain jurisdictional property registration requirements.
- Provide authorized corrections and legal record updates.
Platform Administrators
- Manage platform configuration.
- Monitor network operations.
- Manage access permissions.
- Review security events.
- Maintain integrations.
- Monitor system integrity.
- Manage platform-level audit records.
Core Workflows
Property Registration
- A property is identified through its recognized parcel number, legal description, or other authoritative property reference.
- The system checks for existing registrations and potential duplicate records.
- Available government registry information is retrieved or submitted for verification.
- Supporting ownership documents are uploaded and authenticated.
- The property receives a unique BlockHearth digital identifier.
- A cryptographic record of the registration event is created.
- The property becomes searchable according to its configured publication and verification status.
Property Title History Verification
- A user searches for a property.
- BlockHearth retrieves its available historical title events.
- The system displays recorded ownership changes and supporting document references.
- Cryptographic fingerprints are checked against stored document records.
- Blockchain transaction references are independently verifiable.
- Government registry references are displayed where available.
- Missing records, discrepancies, and disputed events are clearly identified.
- The user can generate a property history report.
Property Ownership Transfer
- An authorized seller initiates a transfer request.
- Buyer and seller identities are verified.
- Required transfer documentation is submitted.
- Applicable parties review and authorize the transaction.
- Optional escrow and notarization integrations coordinate their respective processes.
- The transfer is submitted to the relevant land registry when required.
- Government recording status is monitored.
- Upon confirmation of legally required recording, the finalized title event is added to the blockchain history.
- The previous ownership history remains preserved.
- The updated property record becomes available according to applicable disclosure rules.
Document Verification
- A property document is submitted.
- The system generates a cryptographic fingerprint.
- The document is associated with the relevant property and title event.
- The fingerprint is recorded in the blockchain ledger.
- The original document is preserved in secure off-chain storage.
- Subsequent document verification compares the submitted document against its recorded fingerprint.
- Any mismatch is identified and reported.
Title Dispute and Correction
- An authorized party submits a dispute or correction request.
- Supporting evidence is attached.
- The relevant property history is flagged with an appropriate status.
- Authorized reviewers examine the submission.
- Applicable legal and government documentation is obtained.
- A correction or resolution is recorded as a new historical event.
- Original records remain available for auditing.
- The public property history reflects the updated status without concealing prior events.
Specification Branding License (SBL)
Standard
- Fully AGPL-3.0+ compliant system
- Copyleft enforced for network deployments
- Required attribution:
- Roxanne Ardary
- https://www.roxanneardary.com/
Optional
- Specification Branding License (SBL)
- Attribution-free commercial deployment
- Pricing based on scale, usage, and deployment scope
- https://roxanneardary.com/blockhearth/
License & Notice Requirements
BlockHearth is released under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
By contributing to any Open Arsenal project, you agree that your contributions will also be released under this license.
Please note the following:
- All contributions must comply with the AGPL-3.0+ terms.
- Under Section 7 of the license, all redistributions, forks, and derivative works must preserve attribution to:
Roxanne Ardary and roxanneardary.com. - BlockHearth specifications are free to use with attribution. A Specification Branding License can be negotiated upon request.
- The project’s notice.md file tracks attribution requirements and contributor acknowledgments.
Any update that adds new contributors or modifies attribution should also updatenotice.md. - When submitting a pull request, ensure that any new files maintain the attribution headers where applicable.
- Network-deployed versions of this software must also remain fully AGPL-3.0+ compliant, including exposure of source code modifications when applicable under the license.
For full legal details, please refer to the AGPL-3.0+ license and the project’s notice.md file.
Notice – BlockHearth
Attribution Requirement: Under Section 7 of the AGPL 3.0+ license, all redistributions, forks, and derivative works, including network-deployed versions of this project, must provide attribution to Roxanne Ardary and roxanneardary.com.
Contributors
This file tracks contributors and their specific contributions to the project.
- Roxanne Ardary, roxanneardary.com – November 9, 2026
Created the repository for BlockHearth. Developed the original project concept and specification for an open-source, blockchain-powered property title custody and transparency platform featuring immutable ownership histories, public property records, secure deed verification, smart contract-assisted transfers, title research, fraud detection, and government registry integration. - Add other contributors here – [Date]
[Describe contribution in one sentence]
License – BlockHearth
This repository is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
Key Points:
- You are free to use, modify, and distribute the code.
- All redistributions, forks, and derivative works or network-deployed versions must also be licensed under AGPL-3.0+ and provide attribution to Roxanne Ardary and roxanneardary.com as required under Section 7 of the license.
- The software is provided “as is,” without warranty of any kind.
For the full license text, see GNU AGPL-3.0 License.


