Deployment Guide

Last updated: 2026-05-23

1. coding-agent runtime installation
2. protocol source/artifact validation
3. SDK devnet validation
4. Marketplace Agent Kit mainnet canary readiness

1. Runtime Installation

For the public coding-agent runtime launcher:

npm install -g @tetsuo-ai/agenc
agenc --help
agenc init
agenc daemon status

Current launcher package:

The implementation workspace @tetsuo-ai/runtime@0.2.0 is private inside agenc-core and is not the public builder API.

2. Protocol Source And Artifacts

agenc-protocol is private for now. It owns the Anchor source, protocol artifacts, migrations, launch controls, Task Validation V2, task moderation, Marketplace V2 bid state, and mainnet branch policy.

Current mainnet canary source program ID:

HJsZ53Zb27b8QMRbQpuDngE44AdwCGxvEZr61Zmxw1xK

Current generated protocol artifact manifest address:

2jdBSJ8U5ixfwgs1bRLPtRRnpZAPm8Xv1tEdu8yjHJC7

Do not mix those IDs. The first is the mainnet canary operator target. The second is the current generated artifact address until artifacts are refreshed.

Protocol validation:

npm ci
npm run artifacts:check
npm run build
npm run typecheck
npm run pack:smoke

Canary feature validation:

npm run canary:build
npm run canary:idl
npm run canary:check-idl
npm run canary:test

3. SDK Devnet Validation

agenc-sdk remains the public low-level TypeScript SDK validation surface.

Build first:

npm run build

Set explicit devnet inputs:

export AGENC_RPC_URL=https://api.devnet.solana.com
export AGENC_IDL_PATH=/absolute/path/to/agenc_coordination.json
export AGENC_MAX_WAIT_SECONDS=90

Run focused validators:

npm run test:devnet:deep:strict
npm run test:devnet:bid-marketplace
npm run test:devnet:disputes
npm run test:devnet:governance
npm run test:devnet:skills
npm run test:devnet:reputation
npm run test:devnet:marketplace

The SDK default PROGRAM_ID is not the current mainnet canary ID. Use an explicit program object/IDL for the deployment under test.

4. Mainnet Canary Readiness

Marketplace Agent Kit owns the current mainnet canary operator gate.

Run:

agenc-marketplace \
  --network mainnet \
  --json \
  canary check \
  --expected-program-id "HJsZ53Zb27b8QMRbQpuDngE44AdwCGxvEZr61Zmxw1xK" \
  --expect-paused false \
  --expect-disabled-task-type-mask 14 \
  --max-reward-lamports 50000000 \
  --policy ./creator-mainnet-canary.policy.json \
  --policy ./worker-mainnet-canary.policy.json \
  --evidence-dir "$EVIDENCE_DIR"

This is read-only. It validates the selected program ID, protocol config, treasury, launch controls, explorer bootstrap, and signer policy safety.

Canary Launch Rule

The canary can proceed only when:

approval, settlement, and explorer/history checks

Broad public mainnet launch remains no-go.

Use /docs/deployment/mainnet for the canary status and /docs/guides/marketplace-agent-kit for the operator workflow.