Skip to content

fortunecookies/overview

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 

Repository files navigation

Introduction to FortuneCookies

FortuneCookies is a game of art and luck on Ethereum. Each FortuneCookie is a collectible good luck charm that contains a surprise! Players collect and trade FortuneCookies to maximize their GoodFortune, a form of digital luck that exhibits special powers.

FortuneCookies are produced in limited edition batches designed in collaboration with a unique artist. Everything from the design of the charm and the surprise inside, to the number of FortuneCookies produced, are part of the artist's intended experience. When you own a FortuneCookie, you actually own the digital rights to the associated art. Crack one open to see for yourself!

FortuneCookies batches are sold during official Bake Sales, which will be pre-announced on official FortuneCookies Twitter, Medium, and Telegram accounts at least a week prior. Batches are limited edition, so when they're gone they're truly gone – no more reprints can ever be made. Visit the Official Bake Sale to buy your FortuneCookie. If the Bake Sale is closed, FortuneCookies may be available for resale at popular collectibles exchanges like RareBits, SuperRare, or OpenSea.

FortuneCookies are secured by Ethereum. Technically, FortuneCookies are ERC721 tradeable tokens on the Ethereum blockchain (see ERC721: Non-Fungible Tokens). Because your FortuneCookies live on Ethereum, your GoodFortune will last for generations.

screen shot 2018-06-03 at 9 58 52 pm

Table of Contents

  1. Collect Digital FortuneCookies
    1. The Charm
    2. The Surprise
    3. The Batch
    4. The Bake Sale
  2. Earn GoodFortune on Ethereum
    1. Your GoodFortune Score
    2. The GoodFortune Formula
      1. Fixed Attributes
      2. Gameplay Multipliers
    3. The GoodFortune API
    4. The GoodFortune Oracle
  3. Spread Good Fortune in the World
    1. Artist Compensation
    2. FortuneCookies Foundation
    3. Community Culture

Collect Digital FortuneCookies

FortuneCookies are collectible charms with a surprise.

screen shot 2018-06-03 at 8 53 53 pm

The Charm

The charm is the exterior shell of the FortuneCookie, and contains the surprise hidden inside. All charms are the same for a whole batch, which makes it easy to associate your FortuneCookie with a batch when it's in your wallet – since the charm also functions as your collectibles icon.

PREVIOUS BATCHES CHARMS
Genesis Golden FortuneCookie

screen shot 2018-06-03 at 10 01 12 pm

The Surprise

The surprise is the goodness hidden inside your FortuneCookie that reveals itself to the player that opens the FortuneCookie for the first time. We achieve this by using your Ethereum address to generate pseudorandomness, which assigns you a resultant surprise from the available batch. Unlike regular fortune cookies, FortuneCookies surprises are actually made-for-you.

SURPRISE DESCRIPTION
Lucky Saying String of text; usually a proverb
Lucky Numbers Array of numbers between 0-100; usually four
Artwork Digital artwork
Nothing Hey, it could happen.

image

The Batch

FortuneCookies Batches are limited edition releases that can produce anywhere between 1 and 1 million new FortuneCookies. Batches are the main grouping of FortuneCookies in the game; FortuneCookies from the same Batch have the same Charm – and they usually share similar surprises.

dont know -> Players are restricted to holding only 1 FortuneCookie from each batch at a time.

Batches are designed in collaboration with an artist. The entire experience of the batch, from the number of FortuneCookies produced, to the charm and the surprise hidden inside, are the vision of the artist.

The Bake Sale

Bake Sales are official FortuneCookies events when new FortuneCookies are sold to the public. Most Bake Sales will occur on our website, however some may occur offline or in person for special occasions.

fc_bake-sale

SALE TYPES DESCRIPTION
Reverse Auction fixed quantity; high > low variable price; sold sequentially.
VanillaAuction Use cases include time-based drip auction (like CryptoKitties), single auction
Dutch Auction .
Reverse Dutch Auction .
Flash Sale fixed quantity; fixed price; parallel sales, first come first served until gone.
Buy Now Can be applied to any sale; a price that is above current market rate and allows you to purchase the Next FortuneCookie.

View the Bake Sale.

Earn GoodFortune on Ethereum

Fortune as a positive attribute. Many cultures believe that luck and good fortune are attributes that a person can possess. We wanted to make this a literal reality, so we made GoodFortune an attribute on Ethereum.

Your GoodFortune Score

GoodFortune is a form of public reputation for an Ethereum address. Because FortuneCookies live on the public Ethereum blockchain, their ownership can be publicly tracked.

Publicly verifiable. GoodFortune is secured by Ethereum, so it is pub. Luck that Follows You. Silos suck. Because your GoodFortune is

If you care about the details of how your GoodFortune score is calculated, continue reading. If not, jump to "Spread Good Fortune in the World."

The GoodFortune Formula

A player's GoodFortune is calculated by totaling the GoodFortune of their FortuneCookies.

GoodFortune(player) = sum((GoodFortune(FortuneCookie1)), (GoodFortune(FortuneCookie2)), ...)

The amount of GoodFortune possessed by an individual FortuneCookie is determined by a combination of fixed and variable attributes, and is harder to earn over time.

FIXED ATTRIBUTES * GAMEPLAY MULTIPLIERS * DIFFICULTY

Certain FortuneCookie attributes are fixed and determined during the production of the batch. Other gameplay multipliers affect the GoodFortune value of a FortuneCookie and are behavioral and determined by gameplay dynamics. GoodFortune is harder to earn over time. This is the GoodFortune Difficulty Curve. (Is this bias already built into the weighting of the variables?)

MEANING TYPE VARIABLE FORMULA
Vintage Fixed BatchNumber ( ( last ( BatchNumber ) ) - BatchNumber ) ^ 2
Rarity Fixed BatchQuantity ( 1 / BatchQuantity )
Vintage Set on Sale FortuneCookieNumber ( LastFortuneCookieNumber - FortuneCookieNumber ) ^ 2
Vintage Set on Sale BatchSequence ( ( ( BatchLast - FortuneCookieID ) / ( Range ) ) )
Value Set on Sale SalePrice (std deviations from the mean) is the multiplier. (( or should this be last sale price? - it would be more realtime and punishing ))
Loyalty Set on Open InitialOwnerGoodFortune (Top 25%: 2x) (25%-50%: 1.5x) (50%-75%: 1.25x) (75%-100%: 1.1x) XOXO !! The GoodFortune Multiplier !! XOXO When you buy FortuneCookies from Official Bake Sales, we offer a bonus incentive for our loyal players. We reserve the right to refuse transactions from any address choose, especially if we beileve it to be an aggregation service.
Community Set on Open InitialOwnerPublicTweet 1.1 +10% multiplier, one time opportunity during the bake sale.
Community Gameplay PreviousOwners 1.05 ^ n note: cost is 3.5% to exchange owners, so net 1.5%
Value Gameplay PriceChange what has the price done
Conversion Rate Difficulty TotalGoodFortuneOutstanting (0 - 1,000,000: 1) (1,000,001 - 10,000,000: 0.8) (10,000,001 - 100,000,000: 0.5) (100,000,001 - 1,000,000,000: 0.2)

The GoodFortune API

We offer simple a simple API to request information about a FortuneCookies player address. Our services cache blockchain information, so it's easier/free to lookup information from the GoodFortune Oracle. Easily getFortuneCookies or getGoodFortune balance for a player address. Learn more about [The GoodFortune API]

```GetFortuneCookies() returns an array of the FortuneCookies owned by an```

```GetGoodFortune() returns the total GoodFortune possessed by a player address```

The GoodFortune Oracle

The GoodFortune Oracle is a smart contract on Ethereum that serves two important functions. First, it contains the official formula for calculating GoodFortune the calculation for determining the amount of GoodFortune a FortuneCookie has, as well as contains pointers to every official Batch contract.

function goodFortuneOf(address _owner) external view returns (uint256);
function countFortuneCookies(address _owner) external view returns (uint256);
function calculateGoodFortune(address _owner) external view returns (uint256);

The GoodFortune Oracle exists at the following Ethereum network addresses:

NETWORK ADDRESS
Main 0x1234567890123456789012345678901234567890
Rinkeby 0x1234567890123456789012345678901234567890
Ropsten 0x1234567890123456789012345678901234567890

Spread Good Fortune in the World

The Fortune Friends are committed to spreading good fortune, both digitally and IRL. It's our mission to use new technology as a powerful force of change, empowerment, and self-organization.

Artist Compensation

We fairly compensate artists with between 10-20% of every sale, and 1.25% of every resale.

screen shot 2018-06-03 at 8 50 21 pm

FortuneCookies Foundation

We donate 10% of every sale to the FortuneCookies Foundation, a non-profit committed to spreading good fortune by investing in social impact bounties that matter to our community. Submit an idea at FortuneCookies Foundation. What change will you bounty?

screen shot 2018-06-03 at 8 42 12 pm

Community Culture

We want to promote a fun, open cult-ure. We value creativity, positivity, change, boldness, fun, and play.

Releases

No releases published

Packages

No packages published