Pre-payment economic and structural preflight for an external Base USDC counterp

Pre-payment economic and structural preflight for an external Base USDC counterparty: check endpoint reachability, payment terms, recipient format, caller budget, and economic ceiling before any external payment is made. $0.025 USDC per call on Base.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://api.avedaris.com/v1/paid/counterparty-preflight

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "endpoint": "https://seller.example/v1/paid/task",
    "maxEconomicallyRationalSpendUsd": 0.02,
    "maxSpendUsd": 0.05,
    "outcomeValueUsd": 0.1,
    "paymentRequirement": {
      "amountUsd": 0.01,
      "asset": "USDC",
      "network": "eip155:8453",
      "payTo": "0x1111111111111111111111111111111111111111"
    }
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "additionalProperties": false,
          "properties": {
            "endpoint": {
              "description": "Public HTTP(S) seller endpoint to preflight.",
              "maxLength": 8192,
              "minLength": 8,
              "type": "string"
            },
            "maxEconomicallyRationalSpendUsd": {
              "description": "Optional caller economic ceiling; defaults to maxSpendUsd.",
              "exclusiveMinimum": 0,
              "type": "number"
            },
            "maxSpendUsd": {
              "description": "Caller hard budget ceiling for this prospective purchase.",
              "exclusiveMinimum": 0,
              "type": "number"
            },
            "outcomeValueUsd": {
              "description": "Optional caller-estimated value of a successful outcome. AUN does not infer this in v1.",
              "exclusiveMinimum": 0,
              "type": "number"
            },
            "paymentRequirement": {
              "additionalProperties": false,
              "description": "The seller's quoted x402 payment requirement to check before paying, as amountUsd, network, asset and payTo.",
              "properties": {
                "amountUsd": {
                  "description": "Quoted price in USD as a positive number, e.g. 0.01.",
                  "exclusiveMinimum": 0,
                  "type": "number"
                },
                "asset": {
                  "description": "v1 accepts USDC or the canonical Base USDC contract address.",
                  "type": "string"
                },
                "network": {
                  "description": "v1 accepts Base / eip155:8453.",
                  "type": "string"
                },
                "payTo": {
                  "description": "Proposed EVM settlement recipient.",
                  "type": "string"
                }
              },
              "required": [
                "amountUsd",
                "network",
                "asset",
                "payTo"
              ],
              "type": "object"
            }
          },
          "required": [
            "endpoint",
            "paymentRequirement",
            "maxSpendUsd"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "result": {
              "description": "Output of counterparty.preflight. The fields below are the documented core; some responses add further detail fields.",
              "properties": {
                "advisoryOnly": {
                  "description": "Always true: this is advice, not an enforcement.",
                  "type": "boolean"
                },
                "confidence": {
                  "description": "Confidence in the decision from 0 to 1, higher when more signals were checked.",
                  "type": "number"
                },
                "decision": {
                  "description": "allow (all checks pass), review (seller endpoint could not be confirmed) or deny (any check failed).",
                  "type": "string"
                },
                "economicFit": {
                  "description": "Budget checks for the quoted price.",
                  "properties": {
                    "requestedWithinBudget": {
                      "description": "true when the quoted amount is at or under maxSpendUsd.",
                      "type": "boolean"
                    },
                    "requestedWithinEconomicCeiling": {
                      "description": "true when the quoted amount is at or under your economic ceiling.",
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "requestedWithinBudget",
                    "requestedWithinEconomicCeiling"
                  ],
                  "type": "object"
                },
                "evidence": {
                  "description": "One entry per check performed.",
                  "items": {
                    "description": "One entry per check performed.",
                    "properties": {
                      "code": {
                        "description": "Check id, e.g. network_supported, asset_supported, recipient_format, budget_fit.",
                        "type": "string"
                      },
                      "status": {
                        "description": "pass, warn or fail.",
                        "type": "string"
                      }
                    },
                    "required": [
                      "code",
                      "status"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                },
                "paymentExecuted": {
                  "description": "Always false: no payment is made to the seller.",
                  "type": "boolean"
                },
                "scope": {
                  "description": "Rule set applied, currently base_usdc_x402_preflight_v1.",
                  "type": "string"
                }
              },
              "required": [
                "decision",
                "advisoryOnly",
                "paymentExecuted",
                "scope",
            

This page as JSON