kuilt-deal/us.tractat.kuilt.deal

Package-level declarations

Types

CardOp

@Serializable

sealed class CardOp

A card mutation broadcast over the seam.

CardPhase

enum CardPhase : Enum<CardPhase>

CardState

@Serializable

data class CardState(val ciphertext: ByteArray, val encryptedBy: GSet<PlayerId>, val strippedBy: GSet<PlayerId>, val visibilityQuorum: Set<PlayerId>, val allPlayers: Set<PlayerId>, val quorumTracks: Map<PlayerId, QuorumTrack> = emptyMap())

CommitmentViolation

class CommitmentViolation(val peer: PeerId, val expectedHash: ByteArray, val actualHash: ByteArray) : Exception

Thrown when a peer's revealed secret does not match its earlier commitment hash.

CommutativeScheme

interface CommutativeScheme

DealSession

class DealSession(seam: Seam, scheme: CommutativeScheme, myKey: SchemeKeyPair, allPlayers: Set<PlayerId>, myId: PlayerId, scope: CoroutineScope) : ScopedCloseable

Drives a cryptographically fair card deal over a Seam, as an op-based CRDT.

DeckState

@Serializable

data class DeckState(val cards: List<CardState>)

EncryptedKey

@Serializable

class EncryptedKey(val bytes: ByteArray)

EncryptProof

@Serializable

class EncryptProof(val bytes: ByteArray)

FairRandom

class FairRandom(seam: Seam, peers: Set<PeerId>, tamperedReveal: Boolean = false, fixedSecret: ByteArray? = null, fixedNonce: ByteArray? = null)

Two-phase commit-reveal protocol for deriving a shared random Long seed.

KeyEscrow

interface KeyEscrow

PlayerId

typealias PlayerId = PeerId

QuorumTrack

@Serializable

data class QuorumTrack(val ciphertext: ByteArray, val strippedBy: GSet<PlayerId>)

One quorum member's private-copy reveal chain on a partial multi-member quorum card (CardState.isPartialQuorum).

SchemeKey

@Serializable

class SchemeKey(val raw: ByteArray)

SchemeKeyPair

data class SchemeKeyPair(val encryptKey: SchemeKey, val stripKey: SchemeKey)

SraScheme

class SraScheme : CommutativeScheme

SRA (Shamir–Rivest–Adleman) commutative encryption scheme.

StripProof

@Serializable

class StripProof(val bytes: ByteArray)

Functions

applyOp

fun CardState.applyOp(op: CardOp): CardState?

Returns the next CardState after applying op, or null if op is invalid.

canApply

fun CardState.canApply(op: CardOp): Boolean

Returns true iff op is valid to apply to this CardState.

decodePlaintext

fun decodePlaintext(encoded: ByteArray): ByteArray

Inverse of encodePlaintext: drops the 0x01 marker byte.

encodePlaintext

fun encodePlaintext(plaintext: ByteArray): ByteArray

Encode arbitrary card plaintext into the SRA domain for SraScheme.