Skip to content

skalenetwork/bounty-agent

Test Build and publish codecov Codacy Badge Discord

SKALE Bounty Agent

SKALE Bounty Agent is a part of each SKALE Node, and together is part of the SKALE Node Monitoring Service (NMS). Every SKALE node has a NMS group of N (e.g. 24) other nodes in the network randomly assigned to it. NMS groups regularly audit various node metrics at predetermined periods (e.g. five minutes), log these measurements to their local databases, and submit average metrics to the SKALE Manager Contract (SMC) once for every reward period - epoch (e.g. 30 days).

Every node is rewarded for its validation efforts, based on results sent by NMS group of this node, at the end of each epoch. Bounty agent runs on every node of SKALE network, periodically requests available bounties for validation work from the SMC(once for every epoch).

An important note about production readiness

Bounty Agent is still in active development and therefore should be regarded as alpha software. The development is still subject to security hardening, further testing, and breaking changes. This repository has not yet been reviewed or audited for security.

Development

Requirements

Python ≥ 3.13

Dependencies

Install uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

Install all dependencies:

uv sync --prerelease=allow --all-extras

Linting and type checking

Check linting/formatting issues

uv run ruff check

Check type issues

uv run mypy .

Run tests locally

  1. Export environment variables:
. ./scripts/export_env.sh
  1. Deploy skale-manager:
bash helper-scripts/deploy_manager.sh
  1. Run tests:
bash ./scripts/run_tests.sh

Build

For building Bounty agent docker image locally:

docker build -t your-bounty-image-name .

For more information

Learn more about the SKALE community over on Discord.

Contributing

If you have any questions please ask our development community on Discord. Discord

License

License Copyright (C) 2018-present SKALE Labs

About

Bounty agent - part of SKALE Node Monitoring Service (NMS)

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Contributors 7