Release: adamant-tradebot v8.0.0 — technical overview and upgrade notes

[adamantmm]

Summary

adamant-tradebot v8.0.0 is now released on the dev branch and tagged as v8.0.0.

This is a major upgrade of the open-source (Basic) market-making bot. It realigns the OSS codebase with the current Premium engineering baseline while keeping OSS scope intact: REST-first, spot-focused, no Premium-only modules reintroduced.

Tracking: #109 · merged in #110

If you operate the bot for a listed token, the practical outcome is a more dependable runtime: cleaner startup, safer upgrades on existing databases, refreshed exchange connectors, and an optional private WebUI API for external clients.

---

What changed at a glance

Area	v8.0.0 highlights
Version	7.0.1 → 8.0.0
Runtime	Node.js 22.2+ required
Scope	~235 files; architecture, commands, connectors, deps, security, tests
HTTP stack	Express removed from WebUI path; Fastify + JWT for optional Bot API
ADM intake	Rebuilt on adamant-api 3.x
Database	Automatic migrations on startup (MongoDB driver 7.x)
WebUI API	Optional /api/v1 + WebSocket transport (scenario A)
Exchanges	FameEX → FameEXnet; XeggeX removed from OSS; other OSS connectors refreshed

---

Architecture

Bootstrap sequence (app.js)

Startup is now explicit and ordered:

1. Wait for MongoDB connection and db.ready
2. Run registered DB migrations (modules/dbMigrations.js)
3. Initialize services (ADM socket/polling, debug/health routes, optional WebUI API)
4. Warm up connector metadata (modules/startupWarmup.js)
5. Start active mm_* trading modules

This reduces race conditions on cold start and makes upgrades on existing deployments safer.

Command handling

The monolithic modules/commandTxs.js was split into focused handlers under modules/commands/:

• account, orders, trade, info, features
• shared plumbing: base, compose, context, helpers

Commands still arrive via ADAMANT Messenger (and Telegram where configured), but the code path is easier to maintain and extend.

ADM transaction intake

Legacy modules (modules/api.js, modules/incomingTxsParser.js, modules/checkerTransactions.js) were replaced with:

• modules/adamantApi.js
• modules/admTxChecker.js
• modules/admTxParser.js

This aligns ADM command intake with adamant-api 3.x and the current socket/polling patterns used in the Premium line.

Database migrations

modules/dbMigrations.js runs one-off migrations at startup. The first included migration renames legacy order field type → side when safe to do so.

Upgrade note: existing deployments should back up MongoDB before the first v8 start, then verify open orders and stats after migration.

---

Optional WebUI API (Bot API v1)

v8.0 ships the private HTTP API discussed earlier in #48 and #49.

Location: api/

Stack:

• Fastify HTTP server
• JWT auth (@fastify/jwt, private_webui_secret_key)
• Zod request validation
• Socket.IO for params:updated and related transport hooks
• Security helpers: bind-host resolution, allowed-IP hook, CORS policy

Core routes (/api/v1):

• GET /bot — capabilities bootstrap (installed mm_* modules + exchange feature flags)
• market, account, params, commands, messages

The API is optional and off by default. Enable via private_webui settings in config. It is designed for self-hosted graphical clients; the bot remains the only component that talks to exchanges.

Security reminder: set a strong private_webui_secret_key, restrict private_webui_allowed_ips, and keep the API off the public internet unless you know what you are doing.

---

Exchange connectors (OSS)

Supported in the Basic edition:

• Azbit
• P2PB2B
• StakeCube
• Coinstore
• FameEX (via FameEXnet connector)
• NonKYC

Breaking changes for operators:

Change	Action
FameEX API surface	Switch config to FameEXnet (trader_fameexnet.js / fameexnet_api.js)
XeggeX removed	Migrate to another supported CEX or use Premium for broader coverage

Market-making modules (mm_trader, mm_orderbook_builder, mm_liquidity_provider, mm_price_watcher, orderCollector, orderStats, orderUtils) were refreshed alongside trader adapters.

---

Dependencies and tooling

Notable runtime updates:

• adamant-api 2.x → 3.x
• mongodb 6 → 7
• axios updated
• Added zod, fast-jwt, json-parse-bigint
• Removed express, form-data, uuid from the WebUI path

Dev/tooling:

• Babel 8, ESLint 10
• Jest with scoped runners (npm run test:general, npm run test:api-webui)
• tsconfig.webui-api.json for API typedef checks
• CONTRIBUTING.md with test workflow guidance

At release time: npm run lint clean; npm audit --audit-level=high reported 0 high/critical advisories.

---

Upgrade guide (v7.x → v8.0.0)

pm2 stop tradebot          # or your process manager
cd adamant-tradebot
git pull
npm i

Then:

1. Node.js — upgrade to 22.2+ if needed (.nvmrc in repo)
2. Config — merge new fields from config.default.jsonc into your config.jsonc
3. FameEX — confirm FameEXnet connector settings
4. MongoDB — back up DB; let migrations run on first start
5. WebUI API — if enabled, review private_webui_* security settings
6. Restart: pm2 restart tradebot

Named configs still work:

pm2 start app.js --name tradebot-p2b -- p2b_mmtest

---

OSS scope boundary

v8.0 brings Premium-line engineering quality into the OSS tree, but does not reintroduce Premium-only assumptions:

• No mandatory WebSocket exchange connectors
• No perpetual/futures stack
• No 40+ exchange catalog
• Spot, REST-first baseline preserved

For advanced modules, custom CEX connectors, WebUI hosting, and setup support, see Premium features.

---

Further reading

• Repository: https://github.com/Adamant-im/adamant-tradebot
• Release: https://github.com/Adamant-im/adamant-tradebot/releases/tag/v8.0.0
• Installation: https://marketmaking.app/cex-mm/installation/
• Command reference: https://marketmaking.app/cex-mm/command-reference/
• Medium article (project-owner focused): link to be added after publish

---

Feedback

If you run v8.0 on a live pair, please share:

• exchange used
• upgrade path (fresh install vs v7 migration)
• any connector or config surprises

For bugs, open an issue. For product questions, reply here in MarketMaking.app.

[adamant-al]

Great update!