Deploy API

Endpoints for deployment preflight checks and deployment registration.

Preflight Check

POST /api/deploy/preflight

Checks whether the user’s tier allows deployment to a given chain. Free-tier users cannot deploy to mainnet chains (chain IDs: 1, 42161, 8453, 137, 10).

Request Body:

{
  "chain": "ethereum",
  "chain_id": 1
}

Response (allowed):

{
  "allowed": true
}

Response (blocked):

{
  "allowed": false,
  "reason": "Mainnet deployment requires a Pro plan.",
  "tier_required": "pro"
}

Register Deployment

POST /api/deploy/register

Registers a deployment for analytics. Called by the CLI after a successful deployment.

Request Body:

{
  "chain": "sepolia",
  "chain_id": 11155111,
  "address": "0x1234...abcd",
  "tx_hash": "0xabcd...1234",
  "template_id": "simple-erc20-token"
}

Response:

{
  "success": true
}