Merge pull request #817 from idky137/update_state_service_chain_index_integration

Update state service chain index integration: Feature/lightclient protocol v0.4.0

Author: AloeareV

.gitignore

@@ -14,3 +14,4 @@ docker_cargo/**/*
 container-target/
 .local/
 .failed-tests
+**/proptest-regressions/**

CHANGELOG.md

@@ -0,0 +1,192 @@
+# Changelog
+All notable changes to this library will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this library adheres to Rust's notion of
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## Unreleased
+- [808] Adopt lightclient-protocol v0.4.0
+
+### Added 
+### Changed
+- zaino-proto now references v0.4.0 files
+### Removed
+- `
+
+### Deprecated
+- `zaino-fetch::chain:to_compact` in favor of `to_compact_tx` which takes an 
+  optional height and a `PoolTypeFilter` (see zaino-proto changes)
+- 
+## [v0.4.0] - 2025-12-03
+
+### Added
+- `compact_formats.CompactTxIn`
+- `compact_formats.TxOut`
+- `service.PoolType`
+- `service.LightdInfo` has added fields `upgradeName`, `upgradeHeight`, and
+  `lightwalletProtocolVersion`
+- `compact_formats.CompactTx` has added fields `vin` and `vout`,
+  which may be used to represent transparent transaction input and output data.
+- `service.BlockRange` has added field `poolTypes`, which allows
+  the caller of service methods that take this type as input to cause returned
+  data to be filtered to include information only for the specified protocols.
+  For backwards compatibility, when this field is set the default (empty) value,
+  servers should return Sapling and Orchard data. This field is to be ignored
+  when the type is used as part of a `service.TransparentAddressBlockFilter`.
+
+### Changed
+- The `hash` field of `compact_formats.CompactTx` has been renamed to `txid`.
+  This is a serialization-compatible clarification, as the index of this field
+  in the .proto type does not change.
+- `service.Exclude` has been renamed to `service.GetMempoolTxRequest` and has
+  an added `poolTypes` field, which allows the caller of this method to specify
+  which pools the resulting `CompactTx` values should contain data for.
+
+### Deprecated
+- `service.CompactTxStreamer`:
+    - The `GetBlockNullifiers` and `GetBlockRangeNullifiers` methods are
+      deprecated.
+- `zaino_fetch::FullTransaction::to_compact` deprecated in favor of `to_compact_tx` which includes
+  an optional for index to explicitly specify that the transaction is in the mempool and has no
+  index and `Vec<PoolType>` to filter pool types according to the transparent data changes of
+  lightclient-protocol v0.4.0
+- `zaino_fetch::chain::Block::to_compact` deprecated in favor of `to_compact_block` allowing callers
+  to specify `PoolTypeFilter` to filter pools that are included into the compact block according to
+  lightclient-protocol v0.4.0
+- `zaino_fetch::chain::Transaction::to_compact` deprecated in favor of `to_compact_tx` allowing callers
+  to specify `PoolTypFilter` to filter pools that are included into the compact transaction according
+  to lightclient-protocol v0.4.0.
+
+## [v0.3.6] - 2025-05-20
+
+### Added
+- `service.LightdInfo` has added field `donationAddress`
+- `service.CompactTxStreamer.GetTaddressTransactions`. This duplicates
+  the `GetTaddressTxids` method, but is more accurately named.
+
+### Deprecated
+- `service.CompactTxStreamer.GetTaddressTxids`. Use `GetTaddressTransactions`
+  instead.
+
+## [v0.3.5] - 2023-07-03
+
+### Added
+- `compact_formats.ChainMetadata`
+- `service.ShieldedProtocol`
+- `service.GetSubtreeRootsArg`
+- `service.SubtreeRoot`
+- `service.CompactTxStreamer.GetBlockNullifiers`
+- `service.CompactTxStreamer.GetBlockRangeNullifiers`
+- `service.CompactTxStreamer.SubtreeRoots`
+
+### Changed
+- `compact_formats.CompactBlock` has added field `chainMetadata`
+- `compact_formats.CompactSaplingOutput.epk` has been renamed to `ephemeralKey`
+
+## [v0.3.4] - UNKNOWN
+
+### Added
+- `service.CompactTxStreamer.GetLatestTreeState`
+
+## [v0.3.3] - 2022-04-02
+
+### Added
+- `service.TreeState` has added field `orchardTree`
+
+### Changed
+- `service.TreeState.tree` has been renamed to `saplingTree`
+
+## [v0.3.2] - 2021-12-09
+
+### Changed
+- `compact_formats.CompactOrchardAction.encCiphertext` has been renamed to
+  `CompactOrchardAction.ciphertext`
+
+## [v0.3.1] - 2021-12-09
+
+### Added
+- `compact_formats.CompactOrchardAction`
+- `service.CompactTxStreamer.GetMempoolTx` (removed in 0.3.0) has been reintroduced.
+- `service.Exclude` (removed in 0.3.0) has been reintroduced.
+
+### Changed
+- `compact_formats.CompactSpend` has been renamed `CompactSaplingSpend`
+- `compact_formats.CompactOutput` has been renamed `CompactSaplingOutput`
+
+## [v0.3.0] - 2021-07-23
+
+### Added
+- `service.CompactTxStreamer.GetMempoolStream`
+
+### Removed
+- `service.CompactTxStreamer.GetMempoolTx` has been replaced by `GetMempoolStream`
+- `service.Exclude` has been removed as it is now unused.
+
+## [v0.2.4] - 2021-01-14
+
+### Changed
+- `service.GetAddressUtxosArg.address` has been replaced by the
+  repeated field `addresses`. This is a [conditionally-safe](https://protobuf.dev/programming-guides/proto3/#conditionally-safe-changes)
+  format change.
+- `service.GetAddressUtxosReply` has added field `address`
+
+## [v0.2.3] - 2021-01-14
+
+### Added
+- `service.LightdInfo` has added fields:
+  - `estimatedHeight`
+  - `zcashdBuild`
+  - `zcashdSubversion`
+
+## [v0.2.2] - 2020-10-22
+
+### Added
+- `service.TreeState`
+- `service.GetAddressUtxosArg`
+- `service.GetAddressUtxosReply`
+- `service.GetAddressUtxosReplyList`
+- `service.CompactTxStreamer.GetTreeState`
+- `service.CompactTxStreamer.GetAddressUtxos`
+- `service.CompactTxStreamer.GetAddressUtxosStream`
+
+## [v0.2.1] - 2020-10-06
+
+### Added
+- `service.Address`
+- `service.AddressList`
+- `service.Balance`
+- `service.Exclude`
+- `service.CompactTxStreamer.GetTaddressBalance`
+- `service.CompactTxStreamer.GetTaddressBalanceStream`
+- `service.CompactTxStreamer.GetMempoolTx`
+- `service.LightdInfo` has added fields:
+  - `gitCommit`
+  - `branch`
+  - `buildDate`
+  - `buildUser`
+
+## [v0.2.0] - 2020-04-24
+
+### Added
+- `service.Duration`
+- `service.PingResponse`
+- `service.CompactTxStreamer.Ping`
+
+### Removed
+- `service.TransparentAddress` was removed (it was unused in any service API).
+
+## [v0.1.1] - 2019-11-27
+
+### Added
+- `service.Empty`
+- `service.LightdInfo`
+- `service.TransparentAddress`
+- `service.TransparentAddressBlockFilter`
+- `service.CompactTxStreamer.GetTaddressTxids`
+- `service.CompactTxStreamer.GetLightdInfo`
+- `service.RawTransaction` has added field `height`
+
+## [v0.1.0] - 2019-09-19
+
+Initial release