@blockxai/camp-codegen

@blockxai/camp-codegen

Minimal two-command CLI and SDK for AI → Compile → Deploy. Designed for beginners: colorful streaming logs, sane defaults, and automatic saving of all outputs to your working directory.

• Default API: https://evi-v3-production.up.railway.app
• Default network: basecamp

Install

npm i @blockxai/camp-codegen

Node 18+ is required (native fetch).

Environment

• No API key required
• Optional overrides:
  • API_BASE_URL (or ACAD_BASE_URL)
  • NETWORK (default: basecamp)
  • MAX_ITERS (default: 11)

CLI (two simple commands)

After install, you get two commands: camp and acad.

# 1) Generate from prompt and deploy
camp deploy:prompt --prompt "ERC20 with 1,000,000 supply" [--filename AIGenerated.sol] [--maxIters 11] [--arg value]*

# 2) Deploy from a local Solidity file
camp deploy:file --file ./MyToken.sol [--contractName MyToken] [--filename MyToken.sol] [--maxIters 11]

Interactive wizard (recommended)

Just run camp with no arguments to launch a colorful, guided wizard. It asks what you want to do today, offers popular templates, collects minimal inputs, and then streams logs live while saving everything locally.

camp          # opens the interactive wizard
camp wizard   # alias
camp interactive

• Run directories are named after your prompt (or filename) with a timestamp prefix:
  • ai_pipeline_runs/<timestamp>-<prompt-slug>/pipeline/ for prompt-based runs
  • ai_pipeline_runs/<timestamp>-<file-slug>/file/ for file-based runs
  • Example: ai_pipeline_runs/2025-09-24T14-25-10-erc721-with-minting/pipeline/

What you’ll see and where things are saved:

• Colorful, live logs streamed while the job runs
• All outputs under ./ai_pipeline_runs/<timestamp>-<name>/:
  • pipeline/ or file/
  • job.id, final.status.json
  • logs.ndjson
  • artifacts/ with sources/, abis/, scripts/

Examples:

# Generate and deploy from a prompt
camp deploy:prompt --prompt "ERC721 with minting and baseURI"

# Deploy from a local Solidity file
camp deploy:file --file ./contracts/MyNFT.sol --contractName MyNFT

Programmatic (optional)

The SDK exports AcadClient if you want to call the API directly.

import { AcadClient } from "@blockxai/camp-codegen";

const client = new AcadClient();
const jobId = await client.start_pipeline("ERC20 token", "basecamp", 11, "Token.sol", [1000000]);
const job = await client.wait_for_completion(jobId, { intervalSec: 2, timeoutSec: 2700 });

Build (for contributors)

# inside camp-codegen-js/
npm install
npm run build

Outputs ESM to dist/.