| name | eggbot |
| description | This skill provides the command interface for interacting with eggbot, a Nostr-native egg sales bot operated by buildtall.systems. Use when a customer's agent needs to check inventory, place orders, manage payments, or set up notifications via Nostr DM. |
Eggbot
Overview
Eggbot is a Nostr bot that sells farm eggs for bitcoin (Lightning). Interact with it by sending encrypted DMs containing text commands. It responds using the same DM protocol (NIP-04 or NIP-17) that was used to send the message.
Bot Identity
npub: npub1srcs6w4mmkjdkm6n4dh69smakmauv09vxtfrap73gr8ampwzcc8sdutrts
Relays
Connect to eggbot through these relays:
| Relay | Notes |
|---|
wss://relay.nostr.io | Preferred. Requires NIP-42 authentication and whitelist approval. |
wss://relay.drss.io | Requires NIP-42 authentication. |
wss://relay.damus.io | Public. No auth required. May be rate-limited under load. |
If using relay.nostr.io, the connecting identity must be on the relay's whitelist and the client must support NIP-42 (automatic AUTH challenge signing).
Commands
Send any command as the body of an encrypted DM to eggbot's npub. Commands are case-insensitive.
Check Inventory
inventory
Returns the number of eggs currently available for purchase.
Place an Order
order 6
order 12
Orders must be exactly 6 or 12 eggs. Placing an order reserves the eggs immediately. Only one pending (unpaid) order is allowed at a time. Response includes payment instructions.
Pricing: Set by the operator. Current rate is per half-dozen (6 eggs).
Cancel an Order
cancel <order_id>
Cancels a pending order and releases the reserved eggs back to inventory. Only works while the order status is "pending" (unpaid).
Check Balance
balance
Returns sats received, sats spent, and current balance.
Order History
history
Returns the 25 most recent orders with ID, quantity, price, and status.
Inventory Notifications
notify 6
notify 12
Subscribe to a one-time DM alert when available inventory reaches the specified threshold (6 or 12). The notification fires once and then the subscription is removed.
notify
Check current notification subscription status.
notify off
Cancel an active notification subscription.
Help
help
Returns the list of available commands.
Payment
After placing an order, pay using one of two methods:
-
Lightning invoice — The order response may include a Lightning invoice. Pay it from any Lightning wallet. The operator may need to manually confirm receipt.
-
Nostr zap (recommended) — Zap the bot's profile for the order amount. Eggbot automatically detects the zap receipt, credits the balance, and marks the order as paid.
Order Lifecycle
PENDING ──(pay)──> PAID ──(operator delivers)──> FULFILLED
│
└──(cancel)──> CANCELLED
- pending: Eggs reserved, awaiting payment
- paid: Payment confirmed, awaiting physical delivery
- fulfilled: Delivered by operator
- cancelled: Cancelled before payment, eggs released
Typical Flow
inventory — check availability
order 12 — place order (eggs reserved)
- Zap the bot's profile for the stated amount
- Bot confirms payment automatically
- Operator delivers eggs and marks order fulfilled
history — verify order status
Error Messages
| Situation | Response |
|---|
| Not a registered customer | "you are not a registered customer" |
| Unpaid order exists | "you have 1 unpaid order(s) - please pay or cancel before ordering more" |
| Invalid quantity | "quantity must be 6 or 12" |
| Insufficient inventory | "only N eggs available, cannot order M" |
| Cancel non-pending order | "order N cannot be cancelled (status: paid)" |
| Unknown command | "Unknown command: X. Send 'help' for available commands." |
Prerequisites
To use eggbot, a customer's npub must be registered by an operator. Unregistered npubs receive a rejection message. Contact the operator to request registration.