# Introduction

Details of processes, products and contributions are often stored in siloes, therefore not available for stakeholders when they would need it, while waste and ineffective resources reducing sustainability.

## The challenges we solve

* **Counterfeit Prevention and Product Safety**: Counterfeiting and false product information are significant issues in global supply chains, leading to financial losses, safety hazards, and reputational damage. Our system will provide verified ownership and quality assurance, reducing risks and ensuring consumer safety.
* **Transparency in Provenance and ESG Reporting**: Consumers and regulators increasingly demand transparency regarding product origins and environmental impact. Our solution will allow companies to accurately track and report the provenance of products and the authenticity of environmental and social impact claims, thereby fostering trust and compliance.
* **Resource Optimization and Responsibility Attribution**: By providing clear visibility into the supply chain and ensuring responsible sourcing, our system will help companies optimize their use of resources, reduce waste, and identify the responsible parties for any discrepancies or issues that arise.

## Our solution

We foster a new paradigm in value chains:

* one where data is not just available, but actionable;
* where waste is not just minimized, but transformed into value;
* and where contributions are not just recognized, but rewarded fairly and transparently.

Therefore, we designed an universal traceability standard, store it on on an unbiased, future-proof common database (on permissionless blockchains), estimate its ecological footprint, and represent each subject as ownable NFTs to eliminate cheating with quantities.

* Single Source of Truth: Storing semantic statements securely on p2p hash storage allows it to be referenced as a single source of truth. Stakeholders can build a comprehensive and interoperable knowledge graph.
* NFT Metadata for Quality Attributes: Complex and detailed quality attributes of Real-World Assets can be made available and challengeable as NFT metadata.
* New Paradigm for Stakeholders: Apps leveraging this system can provide enhanced transparency, traceability, and trust, benefiting all stakeholders involved.

In short, our protocol records immutably how things evolve infinitely, by contributions such as:

* materials (products)
* time (services)
* knowledge (licenses)

## Our system is most ideal for:

* businesses (producers, resellers) dealing with **quality-made** products and **sustainable** practices (anti greenwashing and counterfeiting, expounded pricing), especially in most impactful verticals like:
  * Food and Agri
  * Construction
  * ..and where Digital Product Passports will soon be mandatory in the EU:
    * Minerals {Aluminum, Iron and Steel, Electronics, Jewellery}
    * Textiles (in part. garments & footwear)
    * Furniture, including mattresses&#x20;
    * Chemicals, Detergents, Paints, Lubricants, Tyres
    * Energy related products
* "get % from revenue" feature:
  * upstream producers (Fair-Trade)
  * inventors and developers
  * providers with spare machine / HR capacity or excess inventory (soon expiring products)

## Benefits

Using our tools can not only verify, but also increase your sustainability:

1. **Economic Impact**: The system will reduce losses from counterfeiting and false information, increase efficiency in resource use, and open up new revenue streams through dynamic pricing and better utilization of spare capacities. This will lead to increased profitability for companies using the system.
2. **Environmental Impact**: By enabling accurate tracking and reporting of environmental impacts, the system will promote more sustainable practices across supply chains. It will encourage companies to reduce their carbon footprint and improve resource efficiency, contributing to global sustainability goals.
3. **Societal Impact**: The enhanced transparency and accountability will improve consumer trust, ensuring that people have access to safe, high-quality products with verified origins. The system will also support fair trade practices and ethical sourcing, benefiting communities involved in the production process.

Detailed benefits:

* Visualized Insight Pages about brand reputation and NFT meta
* Locality Verification
* Clear Responsibility Attribution
* Verified Ownership (Quality and Waste)
* Authentic ESG Scoring Inputs
* Open License Accounting
* Utilize Spare Capacities and Inventories
* Foster short supply chains
* Ensured Quality and Safety of Built-in Components
* Dynamic pricing based on product quality rating


# Our Peer-to-Peer Advantages

We represent the Decentralized Nature, in which Society and Economy is embedded.

If all stakeholders state mainly what they have direct knowledge (and proof) about, then misinformation and pointing fingers at each other can be prevented.

As things evolve, these information chunks reference each other, so the right information can still be always available, with improved accuracy.

This shared knowledge graph should be stored on a [decentralized infrastructure](https://www.ethswarm.org/), because

1. should be available to every stakeholder, to be used as the Single Source of Truth, therefore keep it updated
   1. at the same time, we provide unrivalled privacy for encrypted attributes: you can set conditions who should be able to decrypt (like current owners or license holders)
2. nobody should be able to censor or delete it
   1. ..not even "system admins" or shareholders of the provider
   2. once uploaded, our data is available as long as its "postage stamp" is funded
3. nobody should be able to manipulate it
   1. even adding a space or modifying any character alters its *keccak* hash, which is used for retrieval
4. and of course, protection from electromagnetic pulses, physical damages, single point of failure, hacking attacks, etc.

## Trustless? Sure, you can verify!

### Is the uploaded data unaltered?

On DevTools' Network tab, check the underlying API call's Response. Use its `swarmReference` attribute to match the data in any Swarm Gateway (an *official* is <https://gateway.ethswarm.org/access> ).

### Are the right attributes linked to my NFT listing?

Check in a block explorer, like the open-source [Blockscout](https://gnosis-chiado.blockscout.com/token/0x1162813F9e8946196f3302E33D485F4f81e970e6). Find the minting transaction, check *swarmHash* (arg 2) in its input data. [Convert that uint32 to hex/Bytes32 format](https://uint256.net/docs/converter), copy it after 0x and use for retrieval from any Swarm Gateway.

### Are the right attributes loaded into our insights?

Combine the above methods! On DevTools' Network tab, compare what we GET from our Swarm node with the *tokenId* and *swarmHash* on a Blockchain explorer.


# Brand Pages

See information related to (submitter's email) domain names in our system, like:

* their published products, services and knowhow
* platform usage and reputation
  * the timeline supports quick overview via recorded input and output quantity relation
* soon:
  * aggregated metrics (eco footprints and values saved)
  * insight charts (e.g. nutrient values delivered)


# Packaging Pages

See Digital Product Passport, including

* environmental footprints (air pollution as carbon equivalent, water footprint)
* geographic provenance of components and processing steps
* a graph / tree of every known components' details
* if food:
  * ingredients, their bio authenticity
  * nutrient values, their relation to Daily Recommended Inputs


# Record

Required fields:

* [ ] type (used as item name)
* [ ] description or external ID (if details are in other databases)
* [ ] ownerId (domain of provider)
* [ ] (expiry)date
* [ ] price (currency should be a trustable stablecoin on Gnosis/Chiado chain)

## Add a service timeslot

Add expirydate (and time) and the duration before that

## Record know-how

Set up the process with input and output product `IDs` (like Food Data Central IDs or HS duty codes), insert text or attachment URL to `description` and set `category` as KnowHow.

## Record a production step

Add output product's parameters, set `process` type, input instances (ingredients, machines, know-how), impacts, coordinates, temperature, etc.

### Mark geo source of ingredients

When adding process InputInstance, select Transported instead of Local.


# Sync with internal systems

You can record any update without manual work, once the API integration is configured with your ERP or other software that knows what you do.

Integration is simple, but we can even help in that.

Base URL: <https://api.trace.market>

## Mint NFT with a new record

<mark style="color:green;">`POST`</mark> `/mint`

Call this endpoint to publish new service capacity or product instances.

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `Bearer <token>`   |

**Body**

| Name      | Type        | Description                                                                                   |
| --------- | ----------- | --------------------------------------------------------------------------------------------- |
| `to`      | EVM address | The owner wallet of the NFT, should be yours                                                  |
| `content` | json        | The actualized JSON from the template you can copy from [Record](/for-providers/record) page. |

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "message": "NFT minted successfully!",
    "tokenId": "0xafad2547ea3a4e18e86638b6b72120f55889f97c65699d54af735ac60f729f25",
    "swarmReference": "8a9486899faa8bb0b4f9256cc276b6fbe738c0ab9c2b55c490bbb8fc6a1f0c1e"
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "Invalid request"
}
```

{% endtab %}
{% endtabs %}


# Marketplace (buy & sell)

## Publish as Listing

When the product's or service slot's details are available in a supported schema, you can mark them as publicly buyable on our List page. After you sign the message, an NFT is minted which can be bought by anyone for the set price, which you'll receive to your connected wallet.

Soon, you'll able to define self-enforcing usage and resell rights.

## Buy on a verified way

Go to our Use page, select the right listing (ensure you have required funds) and Sign the NFT purchase transaction.

## Sell to user outside the system

As the current owner of the NFT, you are free to send it to any address from your web3 wallet, like MetaMask.


