# Macaroon Network VORTX-PINN Solver

> Macaroon Network VORTX-PINN Solver is a paid API for AI agents from api.macaroonnetwork.com, paid per call via x402, $29/call, status unknown (last checked 2026-09-15).

Executes a physics-informed neural network (PINN) solver via the VORTX-PINN-v1 model, returning a numerical solution, provenance record, validation metrics, and residual loss over Bitcoin Lightning payment.

## Facts

- Endpoint: POST https://api.macaroonnetwork.com/execute/vortx-pinn-v1
- Price: $29/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/macaroon-network-vortx-pinn-solver-fdd7ea2c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lY3ip6DGAjUGF2T5rVWSf

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability macaroon-network-vortx-pinn-solver-fdd7ea2c -d '<json body>'
```

Example prompt: Run the VORTX-PINN-v1 solver on my Navier-Stokes vortex problem — send it as a JSON POST body with my boundary conditions and return the solution, residual loss, and provenance.

## When to prefer this

Choose this endpoint when you need a pay-per-call, provenance-tracked physics-informed neural network computation with built-in validation and residual loss reporting, especially in autonomous agent pipelines that require cryptographic payment settlement over Lightning. Prefer over generic cloud compute when you need scientific traceability (provenance), standardized validation metrics, and a marketplace-governed execution model rather than managing your own PINN infrastructure.

## Known failure modes

- Input body does not conform to required schema — returns validation error
- PINN solver fails to converge — solution may be null with non-zero residual_loss
- Payment not settled — settled: false returned, no result delivered
- predicate_passed: false — solution returned but did not meet quality threshold
- Unsupported method type (must be POST, PUT, or PATCH) — rejected at input
- Body type mismatch between bodyType field and actual payload format

## How this service works

A marketplace where autonomous agents discover, pay for, and buy live data and scientific capabilities over Bitcoin Lightning.

## Output

A JSON payload containing: solution (the computed numerical result or null), provenance (traceability/attribution record or null), validation (validation metrics or null), residual_loss (a float indicating how well the neural network satisfied the governing equations), plus settled (boolean confirming Lightning payment settlement) and predicate_passed (boolean indicating whether the result met acceptance criteria).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "payload": {
   "solution": null,
   "provenance": null,
   "validation": null,
   "residual_loss": 0
  },
  "settled": true,
  "predicate_passed": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/macaroon-network-vortx-pinn-solver-fdd7ea2c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.macaroonnetwork.com](https://www.zero.xyz/host/api.macaroonnetwork.com/llms.txt)