FluffyLabs Bot

A GitHub bot that enables cryptocurrency tipping on GitHub issues and pull requests using Polkadot Asset Hub, and triggers benchmarks for pull requests.

Features

• Tip Commands: Send DOT or USDC tips via GitHub comments
• Benchmark Triggers: Trigger benchmark workflows for pull requests
• Authorization: Team/organization membership-based access control
• Reactions: Visual feedback with emoji reactions (👀 for authorized, 👎 for unauthorized)
• Transaction Tracking: Real-time updates with blockchain transaction details
• Error Handling: Contextual error messages for authorized users only

Usage

Tipping

Mention the bot in a comment with a tip command:

@fluffylabs-bot tip <address> <amount> <asset> [optional message]

Examples:

@fluffylabs-bot tip 12uGtv6u5vvUcog67hfLXqrM5anMhyoNuhtp8M1nyQtonwSK 10 DOT great work!
@fluffylabs-bot tip 12uGtv6u5vvUcog67hfLXqrM5anMhyoNuhtp8M1nyQtonwSK 25 USDC

Supported Assets: DOT, USDC

Benchmarking

Trigger benchmark workflows for pull requests in the configured repository:

@fluffylabs-bot benchmark

Example:

@fluffylabs-bot benchmark

This command triggers the benchmark workflow in the configured target repository and passes the current PR number. The command is only available in the configured source repository. Both repositories must be in the same GitHub organization (specified by GITHUB_ORG).

Development

Setup

npm install
cp .env.example .env
# Configure environment variables in .env
npm start

Configuration

Required environment variables:

# GitHub Authorization
GITHUB_ORG=your-org
GITHUB_TEAM=your-team

# Tipping Configuration
WALLET_SEED=your-wallet-seed
ASSET_HUB_RPC=wss://polkadot-asset-hub-rpc.polkadot.io
MAX_DOT_TIP=100
MAX_USDC_TIP=1000

# Benchmark Configuration (optional - feature disabled if not set)
# Both repositories must be in the organization specified by GITHUB_ORG
BENCHMARK_SOURCE_REPO=typeberry
BENCHMARK_TARGET_REPO=typeberry-testing
BENCHMARK_WORKFLOW_FILE=pr-benchmark.yml

Testing

npm test
npm run test-watch  # Watch mode
npm run lint        # Type checking

Docker

docker build -t fluffylabs-bot .
docker run --env-file .env fluffylabs-bot

CI/CD

The project uses GitHub Actions for continuous integration and deployment:

• CI Pipeline: Runs tests, linting, security audits on Node.js 18.x, 20.x, 22.x
• Docker Build: Validates Docker image builds
• Security: Automated dependency vulnerability scanning
• Deployment: Automated Docker image publishing to GitHub Container Registry on releases
• Dependencies: Automated dependency updates via Dependabot

Workflows:

• .github/workflows/ci.yml - Main CI pipeline
• .github/workflows/deploy.yml - Release deployment

How It Works

Tipping

1. Command Detection: Bot monitors comments for mentions and tip commands
2. Authorization: Checks team/organization membership via GitHub API
3. Validation: Validates address format, amount limits, and asset support
4. Reactions: Adds emoji reactions based on authorization status
5. Transaction: Sends blockchain transaction via Polkadot Asset Hub
6. Updates: Edits initial comment with transaction results

Benchmarking

1. Command Detection: Bot monitors PR comments for benchmark commands
2. Repository Validation: Ensures command is used in the correct source repository
3. Authorization: Checks team/organization membership via GitHub API
4. Reactions: Adds emoji reactions based on authorization status
5. Workflow Trigger: Triggers the benchmark workflow in the target repository with PR number
6. Updates: Posts confirmation with link to workflow runs

Contributing

See CONTRIBUTING.md for guidelines.

License

ISC © 2025 Fluffylabs