SKALE Watchdog Client

Minimal Python client for interacting with SKALE Watchdog node APIs (SKALE + FAIR).

Install

pip install skale-watchdog-client

Supports Python 3.13+.

Quick Start

from watchdog_client import SkaleNode, SkalePassiveNode, FairNode, FairPassiveNode

# Base URL can be domain name or IP address of the node.
# A bare host or http:// URL gets :3009, https:// gets :311. An explicit port always wins.
skale_node = SkaleNode('my-skale-node.example.com')
# Use SkalePassiveNode for SKALE nodes running in passive mode
skale_passive = SkalePassiveNode('my-passive-skale-node.example.com')

fair_node = FairNode('my-fair-node.example.com')
# Use FairPassiveNode for FAIR nodes running in passive mode (no SGX endpoint)
fair_passive = FairPassiveNode('my-passive-fair-node.example.com')

# Call any endpoint: each returns ApiResult (fields: data, error, status_code, cache_age, stale)
# cache_age is seconds since the node cached the value, or None when it was fetched live.
# Pass max_age=360 to the node: any result older than that is stale and falsy.
r = skale_node.public_ip()
if r:
    print('Public IP:', r.data)
else:
    print('Error:', r.error)

# Execute every available check on a node
results = skale_node.all_checks()
for name, res in results.items():
    print(name, 'OK' if res else f'ERR: {res.error}')

API

Common (available on both SkaleNode and FairNode)

• containers
• sgx (not available on FAIR passive nodes; see FairPassiveNode)
• hardware
• endpoint
• meta_info (maps to /meta-info)
• btrfs
• ssl
• check_report (maps to /check-report)

SKALE-specific (SkaleNode)

• schains
• ima
• schain_containers_versions (maps to /schain-containers-versions)
• public_ip (maps to /public-ip)
• validator_nodes (maps to /validator-nodes)

SKALE Passive (SkalePassiveNode)

Same as SkaleNode, except the following checks return an error (404), because they are not available on SKALE passive nodes:

• sgx
• schains
• ima
• validator_nodes

FAIR-specific (FairNode)

• chain_checks (maps to /chain-checks)
• chain_record (maps to /chain-record)

FAIR Passive (FairPassiveNode)

Same as FairNode, except:

• sgx: returns an error ApiResult: "SGX check is not available on FAIR passive nodes"

Batch execution

Call all_checks() on any node instance to execute each public check method (no params) and get a dict mapping method name to its ApiResult. One failing check does not stop others.

Result Object

res = fair_node.chain_checks()
if res:
    print(res.data)
else:
    raise RuntimeError(res.error)

License

All contributions are made under the GNU Affero General Public License v3. See LICENSE.