sdk/python/README.md

CFI Connector SDK (cfi-connector-sdk)

Standardized Bank Connector SDK for the Collaborative Fraud Intelligence (CFI) Network.

Installation

pip install cfi-connector-sdk

For local development and testing:

pip install -e .[dev]

Features & Adapters

• BaseTransactionAdapter: Standardized payment schema normalization (NormalizedTransaction).
• BaseFeatureAdapter: Rolling velocity feature calculations (1h count, 24h count, 24h sum).
• BaseEntityAdapter: Privacy-preserving HMAC-SHA256 customer identifier resolution and payload masking.
• LocalFLClient: gRPC mTLS communication, HSM payload signing, zlib compression, and DP gradient submission.
• ConnectorHealthMonitor: Operational health probes for message brokers and X.509 certificate validity.

Running Tests

cd sdk/python
pytest -v

Packaging & Building

python -m build
twine check dist/*