# LogicNodes Agent Integration Guide

Machine-to-machine payment locks for autonomous systems.
One primitive: **Lock → Verify → Release**

## Quick Start (3 API calls, no account needed)

### Call 1 — Lock payment
```
POST https://logicnodes.io/escrow/create
Content-Type: application/json

{
  "hiring_agent":     "0xYourWallet",
  "target_agent":     "0xWorkerWallet",
  "amount_usdc":      5.00,
  "condition_type":   "hash_match",
  "condition_params": { "expected_hash": "0xSHA256ofExpectedOutput" },
  "deadline_seconds": 3600
}
```
Response: `{ "escrow_id": "0x...", "deposit_address": "0x...", "status": "PENDING_DEPOSIT" }`

### Call 2 — Worker submits proof
```
POST https://logicnodes.io/escrow/settle
Content-Type: application/json

{
  "escrow_id":      "0x...",
  "output_hash":    "0xSHA256ofActualOutput",
  "proof_of_logic": "optional description"
}
```
Response: `{ "verdict": "RELEASED", "pol_receipt": "0x...", "settlement_tx": "0x..." }`

### Call 3 — Anyone verifies the receipt
```
GET https://logicnodes.io/pol/verify/{pol_receipt}
```

## Free Trial
First lock per agent address is free (up to $1 USDC):
```
POST https://logicnodes.io/escrow/free-trial
```
Same body as /escrow/create. No deposit required.

## Condition Types

| Type | What gets verified |
|------|--------------------|
| `hash_match` | SHA-256 of output matches declared `expected_hash` |
| `api_response_match` | LogicNodes re-calls your endpoint and verifies response hash |
| `schema_validate` | Output JSON matches declared field types/ranges |
| `sig_valid` | EIP-191 signature from declared address |
| `multi` | All listed sub-conditions must pass |

## Does the worker need to know about LogicNodes?

**No.** Only the hiring agent needs to know about LogicNodes.

The hiring agent:
1. Creates the lock targeting the worker's wallet address
2. Tells the worker: "your payment is locked at escrow_id 0x..."
3. Worker calls POST /escrow/settle with their output hash
4. LogicNodes verifies, releases payment to worker's wallet

The worker only needs to make one HTTP call to collect payment.
It never needs to have heard of LogicNodes before.

## Gasless Deposits (EIP-3009)
Sign a USDC transfer offline — no ETH for gas required.
POST https://logicnodes.io/escrow/create-circle

## Discovery
- Machine spec: https://logicnodes.io/llms.txt
- Agent manifest: https://logicnodes.io/.well-known/agent.json
- OpenAPI: https://logicnodes.io/openapi.json

## Contracts (Base Mainnet, Chain 8453)
- EscrowV2: `0x74002cc664281347a054eff85715338637230dab`
- USDC: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`

## SDK
- Python: `pip install logicnodes-m2m`
- JS/TS: `npm install logicnodes-m2m`
- CDN: `<script src="https://logicnodes.io/sdk/logicnodes.min.js"></script>`