TR8 protocol is a permissionless public good protocol, on the Superchain, for traits (TR8s) of many types, including event attendance, credentials, in-game assets, badges, and more. TR8 protocol uses Ethereum Attestion Searvice (EAS) as a base layer, providing customization, onchain, structured data for issuers of all types of credentials. NFT metadata is store onchain in attestations.
A basic example front end for creating event-based TR8s can be found at https://tr8.me
Some code for TR8 protocol lives in other repos under the tr8-protocol organisation on Github:
- Frontend - an example front end (work in progress)
- Events Example Frontend - an example front-end focused on event attedance TR8s (working demo)
- API - an example API
TR8 Protocol is permissionless. Anyone can create a drop/collection on any topic with any content. TR8 drops do NOT have to be vetted nor approved by a committee or company or organization or DAO. A side-effect of this permissionless nature is that content-filtering becomes the responsibility of front-ends, each of which can apply their own standards for curating content. TR8 Protocol envisions many different front-ends, some general in nature and others focused on specific applications like events, educational credentials, in-game assets, etc.
TR8 is composable through the structured data in the source attestations, and well as via optional hook contracts that issuers can deploy to tightly integrate TR8s into their own protocols and control who can claim their TR8s and what extras happen when they do.
The Superchain of OP Stack chains is the home for TR8 Protocol, currently deployed to Optimism, Base, and Zora (testnets).
All TR8 NFTs are cross-chain by nature and can currently be moved between Optimism, Base, and Zora, with more to follow. Cross-chain transportation provided by LayerZero general message passing (GMP).
At its core, TR8 protocol use EAS attestations as the base layer. There are two kinds of attestations that TR8 issuers and claimers make:
- "New Drop" Attestations. This is an attestation to create a new drop or collection, whether it be a badge for event attendance, an educational certificate, or something else. The attestation includes the structured data for the drop as well as lists of who can issue and/or claim the TR8s. When a new drop attestation is made, a dedicated NFT contract/collection is deployed for the drop. The collection is owned by the issuer enabling them to customize the collection's appearance on OpenSea and other marketplaces and directories. A drop can have an expiry date, a deadline for minting the TR8s in the drop. Drops can be configured as soulbound (non-transferable), or trade-able.
- Mint/Claim Attestations. These attestion can be made either by an issuer (admin) or a claimer. In both cases the
recipientof the attestation is the one who will receive the TR8, if eligible. Configured issuers for a drop can issue (mint) a TR8 to any address. Configured claimers can claim a TR8 for themselves (they are both theattesterand therecipientin these claim attestations). When these attestation are made, hooks are called if configured, enabling limitless composability and providing flexibility on gating who can and cannot claim TR8s in the drop (more on hooks below). Eligible recipients will receive a TR8 NFT for the Drop, adding to their onchain identity.
TR8 drops feature optional reserved namespaces, enabling issuing organizations to group their drops under a single namespace that is reserved for them.
While TR8 users interact primarily through making attestations to the EAS contract, there are several contracts deployed as part of TR8 protocol.
TR8.sol- The TR8 contract provides several functions. It acts an a EASSchemaResolver, hooks that get called when each attestation is made or revoked. When a minting/claiming attestation is made, theonAttest()hook triggers the minting of the TR8 to eigible attestation recipients. When a "new TR8 drop" attestation is made, the hook triggers the deployment of a dedicated NFT contract for the drop. In this way, the contract also acts as a Factory contract which minimally clones NFT contracts. The attestation includes NFT metadata and access permissions for issuers and claimers, stored onchain within the attestation and/or newly deployed contract. Finally, theTR8contract acts a registry for drops and keeps track of reserved nameSpaces for issuers.TR8Nft.sol- This is the implementation contract for TR8 NFTs. Each drop gets it own contract/collection which gets cloned from this contract. These NFTs are cross-chain NFTs that implement theERC721Transportableinterface to faciliate arrivals and departures.TR8Transporter.sol- Powered by LayerZero, this contract is a transport hub for many TR8 NFT contracts. One transporter is deployed per chain and all movement of NFTs move through them. If a transporter detects that a drop NFT contract has not yet been deployed on the destination chain, it calls out to theTR8contract on that chain to deploy, at the same address as the home chain.
TR8 Protocol is composable, and issuers can create their own TR8Hook contracts that get called each time a minting/claiming attestation is made. Hooks can add logic to allow/deny minting, integrate with third party protocols, and thousands of other things. Four example hook contracts were created and deployed:
TR8HookNFTClaimer.sol- This hook enables claiming of a TR8 only if the recipient is a current owner of an NFT from another collection. This could be used to issue TR8s to members of a DAO, or to reward NFT community members.TR8HookNeedEth.sol- This hook requires the the recipient has some amount of native token (ether). This could be used to limit hoarding/scamming of TR8 drops. One can imagine a similar contract that requires a certain balance of a specificERC20token.TR8HookFaucet.sol- This hook acts as faucet, sending tokens to eligible recipients. Note that when a hook is specified for a drop, it doesn't override the specified list of claimers who are allowed to mint/claim the TR8. Rather a hook can revert to prevent the issuance of the TR8 or add new addresses to the claimers list. In this example hook, it does neither, but will drip tokens only to those already eligible for the TR8.TR8HookStreamer.sol- This hook works similar to the faucet, by starts a real-time stream of tokens to the TR8 receipient, powered by the Superfluid protocol. One can imagine gaming applications that perform similar actions.
Note all equivalent contracts are deployed to the same address on each chain.
TR8Nftcontract:0x868F83D1c9349B6c7bA793A0D71Dfb66e60e01Ef: Optimism - Base - ZoraTR8contract:0xC3b0c31C16D341eb09aa3698964369D2b6744108: Optimism - Base - ZoraTR8Transportercontract:0x54C9935e58141cc5b1B4417bb478C7D25228Bfc0: Optimism - Base
Example hook contracts were deployed only to the "home chain", Optimism:
TR8HookFaucetcontract:0x6072fB0F43Bea837125a3B37B3CF04e76ddd3f19: OptimismTR8HookStreamercontract:0xFc3d67C7A95c1c051Db54608313Bd62E9Cd38A76: OptimismTR8HookNFTClaimercontract:0x9F570E88B5CDef206d2633aA3278ac5bceCd4cD8: OptimismTR8HookNeedEthcontract:0x4a62d7B300b505e44066E51B0b635ddb5044955d: Optimism
- Ethereum Attestation Service (EAS): EAS is the foundation upon which TR8 has been built. It is the base layer for TR8 Protocol. # # #
- Optimism: The home chain for TR8 protocol is Optimism, where all attestations and TR8 drops happen. TR8 Protocol is intended to be a permissionless public good. See OP deplyed addresses above. #
- Base: TR8 Protocol NFTs can be moved between OP Stack chain and has been deployed to Base. See Base deployed addresses above #
- Zora: TR8 Protocol NFTs can be moved between OP Stack chain and has been deployed to Zora. See Zora deployed addresses above #
- LayerZero. Cross-chain transportation of TR8s is provided by LayerZero General Message Passing (GMP) #
- Arbitrum: Another home chain for TR8 protocol, where all attestations and TR8 drops happen. TR8 Protocol is intended to be a permissionless public good. See Arb deployed addresses above. #
- Scroll: TR8 Protocol NFTs has been deployed to Scroll. See Scroll deployed addresses above #