actproof 0.2.0__tar.gz → 0.3.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. {actproof-0.2.0 → actproof-0.3.2}/.gitignore +2 -0
  2. {actproof-0.2.0 → actproof-0.3.2}/CHANGELOG.md +107 -3
  3. actproof-0.3.2/DEPLOY.md +120 -0
  4. actproof-0.3.2/LICENSE +201 -0
  5. {actproof-0.2.0 → actproof-0.3.2}/PKG-INFO +97 -43
  6. {actproof-0.2.0 → actproof-0.3.2}/README.md +92 -18
  7. actproof-0.3.2/SECURITY.md +90 -0
  8. {actproof-0.2.0 → actproof-0.3.2}/actproof/__init__.py +2 -2
  9. {actproof-0.2.0 → actproof-0.3.2}/actproof/anchor.py +19 -2
  10. {actproof-0.2.0 → actproof-0.3.2}/actproof/canonical.py +1 -1
  11. {actproof-0.2.0 → actproof-0.3.2}/actproof/catalogue.py +1 -1
  12. {actproof-0.2.0 → actproof-0.3.2}/actproof/cli.py +1 -1
  13. {actproof-0.2.0 → actproof-0.3.2}/actproof/manifest.py +1 -1
  14. actproof-0.3.2/actproof/py.typed +0 -0
  15. {actproof-0.2.0 → actproof-0.3.2}/actproof/receipt.py +1 -1
  16. actproof-0.3.2/actproof/signers/__init__.py +139 -0
  17. {actproof-0.2.0 → actproof-0.3.2}/actproof/signers/google_kms.py +290 -107
  18. actproof-0.3.2/actproof/signers/interface.py +613 -0
  19. {actproof-0.2.0 → actproof-0.3.2}/actproof/signers/mnemonic.py +88 -36
  20. {actproof-0.2.0 → actproof-0.3.2}/actproof/timestamp.py +1 -1
  21. {actproof-0.2.0 → actproof-0.3.2}/actproof/verify.py +1 -1
  22. actproof-0.3.2/docs/ANCHOR_BACKENDS.md +129 -0
  23. actproof-0.3.2/docs/INTEGRATION.md +131 -0
  24. {actproof-0.2.0 → actproof-0.3.2}/docs/STS-STANDARDS-APPLICATION.md +2 -2
  25. {actproof-0.2.0 → actproof-0.3.2}/pyproject.toml +15 -6
  26. {actproof-0.2.0 → actproof-0.3.2}/tests/__init__.py +1 -1
  27. {actproof-0.2.0 → actproof-0.3.2}/tests/test_anchor.py +49 -1
  28. {actproof-0.2.0 → actproof-0.3.2}/tests/test_canonical.py +1 -1
  29. {actproof-0.2.0 → actproof-0.3.2}/tests/test_catalogue.py +1 -1
  30. {actproof-0.2.0 → actproof-0.3.2}/tests/test_catalogue_v3.py +1 -1
  31. {actproof-0.2.0 → actproof-0.3.2}/tests/test_cli.py +1 -1
  32. {actproof-0.2.0 → actproof-0.3.2}/tests/test_manifest.py +1 -1
  33. {actproof-0.2.0 → actproof-0.3.2}/tests/test_receipt.py +1 -1
  34. {actproof-0.2.0 → actproof-0.3.2}/tests/test_signers_google_kms.py +12 -2
  35. {actproof-0.2.0 → actproof-0.3.2}/tests/test_signers_interface.py +5 -2
  36. {actproof-0.2.0 → actproof-0.3.2}/tests/test_signers_mnemonic.py +1 -1
  37. actproof-0.3.2/tests/test_signers_v030_policy.py +833 -0
  38. {actproof-0.2.0 → actproof-0.3.2}/tests/test_timestamp.py +1 -1
  39. {actproof-0.2.0 → actproof-0.3.2}/tests/test_verify.py +1 -1
  40. actproof-0.2.0/LICENSE +0 -21
  41. actproof-0.2.0/actproof/signers/__init__.py +0 -89
  42. actproof-0.2.0/actproof/signers/interface.py +0 -298
@@ -108,3 +108,5 @@ local_config.py
108
108
  scratch/
109
109
  # Local test receipts (these should be in tests/fixtures/ if intended to persist)
110
110
  *.receipt.local.json
111
+ actproof-v*.zip
112
+ APPLY_v*.md
@@ -12,18 +12,122 @@ release. Once 1.0.0 ships, semantic versioning will be strictly followed.
12
12
 
13
13
  ### Planned
14
14
 
15
- - **v0.2.0** — `docs/` complete with three worked examples (NIS2 / EUDR / software release), GitHub Action wrapper `release-anchor.yml`, EU Trusted List chain validation for RFC 3161 tokens, stricter verifier semantics (PARTIAL state distinct from PASS), disclosure CLI subcommands (`actproof verify-disclosure`, `actproof issue-disclosure`).
16
- - **v0.3.0** — Cross-implementation conformance test suite landing.
15
+ - **v0.4.0** — Pluggable anchor backend architecture. Generalize the chain-agnostic substrate (canonicalization, RFC 3161 timestamps, receipt format, verifier) into an `AnchorBackend` protocol with chain-specific implementations (Hedera Consensus Service, Stellar memo-hash, Bitcoin OP_RETURN, Ethereum). See `docs/ANCHOR_BACKENDS.md` for the design intent.
17
16
  - **v1.0.0** — API frozen.
18
17
  - **v2.0.0** — COSE_Sign1 + SCITT Transparent Statement bridge, once RFC 9943 publishes.
19
18
 
19
+ ## [0.3.2] — 2026-05-19
20
+
21
+ **License switch from MIT to Apache-2.0.** Forward-looking positioning of
22
+ actproof-py as verification infrastructure rather than a small utility
23
+ library: Apache-2.0 provides an explicit patent grant suitable for
24
+ standards-facing work and institutional adoption, while remaining as
25
+ permissive as MIT for commercial and proprietary embedding.
26
+
27
+ ### Changed
28
+
29
+ - **LICENSE file replaced** with the canonical Apache License 2.0 text.
30
+ - **`pyproject.toml`** updated: license expression now `"Apache-2.0"`
31
+ with `license-files = ["LICENSE"]` per the modern Python packaging
32
+ guidance. Classifier updated to `License :: OSI Approved :: Apache
33
+ Software License`.
34
+ - **SPDX headers** in all 27 source files (`actproof/*.py`,
35
+ `actproof/signers/*.py`, `tests/*.py`) changed from
36
+ `SPDX-License-Identifier: MIT` to `SPDX-License-Identifier: Apache-2.0`.
37
+ - **README, DEPLOY, and STS standards documentation** updated to state
38
+ Apache-2.0 throughout.
39
+
40
+ ### Notes
41
+
42
+ - Existing users on v0.3.1 (MIT) retain MIT rights for that release.
43
+ All v0.3.2 and later releases are governed by Apache-2.0.
44
+ - Copyright remains "2026 Deyan Paroushev." No change to authorship or
45
+ contributor structure.
46
+ - No API changes, no behavioural changes, no dependency changes. This is
47
+ a pure licensing release.
48
+
49
+ ## [0.3.1] — 2026-05-19
50
+
51
+ **Packaging hotfix.** Resolves an internal contradiction in v0.3.0's
52
+ dependency declaration that prevented installation in modern pip
53
+ environments.
54
+
55
+ ### Fixed
56
+
57
+ - **`cryptography` lower bound relaxed from `>=42.0` to `>=41.0`.** v0.3.0
58
+ declared both `tsp-client>=0.2.1,<0.3` and `cryptography>=42.0`, but
59
+ `tsp-client==0.2.1` (the only version in that range) transitively
60
+ requires `pyOpenSSL<24`, which in turn requires `cryptography<42`. The
61
+ two constraints could not be satisfied simultaneously by a strict pip
62
+ resolver, making v0.3.0 uninstallable in fresh environments. The
63
+ actual cryptography API surface used by
64
+ `actproof.signers.google_kms._extract_raw_ed25519_from_pem`
65
+ (`Ed25519PublicKey`, `load_pem_public_key`, `Encoding.Raw`,
66
+ `PublicFormat.Raw`) has been available since cryptography 2.6, so the
67
+ `>=42` floor was conservative rather than technical.
68
+
69
+ ### Notes
70
+
71
+ - The upper bound `<46.0` is unchanged.
72
+ - v0.4.0 will replace `tsp-client` with `rfc3161-client`, removing the
73
+ legacy `pyOpenSSL` cap entirely. The cryptography floor can then move
74
+ forward in step with modern releases.
75
+
76
+ ## [0.3.0] — 2026-05-17
77
+
78
+ **Security hardening release.** Closes a transaction-validation gap present in v0.2.0. See `SECURITY.md` for the advisory.
79
+
80
+ ### Security
81
+
82
+ - **`AlgorandSigner.validate_transaction` now rejects attack-vector fields unconditionally.** `rekey_to`, `close_remainder_to`, `group`, and `lease` are rejected on every transaction. v0.2.0 accepted these fields if the sender, receiver, amount, and note prefix passed validation; a `rekey_to=attacker` payment was therefore accepted as a benign-looking 0-ALGO self-payment. This is the same attack class that drained roughly 3.3 million USD across 25 accounts in the February 2023 MyAlgo wallet incident.
83
+ - **Transaction type restricted to `PaymentTxn`.** v0.2.0 accepted any `algosdk.transaction.Transaction` subclass. v0.3.0 rejects `AssetTransferTxn`, `ApplicationCallTxn`, `KeyregTxn`, and any other non-payment type.
84
+ - **Fee bounded and forced flat.** `txn.fee` must lie in `[ALGORAND_MIN_FEE_MICROALGOS, max_fee_microalgos]` (default 1000 microALGOs). `build_transaction` now forces `flat_fee=True` and `fee=1000` on the copy of `SuggestedParams` it passes to `PaymentTxn`, so per-byte fee rates returned by algod under congestion do not produce a transaction the signer would reject.
85
+ - **Note size bounded.** New constant `ALGORAND_MAX_NOTE_BYTES = 1024` enforced explicitly by the signer before any KMS call.
86
+ - **`GoogleKMSSigner`: fail-closed end-to-end integrity verification.** Every KMS call now requires `response.name == request.name`, `response.verified_data_crc32c is True`, `crc32c(signature) == response.signature_crc32c`, and `len(signature) == 64`. Same pattern for `get_public_key` (`response.name`, `pem_crc32c`). v0.2.0 used `hasattr(...)` guards that silently bypassed missing fields; v0.3.0 raises `RuntimeError` if any required field is missing or invalid. Implementation follows Google's recommended pattern documented at `cloud.google.com/kms/docs/data-integrity-guidelines`.
87
+ - **`_assemble_signed_transaction` validates signature length.** Refuses to wrap a non-64-byte signature into a `SignedTransaction` (Ed25519 signatures are always 64 octets per RFC 8032).
88
+ - **Release workflow now runs the test suite before publishing.** `.github/workflows/release.yml` adds a pytest gate plus wheel smoke-test job that the publish job depends on. A failing test now blocks the PyPI upload.
89
+
90
+ ### Changed
91
+
92
+ - **`AlgorandSigner.__init__` accepts `allowed_note_prefixes` and `max_fee_microalgos` only.** The earlier v0.3.0 draft had also exposed `require_self_payment` and `require_zero_amount` as configurable booleans; these were removed because disabling them turned the signer into a general-purpose Algorand signing adapter, broader than its stated scope. The strict 0-ALGO self-payment shape is now a non-configurable invariant.
93
+ - **`allowed_note_prefixes` accepts a single `bytes` value.** Passing `allowed_note_prefixes=b"quoruna/v1:"` now works without wrapping in a list. The constructor also raises a clearer `TypeError` when a non-bytes element is found.
94
+ - **`__init_subclass__` walks the full MRO.** Forbidden method names inherited via mixin (`class BadSigner(RawSigningMixin, AlgorandSigner)`) are now caught at class-definition time, not only methods defined directly on the subclass.
95
+ - **`validate_transaction` fails closed on missing `super().__init__()`.** Earlier drafts silently set defaults if a subclass forgot to call the base init. v0.3.0 raises `RuntimeError` listing every missing policy attribute.
96
+ - **GCP KMS protection level wording.** Module and class docstrings no longer claim "HSM-backed" unconditionally. The signer accepts keys with any protection level (`SOFTWARE`, `HSM`, `HSM_SINGLE_TENANT`, `EXTERNAL`); operators who need HSM-residency guarantees should create the key version accordingly.
97
+ - **`GoogleKMSSigner` without `[gcp]` deps.** Previously `actproof.signers.GoogleKMSSigner` was set to `None` if the GCP optional dependencies were missing, producing a confusing `TypeError: 'NoneType' object is not callable` on instantiation. v0.3.0 substitutes a stub subclass that raises a clear `RuntimeError` with the install command.
98
+ - **`tsp-client` dependency loosened to `>=0.2.1,<0.3`.** Downstream applications that pull a slightly newer compatible patch release are no longer blocked by the exact-pin requirement.
99
+
100
+ ### Added
101
+
102
+ - `ALGORAND_MIN_FEE_MICROALGOS`, `ALGORAND_DEFAULT_MAX_FEE_MICROALGOS`, `ALGORAND_MAX_NOTE_BYTES` constants on `actproof.signers.interface`.
103
+ - New test module `tests/test_signers_v030_policy.py` with 52 tests covering the rejection paths above plus KMS response-verification fail-closed semantics. Includes a cryptographic-equivalence regression test that confirms v0.3.0 produces byte-identical signatures to v0.2.0 for the original strict-policy use case.
104
+ - Two new tests in `tests/test_anchor.py` for `build_transaction`: confirms the resulting transaction carries `fee=1000` regardless of caller-supplied fee rate, and confirms the caller's `SuggestedParams` object is not mutated.
105
+ - `SECURITY.md` documenting the v0.2.0 gap, the v0.3.0 fix, and the threat model. Now included in the sdist.
106
+ - `docs/ANCHOR_BACKENDS.md` design note for v0.4.0 multi-chain anchor abstraction.
107
+ - `docs/INTEGRATION.md` integration guide for downstream applications consuming actproof.
108
+ - `actproof/py.typed` PEP 561 marker so downstream type-checkers honor inline annotations.
109
+
110
+ ### Migration from v0.2.0
111
+
112
+ Existing callers using the strict actproof policy (default constructors, anchoring with `actproof:j{...}` notes, 0-ALGO self-payments, fee 1000) see no behavioural change: the signed bytes are byte-identical. Previously-accepted transactions carrying `rekey_to`, `close_remainder_to`, `group`, `lease`, fees above 1000 microALGOs, or notes longer than 1024 bytes are now rejected with `SignerValidationError`. Audit your transaction-construction code to confirm none of these fields should have been set; for a higher `fee` ceiling during network congestion, pass `max_fee_microalgos=<n>` to the signer constructor.
113
+
114
+ Callers of any earlier v0.3.0 draft that used `require_self_payment=False` or `require_zero_amount=False` need to refactor: those kwargs were removed. If you need to sign other transaction shapes, write your own `AlgorandSigner` subclass and override `validate_transaction`.
115
+
116
+ ### Acknowledgements
117
+
118
+ Independent review by ChatGPT (May 2026, three review rounds) flagged the original `rekey_to`/`close_remainder_to` gap, the KMS integrity-check weakening, the MRO walk gap, the configurable-policy footgun, the test-gating mistake, the flat-fee deployment issue, the release-workflow missing test gate, and seven additional release-quality items. All findings are addressed in this release.
119
+
20
120
  ## [0.2.0] — 2026-05-17
21
121
 
122
+ Version bump for the initial PyPI publication path. See [0.1.0] notes below for the substrate API description; v0.2.0 was the version that actually shipped to PyPI (the 0.1.0 slot was skipped per immutable-release policy).
123
+
124
+ ## [0.1.0] — 2026-05-17
125
+
22
126
  **First PyPI release of `actproof`.** This is the inaugural published version of the substrate library under its canonical name. The library is installable via `pip install actproof`.
23
127
 
24
128
  ### Project history
25
129
 
26
- The code in this release was developed under the working name `openproof` on GitHub. The repository at `github.com/deyan-paroushev/openproof-py` was renamed to `github.com/deyan-paroushev/actproof-py` on 2026-05-17; the old URL auto-redirects to the new one. GitHub tags `v0.1.0` (initial public-API surface) and `v0.1.1` (additive schema v3 support) under the previous repository name are the development history of this code; this `v0.2.0` on PyPI is the first published release under the canonical name and supersedes both working-name tags.
130
+ The code in this release was developed under the working name `openproof` on GitHub. The repository at `github.com/deyan-paroushev/openproof-py` was renamed to `github.com/deyan-paroushev/actproof-py` on 2026-05-17; the old URL auto-redirects to the new one. GitHub tags `v0.1.0` (initial public-API surface) and `v0.1.1` (additive schema v3 support) under the previous repository name are the development history of this code; this `v0.1.0` on PyPI is the first published release under the canonical name and supersedes both working-name tags.
27
131
 
28
132
  The PyPI namespace under `openproof` is unrelated to this project.
29
133
 
@@ -0,0 +1,120 @@
1
+ # Deployment
2
+
3
+ This is the actproof-py v0.1.0 source tree, ready to push to
4
+ `github.com/deyan-paroushev/actproof-py`.
5
+
6
+ ## What's inside
7
+
8
+ ```
9
+ actproof-py/
10
+ ├── README.md Project README
11
+ ├── CHANGELOG.md Full v0.0.1 → v0.1.0 history
12
+ ├── LICENSE Apache-2.0
13
+ ├── DEPLOY.md This file
14
+ ├── pyproject.toml Hatchling build, dependencies pinned
15
+ ├── .gitignore
16
+ ├── actproof/ Library source (~3,500 lines, 10 modules)
17
+ │ ├── __init__.py
18
+ │ ├── canonical.py RFC 8785 JCS, strict-mode discipline
19
+ │ ├── manifest.py Manifest envelope (issuer/claim/evidence/recipients)
20
+ │ ├── catalogue.py actproof-events loader + validator
21
+ │ ├── receipt.py Public Receipt + private IssuerEvidence
22
+ │ ├── timestamp.py RFC 3161 with QTSP failover chain
23
+ │ ├── anchor.py ARC-2 disclosed-mode notes on Algorand
24
+ │ ├── signers/ AlgorandSigner ABC + Mnemonic + GoogleKMS
25
+ │ ├── verify.py Six-check end-to-end verification
26
+ │ └── cli.py Click-based CLI (anchor / verify / validate)
27
+ ├── tests/ 11 test files, 443 tests, all passing
28
+ │ └── ...
29
+ └── docs/
30
+ └── STS-STANDARDS-APPLICATION.md Maintainer application narrative
31
+ ```
32
+
33
+ ## First push to GitHub
34
+
35
+ ```bash
36
+ cd actproof-py
37
+
38
+ git init
39
+ git add -A
40
+ git commit -m "Initial release: actproof-py v0.1.0
41
+
42
+ Library and CLI for anchoring signed JSON manifests to Algorand mainnet
43
+ with RFC 3161 qualified timestamps, plus an independent verifier for
44
+ anyone's anchored receipts.
45
+
46
+ 10 modules, 443 passing tests, Apache-2.0 licensed.
47
+
48
+ Implements RFC 8785 JCS, RFC 3161 TSP, Algorand ARC-2 disclosed-mode
49
+ notes, and tracks draft-ietf-scitt-architecture for the v2 COSE_Sign1
50
+ bridge once RFC 9943 publishes."
51
+
52
+ git branch -M main
53
+ git remote add origin git@github.com:deyan-paroushev/actproof-py.git
54
+ git push -u origin main
55
+
56
+ git tag -a v0.1.0 -m "v0.1.0: first usable release"
57
+ git push origin v0.1.0
58
+ ```
59
+
60
+ ## Local verification
61
+
62
+ ```bash
63
+ python -m venv .venv
64
+ . .venv/bin/activate
65
+ pip install -e ".[dev,gcp]"
66
+
67
+ # Sanity checks
68
+ actproof --version # actproof, version 0.1.0
69
+ python -c "import actproof; print(actproof.__version__)"
70
+
71
+ # Full test suite — expect 443 passed (with ACTPROOF_EVENTS_ROOT set, see Notes below)
72
+ ACTPROOF_EVENTS_ROOT=/path/to/actproof-events python -m pytest tests/ -q
73
+
74
+ # CLI help
75
+ actproof --help
76
+ actproof anchor --help
77
+ actproof verify --help
78
+ actproof validate --help
79
+ ```
80
+
81
+ ## Notes for the catalogue
82
+
83
+ Several tests and the `actproof validate` command need the
84
+ actproof-events catalogue to be present somewhere resolvable.
85
+
86
+ The library (CLI flag, env var, error):
87
+
88
+ 1. The `--catalogue` CLI flag (a path to the `acts/` directory)
89
+ 2. The `ACTPROOF_CATALOGUE_PATH` environment variable
90
+ 3. Otherwise raises `CatalogueLoadError`
91
+
92
+ The test suite (env var, sibling repo, skip):
93
+
94
+ 1. The `ACTPROOF_EVENTS_ROOT` environment variable (a path to the
95
+ actproof-events repo root, not the `acts/` directory)
96
+ 2. Falls back to `../actproof-events` as a sibling of this repo
97
+ 3. Tests that need the real catalogue skip cleanly if neither is
98
+ available; tests using synthetic `tmp_path` catalogues run regardless
99
+
100
+ For local development against `github.com/deyan-paroushev/actproof-events`:
101
+
102
+ ```bash
103
+ # Clone as a sibling of this repo
104
+ git clone https://github.com/deyan-paroushev/actproof-events.git ../actproof-events
105
+
106
+ # Or set the env vars explicitly
107
+ export ACTPROOF_EVENTS_ROOT=/path/to/actproof-events # tests
108
+ export ACTPROOF_CATALOGUE_PATH=$ACTPROOF_EVENTS_ROOT/catalogue/acts # library/CLI
109
+ ```
110
+
111
+ ## STS Standards Network application
112
+
113
+ The maintainer's statement of practice is at
114
+ `docs/STS-STANDARDS-APPLICATION.md`. It is written against the four
115
+ sections of the Sovereign Tech Standards Network application form
116
+ (maintainer profile, standards relation, twelve-month plan, track
117
+ record) plus a conflicts-and-disclosures appendix.
118
+
119
+ It is structured to be read by the application reviewer; nothing in it
120
+ is load-bearing for the library itself.
actproof-0.3.2/LICENSE ADDED
@@ -0,0 +1,201 @@
1
+ Apache License
2
+ Version 2.0, January 2004
3
+ http://www.apache.org/licenses/
4
+
5
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6
+
7
+ 1. Definitions.
8
+
9
+ "License" shall mean the terms and conditions for use, reproduction,
10
+ and distribution as defined by Sections 1 through 9 of this document.
11
+
12
+ "Licensor" shall mean the copyright owner or entity authorized by
13
+ the copyright owner that is granting the License.
14
+
15
+ "Legal Entity" shall mean the union of the acting entity and all
16
+ other entities that control, are controlled by, or are under common
17
+ control with that entity. For the purposes of this definition,
18
+ "control" means (i) the power, direct or indirect, to cause the
19
+ direction or management of such entity, whether by contract or
20
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
21
+ outstanding shares, or (iii) beneficial ownership of such entity.
22
+
23
+ "You" (or "Your") shall mean an individual or Legal Entity
24
+ exercising permissions granted by this License.
25
+
26
+ "Source" form shall mean the preferred form for making modifications,
27
+ including but not limited to software source code, documentation
28
+ source, and configuration files.
29
+
30
+ "Object" form shall mean any form resulting from mechanical
31
+ transformation or translation of a Source form, including but
32
+ not limited to compiled object code, generated documentation,
33
+ and conversions to other media types.
34
+
35
+ "Work" shall mean the work of authorship, whether in Source or
36
+ Object form, made available under the License, as indicated by a
37
+ copyright notice that is included in or attached to the work
38
+ (an example is provided in the Appendix below).
39
+
40
+ "Derivative Works" shall mean any work, whether in Source or Object
41
+ form, that is based on (or derived from) the Work and for which the
42
+ editorial revisions, annotations, elaborations, or other modifications
43
+ represent, as a whole, an original work of authorship. For the purposes
44
+ of this License, Derivative Works shall not include works that remain
45
+ separable from, or merely link (or bind by name) to the interfaces of,
46
+ the Work and Derivative Works thereof.
47
+
48
+ "Contribution" shall mean any work of authorship, including
49
+ the original version of the Work and any modifications or additions
50
+ to that Work or Derivative Works thereof, that is intentionally
51
+ submitted to Licensor for inclusion in the Work by the copyright owner
52
+ or by an individual or Legal Entity authorized to submit on behalf of
53
+ the copyright owner. For the purposes of this definition, "submitted"
54
+ means any form of electronic, verbal, or written communication sent
55
+ to the Licensor or its representatives, including but not limited to
56
+ communication on electronic mailing lists, source code control systems,
57
+ and issue tracking systems that are managed by, or on behalf of, the
58
+ Licensor for the purpose of discussing and improving the Work, but
59
+ excluding communication that is conspicuously marked or otherwise
60
+ designated in writing by the copyright owner as "Not a Contribution."
61
+
62
+ "Contributor" shall mean Licensor and any individual or Legal Entity
63
+ on behalf of whom a Contribution has been received by Licensor and
64
+ subsequently incorporated within the Work.
65
+
66
+ 2. Grant of Copyright License. Subject to the terms and conditions of
67
+ this License, each Contributor hereby grants to You a perpetual,
68
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69
+ copyright license to reproduce, prepare Derivative Works of,
70
+ publicly display, publicly perform, sublicense, and distribute the
71
+ Work and such Derivative Works in Source or Object form.
72
+
73
+ 3. Grant of Patent License. Subject to the terms and conditions of
74
+ this License, each Contributor hereby grants to You a perpetual,
75
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76
+ (except as stated in this section) patent license to make, have made,
77
+ use, offer to sell, sell, import, and otherwise transfer the Work,
78
+ where such license applies only to those patent claims licensable
79
+ by such Contributor that are necessarily infringed by their
80
+ Contribution(s) alone or by combination of their Contribution(s)
81
+ with the Work to which such Contribution(s) was submitted. If You
82
+ institute patent litigation against any entity (including a
83
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
84
+ or a Contribution incorporated within the Work constitutes direct
85
+ or contributory patent infringement, then any patent licenses
86
+ granted to You under this License for that Work shall terminate
87
+ as of the date such litigation is filed.
88
+
89
+ 4. Redistribution. You may reproduce and distribute copies of the
90
+ Work or Derivative Works thereof in any medium, with or without
91
+ modifications, and in Source or Object form, provided that You
92
+ meet the following conditions:
93
+
94
+ (a) You must give any other recipients of the Work or
95
+ Derivative Works a copy of this License; and
96
+
97
+ (b) You must cause any modified files to carry prominent notices
98
+ stating that You changed the files; and
99
+
100
+ (c) You must retain, in the Source form of any Derivative Works
101
+ that You distribute, all copyright, patent, trademark, and
102
+ attribution notices from the Source form of the Work,
103
+ excluding those notices that do not pertain to any part of
104
+ the Derivative Works; and
105
+
106
+ (d) If the Work includes a "NOTICE" text file as part of its
107
+ distribution, then any Derivative Works that You distribute must
108
+ include a readable copy of the attribution notices contained
109
+ within such NOTICE file, excluding those notices that do not
110
+ pertain to any part of the Derivative Works, in at least one
111
+ of the following places: within a NOTICE text file distributed
112
+ as part of the Derivative Works; within the Source form or
113
+ documentation, if provided along with the Derivative Works; or,
114
+ within a display generated by the Derivative Works, if and
115
+ wherever such third-party notices normally appear. The contents
116
+ of the NOTICE file are for informational purposes only and
117
+ do not modify the License. You may add Your own attribution
118
+ notices within Derivative Works that You distribute, alongside
119
+ or as an addendum to the NOTICE text from the Work, provided
120
+ that such additional attribution notices cannot be construed
121
+ as modifying the License.
122
+
123
+ You may add Your own copyright statement to Your modifications and
124
+ may provide additional or different license terms and conditions
125
+ for use, reproduction, or distribution of Your modifications, or
126
+ for any such Derivative Works as a whole, provided Your use,
127
+ reproduction, and distribution of the Work otherwise complies with
128
+ the conditions stated in this License.
129
+
130
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
131
+ any Contribution intentionally submitted for inclusion in the Work
132
+ by You to the Licensor shall be under the terms and conditions of
133
+ this License, without any additional terms or conditions.
134
+ Notwithstanding the above, nothing herein shall supersede or modify
135
+ the terms of any separate license agreement you may have executed
136
+ with Licensor regarding such Contributions.
137
+
138
+ 6. Trademarks. This License does not grant permission to use the trade
139
+ names, trademarks, service marks, or product names of the Licensor,
140
+ except as required for describing the origin of the Work and
141
+ reproducing the content of the NOTICE file.
142
+
143
+ 7. Disclaimer of Warranty. Unless required by applicable law or
144
+ agreed to in writing, Licensor provides the Work (and each
145
+ Contributor provides its Contributions) on an "AS IS" BASIS,
146
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147
+ implied, including, without limitation, any warranties or conditions
148
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149
+ PARTICULAR PURPOSE. You are solely responsible for determining the
150
+ appropriateness of using or redistributing the Work and assume any
151
+ risks associated with Your exercise of permissions under this License.
152
+
153
+ 8. Limitation of Liability. In no event and under no legal theory,
154
+ whether in tort (including negligence), contract, or otherwise,
155
+ unless required by applicable law (such as deliberate and grossly
156
+ negligent acts) or agreed to in writing, shall any Contributor be
157
+ liable to You for damages, including any direct, indirect, special,
158
+ incidental, or consequential damages of any character arising as a
159
+ result of this License or out of the use or inability to use the
160
+ Work (including but not limited to damages for loss of goodwill,
161
+ work stoppage, computer failure or malfunction, or any and all
162
+ other commercial damages or losses), even if such Contributor
163
+ has been advised of the possibility of such damages.
164
+
165
+ 9. Accepting Warranty or Support. While redistributing the Work or
166
+ Derivative Works thereof, You may choose to offer, and charge a
167
+ fee for, acceptance of support, warranty, indemnity, or other
168
+ liability obligations and/or rights consistent with this License.
169
+ However, in accepting such obligations, You may act only on Your
170
+ own behalf and on Your sole responsibility, not on behalf of any
171
+ other Contributor, and only if You agree to indemnify, defend,
172
+ and hold each Contributor harmless for any liability incurred by,
173
+ or claims asserted against, such Contributor by reason of your
174
+ accepting any such warranty or support.
175
+
176
+ END OF TERMS AND CONDITIONS
177
+
178
+ APPENDIX: How to apply the Apache License to your work.
179
+
180
+ To apply the Apache License to your work, attach the following
181
+ boilerplate notice, with the fields enclosed by brackets "[]"
182
+ replaced with your own identifying information. (Don't include
183
+ the brackets!) The text should be enclosed in the appropriate
184
+ comment syntax for the file format. We also recommend that a
185
+ file or class name and description of purpose be included on the
186
+ same "printed page" as the copyright notice for easier
187
+ identification within third-party archives.
188
+
189
+ Copyright 2026 Deyan Paroushev
190
+
191
+ Licensed under the Apache License, Version 2.0 (the "License");
192
+ you may not use this file except in compliance with the License.
193
+ You may obtain a copy of the License at
194
+
195
+ http://www.apache.org/licenses/LICENSE-2.0
196
+
197
+ Unless required by applicable law or agreed to in writing, software
198
+ distributed under the License is distributed on an "AS IS" BASIS,
199
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200
+ See the License for the specific language governing permissions and
201
+ limitations under the License.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: actproof
3
- Version: 0.2.0
3
+ Version: 0.3.2
4
4
  Summary: Verifiable receipts of regulated acts. Canonical JSON (RFC 8785), RFC 3161 trusted timestamps, Algorand ARC-2 anchoring, independent verification.
5
5
  Project-URL: Homepage, https://github.com/deyan-paroushev/actproof-py
6
6
  Project-URL: Documentation, https://github.com/deyan-paroushev/actproof-py/tree/main/docs
@@ -11,34 +11,14 @@ Project-URL: Security, https://github.com/deyan-paroushev/actproof-py/blob/main/
11
11
  Project-URL: Catalogue, https://github.com/deyan-paroushev/actproof-events
12
12
  Author-email: Deyan Paroushev <deyan@advisa.tech>
13
13
  Maintainer-email: Deyan Paroushev <deyan@advisa.tech>
14
- License: MIT License
15
-
16
- Copyright (c) 2026 Deyan Paroushev
17
-
18
- Permission is hereby granted, free of charge, to any person obtaining a copy
19
- of this software and associated documentation files (the "Software"), to deal
20
- in the Software without restriction, including without limitation the rights
21
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
22
- copies of the Software, and to permit persons to whom the Software is
23
- furnished to do so, subject to the following conditions:
24
-
25
- The above copyright notice and this permission notice shall be included in all
26
- copies or substantial portions of the Software.
27
-
28
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
29
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
30
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
31
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
32
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
33
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
34
- SOFTWARE.
14
+ License-Expression: Apache-2.0
35
15
  License-File: LICENSE
36
16
  Keywords: algorand,attestation,canonical-json,compliance,evidence,governance,receipts,rfc-3161,rfc-8785,scitt,timestamping,transparency,verification
37
17
  Classifier: Development Status :: 3 - Alpha
38
18
  Classifier: Intended Audience :: Developers
39
19
  Classifier: Intended Audience :: Information Technology
40
20
  Classifier: Intended Audience :: Legal Industry
41
- Classifier: License :: OSI Approved :: MIT License
21
+ Classifier: License :: OSI Approved :: Apache Software License
42
22
  Classifier: Operating System :: OS Independent
43
23
  Classifier: Programming Language :: Python :: 3
44
24
  Classifier: Programming Language :: Python :: 3.10
@@ -50,11 +30,11 @@ Classifier: Topic :: System :: Archiving
50
30
  Classifier: Typing :: Typed
51
31
  Requires-Python: >=3.10
52
32
  Requires-Dist: click<9.0,>=8.1
53
- Requires-Dist: cryptography<46.0,>=42.0
33
+ Requires-Dist: cryptography<46.0,>=41.0
54
34
  Requires-Dist: py-algorand-sdk<3.0,>=2.6.1
55
35
  Requires-Dist: requests<3.0,>=2.32.0
56
36
  Requires-Dist: rfc8785<0.2,>=0.1.4
57
- Requires-Dist: tsp-client==0.2.1
37
+ Requires-Dist: tsp-client<0.3,>=0.2.1
58
38
  Provides-Extra: dev
59
39
  Requires-Dist: mypy>=1.10; extra == 'dev'
60
40
  Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
@@ -72,17 +52,18 @@ Description-Content-Type: text/markdown
72
52
 
73
53
  # actproof
74
54
 
75
- Verifiable receipts of regulated acts. Canonical JSON (RFC 8785), RFC 3161
76
- trusted timestamps, Algorand ARC-2 anchoring, independent verification by
77
- any party with a Python install.
55
+ Verifiable evidence receipts for institutional records, regulated acts, and
56
+ public attestations. Canonical JSON (RFC 8785), RFC 3161 trusted timestamps,
57
+ Algorand ARC-2 anchoring, independent verification by any party with a Python
58
+ install.
78
59
 
79
60
  `actproof` produces cryptographic receipts that any third party can verify
80
- without trusting the issuing platform. A receipt binds: the regulated act
81
- being recorded (from the `actproof-events` catalogue), the canonical JSON
82
- of the issuer's evidence, a qualified timestamp from a trusted timestamp
83
- authority, and a transaction on the Algorand public ledger that carries
84
- the same hash. The verifier reproduces the bytes locally and confirms each
85
- binding.
61
+ without trusting the issuing platform. A receipt binds: the record or act
62
+ being documented (optionally classified against the `actproof-events`
63
+ catalogue for regulated acts), the canonical JSON of the issuer's evidence,
64
+ a qualified timestamp from a trusted timestamp authority, and a transaction
65
+ on the Algorand public ledger that carries the same hash. The verifier
66
+ reproduces the bytes locally and confirms each binding.
86
67
 
87
68
  ## What actproof does not claim
88
69
 
@@ -278,18 +259,91 @@ actproof composes five published standards rather than inventing new ones:
278
259
  v2 parser when COSE_Sign1 + SCITT Transparent Statement becomes
279
260
  standardised.
280
261
 
281
- ## What's NOT in v0.1.0
262
+ ## Independent use outside Quoruna
263
+
264
+ `actproof` is a standalone Python library. It does not require Quoruna, an
265
+ account, a hosted service, or any vendor trust. The intended use cases:
266
+
267
+ * **Regulated industries.** Compliance evidence with verifiable timestamps:
268
+ pharma batch records, financial reporting attestations, NIS2 incident
269
+ reports, EUDR due-diligence statements, AI Act risk assessments.
270
+ * **Civil society and journalism.** Verifiable provenance of reporting,
271
+ research outputs, and document releases without a trusted intermediary.
272
+ * **Academic research.** Pre-registration of analysis plans, anchored
273
+ research artifacts, reproducibility receipts.
274
+ * **Public-sector records.** Public decisions, council resolutions,
275
+ procurement evidence, transparency anchors.
276
+ * **Other receipt and attestation systems.** Any application that today
277
+ emits "trust us" PDFs can emit an actproof receipt instead and let the
278
+ recipient verify without contacting the issuer.
279
+
280
+ Quoruna is one consuming application. It is not the only intended
281
+ consumer. The library API is independent of any particular product or
282
+ hosted service.
283
+
284
+ ## API stability
285
+
286
+ The package currently exposes a deliberately large API surface to let
287
+ adopters work at whatever level suits them. Before the v1.0 release,
288
+ the following discipline applies:
289
+
290
+ * **Stable.** `canonicalize`, `hash_canonical`, `hash_canonical_hex`,
291
+ `build_manifest`, `manifest_to_dict`, `manifest_from_dict`,
292
+ `hash_manifest`, `hash_manifest_hex`, `Receipt`, `read_receipt`,
293
+ `write_receipt`, `verify_receipt`, `CheckResult`, `VerificationResult`.
294
+ These will not break between minor versions before v1.0.
295
+ * **Experimental.** `Catalogue`, `validate_manifest`, RFC 3161 TSA
296
+ chain configuration, the `AnchorMode` enum, and the signer
297
+ abstraction. Subject to refinement before v1.0.
298
+ * **Internal-but-exported.** Constants like `IJSON_MAX_SAFE_INT`,
299
+ `ARC2_NOTE_FORMAT`, and `SCHEMA_DISCRIMINATOR_V3`. Available for
300
+ power users but may change.
301
+
302
+ The full list is in `actproof/__init__.py`. v1.0.0 will declare the final
303
+ stable surface and freeze it under semantic versioning.
304
+
305
+ ## Roadmap
306
+
307
+ * **v0.4.0** — Pluggable anchor backend architecture (`AnchorBackend`
308
+ Protocol). Algorand stays as the production backend; the protocol
309
+ abstraction makes Hedera Consensus Service, Stellar memo-hash, Bitcoin
310
+ OP_RETURN, and Ethereum implementations feasible without changes to
311
+ the canonicalisation, receipt, or verifier code. Also migrates off
312
+ `tsp-client` 0.2.1 onto `rfc3161-client` (Trail of Bits) to remove
313
+ the legacy pyOpenSSL cap.
314
+ * **v0.5.0** — Receipt profile registry. Explicit named profiles
315
+ (`actproof-jcs-v1`, `actproof-algorand-arc2-v1`, `actproof-rfc3161-v1`)
316
+ and a stable verifier dispatch surface for adopters.
317
+ * **v1.0.0** — Stable API frozen. Conformance test vectors finalised.
318
+ * **v2.0.0** — COSE_Sign1 + SCITT Transparent Statement bridge once
319
+ RFC 9943 publishes.
320
+
321
+ ## What actproof does NOT yet ship
282
322
 
283
323
  * **EU Trusted List chain validation** for RFC 3161 tokens. The current
284
324
  verifier checks the token is well-formed and self-consistent; full
285
- chain validation against EUTL is v0.2.x.
286
- * **Conformance test vectors** for cross-implementation interop. The
287
- conformance suite lands in v0.3.0.
288
- * **GitHub Action wrapper** for one-call anchoring from a CI step. Lands
289
- in v0.2.0.
290
- * **Worked examples** for NIS2, EUDR, and software-release use cases.
291
- Land in v0.2.0.
325
+ chain validation against EUTL is on the v0.5.x roadmap.
326
+ * **GitHub Action wrapper** for one-call anchoring from a CI step.
327
+ * **Worked end-to-end examples** for NIS2, EUDR, AI Act, and
328
+ software-release use cases. Conformance vectors and example receipts
329
+ land in `examples/` and `docs/CONFORMANCE_VECTORS.md` in v0.3.x.
292
330
 
293
331
  ## License
294
332
 
295
- MIT. The actproof-events catalogue is CC0 / Apache-2.0.
333
+ Apache-2.0. See `LICENSE`. The `actproof-events` catalogue (sibling
334
+ repository) is CC0 / Apache-2.0.
335
+
336
+ ## Why Apache-2.0
337
+
338
+ `actproof` is intended as reusable verification infrastructure. Apache-2.0
339
+ provides:
340
+
341
+ * The same broad permission to embed in commercial or proprietary work
342
+ as MIT.
343
+ * An explicit contributor patent licence (Section 3 of the licence text),
344
+ which matters for cryptographic and protocol code.
345
+ * A clearer legal posture for institutional and public-sector adopters.
346
+
347
+ If you previously consumed `actproof <= 0.3.1` under MIT, those releases
348
+ remain available on PyPI under MIT. All `actproof >= 0.3.2` releases are
349
+ governed by Apache-2.0.