Create README.md

README.md

@@ -0,0 +1,173 @@
+---
+language:
+- en
+- zh
+license: apache-2.0
+library_name: transformers
+tags:
+- web3
+- finance
+- defi
+- chain-of-thought
+- sft
+- security-audit
+- on-device-ai
+metrics:
+- accuracy
+- ponzi-detection-rate
+- code-security-score
+pipeline_tag: text-generation
+inference: false
+---
+
+# Preface: The Era of Sovereign Intelligence
+
+> *"Not your weights, not your intelligence."*
+> *In the dark forest of Web3, an individual without private AI is merely prey.*
+
+## 1. Model Summary & Legacy
+
+### The Evolution of Sovereign Intelligence
+The DMind lineage was born from a singular conviction: **that decentralized finance deserves decentralized intelligence.** This journey began with **DMind-1**, which shattered the monopoly of closed-source AI by releasing the world's first Web3-native LLM, democratizing access to Solidity comprehension. It continued with **DMind-2**, which proved that domain-specific fine-tuning could outmaneuver trillion-parameter giants in vertical benchmarks, establishing a new standard for specialized AI.
+
+### A Paradigm Shift: From Retrieval to Reflection
+However, **DMind-3** represents our most significant evolutionary leap yet. We recognized that in the high-stakes, adversarial "dark forest" of DeFi, standard knowledge retrieval is a liability. A model must do more than recite facts; it must possess **Reflective Intelligence (System 2 Thinking)** to navigate risk.
+
+**DMind-3-mini** embodies this philosophy. Positioned as the "Brain" within our local ecosystem, it bridges the gap between the real-time reflexes of the edge-side *DMind-3-nano* and the macroscopic foresight of the cloud-native *DMind-3-max*. It is engineered not as a chatbot, but as a **"Computational Financial Actuary"**—a privacy-first, offline-capable engine designed to bring institutional-grade logic to the individual sovereign user.
+
+### 2. From Copilot to Species
+Traditional "Copilots" are merely assistants. In the 24/7 PVP environment of DeFi, you need an **Agent** capable of independent risk assessment. Humans—carbon-based lifeforms with limited processing speed—are increasingly outmatched by MEV bots and algorithmic predators.
+
+We need an evolutionary tool: **An "Exo-Cortex" that runs locally, remains absolutely loyal, and deeply understands the dark logic of finance.**
+
+### 3. The Mission
+**DMind-3-mini** was not built to score points on general benchmarks. It was engineered to arm the individual against institutional extraction. We refuse to upload your Alpha strategies to the cloud. True Web3 AI must be **Private**, **Local**, and **Antifragile**.
+
+* **DMind-3-nano** is your Shield.
+* **DMind-3-mini** is your Spear.
+
+Welcome to the era of **Sovereign Intelligence**.
+
+---
+
+# Model Card: DMind-3-mini
+
+## 1. Model Summary & Legacy
+
+### The DMind Heritage
+The DMind series represents a continuous evolution in specialized Web3 artificial intelligence:
+* **DMind-1 Series:** Pioneered the industry by open-sourcing the world's first LLM dedicated to Web3/Solidity contexts.
+* **DMind-2 Series:** Achieved SOTA performance in vertical benchmarks, proving that domain-specific fine-tuning can outperform larger generalist models.
+* **DMind-3 Series (Current):** Marks a paradigm shift from "Knowledge Retrieval" to **"Reflective Intelligence" (System 2 Thinking)**. We introduce the **C³-SFT** paradigm to solve the hallucination and logic deficit problems in high-stakes financial environments.
+
+### The DMind-3 Family
+The DMind-3 lineup is architected for specific computational environments:
+* **DMind-3-nano (270M):** **The Shield.** An edge-side Intent Recognition model. Optimized for <500MB memory footprint, delivering >98% accuracy in identifying malicious transaction signatures locally.
+* **DMind-3-mini (4B) [THIS MODEL]:** **The Brain.** A "Local Financial Actuary". The core reasoning engine designed for high-end consumer workstations, balancing deep logic inference with privacy-first offline deployment.
+* **DMind-3-max (MoE):** **The Oracle.** A cloud-native Mixture-of-Experts model designed for cross-chain macroeconomic simulation and ecosystem-wide governance.
+
+---
+
+## 2. Model Details
+
+* **Model Name:** DMind-3-mini
+* **Organization:** DMind & Zhulong AI (Hangzhou, China)
+* **Base Architecture:** Qwen3-4B-Thinking-2507 (Customized Transformer w/ RoPE)
+* **Parameter Count:** 4.2 Billion
+* **Precision:** **BF16 (Native)**
+    * *Note: We strictly advise against 4-bit quantization for financial logic tasks, as it degrades numerical precision in APY/IL calculations.*
+* **Context Window:** 128k tokens
+* **Hardware Requirement:** GPU with $\ge$ **12GB VRAM** (Recommended: NVIDIA RTX 4070Ti+, Apple M3/M4 Pro/Max).
+
+---
+
+## 3. Methodology: C³-SFT
+
+**DMind-3-mini** introduces **Contrastive Chain-of-Correction Supervised Fine-Tuning (C³-SFT)**.
+Unlike standard SFT which models a direct mapping $P(y|x)$, C³-SFT forces the model to navigate a "Correction Trajectory" by contrasting against plausible but flawed reasoning (Negative Samples).
+
+![Figure 1: C3-SFT Paradigm](https://your-image-host-url/figure1-c3sft.png)
+*(Figure 1: The C³-SFT training pipeline, illustrating the Triplet Data Structure and Contextual Loss Masking)*
+
+### 3.1 Mathematical Formalization
+Let $\mathcal{D} = \{(x, y^-, y^+_{cot})\}_{i=1}^N$ be our dataset, where $x$ is the financial query, $y^-$ is a "Negative Sample" containing common logical fallacies (e.g., overlooking Impermanent Loss), and $y^+_{cot}$ is the corrective Chain-of-Thought.
+
+The optimization objective $\mathcal{L}_{C^3}$ is defined as maximizing the conditional probability of the correction path, given the error context:
+
+$$
+\mathcal{L}_{C^3}(\theta) = - \mathbb{E}_{\mathcal{D}} \left[ \sum_{t=1}^{T} \alpha_t \cdot \log P_\theta(y^+_{t} \mid x, y^-, y^+_{<t}) \right] + \lambda \mathbb{KL}[\pi_\theta || \pi_{\text{ref}}]
+$$
+
+Where:
+* The input sequence explicitly includes the error state: $[x; \texttt{<SEP>}; y^-; \texttt{<CRITIQUE>}]$.
+* $\alpha_t$ is a dynamic attention weight that penalizes logical discontinuities.
+
+### 3.2 Dual-State Inference Mechanism
+During inference, DMind-3-mini operates in two distinct topological modes based on the presence of a trigger token $\tau$. Let $\mathcal{I}(x)$ denote the inference function:
+
+$$
+\hat{y} = 
+\begin{cases} 
+\operatorname*{arg\,max}\limits_{y} P_\theta(y \mid x) & \text{if } \tau = \emptyset \quad (\text{Standard Mode}) \\
+\operatorname*{arg\,max}\limits_{y} P_\theta(y \mid x, \mathcal{G}_{neg}(x), \mathcal{H}_{crit}) & \text{if } \tau = \texttt{<REFLECT>} \quad (\text{Audit Mode})
+\end{cases}
+$$
+
+* **Standard Mode:** Optimized for latency; generates direct financial summaries.
+* **Audit Mode:** The model internally generates a latent negative hypothesis $\mathcal{G}_{neg}(x)$ and applies the critique operator $\mathcal{H}_{crit}$ to derive a rigorously verified conclusion. This is critical for **Smart Contract Auditing** and **Ponzi Scheme Detection**.
+
+---
+
+## 4. Intended Use: Web3 Financial Know-How
+
+DMind-3-mini is not just a coder; it is a **Financial Risk Assessor**.
+
+### Key Capabilities
+1.  **Yield Attribution Analysis:** Deconstructs APY sources to distinguish between "Real Yield" (Protocol Revenue) and "Inflationary Yield" (Token Emissions).
+2.  **Liquidity Provisioning (LP) Simulation:** Calculates optimal tick ranges for Uniswap V3 positions by modeling volatility surfaces locally.
+3.  **Risk-Adjusted Code Auditing:** Beyond syntax errors, it identifies economic exploits (e.g., Flash Loan attack vectors based on price manipulation).
+
+### The "Brain & Shield" Ecosystem
+For maximum security, we recommend the **DMind Local Stack**:
+
+![Figure 2: Brain and Shield Ecosystem](https://your-image-host-url/figure2-ecosystem.png)
+*(Figure 2: The On-Device Inference Ecosystem showing the synergy between Nano (Shield) and Mini (Brain))*
+
+* **The Brain (DMind-3-mini):** Runs on your high-performance laptop. Handles complex strategy formulation, deep research, and "System 2" logic.
+* **The Shield (DMind-3-nano):** Runs in your browser/wallet background. Handles real-time transaction signing safety checks and "System 1" intuition.
+
+---
+
+## 5. Training Data
+
+The model was fine-tuned on **82,000** high-value private samples:
+
+| Data Source | Proportion | Description |
+| :--- | :---: | :--- |
+| **Institutional Alpha Reports** | 40% | Deep dive reports from top-tier firms (e.g., Paradigm, Delphi), structured into logic chains. |
+| **Financial Post-Mortems** | 30% | Historical analysis of collapses (Luna, FTX, Euler Hack), focusing on pre-crash indicators. |
+| **Smart Contract Audits** | 20% | C³-SFT formatted pairs: Vulnerable Code $\to$ Exploit Analysis $\to$ Fix. |
+| **On-Chain Behavior Logs** | 10% | Parsed intent analysis of "Smart Money" wallet operations during high volatility events. |
+
+---
+
+## 6. Performance Benchmarks
+
+Evaluated on **Web3-Finance-Eval-2026**:
+
+| Metric | DMind-3-mini (4B) | Llama-3-70B | GPT-4o (General) |
+| :--- | :---: | :---: | :---: |
+| **Ponzi Logic Detection** | **96.4%** | 78.2% | 85.5% |
+| **Impermanent Loss Calc** | **99.1%** | 85.0% | 92.3% |
+| **Contract Exploit ID** | **92.3%** | 88.5% | 89.1% |
+| **Inference Cost** | **Local (Free)** | High | High |
+
+*DMind-3-mini outperforms generalist models 15x its size in specific vertical tasks, validating the C³-SFT approach.*
+
+---
+
+## 7. Limitations & Disclaimer
+
+* **High Hardware Barrier:** Due to the decision to retain BF16 precision for financial accuracy, this model **requires >= 12GB VRAM**. It is not suitable for standard office laptops.
+* **Knowledge Cutoff:** While the *logic* is robust, specific protocol data (TVL, Price) is limited to the training cutoff. Use with RAG for real-time data.
+* **Legal Disclaimer:** This model is an **analytical tool**, not a financial advisor. The output (NFA) should never be the sole basis for investment decisions. The developers assume no liability for financial losses.