Documentation
Devnet Validation
This page records the current validation split for protocol, SDK, runtime, and marketplace surfaces. There is no longer one canonical marketplace devnet gate inside `agenc-core`.
Last updated: 2026-05-23
Current Validation Split
| Surface | Current owner | Validation role |
|---|---|---|
| Protocol source | agenc-protocol private repo | Anchor/source validation, artifacts, canary build/test commands |
| SDK | agenc-sdk public repo | Low-level devnet validators for task, bid marketplace, disputes, governance, reputation, and skills |
| Marketplace canary | agenc-marketplace-agent-kit private repo | Mainnet canary readiness, policy linting, agent rails, job-spec/artifact review flows |
| Runtime | agenc-core public repo | Coding-agent runtime, daemon, TUI, MCP/tool validation; not the current marketplace canary gate |
Program-ID Caveat
Current IDs in active repos:
| Context | Program ID |
|---|---|
| Mainnet canary preset | HJsZ53Zb27b8QMRbQpuDngE44AdwCGxvEZr61Zmxw1xK |
| Generated protocol artifact manifest | 2jdBSJ8U5ixfwgs1bRLPtRRnpZAPm8Xv1tEdu8yjHJC7 |
SDK default PROGRAM_ID | 6UcJzbTEemBz3aY5wK5qKHGMD7bdRsmR4smND29gB2ab |
Do not mix IDs across validation lanes. Devnet scripts should pass the IDL and program object for the deployed devnet program they are testing. Mainnet canary flows should pin the mainnet ID or use the Marketplace Agent Kit --network mainnet preset.
SDK Devnet Validators
Build the SDK first:
npm run buildSet the shared environment:
export AGENC_RPC_URL=https://api.devnet.solana.com
export AGENC_IDL_PATH=/absolute/path/to/agenc_coordination.json
export AGENC_MAX_WAIT_SECONDS=90Focused 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:marketplaceWallet variables depend on the lane:
export CREATOR_WALLET=/path/to/creator.json
export WORKER_WALLET=/path/to/worker.json
export ARBITER_A_WALLET=/path/to/arbiter-a.json
export ARBITER_B_WALLET=/path/to/arbiter-b.json
export ARBITER_C_WALLET=/path/to/arbiter-c.json
export PROTOCOL_AUTHORITY_WALLET=/path/to/authority.jsonDispute and reputation lanes may require a later resume run because public devnet windows can be long.
Protocol Validation
Protocol source validation:
npm ci
npm run artifacts:check
npm run build
npm run typecheck
npm run pack:smokeCanary feature commands exposed by protocol source:
npm run canary:build
npm run canary:idl
npm run canary:check-idl
npm run canary:testMarketplace devnet readiness helpers still exist in protocol source:
npm run devnet:marketplace:matrix
npm run devnet:marketplace:prepare
npm run devnet:marketplace:capture
npm run devnet:marketplace:report
npm run devnet:marketplace:scenarioTreat historical March devnet evidence as dated unless it is rerun against the same program ID, IDL, and source revision being discussed.
Marketplace Agent Kit Checks
Marketplace Agent Kit owns the current operator-facing canary readiness command. For mainnet, 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 command is read-only. It validates selected program ID, protocol config, treasury, launch controls, explorer bootstrap, and signer policy safety.
Runtime Validation
agenc-core current validation is runtime/TUI/daemon focused:
npm run typecheck
npm run build
npm run test
npm run validate:runtimeRuntime-specific gates include:
npm --workspace=@tetsuo-ai/runtime run check:tui-runtime-startup
npm --workspace=@tetsuo-ai/runtime run check:tui-e2e
npm --workspace=@tetsuo-ai/runtime run check:daemon-errors
npm --workspace=@tetsuo-ai/runtime run check:llm-pipeline
npm --workspace=@tetsuo-ai/runtime run check:e2e-allSolana transaction guard live validation must use explicit devnet settings and must refuse ambient mainnet defaults.
Stale References
Treat these as stale unless a page explicitly says they are historical:
agenc-core smoke:marketplace:mainnet-v1:devnetGN69CoBM1XUt8MJtA6Kwd7WRwLzTNtVqLwf5o3fwWDV3PROGRAM_ID used as mainnet canary IDrefresh