WAVS AT Protocol

Overview

WAVS AT Protocol is a decentralized service that bridges AT Protocol social interactions with blockchain attestations. It listens to Bluesky/AT Protocol events and automatically creates on-chain attestations for posts that reply to a specific target account.

Prerequisites

• Rust 1.86+ with cargo, plus the wasm32-wasip2 target (rustup target add wasm32-wasip2)
• bun for package management and script execution
• go-task for the Taskfile.yml commands
• Docker (used by the backend tasks for WAVS, chains, and IPFS)
• wkg if you need to refresh the WAVS WIT worlds

Getting started

1. Set up the development environment (install dependencies, fetch WIT worlds):

   task setup

2. Bootstrap the entire system:

   task bootstrap:all

   Use task backend:stop-all to tear everything down, or call the more granular tasks shown by task --list.

How It Works

1. Configuration

• Set your TARGET_HANDLE in taskfile/bootstrap.yml
• This is the account whose replies will trigger attestations
• Default: ismellike.bsky.social

2. Event Ingestion

• WAVS subscribes to AT Protocol's Jetstream real-time event feed
• Monitors for new post events (app.bsky.feed.post)
• Captures post content, author, and reply metadata

3. Processing Pipeline

Trigger Component (Operator)

// Pseudo-code for the filtering logic
if post.reply_to == TARGET_HANDLE {
    process_post(post)
}

• WASI component parses incoming AT Protocol events
• Filters posts based on reply target
• Validates post structure and metadata

Aggregator Component

• Routes output to submission chain
• Interacts with EAS smart contracts
• Submits blockchain transactions

4. On-Chain Attestation

For each qualifying reply:

• Creates EAS attestation with post data
• Links to original post via AT Protocol URI
• Stores author information and reply content
• Generates immutable on-chain record

Querying Attestations

Query all attestations created for the AT Protocol schema:

task query:attestations

License

GPL-3.0-or-later. See LICENSE for details.