🏦 Escrow Architecture & Settlement

DogWifDice is built on a per-round escrow architecture, where every game instance is independently funded, executed, and settled.

This model is central to the platform’s design and directly addresses common issues found in traditional crypto gaming systems, such as pooled liquidity risk, opaque balances, and delayed withdrawals.


🧩 Core Principle

Each game round operates as a self-contained financial unit.

Instead of maintaining a shared pool of user funds or internal account balances, DogWifDice creates a unique escrow wallet for every game round.

All funds required for that round are deposited directly into this escrow wallet, and all payouts are distributed from it.


🔁 Round Lifecycle

Every game follows a clear and consistent lifecycle:

1. Round Initialization

  • A player selects a game and sets a stake amount

  • A unique escrow wallet is generated for that round


2. Funding Phase

  • The player sends funds directly to the escrow wallet

  • In PvP mode, both players must fund the same escrow wallet

  • In PvH mode, the house matches the player’s stake

Important: Users must fund from the same wallet they expect to receive payouts to.


3. Game Execution

  • Once all required funds are received, the game is executed

  • The outcome is determined based on predefined rules


4. Settlement

  • Funds are distributed directly from the escrow wallet:

    • Winner receives payout

    • Platform fee is deducted

    • Remaining funds go to the appropriate party


5. Escrow Closure

  • The escrow wallet is cleared after settlement

  • No funds remain in the wallet

  • The round is considered complete


💰 Settlement Logic

All payouts are derived directly from the escrow wallet for that round.

Player vs House (PvH)

  • Gross Pot = Player Stake + House Stake

Outcome
Distribution

Player Wins

90% to player

Platform Fee

10% of total pot

Player Loses

100% to house


Player vs Player (PvP)

  • Gross Pot = Player A + Player B

Outcome
Distribution

Winner

90% of total pot

Platform Fee

10% of total pot


Special Case: Push (Blackjack)

In the event of a push (tie):

  • The escrow returns funds to the player

  • No platform fee is taken

  • The round is closed cleanly

This ensures a fair and user-aligned outcome.


🔐 Why Escrow-Based Design Matters

DogWifDice deliberately avoids a pooled liquidity or shared balance model.

❌ Traditional Model Problems

  • Shared funds increase systemic risk

  • Users rely on platform custody

  • Withdrawals may be delayed or restricted

  • Lack of clarity on fund flow


✅ DogWifDice Approach

Feature
Benefit

Per-round escrow

Full isolation of funds

Direct funding

No hidden balances

Immediate settlement

No withdrawal delays

Wallet-to-wallet flow

User retains control


🧠 Transparency by Design

The escrow system makes every round:

  • Traceable — funds can be followed from deposit to payout

  • Deterministic — outcomes map directly to fund distribution

  • Auditable (at a high level) — users can verify round activity

Each round effectively acts as a mini ledger entry.


⚠️ User Responsibilities

To ensure proper operation, users must:

  • Fund using the correct wallet

  • Send the exact required amount

  • Keep the round interface open during funding

  • Avoid sending funds from unsupported or incorrect sources

Failure to follow these may result in:

  • Failed round initialization

  • Delayed settlement

  • Refund handling requirements


🛡️ Risk Isolation

Because each round is independent:

  • A failure in one round does not affect others

  • There is no cascading liquidity risk

  • Exposure is limited to the current game only

This significantly reduces the platform’s overall risk profile.


⚡ Performance Considerations

The escrow model is optimized for:

  • Fast round creation

  • Immediate execution

  • Rapid settlement

Combined with Solana’s speed, this enables:

  • High-frequency gameplay

  • Minimal waiting time

  • Smooth user experience


🔄 No Persistent Balances

DogWifDice does not maintain:

  • User wallets

  • Internal balances

  • Custodial accounts

Every interaction is:

Wallet → Escrow → Settlement → Wallet

This eliminates ambiguity and simplifies user understanding.


🔁 Escrow Flow

Last updated

Was this helpful?