DevelopmentInstall

Install dependencies

You’ll need these installed to start building:

  • Docker — runs MongoDB and the API server locally
  • Foundry — compiles and deploys the Solidity contracts
curl -L https://foundry.paradigm.xyz | bash
  • Node.js — required to run the server and app
  • pnpm — the package manager used throughout this project
  • MongoDB Compass — optional GUI for inspecting the database during development

Verify the required tools before cloning:

docker --version
forge --version
node --version
pnpm --version

Pull the repo

git clone --recurse-submodules https://github.com/transfer-agent-protocol/tap-cap-table.git
cd tap-cap-table
pnpm install

Missing submodules: git submodule update --init --recursive.

Who deploys what?

ActorOnchain surface
Protocol builderShips contracts (BUSL). Owns the shared demo factory on Plume if you reuse it.
Transfer agentDeploys their own CapTableFactory — their book of business (many issuer tables).
Issuer / admin walletCalls createCapTable on a factory; becomes ADMIN of that issuer’s cap table.

Mongo’s factories collection is only a local mirror of which factory address this stack talks to. Registering a factory in Mongo does not grant onchain ownership.

Learn the structure

Everything you need for the onchain contracts lives under chain/.

      • CapTable.sol
      • CapTableFactory.sol

Next: Initial setup.

DevelopmentSetup