Skip to Content
IntroductionCore Concepts

Core Concepts

Understanding these core concepts will help you get the most out of KeeperHub.

Workflows

Workflows are visual automations that you build by connecting nodes on a canvas. Each workflow represents a complete automation - from trigger to actions.

Key characteristics:

  • Visual, node-based design
  • Automatic or manual execution
  • Conditional branching for complex logic
  • Shareable via the Hub

Nodes

Nodes are the building blocks of workflows. Each node performs a specific function.

Trigger Nodes

Every workflow starts with a trigger that determines when it runs:

  • Scheduled: Run at intervals (every 5 minutes, hourly, daily)
  • Webhook: Run when an external service calls your workflow URL
  • Event: Run when a blockchain event is detected
  • Block: Run at blockchain block intervals on a specific chain
  • Manual: Run only when you click the Run button

Action Nodes

Actions perform the actual work in your workflow:

  • Web3 Actions: Check Balance, Read Contract, Write Contract, Transfer Funds
  • Notification Actions: Send Email, Send Discord Message, Send Slack Message
  • Integration Actions: Send Webhook, custom HTTP requests

Condition Nodes

Conditions evaluate data and create branching paths:

  • Low Balance Condition: Check if balance is below threshold
  • Value Comparison: Compare any value against a target
  • Custom Logic: Combine conditions with AND/OR operators

Connections

Connections store credentials for external services. Set up connections once and reuse them across workflows.

Connection types:

  • Web3: Wallet connections for blockchain operations
  • Email: Email provider configuration
  • Discord: Webhook URLs for Discord channels
  • Slack: Workspace authorization
  • Webhook: Custom HTTP endpoint credentials

Workflow Runs

Each time a workflow executes, it creates a run with detailed logging:

  • Status: Pending, Running, Success, Error, Cancelled
  • Node Outputs: Results from each node in the workflow
  • Timing: Start time, duration, completion time
  • Errors: Detailed error messages if something fails

The Hub

The Hub is a marketplace for workflow templates:

  • Browse: Discover workflows shared by the community
  • Import: Copy workflows to your account
  • Share: Publish your workflows for others to use

AI Assistant

KeeperHub includes an AI assistant to help you build workflows:

  • Describe what you want in plain language
  • The AI suggests nodes and configurations
  • Review and customize the generated workflow

Access the AI via the “Ask AI…” input at the bottom of the canvas.

Para Wallet

Every KeeperHub account includes a Para wallet:

  • Automatic creation: Created when you sign up
  • Secure custody: Multi-party computation (MPC) security
  • Funding: Top up with ETH to enable gas-consuming operations
  • Management: View balance, withdraw funds via Settings > Wallet

Networks

KeeperHub supports multiple blockchain networks:

  • Ethereum Mainnet: Production network for real transactions
  • Sepolia Testnet: Test network for development (free test ETH)
  • Base: Layer 2 network with lower gas fees
  • Arbitrum: Layer 2 network optimized for DeFi

Always test workflows on a testnet before deploying to Mainnet.