For the complete documentation index, see llms.txt. This page is also available as Markdown.
Flagged for Rewrite

FAQs

1.How can I get started with the Guardian?

To get started you can choose from one of the following options depending upon your level of technical experience.

Option
Format
Technical Complexity

Managed Guardian Service

SaaS / Free Trial

Low

Quickstart guide

Docker containers

Medium

Building from source

Source code

High

2. How can I create a policy?

You can use the policy editor or APIs to create a policy workflow. Some examples can be found in Methodology Digitization and Creating a Policy with the Policy Configuratorhere and there is a quick start guide to help you publish your first policy.

5. Where can I get notified of updates, trainings, and workshops?

6. Where can I see the most recent changes made to the Guardian?

Learn more about past releases here, https://github.com/hashgraph/guardian/releases.

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 can I access the API docs?

On the docs site, checkout the API Reference / guardian

When running via docker, navigate to https://localhost/api/v1/api-docs.

11. 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. 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.

16. 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.

17. 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.

18. 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 dollars). 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.

19. 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.

20. 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

Was this helpful?