Patterns for handling commands, validating input, and filtering messages in XMTP agents. Use when implementing slash commands, validators, or message filters. Triggers on command handling, input validation, or type guards.
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
Best practices for handling commands, validating input, and filtering messages.
Reference these guidelines when:
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Validators | CRITICAL | validators- |
| 2 | Filters | HIGH | filters- |
| 3 | Type Guards | HIGH | guards- |
validators-hex - Use validHex() for hex string validationvalidators-address - Validate Ethereum addressesfilters-message-types - Filter by message type (SDK 2.0+: use direct imports isText, isReaction, isReply, etc. from @xmtp/agent-sdk; keep filter.fromSelf, filter.hasDefinedContent)filters-sender - Filter out self-messagesfilters-content - Check for defined contentguards-codec - Use usesCodec() instead of type assertionsguards-content-type - Use filter helpers for type safetyRead individual rule files for detailed explanations:
rules/validators-hex.md
rules/filters-message-types.md
rules/guards-codec.md
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Core XMTP Agent SDK setup and patterns. Use when creating new agents, handling messages, setting up middleware, or configuring environment variables. Triggers on agent setup, XMTP configuration, message handling, or middleware implementation.
The English summary is being prepared. Showing the original description.
Interactive button-based UI for XMTP agents following XIP-67. Use when creating menus, confirmation dialogs, selection options, or any button-based interaction. Triggers on inline actions, buttons, menus, or ActionBuilder.
The English summary is being prepared. Showing the original description.
File attachment handling for XMTP agents. Use when sending or receiving images, files, or any encrypted remote attachments. Triggers on file upload, image sending, or remote attachment handling.
The English summary is being prepared. Showing the original description.
Token transactions and wallet integration for XMTP agents. Use when sending USDC, creating transaction requests, or handling transaction confirmations. Triggers on USDC transfer, wallet calls, or transaction reference.
The English summary is being prepared. Showing the original description.
Group conversation management for XMTP agents. Use when creating groups, managing members, setting permissions, or sending welcome messages. Triggers on group creation, member management, or permissions.
The English summary is being prepared. Showing the original description.
ENS and Web3 identity resolution for XMTP agents. Use when resolving domain names, extracting mentions, or fetching Farcaster profiles. Triggers on ENS resolution, Farcaster lookup, or mention extraction.
The English summary is being prepared. Showing the original description.