ChainInfo

@Serializable
data class ChainInfo(val publicKey: String, val period: Long, val genesisTime: Long, val genesisSeed: String, val chainHash: String, val scheme: String, val beaconId: String)

Chain configuration information for a drand network.

Contains all metadata needed to verify beacons from a specific drand chain, including the public key, timing parameters, and cryptographic scheme.

This data is returned by a node's /info endpoint and should be cached to avoid redundant network calls.

Constructors

Link copied to clipboard
constructor(publicKey: String, period: Long, genesisTime: Long, genesisSeed: String, chainHash: String, scheme: String, beaconId: String)

Properties

Link copied to clipboard
@SerialName(value = "beacon_id")
val beaconId: String

Human-readable identifier for this beacon chain (e.g., "default", "quicknet"). This is an alias that the drand API resolves to the chainHash.

Link copied to clipboard
@SerialName(value = "chain_hash")
val chainHash: String

Hex-encoded SHA-256 hash uniquely identifying this beacon chain. This is the cryptographic identifier for the network.

Link copied to clipboard
@SerialName(value = "genesis_seed")
val genesisSeed: String

Hex-encoded hash identifying the initial seed for this chain. This provides the starting randomness from which all beacons are derived.

Link copied to clipboard
@SerialName(value = "genesis_time")
val genesisTime: Long

The timestamp of round 0, in Unix epoch seconds. Used to calculate expected round numbers based on current time.

Link copied to clipboard

How often the network emits randomness, in seconds. For example, 30 means a new beacon every 30 seconds.

Link copied to clipboard
@SerialName(value = "public_key")
val publicKey: String

Hex-encoded BLS12-381 public key (no "0x" prefix). This is the aggregated public key from all nodes in the network, used to verify beacon signatures.

Link copied to clipboard

The signing scheme identifier determining which cryptographic operations to use. Examples: "pedersen-bls-chained", "bls-unchained-g1-rfc9380".