Contract repo layout & workflows

This page links to existing Catalyst contract repos and recommended workflows.

Canonical repos

• Identity contracts (Foundry): catalyst-identity-contracts
  Designed to be usable by wallets/nodes that can only read raw EVM storage (catalyst_getStorageAt).
• General contracts: catalyst-contracts (currently minimal; expect changes)

Recommended workflow (Foundry)

1. Write + test contracts:

forge test -vvv

2. Compile:

forge build

3. Deploy via Catalyst tooling (CTX2):

• Use the SDK deploy CLI (see Smart contracts → Deployment guide).

Verify

• Track deployments per chainId (store addresses in deployments/<chainId>.json, or similar).
• Always verify code exists via catalyst_getCode.