crypto/com.midnight.kuira.core.crypto.dust/DustToken

DustToken

data class DustToken(val initialValue: BigInteger, val owner: String, val nonce: String, val sequenceNumber: Int, val creationTime: Long, val backingNight: String, val merkleTreeIndex: Long, val pendingUntil: Long? = null)

Represents a Dust UTXO (Unspent Transaction Output) in the wallet.

What is a Dust Token? Dust is Midnight's fee payment mechanism. When you register a Night UTXO for dust generation, it creates a Dust token that accumulates value over time. This accumulated dust is used to pay transaction fees.

Dust Generation:

Time →
│
├─ Creation (ctime): initialValue Specks
│
├─ Generation Phase: Value increases linearly
│  Rate: backing Night value × generation_decay_rate
│  Cap: backing Night value × night_dust_ratio
│
├─ Full Phase: Value stays at cap
│
├─ Decay Phase: Value decreases linearly (if backing Night is destroyed)
│
└─ Empty: Value reaches zero

Ledger Mapping: Mirrors the ledger's dust wallet UTXO state: the qualified dust output plus an optional "pending until" timestamp for when it becomes available.

Usage:

val token = DustToken(
    initialValue = BigInteger("1000000"), // 1 Dust = 1,000,000 Specks
    owner = dustPublicKey,
    nonce = randomNonce,
    sequenceNumber = 0,
    creationTime = System.currentTimeMillis(),
    backingNight = nightNonce,
    merkleTreeIndex = 0,
    pendingUntil = null // Available immediately
)

// Calculate current value
val currentValue = token.calculateValue(
    now = System.currentTimeMillis(),
    params = dustParams
)

Constructors

DustToken

constructor(initialValue: BigInteger, owner: String, nonce: String, sequenceNumber: Int, creationTime: Long, backingNight: String, merkleTreeIndex: Long, pendingUntil: Long? = null)