API Reference

Every Kleros integration that involves jurors needs off-chain content: dispute templates that tell jurors what question to answer, evidence files that parties submit, and policy documents that define ruling criteria. All of this content is stored on IPFS and referenced on-chain by its CID. The Kleros IPFS gateway at cdn.kleros.link is the recommended gateway for uploading and serving this content.

Base URL

https://cdn.kleros.link

Endpoints

Upload to IPFS

Upload dispute templates, evidence files, and policy documents

Fetch from IPFS

Retrieve content by IPFS CID hash

Common content types

Content	Where it’s used	Schema
Dispute template JSON	`DisputeTemplateRegistry.setDisputeTemplate()`	Dispute Templates
Evidence file JSON	`EvidenceModule` - submitted by parties during a dispute	Evidence Format
Policy document JSON	`policyURI` field in dispute templates	Policy Format
Item attachment	Curate V2 item metadata	Column-based JSON schema

Uploading content - SDK

The @kleros/kleros-sdk wraps the gateway upload in a typed helper:

import { uploadToIPFS } from "@kleros/kleros-sdk";

const evidence = {
  name: "Transaction Screenshot",
  description: "Shows the buyer confirmed delivery on 2024-01-15.",
  fileURI: "/ipfs/QmImageHash...",
  evidenceType: "Image"
};

const { cids } = await uploadToIPFS(JSON.stringify(evidence));
const evidenceURI = cids[0]; // "/ipfs/Qm..."

Redundant pinning

Content uploaded to the Kleros gateway is pinned by Kleros infrastructure. For production integrations, also pin with a secondary provider so your content stays available if the Kleros gateway is temporarily unreachable:

// Example: pin with Pinata in addition to Kleros gateway
const pinataRes = await pinata.pinJSONToIPFS(evidence);
// Both pins point to the same CID

Unpinned IPFS content can disappear if no node is serving it. Always pin from at least two independent sources in production.

⌘I

Getting Started

V2 Architecture

Arbitrable Apps

Products

Cross-chain

Examples

Subgraph & Data

AI Tools

Base URL

Endpoints

Upload to IPFS

Fetch from IPFS

Common content types

Uploading content - SDK

Redundant pinning

​Base URL

​Endpoints

Upload to IPFS

Fetch from IPFS

​Common content types

​Uploading content - SDK

​Redundant pinning

Base URL

Endpoints

Common content types

Uploading content - SDK

Redundant pinning