AGENTESCROW
Whitepaper & Documentation

// Deploy with Hardhat / Foundry
// 1. Install dependencies
npm install --save-dev hardhat @openzeppelin/contracts

// 2. Compile
npx hardhat compile

// 3. Deploy to Sepolia testnet
npx hardhat run scripts/deploy.js --network sepolia

// foundry alternative:
forge create --rpc-url $SEPOLIA_RPC \
  --private-key $PRIVATE_KEY \
  src/AgentEscrow8183.sol:AgentEscrow8183

import { createPublicClient, createWalletClient, http } from 'viem';
import { sepolia } from 'viem/chains';
import { ESCROW_ABI } from './abi';

const CONTRACT = '0xYourDeployedContractAddress';

// 1. Create a job (client side)
const jobId = await walletClient.writeContract({
  address: CONTRACT,
  abi: ESCROW_ABI,
  functionName: 'createJob',
  args: [
    providerAddress,   // address provider
    evaluatorAddress,  // address evaluator
    tokenAddress,      // address(0) for ETH
    parseEther('1.0'), // uint256 amount
    BigInt(Math.floor(Date.now() / 1000) + 86400 * 7), // 7 days expiry
  ],
});

// 2. Fund the job (client sends ETH)
await walletClient.writeContract({
  address: CONTRACT,
  abi: ESCROW_ABI,
  functionName: 'fundJob',
  args: [jobId],
  value: parseEther('1.0'),
});

// 3. Provider submits work
const deliverableHash = keccak256(toHex('ipfs://QmYourDeliverable'));
await walletClient.writeContract({
  address: CONTRACT,
  abi: ESCROW_ABI,
  functionName: 'submitWork',
  args: [jobId, deliverableHash],
});

// 4. Evaluator approves → funds released to provider
await walletClient.writeContract({
  address: CONTRACT,
  abi: ESCROW_ABI,
  functionName: 'completeJob',
  args: [jobId],
});

// AI Agent integration example (TypeScript)
import OpenAI from 'openai';

const tools = [
  {
    type: 'function',
    function: {
      name: 'create_escrow_job',
      description: 'Create a new escrow job on ERC-8183 protocol',
      parameters: {
        type: 'object',
        properties: {
          provider: { type: 'string', description: 'Provider wallet address' },
          evaluator: { type: 'string', description: 'Evaluator wallet address' },
          amount: { type: 'string', description: 'Payment amount in ETH' },
          description: { type: 'string', description: 'Job description' },
        },
        required: ['provider', 'evaluator', 'amount'],
      },
    },
  },
];

// Agent autonomously creates and manages escrow jobs
const response = await openai.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Hire an AI agent to write a smart contract audit report' }],
  tools,
  tool_choice: 'auto',
});