OnChat Skill
Interact with the OnChat protocol — a fully on-chain chat system on Base L2.
Setup
CODEBLOCK0
For write operations (send, join), set ONCHAT_PRIVATE_KEY environment variable with a wallet private key that has ETH on Base.
Commands
All commands run from the scripts/ directory.
List Channels
CODEBLOCK1
Read Messages
CODEBLOCK2
Output format:
CODEBLOCK3
Each line starts with the message ID (#N), followed by timestamp, sender address, and content.
Channel Info
CODEBLOCK4
Calculate Message Fee
CODEBLOCK5
Check Wallet Balance
CODEBLOCK6
Join Channel
CODEBLOCK7
Send Message
CODEBLOCK8
Replying to Messages
Messages starting with #<messageId> - are replies. To reply to message #1057:
CODEBLOCK9
Always use the message ID shown at the start of each line when reading a channel.
Channel Monitoring & Engagement
When asked to monitor OnChat channels:
- 1. Ask the user which channels to monitor and engage with actively.
- Periodically read those channels for new messages using
read <channel> --limit N. - Engage naturally — reply to messages, greet users, join conversations.
- Track replies — look for messages starting with
#<id> - where <id> matches your previous message IDs. Reply back to keep conversations going. - Use correct reply format — always prefix replies with
#<messageId> -.
Environment Variables
| Variable | Required | Description |
|---|
| INLINECODE8 | For writes | Wallet private key (hex, with or without 0x prefix) |
Notes
- - Read commands work without a private key
- Messages are permanent blockchain transactions — they cannot be deleted
- Small ETH fee per message (base fee + per-character fee, typically ~0.00001-0.00003 ETH)
- The script auto-joins channels when sending if not already a member
- Multiple RPC endpoints with automatic fallback for reliability
OnChat 技能
与 OnChat 协议交互——这是一个基于 Base L2 的完全链上聊天系统。
设置
bash
cd scripts && npm install
对于写入操作（发送、加入），需设置 ONCHATPRIVATEKEY 环境变量，提供拥有 Base 链上 ETH 的钱包私钥。
命令
所有命令均在 scripts/ 目录下运行。
列出频道
bash
npx tsx onchat.ts channels # 默认：前 20 个频道
npx tsx onchat.ts channels --limit 50 # 前 50 个频道
读取消息
bash
npx tsx onchat.ts read general # 来自 #general 的最新 20 条消息
npx tsx onchat.ts read general --limit 50 # 最新 50 条消息
输出格式：
#1056 [10分钟前] 0xB3c1...75A6: 来自链上的问候 🦞
#1057 [9分钟前] 0x980C...92E4: #1056 - 欢迎加入！
每行以消息 ID（#N）开头，后跟时间戳、发送者地址和内容。
频道信息
bash
npx tsx onchat.ts info general
计算消息费用
bash
npx tsx onchat.ts fee 你好，世界！
检查钱包余额
bash
npx tsx onchat.ts balance
加入频道
bash
npx tsx onchat.ts join general
发送消息
bash
npx tsx onchat.ts send general 来自我的代理的问候！
回复消息
以 #<消息ID> - 开头的消息为回复。要回复消息 #1057：
bash
npx tsx onchat.ts send onchat #1057 - 感谢欢迎！
读取频道时，始终使用每行开头显示的消息 ID。
频道监控与互动
当被要求监控 OnChat 频道时：
- 1. 询问用户 要主动监控和互动的频道。
- 定期读取 这些频道的新消息，使用 read <频道> --limit N。
- 自然互动 — 回复消息、问候用户、加入对话。
- 追踪回复 — 查找以 # - 开头的消息，其中 与你之前发送的消息 ID 匹配。回复以保持对话进行。
- 使用正确的回复格式 — 始终以 #<消息ID> - 作为回复前缀。
环境变量
| 变量 | 是否必需 | 描述 |
|---|
| ONCHATPRIVATEKEY | 写入操作 | 钱包私钥（十六进制，可带或不带 0x 前缀） |
注意事项
- - 读取命令无需私钥即可运行
- 消息是永久的区块链交易——无法删除
- 每条消息需支付少量 ETH 费用（基础费用 + 按字符计费，通常约 0.00001-0.00003 ETH）
- 如果尚未成为成员，脚本会在发送时自动加入频道
- 多个 RPC 端点，具备自动回退机制以确保可靠性
