Pump Fun Backend

What this app do

• Indexing PumpFun TokenFactory events and storing them in the database
• Processing client requests (REST API)
• Client authentication and provision of JWT tokens

Env variables

Env variable name	Required	Default	Description
NODE_ENV	false	-	Available values: "development", "production" ]
PORT	false	3000	Application port
DATABASE_URL	true	-	Postgres DB connection string
TOKEN_FACTORY_ADDRESS	true	-	Pump Fun TokenFactory address
INDEXER_INITIAL_BLOCK_NUMBER	true	0	Block number on which Pump Fun TokenFactory was created. Required only for the first launch.
GOOGLE_CLOUD_PRIVATE_KEY	true	-	Google Cloud Storage private key
SERVICE_PRIVATE_KEY	true	-	Harmony Mainnet account private key. Required to send setWinner transaction once a day.
JWT_PRIVATE_KEY	true	-	JWT Private key in Base64 format (see "JWT keypair" for details)
JWT_PUBLIC_KEY	true	-	JWT Public key in Base64 format (see "JWT keypair" for details)

Authorization with MetaMask

1. Client initiates the login process and send POST /user/nonce with user address in request body
2. Backend generates a one-time nonce associated with user address
3. Client signing a message I'm signing my one-time nonce: <nonce> with Metamask
4. Client send signed message to Backend via POST /user/verify
5. Backend verifies the signature
6. If the signature and nonce are valid, Backend generate JWT tokens to maintain the session for the user. The nonce is invalidated to prevent reuse.

List of endpoints that require JWT accessToken (Authorization: Bearer <JWTAccessToken>):

• POST /comment
• POST /uploadImage
• POST /metadata
• POST /user
• GET /user/sign-in
• POST /user/update

Token metadata

Token metadata, such as .json file and token images, stored in GCS: https://console.cloud.google.com/storage/browser/pump-fun-metadata

Example:

URI:
https://storage.googleapis.com/pump-fun-metadata/metadata/52548318-41f6-4e63-a94a-d7cdf9000dbf.json

Token image from URI:
https://storage.googleapis.com/pump-fun-metadata/images/52548318-41f6-4e63-a94a-d7cdf9000dbf.jpg

GCS configuration: https://github.com/harmony-one/pump.fun.backend/blob/main/src/config/index.ts#L24

NOTE: some GCS configuration params currently hardcoded in src/config/index.ts.

JWT keypair

1. Generate new RSA keypair:

./keypair/keygen.sh

2. Convert public and private keys to Base64 to easily set up via env variables: https://stackoverflow.com/a/68730638/7311367

3. Set env variables:

JWT_PUBLIC_KEY=<PublicKeyBase64>
JWT_PRIVATE_KEY=<PrivateKeyBase64>

Recreate DB on fly.io

flyctl scale count 0

flyctl postgres connect -a pump-fun-backend-db

\l

SELECT pg_terminate_backend(pid) 
FROM pg_stat_activity 
WHERE pid <> pg_backend_pid() AND datname = 'pump_fun_backend';

drop database pump_fun_backend;

create database pump_fun_backend;

\q

// Set new env variables if needed: flyctl secrete set <secret_name> <secret_value>

flyctl deploy --ha=false