How Leja works: witnessing, records, and trust

Learn how Leja turns a single confirmed payment into a permanent witnessed record, and how those records accumulate into a Trust Graph over time.

Every record on Leja begins with a human confirmation. When an agent confirms that a payment was received, Leja doesn’t just log a number — it creates a witnessed event: a record that a real person attested to, tied to the identities of everyone involved, and stored permanently in the ledger. That single act is the foundation everything else is built on.

This page explains how that process works, how records compound into a Trust Graph, and how Leja Professional and Resident connect to form one ecosystem.

The witnessing model

Witnessing is the core principle that separates a Leja record from a bank transfer, a WhatsApp message, or a printed receipt. Any of those can be disputed, lost, or fabricated. A Leja witnessed event cannot be altered after the fact.

When you confirm a payment on Leja Professional, three things happen at once:

1. A witnessed record is created — linked to the property’s identity, the tenant’s RIN, your organisation’s identity, and the exact event details.
2. A state-compliant receipt is generated — formatted to the requirements of the property’s state, numbered in the LJA-YYYYMM-XXXX format, and ready to share.
3. The Trust Graph is updated — for both the agent and the resident, the witnessed event becomes a permanent entry in their respective records.

The record is immutable. You can annotate or dispute later events, but you cannot edit or delete what was witnessed.

The Trust Graph

The Trust Graph is the accumulated record of every witnessed event tied to a RIN. It isn’t a score or a rating — it’s a timeline of verified facts. Each entry carries a timestamp, a confirmation from a named professional, and a link to the underlying transaction.

Over time, the Trust Graph tells a complete story:

• A resident with five years of on-time payments has a Trust Graph that proves it — not a claim, a record.
• An agent with 300 confirmed receipts across Lagos, Ibadan, and Abuja has a professional Trust Graph that any landlord can inspect.
• A property with a clean maintenance record and no unresolved disputes has a property Trust Graph that protects the next tenant and the next landlord.

The Trust Graph is national and permanent. It follows the RIN holder across every state, every property, and every role they occupy.

The core workflow

The lifecycle of a tenancy on Leja follows a predictable sequence. Each step leaves a witnessed record.

1. Property created

   An agent or property manager adds a property to Leja Professional. The property receives a Property RIN — a permanent identifier that will accumulate the property’s entire history of tenancies, maintenance events, and condition records, surviving ownership changes.

2. Tenant added

   The agent adds the tenant to the property. The tenant’s Resident Identity Number (RIN) links the tenancy to their personal record. If the tenant doesn’t have a RIN yet, Leja creates one at this point using their verified NIN.

3. RIN issued

   The tenant’s RIN is confirmed and active. From this moment, every event in this tenancy — payments, agreement signings, maintenance requests, deposit movements — will attach to their permanent identity.

4. Payment confirmed

   When a payment is due and received, the agent confirms it on Leja Professional. This is the witnessing act. The agent attests that the payment happened, which creates the immutable record. No AI action modifies the ledger without this human confirmation.

5. Receipt generated

   Leja generates a state-compliant receipt automatically. The receipt reflects the correct legal format for the property’s state — Lagos Tenancy Law 2011, Oyo State 2006, FCT Tenancy Act 2008, or whichever applies — with no manual configuration required.

6. Trust Graph updated

   Both the agent’s professional record and the resident’s Trust Graph update simultaneously. The event is now permanent. The resident can view it in their Resident dashboard. The agent’s cumulative record grows by one more verified transaction.

The two product surfaces

Leja Professional and Resident are not separate products — they are two sides of one ecosystem. The same witnessed event that creates a receipt on the Professional side creates a Trust Graph entry on the Resident side. Both parties hold a permanent record of the same transaction, verified by the same confirming agent.

Leja Professional

Property managers and agents are the primary witnesses. Every action you take — adding a tenant, confirming a payment, generating an agreement — creates a formal record in the ledger. Your tools include:

• Portfolio management — properties, tenants, and occupancy tracked in one place
• Payment confirmation and receipting — witnessed payments with auto-generated state-compliant receipts
• Agreement generation — tenancy agreements drafted to the correct legal standard for the property’s state
• Payment statements — auditable ledger statements for landlords and tenants
• Professional Record — your verified track record as an agent, built from every confirmed transaction

Resident

Residents access the records that professionals created on their behalf, and build their own economic identity across three tracks. Your tools include:

• Trust Graph view — your complete payment history, verified and permanent
• RIN dashboard — your identity, your deposit status, your tenancy timeline
• Track 1 (Residential) — every tenancy event, confirmed by your agents and managers
• Track 2 (Service provider) — your work record if you provide property-adjacent services
• Track 3 (Space seeker) — your search, viewing, and booking history

How they interconnect

Every transaction creates a loop. When an agent confirms a payment:

• The agent’s professional record gains a verified transaction
• The resident’s Trust Graph gains a permanent payment entry
• The property’s RIN gains a tenancy event
• The state-compliant receipt is available to both parties immediately

Neither surface is complete without the other. The agent’s confirmation is what gives the resident’s record its integrity. The resident’s RIN is what gives the agent’s record its permanence. The loop closes both ways.

Records created before a resident joins Leja are not lost. When a resident claims their RIN, events that were already witnessed on their behalf — tenancies, payments, agreements — become part of their Trust Graph retroactively, provided the confirming agent is on the platform.