❓FAQs
1.How can I get started with the Guardian?
We recommend spending some time and reading carefully through the docs here: https://docs.hedera.com/guardian/getting-started/readme. You will find setup instructions, a glossary of important terms, demo walk throughs, and more.
2. How can I create policies?
You can use the UI policy editor or APIs to create a policy workflow. Examples are found in the guardian docs here: https://docs.hedera.com/guardian/getting-started/readme
3. Is there a demo to create a policy without importing it?
4. Can I see the Guardian product roadmap and the current backlog?
yes! just install the free chrome extension called zenhub https://www.zenhub.com/. When installed you will be able to see the "zenhub" tab in the Guardian's github repo
5. Where can I get notified of sprint updates and demos?
Every two weeks we publish sprint updates to this youtube playlist: https://www.youtube.com/playlist?list=PLnld0e1pwLhqb69cELqQrW87JFVIDfocL
6. Where can I see the most recent changes made to the Guardian?
You can see the high level release notes here: https://github.com/hashgraph/guardian/releases. Also, you can find the full changelog at the bottom on the release notes to view for yourself via Github compare.
7. How do I request a policy or an issue to be worked on?
You can submit an issue in our Github or directly email us at info@envisionblockchain.com.
8. Whats the difference between iREC Policy and iREC Policy 2 in demo artifacts?
iREC Policy 2 is the up-to-date version of iREC Policy
9. How do I launch the IoT simulator in the reference implementation to generate demo MRV data?
You can visit : http://localhost:3000/mrv-sender/
10. How I can avoid the field name being "off by one" ?
Add an additional short name to the description in the schema configurator. If short name is not set then install field1...N.
11. How can I access the swagger docs for Guardian v2 ?
http://localhost:3000/api-docs/v1/ (note that this URL is only available for the docker build)
12. What is the difference between requestVcDocumentBlock and externalDataBlock to report data?
Both are for reporting data, both are producing VCs at the ‘exit.’
1. requestVcDocumentBlock requires authorization, but the actual document is just json.
2. externalDataBlock does not require authorization, but the document must already be a VC and be correctly signed.
13. Why do I get the error INSUFFICENT_TX_FEE?
The fee in the transaction is too small and needs to be increased changing setting of MAX_TRANSACTION_FEE
14. How are we linking topics to stored ipfs data after mongodb goes away? Is there somewhere I can read this?
MongoDB does not go away, we will keep the local DB for drafts etc. Hedera messages in topics are linked to the ‘published’ policies which are immutable stored in IPFS - messages contain CID of the file in IPFS.
15. Is MRV an existing data architecture used in I-REC or Carbon Offset standards?
A standard registry is an organization that establishes science-based standards for measuring, reporting, and verifying (MRV) ecological benefit claims and issues value in the form of credit for claims that meet the standard set. A standard registry also authorizes validation and verification bodies (VVBs) to collect and process claims based on the established standard. The creation of scientific-based standards for MRV is a rigorous discipline that requires independence from commercial influence in the pursuit of accurate accounting of benefit or emissions claims. In this case iREC is a standards registry, however oftentimes folks implement the iREC standard in a voluntary way and leverage iREC certification for sign off. Some markets, like Dubai, make it a compliance standard.
16. How Guardian uses IPFS for Verifiable Presentation (VP) storage?
We are uploading Verifiable Presentation document to IPFS and CID will be attached in Hedera message which is linked to policy topic.
17. How does Guardian Provenance works?
(ONLY NFT) Open tokens page, click on appropriate token or open ledger works explorer manually https://explore.lworks.io/testnet/tokens/{tokenId} (https://explore.lworks.io/testnet/tokens/0.0.4554172), open "NFT HOLDERS" tab and click on appropriate serial, click on "OVERVIEW" tab and in metadata you can get VP message identifier (1721049137.243457003).
(FT, NFT) Open tokens page, copy appropriate token identifier, open dragonglass explorer https://testnet.dragonglass.me/tokens/{tokenId} (https://testnet.dragonglass.me/tokens/0.0.4554298), click on "All transactions" tab, click on appropriate mint transaction, in memo you can get VP message identifier (1721049808.933544003).
In our case it will be https://testnet.mirrornode.hedera.com/api/v1/topics/messages/1721049137.243457003 You will get a message content:
Take the message attribute value and parse it to a JSON representation:
JSON.parse(atob(message)) // JSON.parse(atob(eyJpZCI6IjEzN.........WFuaDZ2eWEifQ==))
You will have a JSON similar to that one:
Take the url attribute value and paste it to a browser:
https://ipfs.io/ipfs/bafkreia5i3brumci35s733q4gua363ihxrisr6nziaf7h7hgxhyanh6vya
You’ll have a VP of this token.
18. The VCs that are generated as part of the Guardian workflow, have you found any use cases where the status of the VC might change? For example, is there ever a time where a VC might be revoked or expires? If so, does the status get updated on the ledger?
There are many use-cases where the VCs and various other artefacts produced in the course of the policy functioning of the guardian might need to be revoked. One of the obvious examples of such situation is malfunctioning sensor generating invalid MRV data. But there are many others.
19. Is it possible to see a Guardian-minted token's value in hbar as well as its associated CO2e? If so, where does this information come from/how can we access it?
The value of the token in hbar (or USD) will be set by the market, and thus external to the token itself (so there is no way to see in the token what it is worth in $$). And what the token represents (CO2e etc) is determined by the policy under which it was minted. These tokens are the NFTs, and the metadata can include this data if the policy under which the tokens are minted has provisions for it.
20. What is the semantic of the DID in the message? Is it that the standard registry signs VCs etc with the corresponding private key?
DID is the the DID of the RA, i.e. is a globally unique reference linking to a DID document which is the identity - all VCs issued to or by an entity would then be ‘bound’ to this DID as per the ‘self-sovereign identity’ architecture.
21. How to identify data on Hedera after submitting data using sendToGuardianBlock?
You can find it in Project/Policy topic, it depends on sendToGuardianBlock configuration.
Open policies tab, click on policy topic or open it in ledger works explorer manually https://explore.lworks.io/testnet/topics/{topicId} (https://explore.lworks.io/testnet/topics/0.0.4554074), find appropriate INSTANCE_POLICY_TOPIC message and copy childId, then replace it in the url, find appropriate message or find appropriate DYNAMIC_TOPIC message and do same thing with childId.
Unfortunately, Ledger Works does not have a search by messageId, but messages can be obtained using mirror node.
for example https://testnet.mirrornode.hedera.com/api/v1/topics/messages/1659539040.128851003
Last updated