chip35-dl-coin 0.11.0

Isolated CHIP-0035 Chia DataLayer store coin driver (offline spend-bundle construction).
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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

//! # chip35-dl-coin
//!
//! Isolated CHIP-0035 Chia DataLayer **store coin** driver. Provides the
//! offline spend builders to mint, update, and burn (melt) DataLayer stores,
//! plus keyless spend-bundle serialization helpers. No networking, no signing,
//! no key derivation — those are the caller's responsibility.

mod cat;
mod collection;
mod consolidation;
mod did;
mod dig;
mod error;
mod gating;
mod lazy_mint;
mod metadata;
mod nft;
mod offer;
mod payment;
mod select;
mod store;
mod subscription;
mod types;

// Re-export the chia primitives consumers/bindings need.
pub use chia_bls::{master_to_wallet_unhardened, PublicKey, SecretKey, Signature};
pub use chia_protocol::{Bytes, Bytes32, Coin, CoinSpend, Program, SpendBundle};
pub use chia_puzzle_types::{EveProof, LineageProof, Proof};
// chia-sdk-driver 0.36 respelled `DataStore*` as `Datastore*`. This crate keeps the original
// spelling because it is echoed verbatim by the wasm bindings' exported names and their generated
// TypeScript declarations (`wasm/src/ts.rs`), which are a published JavaScript contract; renaming
// the Rust type would break every JS consumer for a purely cosmetic upstream change. The alias is
// confined to this one boundary so the rest of the crate speaks a single spelling.
pub use chia_sdk_driver::{
    Datastore as DataStore, DatastoreInfo as DataStoreInfo, DatastoreMetadata as DataStoreMetadata,
    DelegatedPuzzle, Did, DidInfo, HashedPtr,
};

pub use error::{Error, WalletError};

// DIG-CAT per-capsule store payment (the canonical store-payment builder). Minting a store is FREE
// of $DIG; a capsule (commit / root-advance) pays the dynamic, USD-pegged per-capsule price in $DIG
// to the treasury via [`build_dig_store_payment`], concatenated atomically with the root-advance.
pub use dig::{
    build_dig_store_payment, dig_treasury_payment_coin, DIG_ASSET_ID,
    DIG_TREASURY_INNER_PUZZLE_HASH,
};

pub use store::{
    add_fee, admin_delegated_puzzle_from_key, datastore_from_spend, digstore_owner_hint,
    hex_spend_bundle_to_coin_spends, melt_store, mint_store, oracle_delegated_puzzle, oracle_spend,
    spend_bundle_to_hex, update_store_metadata, update_store_ownership,
    writer_delegated_puzzle_from_key, DataStoreInnerSpend, DATASTORE_LAUNCHER_HINT,
    DIGSTORE_OWNER_HINT_DOMAIN,
};
pub use types::SuccessResponse;

// Asset toolkit (roadmap #33/#34/#35/#36).
pub use cat::{issue_cat, IssueCatResponse};
pub use collection::{
    build_bulk_mint, build_bulk_mint_funded, build_bulk_mint_funded_no_did, generate_item_metadata,
    synthetic_puzzle_hash, BulkMintResponse, Collection, ManifestItem, ManifestMedia,
};
pub use did::{create_did, CreateDidResponse};
// Trustless lazy mint / mint-on-claim (roadmap #40): the creator DID precommits a collection ONCE,
// then anyone mints an individual NFT on demand with no further DID involvement.
pub use lazy_mint::{
    build_lazy_mint_claim, build_lazy_mint_commit, merkle_membership_root,
    verify_merkle_membership, LazyMintClaimResponse, LazyMintCommitResponse, LazyMintItem,
    LazyMintPolicy, LazyMintTreeDescriptor, MerkleMembershipProof,
};
pub use metadata::{
    sha256, validate_uri_hash, Attribute, Chip0007Metadata, CollectionAttribute, CollectionRef,
    MetadataError, CHIP0007_FORMAT,
};
pub use nft::{
    mint_nft, mint_nft_with_did, DidAttribution, NftMediaMetadata, NftMintParams, NftMintResponse,
};
pub use offer::{decode_offer, encode_offer};

// In-dapp monetization (roadmap #46): payment, paywall (pay-to-unlock), NFT-gating, subscription
// scaffold. The dapp deployed on DIG EARNs — these are the inbound-economic primitives.
pub use gating::{
    prove_collection_membership, prove_nft_ownership, read_nft_ownership, GatingError,
    NftOwnershipProof,
};
pub use payment::{
    build_cat_payment, build_xch_payment, payment_nonce, verify_payment_receipt, ObservedPayment,
    PaymentAsset, PaymentReceipt, PaymentResponse, PaywallError,
};

// Shared coin selection + consolidation (epic #410 / #413): high-value-first selection with a
// coin-count cap + a distinct NeedsConsolidation signal, plus the keyless self-send consolidation
// builders the auto-combine loop submits when a wallet is too fragmented to move value. Released via
// the chip35 wasm; byte-mirrored by the native Rust layer (dig-l1-wallet, #414).
pub use consolidation::{build_cat_consolidation, build_coin_consolidation};
pub use select::{select_coins, CoinSelection, SelectCoinsResult, DEFAULT_COIN_CAP};
pub use subscription::{
    build_subscription_authorization, build_subscription_claim, SubscriptionTerms,
};

// Re-export the Cat primitive (consumed by `build_cat_payment`'s caller to construct the buyer's CAT
// coins, and by the wasm boundary).
pub use chia_sdk_driver::{Cat, CatInfo};

// Deploy-token delegation (roadmap #17): a deploy token is a **revocable writer delegate**, not a
// bespoke puzzle. The prior hand-rolled scaffold (`deploy_token.rs`) is superseded — there is no
// special deploy-token type. To issue one, the owner adds [`writer_delegated_puzzle_from_key`] for
// the CI deploy key to the store's delegated-puzzle set via [`update_store_ownership`]; the deploy
// key then advances the root with [`update_store_metadata`] under [`DataStoreInnerSpend::Writer`]
// (a root advance IS a metadata update — no owner seed required). To revoke, the owner (or an admin
// delegate) replaces the delegated-puzzle set, dropping that writer. An on-chain DIG spend-cap that
// would further bound a deploy token is the only non-native extra and is future work.