Stable Packs Documentation

Overview

Protocol map

Opening economics

You pay10 USD0or the live $10 equivalent in USD0

=

9 USD0USD0 cash dropUsed to acquire the selected token.

+

Up to 1 USD0Protocol feeAccrues only after successful delivery.

USD0 network gas is separate. For an USD0 Network gas and the protocol fee come from the amount remaining after the 9 USD0 purchase.

What Stable Packs does

Stable Packs turns a fixed $10 opening into one USD0 cash drop on Stable Chain. You choose a live pack, review its possible outcomes and odds, select USD0 or USD0, and confirm the transaction from your wallet.

Every successful opening follows the same onchain route. The payment, random selection, USD0 cash drop, and direct delivery are enforced by Stable Packs contracts. Stable Packs does not issue points, an IOU, or an offchain claim in place of the delivered token.

Pack Anatomy

A pack is an onchain configuration with a price, a set of eligible USD0 cash drops, and a published weight for every possible result. One opening produces one selected USD0 cash drop.

Live Packs

Stable Packs fails closed. A pack becomes Live only when its complete production route passes current health checks, including deployed contracts, supported USD0 cash drops, price feeds, liquidity routes, settlement simulation, and randomness capacity.

Odds & Selection

Odds are published before payment and describe which USD0 cash drop can be selected. They do not change the amount invested. A rarer result receives the same 9 USD0 purchase allocation as every other result.

After payment, the contract commits the opening to its pack snapshot and uses the configured randomness coordinator to select one enabled option. Settlement retries keep the same selected token. A failed swap cannot reroll the result.

Payments

Both payment choices enter the same Stable Packs opening contract and produce the same USD0 cash drop allocation. Native USD0 is also required separately for Stable Chain network gas.

Settlement

Settlement validates the selected route and its independent price before funds move into the USD0 cash drop. Exactly 9 USD0 is allocated to the purchase. Up to 1 USD0 becomes the protocol fee only after the contract verifies successful delivery.

1. Payment acceptedThe contract records the opening and protects the payment as a liability.
2. Result selectedRandomness resolves one option from the opening's published weights.
3. Route revalidatedLiquidity, price, and minimum output checks run again before the swap.
4. Delivery confirmedThe USD0 cash drop reaches the opener before any protocol fee accrues.

Delivery

The settlement adapter sends the purchased USD0 cash drop directly to the wallet that opened the pack. Stable Packs does not maintain a custodial balance for the user and does not require a later claim transaction.

Retries & Refunds

If settlement fails after selection, the opening remains recoverable. The owner can retry the same selected token. When the contract's refund conditions are met, the owner can instead recover the original payment asset.

Contracts

Stable Packs runs on Stable Chain mainnet, chain ID 988. The primary public contracts can be inspected directly on Blockscout.

$SPACKSNative project token contract address

0xfEaA9149A2E0Ef58e86Faf72B78068dE2D272926Copy

USD0Canonical payment asset on Stable Chain

0xfEaA9149A2E0Ef58e86Faf72B78068dE2D272926Copy