{"id":15910,"date":"2022-04-22T13:58:00","date_gmt":"2022-04-22T13:58:00","guid":{"rendered":"https:\/\/hederav2stg.wpenginepowered.com\/blog\/guardian-v2-0-the-next-generation-of-esg-marketplaces-built-on-hedera\/"},"modified":"2025-12-10T05:12:49","modified_gmt":"2025-12-10T05:12:49","slug":"guardian-v2-0-the-next-generation-of-esg-marketplaces-built-on-hedera","status":"publish","type":"post","link":"https:\/\/hedera.com\/blog\/guardian-v2-0-the-next-generation-of-esg-marketplaces-built-on-hedera\/","title":{"rendered":"Guardian v2.0: The next generation of ESG marketplaces built on Hedera"},"content":{"rendered":"
\n

For Earth Day 2022, Envision Blockchain is proud to announce the release of the 2.0 version of the Guardian.\u00a0<\/p>\n

The Guardian<\/a> is a modular open-source solution that includes best-in-class identity management and DLT libraries for developers to get started creating ESG assets, such as carbon offsets and credits. It allows for full discoverability and traceability of ESG assets to be put into practice.\u00a0<\/p>\n

Since its introduction, DOVU<\/a>, CivicLedger<\/a>, Tymlez<\/a> (who\u2019s customers include Queensland Government, UON, and TROEF), and numerous Hedera Governing Council<\/a> members have adopted the Guardian.<\/p>\n

Guardian v2.0 delivers new features to expand on what was built and grow the Hedera Guardian ecosystem. Major features introduced include greater decentralization, immutability, ESG asset recovery, enriched documentation, and bug fixes. The Guardian version 2.0 is a game changer for the voluntary ecological market as a whole and the Hedera applications which are participating.<\/p>\n

Learn more about Guardian v2 and clone the Github repository\u00a0here<\/a>.<\/p>\n

Token Provenance<\/h4>\n

We have been getting a lot of questions around \u201chow do you trace events that lead to a token event on-chain\u201d? We have improved the UX to show the provenance with mapping between the documents stored in IPFS and messages inside Hedera Topics that shows relationships between various ESG artifacts such as Verifiable Presentations, Verifiable Credentials, and more. Below is an architectural diagram of how Token provenance looks with an example:<\/p>\n<\/div>\n

\"\"\/<\/figure>\n
\n

Here is how you get a Verifiable Presentation from a token mint transaction: <\/p>\n

Look for a token mint transaction on DragonGlass<\/a>.<\/p>\n

For the transaction 00341948921649942497135549961<\/strong> the link will be https:\/\/testnet.dragonglass.me\/transactions\/00341948921649942497135549961<\/a><\/p>\n

Transaction data will contain data similar to this:<\/p>\n<\/div>\n

\n


\n \"code<\/p>\n

\n
<\/div>\n
<\/div>\n<\/p><\/div>\n
TRANSACTION DETAILS 0.0.34194892@1649942497-135549961 (SUCCESS)\nTRANSACTION TYPE Mint Token\nTRANSACTION HASH 8ec781457fbd0ab6124eb04396cdcff153868f4f52b1836e42158fd3f23fc0139f1fd7b7ee18915124eab74d49c9d0ad\nPAYER 0.0.34194892\nMEMO 1649942508.776446488\n<\/code><\/pre>\n<\/div>\n
\n
Take the MEMO value (which is the Hedera message timestamp) and add it to the URL after the \/messages\/  to get a message from a Hedera Mirror Node.<\/p>\n
In our case it will be https:\/\/testnet.mirrornode.hedera.com\/api\/v1\/topics\/messages\/1649942508.776446488<\/a><\/p>\n
You will get a message content:<\/p>\n<\/div>\n
\n
  
\n  \"code<\/p>\n
\n
<\/div>\n
<\/div>\n<\/p><\/div>\n
{\n  \"chunk_info\": {\n    \"initial_transaction_id\": {\n      \"account_id\": \"0.0.34194892\",\n      \"nonce\": 0,\n      \"scheduled\": false,\n      \"transaction_valid_start\": \"1649942496.012855213\"\n    },\n    \"number\": 1,\n    \"total\": 1\n  },\n  \"consensus_timestamp\": \"1649942508.776446488\",\n  \"message\": \"eyJpZCI6IjEzNTZlMDNhLTk5NGEtNGU5ZC1iNTFmLWNlMGY4NzBmZDk1MiIsInN0YXR1cyI6IklTU1VFIiwidHlwZSI6IlZQLURvY3VtZW50IiwiYWN0aW9uIjoiY3JlYXRlLWNwLWRvY3VtZW50IiwiaXNzdWVyIjpudWxsLCJyZWxhdGlvbnNoaXBzIjpbIjE2NDk5NDI0OTYuMDEwMjExMDAwIl0sImNpZCI6ImJhZmtyZWlhNWkzYnJ1bWNpMzVzNzMzcTRndWEzNjNpaHhyaXNyNm56aWFmN2g3aGd4aHlhbmg2dnlhIiwidXJsIjoiaHR0cHM6Ly9pcGZzLmlvL2lwZnMvYmFma3JlaWE1aTNicnVtY2kzNXM3MzNxNGd1YTM2M2loeHJpc3I2bnppYWY3aDdoZ3hoeWFuaDZ2eWEifQ==\",\n  \"payer_account_id\": \"0.0.34194892\",\n  \"running_hash\": \"P0i9GNaL1qUoPQmNHOumV\/3x8K4voPmOUNJOfXDJl9K89u\/7Qa7GgqKR3kmaTcAF\",\n  \"running_hash_version\": 3,\n  \"sequence_number\": 9,\n  \"topic_id\": \"0.0.34204397\"\n}\n<\/code><\/pre>\n<\/div>\n
\n
Take the url attribute value and paste it to a browser:<\/p>\n
https:\/\/ipfs.io\/ipfs\/bafkreia5i3brumci35s733q4gua363ihxrisr6nziaf7h7hgxhyanh6vya<\/a><\/p>\n
You\u2019ll have a VP of this token.<\/p>\n<\/div>\n
\n
  
\n  \"code<\/p>\n
\n
<\/div>\n
<\/div>\n<\/p><\/div>\n
{\n  \"id\": \"db698146-38e2-48f6-8819-6f596647f970\",\n  \"type\": [\n    \"VerifiablePresentation\"\n  ],\n  \"@context\": [\n    \"https:\/\/www.w3.org\/2018\/credentials\/v1\"\n  ],\n  \"verifiableCredential\": [\n    {\n      \"id\": \"2f6ca45d-7f0d-405a-a011-b736db93e511\",\n      \"type\": [\n        \"VerifiableCredential\"\n      ],\n      \"issuer\": \"did:hedera:testnet:9ZJXR58X9XQUgwiuxQQiTUt5yY2vX2Tw5Uph4xXsnkfM;hedera:testnet:tid=0.0.34194893\",\n      \"issuanceDate\": \"2022-04-14T13:21:28.918Z\",\n      \"@context\": [\n        \"https:\/\/www.w3.org\/2018\/credentials\/v1\"\n      ],\n      \"credentialSubject\": [\n        {\n          \"field0\": \"did:hedera:testnet:F55HnMGMzS3TkuqBjLaUxcYvm86oGfTFViXELD4GNFAo;hedera:testnet:tid=0.0.34194893\",\n          \"field1\": \"did:hedera:testnet:8jjgRqbr2YRYccxMrvhupyu543izSe8N1J6UHbgWkhiA;hedera:testnet:tid=0.0.34204397\",\n          \"field2\": {\n            \"type\": \"706bb8da-7f39-4518-85c3-b4b23a6ef28a\",\n            \"@context\": [\n              \"https:\/\/ipfs.io\/ipfs\/bafkreidcyabsha6frnfqie7bpa5o3yrb6cllglsxd4krjksvreg35ygluy\"\n            ]\n          },\n          \"field3\": {\n            \"type\": \"64c171a2-ac60-4972-b796-8596381c65a8\",\n            \"@context\": [\n              \"https:\/\/ipfs.io\/ipfs\/bafkreidcyabsha6frnfqie7bpa5o3yrb6cllglsxd4krjksvreg35ygluy\"\n            ]\n          },\n          \"field6\": \"2022-04-07\",\n          \"field7\": 1,\n          \"field8\": \"2022-04-28\",\n          \"field17\": \"nu81uxel\",\n          \"field18\": \"0.0.34194895\",\n          \"ref\": \"did:hedera:testnet:8jjgRqbr2YRYccxMrvhupyu543izSe8N1J6UHbgWkhiA;hedera:testnet:tid=0.0.34204397\",\n          \"policyId\": \"62581e42a7303b7ff96a8012\",\n          \"@context\": [\n            \"https:\/\/ipfs.io\/ipfs\/bafkreidcyabsha6frnfqie7bpa5o3yrb6cllglsxd4krjksvreg35ygluy\"\n          ],\n          \"id\": \"6a730bc5-19e2-427d-b132-b9b49359ea20\",\n          \"type\": \"143e109a-a089-48a1-8a7b-534bfaf79c4d&1.0.0\"\n        }\n      ],\n      \"proof\": {\n        \"type\": \"Ed25519Signature2018\",\n        \"created\": \"2022-04-14T13:21:28Z\",\n        \"verificationMethod\": \"did:hedera:testnet:9ZJXR58X9XQUgwiuxQQiTUt5yY2vX2Tw5Uph4xXsnkfM;hedera:testnet:tid=0.0.34194893#did-root-key\",\n        \"proofPurpose\": \"assertionMethod\",\n        \"jws\": \"eyJhbGciOiJFZERTQSIsImI2NCI6ZmFsc2UsImNyaXQiOlsiYjY0Il19..hw6O674MalfXIlD3RyOd1BLhvH_xBYIudK1UQ-cAvZxYYejdMjU2TYfjC-sUa7ZYcioZ_CfSBsMwI7WCO3hGAw\"\n      }\n    },\n    {\n      \"id\": \"c0c0d496-4f86-4ca9-94cc-80552d838168\",\n      \"type\": [\n        \"VerifiableCredential\"\n      ],\n      \"issuer\": \"did:hedera:testnet:9ZJXR58X9XQUgwiuxQQiTUt5yY2vX2Tw5Uph4xXsnkfM;hedera:testnet:tid=0.0.34194893\",\n      \"issuanceDate\": \"2022-04-14T13:21:36.139Z\",\n      \"@context\": [\n        \"https:\/\/www.w3.org\/2018\/credentials\/v1\"\n      ],\n      \"credentialSubject\": [\n        {\n          \"date\": \"2022-04-14T13:21:36.134Z\",\n          \"tokenId\": \"0.0.34194898\",\n          \"amount\": \"1\",\n          \"@context\": [\n            \"https:\/\/ipfs.io\/ipfs\/bafkreiaamzhmh3l5pn5nneib5yifb3gjwlotf6fr6vb65j7tfi4tefxcza\"\n          ],\n          \"type\": \"MintToken&1.0.0\"\n        }\n      ],\n      \"proof\": {\n        \"type\": \"Ed25519Signature2018\",\n        \"created\": \"2022-04-14T13:21:36Z\",\n        \"verificationMethod\": \"did:hedera:testnet:9ZJXR58X9XQUgwiuxQQiTUt5yY2vX2Tw5Uph4xXsnkfM;hedera:testnet:tid=0.0.34194893#did-root-key\",\n        \"proofPurpose\": \"assertionMethod\",\n        \"jws\": \"eyJhbGciOiJFZERTQSIsImI2NCI6ZmFsc2UsImNyaXQiOlsiYjY0Il19..3uhxt-NAuLaIGTDXlqkD92QOTUZOjJgHNjFwP6jrrGchFLwxuDDnhz5VzMMLv1k3_VkVLvIKx1V-E1aewSI5Bw\"\n      }\n    }\n  ],\n  \"proof\": {\n    \"type\": \"Ed25519Signature2018\",\n    \"created\": \"2022-04-14T13:21:36Z\",\n    \"verificationMethod\": \"did:hedera:testnet:9ZJXR58X9XQUgwiuxQQiTUt5yY2vX2Tw5Uph4xXsnkfM;hedera:testnet:tid=0.0.34194893#did-root-key\",\n    \"proofPurpose\": \"authentication\",\n    \"challenge\": \"123\",\n    \"jws\": \"eyJhbGciOiJFZERTQSIsImI2NCI6ZmFsc2UsImNyaXQiOlsiYjY0Il19..-yNpvBHaDnFk-T5OWY516WBsBnsE40E-4-z-d54BhwanRBN15D6VbKGUjRG4kkKhEp-7jh8WIO2VRsYY4-SOBQ\"\n  }\n}\n<\/code><\/pre>\n<\/div>\n
\n
Recovery of ESG Assets<\/h4>\n
We have added support for the Root Authority account\u2019s assets to be recovered (policies, schemas, etc.) when switching to a new Guardian instance using just Hedera Topics. Now, Guardian users are able to ‘recover’ previously created Root Authority account assets that have been stored in IPFS using only Hedera topic messages.<\/p>\n
Below is a screenshot of different versions of a policy stored in one topic.<\/p>\n<\/div>\n
\"\"\/<\/figure>\n
\n
This is the general structure of topics:<\/strong>
<\/h4>\n<\/div>\n
\"\"\/<\/figure>\n
\n
You can see how to recover the IPFS url from a Hedera topic in this screenshot:<\/strong>
<\/h4>\n<\/div>\n
\"\"\/<\/figure>\n
\n
Introducing Projects<\/strong><\/h4>\n
We have implemented the concept of a \u201cProject\u201d to the Guardian which groups together the following entities: Root Authority, Policy, Users & Custom Roles, and Sensors with their associated MRV data. This allows policy creators to now specify separate hedera topics for different projects which correlates to different groups of entities (the best analogy is this resembles multi-tenancy).<\/p>\n
Below is a screenshot that shows how Projects are created from within the Guardian\u2019s policy configuration screen:<\/p>\n<\/div>\n
\"\"\/<\/figure>\n
\n
Step by Step Policy Guides<\/strong><\/h4>\n
There are a few new demo policies to see how the Guardian creates ESG assets. One of them is the Verra Redd Demo for the avoidance of deforestation. We have included a step by step guide in out gitbook documentation for that policy. We have also enhanced the International Renewable Energy Credit policy and have also included a step by step guide for that as well.<\/p>\n
\n
We have added more support for policy creators who may deal with multiple policies via the policy selector in the schema page. This allows for a better user experience when dealing with a large number of policies and schemas.<\/p>\n<\/div>\n
\"\"\/<\/figure>\n
\n
Enriched Hedera Topic Messages<\/strong><\/h4>\n
One big change with regards to the plumbing is the removal of the vc-modules and the DID-SDK-JS libraries. Originally this library was used to publish messages to hedera topics. We realized that it only allowed us to send messages in a predefined format. This limitation forced us to create our own implementation of publishing messages to Hedera topics. Now we can allow Guardian users to publish messages in a more enriched format. This implementation is baked into the existing Guardian Service. 
<\/strong><\/p>\n
API Deprecation<\/strong><\/h4>\n
Last, but not least, is a note to developers that a few APIs will be deprecated in this release and discontinued on August 9, 2022.<\/p>\n