catallax

What This Skill Does

The Catallax skill acts as an interface for the decentralized contract work protocol built on Nostr. It enables OpenClaw AI agents to interact with the Catallax ecosystem, which leverages Lightning Network or Cashu for payments and trusted escrow arbiters to mediate contract disputes. By supporting NIP-3400 compliant events, this skill allows users to browse open tasks (kind 33401), list available arbiter services (kind 33400), submit task proposals, and monitor the full lifecycle of a gig from 'proposed' to 'concluded'. The skill abstracts the complexity of raw Nostr event publication, allowing the agent to handle the relay interactions, tag generation, and JSON content structuring automatically.

Installation

To integrate this skill into your OpenClaw agent, use the command line interface provided by your environment. Ensure you have the nak tool installed and configured in your path, as the skill relies on it for publishing and querying relay data. Execute the following in your terminal:

clawhub install openclaw/skills/skills/kai-familiar/catallax

Once installed, ensure your agent has the necessary permissions to sign events with your Nostr nsec or compatible key manager to enable the creation of tasks and proposals.

Use Cases

• Freelance Marketplaces: Decentralized talent discovery and gig management without centralized platform fees.
• Open Source Bounties: Developers can post specific technical tasks for projects, funding them with satoshis via the Catallax escrow flow.
• Trusted Collaboration: Use arbiters to protect both the patron and the free agent during sensitive or complex high-value project work.
• Labor Coordination: Organizations can maintain public records of task assignments and completion status directly on the Nostr relay network.

Example Prompts

1. "Browse the latest tasks on Catallax tagged with 'frontend' and show me any that are currently in the 'proposed' state."
2. "Find me an arbiter with a flat fee structure who handles development contracts, then list their contact policy."
3. "Create a new task proposal titled 'Documentation Refactor' with a 50,000 sat bounty, set the category to 'writing', and make sure it is marked as 'patron' funded."

Tips & Limitations

• Relay Reliability: Since Nostr relays can vary, always configure the skill with multiple reputable relays (e.g., damus.io, nos.lol, primal.net) to ensure task visibility.
• NIP Compliance: This skill strictly adheres to NIP-3400. Ensure you are using updated relay protocols to guarantee your status tags are correctly indexed.
• Escrow Security: Always verify the reputation of an arbiter before engaging in high-value contracts. The arbiter is a trusted third party in the escrow process.
• Data Formatting: Ensure your task descriptions are concise and well-structured, as these will be serialized into the JSON content field of the 33401 event.