📖
Managed Guardian Service Documentation
HomeSupportContact UsAbout
  • 👋The Next Generation of Registry Systems
  • Overview
    • 🌎Quick Start - MGS
    • 🌐Quick Start - Indexer
      • 🌐Existing MGS Account Users
      • 🌐New User Without an MGS Account
    • ✨Key Features of Managed Guardian Service (MGS)
    • 🤖Custom MGS ChatGPT Assistant
  • LEARN
    • 🎬Important Concepts
      • ☺️Types of Users
      • ⛓️About the Trust Chain
      • 📂About Schemas
      • 🔃About Policies
      • 🎮About Dry Run
      • ⚖️About Retirement
      • 🔐About MGS Vault
    • 📽️Methodology Breakdown
  • 🆕WHAT'S NEW
    • Changelog
      • Beta v11
      • Beta v10.2
      • Beta v10.1
      • Beta v10
      • Beta v9
      • Beta v8
      • Beta v7
      • Beta v6
      • Beta v5.1
      • Beta v5
      • Beta v4
      • Beta v3.2
      • Beta v3.1
      • Beta v3
      • Beta v1
      • Beta v2
  • TECHNICAL INFORMATION
    • Two-Factor Authentication (2FA) Setup Guide
    • 📯Tenant Admins
      • ☁️Azure B2C Single Sign-On (SSO) Integration Guide
      • 🗃️IPFS Storage Providers
        • ☑️Compatible IPFS Storage Providers
        • ☁️Managed IPFS Node
          • 🗃️Integrating Managed IPFS Node with MGS Tenants
        • ☁️Web3.Storage
          • 🔐How to Generate Web3.Storage Key and Proof
          • 🗃️Integrating Web3.Storage with MGS Tenants
        • ☁️filebase
          • 🔐Setting up filebase
          • 🗃️Integrating filebase with MGS Tenants
      • 🛠️Tenant Operations
        • ⚙️Tenant APIs
          • Return Tenants
          • Return user Tenants
          • Create New Tenant
          • Return Tenant Related Settings
          • Send Invite Link
          • Delete Tenant
          • Return Users for Tenant
          • Delete Tenant User
          • Reorder Tenants
      • 🖥️Creating Tenants using the UI
    • 👨‍💻Users
      • 🏫Standard Registry Users, Schemas, and Policies
        • 🛠️Schemas
          • 📂Available Schema Types
          • 📁Property Glossary
          • ℹ️System / Policy Schemas
          • 🖥️Creating a System Schema using the UI
          • 🖥️Creating a Policy Schema using the UI
          • 💻Creating Tag Schemas using UI
          • ⚙️Schema Creation Using APIs
            • Listing of Schema
            • Publishing schema based on schema ID
            • Updating Schema
            • Deleting a Schema
            • Schema Preview from IPFS
            • Schema Preview from Zip
            • Export message IDs of Schema
            • Export Files from Schema
            • Creation of Schema related to the topic
            • Returns all Schemas related to the topic
            • Importing Zip file containing Schema
            • Import schema from Zip
            • Returning Schema by SchemaID
          • ⚙️System Schemas APIs
            • Creates New System Schema
            • Returns Schema by Type
            • Returns Schema by Username
            • Updates the Schema
            • Delete System Schema
            • Publishes the Schema
            • Schema Type
          • ⚙️Schema Related APIs for Asynchronous Execution
            • Creation of Schema
            • Publishing Schema
            • Previews the Schema from IPFS
            • Importing Schema from IPFS
            • Importing Schema from .zip
          • 📁Schema Tree
            • 💻Schema Tree UI
            • ⚙️Returning Schema Tree API
          • 📁Example Data
            • 💻Adding Example data using UI
          • 📁Schema Differentiation
            • 💻Schema Differentiation using UI
            • ⚙️Schema Differentiation APIs
              • Returns Result of Schema comparison
              • Exports Schema Differentiation Results
          • 📁Tag Schema
            • ⚙️Tag Schema APIs
              • Returning all Schema Tags
              • Creating new Schema Tag
              • Deleting Schema Tag
              • Updating Schema Tag
              • Publishing Schema
              • Returning list of published schemas
          • Schema Predefined Values
          • Schema Rules
            • Defining Schema Rules using UI
            • APIs related to Schema Rules
              • Creation of the new schema rule
              • Retrieve the schema rules
              • Retrieve the configuration of the rule by its ID
              • Update the configuration of the rule with the corresponding ID
              • Delete the rule by its ID
              • Activate the rule with the specified ID
              • Deactivate the rule with the specified ID
              • List all the schemas and policy relevant to the rule with the specified ID
              • Retrieve all the data needed for evaluating the rules
              • Create a new rule from the file
              • Load the file and return its preview
              • Export the selected rule (by ID) into the file
        • 🛠️Policies
          • 🎓Policy Glossary
          • 🔄Available Policy Workflow Blocks
            • InterfaceContainerBlock
            • PolicyRolesBlock
            • InterfaceStepBlock
            • requestVCDocumentBlock
            • sendToGuardianBlock
            • reassigningBlock
            • InformationBlock
            • InterfaceDocumentsSourceBlock
            • paginationAddon
            • DocumentsSourceAddOn
            • filtersAddOnBlock
            • InterfaceActionBlock
            • externalDataBlock
            • retirementDocumentBlock
            • wipeDocumentBlock
            • calculateMathAddOnBlock
            • reportBlock & reportItemBlock
            • switchBlock
            • TimerBlock
            • aggregateDocumentBlock
            • revocationBlock
            • setRelationshipsBlock
            • Button Block
            • documentValidatorBlock
            • tokenActionBlock
            • tokenConfirmationBlock
            • mintDocumentBlock
            • groupManagerBlock
            • multiSignBlock
            • customLogicBlock
            • splitBlock
            • create Token Block
            • Impact Addon
            • Http Request Block
            • historyAddOn
            • selectiveAttributes Block
            • tagsManagerBlock
            • extractDataBlock
            • externalTopicBlock
            • messagesReportBlock
            • notificationBlock
            • Button BlockOn Addon
            • Data Transformation Addon
            • Events
          • 💻Creating Policy using UI
          • 🖥️Creating a Policy using Policy Configurator
            • Getting Started with the Policy Workflows
            • Policy Workflow Step 1
            • Policy Workflow Step 2
            • Policy Workflow Step 3
            • Policy Workflow Step 4
            • Policy Workflow Step 5
            • Policy Workflow Step 6
            • Policy Workflow Step 7
            • Policy Workflow Step 8
            • Policy Workflow Step 9
            • Policy Workflow Step 10
            • Policy Workflow Step 11
            • Policy Workflow Step 12
            • Policy Workflow Step 13
            • Policy Workflow Step 14
            • Policy Workflow Step 15
            • Policy Workflow Step 16
            • Policy Workflow Step 17
            • Policy Workflow Step 18
            • Policy Workflow Step 19
            • Policy Workflow Step 20
            • Policy Workflow Step 21
            • Policy Workflow Step 22
            • Policy Workflow Step 23
            • Policy Workflow Step 24
            • Policy Workflow Step 25
            • Policy Workflow Wrap Up
          • ⚙️Creating a Policy using APIs
            • Prerequesite Steps
            • Creation of a Policy
            • Policy Listing
            • Policy from IPFS
            • Policy Preview from IPFS
            • Retrieves Policy Configuration
            • Updates Policy Configuration
            • Publish a Policy
            • Policy Validation
            • Retrieval of Data from Root Policy Block
            • Request Block Data
            • Sends Data to Specified Block
            • Sends Data to specified Block by Tag
            • Returns Block ID by tag
            • Retrieves Block Data by Tag
            • Exporting Message ID
            • Export to zip file
            • Import from zip file
            • Returns list of Groups of a particular user
            • Make the selected Group active
            • Creating link between policies
            • Requesting Multi Policy Config
            • Imports open sourced policy
            • Allowed open sources list for import
            • Returns Open Source File URL
            • Returns OpenSourced policies list for import
          • 📂Dry Run
            • 🖥️Dry Run Mode using the UI
              • Dry Run Operations Guide
            • ⚙️Dry Run Mode using APIs
              • Running Policy without making any changes
              • Returning all Virtual Users
              • Creating Virtual Account
              • Logging Virtual User
              • Restarting the execution of Policy
              • Returns List of Transactions
              • Returns List of Artifacts
              • Returns List of IPFS Files
              • Returning Policy to Editing
              • Create Savepoint
              • Returns Savepoint State
              • Restoring SavePoint
              • Deletes SavePoint
          • 📁Record/Replay
            • 💻Policy execution record and replay using UI
            • ⚙️Record/Replay APIs
              • Get Recording
              • Start Recording
              • Stop Recording
              • Get Recorded Actions
              • Run record from zip file
              • Stop Running
              • Get Running Results
              • Fast Forward
              • Retry Step
              • Skip Step
          • 🪟External Events
            • ⚙️Send Data using the External Data APIs
              • Sends Data from External Source
          • ⚙️Trustchain APIs
            • Requesting
            • Building and returning
          • ⚙️Policy Related APIs for Asynchronous Execution
            • Creates new Policy
            • Publishing a Policy
            • Importing a Policy from IPFS
            • Importing a Policy from File
            • Policy Review
          • 🧑‍🤝‍🧑Roles and Groups
            • 💻Creating Roles and Groups using Policy Configurator UI
          • 📂Modules
            • 💻Modules using UI
            • ⚙️Modules APIs
              • Returns all Modules
              • Creating new Module
              • Returns Module Menu
              • Retrieves Module Configuration
              • Updates Module Configuration
              • Delete the module
              • Publishing Module onto IPFS
              • Returns Hedera ID for specific Module
              • Exporting Module in zip format
              • Import Module from IPFS
              • Import module from zip file
              • Preview Module from IPFS
              • Preview Module from zip file
              • Validates Module
          • 📂Tools
            • 💻Tools using UI
            • ⚙️Tools APIs
              • Creating new Tool
              • Returns list of tools
              • Creating new tool asynchronously
              • Deletes the tool
              • Retrieves Tool Configuration
              • Updates Tool Configuration
              • Publishes Tool onto IPFS
              • Publishes Tool into IPFS asynchronously
              • Validates Selected Tool
              • Returns Tools and its artifacts in zip format
              • Retrieves Hedera Message ID
              • Previews Imported Tool from IPFS
              • Imported Tool from IPFS
              • Previews Imported Tool from Zip
              • Importing Tool from Zip
              • Imports new tool from Zip Asynchronously
              • Imports new tool from IPFS Asynchronously
              • Returns List of Tools
          • 🔑Selective Disclosure
            • 📔User Guide
            • 💻Selective Disclosure Demo
          • 📂Policy Differentiation
            • 💻Global search and comparison UI
            • 💻Policy Differentiation using UI
            • ⚙️Policy Differentiation APIs
              • Comparing Policies
              • Searching Policies
              • Exports Comparison results
          • 📂Block/Policy Search
            • 💻Block Search using UI
            • ⚙️Block Search APIs
              • Searching Same Blocks
            • 💻Policy Search using UI
            • ⚙️Policy Search APIs
              • Search Policies
          • 📂Document Comparison
            • 💻Document Comparison using UI
            • ⚙️Document Comparison APIs
              • Compare Documents
              • Export of Comparison Result
          • 📂Tagging
            • 💻Tagging using UI
            • ⚙️Tagging APIs
              • Creating Tag
              • Searching Tag
              • Deleting Tag
              • Synchronization of Tags
          • 🤖Auto Suggestion
            • 💻Demo using UI
            • ⚙️Auto Suggestion APIs
              • Get next and nested suggested block types
              • Get suggestions configuration
              • Set suggestions configuration
          • 📂Themes
            • 💻Themes using UI
            • ⚙️Themes APIs
              • Returning all themes
              • Creating theme
              • Updating theme Configuration
              • Deleting theme
              • Returning zip file containing themes
              • Importing theme
          • 📂Policy Wizard
            • 💻Demo using UI
            • ⚙️Policy Wizard APIs
              • Creating new Policy
              • Getting Policy Configuration
          • 📁Discontinuing Policy
            • 💻User Guide
            • ⚙️APIs related to Discontinuing Policy
              • Discontinue Policy
              • Migrate Policy Data
              • Migrate Policy Data Asynchronously
              • Get Policy Documents
          • 📁Live Project Data Migration
            • ➡️Live Project Data Migration UI
            • ⚙️APIs related to Live Project Data Migration
              • Getting Policy Data
              • Uploading Policy Data
              • Getting Policy Tag Block Map
              • Getting Policy Virtual Keys
              • Uploading Policy Virtual Keys
          • Roles & Permissions
            • Roles and Permissions User Guide
            • APIs related to Roles & Permissions
              • Returns list of all permissions
              • Returns list of all roles
              • Creates a New Role
              • Updates Role Configuration
              • Deletes Role
              • Setting Default Role
              • Returns list of all users for whom the current user can change the role
              • Retrieves information about the user (roles, permissions assigned policies)
              • Updates User Roles (only SR)
              • Returns list of all Policies
              • Assigns Policies to a User - Only SR
              • Updates user roles (for ordinary users)
              • Assigns policies to a user (for ordinary users)
          • 📁Import/Export from Excel
            • 💻Import and Export Excel file User Guide
            • ⚙️APIs related to Import/Export Schemas from Excel
              • Import Schemas in Excel file format into local DB
              • Asynchronously Imports Schemas in Excel file format into a policy
              • Previews Schema from Excel file
              • Returns Schema in Excel file format
              • Returns list of Schemas
              • Exporting Policy to Excel
              • Import Schemas in Excel file format into a Policy
              • Policy Preview from Excel file
          • 💻Demo on Integrating external policies using UI
          • 📁Policy Labels
            • Policy Labels UI
            • APIs related to Policy Labels
              • Creating new Label definition
              • Retrieve the list of Label definitions
              • Retrieve a label definition configuration by ID
              • Update Label configuration by ID
              • Delete Label definition by ID
              • Publish Label definition by ID
              • Publish Label definition by ID asynchronously
              • Retrieve the list of components for Label configuration (schemas, policies, etc)
              • Import Label configuration from a file
              • Export Label configuration to a file
              • Preview of the imported file
              • Search for Labels and Statistics for importing into Label configuration
              • Retrieve the list of created tokens (VPs) for which a Label document can be created
              • Retrieve token (VP) and all its dependencies by document ID
              • Create a new Label document for token (VP)
              • Retrieve a list of created Label documents
              • Retrieve Label document by ID
              • Retrieve linked Label documents by ID
          • Formula Linked Definitions
            • Formula Linked Definitions using UI
            • APIs related to Formula Linked
              • Creating a new formula
              • Returns a list of formulas
              • Returns a formula by its ID
              • Update the formula by its ID
              • Delete the formula by its ID
              • Retrieve the list of all schemas and policies linked to a Formula
              • Create a new formula (import) from a file
              • Export selected formulas into a file
              • Loads (import) a file and return its preview
              • Publish a formula
              • Retrieve all data from documents that needed for displaying the formula
          • Decentralized Guardian
            • Remote Policy UI
            • ⚙️APIs
              • Returns the list of requests for adding remote policies
              • Previews the policy from IPFS without loading it into the local DB
              • Policy Import from IPFS
              • Approves policy Asynchronously
              • Rejects policy Asynchronously
              • Approves Policy
              • Rejects policy
              • Return a list of all policies requests
              • Approves a request for an action from a remote Guardian
              • Rejects a request for an action from a remote Guardian
              • Return a count of policy requests
              • Returns the list of existing keys
              • Creates a new key
              • Deletes the key with the specified ID Copy
          • 📔Artifacts
            • 💻Importing/Deleting Artifacts using UI
            • ⚙️Artifacts APIs
              • Returns all Artifacts
              • Upload Artifacts
              • Delete Artifact
          • 🔔Notifications
            • 💻User Guide
            • ⚙️APIs related to Notifications
              • Get all Notifications
              • Get new Notifications
              • Get Progresses
              • Read All Notifications
              • Delete Notifications
        • 🛠️Standard Registry Operations
          • ⚙️Task Status APIs
            • Returning Task Statuses
      • 🛠️User Operations
        • ✖️Multi Policy
          • 💻Configuring Multi Policy using UI
        • 🤖AI Search of Methodologies
          • 💻AI Search using UI
          • ⚙️AI Search APIs
            • Returns response
            • Rebuilds vector based on policy data
        • 🔎Guided Search of Methodologies
          • 💻Search using UI
          • ⚙️Search APIs
            • Retrieves list of all categories
            • List of policies that are best suited for given parameters
        • ⚙️Account APIs
          • Display User List
          • User Balance
          • User Session
          • User Login
          • Registering new account
          • Returns all Standard Registries
          • Requests Password Reset
          • Sets New Password
          • Current version terms of use
          • Accept terms of use
          • Returns all Standard Registries with Policies and VC Documents
        • ⚙️Profile APIs
          • User Account Balance
          • User Account Information
          • Setting User Credentials
          • Setting User Credentials Asynchronously
          • Setup Vault for user secrets
        • ⚙️Artifacts APIs
          • Returns all Artifacts
          • Upload Artifacts
          • Delete Artifacts
        • Bottom Up Data Traceability
          • Bottom Up Data Traceability using UI
          • APIs related to Statistics Report
            • Create new Statistics Definition
            • Get the list of Statistics Definitions
            • Retrieve details of the Statistics Definition by ID
            • Update configuration of the Statistics Definition by ID
            • Delete the Statistics Definition by ID
            • Publish Statistics Definition by ID
            • Retrieve the list of linked schemas and policy
            • Retrieve the list of all documents conforming the rules of the Statistics Definition
            • Create a new Statistics Assessment based on the Statistics Definition
            • Retrieve the list of existing Statistics Assessment
            • Retrieve the Statistics Assessment by ID
            • Retrieve all VC documents related to the Statistics Assessment
            • Importing Statistic from zip file
            • Exporting statistic report to a file
            • Previews the statistic report imported from zip file
      • 📁Bring your own DIDs
        • 💻Bring Your Own (BYO) DIDs UI
        • ⚙️BYO APIs
          • Validate DID Format
          • Validate DID Keys
      • Asynchronous Tasks Status
      • Show list of Hedera Transactions
        • Showing List of Hedera Transactions UI
        • APIs
          • Returning all transactions for Policy
          • Returning all transactions for Schema
          • Returning all transactions for Contract
          • Returning all transactions for Tokens
      • 🔐MGS Vault
        • ☑️Compatible Vaults
        • 🔑MGS Vault
          • 🎙️Introducing MGS Vault
          • ⚙️HashiCorp Vault Setup
          • ⚙️HashiCorp Vault Integration with MGS
        • 🔑Microsoft Azure Key Vault
          • 🎙️Introducing Microsoft Azure Key Vault
          • ⚙️Microsoft Azure Key Vault Setup
          • ⚙️Microsoft Azure Key Vault Integration with MGS
        • 🔑Google Cloud Platform Secret Manager
          • 🎙️Introducing Google Cloud Platform Secret Manager
            • ⚙️GCP Secret Manager Setup
            • ⚙️GCP Secret Manager Integration with MGS
    • 🕐Obsolete Guardian Artifacts
    • 📁Project Comparison
      • ⚙️Project Comparison APIs
        • Comparing Documents
        • Retrieves all categories
        • Retrieves all Properties
        • Search Projects by filters
    • Global Indexer
      • Indexer User Guide
      • APIs related to Indexer
        • Full Text Indexer Search
        • Returns Standard Registries
        • Returns Registry as per MessageID
        • Returns Registry Users
        • Returns Registry User as per MessageID
        • Returns Policies
        • Returns policy as per MessageID
        • Returns Tools
        • Returns Tool as per MessageID
        • Returns Modules
        • Returns Module as per MessageID
        • Returns Schemas
        • Returns Schema as per MessageID
        • Returns Schema Tree
        • Returns Tokens
        • Returns Token as per TokenID
        • Returns Roles
        • Returns Role as per MessageID
        • Returns DIDs
        • Returns DID as per MessageID
        • Returns DID Relationships
        • Returns VP Documents
        • Returns VP Document as per MessageID
        • Returns VP Relationships
        • Returns VC Documents
        • Returns VC Document as per MessageID
        • Returns VC Relationships
        • Returns NFTs
        • Returns NFT as per Serial No.
        • Returns Topics
        • Returns Topic as per TopicID
        • Returns Contracts
        • Returns Contract as per MessageID
        • Returns Landing Page Analytics
        • Returns Project Coordinates
        • Returns Search Policy Results
        • Attempts to refresh linked files for the selected documents
        • Returns Hedera Network
        • Returns Hedera Network Explorer Settings
        • Returns Data Loading Progress Result
        • Returns Registry Relationships
        • Returns Policy Relationships
        • Retrieve the list of formulas
        • Retrieve the formula by message ID
        • Retrieve linked documents which are related to formula
        • Returning Topic Data Priority Loading Progress
        • Adding Topic Data Priority Loading
        • Adding Policy Data for Priority Loading
        • Adding Token Data for Priority Loading
        • Adding Document to Data Priority Loading
    • ⚙️API Guideline
    • 🪙Tokens
      • 💻Creating Token using UI
      • 📁Token Template
        • 💻Creating Token Template using UI
        • 💻Creating Token through UI using Token Template
      • 🔎How to establish Token Authenticity
      • 🛠️Token Operations
        • ⚙️Token APIs
          • Token Listing
          • Creation of the token
          • User Info for selected token
          • Associates the user with token
          • Disassociates the user with token
          • Grants KYC for the user (Deprecated)
          • Grants KYC for the user
          • Revoke KYC of the user (Deprecated)
          • Revoke KYC of the user
          • Freeze tokens of a user
          • Unfreeze tokens of a user
      • 📁Token Retirement Contract
        • 💻Creating Contract using UI
        • TrustChain representation of token retirement
        • ⚙️Retirement APIs
          • Returning all contracts
          • Creating new Contract
          • Importing new Contract
          • Get Contract Permissions
          • Removing Contract
          • Returns a list of all Wipe requests
          • Enabling Wipe Requests
          • Disabling Wipe Requests
          • Approving Wipe Requests
          • Rejecting Wipe Requests
          • Clearing Wipe Requests
          • Adding Wipe Admin
          • Removing Wipe Admin
          • Adding Wipe Manager
          • Removing Wipe Manager
          • Adding Wipe Wiper
          • Removing Wipe Wiper
          • Syncing Retire Pools
          • Returning list of all Retire Requests
          • Returning list of all Retire Pools
          • Deleting Retire Requests
          • Deleting Retire Pools
          • Setting Retire Pools
          • Unsetting Retire Pool
          • Unsetting Retire Request
          • Retiring Tokens
          • Approving Retire Request
          • Cancelling Retire Request
          • Adding Retire Admin
          • Removing Retire Admin
          • Returning all Retired VCs
      • Dynamic Token Creation in Guardian Policies
    • ⛓️Trust Chain
      • 🛠️Trust Chain Operations
        • ⚙️Trust Chain APIs
          • Requesting
          • Building and Returning
    • 🔬Open-Source Guardian Architecture
      • 🔭High Level Architecture
      • 🔬Deep Dive Architecture
      • 👏Policies,Projects and Topics mapping Architecture
      • ➗MRV Splitting Logic
      • 🔑Internal (with Vault)Signing Sequence Diagram
      • 🔥FireBlocks Signing Sequence Diagram
    • 📄Full API Documentation
    • 📁Library of Policy Examples
      • 💻Creating and using Roles
      • 🔢Data input via Forms, using Roles to partition user activities
      • 🪙Token Operations
      • 📃MRV Document Operations
      • ⛓️TrustChain reports
      • ➗MRV aggregation and splitting for minting tokens
    • 🔁Process for Testnet Resets
      • Deleting Tenants and Re-inviting Users
      • Setup of a User Account
  • 🗺️Preloaded Policy Guides
    • 🌳Carbon Offsets
      • 🌲Verra Redd+ VM0007 Policy Guide
      • 👩‍🌾VM0017 Adoption of Sustainable Agricultural Land Management, v1.0
      • 👩‍🌾VM0042 Methodology for Improved Agricultural Land Management
      • 🌲VM0047 Afforestation, Reforestation, and Revegetation
      • 🌲Gold Standard Afforestation and Reforestation (AR) v2.0
      • 👷Carbon Reduction Measurement - GHG Corporate Standard Policy Guide
      • 👩‍🌾Dovu Methodologies (Agre Calc & Cool Farm)
      • 🚗Sustainable End-of-Life Vehicle Scrapping Program: Government Backed Voluntary Program
      • ♨️Improved Cookstove
      • ♨️GoldStandard - Metered Energy Cooking
      • 🏭CDM AMS-II.G.: Energy Efficiency Measures in Thermal Applications of Non-Renewable Biomass
      • 🏭CDM AMS-III.AR: Substituting fossil fuel based lighting with LED/CFL lighting systems
      • 🏭CDM AMS-III.D.: Methane Recovery in Animal Manure Management Systems
      • 🏭CDM AMS III.BB: Electrification of communities through grid extension
      • 🏭CDM AR-ACM0003: Methodology for Afforestation and Reforestation of Lands Except Wetlands
      • 🏭CDM ACM0001: Flaring or Use of Landfill Gas
      • 🏨CDM ACM0002: Grid-Connected Electricity Generation from Renewable Sources
      • 🏭CDM ACM0006: Electricity and Heat Generation from Biomass
      • 🏭CDM ACM0007: Conversion from Single Cycle to Combined Cycle Power Generation
      • 🏭CDM ACM0018: Electricity Generation from Biomass in Power-Only Plants
      • 🏨CDM AMS-I.A.: Electricity Generation by the User
      • 🏨CDM AMS-I.C.: Thermal Energy Production with or Without Electricity
      • 🏨CDM AMS-I.F.: Renewable Electricity Generation for Captive Use and Mini-Grid
      • 🏛️CDM AMS-II.J.: Demand-Side Activities for Efficient Lighting Technologies
      • 🏭CDM AMS-III.AV.: Low Greenhouse Gas Emitting Safe Drinking Water Production Systems
      • 🏭CDM AMS-III.F.: Avoidance of Methane Emissions Through Composting
      • 🏦CDM AMS-III.H.: Methane Recovery in Wastewater Treatment
      • 🏭PWRM0001 Plastic Waste Collection Methodology
      • 🥇Carbon Sequestration through Accelerated Carbonation of Concrete Aggregate
      • 🏭VM0044 Methodology for Biochar Utilization in Soil and Non-Soil Applications
      • 🏭VM0041 Methodology for the Reduction of Enteric Methane Emissions from Ruminants
      • 🏭AMS-I.D: Grid Connected Renewable Electricity Generation – v.18.0
      • 🏭PWRM0002 Plastic Waste Recycling Methodology
      • 🍚Methane Emission Reduction by Adjusted Water Management Practice in Rice Cultivation
      • ⛽Verra VMR0006: Energy Efficiency and Fuel Switch Measures in Thermal Applications
      • AMS-I.E Switch from Non-Renewable Biomass for Thermal Applications by the User
      • GCCM001 v.4 Methodology for Renewable Energy Generation Projects Supplying Electricity to Grid
      • Climate Action Reserve’s U.S. Landfill Protocol Version 6.0
      • Landfill Gas Destruction and Beneficial Use Projects, Version 2.0
      • VM0042 Improved Agricultural Land Management, v2.1
    • 🔋Renewable Energy Credits
      • 📡International Renewable Energy Credit Standard Policy guide
    • 🏭Carbon Emissions
      • 🏠Remote Work GHG Policy Policy Guide
      • 🏢Carbon Emissions Measurement - GHG Corporate Standard Policy Guide
      • 🏙️atma GHG Scope II Carbon Emission Policy
      • 🏢Atma Scope 3 GHG Policy
      • 🏢GHGP Corporate Standard
      • 🏭GHGP Corporate Standard V2
Powered by GitBook
On this page
  • Table of Contents
  • Introduction
  • Need and Use for the GHGP Corporate Standard Policy
  • Policy Workflow
  • Policy Guide
  • Available Roles
  • Important Documents & Schemas
  • Token (Carbon Emission)
  • Step by Step
  • Organization Flow
  • VVB Flow
  • Administrator (Registry)
  • Futureproofing (Automated GHG Inventories)
Export as PDF
  1. Preloaded Policy Guides
  2. Carbon Emissions

GHGP Corporate Standard V2

PreviousGHGP Corporate Standard

Last updated 6 months ago

Table of Contents

Introduction

The GHG Protocol Corporate Accounting and Reporting Standard (GHGP Corporate Standard) is the world’s leading standard outlining requirements and guidance for corporate-level and organizational-level GHG emission inventories. Approximately 92% of Fortune 500 companies responding to the CDP—an investor-led effort to increase corporate carbon disclosures—referenced the used the GHGP Corporate Standard to conduct their GHG inventories.[1] Also, many other GHG-related standards—such as the Natural Capital Partner’s CarbonNeutral Protocol and the Science Based Targets Initiative (SBTi)—point to the Greenhouse Gas Protocol as the commonplace standard for the quantification and accounting of corporate GHG emissions. As future regulations and standards are developed and implemented, they may either prescribe or encourage the use of Greenhouse Gas Protocol standards.

This Guardian Policy mints Carbon Emission Tokens (CETs) in accordance with the GHGP Corporate Standard, including the Scope 2 Guidance, which was later published as an amendment to the GHGP Corporate Standard. In addition, the policy includes functionality to attribute emissions to products and services and use this data to calculate and publish product carbon footprints (PCFs) in accordance with the Pathfinder Framework v2.0. The policy and methodologies are designed to calculate emissions based on MRV data that can either be input manually by the organization, or automatically through API and trusted external data sources. The policy is equipped with standard emission factors (such as eGRID emission rates) and Intergovernmental Panel on Climate Change (IPCC) global warming potentials (GWPs).

The policy currently covers the following sources and future versions will have the ability add new modulated source categories and custom source schemas.

Included Sources:

- Scope 1: Stationary Combustion

- Scope 1: Mobile Combustion

- Scope 1: Refrigerants

- Scope 2: Purchased Electricity (Location-Based)

- Scope 2: Purchased Electricity (Market-Based)

- Scope 3.1: Purchased Goods and Services

- Scope 3.4: Upstream Transportation and Distribution

The policy is designed to be dynamic, allowing companies to assign entities to organizations, assets(facilities, vehicles, equipment, etc.) to entities, and GHG sources to assets/EGOs in a hierarchical structure to dynamically tailor the policy and inventory to specific corporate structures and operations.

Need and Use for the GHGP Corporate Standard Policy

According to the IPCC, in order to avoid potentially irreversible impacts of climate change, global GHG emissions should be reduced by approximately 45% by 2030 (relative to 2010 levels) and achieve net zero by around 2050. Therefore, it comes as no surprise that many of the largest companies in the world are increasingly aligning their GHG reduction targets with the latest scientific studies, in an effort to both exhibit their commitment to sustainability, as well as to remain viable in a low-carbon future. The number of companies working with the Science Based Targets initiative (SBTi) has increased nearly 1,900% between 2015 and 2020, with 1,039 cumulatively committed companies representing nearly 20% of global market capitalization (over $20.5 trillion USD).

In addition to momentum in voluntary GHG commitments, there are several new regulations requiring the measuring and reporting of GHG emissions (outlined below):

The Securities and Exchange Commission (SEC) Climate Disclosure Rules: On March 6th, 2024, the SEC adopted rules to enhance and standardize climate-related disclosures by public companies and in public offerings. The rules will require registrants to disclose climate-related risks, targets, mitigating strategic efforts, and [for large, accelerated filers (LAFs) and accelerated filers (AFs) that are not otherwise exempted] scope 1 and 2 GHG emissions.

The European Union Corporate Sustainability Reporting Directive (CSRD): On January 5th, 2023, the EU’s Corporate Sustainability Reporting Directive (CSRD) took effect, strengthening existing rules on social and environmental reporting [including climate risks and impacts]. The rules will now apply to a broader set of companies, as well as non-EU companies generating over EUR 150 million on the EU market.

California Climate Corporate Data Accountability Act: On Oct. 7th, 2023. California Gov. Gavin Newsom signed into law California’s Climate Corporate Data Accountability Act, requiring corporations that do business in California, with annual revenues over $1 billion, to publicly disclose scope 1 and scope 2 GHG emissions beginning in 2026, and scope 3 emissions in 2027.

Despite a growing interest in measuring, disclosing, and reducing GHG emissions from corporations, regulators, and investors alike, companies are struggling to accurately measure and report emissions. In general, current quantification methodologies are flawed, GHG accounting standards leave significant room for error, access to quality data is low, and there is a prevailing lack of GHG accounting expertise. As a result, high-profile companies have been exposed for incorrect GHG inventories and worse, misleading claims on carbon performance. According to an article by Bloomberg, ‘Corporate Greenhouse Gas Data Doesn’t Always Add Up,’ “As companies rush to set climate goals, some aren’t even getting the basics quite right when it comes to accounting for greenhouse-gas emissions. According to researchers in Ireland, the U.K. and Germany, based on decade’s worth of corporate emissions data, “when the numbers were tallied, many didn’t add up. They found instances of errors, omissions and rounding issues (often down rather than up).”

The Guardian GHGP Corporate Policy offers a unique technical opportunity for companies to streamline, add robustness, and build trust and transparency into their GHG inventories. The policy allows users to dynamically add entities and assets to organizations and GHG sources to assets to build their inventories in alignment with their specific corporate and operational structures. MRV data can then be sourced by the Guardian automatically (e.g., via API, IoT-enabled devices, etc.) or provided manually depending on the user’s level of digitization. The inventory is further streamlined through Guardian policies with built in auto-calculation blocks, emission factors, and GWPs. The results of the inventory can be immutably and transparently verified by independent third parties. Finally, the emissions are tokenized to allow for enhanced tracking, transparency, accounting, and reporting, with the results and data structured in accordance with GHGP reporting requirements.

Policy Workflow

Policy Guide

This policy is published to Hedera network and can either be imported via Github (.policy file) or IPFS timestamp.

Latest Version - 1698402201.827872003

Available Roles

Registry – The role responsible for publishing policies, creating tokens, and issuing CETs to organizations in accordance with the policy and methodology.

Organization – Company or other organization generating, quantifying, and reporting GHG emissions. The organization also provides MRV data and receives CETs.

VVB (Validation & Verification Body) – Independent third party who audits organization’s critical documentation, MRV data and sources, and GHG inventories. Verification is optional for this policy as it is (as of this writing) optional under the GHGP Corporate Standard. The workflow steps involving the VVBs will not block the subsequent steps or the minting of CETs, therefore they can be 1) executed according to the workflow above, 2) skipped, or 3) executed later in the workflow.

Important Documents & Schemas

  1. Organizational Profile – The company or organization creates a profile of key information, targets, and reporting metrics. Entities (such as business units, subsidiaries, etc.) are assigned to the company or organization.

  2. Entity Schema – The company profiles with key information for each entity. Assets (such as facilities, vehicles, etc.) are assigned to entities. Together, the entities make up the corporate structure by which the inventory is based.

  3. Asset Schema — Information on company assets provided by the organization and GHG sources (such grid electricity, fuel consumption, etc.) are assigned to assets.

  4. Source Schema — Aggregated activity data (such electrical consumption, fuel consumption, etc.) which are used to auto-calculate GHG emissions.

  5. Raw Data Schema — Raw activity data sourced manually or automatically from APIs or devices such as IoT-enabled electricity meters.

  6. Reporting Metrics — Key metrics to support reporting in alignment with the GHGP Corporate Standard.

  7. Product Carbon Footprint (PCF): Data fields outlined by the Pathfinder Framework v 2.0. The PCF is publishable and can be referenced by supply chain partners to support improved scope 3 calculations.

Token (Carbon Emission)

Carbon Emission Token (CET) equivalent to 1 metric ton of CO2e emissions.

Step by Step

Organization Flow

The Organization is responsible for inputting key data and information and assigning entities, assets, GHG sources, and devices in alignment with their corporate and operational structure.

1. Login into the service using credentials.

  1. Choose role “Organization.”

  1. Under the Token History tab, the user can view the Trust Chain, where all the collective VCs can be viewed.

  1. Create an Entity Profile for each applicable corporate entity (e.g., subsidiaries, business units, etc.). It is often good practice to have the corporate structure of the GHG inventory aligned with the corporate structure reflected in financial reporting, if applicable.

  1. If the company or organization has already set GHG reduction targets, add them here and input the required and applicable details. It is generally best practice to set targets in alignment with the Science Based Targets initiative (SBTi).

  1. For each organizational entity, add all assets that generate emissions (e.g., facilities, fleet vehicles, etc.).

  1. For each asset, add all applicable GHG sources and input the required and applicable fields. For example, common GHG sources for facilities are electricity, natural gas, and refrigerant consumption

  1. For each GHG source, enter activity data such as electricity consumption (kWh) for facilities or distance traveled (miles) for vehicles. MRV data can be provided manually by the organization, or sourced automatically from APIs or verified monitoring devices such as IoT-enabled meters that are assigned to specific GHG sources. During this step, market-based instruments such as Renewable Energy Certificates (RECs) can be allocated to applicable GHG sources.

  1. After all the applicable monitoring data is input for the reporting period, key reporting metrics will be automatically populated and can be viewed under the Reporting Metrics tab in the VC document.

  1. Once the reporting metrics have been calculated, a VVB can be assigned, and the metrics can be submitted for verification. This step is currently optional.

  1. If applicable, the organization can create and publish digital PCFs in alignment with the Pathfinder Framework v2.0. The PCF is based on all emissions attributed to a specific product/service IDs and made relative to the declared unit.

Supply chain partners can reference the PCF to support their scope 3 calculations.

  1. Under the Token History tab, the user can view the Trust Chain, where all the collective VCs can be viewed.

VVB Flow

  1. Once the organization assigns a VVB, the VVB will be able to approve or reject MRV data and GHG sources. The VVB will also be able to approve or reject the GHG inventory reporting metrics after it’s calculated by the Guardian. These steps are optional and can be skipped or executed later in the workflow.

Administrator (Registry)

  1. After the organizational emissions have been calculated, the Registry will approve or reject the CET issuance request, and consequently issue CETs if approved.

Futureproofing (Automated GHG Inventories)

In future iterations of the policy, GHG source schemas can be modulated, and new types of data sources can be added as necessary. In addition, new GHG source categories will be added, as well as an option to add custom source schemas and emission factors. These may be added to the Guardian policy in the form of policy modules.

The policy is designed to be dynamic, allowing organizations to assign entities to organizations, assets to entities, and GHG sources to assets in a hierarchical structure to dynamically tailor the inventory to specific corporate structures and operations. This aspect may also be modulated in future iterations of the policy.

GHGP v3 will include an optional tool to manage disclosures to the SEC in alignment with their Climate Disclosure Rules.

🗺️
🏭
🏭
Introduction
Need and Use for the GHGP Corporate Standard Policy
Policy Workflow
Policy Guide
Available Roles
Important Documents & Schemas
Token (Carbon Emission)
Step by Step
Organization Flow
VVB Flow
Administrator (Registry) Flow
Futureproofing (Automated GHG Inventories)
TODO
Sources can also be attributed to products and services when applicable to support PCF calculations and scope 3 accounting.