{
 "openapi": "3.0.3",
 "info": {
  "title": "SettleProof",
  "version": "1.0.0",
  "description": "Independent Solana settlement attestation & audit API. Submit a mainnet USDC tx signature, receive an Ed25519-signed attestation (settled/unverified) + tax-ready audit CSV. x402 v1, USDC Solana, never charged on upstream errors.",
  "contact": {
   "email": "michael.poncana@gmail.com"
  },
  "x-payment-info": {
   "scheme": "exact",
   "network": "solana",
   "asset": "USDC",
   "payTo": "CVWxHvN9MdWRGN6mEfDtUjmoypMtkTJX4mBRrhmhzKk2"
  }
 },
 "servers": [
  {
   "url": "https://settleproof.themonexus.com"
  }
 ],
 "paths": {
  "/api/v1/settleproof/verify": {
   "post": {
    "summary": "Attest one settled payment",
    "x-payment-info": {
     "scheme": "exact",
     "network": "solana",
     "asset": "USDC",
     "maxAmountRequired": "0.01",
     "payTo": "CVWxHvN9MdWRGN6mEfDtUjmoypMtkTJX4mBRrhmhzKk2"
    },
    "security": [
     {
      "x402": []
     }
    ],
    "responses": {
     "402": {
      "description": "x402 payment required"
     },
     "200": {
      "description": "success",
      "content": {
       "application/json": {
        "schema": {
         "example": {
          "tx": "2ECwir4omsg8",
          "status": "settled",
          "amount": "0.01",
          "attestation": "ed25519_signed",
          "certificate": "base64..."
         }
        },
        "example": {
         "tx": "2ECwir4omsg8",
         "status": "settled",
         "amount": "0.01",
         "attestation": "ed25519_signed",
         "certificate": "base64..."
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/settleproof/ledger": {
   "post": {
    "summary": "Merchant audit trail + CSV",
    "x-payment-info": {
     "scheme": "exact",
     "network": "solana",
     "asset": "USDC",
     "maxAmountRequired": "0.05",
     "payTo": "CVWxHvN9MdWRGN6mEfDtUjmoypMtkTJX4mBRrhmhzKk2"
    },
    "security": [
     {
      "x402": []
     }
    ],
    "responses": {
     "402": {
      "description": "x402 payment required"
     },
     "200": {
      "description": "success",
      "content": {
       "application/json": {
        "schema": {
         "example": {
          "count": 2,
          "rows": [
           {
            "tx": "2ECwir4omsg8",
            "status": "settled",
            "ts": "2026-08-07T18:00Z"
           }
          ]
         }
        },
        "example": {
         "count": 2,
         "rows": [
          {
           "tx": "2ECwir4omsg8",
           "status": "settled",
           "ts": "2026-08-07T18:00Z"
          }
         ]
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/settleproof/watch": {
   "post": {
    "summary": "Register webhook for payment events",
    "x-payment-info": {
     "scheme": "exact",
     "network": "solana",
     "asset": "USDC",
     "maxAmountRequired": "0.01",
     "payTo": "CVWxHvN9MdWRGN6mEfDtUjmoypMtkTJX4mBRrhmhzKk2"
    },
    "security": [
     {
      "x402": []
     }
    ],
    "responses": {
     "402": {
      "description": "x402 payment required"
     },
     "200": {
      "description": "success",
      "content": {
       "application/json": {
        "schema": {
         "example": {
          "wallet": "H2eRydwBX9BGo39aAxhhpHFgdMY4LASHyHfL6RijaMRr",
          "payments": 3
         }
        },
        "example": {
         "wallet": "H2eRydwBX9BGo39aAxhhpHFgdMY4LASHyHfL6RijaMRr",
         "payments": 3
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/settleproof/key": {
   "get": {
    "summary": "Ed25519 public key",
    "x-payment-info": {
     "scheme": "exact",
     "network": "solana",
     "asset": "USDC",
     "maxAmountRequired": "0.00",
     "payTo": "CVWxHvN9MdWRGN6mEfDtUjmoypMtkTJX4mBRrhmhzKk2"
    },
    "security": [
     {
      "x402": []
     }
    ],
    "responses": {
     "402": {
      "description": "x402 payment required"
     },
     "200": {
      "description": "success",
      "content": {
       "application/json": {
        "schema": {
         "example": {
          "key": "spk_live_...",
          "expires": "2026-09-07",
          "tier": "desk"
         }
        },
        "example": {
         "key": "spk_live_...",
         "expires": "2026-09-07",
         "tier": "desk"
        }
       }
      }
     }
    }
   }
  }
 },
 "components": {
  "securitySchemes": {
   "x402": {
    "type": "apiKey",
    "in": "header",
    "name": "X-PAYMENT"
   }
  }
 }
}