LooksRare YOLO Subgraph

Introduction

The LooksRare YOLO Subgraph is designed to index data from the YOLO contract deployed on the Ethereum network. The YOLO contract is a system where users can deposit different types of tokens (ETH/ERC-20/ERC-721) to participate in YOLO rounds.

The LooksRare YOLO Subgraph organizes its data into several core entities. These entities include:

• YOLO: Represents the overall YOLO state.
• Round: Contains information about a specific YOLO round.
• Entry: Describes a single user's participation in a round.
• Deposit: Represents a deposit made by a user in a round.
• Transaction: Represents an Ethereum transaction associated with a YOLO event.
• RoundStatusLog: Contains logs for the status changes of a round.

If you're unfamiliar with GraphQL, you may want to check out an Introduction to GraphQL.

The YOLO Subgraph is located at the following endpoint: YOLO Subgraph.

Entities Schema

More information about each field can also be found in the YOLO Smart Contract documentation.

Entry

An Entry entity represents an entry in a round.

• id: The entry’s id (ID!).
• depositor: The address of the depositor (Bytes!).
• round: The Round entity associated with the entry (Round!).
• totalNumberOfEntries: The total number of entries for the depositor in the round (BigInt!).
• deposits: A list of Deposit entities associated with this entry ([Deposit!]!)

Round

A Round entity represents a round of the YOLO.

• id: The round’s id (ID!).
• roundId: The roundId within the contract (BigInt!).
• status: The status of the round (Int!).
• lastStatusUpdate: The timestamp of the last status update (BigInt).
• statusLog: A list of RoundStatusLog entities associated with the round ([RoundStatusLog!]!).
• winner: The address of the round’s winner (Bytes).
• cutoffTime: The cutoff time for the round (BigInt!).
• drawnAt: The timestamp when the winner was drawn (BigInt).
• drawnHash: The transaction hash where the winner was drawn (Bytes).
• numberOfParticipants: The number of participants in the round (BigInt!).
• maximumNumberOfDeposits: The maximum number of deposits for the round (BigInt!).
• maximumNumberOfParticipants: The maximum number of participants for the round (BigInt!).
• valuePerEntry: The value per entry for the round (BigInt!).
• numberOfEntries: The number of entries in the round (BigInt!).
• deposits: A list of Deposit entities associated with the round ([Deposit!]!).
• transactions: A list of Transaction entities associated with the round ([Transaction!]!).

RoundStatusLog

A RoundStatusLog entity represents a log of a round's status change.

• id: The log’s id (ID!).
• round: The Round entity associated with the status log (Round!).
• status: The status of the round (Int!).
• transaction: The transaction hash that caused the status to change (Bytes!).
• timestamp: The timestamp when the status was updated (BigInt!).
• block: The block number when the status was updated (BigInt!).

YOLO

A YOLO entity represents the overall YOLO game.

• id: The YOLO entity id (ID!).
• totalRounds: The total number of rounds in the YOLO (BigInt!).

Deposit

A Deposit entity represents a deposit made in a round.

• id: The deposit’s id (ID!).
• round: The Round entity associated with the deposit (Round!).
• entry: The Entry entity associated with the deposit (Entry!).
• transaction: The Transaction entity associated with the deposit (Transaction!).
• indice: The index of the deposit (BigInt!).
• tokenType: The type of token deposited (Int!).
• tokenAddress: The address of the token (Bytes!).
• tokenId: The id of the token (BigInt!).
• tokenAmount: The amount of tokens deposited (BigInt!).
• depositor: The address of the depositor (Bytes!).
• numberOfEntries: The number of entries corresponding to the deposit (BigInt!).
• claimed: Indicates whether the deposit has been claimed (Boolean!).
• withdrawn: Indicates whether the deposit has been withdrawn (Boolean!).
• claimedHash: The transaction hash when the deposit was claimed (Bytes).

Transaction

A Transaction entity represents a transaction in a round.

• id: The transaction's hash (ID!).
• hash: The transaction’s hash (Bytes!).
• round: The Round entity associated with the transaction (Round!).
• depositor: The address of the depositor (Bytes!).
• deposits: A list of Deposit entities associated with the transaction ([Deposit!]!).
• totalNumberOfEntries: The total number of entries associated with the transaction (BigInt!).
• gasLimit: The gas limit of the transaction (BigInt!).
• gasPrice: The gas price of the transaction (BigInt!).
• block: The block number when the transaction was made (BigInt!).
• timestamp: The timestamp when the transaction was made (BigInt!).

Examples

Querying YOLO total rounds

This query retrieves the totalRounds of the YOLO game.

{
  yolos {
    totalRounds
  }
}

Querying a Round

This query retrieves a specific Round by its id.

{
  round(id: "4") {
    id
    roundId
    status
    lastStatusUpdate
    cutoffTime
    deposits {
      tokenType
      depositor
      tokenAddress
      tokenAmount
    }
    numberOfParticipants
    maximumNumberOfDeposits
    maximumNumberOfParticipants
    valuePerEntry
    numberOfEntries
    drawnAt
    winner
  }
}

Querying an Entry

This query retrieves a specific Entry by its id.

{
  entry(id: "4-0x992c659e3a3a2a7902c145441c77e8c216a1332f") {
    id
    depositor
    round {
      roundId
      drawnAt
      cutoffTime
    }
    totalNumberOfEntries
  }
}

Querying a Deposit

This query retrieves a specific Deposit by its id.

{
  deposit(id: "4-2") {
    id
    round {
      roundId
      lastStatusUpdate
    }
    entry {
      id
      totalNumberOfEntries
    }
    transaction {
      hash
    }
    indice
    tokenType
    tokenAddress
    tokenId
    tokenAmount
    depositor
    numberOfEntries
    claimed
    withdrawn
    claimedHash
  }
}

Querying a Transaction

This query retrieves a specific Transaction by its id.

{
  transaction(
    id: "0x06332cd7009ac080ddb6af6d86e2a0756bc6d7c6071d29e89e5481edc43d38fa"
  ) {
    id
    hash
    round {
      roundId
    }
    depositor
    totalNumberOfEntries
    gasLimit
    gasPrice
    block
    timestamp
  }
}

Querying a RoundStatusLog

This query retrieves a specific RoundStatusLog by its id.

{
  roundStatusLog(id: "4-2") {
    id
    round {
      roundId
    }
    status
    transaction
    timestamp
    block
  }
}