Version: 0.1.0
Date: 01 April 2026
A growing toolset to help validate and utilize Open Cap Table Format datasets.
Currently, the toolset includes 3 tools:
This tool creates a workable JSON object of the content of an OCF folder from the path of the directory holding the OCF files.
const ocfPackage = readOcfPackage(ocfPackageFolderDir);This tool tests the logical and structural validity of an OCF package. We are continuing to build out the rules set for validity but have good coverage for stock transactions and basic validations for convertible, warrant, and equity compensation transactions. Other transactions, such as vesting transactions, are only checked for naming a security removed earlier, if at all.
const ocfValidation = ocfValidator(ocfPackageFolderDir);Validation goes through the transactions in date order and stops at the first one that fails. The tool outputs an object whose fields include:
result: stringsays whether the package appears valid, or what made the validation fail: usually the transaction that failed and why. It's the one field that says whether the package is valid. A valid package can still have warnings, and the result counts them: "…appears valid, with 1 warning."findingslists the problems found by the checks that report findings. Today those are the convertible, warrant, and equity compensation validators' checks, plus one run on every issuance and on the transactions nothing else validates, except a return to pool: that no earlier transaction removed the security. Each finding has aseverity("error"or"warning"), the id of thecheckthat produced it, amessage, and asubject: theobject_typeandidof the transaction it's about. An error fails its transaction; a warning doesn't.reportlists, for each stock transaction the tool validates, the checks it did and whether each passed. The stock validators haven't moved to findings yet; a stock issuance that reuses a removed security fails with a finding instead.snapshotsholds the cap table at the end of each day with transactions, up to the last day validated in full.
This tool allows the user to see the outstanding captable of a OCF package on a given date.
const snapshot = ocfSnapshot(ocfPackageFolderDir, ocfSnapshotDate);ocfSnapshot returns the validator's last snapshot on or before that date, or null if there isn't one. It doesn't report the validation's result or findings. If the validation failed, it returns the cap table as of the last day validated in full, even for a later date, without saying so. To get the cap table and the validation's outcome together, call ocfValidator and read snapshots, result, and findings from its output.
Download this repository and run npm i; npm run build; npm link;
In the project that you want to use ocf-tools, run npm link ocf-tools and add
const { readOcfPackage, ocfValidator, ocfSnapshot } = require("ocf-tools");
to the top of the file you want to use the ocf-tools in.