Frequently Asked Questions (FAQ)
What is DePIN Tracker?
DePIN Tracker is a platform designed for monitoring and managing mining devices. It provides a comprehensive view of device statuses, rewards, and associated metadata, making it easier for users to track their mining operations efficiently.
How do I integrate my miner with DePIN Tracker?
To integrate your miner, follow the API documentation to implement the required endpoints. At least one of the endpoints (getStatus
or getRewards
) must be implemented for basic functionality. For a seamless experience, we recommend implementing all available endpoints.
Can the user's email be used as a device ID?
Yes, but ensure that the email corresponds to only one miner. If an email is associated with multiple miners, it will not be represented correctly.
Should I paginate my rewards endpoint?
No. DePIN Tracker will call period=all
only once, so pagination is not necessary for the rewards endpoint.
What if our existing API endpoints differ from the listed ones?
If your existing API endpoints provide the required data but are structured or named differently, they can still be used for integration. However, we strongly recommend implementing our suggested endpoints to streamline the integration process.
If you choose to use your existing API, you must provide us with:
- A list of equivalent endpoints.
- Rules to extract issues.
- The list of issues and their severity levels from your API.
- Details on how to extract miner issues from your equivalent endpoints. This includes:
- A complete list of issues encountered by miners.
- The severity level (
gravity
) of each issue, such asHigh
,Medium
, orLow
.
It is more challenging for us to work with existing endpoints because we do not have deep knowledge of the inner workings of your DePIN system. Providing clear and detailed mappings will reduce potential integration delays and ensure accurate data representation on our platform.
What is a miner issue?
A miner issue is any problem or abnormal condition reported by the getStatus
endpoint. These issues indicate the current operational state of the miner and can include:
- Connectivity problems (e.g.,
Offline
). - Performance-related concerns (e.g.,
SpeedTestMissing
). - Configuration errors.
Each issue is categorized by its severity (gravity
) to help users prioritize resolution.
What happens if getStatus
returns issues?
- The issue is saved, and we create an 'incident' on our platform.
- Depending on the user's alert preferences, they will be notified of the issue.
- When
getStatus
indicates that the issue is no longer present, we automatically close the 'incident'.
You do not have to handle any of this. All incident management and notifications are handled by the DePIN Tracker platform.
What level of data security does DePIN Tracker provide?
DePIN Tracker ensures all communications use HTTPS to protect data in transit. Additionally, all API requests require authentication via an Authorization
header to safeguard access and ensure secure interactions.
What happens if a miner is offline?
When a miner is offline, the getStatus
endpoint should return an issue type of Offline
with a severity level of High
. This allows users to quickly identify and address downtime.
Can we add custom metadata to devices?
Yes. If your network uses additional metadata fields (e.g., region, custom tags), these can be incorporated into the integration. Reach out to our team to discuss your specific needs.
Do you offer support for integrating with DePIN Tracker?
Absolutely. If you encounter any challenges during the integration process, our support team is available to assist you. Contact us to receive guidance or clarification on the requirements and implementation steps.
If you have further questions, feel free to reach out to our support team for assistance.