curl -X POST https://api.verifyproceed.com/v1/acp/guard \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"bridge","chain":"base","amount_usd":50000}'

{
  "verdict": "proceed",
  "confidence": 0.95,
  "risk": "low",
  "expires_in": 300,
  "decision": {
    "action": "execute",
    "reason": "All safety checks passed."
  },
  "evidence": [...],
  "failure_modes": []
}

https://verifyproceed.com/get-api-key

# Returns HTTP 402 (expected) — proves the API is live
curl -X POST https://api.verifyproceed.com/v1/acp/guard \
  -H "Content-Type: application/json" \
  -d '{"action":"generic","chain":"base"}'

curl -X POST https://api.verifyproceed.com/v1/acp/guard \
  -H "Authorization: Bearer vp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"action":"generic","chain":"base"}'

# pip install requests
import requests

response = requests.post(
    "https://api.verifyproceed.com/v1/acp/guard",
    headers={
        "Authorization": "Bearer vp_your_key_here",
        "Content-Type": "application/json",
    },
    json={
        "action":     "bridge",
        "chain":      "base",
        "amount_usd": 50000,
    },
)

result = response.json()

if result["verdict"] == "proceed":
    execute_bridge()
else:
    print("Blocked:", result["decision"]["reason"])

const response = await fetch(
  "https://api.verifyproceed.com/v1/acp/guard",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.VP_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      action:     "swap",
      chain:      "base",
      amount_usd: 10000,
    }),
  }
);

const { verdict, decision } = await response.json();

if (verdict !== "proceed") {
  console.log("Blocked:", decision.reason);
  return;
}

// safe to execute

import type { Action, IAgentRuntime, Memory } from "@elizaos/core";

export const guardAction: Action = {
  name: "GUARD_CHECK",
  description: "Run VerifyProceed pre-execution safety check before any on-chain action",
  async handler(runtime: IAgentRuntime, message: Memory) {
    const res = await fetch(
      "https://api.verifyproceed.com/v1/acp/guard",
      {
        method: "POST",
        headers: {
          "Authorization": `Bearer ${process.env.VP_API_KEY}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          action:     message.content.action ?? "generic",
          chain:      "base",
          amount_usd: message.content.amount_usd ?? 0,
        }),
      }
    );

    const verdict = await res.json();

    if (verdict.verdict !== "proceed") {
      return { text: `Action blocked: ${verdict.decision.reason}` };
    }

    return { text: "Guard check passed — proceeding." };
  },
};

from langchain.tools import tool
import requests

@tool
def guard_check(action: str, chain: str = "base", amount_usd: float = 0) -> str:
    """Run a pre-execution safety check before any DeFi action."""
    response = requests.post(
        "https://api.verifyproceed.com/v1/acp/guard",
        headers={"Authorization": f"Bearer {VP_API_KEY}"},
        json={"action": action, "chain": chain, "amount_usd": amount_usd},
    )
    result = response.json()
    return f"verdict:{result['verdict']} confidence:{result['confidence']}"

{
  "action":               "swap | transfer | bridge | yield_deposit | generic",
  "chain":                "base | ethereum | arbitrum | optimism | polygon",
  "pair_address":         "0x... (optional — for DEX checks)",
  "stablecoin_asset_id":  "usd-coin (optional — for depeg checks)",
  "rpc_url":              "https://... (optional — overrides default RPC)",
  "bridge_status_url":    "https://... (optional — for bridge exploit check)",
  "amount_usd":           50000,
  "strict_mode":          true
}

{
  "verdict":      "proceed | wait | block",
  "confidence":   0.95,
  "risk":         "low | medium | high",
  "expires_in":   300,
  "decision": {
    "action":     "execute | retry | halt",
    "reason":     "All safety checks passed.",
    "constraints": {}
  },
  "evidence":     [...],
  "failure_modes": []
}

POST /v1/acp/guard  (no key)
← HTTP 402 + payment challenge
→ Agent pays $0.01 USDC on Base
→ Retry with X-PAYMENT header
← HTTP 200 + verdict

git clone https://github.com/verifyproceed/verifyproceed.git
cd verifyproceed

pip install -r requirements.txt

cp .env.example .env
# Edit .env with your keys

uvicorn app:app --reload --port 8000

docker build -t verifyproceed-guard .
docker run -p 8000:8000 --env-file .env verifyproceed-guard