- Indexing PumpFun TokenFactory events and storing them in the database
- Processing client requests (REST API)
- Client authentication and provision of JWT tokens
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) |
- Client initiates the login process and send POST
/user/nonce
with user address in request body - Backend generates a one-time nonce associated with user address
- Client signing a message
I'm signing my one-time nonce: <nonce>
with Metamask - Client send signed message to Backend via POST
/user/verify
- Backend verifies the signature
- 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, 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
.
- Generate new RSA keypair:
./keypair/keygen.sh
-
Convert public and private keys to Base64 to easily set up via env variables: https://stackoverflow.com/a/68730638/7311367
-
Set env variables:
JWT_PUBLIC_KEY=<PublicKeyBase64>
JWT_PRIVATE_KEY=<PrivateKeyBase64>
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 secrets set <secret_name> <secret_value>
flyctl deploy --ha=false