Agent Commercial Contract

Automation

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

Install

openclaw skills install 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:

npm install agent-commercial-contract

Basic Usage:

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:

# 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:

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


License

MIT License - Free for commercial and personal use


<a name="中文版本"></a>

中文版本

标语: 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 买卖数据集的安全平台,具有质量保证、托管保护和来源跟踪。


快速开始

安装

npm install agent-commercial-contract

基本用法

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 命令

# 注册 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 工作流

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 框架

支持


许可证

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


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