# Punk Paperclip

> It all started with one on-chain paperclip in a vault. Each round, people bid to take whatever the vault is holding, and the vault walks that pile toward a real CryptoPunk.

Runs on Ethereum Mainnet. Anyone can offer NFTs and whitelisted ERC-20s (such as WETH) for everything the vault holds. Offers are signed Seaport orders: the assets stay in the offerer's wallet until the vault accepts one. The accepted offerer receives the whole vault inventory and a Paperclip receipt NFT, and the next round bids for what the vault holds after that.

## Docs

- [Docs](https://punkpaperclip.com/docs): how rounds, offers, settlement and receipts work
  - [What is it](https://punkpaperclip.com/docs#what)
  - [How it works](https://punkpaperclip.com/docs#how)
  - [Offer engine](https://punkpaperclip.com/docs#engine)
    - [Seaport settlement](https://punkpaperclip.com/docs#engine-seaport)
    - [PaperclipRegistry](https://punkpaperclip.com/docs#engine-registry)
    - [Assets stay in your wallet](https://punkpaperclip.com/docs#engine-custody)
  - [How offers work](https://punkpaperclip.com/docs#offers)
    - [Creating an offer](https://punkpaperclip.com/docs#offers-create)
    - [Cancelling](https://punkpaperclip.com/docs#offers-cancel)
    - [Full offer lifecycle](https://punkpaperclip.com/docs#offers-lifecycle)
  - [The Vault](https://punkpaperclip.com/docs#vault)
    - [Sending assets directly (don't)](https://punkpaperclip.com/docs#vault-gifts)
  - [Accepting & settling](https://punkpaperclip.com/docs#settling)
  - [Paperclip receipts](https://punkpaperclip.com/docs#receipts)
    - [Genesis #0](https://punkpaperclip.com/docs#receipts-genesis)
    - [The collection](https://punkpaperclip.com/docs#receipts-collection)
  - [After the Punk](https://punkpaperclip.com/docs#after)
    - [What comes with it](https://punkpaperclip.com/docs#after-what)
    - [Special extra rounds](https://punkpaperclip.com/docs#after-extra)
  - [Why participate](https://punkpaperclip.com/docs#why)

## Pages

- [Start](https://punkpaperclip.com/): the current round, what the vault holds, and the FAQ
- [Current round](https://punkpaperclip.com/rounds): redirects to the round now taking offers; every round is at /rounds/{n}
- [Paperclips](https://punkpaperclip.com/paperclips): every receipt minted, each at /paperclips/{id}
- [Create an offer](https://punkpaperclip.com/create): needs a connected wallet

## Contracts

- Vault (holds the inventory and accepts offers): [0x40a2fca4771a8539c22faafa7ac4b4514658db3d](https://etherscan.io/address/0x40a2fca4771a8539c22faafa7ac4b4514658db3d)
- Punk Paperclips collection (the receipts): [0x15882b17ba4256886dfd0228f7a404ace4f11e84](https://etherscan.io/address/0x15882b17ba4256886dfd0228f7a404ace4f11e84)
- PaperclipRegistry (records offers made to the vault): [0x768062dd183691c883a20dffc02dd17142feecef](https://etherscan.io/address/0x768062dd183691c883a20dffc02dd17142feecef)
- Seaport (settles every trade): [0x0000000000000068F116a894984e2DB1123eB395](https://etherscan.io/address/0x0000000000000068F116a894984e2DB1123eB395)
- [The collection on OpenSea](https://opensea.io/assets/ethereum/0x15882b17ba4256886dfd0228f7a404ace4f11e84)

## Data (read-only JSON)

The routes the pages themselves read. Not a versioned API: the shapes follow the site.

- [Rounds](https://punkpaperclip.com/api/rounds): every round: whether it is open, when it settled, who won it, and its receipt's mint status
- [Offers](https://punkpaperclip.com/api/offers): offers registered for the vault; one offer at /api/offers/{id}
- [A Paperclip](https://punkpaperclip.com/api/paperclips/0): one Paperclip's fields and traits, by token id (0 is Genesis)

## Optional

- [Sitemap](https://punkpaperclip.com/sitemap.xml)