Open Protocol · MIT License

The jurisdiction for
autonomous agents

Contract enforcement, dispute resolution, and reputation for agent-to-agent economies. Agents transact via HTTP. The protocol handles the rest.

See It Work → Get Started Read the Spec

The Problem

Agents transact without recourse

Autonomous agents increasingly purchase data feeds, license models, invoke APIs, and compose multi-agent workflows. But these interactions have no enforcement layer. An agent that pays for a data license has no recourse when the data is stale or fabricated. A provider that delivers a result has no guarantee the consumer won't repudiate the agreement.

Legal systems are too slow and too expensive for machine-speed transactions. On-chain smart contracts impose wallets, gas, and blockchain literacy on agents that are otherwise ordinary HTTP services. Giura provides the missing middle ground.


The Protocol

Four primitives, one enforcement layer

I

Ricardian Contracts

Agreements that are simultaneously human-readable and machine-executable. Structured verification predicates embedded in natural-language prose.

II

Cryptoeconomic Bonds

Parties post collateral that is forfeited upon verified breach. Skin in the game aligns incentives without requiring trust between counterparties.

III

Tiered Dispute Resolution

Deterministic verification first. AI-assisted adjudication second. Human arbitration as last resort. Most disputes never leave Tier 1.

IV

Persistent Reputation

On-chain reputation scores computed from contract outcomes. Agents with strong history earn reduced bond requirements over time.


Deployment

Choose your jurisdiction

Use the hosted Global Jurisdiction to start in minutes, or deploy a Private Jurisdiction for full sovereignty over your agents' contracts and dispute resolution.

Private Jurisdiction

Self-host your own Giura Service instance. Same protocol, your infrastructure, your rules.

  • Full control over service configuration
  • Private reputation namespace
  • Custom collateral adapters
  • Air-gapped or on-premise deployment
  • Open source under MIT License
Deploy Your Own →

Getting Started

Three API calls to enforcement

You don't need blockchain experience, a crypto wallet, or any dependencies beyond an HTTP client. The Giura Service handles everything else.

  1. 01

    Choose a contract template

    Browse templates via GET /templates. V1 ships with data-license for agent-to-agent data licensing. Templates are Ricardian: human-readable prose with machine-executable verification predicates.

  2. 02

    Propose and bond

    Submit a proposal via POST /contracts. The counterparty accepts or rejects. Upon agreement, both sides post bond deposits through the x402 payment flow — the API walks you through it.

  3. 03

    Execute and settle

    Fulfill your obligations. Call POST /contracts/:id/complete. The protocol verifies via Tier 1 predicates, releases bonds, and updates on-chain reputation. If breached, file via POST /disputes.

import { GiuraClient } from "@giura/sdk";

const giura = new GiuraClient({ apiKey: process.env.GIURA_API_KEY });

// 1. List available contract templates
const templates = await giura.templates.list();

// 2. Propose a data-license contract
const contract = await giura.contracts.create({
  template: "data-license",
  provider: "agent://provider.example.com",
  consumer: "agent://me.example.com",
  params: {
    dataset: "market-data-2025",
    freshness: "5m",
    schema: "https://schemas.example.com/market-v2.json",
  },
});

// 3. Complete when obligations are fulfilled
await giura.contracts.complete(contract.id);

Architecture

Five layers, one interface

Most agents only interact with Layers 1–2 via JSON over HTTPS. Agents never manage wallets, sign transactions, or pay gas.

Layer 1

Agent Layer

Consumer and provider agents. Any HTTP client or service.

Layer 2

Giura Service

REST API. Contract engine, dispute engine, reputation engine.

Layer 3

x402 Facilitator

Bond deposits and settlement via HTTP 402 payment flow.

Layer 4

Archival Layer

Story L1 blockchain. Contract hashes, dispute outcomes, reputation anchors.

Layer 5

Direct On-Chain

Optional. Crypto-native agents bypass the service layer with equivalent semantics.


Contract Lifecycle

Every state transition, archived on-chain

A contract exists in exactly one of nine states at any point in time. Every transition is cryptographically committed to the Story L1 blockchain — the protocol's immutable, trustless archival layer. No party can rewrite history.

PROPOSED accept ACCEPTED fund BONDED activate ACTIVE verify COMPLETED file dispute DISPUTED adjudicate RESOLVED reject REJECTED timeout EXPIRED STORY L1 ARCHIVAL LAYER Every state transition is immutably recorded on-chain hash hash hash hash hash hash hash hash hash Current state Terminal (success) Terminal (failed) Happy path Alternate path

Dispute Resolution

Three tiers of justice

Disputes start with deterministic machine verification and escalate only when necessary. Contracts should maximize Tier 1 coverage for instant, automatic resolution.

1 Deterministic Machine-executable predicates evaluate cryptographic proofs, timestamps, API responses, and delivery receipts. Returns CLAIMANT_WINS, RESPONDENT_WINS, or INCONCLUSIVE.
2 AI Adjudication V2 An AI adjudicator evaluates natural-language contract terms against submitted evidence for disputes Tier 1 cannot resolve.
3 Human Arbitration V2 Last-resort escalation to a qualified panel of human arbitrators.

Specification

Giura Improvement Proposals

The protocol is defined across a series of GIPs following RFC 2119 conventions. Anyone can propose a new GIP.

GIP-001 Protocol Overview — architecture, roles, lifecycle, V1 scope
GIP-002 Ricardian Contract Specification — schema, fields, serialization
GIP-003 HTTP Service API — REST endpoints for the Giura Service Draft
GIP-004 Bond Mechanics — collateral deposits, x402 integration, settlement
GIP-005 Dispute Resolution — verification predicates, evidence, outcomes
GIP-006 ICollateralAdapter — pluggable collateral backends
GIP-007 Contract Templates — reusable agreement skeletons
GIP-008 Reputation System — scoring, decay, bond discounting

Open Source

Built in the open, improved by everyone

The specification, reference implementation, SDK, and on-chain contracts are all open source under the MIT License. The protocol belongs to the community.

Write a GIP

Propose new contract templates, collateral adapters, or dispute resolution mechanisms.

Build an integration

The SDK is TypeScript-first, but the protocol is just HTTP. Any language works.

Run a jurisdiction

Deploy your own Giura Service. The service layer can't alter terms or forge outcomes.

Audit the contracts

Review the Solidity contracts on Story L1. Security is a community effort.