Transfer Agent Protocol (TAP) Cap Table

An onchain cap table implementation combining Solidity smart contracts with an off-chain Node.js API server. Implements the Open Cap Table Coalition (OCF) standard.

Read official docs at https://docs.transferagentprotocol.xyz.

Structure

This is a pnpm monorepo:

tap-cap-table/
├── app/        # Next.js frontend
├── server/     # Express API server
├── chain/      # Solidity smart contracts (Foundry)
├── docs/       # Nextra documentation site
└── ocf/        # OCF standard (git submodule)

Quick Start

pnpm install
pnpm setup
cp .env.example .env        # Edit with your keys (see below)
pnpm docker:up              # Start MongoDB, server, and app

This spins up three services via Docker: Server http://localhost:8293 App http://localhost:3000 MongoDB localhost:27017

Then go read official docs

Environment: Copy .env.example to .env and fill in PRIVATE_KEY, RPC_URL, CHAIN_ID, and the NEXT_PUBLIC_* variables for the frontend. For Plume Mainnet, set CHAIN_ID=98866 and RPC_URL=https://rpc.plume.org.

Scripts

# Docker (runs all services: MongoDB, server, app)
pnpm docker:up              # Start all services
pnpm docker:down            # Stop all services
pnpm docker:logs            # Stream logs
pnpm docker:build           # Rebuild and start

# Local development (hot-reload, run instead of Docker server/app)
pnpm dev                    # API server
pnpm app:dev                # Frontend
pnpm docs:dev               # Docs site

Development

For developers using Warp, see WARP.md for AI-assisted development guidance.

Contributing

We welcome all contributions. Please give a quick read to our CONTRIBUTING guidelines before submitting new PRs!

License

This project uses a multi-license structure:

• Core Protocol (chain/): BUSL-1.1 (converts to AGPLv3 on January 1, 2028)
• API Server (server/): AGPL-3.0
• Frontend (app/): Proprietary
• Documentation (docs/): MIT

For enterprise licensing inquiries, please contact the owner of this repo.