Module types 

Request/response wire types for every DIG-node RPC method.

Each type is serde-derived and models a method’s params or result field-for-field with the canonical implementation (the digstore dig-node crate). Fields that appear only in one profile or only on the first window of a paged stream are Option and doc-flagged.

Hex-encoded identifiers (store_id, root, retrieval_key, peer_id) are carried as String on the wire — lower-case 64-hex — because the interface crate does no crypto and imposes no byte-array dependency. Callers validate length/charset at their boundary.

Two content profiles, one chunk type

ContentChunk models both the node profile (dig.getContent on the local dig-node) and the network profile (rpc.dig.net). The network-profile-only fields — total_length, length, program_hash, offset — are Option so one type serves both surfaces with no silent split.

Structs

AnchoredRoot

Result for dig.getAnchoredRoot — the store’s current chain-anchored tip root.

AnnounceAck

Result for dig.announce.

AnnounceParams

Params for dig.announce.

AvailabilityAnswer

One availability answer. Only the fields relevant to the query’s granularity are populated.

AvailabilityBatch

Result for dig.getAvailability — one answer per query item, in order.

AvailabilityQuery

One availability query item. Granularity is inferred from which fields are present: store_id only ⇒ which roots are held; +root ⇒ a capsule; +root +retrieval_key ⇒ a resource.

CacheConfig

Result for cache.getConfig.

CacheStats

Result for cache.stats — cache telemetry beside cache.getConfig: the reserved cap + live usage, the cached-capsule count + total on-disk bytes, and the session eviction + content-cache counters.

CachedCapsule

One durable cached-module entry.

CachedList

Result for cache.listCached.

CapsuleKey

Params for a capsule-keyed cache op (cache.removeCached, cache.fetchAndCache).

Collection

Result for dig.getCollection — collection-level facts computed from DIG’s own coinset data.

CollectionItem

One resolved collection item — its current on-chain owner, royalty, and CHIP-0007 metadata.

CollectionItemsPage

Result for dig.listCollectionItems — a page of resolved items.

ContentCacheCounters

The decoded-content cache hit/miss counters carried in CacheStats.

ContentChunk

One window of a resource’s ciphertext — the chunk wire object.

ContentRef

The content item a redirect points at: store_id [+ root [+ retrieval_key]], each lower-case 64-hex — the exact item to re-request.

FetchAndCacheResult

Result for cache.fetchAndCache.

FetchModuleRangeParams

Params for dig.fetchModuleRange — a single range frame of the whole .dig module blob for (store, root).

FetchRangeParams

Params for dig.fetchRange — a single range frame of a resource this node holds.

GetAnchoredRootParams

Params for dig.getAnchoredRoot.

GetAvailabilityParams

Params for dig.getAvailability.

GetCollectionParams

Params for dig.getCollection.

GetContentParams

Params for dig.getContent — a verified resource-window read.

GetModuleInfoParams

Params for dig.getModuleInfo — the handshake a peer reads before range-pulling a whole .dig module for (store, root).

GetRewardDistributorParams

Params for dig.getRewardDistributor.

GetRewardDistributorResult

Result for dig.getRewardDistributor — SPEC §2.6, third method: chain-derived distributor state only, never the local prover loop’s own state (see RewardProverStatus for that).

GetRewardProverStatusParams

Params for dig.getRewardProverStatus.

GetRewardProverStatusResult

Result for dig.getRewardProverStatus.

Health

Result for dig.health — liveness + a capability summary.

ListCollectionItemsParams

Params for dig.listCollectionItems.

ListInventoryParams

Params for dig.listInventory.

ListRewardDistributorCommitmentsParams

Params for dig.listRewardDistributorCommitments.

ListRewardDistributorCommitmentsResult

Result for dig.listRewardDistributorCommitments — SPEC §7.4 clause 5: per-epoch commitment slots, never a single balance figure.

ListRewardDistributorsResult

Result for dig.listRewardDistributors — SPEC §2.6: “the distributors this node funds, and the distributors this node has a claim to as a mirror”.

Methods

Result for dig.methods — the method names this node implements (agent self-describe).

ModuleInfo

Result for dig.getModuleInfo — the transfer descriptor of a whole .dig module.

NetworkInfo

Result for dig.getNetworkInfo — this node’s own peer-network posture.

NftMetadata

CHIP-0007 NFT metadata for one collection item.

PayeeClaimStatus

Result for dig.getPayeeRewardClaimStatus — the claim-side posture of the node answering, as a payee.

PeerAddress

A peer’s dialable network endpoint.

PeerConnectParams

Params for control.peers.connect and control.peers.disconnect.

PeerConnectResult

Result for control.peers.connect.

PeerDisconnectResult

Result for control.peers.disconnect.

PeerStatusSnapshot

Result for control.peerStatus — a snapshot of the node’s L7 peer network. Always safe to call; reports running: false on the FFI path.

PeersList

Result for dig.getPeers — the peers this node currently knows (peer exchange over RPC).

ProverCounters

The reward prover loop’s running counters — SPEC §2.3.

Provider

A content provider: a holder’s stable peer_id plus its candidate addresses.

RangeFrame

One range frame of a resource: a byte window, plus the per-resource verification metadata that makes the window independently checkable.

RedirectInfo

The error.data.redirect payload of a ContentRedirect (-32008).

RelayStatus

The node’s relay reservation posture.

RemoveCachedResult

Result for cache.removeCached.

RewardDistributorCommitment

One clawback commitment slot for a distributor epoch — SPEC §7.4 clause 5.

RewardDistributorRef

A minimal distributor reference — SPEC §2.6.

RewardProverStatus

One distributor’s prover-loop status — SPEC §2.3 / §2.4.

SetCapBytesParams

Params for cache.setCapBytes.

SetCapBytesResult

Result for cache.setCapBytes.

StageParams

Params for dig.stage — compile a local folder into a capsule .dig module in-process.

StageResult

Result for dig.stage — the compiled capsule.

SubscribeParams

Params for control.subscribe and control.unsubscribe.

SubscribeResult

Result for control.subscribe.

SubscriptionsList

Result for control.listSubscriptions.

UnsubscribeResult

Result for control.unsubscribe.

Enums

ClaimLogObservation

What a node can say about its own claim log: it read the log and has a count, or it did not read the log and has no count to give.

Half

One collection a responder either consulted — and can therefore answer for — or did not: dig-rewards-coin SPEC §12.5 clause 6.

Inventory

Result for dig.listInventory.

PayeeSubject

The subject of a payee-side status answer.

ProverState

The always-on reward prover loop’s state — SPEC §2.3, the closed set.

Type Aliases

HexId

A lower-case 64-hex identifier on the wire (e.g. a store_id, root, retrieval_key, or peer_id). A type alias for documentation; validation is the boundary’s job.