farcaster token bot

clone this repository to easily spin-up a farcaster bot that tracks a token.

currently supports erc20, some tweaks are needed to track erc721 and erc1155.

before starting

this repository was started for pointsbot, meaning that i tried to generalize it as much as possible, but you'll need to adapt the code a lil bit for whatever token you wanna track.

what it does right now

catch "swap" events on a given uniswap pool and publishes it on farcaster (example cast) - by default the swap events tracked are between your token and $weth, but easy to replace $weth with something else
catch direct "transfer" events between two addresses and publishes it on farcaster - publish only if one of the two addresses involved own a farcaster account
publishes on farcaster hourly updates about token stats (market cap, volumes 24h, holders) (example cast)
publishes updates every 2 hour about the top holders on farcaster (example cast)

how to make it work

install packages with bun install (if u don't use bun, u can still use npm or yarn)
setup local env with cp .env.tpl .env and then populate your .env
update src/constants/index.ts accordingly with your token details (address, symbol and decimals) - you can find those on https://etherscan.io/token/YOUR_TOKEN_ADDRESS
deploy it somewhere - i used railway and created a simple service connected to my github repository, so that at each push it triggers a new deployment.

about api keys

go here to get airstack api key - airstack is used to get the leaderboard of holders on farcaster
go here to get dextools api key - dextools is used to get token stats
go here to get a farcaster signer uuid and api key - ofc used to publish casts on farcaster, you'll likely need to create a new account for your bot
go here to get alchemy rpc url
go here to setup your webhook - check this gist to understand how to structure the graphql query in order to filter the right events sent through your webhook

what next?