ISCC - Crypto

iscc-crypto is the cryptographic signing and verification module for the ISCC (International Standard Content Code) Framework.

Features

• Ed25519 key generation and management
• JSON canonicalization and signing
• W3C Verifiable Credentials Data Integrity proofs
• Multibase and multikey support
• Cryptographic nonce generation with embedded node identifier
• Command-line interface for key generation and identity management
• Minimal external dependencies for core cryptographic operations

Installation

Use the package manager pip to install iscc-crypto:

pip install iscc-crypto

Quick Start

>>> import json
>>> import iscc_crypto as icr

>>> keypair = icr.key_from_secret("z3u2So9EAtuYVuxGog4F2ksFGws8YT7pBPs4xyRbv3NJgrNA")

>>> # Sign a JSON document
>>> doc = {"title": "My Document", "content": "Important data"}
>>> signed_doc = icr.sign_json(doc, keypair)

>>> # Show the signed document structure
>>> print(json.dumps(signed_doc, indent=2))
{
  "title": "My Document",
  "content": "Important data",
  "signature": {
    "version": "ISCC-SIG v1.0",
    "pubkey": "z6MkpFpVngrAUTSY6PagXa1x27qZqgdmmy3ZNWSBgyFSvBSx",
    "proof": "z5xCgXk6tGJTVcvrcvVok5XgLn5Mefo49ztwwW8QCmjoySH4ZEkri4XoY2JjiyaD7yD4Na7eoGPqmhPoeM2uvBmF8"
  }
}

>>> # Verify the signed document
>>> icr.verify_json(signed_doc)
VerificationResult(signature_valid=True, identity_verified=None, message=None)

Documentation

Documentation is published at https://crypto.iscc.codes

Development

Requirements

• Python 3.10 or higher
• UV for dependency management

Development Setup

git clone https://github.com/iscc/iscc-crypto.git
cd iscc-crypto
uv sync

Testing

Run the test suite:

uv run pytest

Maintainers

@titusz

Contributing

Pull requests are welcome. For significant changes, please open an issue first to discuss your plans. Please make sure to update tests as appropriate.

You may also want to join our developer chat on Telegram at https://t.me/iscc_dev.

License

iscc-crypto is licensed under the Apache License, Version 2.0