proto: Add Any Protobuf type and improve Duration and Timestamp Protobuf types

[romac]

Closes: #1445

Notes

• This PR only includes Any, Duration, and Timestamp for now, but we may add other well-known types if needed.
• All three types come with a prost::Name impl, as requested.
• Any::from_msg and Any::to_msg are provided.
• I chose not to go with pbjson-build as it brings a dependency on chrono whereas we are using time at the moment. Also, there only a few protos and we can just inline the serde implementation generated by pbjson-build or write our own manually. I am happy to revisit this if deemed necessary.
• JSON serialization for Any is not compliant with the ProtoJSON spec because it is currently impossible to do so without knowledge of all registered types that may be serialized as an Any. See the corresponding pbjson issue for more info. Instead, we currently use the same serialization format as pbjson.

Important

Before we merge this, we need to try out integration in ibc-proto-rs, cosmos-rust, ibc-rs, and Hermes.

---

• Referenced an issue explaining the need for the change
• Updated all relevant documentation in docs
• Updated all code comments where relevant
• Wrote tests
• Added entry in .changelog/

[romac]

@tony-iqlusion Looking forward to hearing what you think :)

[tony-iqlusion]

This looks good to me

[ash-burnt]

Unlike prost_types::Timestamp, our Timestamp struct does not provide a way to construct it from a std::time::SystemTime, is this something we want to add?

@Peartes can you take a pass at this in a follow-up PR?

[romac]

Unlike prost_types::Timestamp, our Timestamp struct does not provide a way to construct it from a std::time::SystemTime, is this something we want to add?

@Peartes can you take a pass at this in a follow-up PR?

I have taken care of it, as well as derivation of impls for schemars, borsh and parity-scale-codec.

[romac]

Here is the draft integration PR for ibc-proto: cosmos/ibc-proto-rs#226

[Farhad-Shabani]

Thank you @romac. Looks good from ibc-rs end as well.
Since ibc-proto-rs and tendermint-proto get hormonized, this also resolves an existing bump in ibc-rs. This PR probably closes #1053 as well?

[romac]

Yes once merged it will resolve that as well.

[tony-iqlusion]

@romac it looks like both tendermint and tendermint-proto still include prost-types in their Cargo.toml

[tony-iqlusion]

I'm getting a bunch of build failures trying to use this feature:

$ cargo test --all-features
   Compiling tendermint-proto v0.39.0
error[E0433]: failed to resolve: use of undeclared crate or module `std`
   --> /Users/tarcieri/.cargo/registry/src/index.crates.io-6f17d22bba15001f/tendermint-proto-0.39.0/src/google/protobuf/timestamp.rs:105:11

(repeat several dozen instances of that error re: std)

I think you forgot an extern crate std and it seems like CI probably isn't testing it.

[tony-iqlusion]

Opened an issue to track this: #1454

[tony-iqlusion]

Hmm, this previously returned DurationError:

https://docs.rs/prost-types/0.13.1/src/prost_types/duration.rs.html#86-104

impl TryFrom<Duration> for time::Duration {
    type Error = DurationError;

    /// Converts a `Duration` to a `std::time::Duration`, failing if the duration is negative.
    fn try_from(mut duration: Duration) -> Result<time::Duration, DurationError> {
        duration.normalize();
        if duration.seconds >= 0 && duration.nanos >= 0 {
            Ok(time::Duration::new(
                duration.seconds as u64,
                duration.nanos as u32,
            ))
        } else {
            Err(DurationError::NegativeDuration(time::Duration::new(
                (-duration.seconds) as u64,
                (-duration.nanos) as u32,
            )))
        }
    }
}

[romac]

Good catch, will fix it! As well as replace the From<core::time::Duration> instance with a TryFrom<core::time::Duration> following prost-types's implementation instead of pbjson-types which I lifted those from.

[romac]

#1456