Repository files navigation

A Home Assistant integration to compensate CO2 consumed by burning carbon units with the help of a remote agent.

Each tonn of CO2 emitted into the atmosphere counts, there are some special carbon units representing the CO2 amounts.These units may be burnt to "compensate your carbon footprint". More on that one may findhere.Our team has developed an Agent which may burn these units for you for some fee (since there are testing units now, there is no fee).This is an integration providing the ability to request that agent and compensate your home's carbon footprint based on theenergy sensors data. The unique identifier of yours is you blockchain account private key. The entire service is as well based on web3technologies.

1. Get integration files:

Using HACS:

• Install HACS.
• Navigate toHACS->Integrations and press three dots at the top-right. SelectCustom repositories and pastehttps://github.com/Multi-Agent-io/carbon-offsetting-web3-integration, chooseIntegration category. PressAdd.
• ClickExplore & Add Repositories at the bottom-right and search forWeb3 Carbon Footprint Offsetting. Click on it.
• ClickDownload at bottom-right, download the integration.
• Proceed to step 2.

Manually:

• Clone the repository into thecustop_components folder of your HomeAssistant config (create one if you don't have it)
• Navigate to the foldercarbon-offsetting-web3-integration and copy theintegration files to thecustom_components folder of your HomeAssistant:

homeassistant@ubuntu:~/.homeassistant/custom_components$ git clone https://github.com/Multi-Agent-io/carbon-offsetting-web3-integrationcp -r carbon-offsetting-web3-integration/custom_components/carbon_offsetting_web3.rm -rf carbon-offsetting-web3-integration/

This wierd file structure is due to HACS requirements. Proceed to step 2.

2. Restart HA to load the integration into HA.
3. Go to Settings -> Devices & Services -> Integrations and click the 'Add Integration' button. Look for 'Web3 CarbonFootprint Offsetting' and click to add it.

For this integration you need anaccount inRobonomicsNetwork. Save the seed when creating an account, it will be required at integration setup.If you useRobonomics HomeAssistant integration, youmay want to use Controller seed.

To set up the integration, you need to select the entities representingtotal amount of energy your Home consumes,there is a multiple choice selector for that. Similarly, if you have any energy production (e.g. solar panels), pick entitiesrepresenting them in the production entities selector. You may leave it blank if no production entities.

Input seed of your Robonomics account. The integration use it to sign liability messages when creating liabilities forcarbon offsetting agent. This will cost you nothing, and the seed won't be sent anywhere.

Next section is dedicated to the IPFS settings. IPFS is used to store liabilities technics data. All the fields areoptional, if you don't specify any gateway, your local one will be used. If you want to use a remote one, paste its URLinto the corresponding field and set auth header. This integration supports Web3-auth headers, the ones that require yourseed as well. If you use conventional authentication method, paste the login and password.

Note! Use multiaddr format!

Once the integration is set, three entities will be created, representing the amount of fossil kWh to compensate, lastcompensation date and total amount of compensated kWh.

They are unknown values yet. To get them, go toDeveloper Tools->Services and callWeb3 Carbon Footprint Offsetting: Get amount of kWh uncompensated.service. It will update your values based on your home parameters.

CallWeb3 Carbon Footprint Offsetting: Compensate an amount of produced CO2 by burning carbon units to compensate thedisplayed amount. After that, the values on the lovelace will be updated. You can do this any time you want, all thecalculations will be performed automatically.

Error"PubSub Timeout" means that the response message was not delivered to your system. That is due to sum issues in RobonomicsPubSub technology which is actively developed. In case of requesting amount of kWh to compensate, call the service once again,and when the compensation call timed out, call theWeb3 Carbon Footprint Offsetting: Get amount of kWh uncompensated. in casethe burn happened, but never reported.

Other errors require the user to check logs of the integration.

To get access to logs, enable debug logs in HomeAssistant'sconfiguration.yml by adding the following:

logger:default:warninglogs:custom_components.carbon_offsetting_web3:debug

All the logs are store inhome-assistant.log