Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 9 additions & 2 deletions docusaurus.config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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'],
},
Expand Down Expand Up @@ -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',
Expand Down
49 changes: 49 additions & 0 deletions hpp-coder/index.md
Original file line number Diff line number Diff line change
@@ -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.
54 changes: 7 additions & 47 deletions hpp-coder/solidity-master-2.md → hpp-coder/model-details.md
Original file line number Diff line number Diff line change
@@ -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)**.

Expand Down Expand Up @@ -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.
Expand All @@ -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.
Expand Down Expand Up @@ -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.
Expand All @@ -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.
Expand Down Expand Up @@ -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.
Expand All @@ -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:
Expand All @@ -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.
15 changes: 15 additions & 0 deletions hpp-coder/quickstart.md
Original file line number Diff line number Diff line change
@@ -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).

:::
12 changes: 12 additions & 0 deletions sidebarsCoder.ts
Original file line number Diff line number Diff line change
@@ -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;
9 changes: 9 additions & 0 deletions src/pages/helloMarkdown.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
title: my hello page title
description: my hello page description
hide_table_of_contents: true
---

# Hello

How are you?
21 changes: 21 additions & 0 deletions src/pages/helloReact.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
import React from 'react';
import Layout from '@theme/Layout';

export default function Hello() {
return (
<Layout title="Hello" description="Hello React Page">
<div
style={{
display: 'flex',
justifyContent: 'center',
alignItems: 'center',
height: '50vh',
fontSize: '20px',
}}>
<p>
Edit <code>pages/helloReact.js</code> and save to reload.
</p>
</div>
</Layout>
);
}