Introduction

QRToken is a framework for issuing verifiable token-of-truth series: an upgradeable ERC-1155 contract, a Hardhat CLI, and an IPFS/Filebase metadata pipeline that together let you attach on-chain, independently verifiable claims to a physical or digital asset.

The model

A series is a set of tokens sharing one metadata folder on IPFS. The lifecycle an issuer runs is:

1. Deploy your own contracts (an upgradeable Series1155V1 behind a UUPS proxy, plus a SeriesActivation holding contract).
2. Create a series pointing at a metadata CID on IPFS.
3. Mint tokens into the series.
4. Register holders — the tokens are held by the activation contract until claimed.
5. Activate — the owner signs a message and SeriesActivation verifies the ECDSA signature, transferring possession to them.
6. Verify — anyone can independently confirm each claim by its source.

Trust model: provenance by source

Every displayed value carries where it came from:

• ON-CHAIN — read directly from the blockchain at a pinned block. The contract is the source of truth.
• METADATA — everything fetched from IPFS (the series JSON and media).

The point of the framework is that a recipient never has to trust a website: on-chain values are read from the chain, metadata values resolve from IPFS by CID, and the two can be checked against each other.

Ready to stand up your own series? Head to Getting Started for the end-to-end golden path.