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
  }
}

Introduction​

Entities Schema​

Entry​

Round​

RoundStatusLog​

YOLO​

Deposit​

Transaction​

Examples​

Querying YOLO total rounds​

Querying a Round​

Querying an Entry​

Querying a Deposit​

Querying a Transaction​

Querying a RoundStatusLog​