dig-options 0.4.1

The DIG Network canonical Chia option-contract (CHIP-0042) expert crate: a pure, key-free, network-free CoinSpend-builder for covered options — create, exercise, clawback/cancel, inspect. Never holds a key, never signs, never broadcasts — the consumer signs + pushes.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

//! Report the signatures a set of coin spends requires — WITHOUT signing.
//!
//! dig-options never holds a key and never signs. After a builder produces its unsigned
//! `CoinSpend`s, the caller uses [`required_signatures`] to learn exactly which BLS messages
//! it must sign (each carrying the public key, the raw message, and the appended
//! coin/domain data), signs them with its own key material, and aggregates the result into
//! the `SpendBundle`. This keeps the signing decision — and the secret key — entirely on the
//! caller's side of the identity boundary (#908).

use chia_protocol::{Bytes32, CoinSpend};
use chia_wallet_sdk::signer::{AggSigConstants, RequiredSignature};
use clvmr::Allocator;

use crate::error::Result;

/// Compute every signature `coin_spends` requires, given the network's `agg_sig_me`
/// additional data (the genesis challenge — mainnet or testnet).
///
/// Runs each spend's puzzle to collect its `AGG_SIG_*` conditions and resolves them into
/// [`RequiredSignature`]s. The caller signs each returned message with the matching key and
/// aggregates the signatures. This function performs NO signing and touches no secret.
pub fn required_signatures(
    coin_spends: &[CoinSpend],
    agg_sig_me: Bytes32,
) -> Result<Vec<RequiredSignature>> {
    let mut allocator = Allocator::new();
    let constants = AggSigConstants::new(agg_sig_me);
    Ok(RequiredSignature::from_coin_spends(
        &mut allocator,
        coin_spends,
        &constants,
    )?)
}