diff --git a/docusaurus.config.ts b/docusaurus.config.ts index 4fa8554..5806276 100644 --- a/docusaurus.config.ts +++ b/docusaurus.config.ts @@ -89,7 +89,7 @@ const config: Config = { id: 'coder', path: 'hpp-coder', routeBasePath: 'hpp-coder', - sidebarPath: false, + sidebarPath: './sidebarsCoder.ts', }, ], // x402 payment-protocol docs — a standalone product section served at /x402 @@ -111,7 +111,7 @@ const config: Config = { { hashed: true, indexDocs: true, - docsRouteBasePath: ['/', 'hub', 'hpp-router', 'x402'], + docsRouteBasePath: ['/', 'hub', 'hpp-router', 'x402', 'hpp-coder'], highlightSearchTermsOnTargetPage: true, language: ['en'], }, @@ -156,6 +156,13 @@ const config: Config = { label: 'x402', position: 'right', }, + { + type: 'docSidebar', + sidebarId: 'coderSidebar', + docsPluginId: 'coder', + label: 'HPP Coder', + position: 'right', + }, { href: 'https://github.com/hpp-io/docs', label: 'GitHub', diff --git a/hpp-coder/index.md b/hpp-coder/index.md new file mode 100644 index 0000000..e1f2d9a --- /dev/null +++ b/hpp-coder/index.md @@ -0,0 +1,49 @@ +--- +title: HPP Coder +slug: / +sidebar_position: 1 +--- + +# Solidity-Master 2 + +**Solidity-Master 2** is a Large Language Model (LLM) specialized in Solidity smart contract development. + +Built upon **Qwen3-Coder-30B-A3B-Instruct**, Solidity-Master 2 is fine-tuned using a large-scale corpus of Solidity source code collected from the Ethereum Mainnet and GitHub. The model is optimized for Solidity code generation, completion, and understanding. + +To keep pace with the rapidly evolving Ethereum ecosystem, Solidity-Master 2 is continuously improved through monthly data collection and incremental fine-tuning. + +## Key Features + +- Built on **Qwen3-Coder-30B-A3B-Instruct** +- Fine-tuned using **Solidity v0.8.20+** source code +- Optimized for Solidity smart contract generation and completion +- Trained using verified Ethereum Mainnet contracts and high-quality open-source GitHub repositories +- Updated monthly through continual fine-tuning with newly collected datasets + +## Availability + +Solidity-Master 2 is available across HPP's products: + +- **HPP Router** — call it by the model id `ollama/solidity-master:2` (currently free). + See [HPP Router](/hpp-router) and [Models & Pricing](/hpp-router/models-and-pricing). +- **HPP Hub Playground** — pick **solidity-master:2** in the model selector to chat with it. + See the [Playground guide](/hub/playground). + +## Citation + +If you use Solidity-Master 2 in your research or projects, please cite the corresponding repository or technical documentation. + +```bibtex +@software{solidity_master2, + title = {Solidity-Master 2}, + author = {HPP project}, + year = {2026}, + note = {A Solidity-specialized large language model based on Qwen3-Coder-30B-A3B-Instruct} +} +``` + +## License + +The license of Solidity-Master 2 follows the licensing terms of the underlying **Qwen3-Coder-30B-A3B-Instruct** base model. + +Please refer to the project repository for additional licensing information. diff --git a/hpp-coder/solidity-master-2.md b/hpp-coder/model-details.md similarity index 86% rename from hpp-coder/solidity-master-2.md rename to hpp-coder/model-details.md index 7cbdee0..370d815 100644 --- a/hpp-coder/solidity-master-2.md +++ b/hpp-coder/model-details.md @@ -1,24 +1,11 @@ -# Solidity-Master 2 - -## Overview - -**Solidity-Master 2** is a Large Language Model (LLM) specialized in Solidity smart contract development. - -Built upon **Qwen3-Coder-30B-A3B-Instruct**, Solidity-Master 2 is fine-tuned using a large-scale corpus of Solidity source code collected from the Ethereum Mainnet and GitHub. The model is optimized for Solidity code generation, completion, and understanding. - -To keep pace with the rapidly evolving Ethereum ecosystem, Solidity-Master 2 is continuously improved through monthly data collection and incremental fine-tuning. - -### Key Features - -- Built on **Qwen3-Coder-30B-A3B-Instruct** -- Fine-tuned using **Solidity v0.8.20+** source code -- Optimized for Solidity smart contract generation and completion -- Trained using verified Ethereum Mainnet contracts and high-quality open-source GitHub repositories -- Updated monthly through continual fine-tuning with newly collected datasets - --- +title: Model Details +sidebar_position: 3 +--- + +# Model Details -## Model Architecture +## Architecture Solidity-Master 2 inherits the architecture of **Qwen3-Coder-30B-A3B-Instruct** without modifying the underlying network structure. Domain adaptation is achieved through **Supervised Fine-Tuning (SFT)** using **Low-Rank Adaptation (LoRA)**. @@ -95,7 +82,6 @@ Only verified contracts with publicly available source code are included in the - Complete source files - Successfully retrievable metadata - #### 1.2 GitHub Open-source Solidity repositories are continuously collected from GitHub. @@ -109,7 +95,6 @@ The crawler prioritizes repositories satisfying the following criteria: The crawler extracts Solidity source files and stores them in the internal code repository for preprocessing. - #### 1.3 Deduplication Source code collected from Ethereum Mainnet and GitHub often contains duplicated contracts or mirrored repositories. @@ -206,7 +191,6 @@ During deployment, the trained LoRA adapters may either: - Be merged into the base model weights, or - Be loaded dynamically during inference. - ### Continual Learning The Solidity ecosystem evolves rapidly as new language features, libraries, and smart contract patterns emerge. @@ -231,6 +215,7 @@ This continual learning strategy enables Solidity-Master 2 to remain aligned wit As the training corpus continues to grow, future versions of Solidity-Master are expected to deliver improved code quality, broader language coverage, and stronger generalization across diverse Solidity development tasks. --- + ## Evaluation Solidity-Master 2 was evaluated using **SolContractEval**, a benchmark designed to assess Solidity code generation capabilities. @@ -277,7 +262,6 @@ Solidity-Master 2 is optimized for a broad range of Solidity development tasks, The model is intended to assist developers throughout the smart contract development lifecycle, from code generation to maintenance. ---- ## Limitations Although Solidity-Master 2 is specialized for Solidity programming, it is **not** intended to replace professional smart contract auditing. @@ -291,7 +275,6 @@ Current limitations include: - Human review is required before production deployment - Benchmark results are based on a subset of 40 SolContractEval tasks ---- ## Future Work Future releases of Solidity-Master will focus on: @@ -304,26 +287,3 @@ Future releases of Solidity-Master will focus on: - Improving instruction diversity for advanced smart contract development tasks The model will continue to be updated on a monthly basis through the continual learning pipeline, ensuring alignment with the latest Solidity language features and development practices. - ---- - -## Citation - -If you use Solidity-Master 2 in your research or projects, please cite the corresponding repository or technical documentation. - -```bibtex -@software{solidity_master2, - title = {Solidity-Master 2}, - author = {HPP project}, - year = {2026}, - note = {A Solidity-specialized large language model based on Qwen3-Coder-30B-A3B-Instruct} -} -``` - ---- - -## License - -The license of Solidity-Master 2 follows the licensing terms of the underlying **Qwen3-Coder-30B-A3B-Instruct** base model. - -Please refer to the project repository for additional licensing information. diff --git a/hpp-coder/quickstart.md b/hpp-coder/quickstart.md new file mode 100644 index 0000000..c098441 --- /dev/null +++ b/hpp-coder/quickstart.md @@ -0,0 +1,15 @@ +--- +title: Quickstart +sidebar_position: 2 +--- + +# Quickstart + +:::note Coming Soon + +This page is under construction. In the meantime, you can access Solidity-Master 2 via: + +- **HPP Router** — use model id `ollama/solidity-master:2`. See [HPP Router](/hpp-router) and [Models & Pricing](/hpp-router/models-and-pricing). +- **HPP Hub Playground** — pick **solidity-master:2** in the model selector. See the [Playground guide](/hub/playground). + +::: diff --git a/sidebarsCoder.ts b/sidebarsCoder.ts new file mode 100644 index 0000000..b0301b4 --- /dev/null +++ b/sidebarsCoder.ts @@ -0,0 +1,12 @@ +import type {SidebarsConfig} from '@docusaurus/plugin-content-docs'; + +// Sidebar for the standalone "HPP Hub" guide (the `hub` docs instance, served at /hub). +// Pages appear in the left sidebar in this order; add new pages here as you create them +// under `hub/` (the id is the file path without the extension). +const sidebars: SidebarsConfig = { + coderSidebar: [ + {type: 'autogenerated', dirName: '.'}, + ], +}; + +export default sidebars; diff --git a/src/pages/helloMarkdown.md b/src/pages/helloMarkdown.md new file mode 100644 index 0000000..1144e8b --- /dev/null +++ b/src/pages/helloMarkdown.md @@ -0,0 +1,9 @@ +--- +title: my hello page title +description: my hello page description +hide_table_of_contents: true +--- + +# Hello + +How are you? \ No newline at end of file diff --git a/src/pages/helloReact.js b/src/pages/helloReact.js new file mode 100644 index 0000000..71868e1 --- /dev/null +++ b/src/pages/helloReact.js @@ -0,0 +1,21 @@ +import React from 'react'; +import Layout from '@theme/Layout'; + +export default function Hello() { + return ( + +
+

+ Edit pages/helloReact.js and save to reload. +

+
+ + ); +} \ No newline at end of file