Configuration
every variable, every setting.

01Two places, one rule

In plain words: a small text file called .env tells the program how to start (which port, where the database file is, and the secret key that unlocks the console). Everything you will want to change later (your brand, your bot, your chats, your wallet, the scoring rules, the earning options) is a form in the operator console at /admin, saved with one click. You can run the whole product with four lines in .env and do the rest in the browser. The table below is the technical detail of the same rule.

• A value in .env is used until the same setting is saved in the console, which then wins. The start-up log lists the .env values in use.
• The three secrets are the exception: when TELEGRAM_BOT_TOKEN, SOLANA_RPC_URL or HELIUS_API_KEY is set in .env, the console field is locked and the .env value wins.
• Secrets saved in the console are encrypted with ADMIN_SECRET_KEY in admin.sqlite (next to the database). Back the key and that file up together.
• pnpm start (and pnpm recompute) reads .env from the folder you start it in. ENV_FILE=/path/to/file uses another file. Variables already set in the real environment win over .env.

02Bootstrap variables

03Starting values (also in the console)

Example of a custom link, with a made-up terminal:

# Example only
BUY_URL_TEMPLATE=https://your-terminal.example/swap?out={mint}
BUY_LABEL=Your Terminal

Source: .env.example, src/core/config.ts, src/settings/schema.ts, src/admin/kit.ts.

04Scoring method

These change every number on the site. /methodology always shows the values in use. Decide before you publish and announce any change. The first five are also in the console under Method; all apply after a restart.

Advanced (not in .env.example; defaults and formulas in SPEC.md): SCORING_MAX_PRICE_SOURCE_RATIO, SCORING_FOLLOWER_SIZE_USD, SCORING_LIQUIDITY_SLIPPAGE_K, SCORING_MAX_SLIPPAGE_BPS, SCORING_LIQUIDITY_FLOOR_USD, SCORING_PRE_RUNUP_THRESHOLD, SCORING_PRE_RUNUP_WINDOW_MIN, SCORING_EXIT_VWAP_MIN, SCORING_ENTRY_VWAP_MIN.

After changing the method, recompute the stored results so every call is scored the same way:

sudo systemctl stop verified-calls
pnpm build                  # once, if dist/ is older than the code
pnpm recompute --dry-run    # shows what would change
pnpm recompute
sudo systemctl start verified-calls

The script reads only the database and never calls a price API. Calls, seals and proofs are never touched. Exit 0 = done, 1 = some rows could not be recomputed (listed).

05Console-only settings

These have no .env variable: reply cards, the groups directory, integrity rules, API keys and every earning option (trading-link codes, Jupiter swap, VIP plans, paid listings, sponsored slot). See Admin console and Earnings.