mirror of
https://github.com/conduition/dlctix.git
synced 2026-01-30 05:05:06 +01:00
296cfaae66
We were using btrees indexed by players, which required each btree to store the player in memory. This was inefficient. Instead, we now index by usize, which is a player index in the sorted set of players in ContractParameters.
40 lines
1.8 KiB
Rust
40 lines
1.8 KiB
Rust
use secp::Point;
|
|
|
|
/// The agent who provides the on-chain capital to facilitate the ticketed DLC.
|
|
/// Could be one of the players in the DLC, or could be a neutral 3rd party
|
|
/// who wishes to profit by leveraging their capital.
|
|
#[derive(Debug, Clone)]
|
|
pub struct MarketMaker {
|
|
pub pubkey: Point,
|
|
}
|
|
|
|
/// A player in a ticketed DLC. Each player is identified by a public key,
|
|
/// but also by their ticket hash. If a player can learn the preimage of
|
|
/// their ticket hash (usually by purchasing it via Lightning), they can
|
|
/// claim winnings from DLC outcomes.
|
|
///
|
|
/// The same pubkey can participate in the same ticketed DLC under different
|
|
/// ticket hashes, so players might share common pubkeys. However, for the
|
|
/// economics of the contract to work, every player should be allocated
|
|
/// their own completely unique ticket hash.
|
|
#[derive(Debug, Clone, Ord, PartialOrd, Hash, Eq, PartialEq)]
|
|
pub struct Player {
|
|
/// An ephemeral public key controlled by the player.
|
|
///
|
|
/// It should be ephemeral because once the player receives an off-chain
|
|
/// payout, they can choose to reveal their secret key to the market
|
|
/// maker, which allows the market maker to use key-spending (instead
|
|
/// of inefficient script spending) to reclaim the on-chain capital.
|
|
pub pubkey: Point,
|
|
|
|
/// The ticket hashes used for HTLCs. To buy into the DLC, players must
|
|
/// purchase the preimages of these hashes.
|
|
pub ticket_hash: [u8; 32],
|
|
|
|
/// A hash used for unlocking the split TX output early. To allow winning
|
|
/// players to receive off-chain payouts, they must provide this `payout_hash`,
|
|
/// for which they know the preimage. By selling the preimage to the market maker,
|
|
/// they allow the market maker to reclaim the on-chain funds.
|
|
pub payout_hash: [u8; 32],
|
|
}
|