Struct WalletCoinSpendParams 

pub struct WalletCoinSpendParams {
    pub coin_id: String,
}

control.wallet.coinSpend params: WHICH coin’s spend to read, named by that coin’s own id.

Why the spend and the coin record are separate methods

WalletCoinByIdParams answers what is this coin, and was it spent? — an id, an amount, a puzzle HASH and two heights. None of that reveals what the spend DID. Reconstructing a lineage (which is how a dig-profile’s DID singleton is followed forward) needs the puzzle REVEAL and the solution, and those exist only in the spend. A caller holding a coin record alone can see that a coin is gone and cannot see what it became.

The id names the SPENT coin, not the spend

A spend has no id of its own on chain; it is identified by the coin it consumed. So the parameter is the same 64-hex coin id WalletCoinByIdParams takes, validated by the same rule, and the two methods are asked with the identical value.

Fields

coin_id: String

The SPENT coin’s id: lowercase 64-hex, unprefixed. A 0x prefix is TOLERATED on input and normalized away by Self::validated; it is never emitted.

Implementations

impl WalletCoinSpendParams

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

Normalize and check the coin id, or reject the request as -32602 INVALID_PARAMS.

A malformed id is a malformed REQUEST, and the node refuses it here — before consulting any chain. That ordering is normative rather than an optimisation: were a bad id allowed through, the read would come back empty, and the caller would be told the honest-looking answer the chain holds nothing about a coin it never actually asked after. An unanswerable question and a chain that answered “no” must never wear the same shape.

Accepts exactly two spellings — 64 lowercase hex characters, or the same 64 preceded by 0x. Uppercase, whitespace and every other length are refused, because the contract’s hex wire form is lowercase and unprefixed everywhere else in this crate.

Trait Implementations

impl Clone for WalletCoinSpendParams

fn clone(&self) -> WalletCoinSpendParams

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ControlCall for WalletCoinSpendParams

const METHOD: ControlMethod = ControlMethod::WalletCoinSpend

The wire method this call invokes.

type Output = WalletCoinSpendResult

The typed result this call returns on success.

impl Debug for WalletCoinSpendParams

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WalletCoinSpendParams

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for WalletCoinSpendParams

impl PartialEq for WalletCoinSpendParams

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for WalletCoinSpendParams

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 WalletCoinSpendParams