Get group snapshots

Query toolkit to fetch group snapshots

Group snapshots store the data of a group at a specific timestamp. You can easily know the data of any group by knowing the groupId or the groupName and the associated timestamp.

Get the latest snapshot

You can query the latest snapshot by specifying the groupId or the groupName.

Query with groupId

query getSnapshot {
  groupSnapshot(
    groupId: "0x682544d549b8a461d7fe3e589846bb7b",
  ) {
    id
    dataUrl
    size
    timestamp
    valueDistribution {
      numberOfAccounts
      value
    }
  }
}

Query with groupName

query getSnapshot {
  groupSnapshot(
    groupName: "proof-of-humanity",
  ) {
    id
    dataUrl
    size
    timestamp
    valueDistribution {
      numberOfAccounts
      value
    }
  }
}

Response

{
  "data": {
    "groupSnapshot": {
      "id": "0x682544d549b8a461d7fe3e589846bb7b6c617465737400000000000000000000",
      "dataUrl": "https://sismo-prod-hub-data.s3.eu-west-1.amazonaws.com/group-snapshot-store/0x682544d549b8a461d7fe3e589846bb7b/1678111868.json",
      "size": 16932,
      "timestamp": "latest",
      "valueDistribution": [
        {
          "numberOfAccounts": 16932,
          "value": "1"
        }
      ]
    }
  }
}

Get a snapshot at a specific timestamp

Query

query getSnapshotWithTimestamp {
  groupSnapshot(
    groupName: "proof-of-humanity",
    timestamp: "1675692588"
  ) {
    id
    dataUrl
    size
    timestamp
    valueDistribution {
      numberOfAccounts
      value
    }
  }
}

Response

{
  "data": {
    "groupSnapshot": {
      "id": "0x682544d549b8a461d7fe3e589846bb7b00000000000000000000000063e10a2c",
      "dataUrl": "https://sismo-prod-hub-data.s3.eu-west-1.amazonaws.com/group-snapshot-store/0x682544d549b8a461d7fe3e589846bb7b/1675692588.json",
      "size": 16834,
      "timestamp": "1675692588",
      "valueDistribution": [
        {
          "numberOfAccounts": 16834,
          "value": "1"
        }
      ]
    }
  }
}