Files

2.3 KiB

Deployment

Local Development

# Start bot (default port 5123)
bun run dev

# Expose webhook via Tailscale Funnel
tailscale funnel 5123
# Creates URL like: https://your-machine.taild8e1b0.ts.net/

# Alternative: ngrok
ngrok http 5123

Setup Webhook in Developer Portal

  1. Go to https://app.towns.com/developer
  2. Select your bot
  3. Set Webhook URL to your tunnel URL + /webhook
    • Example: https://your-machine.taild8e1b0.ts.net/webhook
  4. Save changes

Testing Checklist

  • Bot server running (bun run dev)
  • Tunnel active (Tailscale/ngrok)
  • Webhook URL updated in Developer Portal
  • Bot installed in a Space (Settings → Integrations)
  • Bot added to the specific channel (Channel Settings → Integrations)
  • Check logs for incoming webhook events

Render.com Deployment

  1. Create Web Service from Git repo
  2. Set build command: bun install
  3. Set start command: bun run start
  4. Set environment variables:
    • APP_PRIVATE_DATA
    • JWT_SECRET
    • DATABASE_URL (if using database)
    • BASE_RPC_URL (recommended: Alchemy/Infura)
  5. Set webhook URL in app.towns.com/developer to Render URL + /webhook

Health Check Endpoint

Add for deployment platforms that require health checks:

import { Hono } from 'hono'

const app = new Hono()

app.get('/health', (c) => c.json({
  status: 'ok',
  timestamp: new Date().toISOString(),
  gasWallet: bot.viem.account.address
}))

Graceful Shutdown

Handle SIGTERM for clean shutdown (required for Render/Kubernetes):

process.on('SIGTERM', async () => {
  console.log('SIGTERM received, closing...')
  await pool.end()  // Close DB connections
  process.exit(0)
})

Database Connection Pool

import { Pool } from 'pg'

const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
  max: 10,
  idleTimeoutMillis: 30000,
  connectionTimeoutMillis: 2000
})

// Health check on startup
await pool.query('SELECT 1')

Thread Ownership Pattern (Race-Safe)

// First writer wins
await pool.query(
  `INSERT INTO threads (thread_id, user_id)
   VALUES ($1, $2)
   ON CONFLICT (thread_id) DO NOTHING`,
  [threadId, userId]
)

// Check ownership
const result = await pool.query(
  'SELECT user_id FROM threads WHERE thread_id = $1',
  [threadId]
)
return result.rows[0]?.user_id === userId