Packfolio Documentation

Overview

Protocol map

Opening economics

You pay10 USDGor the live $10 equivalent in ETH

=

9 USDGStock Token purchaseUsed to acquire the selected token.

+

Up to 1 USDGProtocol feeAccrues only after successful delivery.

ETH network gas is separate. For an ETH opening, conversion costs and the protocol fee come from the amount remaining after the 9 USDG purchase.

What Packfolio does

Packfolio turns a fixed $10 opening into one real Stock Token on Robinhood Chain. You choose a live pack, review its possible outcomes and odds, select USDG or ETH, and confirm the transaction from your wallet.

Every successful opening follows the same onchain route. The payment, random selection, Stock Token purchase, and direct delivery are enforced by Packfolio contracts. Packfolio 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 Stock Tokens, and a published weight for every possible result. One opening produces one selected Stock Token.

Live Packs

Packfolio fails closed. A pack becomes Live only when its complete production route passes current health checks, including deployed contracts, supported Stock Tokens, price feeds, liquidity routes, settlement simulation, and randomness capacity.

Odds & Selection

Odds are published before payment and describe which Stock Token can be selected. They do not change the amount invested. A rarer result receives the same 9 USDG 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 Packfolio opening contract and produce the same Stock Token purchase allocation. Native ETH is also required separately for Robinhood Chain network gas.

Settlement

Settlement validates the selected route and its independent price before funds move into the Stock Token. Exactly 9 USDG is allocated to the purchase. Up to 1 USDG 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 Stock Token reaches the opener before any protocol fee accrues.

Delivery

The settlement adapter sends the purchased Stock Token directly to the wallet that opened the pack. Packfolio 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

Packfolio runs on Robinhood Chain mainnet, chain ID 4663. The primary public contracts can be inspected directly on Blockscout.

Packfolio CoreOpening, selection, settlement, retries, and refunds0xcEE660F80Da315b1D4e386c38FbFE72DbDb56a16

USDGCanonical payment asset on Robinhood Chain0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168