Skip to content

Release 2026 01 13 ocp v28 major upgrade

Cursor Agent edited this page Jun 22, 2026 · 4 revisions

Release: OCP v28 Major Upgrade

Historical — current source: OpenCapTable-v35; see Releases

Date: 2026-01-13 Author: NC Networks: devnet, mainnet

Summary

Major upgrade of the Open Cap Table Protocol from v27 to v28. This release changes the EditIssuer choice to return EditIssuerResult instead of ContractId CapTable for consistency with UpdateCapTableResult.

What's Being Deployed

Package Version Description
OpenCapTable-v28 0.0.1 EditIssuer now returns EditIssuerResult

Breaking Changes

  • EditIssuer return type changed: Now returns EditIssuerResult instead of ContractId CapTable
  • New data type: EditIssuerResult with updatedCapTableCid and editedIssuerCid fields
  • Requires new OCP Factory contract (existing v27 factories remain operational for legacy cap tables)

EditIssuerResult

data EditIssuerResult = EditIssuerResult with
    updatedCapTableCid: ContractId CapTable
    editedIssuerCid: ContractId Issuer

Pre-Deployment Checklist

  • npm install - Dependencies installed
  • npm run build - All DAML packages built successfully
  • npm run test - All tests passing
  • Upload OCP v28 DAR to devnet
  • Upload OCP v28 DAR to mainnet
  • Create new OCP Factory (v28) on devnet
  • Create new OCP Factory (v28) on mainnet
  • Verify factory contract IDs saved
  • Update dependent services with new template IDs

Deployment Commands

npm run build
npm run test
npm run upload-dar -- --package ocp --network devnet
npm run upload-dar -- --package ocp --network mainnet
npx tsx scripts/create-ocp-factory.ts --network devnet
npx tsx scripts/create-ocp-factory.ts --network mainnet
npm run verify-dars

Migration Notes

For SDK Consumers

Update code that calls EditIssuer to handle the new return type:

// Before (v27)
const capTableCid = await editIssuer(...)

// After (v28)
const result = await editIssuer(...)
const capTableCid = result.updatedCapTableCid
const issuerCid = result.editedIssuerCid

Generated: 2026-01-13

Clone this wiki locally