/linea-attestation-registry

Verax is a shared registry for storing attestations of public interest on EVM chains, designed to enhance data discoverability and consumption for dApps across the network.

Primary LanguageTypeScriptMIT LicenseMIT


Verax
Verax Attestation Registry

Verax is a shared registry for storing attestations of public interest on EVM chains, designed to enhance data discoverability and consumption for dApps across the network.

Links • Repository Organisation • Contributing • Contracts Addresses • Linking Attestations • License

Links

📚 Official documentation
🔍 Testnet GraphQL API
🔍 Mainnet GraphQL API
🧱 Verax SDK - WIP
🌍 Verax Explorer - Coming soon

Repository Organisation

.
├── contracts   # All smart contracts needed to run Verax
├── explorer    # Explorer frontend to discover the main objects
├── sdk         # The Verax SDK to easily interact with the contracts and the subgraph
├── subgraph    # The subgraph indexing Verax data

Contributing

Verax Attestation Registry is a community-led initiative, with developers from various companies and different backgrounds. While we are more than happy to get help from multiple sources, we need to rely on strong Ways of Working.

Don't hesitate to check our Contribution Guide before pushing your first code to the repo!

Contracts Addresses

The main contracts (i.e. the "registries") and the helpers contracts are deployed on:

  • Linea Testnet
  • Linea Mainnet
  • Arbitrum Testnet
  • Arbitrum Mainnet

Here are the addresses on those networks:

Linea Testnet
Linea Mainnet
Arbitrum Testnet
Arbitrum Mainnet

Linking Attestations

Verax Attestation Registry allows creating links ("relationships") between attestations.
🔗 Go to the official documentation for more details

Verax offers 2 Schemas to cover most use cases:

  • The Relationship Schema, with ID 0x41b8c81288eebbf173b2f54b9fb2f1d37f2caca51ef39e8f99299b53c2599a3a
  • The Named Graph Relationship Schema with ID 0x8f83a0ef7871f63455a506f6bca0db98a88721764ae6dbde2afddd8e12e442b8

Managing Off-chain Attestations

To handle large payloads to attest and avoid increasing the gas cost for the attestation process, it is possible to host the attested payload off-chain. In this case, the on-chain attestation will only contain a link to the attested payload, based on a dedicated Schema called Offchain. It is available with ID 0xa288e257097a4bed4166c002cb6911713edacc88e30b6cb2b0104df9c365327d.

To use it, simply pass a payload with the following content:

{
  "schemaId": "0x41b8c81288eebbf173b2f54b9fb2f1d37f2caca51ef39e8f99299b53c2599a3b",
  "uri": "https://example.com/payload/123"
}
  • schemaId: the ID of the Schema encoding the complete (off-chain) payload
  • uri: the link to the complete (off-chain) payload

License

MIT