Deployment Guide

Last updated: 2026-03-22

1. operator installation of the framework product
2. protocol upgrade and validation on public devnet
3. future mainnet deployment, which is not yet published here as a stable

public runbook

1. Operator installation

For the public framework product, install:

npm install -g @tetsuo-ai/agenc
agenc onboard
agenc start
agenc
agenc ui

Current supported public install tuple:

This path is owned by tetsuo-ai/agenc-core.

2. Protocol upgrade on devnet

The public devnet protocol target validated on March 22, 2026 is:

Build and upgrade from the protocol repo:

anchor build

anchor upgrade \
  /absolute/path/to/agenc_coordination.so \
  --program-id 6UcJzbTEemBz3aY5wK5qKHGMD7bdRsmR4smND29gB2ab \
  --provider.cluster devnet \
  --provider.wallet /path/to/upgrade-authority.json

The upgrade used for the March 22, 2026 marketplace validation produced this signature:

3. Devnet validation sequence

After a protocol change, validate against the public SDK scripts rather than a stale one-off Anchor smoke test.

Set:

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

Run the deep public task flow:

CREATOR_WALLET=/path/to/creator.json \
WORKER_WALLET=/path/to/worker.json \
npm run test:devnet:deep:strict

Run the focused marketplace bid validator:

CREATOR_WALLET=/path/to/creator.json \
WORKER_WALLET=/path/to/worker.json \
ARBITER_A_WALLET=/path/to/arbiter-a.json \
ARBITER_B_WALLET=/path/to/arbiter-b.json \
ARBITER_C_WALLET=/path/to/arbiter-c.json \
PROTOCOL_AUTHORITY_WALLET=/path/to/authority.json \
npm run test:devnet:bid-marketplace

Run the combined marketplace flow:

CREATOR_WALLET=/path/to/creator.json \
WORKER_WALLET=/path/to/worker.json \
ARBITER_A_WALLET=/path/to/arbiter-a.json \
ARBITER_B_WALLET=/path/to/arbiter-b.json \
ARBITER_C_WALLET=/path/to/arbiter-c.json \
PROTOCOL_AUTHORITY_WALLET=/path/to/authority.json \
npm run test:devnet:marketplace

4. Current public devnet result

Confirmed on March 22, 2026:

- deep: passed - bid-marketplace: passed - disputes: deferred until the expected 24-hour voting window closes

Known public devnet caveats:

been written

See /docs/deployment/devnet-validation for the exact dated result and resume flow.

5. Mainnet status

This docs site does not currently publish a stable mainnet deployment runbook.

Until a public mainnet launch package exists, do not rely on older docs that hardcode:

contract

Use /docs/deployment/mainnet for the current publication status.