The Guardian is an innovative open-source platform that streamlines the creation, management, and verification of digital environmental assets. It leverages a customizable Policy Workflow Engine and Web3 technology to ensure transparent and fraud-proof operations, making it a key tool for transforming sustainability practices & carbon markets.
Below are the universal software prerequisites, followed by network-specific items.
- Git – source-control tooling
- Docker – one-command build & run
- MongoDB v6, Node.js v16, and NATS 1.12.2 – auto-installed when using Docker-Compose
- Web3.Storage account – IPFS pinning service
- Filebase account – S3-compatible IPFS pinning
- Redis 7.3.0 – in-memory cache & message broker (auto-provisioned by the Docker stack)
| Testnet (default) | Mainnet (production) | |
|---|---|---|
| Account | Create via Hedera Developer Portal | Create via Hedera-enabled wallet (e.g., HashPack) |
| Key type | ED25519 | ED25519 |
| Network | testnet |
mainnet |
Fees: Mainnet operations incur HBAR costs—fund your account before running Guardian.
-
Install a Hedera-enabled wallet (e.g., HashPack).
-
Create a Mainnet account and note the Account ID (
0.0.x). -
Export the ED25519 key pair
- HashPack path: Settings → Manage Accounts → Export Private Key (DER format).
-
Update your
.envHEDERA_NET=mainnet HEDERA_OPERATOR_ID=0.0.123456 HEDERA_OPERATOR_KEY=-----BEGIN PRIVATE KEY----- … -----END PRIVATE KEY-----
-
Create a Testnet account via the Hedera Developer Portal.
-
Record your Account ID (
0.0.x). -
Download the ED25519 private key (ignore ECDSA)
- Select DER Encoded — do not choose HEX Encoded.
-
Update your
.envHEDERA_NET=testnet HEDERA_OPERATOR_ID=0.0.987654 HEDERA_OPERATOR_KEY=-----BEGIN PRIVATE KEY----- … -----END PRIVATE KEY-----
-
Docker-Compose
docker compose -f ./deploy/docker-compose.yml --profile all up -d
(Detects Testnet/Mainnet from
.env) -
Pre-built containers — pull
hashgraph/guardian:latestand supply.envas a secret. -
Manual build — clone repo, install Node deps, compile, start services.
- Server not starting? Ensure that Docker is running and all containers are up.
- Cannot access the admin dashboard? Check if the correct ports (3000) are open and not blocked by your firewall.
- Issues with API calls? Verify that your Hedera account ID and private key are correctly configured in the
.envfile. - For additional help, visit the Hedera Guardian GitHub Issues.
- For support, reach out via Hedera Discord Sustainability channel or email us at info@envisionblockchain.com.
- Submit feedback or feature requests through the GitHub repository.
- Hedera Guardian is open-source and licensed under the Apache 2.0 License. Please review the LICENSE file for more details.