📖
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
  • Typical Projects
  • Mitigation Action
  • Target Consumers
  • Minimum Household Participation
  • Grid Transition
  • Excluded Cases
  • Minimum Household Participation
  • Metering and Measurement
  • Master-Meter and Sub-Master-Meters
  • Consumption Calculation
  • Emission Reduction Limit
  • Applicability Conditions
  • Important Parameters
  • Need and Use for the AMS-III.BB Policy
  • Policy Workflow
  • Policy Guide
  • Available Roles
  • Important Documents & Schemas
  • Tools Referenced
  • Token (Carbon Emission Reduction)
  • Step by Step
Export as PDF
  1. Preloaded Policy Guides
  2. Carbon Offsets

CDM AMS III.BB: Electrification of communities through grid extension

PreviousCDM AMS-III.D.: Methane Recovery in Animal Manure Management SystemsNextCDM AR-ACM0003: Methodology for Afforestation and Reforestation of Lands Except Wetlands

Last updated 10 months ago

Table of Contents

Introduction

The AMS-III.BB methodology is a pivotal framework under the Clean Development Mechanism (CDM). This methodology focuses on projects that supply electricity to communities previously disconnected from national or regional grids and reliant on high-carbon-intensive mini-grids or stand-alone power generators. Additionally, it addresses the displacement of fossil fuel-based lighting systems, contributing to the reduction of greenhouse gas (GHG) emissions. In this document, we will go over the components of AMS-III.BB, exploring how it enables low-carbon-intensive grid and mini-grid electricity to displace high-carbon-intensive sources.

Typical Projects

AMS-III.BB is tailored for electrification endeavors that bring power to communities previously excluded from national or regional grids. These projects typically serve areas where high-carbon-intensive mini-grids or stand-alone generators were the primary sources of electricity. In some cases, fuel-based lighting systems were also in use before project implementation.

Mitigation Action

A fundamental goal of AMS-III.BB is the displacement of high-carbon-intensive electricity or lighting services with low-carbon-intensive grid or mini-grid electricity. By facilitating this shift, the methodology plays a significant role in mitigating GHG emissions and advancing sustainability.

Target Consumers

AMS-III.BB projects have a broad reach, providing electricity to diverse consumer groups. These consumers include households, commercial facilities such as shops, public services, buildings, and small and medium-sized enterprises (SMMEs). The electricity generated can power a range of applications, from lighting to electrical appliances and even agricultural water pumps, thereby fostering economic development and improving quality of life.

Minimum Household Participation

A requirement of AMS-III.BB is that at least 75 percent of the project consumers must be households. This ensures that a substantial portion of the community benefits from the electrification efforts, aligning with the goal of inclusive development.

Grid Transition

AMS-III.BB methodology is particularly relevant in situations where consumers were previously unconnected to national or regional grids. It also applies when a fraction of consumers previously reliant on carbon-intensive mini-grids transitions to a less carbon-intensive regional/national or mini-grid. In both cases, the methodology facilitates the transition toward cleaner and more sustainable energy sources.

Excluded Cases

While AMS-III.BB embraces various electrification approaches, it excludes portable electricity generating systems. This exclusion helps maintain the methodology's focus on more comprehensive and sustainable electrification solutions.

Minimum Household Participation

A fundamental requirement of AMS-III.BB is that at least 75 percent of the project consumers must be households. This ensures that a substantial portion of the community benefits from the electrification efforts, aligning with the goal of inclusive development.

Metering and Measurement

Effective metering and measurement are integral to AMS-III.BB projects. The methodology mandates metering of electricity consumption, particularly for Type I consumers expected to consume more than 1000 kWh per year. Prepaid devices for purchasing electricity are considered equivalent to traditional metering, ensuring accurate monitoring of energy consumption.

Master-Meter and Sub-Master-Meters

To facilitate accurate monitoring, some AMS-III.BB projects may require master-meters to measure the gross electricity sent out to all consumers. Additionally, sub-master-meters are utilized for those consumers who are not individually metered. Exceptions are made when all consumers are individually metered, or when a sample-based survey is employed.

Consumption Calculation

For household consumers not individually metered (Type I-NM), consumption is calculated through various methods, including sub-master-meter readings or sample surveys. In contrast, metered households (Type I-M) and non-household consumers (Type II) have their consumption measured using standard electricity meters or billing records from prepaid connections.

Emission Reduction Limit

AMS-III.BB methodology is limited to projects resulting in emission reductions of less than or equal to 60 kt CO2 equivalent annually. This cap ensures that the methodology remains aligned with its emissions reduction goals while allowing for flexible and sustainable electrification solutions.

Applicability Conditions

AMS-III.BB is applicable under specific conditions, including:

  • Limited to communities lacking access to national or regional grids.

  • A requirement that at least 75% of the end users are households.

Important Parameters

Key parameters play a vital role in the implementation and monitoring of AMS-III.BB projects:

  • During validation, the methodology necessitates the documentation of the physical location of each consumer, their anticipated connected load, and expected usage hours.

  • Monitoring involves metering the total electricity delivered to consumers, with the option of using prepaid devices for this purpose.

  • Metering is essential for tracking electricity consumption among non-household end users (e.g., commercial consumers, small and medium-sized enterprises, public institutions, street lighting, and irrigation pumps) and household end-users projected to consume more than 1000 kWh per year.

Need and Use for the AMS-III.BB Policy

The AMS-III.BB methodology plays a vital role in addressing the growing need for sustainable electrification in communities that lack access to reliable electricity. It provides a structured approach for projects aimed at extending the grid or constructing new mini grids to connect consumers who were previously off the grid. These initiatives aim to displace high-carbon-intensive electricity sources and fuel-based lighting systems, thus reducing greenhouse gas emissions and fostering economic development in underserved regions. To understand the significance of AMS-III.BB, it's essential to compare the merits and considerations of mini grids versus grid electricity.

Mini-grids are localized power generation and distribution systems, often deployed in remote or rural areaswhere connecting to the national or regional grid is cost-prohibitive. They bring electricity to communities that were once reliant on high-carbon-intensive mini-grids or stand-alone power generators. While mini grids offer reliable electricity access and the potential to integrate renewable energy sources, they can be economically challenging to establish and may rely on fossil fuel generators. In contrast, grid electricity operates within large, interconnected networks, benefiting from economies of scale and efficient power transmission. Grids can access a diverse energy mix, including renewables, and are subject to stringent environmental regulations, generally resulting in lower emissions compared to mini grids. The choice between mini-grids and grid electricity depends on the specific needs, geographic location, and economic viability of the targeted community or region.

Policy Workflow

Policy Guide

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

Available Roles

  • Project Proponent - The project proponent is responsible for executing the emission reduction project. The project proponent must adhere to the requirements outlined by the CDM and provide evidence of the emission reductions achieved. Upon successful verification, the project proponent receives certified emission reduction (CER) tokens as an incentive for their emission reductions.

  • Verification and Validation Body (VVB) - The VVB plays a critical role in independently verifying and validating the project data submitted by the project proponent. They thoroughly assess the project's emission reduction potential, methodologies, and adherence to the policy guidelines. Based on their evaluation, the VVB either approves or rejects the project for registration.

  • Registry (UNFCCC) - The United Nations Framework Convention on Climate Change (UNFCCC) serves as the registry for the CDM. They oversee the multiple workflow steps involved in the project's approval, including the verification and validation process by the VVB. The UNFCCC's approval is necessary for the project's successful registration and issuance of CER tokens.

Important Documents & Schemas

  • Project Description - Project Proponent information, standard project information, methodology information like baseline emissions, project emissions, etc.

  • Emissions Reduction – Schema included within the project information form; this is filled out by the project proponent to calculate annual emission reductions.

  • Monitoring Report – The monitoring report is to be filled out based on the monitoring plan mentioned within the methodology.

Tools Referenced

  1. Methodological Tool 07 - Tool to calculate the emission factor for an electricity system.

  2. Methodological Tool 21 - Demonstration of additionality of smallscale project activities.

  3. Methodological Tool 33 - Default values for common parameters.

Token (Carbon Emission Reduction)

Certified Emission Reduction (CER) credits, each equivalent to one tonne of CO2.

Step by Step

  1. Login as Standard Registry and import the policy either by file or through IPFS timestamp, which is mentioned above.

  2. Once policy is imported, we need to open the policy and see all the steps involved in it:

  1. Now, we need to create new user and assign role as Project Participant.

  1. Name new Project Participant:

  1. Now, the project participant waits for its name's approval

  1. Now we create a new user and assign its role as VVB

  1. Once role is assigned, we need to give a name to VVB:

  1. Once name is assigned, VVB waits for its name to be approved by Standard Registry:

  1. Now we login as SR and view the documents submitted by VVB and Project Participant and approve their requests by clicking on Approve button:

  1. Once approved, we login back as Project Participant and create new project by clicking on New Project and entering complete details of the project:

  1. Once project details are submitted, it waits for SR to approve it:

  1. Login back as SR and after reviewing the document, it approved the project submitted by Project Participant

  1. Now Project Participant creates monitoring report by clicking on Add Report and fills out the monitoring report form.

  1. After creating monitoring report, project participant assigns VVB to approve it:

  1. Now, we login as VVB and after reviewing the monitoring report, VVB approves it:

  1. Now we login as SR and once it is reviewed, SR approves the Monitoring report

  1. Once minting is completed after clicking on Mint, we can view Trustchain by clicking on "View Trustchain"

🗺️
🌳
🏭
Introduction
Typical Projects
Mitigation Action
Target Consumers
Minimum Household Participation
Grid Transition
Excluded Cases
Minimum Household Participation
Metering and Measurement
Need and Use for the AMS-III.BB Policy
Policy Workflow
Policy Guide
Available Roles
Important Documents & Schemas
Tools Referenced
Token (Carbon Emission Reduction)
Step by Step