Fleet Contract
All Clients using the Diode Network must be listed in a Fleet Contract in order to be able to communicate. Sometimes a Fleet Contract is also referred to as a Perimeter.
A Fleet Contract sponsors or underwrites your device’s communications. Every time a device communicates with the Diode Network, it must provide the Fleet Contract by which its communication is sponsored. A device can belong to many different Fleet Contracts, but each communication session must specify only one Fleet Contract that it would like to use for that session.
In the context of the Diode Network, a Fleet Contract is a decentralized smart contract that stores and manages the identities of clients (public keys) that it is sponsoring for communication. The Fleet Contracts provide a number of functions to facilitate secure communications, including client registration, client deregistration, protected or private connections, and other capabilities.
Although today (circa 2021 - 2023) Fleet Contracts are not required to have “stake” (a token balance), in the future, this is how Diode Network infrastructure will determine the QoS provided to the device. The higher the stake, the more likely it is that a performant network infrastructure node will handle your traffic. If you have no stake in the Fleet Contract, then it is unlikely that an infrastructure node will want to handle your traffic because it will not get rewarded for doing so.
For commercial use of the Diode Network, it is important that you have your own Fleet Contract so that your device cannot be de-listed from someone else’s Fleet Contract, thereby disabling device communications. However, for development purposes, Diode provides a “Diode Developer Fleet Contract” at address 0x6000000000000000000000000000000000000000 that can be used by anyone for testing and non-commercial use.
If you are using the Diode Client and have not explicitly set your Fleet Contract, it will default to using the Diode Developer Fleet Contract. To see what Fleet Contract your Client is using, use: diode config
or go to the Diode Network Explorer and search for your Client address - the account details page will display the Fleet Contract it belongs to.
To create your own Fleet Contract, use the Diode App’s Network feature or use the Diode Network Explorer Fleets page (must have MetaMask installed).
Once you’ve created your Fleet Contract, you can configure your devices to use it.