Skip to content

chore: fix cargo doc errors #4510

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Conversation

ehegnes
Copy link
Contributor

@ehegnes ehegnes commented May 3, 2025

No description provided.

Signed-off-by: Eric Hegnes <eric@hegnes.com>
@ehegnes ehegnes requested a review from benluelo as a code owner May 3, 2025 06:25
Copy link

vercel bot commented May 3, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

1 Skipped Deployment
Name Status Preview Comments Updated (UTC)
site ⬜️ Ignored (Inspect) May 3, 2025 6:25am

@@ -49,7 +49,7 @@ pub const ZKGM_TOKEN_MINTER_LABEL: &str = "zkgm-token-minter";

/// Instantiate `ucs03-zkgm`.
///
/// This will instantiate the minter contract with the provided [`TokenMinterInitMsg`][crate::msg::TokenMinterInitMsg]. The admin of the minter contract is set to `ucs03-zkgm`. All migrations for the minter will be threaded through the `ucs03-zkgm` migrate entrypoint.
/// This will instantiate the minter contract with the provided [`ucs03_zkgm_token_minter_api::TokenMinterInitMsg`]. The admin of the minter contract is set to `ucs03-zkgm`. All migrations for the minter will be threaded through the `ucs03-zkgm` migrate entrypoint.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// This will instantiate the minter contract with the provided [`ucs03_zkgm_token_minter_api::TokenMinterInitMsg`]. The admin of the minter contract is set to `ucs03-zkgm`. All migrations for the minter will be threaded through the `ucs03-zkgm` migrate entrypoint.
/// This will instantiate the minter contract with the provided [`TokenMinterInitMsg`][ucs03_zkgm_token_minter_api::TokenMinterInitMsg]. The admin of the minter contract is set to `ucs03-zkgm`. All migrations for the minter will be threaded through the `ucs03-zkgm` migrate entrypoint.

@@ -64,7 +64,7 @@ pub enum QueryMsg {
GetStatus {
client_id: ClientId,
},
/// NOTE: Reads state through the [`QueryStore`].
/// NOTE: Reads state through the `ibc_union::state::QueryStore`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// NOTE: Reads state through the `ibc_union::state::QueryStore`.
/// NOTE: Reads state through the `QueryStore`.

@@ -83,13 +83,13 @@ pub enum QueryMsg {
proof: Bytes,
path: Bytes,
},
/// NOTE: Reads state through the [`QueryStore`].
/// NOTE: Reads state through the `ibc_union::state::QueryStore`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// NOTE: Reads state through the `ibc_union::state::QueryStore`.
/// NOTE: Reads state through the `QueryStore`.

UpdateState {
caller: String,
client_id: ClientId,
relayer: String,
},
/// TODO: Should read state through the [`QueryStore`].
/// TODO: Should read state through the `ibc_union::state::QueryStore`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// TODO: Should read state through the `ibc_union::state::QueryStore`.
/// TODO: Should read state through the `QueryStore`.

@@ -17,50 +17,40 @@ pub mod slots {
use solidity_slot::{MappingKey, Slot, U256};
use unionlabs_primitives::ByteArrayExt;

/// The slot containing [`_latestNodeCreated`].
/// The slot containing [`_latestNodeCreated`](https://github.com/OffchainLabs/nitro-contracts/blob/90037b996509312ef1addb3f9352457b8a99d6a6/src/rollup/RollupCore.sol#L62).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why? just fix the link instead:

    /// [`_latestNodeCreated`]: https://github.com/OffchainLabs/nitro-contracts/blob/90037b996509312ef1addb3f9352457b8a99d6a6/src/rollup/RollupCore.sol#L62
                              ^ here

Comment on lines +92 to +93
/// [`crate::Callback::AggregateSubmitTxFromOrderedHeaders`] message, which will
/// be used to build the actual [`unionlabs::ibc::core::client::msg_update_client::MsgUpdateClient`]s.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same comment here

/// Use [`nodes()`] to calculate the slot for the mapping.
///
/// [`_nodes`] https://github.com/OffchainLabs/nitro-contracts/blob/90037b996509312ef1addb3f9352457b8a99d6a6/src/rollup/RollupCore.sol#64
/// Use `nodes()` to calculate the slot for the mapping.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this should link to rollup_core_nodes_confirm_data_slot

/// Given an [`OrderedMsgUpdateClients`], returns [`Op`]s that generate [`IbcMessage`]s with proofs at the highest height of the updates.
/// Given an `OrderedMsgUpdateClients`, returns [`Op`]s that generate `IbcMessage`s with proofs at the highest height of the updates.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

keep the links but include the full path to types not already in scope

@@ -37,7 +37,7 @@ pub struct BatchableEvent<V: IbcSpecExt> {
}

// REVIEW: We probably want to add a way to have "a packet timed out" be a variant here as well
/// A subset of [`FullEvent`], containing only events that cause an action on the counterparty chain.
/// A subset of [`ibc_classic_spec::FullEvent`], containing only events that cause an action on the counterparty chain.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// A subset of [`ibc_classic_spec::FullEvent`], containing only events that cause an action on the counterparty chain.
/// A subset of [`FullEvent`][ibc_classic_spec::FullEvent], containing only events that cause an action on the counterparty chain.

@@ -74,7 +74,7 @@ impl TryFrom<ibc_classic_spec::FullEvent> for EventClassic {
}

// REVIEW: We probably want to add a way to have "a packet timed out" be a variant here as well
/// A subset of [`FullEvent`], containing only events that cause an action on the counterparty chain.
/// A subset of [`ibc_union_spec::event::FullEvent`], containing only events that cause an action on the counterparty chain.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// A subset of [`ibc_union_spec::event::FullEvent`], containing only events that cause an action on the counterparty chain.
/// A subset of [`FullEvent`][ibc_union_spec::event::FullEvent], containing only events that cause an action on the counterparty chain.

@unionlabs unionlabs deleted a comment May 3, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants