From 17de24c99c4e876de1f1c9ca678e6467c9254309 Mon Sep 17 00:00:00 2001 From: Hochul Seok Date: Tue, 30 Jun 2026 14:52:24 +0900 Subject: [PATCH 1/2] Expose HPP Coder in the navbar - Add an "HPP Coder" navbar item (right of x402) linking to the Solidity-Master 2 model card in the existing `coder` docs instance. - Give the doc `slug: /` so it serves at the clean /hpp-coder URL, matching the /hub, /hpp-router, /x402 convention. - Index the hpp-coder instance for local search. - Add an "Availability" section to the model card linking to where the model can be used: HPP Router (ollama/solidity-master:2, free) and the HPP Hub Playground. --- docusaurus.config.ts | 9 ++++++++- hpp-coder/solidity-master-2.md | 15 +++++++++++++++ 2 files changed, 23 insertions(+), 1 deletion(-) diff --git a/docusaurus.config.ts b/docusaurus.config.ts index 4fa8554..fb87c66 100644 --- a/docusaurus.config.ts +++ b/docusaurus.config.ts @@ -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: 'doc', + docId: 'solidity-master-2', + docsPluginId: 'coder', + label: 'HPP Coder', + position: 'right', + }, { href: 'https://github.com/hpp-io/docs', label: 'GitHub', diff --git a/hpp-coder/solidity-master-2.md b/hpp-coder/solidity-master-2.md index 7cbdee0..c27f621 100644 --- a/hpp-coder/solidity-master-2.md +++ b/hpp-coder/solidity-master-2.md @@ -1,3 +1,7 @@ +--- +slug: / +--- + # Solidity-Master 2 ## Overview @@ -18,6 +22,17 @@ To keep pace with the rapidly evolving Ethereum ecosystem, Solidity-Master 2 is --- +## 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). + +--- + ## Model 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)**. From 42dde8210bf1ab161b7ffecf96ea8fb9bee803ea Mon Sep 17 00:00:00 2001 From: Hayarobi Park Date: Thu, 2 Jul 2026 11:26:39 +0900 Subject: [PATCH 2/2] docs(hpp-coder): restructure into multi-page layout with sidebar MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Split solidity-master-2.md into index.md, model-details.md, and quickstart.md (coming soon) following the Overview → Quickstart → Model Details pattern used across other HPP doc sections - Consolidate architecture, data pipeline, evaluation, and capabilities into a single Model Details page --- docusaurus.config.ts | 6 +- hpp-coder/index.md | 49 ++++++++++++++ ...{solidity-master-2.md => model-details.md} | 65 ++----------------- hpp-coder/quickstart.md | 15 +++++ sidebarsCoder.ts | 12 ++++ src/pages/helloMarkdown.md | 9 +++ src/pages/helloReact.js | 21 ++++++ 7 files changed, 114 insertions(+), 63 deletions(-) create mode 100644 hpp-coder/index.md rename hpp-coder/{solidity-master-2.md => model-details.md} (83%) create mode 100644 hpp-coder/quickstart.md create mode 100644 sidebarsCoder.ts create mode 100644 src/pages/helloMarkdown.md create mode 100644 src/pages/helloReact.js diff --git a/docusaurus.config.ts b/docusaurus.config.ts index fb87c66..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 @@ -157,8 +157,8 @@ const config: Config = { position: 'right', }, { - type: 'doc', - docId: 'solidity-master-2', + type: 'docSidebar', + sidebarId: 'coderSidebar', docsPluginId: 'coder', label: 'HPP Coder', position: 'right', 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 83% rename from hpp-coder/solidity-master-2.md rename to hpp-coder/model-details.md index c27f621..370d815 100644 --- a/hpp-coder/solidity-master-2.md +++ b/hpp-coder/model-details.md @@ -1,39 +1,11 @@ --- -slug: / +title: Model Details +sidebar_position: 3 --- -# Solidity-Master 2 +# Model Details -## 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 - ---- - -## 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). - ---- - -## 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)**. @@ -110,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. @@ -124,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. @@ -221,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. @@ -246,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. @@ -292,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. @@ -306,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: @@ -319,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