Struct SetMirrorAdvertiseUrlsParams 

pub struct SetMirrorAdvertiseUrlsParams {
    pub urls: Option<Vec<String>>,
}

control.config.setMirrorAdvertiseUrls params.

The three states this ONE optional field carries, and why an empty list is refused

• None (absent, or JSON null) CLEARS the override, reverting to dig-node#562’s DERIVED default — this node’s own discovered public address.
• Some(urls) with at least one entry SETS the override to exactly those URLs.
• Some(vec![]) — an EXPLICIT empty list — is REFUSED as -32602 INVALID_PARAMS rather than silently taken to mean either of the above. It is genuinely ambiguous between “advertise nothing” (forfeiting every mirror reward this node could otherwise earn this epoch) and “go back to automatic” — and guessing wrong either forfeits money the operator did not intend to give up, or silently overrides a deliberate choice to stop advertising. See Self::validated.

Fields

urls: Option<Vec<String>>

The URLs to advertise, or None to clear the override and revert to the derived default. See the type doc for why Some(vec![]) is refused rather than accepted as either meaning.

Implementations

impl SetMirrorAdvertiseUrlsParams

pub fn validated(self) -> Result<Self, ControlError>

Refuse an explicit empty list, and refuse any entry that is not a well-formed absolute URL, both as -32602 INVALID_PARAMS. None and a non-empty list of well-formed URLs both pass through unchanged.

Refused rather than guessed at, for the same reason CollateralMarginSetParams::validated refuses rather than clamps: a caller is stating an intent right now, and silently applying a different meaning than the one requested would make a subsequent MirrorAdvertiseView disagree with what the caller believes it set — on a surface that gates real mirror-coin rewards.

Trait Implementations

impl Clone for SetMirrorAdvertiseUrlsParams

fn clone(&self) -> SetMirrorAdvertiseUrlsParams

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ControlCall for SetMirrorAdvertiseUrlsParams

const METHOD: ControlMethod = ControlMethod::ConfigSetMirrorAdvertiseUrls

The wire method this call invokes.

type Output = SetMirrorAdvertiseUrlsResult

The typed result this call returns on success.

impl Debug for SetMirrorAdvertiseUrlsParams

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SetMirrorAdvertiseUrlsParams

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SetMirrorAdvertiseUrlsParams

impl PartialEq for SetMirrorAdvertiseUrlsParams

fn eq(&self, other: &SetMirrorAdvertiseUrlsParams) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for SetMirrorAdvertiseUrlsParams

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SetMirrorAdvertiseUrlsParams