Security
TAP isn’t in production, and there’s no bug bounty or response-time commitment. Report vulnerabilities to security@palmer.earth, not in a public GitHub issue. Include the component, what you observed, and the impact. The full policy is in SECURITY.md.
Scope
In scope: the contracts in chain/src, the API and event poller in server/, the app in app/, and the workflows in .github/workflows.
Out of scope:
- Vendored contracts in
chain/liband theocf/submodule. Report those upstream. - Plume, browser wallets, and public RPC providers.
- The local Docker stack. Its database uses published development credentials, and the API doesn’t authenticate callers. A report is in scope when the same behavior would matter for a hosted API, a hosted app, or a deployed contract.
Before running this in production
- Don’t commit
.envfiles or private keys. - Keep the API and the database off the public internet. Anyone who can reach the API can make the server key sign transactions.
- Keep the factory owner’s key out of long-running servers, since it controls upgrades for every cap table on the factory. See Three wallets and keys.
What the contracts don’t enforce
The contracts don’t check that:
- a new stock class’s authorized shares fit within the issuer’s authorized shares,
- a stock class adjustment stays at or above the shares that class has issued,
- an issuer adjustment stays at or above every stock class’s authorized shares,
- the wallet passed to
removeWalletFromStakeholderbelongs to the stakeholder passed with it.
Check these before you send the transaction. The invariant tests pass because their handler keeps inputs within these limits; see Invariants.
Checks we run
- Pull requests to
mainrun the Node and Foundry jobs inci.yml. Both must pass, along with one approving review. Testing lists what each job runs. - Changes to Solidity files or
chain/foundry.tomlalso run the invariant suite insecurity.yml. That job isn’t required to merge. - Dependabot updates the pnpm lockfile and GitHub Actions, with security updates on. Secret scanning and push protection are on.
- The repository doesn’t run a Solidity static analyzer.
Run the tests locally
make test # every Solidity test, including the invariants
make test-invariant # invariants only, 256 runs at depth 50
make test-invariant-deep # invariants only, 2000 runs at depth 100Last updated on