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

0•

Herramientas de Colaboración

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.

Características Principales

01Towns SDK initialization and environment configuration

020 GitHub stars

03Secure two-wallet architecture management for gas and treasury

04Slash command and message event handler implementation

05Blockchain integration using Viem for Base network operations

06Interactive UI components including forms and transaction requests

Casos de Uso

01Creating automated community moderation and utility bots for Towns spaces

02Developing interactive mini-apps that trigger from slash commands or mentions

03Building token-gated access systems or automated on-chain payment handlers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add towns-protocol/skills bots

For use in Claude.ai and ChatGPT

Download Skill