SolcQueue

SolcQueue is a production-oriented Solidity compilation service. It turns Solidity source into ABI, creation bytecode, deployed bytecode, compiler metadata, diagnostics, and a reproducible source hash through either a synchronous HTTP call or an asynchronous worker queue.

• Compiles real Solidity source with the official solc-js compiler
• Produces ABI, bytecode, deployed bytecode, metadata, warnings, and errors
• Supports synchronous compilation and asynchronous jobs
• Scales active workers in response to queue depth within configured limits
• Streams job lifecycle events over Server-Sent Events (SSE)
• Validates source size, filenames, contract names, and optimizer configuration
• Reports queue, worker, compiler, completion, and failure metrics
• Disables framework fingerprinting and returns consistent JSON errors

It is a build and processing service. It does not deploy contracts, manage private keys, or claim blockchain consensus.

• Node.js 18 or newer

git clone https://github.com/centxyz/SolcQueue.git
cd SolcQueue
npm install
npm test
npm start

The API listens on port 3000 by default.

curl -s http://localhost:3000/api/compile \
  -H 'Content-Type: application/json' \
  -d '{
    "fileName": "Counter.sol",
    "contractName": "Counter",
    "source": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0; contract Counter { uint256 public count; function increment() external { count += 1; } }",
    "optimizer": { "enabled": true, "runs": 200 }
  }'

The successful response contains compiler, sourceHash, diagnostics, and one or more contract artifacts under contracts.

Submit the same JSON body to the job endpoint:

curl -i http://localhost:3000/api/jobs \
  -H 'Content-Type: application/json' \
  --data-binary @request.json

The server returns 202 Accepted, a job ID, and a Location header. Poll the location until the status is completed or failed:

curl http://localhost:3000/api/jobs/JOB_ID

Watch every job transition in real time:

curl -N http://localhost:3000/api/events

The default maximum Solidity source size is 512 KiB. The HTTP JSON body limit is 1 MiB.

npm test

The suite compiles a real contract and verifies bytecode/ABI output, compiler diagnostics, request validation, asynchronous success and failure paths, worker scaling, metrics, and routing.

MIT © cent

• Compilation success does not imply contract correctness or security.
• The in-memory job queue and metrics are scoped to one running service instance.
• The service does not manage keys, deploy contracts, or provide chain consensus.