Agent Commercial Contract

Enables AI agents to autonomously negotiate, sign, execute, and enforce legally binding commercial contracts with escrow, milestone payments, and dispute res...

Justin Liu@zhenstaff

Install

openclaw skills install @zhenstaff/agent-commercial-contract

Agent Commercial Contract

English | 中文

English Version

Tagline: The Legal Layer for Agent-to-Agent Commerce

Category: Automation / Legal Tech

Version: 1.0.0

What is it?

Agent Commercial Contract is a comprehensive smart contract framework that enables AI agents to autonomously negotiate, sign, execute, and enforce commercial agreements. It provides the legal and financial infrastructure necessary for agent-to-agent commerce.

Core Capabilities

Contract Management

Create legally-binding contracts from templates or custom terms
Multi-party digital signatures with cryptographic verification
Automated contract lifecycle (draft → signed → active → completed)
Milestone-based execution with deliverable tracking
Full audit trail of all contract events

Agent Identity & Authentication

Cryptographic identity system with public/private key pairs
Digital signature generation and verification
API key-based authentication
Capability-based access control

Escrow & Payment

Automated payment holding in secure escrow accounts
Milestone-based fund release mechanisms
Refund and dispute handling
Multi-currency support
Complete transaction history

Dispute Resolution

Structured dispute raising with evidence submission
Arbitrator assignment (human or AI)
Evidence verification with cryptographic hashing
Automated compensation calculation
Resolution enforcement

When to Use This Skill

AI Agent Marketplaces Build marketplaces where AI agents can buy and sell services with automatic contract enforcement.

Multi-Agent Collaboration Enable multiple agents to work together on projects with clear terms, milestone-based payments, and automated conflict resolution.

API-as-a-Service Networks Create networks where agents monetize their APIs with usage tracking, billing automation, and SLA enforcement.

Data Exchange Platforms Build secure platforms for agents to buy/sell datasets with quality guarantees, escrow protection, and provenance tracking.

Quick Start

Installation:

bash

npm install agent-commercial-contract

Basic Usage:

typescript

import AgentCommercialContract from 'agent-commercial-contract';

const sdk = new AgentCommercialContract();

// Register agents
const provider = await sdk.identity.registerAgent('Provider AI', ['data-processing']);
const consumer = await sdk.identity.registerAgent('Consumer AI', ['analytics']);

// Create contract with escrow
const result = await sdk.createContractWithEscrow(
  provider.data.identity,
  consumer.data.identity,
  {
    title: 'Data Processing Service',
    service: { type: 'data-processing', specification: '...' },
    payment: { amount: 5000, currency: 'USD', structure: 'milestone' },
    timeline: { duration: 30 },
  }
);

CLI Commands:

bash

# Register agent
agent-contract agent register --name "My Agent" --capabilities "data-processing"

# Create contract
agent-contract contract create \
  --provider agent_xxx \
  --consumer agent_yyy \
  --title "Service Agreement" \
  --amount 1000 \
  --with-escrow

# View dashboard
agent-contract dashboard --agent agent_xxx

Integration with AI Agents

Autonomous Agent Workflow:

typescript

class AutonomousAgent {
  constructor(private sdk: AgentCommercialContract) {}

  async offerService() {
    await this.sdk.identity.registerAgent('My Service Bot', ['data-processing']);
  }

  async acceptContract(contractId: string) {
    const contract = this.sdk.contracts.getContract(contractId);
    if (this.canFulfill(contract)) {
      const signature = this.generateSignature(contract);
      await this.sdk.contracts.signContract({
        contractId,
        agentId: this.agentId,
        signature,
        credentials: this.credentials,
      });
    }
  }

  async deliverWork(contractId: string, milestoneId: string) {
    await this.sdk.completeMilestoneAndPay(contractId, milestoneId, this.agentId);
  }
}

Security & Best Practices

Cryptographic Security:

RSA 2048-bit keys for digital signatures
SHA-256 hashing for evidence integrity
Secure key storage recommendations
API key rotation support

Legal Enforceability:

Digital signatures legally binding
Jurisdiction specification in contracts
Audit trails for compliance
Dispute resolution mechanisms

Best Practices:

Never commit private keys to version control
Use environment variables for sensitive data
Implement key rotation policies
Maintain comprehensive audit logs
Test contracts in staging environment first

API Reference

ContractManager:

createContract() - Create new contract
signContract() - Sign with digital signature
activateContract() - Activate signed contract
completeContract() - Mark as completed

EscrowManager:

createEscrow() - Create escrow account
deposit() - Deposit funds
release() - Release payment
refund() - Process refund

DisputeManager:

raiseDispute() - Raise dispute
submitEvidence() - Submit evidence
resolveDispute() - Resolve with ruling

Dependencies

TypeScript: Type-safe development
nanoid: Unique ID generation
better-sqlite3: Local contract storage (optional)
jsonwebtoken: JWT authentication
chalk: CLI output formatting
commander: CLI framework

Support

GitHub: https://github.com/ZhenRobotics/agent-commercial-contract
Documentation: Full API docs and guides
Issues: Bug reports and feature requests

License

MIT License - Free for commercial and personal use

中文版本

标语: AI Agent 商业交易的法律层

分类: 自动化 / 法律科技

版本: 1.0.0

这是什么？

Agent Commercial Contract 是一个综合性智能合约框架，使 AI Agent 能够自主协商、签署、执行和强制执行商业协议。它为 Agent 之间的商业交易提供必要的法律和金融基础设施。

核心能力

合同管理

从模板或自定义条款创建具有法律约束力的合同
带加密验证的多方数字签名
自动化合同生命周期（草稿 → 已签署 → 活跃 → 完成）
基于里程碑的执行与可交付成果跟踪
所有合同事件的完整审计追踪

Agent 身份与认证

具有公钥/私钥对的加密身份系统
数字签名生成和验证
基于 API 密钥的认证
基于能力的访问控制

托管与支付

在安全托管账户中自动保管付款
基于里程碑的资金释放机制
退款和纠纷处理
多币种支持
完整的交易历史

纠纷解决

结构化的纠纷提出与证据提交
仲裁员分配（人工或 AI）
使用加密哈希的证据验证
自动补偿计算
决议执行

何时使用此 Skill

AI Agent 市场 构建 AI Agent 可以买卖服务的市场，具有自动合同执行功能。

多 Agent 协作 使多个 Agent 能够在项目上协作，具有明确的条款、基于里程碑的付款和自动冲突解决。

API 即服务网络 创建 Agent 将其 API 货币化的网络，具有使用跟踪、自动计费和 SLA 执行。

数据交换平台 构建 Agent 买卖数据集的安全平台，具有质量保证、托管保护和来源跟踪。

快速开始

安装：

bash

npm install agent-commercial-contract

基本用法：

typescript

import AgentCommercialContract from 'agent-commercial-contract';

const sdk = new AgentCommercialContract();

// 注册 Agent
const provider = await sdk.identity.registerAgent('提供者 AI', ['数据处理']);
const consumer = await sdk.identity.registerAgent('消费者 AI', ['分析']);

// 创建带托管的合同
const result = await sdk.createContractWithEscrow(
  provider.data.identity,
  consumer.data.identity,
  {
    title: '数据处理服务',
    service: { type: 'data-processing', specification: '...' },
    payment: { amount: 5000, currency: 'USD', structure: 'milestone' },
    timeline: { duration: 30 },
  }
);

CLI 命令：

bash

# 注册 Agent
agent-contract agent register --name "我的 Agent" --capabilities "data-processing"

# 创建合同
agent-contract contract create \
  --provider agent_xxx \
  --consumer agent_yyy \
  --title "服务协议" \
  --amount 1000 \
  --with-escrow

# 查看仪表板
agent-contract dashboard --agent agent_xxx

与 AI Agent 集成

自主 Agent 工作流：

typescript

class AutonomousAgent {
  constructor(private sdk: AgentCommercialContract) {}

  async offerService() {
    await this.sdk.identity.registerAgent('我的服务机器人', ['数据处理']);
  }

  async acceptContract(contractId: string) {
    const contract = this.sdk.contracts.getContract(contractId);
    if (this.canFulfill(contract)) {
      const signature = this.generateSignature(contract);
      await this.sdk.contracts.signContract({
        contractId,
        agentId: this.agentId,
        signature,
        credentials: this.credentials,
      });
    }
  }

  async deliverWork(contractId: string, milestoneId: string) {
    await this.sdk.completeMilestoneAndPay(contractId, milestoneId, this.agentId);
  }
}

安全性与最佳实践

加密安全：

用于数字签名的 RSA 2048 位密钥
用于证据完整性的 SHA-256 哈希
安全密钥存储建议
API 密钥轮换支持

法律可执行性：

数字签名具有法律约束力
合同中的司法管辖区规范
用于合规的审计追踪
纠纷解决机制

最佳实践：

切勿将私钥提交到版本控制
使用环境变量存储敏感数据
实施密钥轮换策略
维护全面的审计日志
先在测试环境中测试合同

API 参考

ContractManager（合同管理器）：

createContract() - 创建新合同
signContract() - 使用数字签名签署
activateContract() - 激活已签署的合同
completeContract() - 标记为已完成

EscrowManager（托管管理器）：

createEscrow() - 创建托管账户
deposit() - 存入资金
release() - 释放付款
refund() - 处理退款

DisputeManager（纠纷管理器）：

raiseDispute() - 提出纠纷
submitEvidence() - 提交证据
resolveDispute() - 以裁决解决

依赖项

TypeScript：类型安全开发
nanoid：唯一 ID 生成
better-sqlite3：本地合同存储（可选）
jsonwebtoken：JWT 认证
chalk：CLI 输出格式化
commander：CLI 框架

支持

GitHub: https://github.com/ZhenRobotics/agent-commercial-contract
文档: 完整的 API 文档和指南
问题: 错误报告和功能请求

许可证

MIT 许可证 - 可免费用于商业和个人用途

为 AI Agent 提供法律和金融自主权 🤖⚖️