What is the primary identity format for users in Towns?

User IDs in the Towns Protocol are always Ethereum addresses in the 0x... format, never traditional usernames.

How do I securely verify a payment within a bot?

Always verify the transaction on-chain using 'waitForTransactionReceipt' and check that the status equals 'success' rather than trusting the transaction hash alone.

How does the bot handle gas fees and treasury separately?

It uses a two-wallet architecture where 'bot.viem.account.address' serves as the gas wallet for fees, while 'bot.appAddress' acts as the treasury for application transfers.

What formatting rules should I follow for bot messages?

Use double newlines (\n\n) between sections to prevent rendering overlaps, and avoid using triple dashes (---) as they render as zero-height rules in the Towns client.

Why don't my slash commands trigger onMessage handlers?

In the Towns SDK, slash commands and onMessage handlers are exclusive; slash commands are handled by their own specific listeners and do not bubble to general message handlers.

Towns Protocol Bot Development

Name: Towns Protocol Bot Development
Author: towns-protocol

bytowns-protocol

协作工具

Builds and deploys feature-rich bots for the Towns Protocol with full support for blockchain operations and interactive messaging.

关于

This skill provides a comprehensive toolkit for developing sophisticated AI agents and bots within the Towns Protocol ecosystem. It guides developers through SDK initialization, handling slash commands, managing message events, and implementing interactive UI components like forms and buttons. Crucially, it includes deep integration with Ethereum-based blockchain operations, enabling secure transaction handling, token transfers, and multi-wallet architectures on the Base network. Whether you are building moderation tools or complex decentralized applications, this skill ensures your bot follows protocol-specific best practices and avoids common implementation pitfalls.

主要功能

Towns SDK initialization and environment configuration
0 GitHub stars
Secure two-wallet architecture management for gas and treasury
Slash command and message event handler implementation
Blockchain integration using Viem for Base network operations
Interactive UI components including forms and transaction requests

使用场景

Creating automated community moderation and utility bots for Towns spaces
Developing interactive mini-apps that trigger from slash commands or mentions
Building token-gated access systems or automated on-chain payment handlers

关于

主要功能

Towns SDK initialization and environment configuration
0 GitHub stars
Secure two-wallet architecture management for gas and treasury
Slash command and message event handler implementation
Blockchain integration using Viem for Base network operations
Interactive UI components including forms and transaction requests

使用场景

Creating automated community moderation and utility bots for Towns spaces
Developing interactive mini-apps that trigger from slash commands or mentions
Building token-gated access systems or automated on-chain payment handlers