Skip to content

Latest commit

Β 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 

Repository files navigation

Integrate Hedera Guardian GHGP Corporate Standard V2 policy into the workflow so you can push event-ledger data into the policy, compute emissions in compliance with recognized standards, and then issue Carbon Emission Tokens (CETs). The policy follows the Greenhouse Gas Protocol Corporate Standard (including Scope 2 Guidance) and defines how MRV data should be structured, validated, and tokenized.


🌍 End-to-End Workflow Including GHGP Corporate Standard V2

1) Event Ledger β†’ Data Extraction

Extract daily resource usage from your event ledger:

Metric Unit Notes
Essential electricity kWh e.g., plant power
Non-essential electricity kWh e.g., refrigeration
Total water mΒ³ water consumption
Hot water mΒ³ sub-portion of total
Gas (low pressure) mΒ³ fuel source

Each record should be

  • timestamped
  • uniquely hashed
  • linked to a facility or asset in your ledger

2) Normalisation & Emissions Calculation

Before feeding into Guardian, normalize metrics and compute carbon emissions using GHGP-aligned factors. The GHGP Corporate Standard V2 policy expects:

βœ” Scope 1: direct combustion sources (e.g., gas) βœ” Scope 2: purchased electricity (location- or market-based) βœ” Optionally Scope 3 if needed later

β€Ό Important GHGP Scope 2 Guidance requires that electricity activity data (kWh) be multiplied by appropriate emission factors, and both location-based and market-based accounting are supported when available.

Example internal transformation

{
  "facility_id": "F-001",
  "date": "2026-02-05",
  "electricity_kwh": 600,
  "water_m3": 12.5,
  "hot_water_m3": 4.2,
  "gas_m3": 38,
  "scope1_co2e_t": ...,
  "scope2_co2e_t": ...
}

3) Prepare GHGP-Aligned MRV Payload

Guardian’s GHGP v2 policy uses a hierarchical entity β†’ asset β†’ source β†’ raw data model:

βœ” Organization Profile – company metadata βœ” Entity Schema – business unit / subsidiary βœ” Asset Schema – facility or equipment βœ” Source Schema – e.g., electricity meter, gas meter βœ” Raw Data Schema – actual MRV values for metrics βœ” Reporting Metrics – computed emissions aligned with GHGP

Your normalized measurements become MRV records under the β€œSource” schema.


4) Guardian Policy Ingestion & Validation

Process:

  1. Authenticate against Guardian using DID or API key

  2. Submit MRV data as a policy input

  3. Policy executes auto-calculations:

    • Applies GHGP emission factor tables
    • Maps raw activity to Scope 1/Scope 2 emissions
    • Checks completeness and structure
  4. Policy generates β€œReporting Metrics” β€” each linked to GHGP categories

Optional: A VVB (validation & verification body) can review the data before issuance, per GHGP workflow.


5) Token Issuance Logic

The GHGP Corporate Standard V2 policy defines a Carbon Emission Token (CET) equal to 1 metric tonne COβ‚‚e.

Issuance triggers when:

  • normalized activity data is submitted and valid
  • reporting metrics computed by the policy are verified (optional)
  • the organization requests issuance for the reporting period

Outcome: Guardian mints CET tokens based on total Scope 1 + 2 emissions computed under GHGP rules.


6) Transparent Audit Chain

Guardian preserves:

  • Raw MRV inputs
  • Policy execution logs
  • Emission calculations
  • Token minting transactions

This creates a verifiable trust chain compliant with reporting standards β€” ideal for ESG metrics, CSRD disclosures, or SBTi alignment.


🧠 Recommended Practices

βœ” Audit emission factors: Pull up-to-date grid or supplier specs βœ” Model scope boundaries carefully: Define whether your meters map to organization asset boundaries authorized for GHGP reporting βœ” Automate ingestion: APIs or IoT devices to populate MRV data βœ” Use hierarchical entity structure: Align with GHGP corporate boundary rules


Stage 0 β€” Foundations & Decisions (do this first)

0.1 Define reporting boundaries

Tasks

  • Define organizational boundary (legal entity vs operational control)
  • Define facility boundary (what meters belong to which facility)
  • Decide reporting cadence (daily ingestion β†’ monthly issuance is common)

Outputs

  • Boundary definition document
  • Facility & meter registry (IDs, location, scope mapping)

0.2 Decide Scope handling (per GHGP V2)

Tasks

  • Scope 1 β†’ Gas (low pressure)

  • Scope 2 β†’ Electricity (essential + non-essential)

  • Decide:

    • Location-based only or
    • Location + market-based (if supplier data exists)

Outputs

  • Scope mapping table
  • Emission factor source list (grid, gas, water)

Stage 1 β€” Event Ledger Extension (you own this)

You do not change the ledger’s core role. You extend it.

1.1 Add emissions-ready data model

Tasks

  • Ensure ledger events include:

    • Facility ID
    • Meter/source ID
    • Timestamp (ISO-8601, UTC)
    • Raw units (kWh, mΒ³)
  • Ensure immutability + hash generation

Outputs

  • Versioned event schema
  • Ledger event hash per record

1.2 Embed Normalisation & Calculation Component

You said this can live inside the ledger app β€” perfect.

Tasks

  • Unit normalization:

    • Electricity β†’ kWh
    • Water β†’ mΒ³
    • Gas β†’ mΒ³
  • Derived calculations:

    • Hot water energy (Ξ”T Γ— volume)
  • Apply GHGP-aligned emission factors

  • Separate:

    • Raw activity data
    • Calculated emissions

Outputs

  • Normalised activity dataset
  • Calculated emissions dataset
  • Deterministic calculation logic (versioned)

1.3 Evidence packaging

Tasks

  • Generate an evidence bundle per reporting period:

    • Ledger event hashes
    • Calculation version
    • Emission factor version
  • Store bundle hash on your side

Outputs

  • Evidence hash (this is what Guardian anchors)

Stage 2 β€” Guardian Environment Setup (Managed Service)

2.1 Guardian tenant configuration

Tasks

  • Confirm Managed Guardian endpoints

  • Create Guardian users & roles:

    • Organization Admin
    • Data Submitter
    • (Optional) Verifier/VVB

Outputs

  • Guardian identities
  • API credentials / DID mappings

2.2 Import GHGP Corporate Standard V2 policy

Tasks

  • Load GHGP Corporate Standard V2 policy

  • Review policy blocks:

    • Organization
    • Facility (Asset)
    • Emission Sources
    • Raw Data
    • Reporting Metrics
  • Freeze a policy version for production

Outputs

  • Active GHGP V2 policy instance
  • Policy version ID

Stage 3 β€” Data Mapping Layer (critical glue)

This is where most projects succeed or fail.

3.1 Map ledger β†’ Guardian schemas

Tasks

  • Map:

    • Facility β†’ Guardian Asset
    • Meter β†’ Guardian Source
    • Daily usage β†’ Raw Data schema
  • Explicitly map:

    • Essential electricity β†’ Scope 2
    • Non-essential electricity β†’ Scope 2 (separate source)
    • Gas β†’ Scope 1
    • Water β†’ Optional reporting metric

Outputs

  • Mapping specification document
  • JSON payload templates per schema

3.2 Build Guardian ingestion client

Tasks

  • Implement Guardian API client:

    • Authentication
    • Schema creation (once)
    • Raw data submission (recurring)
  • Handle:

    • Idempotency
    • Retry logic
    • Submission status tracking

Outputs

  • Guardian ingestion service/module
  • Submission logs

Stage 4 β€” Policy Execution & Validation Flow

4.1 Automated policy execution

Tasks

  • Trigger policy after:

    • Reporting period close
    • All facilities submitted
  • Monitor:

    • Validation failures
    • Missing sources
    • Unit mismatches

Outputs

  • Policy execution records
  • GHGP-compliant reporting metrics

4.2 Optional verification step (future-proof)

Tasks

  • Enable VVB review workflow (optional now)
  • Define approval thresholds (auto vs manual)

Outputs

  • Verifier decision logs
  • Audit-ready trail

Stage 5 β€” Token Issuance Design

5.1 Token model (recommended)

Carbon Emission Token (CET)

  • 1 token = 1 tCOβ‚‚e
  • Fungible (HTS)
  • Issued per org per reporting period

Tasks

  • Confirm token metadata
  • Define issuance trigger in policy

Outputs

  • Token definition
  • Issuance rules locked

5.2 Token lifecycle controls

Tasks

  • Define:

    • Holding accounts
    • Retirement mechanism
    • (Optional) Internal transfers
  • Prevent double issuance for same period

Outputs

  • Token governance rules
  • Retirement flow

Stage 6 β€” Operations, Monitoring & Governance

6.1 Monitoring & alerts

Tasks

  • Monitor:

    • Ledger β†’ Guardian drift
    • Failed submissions
    • Policy changes
  • Alert on:

    • Missing days
    • Anomalous consumption

Outputs

  • Ops dashboards
  • Alerting rules

6.2 Versioning & audit readiness

Tasks

  • Version:

    • Emission factors
    • Calculation logic
    • Guardian policy
  • Snapshot reports per period

Outputs

  • Immutable audit snapshots
  • Regulator-ready evidence pack

End-State Architecture (What You’ll Have)

  • Ledger β†’ system of record

  • Normalization component β†’ deterministic MRV engine

  • Guardian β†’ trust, policy, and issuance layer

  • Tokens β†’ cryptographic proof of emissions

  • Full audit chain:

    Raw event β†’ hash β†’ calculation β†’ Guardian policy β†’ token
    

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors