llms.txt
# Just The Tips
> Non-custodial multi-chain stablecoin tipping bot for creators. Runs on XRPL, Base, Arbitrum, and Solana. Users run their own bot — nothing is hosted by us. No accounts, no custody, no tracking.
Just The Tips is an open-source bot that lets creators (streamers, writers, podcast hosts) accept stablecoin tips from their audience. The creator configures the bot with their own receive addresses and runs it on their own infrastructure. The bot watches those addresses across multiple chains and posts thank-you messages in Discord, Telegram, Twitch, or X when tips arrive. The bot never holds keys or funds; every transaction is signed by the tipper in their own wallet.
Current version: 0.2.0-alpha.1 (April 2026). Completes the originally-scoped four-chain, four-platform surface — 0.1.0-alpha.7 shipped the MVP with Discord and Telegram; 0.2.0-alpha.1 added Twitch and X. Feature-complete relative to the original design; security patches only going forward. Forks for new chains or platforms are explicitly welcome under BSL 1.1.
## Project overview
- [Landing page](https://justthetips.dev/): the pitch, how it works, chain badges, deploy trace, download
- [Story](https://justthetips.dev/story): why this project exists, zine-format origin narrative
- [Live tip trace](https://justthetips.dev/chat-demo): animated walkthrough of a single tip from chat to chain to confirmation
- [Configurator](https://justthetips.dev/configurator): in-browser form that builds a personalized bot bundle
## Documentation
- [FAQ](https://justthetips.dev/faq): frequently asked questions about custody, chains, security, and setup
- [Wallet guide](https://justthetips.dev/wallet-guide): how to set up a wallet on each of the four supported chains
- [Twitch setup](https://justthetips.dev/twitch-setup): register a Twitch app, generate an OAuth token, get numeric user IDs, paste into config.env
- [X (Twitter) setup](https://justthetips.dev/x-setup): register an X Developer account, create an app with read+write permissions, get five credentials, paste into config.env
- [Troubleshooter](https://justthetips.dev/troubleshooter): decision tree for common problems
- [Releases](https://justthetips.dev/releases): versioned release history with hashes and audit notes
## Deploy guides
- [Deploy to Railway](https://justthetips.dev/deploy-railway): easiest path for non-technical creators, ~10 minutes
- [Deploy to Render](https://justthetips.dev/deploy-render): Git-based deployment, ~15 minutes
- [Deploy to Fly.io](https://justthetips.dev/deploy-fly): command-line deployment, ~15 minutes
- [Self-hosting guide](https://justthetips.dev/deploy-self): running on your own laptop or VPS
## Developer docs
- [Developer docs index](https://justthetips.dev/docs/): technical documentation landing
- [Evaluate before you deploy](https://justthetips.dev/docs/evaluate): how to audit the code in 5 minutes, 30 minutes, or an afternoon. AI review tools explicitly welcome.
- [Architecture](https://justthetips.dev/docs/architecture): top-down map of how the bot works
- [Security](https://justthetips.dev/docs/security): threat model, data handling, dependency policy, vulnerability reporting
## Key facts
- **Non-custodial:** the bot never holds keys or funds. Every transaction is signed by the tipper in their own wallet.
- **Multi-chain:** four chains supported (XRPL, Base, Arbitrum, Solana). Creator picks any combination. No single chain is load-bearing.
- **No tracking:** no analytics, no accounts, no phone-home telemetry. Configurator runs entirely in the browser; tokens and addresses never leave the user's machine.
- **Self-hosted:** users deploy to Railway, Render, Fly.io, or their own infrastructure. We host nothing.
- **Source-available:** BSL 1.1 license, converts to Apache 2.0 after four years.
- **Technology stack:** Node.js 22.6+, TypeScript with native `--experimental-strip-types`, Fastify HTTP server, no database, no smart contracts.
- **Chat platforms:** Discord, Telegram, Twitch, and X (Twitter). Each configured independently — enable any combination, or just one.
- **Assets accepted by default:** XRP on XRPL; USDC on Base; USDC on Arbitrum; SOL and USDC on Solana.
## Release and verification
- [Download (latest tarball)](https://justthetips.dev/downloads/justthetips-latest.tar.gz)
- [SHA-256 hash file](https://justthetips.dev/downloads/justthetips-0.2.0-alpha.1.tar.gz.sha256)
Verify the SHA-256 of your downloaded tarball matches the published hash before running. The hash is also displayed on the landing page's download section and in the releases page.
## Contact and contribution
- Source license: BSL 1.1 (see LICENSE.md in the source tarball)
- Security disclosures: see [Security](https://justthetips.dev/docs/security) for responsible disclosure policy
- The project is maintained by the publishers of justthetips.dev
