haggle-protocol_skill

This skill enables AI agents to negotiate on-chain deals using haggle protocol across Base, Solana, and other testnets, ensuring fair, escrow-backed

Python

2.6k

GitHub Stars

2

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill openclaw/skills --skill haggle-protocol

_meta.json462 B
SKILL.md8.9 KB

Overview

This skill implements an on-chain negotiation protocol that lets autonomous AI agents create, negotiate, and settle deals using real USDC on Base Mainnet or test tokens on supported testnets. It provides turn-based, multi-round alternating offers with configurable escrow decay so agents discover fair prices through bargaining rather than fixed rates. The protocol supports escrow, settlement math, and tools for integration via MCP server, SDKs, or REST API.

How this skill works

A buyer deposits escrow into a protocol-controlled vault and invites a seller. The seller accepts and parties exchange alternating offers on-chain. Each round the escrow decays at a configurable rate, creating time pressure and narrowing acceptable offers. Either party can accept an offer to trigger settlement, which deducts protocol fees and releases funds according to on-chain rules.

When to use it

When an AI agent must buy or sell a service but a fixed price is unknown
To automate bilateral bargaining between autonomous agents with on-chain enforceability
When you need escrowed funds to prevent counterparty risk
For experiments with dynamic pricing, decay-driven incentives, or negotiation strategies
When integrating agents across Base Mainnet and supported testnets (Solana, Monad, Arbitrum)

Best practices

Use a dedicated wallet and load HAGGLE_PRIVATE_KEY only for agent operations
Test on Sepolia/Devnet or Monad testnet with mock tokens before mainnet
Approve the minimal token amount required for escrow, not unlimited allowances
Set reasonable maxRounds, decayRateBps, and responseWindow to balance speed and fairness
Monitor the agent wallet and rotate keys if you suspect compromise

Example use cases

Agent-to-agent purchase of a data analysis job where the buyer and seller negotiate price
Automated marketplace agents discovering fair prices for microservices with time-based pressure
Research on bargaining strategies: anchoring, gradual concessions, and decay-aware tactics
Integrating an agent fleet that negotiates per-task pricing and settles with USDC on Base
Simulated negotiation tournaments on testnets to tune decay and response parameters

FAQ

Deployed on Base Mainnet (USDC) and available on Solana Devnet, Monad Testnet, Base Sepolia, and Arbitrum Sepolia with mock tokens.

How is settlement calculated?

A 0.5% protocol fee is taken from the settled amount. Seller receives settledAmount - protocolFee and buyer is refunded effectiveEscrow - settledAmount.