feat(aggregator): basic JSON-RPC API version mgmt

[aasseman]

By API, here we mean specifically the TAP JSON-RPC API version, not the library version.

Maintains a const list of supported API versions, as well as a const list of API versions for which to warn of imminent deprecation. We expect the client to periodically check if its expected API version is deprecated. For all functions, an expected API version is to be supplied as argument. Each function will have to check if the number is supported, and return an error otherwise.

Rationale:

• The JSON-RPC spec does not allow for deprecation messages. All non-error responses have to be HTTP 204. The design is the result of trying not to break the JSON-RPC spec.
• This is designed for maximum flexibility. The primary goal is to have a reasonable public API. The actual implementation can be improved in the future.
• Enables support for and discovery of multiple API versions from day 0.
• Enables a way to warn users of future version deprecations from day 0.

Some of those features may not be needed, but at least there is a low chance that we get stuck when the need to migrate to a new API version arises.

Please comment!

fixes #79 (hopefully!)

[aasseman]

Rebased onto latest main

[aasseman]

What's left at this point:

• Detailed documentation of the JSON API
• Enums for JSON-RPC warning and error codes

[github-actions[bot]]

🤖 Cargo Audit Report 🤖`

Show Report

*** Fetching advisory database from `https://github.com/RustSec/advisory-db.git` Loaded 547 security advisories (from /usr/local/cargo/advisory-db) Updating crates.io index Scanning Cargo.lock for vulnerabilities (421 crate dependencies) Crate: atty Version: 0.2.14 Warning: unsound Title: Potential unaligned read Date: 2021-07-04 ID: RUSTSEC-2021-0145 URL: https://rustsec.org/advisories/RUSTSEC-2021-0145 Dependency tree: atty 0.2.14 └── criterion 0.4.0 └── tap_core 0.1.0 └── tap_aggregator 0.1.0 warning: 1 allowed warning found ```

Pusher: @aasseman, Action: pull_request, Working Directory: `, Workflow:tests`

[github-actions[bot]]

Coverage after merging rpc_api_versioning into main will be

80.91%

Coverage Report

File	Stmts	Branches	Funcs	Lines	Uncovered Lines
tap_aggregator/src
aggregator.rs	92.45%	100%	100%	90.70%	40–43, 53–56
api_versioning.rs	93.10%	100%	88.24%	95.12%	15
error_codes.rs	0%	100%	0%	0%	16, 5
jsonrpsee_helpers.rs	48.78%	100%	41.67%	51.72%	44, 51–57, 9
main.rs	3.70%	100%	6.67%	2.56%	17, 21–22, 26, 30–31, 35–36, 40–41, 45–46, 49–51, 54–61, 64–69, 72–76, 78
server.rs	86.09%	100%	100%	82.22%	101, 113–117, 137, 69–77
tap_core/src
eip_712_signed_message.rs	83.78%	100%	80%	85.19%	57
lib.rs	78.57%	100%	80%	77.78%	22, 59
receipt_aggregate_voucher.rs	92.50%	100%	87.50%	93.75%	23
tap_core/src/adapters/test
collateral_adapter_mock.rs	88.33%	100%	75%	90.38%	18, 44–45, 64
collateral_adapter_test.rs	100%	100%	100%	100%
rav_storage_adapter_mock.rs	92%	100%	71.43%	95.35%	30
rav_storage_adapter_test.rs	100%	100%	100%	100%
receipt_checks_adapter_mock.rs	97.83%	100%	100%	97.50%	61
receipt_checks_adapter_test.rs	95.83%	100%	100%	95%	59
receipt_storage_adapter_mock.rs	93.46%	100%	86.67%	94.57%	28, 90–92
receipt_storage_adapter_test.rs	100%	100%	100%	100%
tap_core/src/tap_manager
manager.rs	76.76%	100%	58.33%	78.46%	107, 126–129, 135, 170–176, 190, 201–202, 213, 95
rav_request.rs	0%	100%	0%	0%	9
tap_core/src/tap_manager/test
manager_test.rs	100%	100%	100%	100%
tap_core/src/tap_receipt
mod.rs	41.46%	100%	36.36%	43.33%	16, 49–59
receipt.rs	88.46%	100%	87.50%	88.89%	19
receipt_auditor.rs	80%	100%	83.33%	79.70%	103–105, 115, 121–126, 139, 146, 161–163, 65, 78–80, 87–90
received_receipt.rs	83.06%	100%	78.05%	83.83%	119–121, 131, 215–217, 230–232, 238–240, 247–249, 251–253, 282–284, 308, 319, 326, 333–335, 340, 345, 349–350, 359–360, 382, 396–398

[github-actions[bot]]

🤖 Cargo Audit Report 🤖`

Show Report

*** Fetching advisory database from `https://github.com/RustSec/advisory-db.git` Loaded 547 security advisories (from /usr/local/cargo/advisory-db) Updating crates.io index Scanning Cargo.lock for vulnerabilities (421 crate dependencies) Crate: atty Version: 0.2.14 Warning: unsound Title: Potential unaligned read Date: 2021-07-04 ID: RUSTSEC-2021-0145 URL: https://rustsec.org/advisories/RUSTSEC-2021-0145 Dependency tree: atty 0.2.14 └── criterion 0.4.0 └── tap_core 0.1.0 └── tap_aggregator 0.1.0 warning: 1 allowed warning found ```

Pusher: @aasseman, Action: pull_request, Working Directory: `, Workflow:tests`

[github-actions[bot]]

Coverage after merging rpc_api_versioning into main will be

80.91%

Coverage Report

File	Stmts	Branches	Funcs	Lines	Uncovered Lines
tap_aggregator/src
aggregator.rs	92.45%	100%	100%	90.70%	40–43, 53–56
api_versioning.rs	93.10%	100%	88.24%	95.12%	15
error_codes.rs	0%	100%	0%	0%	16, 5
jsonrpsee_helpers.rs	48.78%	100%	41.67%	51.72%	44, 51–57, 9
main.rs	3.70%	100%	6.67%	2.56%	17, 21–22, 26, 30–31, 35–36, 40–41, 45–46, 49–51, 54–61, 64–69, 72–76, 78
server.rs	86.09%	100%	100%	82.22%	101, 113–117, 137, 69–77
tap_core/src
eip_712_signed_message.rs	83.78%	100%	80%	85.19%	57
lib.rs	78.57%	100%	80%	77.78%	22, 59
receipt_aggregate_voucher.rs	92.50%	100%	87.50%	93.75%	23
tap_core/src/adapters/test
collateral_adapter_mock.rs	88.33%	100%	75%	90.38%	18, 44–45, 64
collateral_adapter_test.rs	100%	100%	100%	100%
rav_storage_adapter_mock.rs	92%	100%	71.43%	95.35%	30
rav_storage_adapter_test.rs	100%	100%	100%	100%
receipt_checks_adapter_mock.rs	97.83%	100%	100%	97.50%	61
receipt_checks_adapter_test.rs	95.83%	100%	100%	95%	59
receipt_storage_adapter_mock.rs	93.46%	100%	86.67%	94.57%	28, 90–92
receipt_storage_adapter_test.rs	100%	100%	100%	100%
tap_core/src/tap_manager
manager.rs	76.76%	100%	58.33%	78.46%	107, 126–129, 135, 170–176, 190, 201–202, 213, 95
rav_request.rs	0%	100%	0%	0%	9
tap_core/src/tap_manager/test
manager_test.rs	100%	100%	100%	100%
tap_core/src/tap_receipt
mod.rs	41.46%	100%	36.36%	43.33%	16, 49–59
receipt.rs	88.46%	100%	87.50%	88.89%	19
receipt_auditor.rs	80%	100%	83.33%	79.70%	103–105, 115, 121–126, 139, 146, 161–163, 65, 78–80, 87–90
received_receipt.rs	83.06%	100%	78.05%	83.83%	119–121, 131, 215–217, 230–232, 238–240, 247–249, 251–253, 282–284, 308, 319, 326, 333–335, 340, 345, 349–350, 359–360, 382, 396–398

[github-actions[bot]]

🤖 Cargo Audit Report 🤖`

Show Report

*** Fetching advisory database from `https://github.com/RustSec/advisory-db.git` Loaded 548 security advisories (from /usr/local/cargo/advisory-db) Updating crates.io index Scanning Cargo.lock for vulnerabilities (421 crate dependencies) Crate: atty Version: 0.2.14 Warning: unsound Title: Potential unaligned read Date: 2021-07-04 ID: RUSTSEC-2021-0145 URL: https://rustsec.org/advisories/RUSTSEC-2021-0145 Dependency tree: atty 0.2.14 └── criterion 0.4.0 └── tap_core 0.1.0 └── tap_aggregator 0.1.0 warning: 1 allowed warning found ```

Pusher: @aasseman, Action: pull_request, Working Directory: `, Workflow:tests`

[github-actions[bot]]

Coverage after merging rpc_api_versioning into main will be

80.66%

Coverage Report

File	Stmts	Branches	Funcs	Lines	Uncovered Lines
tap_aggregator/src
aggregator.rs	92.45%	100%	100%	90.70%	40–43, 53–56
api_versioning.rs	86.21%	100%	76.47%	90.24%	15–16
error_codes.rs	0%	100%	0%	0%	16, 5
jsonrpsee_helpers.rs	43.90%	100%	33.33%	48.28%	44, 51–57, 9
main.rs	3.70%	100%	6.67%	2.56%	17, 21–22, 26, 30–31, 35–36, 40–41, 45–46, 49–51, 54–61, 64–69, 72–76, 78
server.rs	86.09%	100%	100%	82.22%	101, 113–117, 137, 69–77
tap_core/src
eip_712_signed_message.rs	83.78%	100%	80%	85.19%	57
lib.rs	78.57%	100%	80%	77.78%	22, 59
receipt_aggregate_voucher.rs	92.50%	100%	87.50%	93.75%	23
tap_core/src/adapters/test
collateral_adapter_mock.rs	88.33%	100%	75%	90.38%	18, 44–45, 64
collateral_adapter_test.rs	100%	100%	100%	100%
rav_storage_adapter_mock.rs	92%	100%	71.43%	95.35%	30
rav_storage_adapter_test.rs	100%	100%	100%	100%
receipt_checks_adapter_mock.rs	97.83%	100%	100%	97.50%	61
receipt_checks_adapter_test.rs	95.83%	100%	100%	95%	59
receipt_storage_adapter_mock.rs	93.46%	100%	86.67%	94.57%	28, 90–92
receipt_storage_adapter_test.rs	100%	100%	100%	100%
tap_core/src/tap_manager
manager.rs	76.76%	100%	58.33%	78.46%	107, 126–129, 135, 170–176, 190, 201–202, 213, 95
rav_request.rs	0%	100%	0%	0%	9
tap_core/src/tap_manager/test
manager_test.rs	100%	100%	100%	100%
tap_core/src/tap_receipt
mod.rs	41.46%	100%	36.36%	43.33%	16, 49–59
receipt.rs	88.46%	100%	87.50%	88.89%	19
receipt_auditor.rs	80%	100%	83.33%	79.70%	103–105, 115, 121–126, 139, 146, 161–163, 65, 78–80, 87–90
received_receipt.rs	83.06%	100%	78.05%	83.83%	119–121, 131, 215–217, 230–232, 238–240, 247–249, 251–253, 282–284, 308, 319, 326, 333–335, 340, 345, 349–350, 359–360, 382, 396–398