Skip to content

Repository files navigation

iTXTech fdnext

License: AGPL v3Version

fdnext is a high-performance, one-stop parsing engine for memory chips. It provides comprehensive support for part-number (PN) decoding, NAND Flash ID inspection, and database searches across multiple vendors and storage technologies.

简体中文


🚀 Try it in Action

FlashMaster is the flagship implementation of the fdnext engine—a workstation-grade intelligence platform for engineers.

👉 Open FlashMaster Web App


✨ Overview

fdnext is designed as the backbone for memory chip intelligence. It normalizes complex vendor data into structured, actionable information, enriched with local resources and verified against strict result contracts.

Core Workflows

  • Part Number Decoding: Instant decoding of raw NAND, eMMC, UFS, DRAM, and more.
  • Flash ID Decoding: Deep inspection of NAND Flash IDs through a typed identifier API.
  • Smart Resource Flow: Bundled fdb, mdb, and language packs with Micron FBGA code lookup.
  • Universal Dispatch: Shared runtime layer for native Node.js HTTP and Cloudflare Workers.
  • Data Maintenance: CLI tools for FDB/MDB generation, crawling, DecodePack management, and evidence metadata auditing.

🏗️ Architecture

fdnext is organized as a strict TypeScript monorepo. The main package is now batteries-included, while platform packages stay thin adapters.

  • Core (@itxtech/fdnext-core): Engine, DecodePack rules/compiler, embedded resources, result contract, and shared runtime.
  • Adapters: Native support for Node.js HTTP and Cloudflare Workers.
  • Data Tools (@itxtech/fdbgen): Database generation, MDB crawling, and resource aggregation tools.
  • Testing (@itxtech/fdnext-contract-test): Result schema and behavior contract validation.
  • Legacy compatibility:@itxtech/fd-server exposes the old FlashDetector / FDWebServer HTTP API for FlashMaster Classic migration deployments, with Cloudflare Workers as the preferred deployment path.

🛠️ Toolchain & Development

This project uses pnpm for workspace management.

Prerequisites

  • Node.js 24+
  • pnpm 11+

Quick Start

# Install dependencies
pnpm install
# Build all packages
pnpm build
# Run test suite
pnpm test

Useful Commands

CommandDescription
pnpm buildBuild all packages in the workspace
pnpm testRun all unit and integration tests
pnpm typecheckRun TypeScript type checks across the repo
pnpm contract:checkValidate result schema and behavior contracts
pnpm check:decodepackValidate DecodePack structure and maintenance policies
pnpm check:staticRun TypeScript and DecodePack static checks
pnpm checkRun the fast static and DecodePack rule gate
pnpm check:prBuild once, then run the complete source/package contract gate
pnpm lintAlias for pnpm check:static
pnpm cliRun the core CLI tools (DecodePack management)
pnpm fdbgen:generateGenerate the FDB database

📊 Parsing Coverage

AreaProduct FamiliesSupported Vendors
NAND PNRaw NAND, eMMC, UFS, eMCP/uMCP, E2NANDSamsung, SK hynix, SanDisk/WD, KIOXIA, Micron, YMTC, Kingston, Longsys, BIWIN, Silicon Motion, ESMT, Macronix, Spectek, Intel
DRAM PNDDR, LPDDR (Density, Gen, Package, Speed, etc.)Micron, Crucial, SK hynix, Samsung, Nanya, Elpida, CXMT, GigaDevice, ISSI, Winbond, ESMT, Etron, Spectek, BIWIN, Longsys

📖 Documentation

The unified documentation index can be found in docs/README.md.


⚖️ License

Copyright (c) 2019-2026 iTX Technologies

This project is licensed under the GNU Affero General Public License v3.0. See the LICENSE file for details.

About

Memory Chip Parsing Engine

Resources

Stars

8 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages