Skip to main content

Agent (Core)

The Agent is the control-layer component of a Resultity node. It manages the node’s lifecycle, handles job assignment, maintains communication with the network, and coordinates local execution via the Runtime.

The Agent is designed to run as a containerized service and is isolated from direct user access. It acts as the trusted interface between the node and the broader Resultity infrastructure.

Responsibilities

The Agent is responsible for:

  • Network communication:

    • Establishing persistent WebSocket connections to io.network.resultity.com;
    • Handling heartbeat pings and receiving job assignments;
    • Performing status checks and reporting node metadata.
  • Cryptographic operations:

    • Signing job results, heartbeat reports, and control messages using the node’s EVM private key;
    • Verifying configuration updates issued by the network.
  • Job coordination:

    • Accepting job instructions from the network;
    • Validating job parameters and compatibility with installed models;
    • Dispatching input to the Runtime and collecting outputs.
  • Runtime orchestration:

    • Launching the Runtime container with required parameters;
    • Monitoring the health of the Runtime and restarting it if needed;
    • Triggering test runs after model updates.
  • Configuration and updates:

    • Comparing local and remote configuration hashes;
    • Fetching and applying updated snapshots;
    • Automatically updating containers and model images.

Security and Integrity

The Agent ensures trust and traceability via:

  • EVM-based signatures: every outbound message is signed using the node’s private key;
  • Message structure: signed messages include nonce or timestamp to prevent replay attacks;
  • Hash validation: updates and models are verified by SHA-based or Merkle-based checksums;
  • Connection hygiene: connections are dropped and re-established if invalid behavior is detected.

Interaction Summary

ActionTriggered byDestination
HeartbeatTimerio.network.resultity.com
Job request handlingServer pushio.network.resultity.com
Config fetch and syncLocal checksumio.network.resultity.com
Model test runNew installRuntime container
Signature verificationAll messagesNetwork services

The Agent is the operational brain of the node — enforcing policy, mediating execution, and securely relaying all network communication.