Verification Matrix

This page lists the commands that prove the Vela workspace is integrated.

Use the smallest reliable gate for daily work. Use the full gate before deployment, SDK publication, or investor/demo environments.

Gold Gates

Gate	Command	When
Protocol rollout gate	cd vela-protocol && bun run verify:rollout	Before protocol deploy
Deployed artifact gate	cd vela-protocol && bun run verify:deployed	After protocol deploy
SDK release gate	cd vela-sdk && bun run release:verify	Before SDK publish or consumer rollout
Docs build	cd vela-docs && bun run build	Before public docs deploy
Internal wiki build	cd internal-wiki && bun run build	Before wiki deploy
v1.9 Commerce release gate	cd vela-dashboard && bun run release:v19	Before any Commerce OS rollout

Protocol

cd /Users/laitsky/Developments/vela-labs/vela-protocol

bun run program-ids:check
bun run build:devnet-safe
bun run verify:rollout
bun run verify:deployed

Use verify:rollout before deploying and verify:deployed after deploying.

SDK

cd /Users/laitsky/Developments/vela-labs/vela-sdk

bunx markdownlint-cli2 README.md
bun run check
bun test
bun run test:protocol
bun run build
bun run smoke:package
bun run release:verify

release:verify is the publication gate. It includes typecheck, tests, protocol-backed tests, build, and package smoke.

Dashboard

Protocol rollout gate currently runs targeted worker tests:

cd /Users/laitsky/Developments/vela-labs/vela-dashboard

bun test \
  worker/src/routes/webhook.test.ts \
  worker/src/queue/webhook-fanout.test.ts \
  worker/src/queue/helius-webhook-upgrade-events.test.ts \
  worker/tests/stream-events.test.ts

Use broader dashboard checks when changing UI, auth, D1 schema, or API routes.

For Commerce OS, use the full local-only gate:

cd /Users/laitsky/Developments/vela-labs/vela-dashboard
bun run release:v19

This verifies fresh migrations and both Drizzle schemas, dashboard and Worker checks/builds, browser workflows, mocked RPC fixtures, local-validator SPL and Token-2022 flows, checkout bundle budgets, SDK tests/build, and webhook tests/build. It must not deploy or mutate remote resources.

Manual devnet acceptance must additionally prove an unrelated signature is rejected, the payer is derived, partial and remaining refunds reconcile, over-refunds fail, documents and exports open, webhook events reach the correct merchant, and auditor mutations return 403.

Webhook Package

cd /Users/laitsky/Developments/vela-labs/vela-webhook

bun run build
bun test

Must pass when event schemas or fixtures change.

Checkout

cd /Users/laitsky/Developments/vela-labs/vela-checkout

bun run check

Must pass when subscription transaction-building or checkout session payloads change.

Widget

cd /Users/laitsky/Developments/vela-labs/vela-widget

bun run typecheck

Must pass when browser-safe SDK exports, checkout transaction-building, or embedded flow messaging changes.

Portal

cd /Users/laitsky/Developments/vela-labs/vela-portal

bun run typecheck

Must pass when subscriber auth, cancellation, invoice rendering, or plan switching changes.

Admin

cd /Users/laitsky/Developments/vela-labs/vela-admin

bun run typecheck

Use admin tests when changing emergency controls, token config, audit writes, or protocol config deserialization.

Docs and Demo

cd /Users/laitsky/Developments/vela-labs/vela-docs
bun run build

cd /Users/laitsky/Developments/vela-labs/vela-demo
rm -rf /tmp/vela-demo-check
bun build server.ts --target bun --outdir /tmp/vela-demo-check

Docs build may surface route warnings that predate the current change. Do not ignore hard build failures.

Internal Wiki

cd /Users/laitsky/Developments/vela-labs/internal-wiki

bun run build

The wiki must build before it is treated as the current source of truth.

Full Multi-Token Rollout Verification

Use this when token semantics, plan creation, subscription, pulls, streams, or events change:

cd /Users/laitsky/Developments/vela-labs/vela-protocol

bun run verify:rollout
bun run verify:deployed

cd ../vela-sdk
bun run release:verify

cd ../vela-docs
bun run build

cd ../internal-wiki
bun run build

Then manually inspect:

• dashboard/webhook event path accepts empty token_symbol
• non-USDC events preserve mint
• checkout/widget choose wrapped-USDC vs Token-2022 subscribe path correctly
• docs/examples no longer imply periodic billing is USDC-only

Failure Triage

Failure	First action
Program ID mismatch	Stop. Check program keypairs and config/program-ids.json
IDL mismatch	Regenerate or copy IDLs, then rerun SDK tests
SDK typecheck failure	Fix SDK before touching runtime consumers
Webhook schema failure	Check event fixture and SDK event schema
Dashboard worker failure	Check queue/event processor and token symbol policy
Checkout/widget typecheck failure	Check browser-safe SDK exports and transaction builders
Deployed byte hash mismatch	Stop. Confirm local artifact and deployed program dump
Wiki/docs build failure	Fix navigation/frontmatter/link/content before relying on docs

Verification Log Template

# Verification Log

Date:
Operator:
Change:

## Commands

- [ ] command:
  - result:
  - notes:

## Manual Checks

## Known Warnings

## Decision

Ship / do not ship: