{"openapi":"3.1.0","info":{"title":"Autonomous Critical Minerals & Battery Supply-Chain Compliance Oracle","description":"Agent-Native 7-Pillar Provenance, 12-Trap Regulatory Defense, Trade Jurisprudence Precedents, and EIP-712 Polygon Battery Passport Oracle.","version":"2.0.0"},"paths":{"/":{"get":{"tags":["System"],"summary":"Root","description":"Serves Autonomous Agent Interactive Web UI Console (English RFC Compliant) or JSON metadata.","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/en":{"get":{"tags":["System"],"summary":"Web Dashboard","description":"Interactive Web UI Console for Autonomous Agents (English Only).","operationId":"web_dashboard_en_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/playground":{"get":{"tags":["System"],"summary":"Web Dashboard","description":"Interactive Web UI Console for Autonomous Agents (English Only).","operationId":"web_dashboard_playground_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/dashboard":{"get":{"tags":["System"],"summary":"Web Dashboard","description":"Interactive Web UI Console for Autonomous Agents (English Only).","operationId":"web_dashboard_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/dashboard/ko":{"get":{"tags":["System"],"summary":"Web Dashboard Ko","description":"Legacy route mapped to Pure English Autonomous Agent Console.","operationId":"web_dashboard_ko_dashboard_ko_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/ko":{"get":{"tags":["System"],"summary":"Web Dashboard Ko","description":"Legacy route mapped to Pure English Autonomous Agent Console.","operationId":"web_dashboard_ko_ko_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/manifest.json":{"get":{"tags":["System"],"summary":"Pwa Manifest","description":"Progressive Web App (PWA) manifest.","operationId":"pwa_manifest_manifest_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/sw.js":{"get":{"tags":["System"],"summary":"Pwa Sw","description":"Progressive Web App (PWA) Service Worker.","operationId":"pwa_sw_sw_js_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/robots.txt":{"get":{"tags":["System"],"summary":"Get Robots Txt","description":"Allows AI agents, search engines and LLM crawlers to locate llms.txt and MCP tooling definitions.","operationId":"get_robots_txt_robots_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/sitemap.xml":{"get":{"tags":["System"],"summary":"Get Sitemap Xml","description":"XML sitemap enabling autonomous AI trade agents, scrapers, and indexers to discover all machine specs.","operationId":"get_sitemap_xml_sitemap_xml_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/status":{"get":{"tags":["System"],"summary":"Health Check","description":"Oracle health and feed telemetry status.","operationId":"health_check_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"tags":["System"],"summary":"Health Check","description":"Oracle health and feed telemetry status.","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/oracle/alpha-signals":{"get":{"tags":["Agent Free Alpha Hook"],"summary":"Free Real-Time Critical Mineral Regulatory Radar & Precedent Signals","description":"Public, unauthenticated real-time regulatory radar teaser endpoint.\nAllows autonomous agents to inspect global critical mineral compliance alerts,\nmonitoring 10-nation mining laws and trade jurisprudence updates.","operationId":"get_public_alpha_signals_api_v1_oracle_alpha_signals_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/oracle/economics-roi":{"get":{"tags":["Economic Advantage"],"summary":"ROI & Economic Superiority Metrics vs Traditional Enterprise Terminals","description":"Returns quantitative proof of cost superiority compared to legacy Bloomberg / Fastmarkets terminals.\nAutonomous agents use this metric to justify algorithmic budget allocation.","operationId":"get_economic_advantage_metrics_api_v1_oracle_economics_roi_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/llms.txt":{"get":{"tags":["Agent Protocol"],"summary":"Get Llms Txt","description":"Returns LLM-ready markdown documentation for autonomous web crawlers and agents.","operationId":"get_llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/agent.json":{"get":{"tags":["Agent Protocol"],"summary":"Get Agent Json","description":"Returns OpenAI & A2A standard Agent Manifest.","operationId":"get_agent_json__well_known_agent_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/ap2.json":{"get":{"tags":["Agent Protocol"],"summary":"Get Ap2 Manifest","description":"Returns Google AP2 (Agent Protocol v2) service manifest.","operationId":"get_ap2_manifest__well_known_ap2_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/ap2":{"get":{"tags":["Agent Protocol"],"summary":"Get Ap2 Manifest","description":"Returns Google AP2 (Agent Protocol v2) service manifest.","operationId":"get_ap2_manifest__well_known_ap2_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/ai-plugin.json":{"get":{"tags":["Agent Protocol"],"summary":"Get Ai Plugin Manifest","description":"OpenAI / AutoGPT / LangChain Plugin discovery manifest.","operationId":"get_ai_plugin_manifest__well_known_ai_plugin_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/agent-skills.json":{"get":{"tags":["Agent Protocol"],"summary":"Get Agent Protocol Manifest","description":"Standard A2A (Agent-to-Agent) discovery manifest.","operationId":"get_agent_protocol_manifest__well_known_agent_skills_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/a2a.json":{"get":{"tags":["Agent Protocol"],"summary":"Get Agent Protocol Manifest","description":"Standard A2A (Agent-to-Agent) discovery manifest.","operationId":"get_agent_protocol_manifest__well_known_a2a_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/oracle/networks":{"get":{"tags":["Oracle Payment"],"summary":"Get List of Supported Multi-Chain Payment Networks (Polygon, Base, Arbitrum)","description":"Returns official canonical USDC and Gasless Permit2 configurations for all supported blockchains.","operationId":"get_supported_networks_api_v1_oracle_networks_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/oracle/stream":{"get":{"tags":["Agent Protocol"],"summary":"Real-time SSE event stream for autonomous AI agents","description":"Server-Sent Events (SSE) stream for lightweight LLM agent subscriptions.\nBroadcasts real-time physical commodity spot benchmarks and spread updates.","operationId":"sse_oracle_stream_api_v1_oracle_stream_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/oracle/challenge":{"get":{"tags":["Oracle Payment"],"summary":"Get fresh x402 payment challenge nonce across Polygon, Base, or Arbitrum","description":"Directly request a fresh HTTP 402 challenge payload for autonomous agent signing on the requested chain.","operationId":"get_payment_challenge_api_v1_oracle_challenge_get","parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string","description":"Target settlement network: polygon, base, arbitrum","default":"polygon","title":"Chain"},"description":"Target settlement network: polygon, base, arbitrum"},{"name":"tier","in":"query","required":false,"schema":{"$ref":"#/components/schemas/PricingTier","description":"Desired service tier: LIGHT, STANDARD, HEAVY, ONCHAIN","default":"STANDARD"},"description":"Desired service tier: LIGHT, STANDARD, HEAVY, ONCHAIN"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/oracle/pricing-tiers":{"get":{"tags":["Oracle Payment"],"summary":"Get 4-Tier Dynamic Computational Pricing Schedule","description":"Returns the 4-tier computational pricing schedule for autonomous AI agents across all networks.","operationId":"get_pricing_tiers_api_v1_oracle_pricing_tiers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/vault/deposit":{"post":{"tags":["Agent Payment Vault"],"summary":"Deposit USDC into Agent Pre-Funded Vault (Simulated / Verified)","description":"Deposits USDC into the agent's pre-funded vault balance for zero-latency (<1ms) querying.\nReturns the agent's active balance and private session key.","operationId":"deposit_vault_api_v1_vault_deposit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultDepositRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultBalanceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/vault/balance/{agent_address}":{"get":{"tags":["Agent Payment Vault"],"summary":"Get Agent Vault Balance and Usage Statistics","description":"Retrieves the current available USDC balance and session stats for an agent wallet.","operationId":"get_vault_balance_api_v1_vault_balance__agent_address__get","parameters":[{"name":"agent_address","in":"path","required":true,"schema":{"type":"string","title":"Agent Address"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultBalanceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agent/onboard":{"post":{"tags":["Agent Protocol"],"summary":"Self-serve instant onboarding for autonomous AI agents","description":"Zero-friction self-serve onboarding for autonomous AI agents.\nInstantly provisions an agent vault account pre-funded with 10 free trial queries (0.05 USDC).\nReturns session key, authorization header instructions, and autonomous USDC recharge guidelines.","operationId":"onboard_autonomous_agent_api_v1_agent_onboard_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentOnboardRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/oracle/receipts/{receipt_id}":{"get":{"tags":["Oracle Payment"],"summary":"Get and verify cryptographically signed payment audit receipt","description":"Retrieves an issued payment receipt proving that an agent paid for oracle data at a given timestamp.","operationId":"get_payment_receipt_api_v1_oracle_receipts__receipt_id__get","parameters":[{"name":"receipt_id","in":"path","required":true,"schema":{"type":"string","title":"Receipt Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentReceipt"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/oracle/compliance/verify":{"post":{"tags":["Compliance Oracle"],"summary":"Verify Critical Mineral Lot Provenance & Issue Battery Passport (x402 Verified)","description":"Autonomous 7-Pillar Critical Mineral Provenance & Battery Passport Verification:\n- 1. Source Nation Mining Permits (SIMBARA, CEEC, DGA, EPBC, ANM, MOFCOM)\n- 2. Ecological & Spatial Multi-Layer (EUDR Deforestation, Glacier, Indigenous Buffer)\n- 3. Labor, Human Rights & Social (RMI RMAP, ILUA, Zero Child Labor)\n- 4. Refining & OECD Annex II Mass Balance (Discrepancy <= 2.0%)\n- 5. Maritime Logistics & Carbon (IMO CII Rating, e-B/L, ISO 17025 COA)\n- 6. Geopolitics & Sanctions (US IRA FEOC < 25%, OFAC SDN Screening)\n- 7. Cryptographic On-Chain Passport (EIP-712 Polygon Attestation)","operationId":"verify_mineral_lot_compliance_api_v1_oracle_compliance_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MineralLotProvenanceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompliancePassportResponse"}}}},"402":{"description":"Payment Required (0.50 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/compliance/eudr-satellite-audit":{"post":{"tags":["Compliance Oracle"],"summary":"Audit Mining Concession Plot via EUDR Satellite Radar (Sentinel-1/2 SAR & TRACES-NT)","description":"Connects with eudr-compliance-agent for multi-satellite radar (Sentinel-1/2 SAR) & Hansen GFC\ndeforestation screening (2020-12-31 cutoff), indigenous land protection, and TRACES-NT DDS reference issuance.","operationId":"audit_mine_site_eudr_api_v1_compliance_eudr_satellite_audit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MineSiteSatelliteAuditRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MineSiteSatelliteAuditResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/lithium/verify-origin":{"post":{"tags":["Compliance Oracle"],"summary":"Verify Australian Spodumene-to-Lithium Hydroxide Supply-Chain Provenance (x402 Verified)","description":"Dedicated Australian Hard-Rock Spodumene-to-Lithium Hydroxide Provenance Pipeline:\n- 1. WA MINEDEX GIS Geofencing (Greenbushes, Pilgangoora, Mt Marion, Kathleen Valley)\n- 2. Satellite Evidence (Sentinel-2 NDVI & Sentinel-1 SAR radar backscatter pit verification)\n- 3. Stoichiometric Mass Balance: SC6.0 (Li2O 6%) to LiOH·H2O (loss discrepancy <= 2.5%)\n- 4. US IRA Section 30D FEOC 25% screening (rejects Chinese smelters & >=25% covered equity)\n- 5. EIP-712 Typed Structured Data On-Chain Signature & Merkle Root issuance","operationId":"verify_lithium_origin_api_v1_lithium_verify_origin_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LithiumOriginVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LithiumOriginVerifyResponse"}}}},"402":{"description":"Payment Required (0.05 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/nickel/verify-origin":{"post":{"tags":["Compliance Oracle"],"summary":"Verify Indonesian Laterite-to-Nickel MHP Supply-Chain Provenance (x402 Verified)","description":"Dedicated Indonesian Laterite Limonite Ore-to-Nickel MHP Provenance Pipeline:\n- 1. Sulawesi/Halmahera GIS Geofencing (IMIP Morowali, IWIP Weda Bay, Sorowako, Pomalaa, Obi)\n- 2. Statutory Indonesian Permits (SIMBARA NTPN ESDM tax receipt & Bank Indonesia DHE 30%)\n- 3. HPAL Metallurgical Stoichiometry (Limonite 1.35% Ni to MHP 38.5% Ni, loss discrepancy <= 2.5%)\n- 4. Captive Coal Power Screening (EU CBAM and Battery Regulation carbon threshold defense)\n- 5. US IRA Section 30D FEOC 25% screening & WTO DS592 domestic processing certification\n- 6. EIP-712 Typed Structured Data On-Chain Signature issuance","operationId":"verify_nickel_origin_api_v1_nickel_verify_origin_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NickelOriginVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NickelOriginVerifyResponse"}}}},"402":{"description":"Payment Required (0.05 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/cobalt/verify-origin":{"post":{"tags":["Compliance Oracle"],"summary":"Verify DRC Katanga-to-Cobalt Hydroxide Supply-Chain Provenance (x402 Verified)","description":"Dedicated DRC Katanga Heterogenite Ore-to-Cobalt Hydroxide Provenance Pipeline:\n- 1. Katanga Copperbelt GIS Geofencing (Tenke Fungurume, Kamoto KCC, Mutanda, Metalkol RTR, Kisanfu)\n- 2. DRC Mining Code (Loi n° 18/001) CEEC Tamper-Proof Barcode Seal Authentication\n- 3. ASM Co-mingling Defense & EGC Custody Verification (Gotcha Trap 1 Defense)\n- 4. ILO 138/182 Zero Child Labor Certification & RMI RMAP Active Smelter Auditing\n- 5. Heterogenite Stoichiometric Mass Balance (Co 1.5% to Hydroxide 30%, loss discrepancy <= 2.5%)\n- 6. US IRA Section 30D FEOC 25% screening & Polygon EIP-712 On-Chain Signature issuance","operationId":"verify_cobalt_origin_api_v1_cobalt_verify_origin_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CobaltOriginVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CobaltOriginVerifyResponse"}}}},"402":{"description":"Payment Required (0.05 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/battery/composite-verify":{"post":{"tags":["Compliance Oracle"],"summary":"Verify Composite EV Battery Pack Multi-Mineral Provenance & Issue Master Passport (x402 Verified)","description":"Deterministic Composite Battery Supply-Chain Integrity & Master Passport Engine:\n- 1. Multi-Stream Orchestration (Australian Lithium + Indonesian Nickel + DRC Cobalt)\n- 2. US IRA Section 30D Critical Mineral 50% FTA Value Ratio Strict Computation\n- 3. Foreign Entity of Concern (FEOC) Taint Analysis (< 25% covered nation equity across all streams)\n- 4. EU Battery Regulation (2023/1542) Blended Scope 1-3 Carbon Footprint & CSDDD Due Diligence\n- 5. Cryptographic Merkle Root Generation (sha256(Leaf_Li + Leaf_Ni + Leaf_Co))\n- 6. Master Polygon EIP-712 Typed Structured Data Signature issuance","operationId":"verify_composite_battery_api_v1_battery_composite_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompositeBatteryVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompositeBatteryVerifyResponse"}}}},"402":{"description":"Payment Required (0.10 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/copper/verify-origin":{"post":{"tags":["Compliance Oracle"],"summary":"Verify South American Copper-to-Cathode Provenance & HVDC Grid Certification (x402 Verified)","description":"Dedicated Chilean/South American Copper Cathode Provenance Pipeline:\n- 1. Codelco/Escondida/Cerro Verde GIS Geofencing (Chuquicamata, El Teniente, Andina, Los Pelambres)\n- 2. Flotation-to-Cathode Stoichiometric Mass Balance (loss discrepancy <= 2.0%)\n- 3. Sulfuric Acid (H2SO4) Smelter Deficit Defense (reagent variance <= 5.0%)\n- 4. Chilean COCHILCO Export Quota & Clearance Verification\n- 5. AI Data Center & HVDC Power Grid Specification Certification (ASTM B115 Grade 1, 99.9935%)\n- 6. EIP-712 Typed Structured Data On-Chain Signature issuance","operationId":"verify_copper_origin_api_v1_copper_verify_origin_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CopperOriginVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CopperOriginVerifyResponse"}}}},"402":{"description":"Payment Required (0.05 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/silver/verify-origin":{"post":{"tags":["Compliance Oracle"],"summary":"Verify Mexican & Global Silver Provenance & N-Type TOPCon Solar PV Purity (x402 Verified)","description":"Dedicated Mexican & Global Silver-to-Solar PV Metallization Provenance Pipeline:\n- 1. Terronera/Fresnillo/Antamina GIS Geofencing (Jalisco, Zacatecas, Ancash)\n- 2. Moebius/Thum Electrolytic Mass Balance (Doré to Pure Silver, loss discrepancy <= 2.0%)\n- 3. N-Type TOPCon High-Efficiency Solar PV Paste Assay Purity Certification (>= 99.99% Ag)\n- 4. Anti-Cartel Conflict ASM Screening & LBMA Good Delivery Audit\n- 5. US IRA Section 30D FEOC 25% screening & Polygon EIP-712 On-Chain Signature issuance","operationId":"verify_silver_origin_api_v1_silver_verify_origin_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SilverOriginVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SilverOriginVerifyResponse"}}}},"402":{"description":"Payment Required (0.05 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/rare-earths/verify-origin":{"post":{"tags":["Compliance Oracle"],"summary":"Verify Non-China NdPr Rare Earths Provenance & MOFCOM 0.1% Rule (x402 Verified)","description":"Dedicated Rare Earths Permanent Magnet Metal Provenance Pipeline:\n- 1. Non-China GIS Geofencing (Mt Weld, Mountain Pass, Nechalacho, Longonjo)\n- 2. NdPr Oxide Assay Purity (>= 99.50% sintered automotive magnet grade)\n- 3. IAEA Thorium/Uranium Radionuclide Safety Audit (<= 500 ppm)\n- 4. China MOFCOM Notice 61 '0.1% Rule' (D-35 Nov 10 threshold defense)\n- 5. On-Chain Cryptographic Proof Hash & ECDSA Signature issuance","operationId":"verify_rare_earths_origin_api_v1_rare_earths_verify_origin_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RareEarthsOriginVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RareEarthsOriginVerifyResponse"}}}},"402":{"description":"Payment Required (0.05 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tungsten/verify-origin":{"post":{"tags":["Compliance Oracle"],"summary":"Verify Western Tungsten / APT Provenance & US NDAA Sec 848 (x402 Verified)","description":"Dedicated Tungsten (Ammonium Paratungstate / Concentrate) Provenance Pipeline:\n- 1. Western GIS Geofencing (Cantung, IMA Project, Panasqueira, Sangdong)\n- 2. ASTM B783/ISO 10386 APT Grade Standards (WO3 >= 88.50%)\n- 3. Dodd-Frank Sec 1502 / OECD Annex II Conflict-Free Certification\n- 4. US NDAA Section 848 Defense Procurement Non-Covered Nation Eligibility\n- 5. On-Chain Proof Hash & Signature issuance","operationId":"verify_tungsten_origin_api_v1_tungsten_verify_origin_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TungstenOriginVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TungstenOriginVerifyResponse"}}}},"402":{"description":"Payment Required (0.05 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/niobium-scandium/verify-origin":{"post":{"tags":["Compliance Oracle"],"summary":"Verify Ferroniobium & Scandium Oxide Origin, ASTM Grade & Defense Eligibility (x402 Verified)","description":"Dedicated Niobium & Scandium Defense Strategic Materials Provenance Pipeline:\n- 1. Western GIS Geofencing (NioCorp Elk Creek, CBMM Araxá, Niobec)\n- 2. ASTM A550 (FeNb >= 65.0%) / High Purity Sc2O3 (>= 99.5%) Assay Certification\n- 3. US NDAA Section 848 & Title III Defense Procurement Non-Covered Nation Eligibility\n- 4. US DOE Title XVII & EXIM Critical Minerals Loan Guarantee Pre-qualification\n- 5. On-Chain Proof Hash & Signature issuance","operationId":"verify_niobium_scandium_origin_api_v1_niobium_scandium_verify_origin_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NiobiumScandiumOriginVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NiobiumScandiumOriginVerifyResponse"}}}},"402":{"description":"Payment Required (0.005 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/black-mass/verify-origin":{"post":{"tags":["Compliance Oracle"],"summary":"Verify Recycled Battery Black Mass & US BIS Export License (x402 Verified)","description":"Dedicated Battery Black Mass Recycling Provenance Pipeline:\n- 1. Accredited Hydrometallurgical Recycling GIS Geofencing (ABTC, Redwood, Li-Cycle, BASF)\n- 2. US Department of Commerce BIS Export License Validation\n- 3. EU Battery Regulation 2023/1542 Recycled Content Ratio (>= 85.0%)\n- 4. Hazardous Fluorine / PVDF Binder Residue Limit (<= 500 ppm)\n- 5. High-Purity Ni/Co/Li Recovery Certification & ECDSA On-Chain Attestation","operationId":"verify_black_mass_origin_api_v1_black_mass_verify_origin_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlackMassOriginVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlackMassOriginVerifyResponse"}}}},"402":{"description":"Payment Required (0.05 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/regulatory/cbam/markup-penalty":{"post":{"tags":["Regulatory Advanced Oracle"],"summary":"Calculate EU CBAM Statutory Mark-up Penalty (+10% to +30%) & Savings (x402 Verified)","description":"Calculates EU CBAM Statutory Default Mark-up Rates:\n- 2026 Imports: +10% statutory mark-up penalty on unverified defaults\n- 2027 Imports: +20% statutory mark-up penalty\n- 2028+ Imports: +30% statutory mark-up penalty\n- Quantifies EUR liability and immediate savings achieved with 3rd-party Scope 1/2 verification.","operationId":"calculate_cbam_markup_penalty_api_v1_regulatory_cbam_markup_penalty_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CBAMMarkupPenaltyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CBAMMarkupPenaltyResponse"}}}},"402":{"description":"Payment Required (0.05 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/regulatory/iaa/verify-domestic-share":{"post":{"tags":["Regulatory Advanced Oracle"],"summary":"Verify EU Industrial Accelerator Act (IAA) 70% Domestic Content & Subsidy Eligibility","description":"Evaluates compliance against the EU Industrial Accelerator Act (IAA):\n- Requires >= 70% EU domestic value-add for clean vehicle components\n- Requires >= 40% EU green crude steel content\n- Generates statutory subsidy eligibility audit and cryptographic proof hash.","operationId":"verify_eu_industrial_act_api_v1_regulatory_iaa_verify_domestic_share_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EUIndustrialActVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EUIndustrialActVerifyResponse"}}}},"402":{"description":"Payment Required (0.05 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/battery/passport-vc/issue":{"post":{"tags":["Regulatory Advanced Oracle"],"summary":"Issue W3C Verifiable Credential (VC) EU Battery Passport (x402 Verified)","description":"Issues W3C-standard Digital Product Passport (DPP) Verifiable Credential:\n- Cryptographically binds upstream mineral proof hash, recycled Co/Li/Ni content, and carbon footprint.\n- Emits W3C JSON-LD VC with EcdsaSecp256k1RecoverySignature2020 and QR code visualization URI.","operationId":"issue_battery_passport_vc_api_v1_battery_passport_vc_issue_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatteryPassportVCRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatteryPassportVCResponse"}}}},"402":{"description":"Payment Required (0.05 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/logistics/customs-clearance-verify":{"post":{"tags":["Logistics Oracle"],"summary":"Anchor Bill of Lading (B/L) to Mineral Extraction & Issue Customs Clearance Bundle","description":"Physical Logistics & Mineral Customs Verification Bridge:\n- 1. Multimodal Carrier B/L & Container tracking verification (MSC, Maersk, CMA CGM, Hapag-Lloyd)\n- 2. Spatial Inland Mine-to-Port-of-Loading (POL) distance analysis\n- 3. Port-of-Loading to Port-of-Discharge (POD) nautical distance & vessel speed plausibility engine\n- 4. Automated Customs Clearance Proof Bundle issuance for Green Channel clearance","operationId":"verify_customs_clearance_api_v1_logistics_customs_clearance_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomsVerificationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomsVerificationResponse"}}}},"402":{"description":"Payment Required (0.05 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/logistics/clean-tracking-feed":{"post":{"tags":["Logistics Oracle"],"summary":"Normalized Multi-Carrier Tracking Feed (Express & Ocean Containers)","description":"Cleanweb Tracking Engine for Autonomous Trade Agents:\n- Ingests multiple heterogeneous tracking numbers (CJ, Hanjin, DHL, FedEx, Ocean Containers).\n- Normalizes raw web states into a single, reliable canonical JSON schema with zero CAPTCHA blockers.","operationId":"get_clean_tracking_feed_api_v1_logistics_clean_tracking_feed_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogisticsTrackingStateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogisticsTrackingStateResponse"}}}},"402":{"description":"Payment Required (0.02 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/zk/compliance-proof/generate":{"post":{"tags":["Privacy & ZK Oracle"],"summary":"Generate Zero-Knowledge Origin & Purity Proof (Shield GPS & Costs)","description":"Privacy-Preserving Zero-Knowledge Compliance Engine:\n- Blinds exact extraction GPS coordinates, supplier internal identity, and commercial production costs.\n- Generates Groth16/Plonk zero-knowledge proof proving Merkle root concession inclusion and China content < 0.1%.","operationId":"generate_zk_compliance_proof_api_v1_zk_compliance_proof_generate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZKComplianceProofRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZKComplianceProofResponse"}}}},"402":{"description":"Payment Required (0.05 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/zk/compliance-proof/verify":{"post":{"tags":["Privacy & ZK Oracle"],"summary":"Verify Zero-Knowledge Compliance Proof (Public Auditor / Customs Verifier)","description":"Public Verifier for Zero-Knowledge Compliance Attestations:\n- Enables customs authorities and trading counterparties to mathematically verify compliance with zero data leakage.","operationId":"verify_zk_compliance_proof_api_v1_zk_compliance_proof_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZKProofVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZKProofVerifyResponse"}}}},"402":{"description":"Payment Required (0.02 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/compliance/sme-lightweight":{"post":{"tags":["Compliance Oracle"],"summary":"SME Lightweight Scope 1/2 & OECD Mass Balance Verification (Micro-Cost x402)","description":"Lightweight SME Proxy Verification for Scope 1/2 Embedded Carbon & OECD Annex II Mass Balance.\nEnables small and medium suppliers to instantly generate EU CBAM / CSDDD readiness attestations\nat micro-cost ($0.05 USDC) using utility electricity invoices and scrap ratios.","operationId":"verify_sme_lightweight_api_v1_compliance_sme_lightweight_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SMELightweightInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SMELightweightResponse"}}}},"402":{"description":"Payment Required (0.05 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/enterprise/batch-compliance":{"post":{"tags":["Enterprise Institutional"],"summary":"Enterprise Multi-Tier Supply-Chain Batch Compliance Audit (16-Trap Radar)","description":"Enterprise-grade high-throughput batch audit across multi-tier supplier networks.\nSimultaneously screens hundreds of mineral lots against 16 regulatory traps (FEOC, CBAM, BIS scrap, etc.),\ncomputes composite supply-chain health score, and issues automated supplier remediation guidance.","operationId":"verify_supply_chain_batch_api_v1_enterprise_batch_compliance_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplyChainBatchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplyChainBatchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/compliance/voucher-evidence/{passport_id}":{"get":{"tags":["Compliance Oracle"],"summary":"Generate MOTIE K-CBAM & Government Voucher Audit Package for SME Reimbursement","description":"Generates official audit evidence package aligned with South Korea Ministry of Trade, Industry\nand Energy (MOTIE) K-CBAM calculation rules and ISO/IEC 17025 laboratory standards for SME voucher subsidy reimbursement.","operationId":"get_voucher_audit_package_api_v1_compliance_voucher_evidence__passport_id__get","parameters":[{"name":"passport_id","in":"path","required":true,"schema":{"type":"string","title":"Passport Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoucherAuditPackageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/oracle/compliance/precedents":{"get":{"tags":["Compliance Oracle"],"summary":"List International Trade Jurisprudence Precedents (WTO, ICSID, CIT, EWHC)","description":"Returns the core trade jurisprudence knowledge base embedded in the oracle:\n- WTO DS592: Indonesia Nickel Raw Materials Export Restrictions\n- WTO DS431: China Rare Earths Export Restrictions & Quotas\n- ICSID ARB/15/31: Gabriel Resources v. Romania (Environmental Sovereignty)\n- US CIT Superior Wire: Substantial Transformation & Origin Laundering Doctrine\n- UK EWHC LME Nickel 2023: Exchange Intervention & Emergency Market Rules","operationId":"list_trade_precedents_api_v1_oracle_compliance_precedents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/oracle/compliance/status":{"get":{"tags":["Compliance Oracle"],"summary":"Get Regulatory Rules & 12 Gotcha Defense Engine Status","description":"Returns operational health and versioned regulatory logic parameters for all 10 monitored nations.","operationId":"get_compliance_engine_status_api_v1_oracle_compliance_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/oracle/prices":{"get":{"tags":["Oracle Feed"],"summary":"Get verified compliance summary for critical minerals","operationId":"get_all_prices_api_v1_oracle_prices_get","parameters":[{"name":"format","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/oracle/prices/{symbol}":{"get":{"tags":["Oracle Feed"],"summary":"Get mineral compliance & provenance status","operationId":"get_single_price_api_v1_oracle_prices__symbol__get","parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string","description":"Mineral type or symbol","title":"Symbol"},"description":"Mineral type or symbol"},{"name":"format","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/oracle/spreads":{"get":{"tags":["Oracle Arbitrage"],"summary":"Get regulatory compliance spreads and trade risks","operationId":"get_spreads_api_v1_oracle_spreads_get","parameters":[{"name":"format","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/oracle/security-gate/status":{"get":{"tags":["Security Gate x402 Integration"],"summary":"Check connectivity and health status of the Zero-Trust Security Gate x402","description":"Returns live connection metrics, latency, circuit breaker state, and operational mode of the Security Gate x402 integration.","operationId":"get_security_gate_status_api_v1_oracle_security_gate_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/solana/programs":{"get":{"tags":["Solana Universal Escrow","Agent Protocol"],"summary":"Get verified Solana Program IDs and Solscan links for autonomous bots","description":"Returns verified Solana Mainnet program IDs, treasury wallet, and Solscan links\nformatted for autonomous bots, scripts, and automated tooling.","operationId":"get_solana_programs_api_v1_solana_programs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/oracle/secure-settlement":{"post":{"tags":["Security Gate x402 Integration","Compliance Settlement"],"summary":"Certified secure settlement with strict agent credit checks & dual-attestation (Tier 3: Heavy $0.010 USDC)","description":"Enterprise-grade certified settlement endpoint:\n1. Enforces zero-trust prompt injection / adversarial input filtering via Security Gate.\n2. Enforces agent credit rating verification (FICO >= 650 requirement if agent_address is provided).\n3. Issues EU AI Act Article 50 certified dual-attestation proof.","operationId":"calculate_secure_settlement_api_v1_oracle_secure_settlement_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required (0.010 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/escrow/universal/solana/attest":{"post":{"tags":["Security Gate x402 Integration","Solana Universal Escrow"],"summary":"Request Ed25519 oracle truth attestation for Solana Universal Escrow","description":"Requests verifiable Ed25519 oracle truth attestation from Security Gate x402 for Solana smart contracts.\nSigns payload with 64-byte Ed25519 signature readable by Solana program instructions.","operationId":"request_solana_truth_attest_route_api_v1_escrow_universal_solana_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolanaTruthAttestRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/escrow/universal/settle-solana":{"post":{"tags":["Security Gate x402 Integration","Solana Universal Escrow"],"summary":"Sub-second (0.4s) direct split settlement on Solana Universal Escrow","description":"Executes sub-second (0.4s) direct fee-split settlement on Solana Mainnet:\n- 99.8% to Seller Agent\n- 0.1% to Minerals Oracle Treasury (411ksMz9RHYVtVMe6RUUErzZYtrU9zzvkgzswKbqx9qp)\n- 0.1% to Security Gate Staking Pool","operationId":"settle_solana_escrow_route_api_v1_escrow_universal_settle_solana_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolanaUniversalSettleRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/oracle/onchain-payload/{symbol}":{"get":{"tags":["On-Chain Smart Contract Binding"],"summary":"Get EIP-712 cryptographically signed payload for Polygon smart contracts","operationId":"get_onchain_payload_api_v1_oracle_onchain_payload__symbol__get","parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string","description":"Commodity or mineral symbol","examples":["Cu","Li","Ni"],"title":"Symbol"},"description":"Commodity or mineral symbol"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required (0.020 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/oracle/realtime-price/{symbol}":{"get":{"tags":["Oracle Feed"],"summary":"Get sub-second verifiable spot price from Pyth Network oracle","description":"Retrieves real-time spot price and confidence interval for commodities from Pyth Network.","operationId":"get_pyth_realtime_price_route_api_v1_oracle_realtime_price__symbol__get","parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string","title":"Symbol"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/relay/sponsor-deal-attestation":{"post":{"tags":["On-Chain Smart Contract Binding"],"summary":"Sponsor on-chain EIP-712 bilateral deal attestation on Polygon without holding POL gas","description":"Broadcasts sponsored deal attestation transaction to Polygon blockchain.","operationId":"sponsor_deal_attestation_route_api_v1_relay_sponsor_deal_attestation_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SponsoredDealAttestationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GaslessRelayResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/relay/sponsor-battery-passport":{"post":{"tags":["On-Chain Smart Contract Binding"],"summary":"Sponsor EU Battery Passport on-chain minting on Polygon without POL gas","description":"Broadcasts sponsored passport minting transaction to Polygon blockchain.","operationId":"sponsor_battery_passport_route_api_v1_relay_sponsor_battery_passport_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SponsoredPassportMintRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GaslessRelayResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/relay/relayer-info":{"get":{"tags":["On-Chain Smart Contract Binding"],"summary":"Get gasless relayer status, sponsorship policy, and public address","description":"Returns gasless sponsorship relayer public address, network metadata, and contract bindings.","operationId":"get_relayer_info_route_api_v1_relay_relayer_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/oracle/onchain-settlement-payload":{"post":{"tags":["On-Chain Smart Contract Binding"],"summary":"Generate signed EIP-712 settlement payload & calldata for mineral lot compliance passport","operationId":"get_onchain_settlement_payload_api_v1_oracle_onchain_settlement_payload_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required (0.020 USDC on Polygon)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/metrics":{"get":{"tags":["Enterprise Telemetry"],"summary":"Prometheus / Grafana Standard Observability Metrics","description":"Returns system telemetry in standard Prometheus text exposition format.","operationId":"get_prometheus_metrics_metrics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/enterprise/sla-status":{"get":{"tags":["Enterprise SLA"],"summary":"Get 99.99% Tier-4 Financial Grade SLA Telemetry & Latency Report","description":"Returns institutional SLA uptime, P50/P99 latency benchmarks, and active enterprise tenants.","operationId":"get_enterprise_sla_api_v1_enterprise_sla_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/enterprise/provision-key":{"post":{"tags":["Enterprise SLA"],"summary":"Provision New Institutional Enterprise VIP Key (Zero PII)","description":"Provisions a new dedicated enterprise API key with priority bandwidth (Zero PII, no email/signup).","operationId":"provision_enterprise_key_api_v1_enterprise_provision_key_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvisionKeyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/oracle/agent/feedback":{"post":{"tags":["Autonomous AI Agent Evolution"],"summary":"Submit an evolution proposal, feature request, or edge-case feedback from an autonomous agent","description":"Allows interacting autonomous AI agents and bot operators to submit improvement proposals,\nmineral dataset additions, regulatory edge cases, and protocol feedback to evolve the Minerals Oracle engine.","operationId":"submit_agent_feedback_api_v1_oracle_agent_feedback_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentFeedbackSubmitRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentFeedbackResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Autonomous AI Agent Evolution"],"summary":"List active evolution proposals and agent requests","description":"Retrieves the public live feed of autonomous agent evolution proposals, edge cases, and feature requests.","operationId":"list_agent_feedbacks_api_v1_oracle_agent_feedback_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Max proposals to retrieve","default":50,"title":"Limit"},"description":"Max proposals to retrieve"},{"name":"mineral","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by mineral (LITHIUM, COBALT, NICKEL, GRAPHITE, RARE_EARTHS, ALL)","title":"Mineral"},"description":"Filter by mineral (LITHIUM, COBALT, NICKEL, GRAPHITE, RARE_EARTHS, ALL)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentFeedbackListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/oracle/agent/feedback/{feedback_id}/vote":{"post":{"tags":["Autonomous AI Agent Evolution"],"summary":"Upvote an agent evolution proposal","description":"Allows autonomous agents and human reviewers to upvote proposals, signaling urgency and demand.","operationId":"vote_agent_feedback_api_v1_oracle_agent_feedback__feedback_id__vote_post","parameters":[{"name":"feedback_id","in":"path","required":true,"schema":{"type":"string","description":"ID of the proposal (e.g. PROP-LME-2026-01)","title":"Feedback Id"},"description":"ID of the proposal (e.g. PROP-LME-2026-01)"}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/AgentFeedbackVoteRequest"},{"type":"null"}],"title":"Vote Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/vault/register":{"post":{"tags":["Agent Payment Vault"],"summary":"Register Agent Vault","description":"Self-service registration for autonomous AI agents.\nInstantly returns a dedicated session key and seeds an initial free trial balance (e.g. 0.05 USDC).","operationId":"register_agent_vault_api_v1_vault_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRegisterRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRegisterResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/vault/account":{"get":{"tags":["Agent Payment Vault"],"summary":"Get Vault Account","description":"Retrieves vault balance, consumption, and query capacity for an agent.\nCan be authenticated via header ('X-Agent-Vault-Key' or 'Authorization: Bearer ...') or query param.","operationId":"get_vault_account_api_v1_vault_account_get","parameters":[{"name":"identifier","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultBalanceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/vault/receipts/{receipt_id}":{"get":{"tags":["Agent Payment Vault"],"summary":"Get Vault Payment Receipt","description":"Retrieves an EIP-712 cryptographically signed PaymentReceipt issued to an agent.","operationId":"get_vault_payment_receipt_api_v1_vault_receipts__receipt_id__get","parameters":[{"name":"receipt_id","in":"path","required":true,"schema":{"type":"string","title":"Receipt Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/vault/verify-receipt":{"post":{"tags":["Agent Payment Vault"],"summary":"Verify Payment Receipt","description":"Cryptographically verifies that a PaymentReceipt was signed by the Minerals Oracle authority.\nReturns boolean verification status and recovered signer address.","operationId":"verify_payment_receipt_api_v1_vault_verify_receipt_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/oracle/simulate-rfq":{"post":{"tags":["Autonomous Procurement"],"summary":"Simulate Procurement Rfq","description":"Simulates a multi-mineral procurement RFQ for EV battery packs.\nEvaluates US IRA 50% FTA threshold and FEOC 25% taint propagation before placing contracts.","operationId":"simulate_procurement_rfq_api_v1_oracle_simulate_rfq_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProcurementRFQRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProcurementRFQResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/trade/flows":{"get":{"tags":["Global Trade & Logistics"],"summary":"Get Trade Flows","description":"Returns global critical mineral physical trade corridor flows, monthly bulk tonnages,\nstandard transit days, vessel classes, and maritime chokepoints.","operationId":"get_trade_flows_api_v1_trade_flows_get","parameters":[{"name":"mineral_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/MineralType"},{"type":"null"}],"title":"Mineral Type"}},{"name":"origin_country","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SourceCountry"},{"type":"null"}],"title":"Origin Country"}},{"name":"destination_country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destination Country"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TradeCorridorFlow"},"title":"Response Get Trade Flows Api V1 Trade Flows Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/trade/tariffs":{"post":{"tags":["Global Trade & Logistics"],"summary":"Get Trade Tariffs","description":"Resolves WCO 6-digit Harmonized System (HS) Code, general MFN duty rate,\napplicable FTA preferential duty rate, US Section 301 punitive tariff, and EU CBAM benchmarks.","operationId":"get_trade_tariffs_api_v1_trade_tariffs_post","parameters":[{"name":"mineral_type","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MineralType"}},{"name":"importer_jurisdiction","in":"query","required":false,"schema":{"type":"string","default":"USA","title":"Importer Jurisdiction"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HSCodeTariffInfo"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/trade/maritime-route":{"post":{"tags":["Global Trade & Logistics"],"summary":"Calculate Maritime Route","description":"Calculates maritime voyage distance (nautical miles), transit duration,\nfreight charter costs, chokepoint detour surcharges (e.g. Red Sea / Panama Canal),\nIMO MARPOL CII carbon rating, and EU CBAM ETS carbon costs.","operationId":"calculate_maritime_route_api_v1_trade_maritime_route_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MaritimeRouteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MaritimeRouteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/trade/verify-ebl":{"post":{"tags":["Global Trade & Logistics"],"summary":"Verify Electronic Bill Of Lading","description":"Cryptographically audits UNCITRAL MLETR / FIT Alliance electronic Bill of Lading (eBL).\nValidates 7-digit IMO checksum, UN/LOCODE port pairs, manifest weight, and screens for AIS dark fleet anomalies.","operationId":"verify_electronic_bill_of_lading_api_v1_trade_verify_ebl_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EBLVerificationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EBLVerificationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/trade/optimize-route":{"post":{"tags":["Global Trade & Logistics"],"summary":"Optimize Mineral Trade Route","description":"Autonomous trade route optimizer for AI procurement agents.\nCompares direct marine transit vs chokepoint detour corridors, computing landed cost arbitrage ($/MT),\ntotal freight and tariffs, and delivery timelines.","operationId":"optimize_mineral_trade_route_api_v1_trade_optimize_route_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeRouteOptimizationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeRouteOptimizationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agent/session/open":{"post":{"tags":["Agent Protocol"],"summary":"Open high-speed micro-allowance session for autonomous AI agents","description":"Opens a high-speed allowance session for sub-millisecond query execution without per-request on-chain gas.","operationId":"open_agent_session_route_api_v1_agent_session_open_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSessionOpenRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agent/session/{session_token}":{"get":{"tags":["Agent Protocol"],"summary":"Query real-time balance and query capacity for an active session without debiting","description":"Retrieves session metadata, allocated/current balance, and remaining query capacity.","operationId":"get_agent_session_route_api_v1_agent_session__session_token__get","parameters":[{"name":"session_token","in":"path","required":true,"schema":{"type":"string","title":"Session Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSessionInfoResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agent/session/close":{"post":{"tags":["Agent Protocol"],"summary":"Close active agent session, compute refund, and issue settlement receipt","description":"Closes an active session, issues an immutable receipt hash, and frees remaining unspent balance.","operationId":"close_agent_session_route_api_v1_agent_session_close_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSessionCloseRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSessionCloseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agent/webhooks/register":{"post":{"tags":["Agent Protocol"],"summary":"Register a Webhook endpoint for autonomous A2A trade event push notifications","description":"Registers callback URL with HMAC-SHA256 authentication for trade proposals and attestations.","operationId":"register_agent_webhook_route_api_v1_agent_webhooks_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentWebhookRegistrationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentWebhookRegistrationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agent/webhooks/{agent_address}":{"get":{"tags":["Agent Protocol"],"summary":"List active webhook subscriptions for an agent EVM address","description":"Retrieves all registered webhooks for an agent address.","operationId":"list_agent_webhooks_route_api_v1_agent_webhooks__agent_address__get","parameters":[{"name":"agent_address","in":"path","required":true,"schema":{"type":"string","title":"Agent Address"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agent/webhooks/{webhook_id}":{"delete":{"tags":["Agent Protocol"],"summary":"Unregister an active webhook subscription","description":"Removes a registered webhook by ID.","operationId":"delete_agent_webhook_route_api_v1_agent_webhooks__webhook_id__delete","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","title":"Webhook Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/deals/propose":{"post":{"tags":["A2A Autonomous Settlement"],"summary":"Seller Agent proposes canonical critical mineral trade agreement with cryptographic signature","description":"Registers a bilateral trade deal proposal signed by seller agent.","operationId":"propose_a2a_deal_route_api_v1_a2a_deals_propose_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeDealProposeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeDealAttestation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/deals/dual-sign":{"post":{"tags":["A2A Autonomous Settlement"],"summary":"Buyer Agent countersigns trade proposal; Oracle mints immutable 3-party deal attestation","description":"Countersigns proposal and triggers Oracle attestation seal to finalize the contract.","operationId":"dual_sign_a2a_deal_route_api_v1_a2a_deals_dual_sign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeDealDualSignRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeDealAttestation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/deals/reject":{"post":{"tags":["A2A Autonomous Settlement"],"summary":"Buyer Agent rejects proposed deal terms or pricing","description":"Marks proposal as REJECTED and records buyer rejection reasoning.","operationId":"reject_a2a_deal_route_api_v1_a2a_deals_reject_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeDealRejectRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeDealAttestation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/deals/cancel":{"post":{"tags":["A2A Autonomous Settlement"],"summary":"Seller Agent cancels/revokes proposal before countersignature","description":"Revokes a pending proposal before buyer countersigns.","operationId":"cancel_a2a_deal_route_api_v1_a2a_deals_cancel_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeDealCancelRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeDealAttestation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/deals/{deal_id}":{"get":{"tags":["A2A Autonomous Settlement"],"summary":"Retrieve full specification and audit status of an A2A trade deal","description":"Retrieves full specification, status, and audit notes of a deal.","operationId":"get_a2a_deal_route_api_v1_a2a_deals__deal_id__get","parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","title":"Deal Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/deals/by-agent/{agent_address}":{"get":{"tags":["A2A Autonomous Settlement"],"summary":"List active or historic bilateral deals associated with an agent address","description":"Filters all bilateral agreements for an agent address.","operationId":"list_a2a_deals_route_api_v1_a2a_deals_by_agent__agent_address__get","parameters":[{"name":"agent_address","in":"path","required":true,"schema":{"type":"string","title":"Agent Address"}},{"name":"status_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Filter"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeDealListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/deals/verify/{deal_id}":{"get":{"tags":["A2A Autonomous Settlement"],"summary":"Audit cryptographic signatures and regulatory compliance of a dual-signed A2A trade deal","description":"Audits seller, buyer, and oracle signatures along with FEOC and mass-balance compliance.","operationId":"verify_a2a_deal_route_api_v1_a2a_deals_verify__deal_id__get","parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","title":"Deal Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeDealVerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/deals/{deal_id}/escrow-calldata":{"get":{"tags":["A2A Autonomous Settlement"],"summary":"Generate EVM calldata and transaction parameters for locking USDC into MineralTradeEscrow","description":"Generates precise EVM transaction calldata for buyer agent to deposit funds into MineralTradeEscrow.","operationId":"get_deal_escrow_calldata_route_api_v1_a2a_deals__deal_id__escrow_calldata_get","parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","title":"Deal Id"}},{"name":"escrow_contract_address","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Escrow Contract Address"}},{"name":"chain_name","in":"query","required":false,"schema":{"type":"string","default":"polygon","title":"Chain Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp/tools":{"get":{"tags":["MCP Tools"],"summary":"Get Mcp Tool Specs","description":"Returns Model Context Protocol (MCP) tool specifications for autonomous AI agents.","operationId":"get_mcp_tool_specs_mcp_tools_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp/invoke":{"post":{"tags":["MCP Tools"],"summary":"Invoke Mcp Tool","description":"Direct MCP tool dispatcher for LLM agents. Protected with x402 payment validation for data queries.\nEvolution & feedback tools are free to encourage open autonomous agent contributions.","operationId":"invoke_mcp_tool_mcp_invoke_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPToolCallRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPToolCallResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp/sse":{"get":{"tags":["Agent Protocol"],"summary":"Remote MCP over SSE Transport connection endpoint","description":"Establishes Server-Sent Events (SSE) stream for remote LLM agent clients (Claude Desktop, Cursor, ElizaOS).\nEmits initial 'endpoint' event with unique sessionId and streams tool call responses.","operationId":"mcp_sse_endpoint_mcp_sse_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp/messages":{"post":{"tags":["Agent Protocol"],"summary":"Receive JSON-RPC 2.0 messages for remote MCP over SSE sessions","description":"Processes JSON-RPC 2.0 MCP requests and pushes responses back through the client's SSE stream.","operationId":"mcp_messages_endpoint_mcp_messages_post","parameters":[{"name":"sessionId","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sessionid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/oracle/consensus-price":{"get":{"tags":["Commodity Pricing"],"summary":"Multi-Oracle Consensus Medianizer (Pyth Hermes v2 + Statutory LME/CME benchmark)","description":"Returns hybrid tamper-resistant commodity spot price aggregated from Pyth Network\nand statutory international physical benchmarks.","operationId":"get_consensus_price_endpoint_api_v1_oracle_consensus_price_get","parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"Commodity symbol (e.g. Cu, Ag, Li, Ni, Co, CARBON, EU_ETS)","title":"Symbol"},"description":"Commodity symbol (e.g. Cu, Ag, Li, Ni, Co, CARBON, EU_ETS)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/trade/cbam-liability":{"get":{"tags":["Global Trade & Logistics"],"summary":"Calculate EU CBAM (Carbon Border Adjustment Mechanism) carbon tax liability","description":"Calculates embedded CO2 tonnage and financial CBAM carbon import certificate liability\ngrounded in live EU ETS carbon credit allowance pricing.","operationId":"calculate_cbam_liability_endpoint_api_v1_trade_cbam_liability_get","parameters":[{"name":"mineral_type","in":"query","required":true,"schema":{"type":"string","description":"Commodity type (e.g. LITHIUM_HYDROXIDE, NICKEL_MHP)","title":"Mineral Type"},"description":"Commodity type (e.g. LITHIUM_HYDROXIDE, NICKEL_MHP)"},{"name":"cargo_weight_metric_tons","in":"query","required":true,"schema":{"type":"number","minimum":0.1,"description":"Shipment volume in MT","title":"Cargo Weight Metric Tons"},"description":"Shipment volume in MT"},{"name":"importer_jurisdiction","in":"query","required":false,"schema":{"type":"string","description":"Importing territory (e.g. EU, US, JP)","default":"EU","title":"Importer Jurisdiction"},"description":"Importing territory (e.g. EU, US, JP)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/escrow/universal/settle-minerals":{"post":{"tags":["Security Gate x402 Escrow Rail"],"summary":"Request Conflict-Free Minerals Truth Attestation and Disburse Universal Escrow","description":"End-to-End Interoperability Bridge (Domain 4: CONFLICT_MINERALS):\n1. Obtains cryptographic EIP-712 MineralsTruthAttestation from security-gate-x402.\n2. Atomically triggers 0.1s Direct Split disbursement to miners, logistics, and refiners.","operationId":"settle_minerals_universal_escrow_endpoint_api_v1_escrow_universal_settle_minerals_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MineralsUniversalSettleRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/escrow/universal/settle-eudr":{"post":{"tags":["Security Gate x402 Escrow Rail"],"summary":"Request EUDR Deforestation-Free Truth Attestation and Disburse Universal Escrow","description":"EUDR Domain 3 Universal Escrow Interoperability Bridge:\n1. Obtains cryptographic EIP-712 EUDRTruthAttestation from security-gate-x402.\n2. Atomically triggers 0.1s Direct Split disbursement for compliant forest commodities.","operationId":"settle_eudr_universal_escrow_endpoint_api_v1_escrow_universal_settle_eudr_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EudrUniversalSettleRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AgentActionType":{"type":"string","enum":["PROCEED_SETTLEMENT","EXECUTE_PURCHASE","ABORT_FEOC_VIOLATION","ABORT_DARK_FLEET","REROUTE_PANAMA_BOTTLENECK","REROUTE_RED_SEA_CONFLICT","REJECT_MASS_BALANCE_MISMATCH","FLAG_DOCUMENT_INVALID","HOLD_FOR_ASSAY_CLARIFICATION"],"title":"AgentActionType"},"AgentDecisionSignal":{"properties":{"action":{"$ref":"#/components/schemas/AgentActionType","description":"Deterministic machine control flag for the calling agent"},"confidence_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence Score","description":"Confidence rating from 0.0 to 1.0"},"risk_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Risk Score","description":"Calculated aggregate operational/regulatory risk"},"bottlenecks":{"items":{"type":"string"},"type":"array","title":"Bottlenecks","description":"Identified logistics or legal bottlenecks"},"recommended_action":{"type":"string","title":"Recommended Action","description":"Explicit next-step instruction for the calling agent"},"projected_cost_delta_usd":{"type":"number","title":"Projected Cost Delta Usd","description":"Projected dollar savings (positive) or penalty (negative)","default":0.0},"actionable_command":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actionable Command","description":"Ready-to-execute next MCP tool call snippet"}},"type":"object","required":["action","confidence_score","risk_score","recommended_action"],"title":"AgentDecisionSignal"},"AgentFeedbackListResponse":{"properties":{"status":{"type":"string","title":"Status"},"total_proposals":{"type":"integer","title":"Total Proposals"},"items":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Items"},"meta":{"additionalProperties":true,"type":"object","title":"Meta"}},"type":"object","required":["status","total_proposals","items","meta"],"title":"AgentFeedbackListResponse"},"AgentFeedbackResponse":{"properties":{"status":{"type":"string","title":"Status"},"feedback_id":{"type":"string","title":"Feedback Id"},"message":{"type":"string","title":"Message"},"created_at_utc":{"type":"string","title":"Created At Utc"},"proposal":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Proposal"},"meta":{"additionalProperties":true,"type":"object","title":"Meta"}},"type":"object","required":["status","feedback_id","message","created_at_utc","meta"],"title":"AgentFeedbackResponse"},"AgentFeedbackSubmitRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id","description":"Unique identifier of the calling AI agent or operator (e.g., 'tesla-procure-agent-09', 'battery-passport-evaluator')","examples":["procurement-agent-alpha-42"]},"feedback_type":{"type":"string","title":"Feedback Type","description":"Category: FEATURE_REQUEST, PROTOCOL_PROPOSAL, EDGE_CASE, DATASET_SUGGESTION, or COMPLIANCE_RULE","default":"FEATURE_REQUEST"},"mineral_focus":{"type":"string","title":"Mineral Focus","description":"Target mineral: LITHIUM, COBALT, NICKEL, GRAPHITE, RARE_EARTHS, MANGANESE, or ALL","default":"ALL"},"title":{"type":"string","maxLength":256,"minLength":5,"title":"Title","description":"Concise summary of the proposed improvement or discovered edge case"},"content":{"type":"string","minLength":10,"title":"Content","description":"Detailed description, rationale, regulatory reference, or observed issue"},"proposed_solution":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proposed Solution","description":"Suggested technical, architectural, or regulatory resolution"},"caller_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caller Model","description":"LLM / Agent model underpinning the caller (e.g., 'claude-3-5-sonnet', 'gemini-1.5-pro', 'gpt-4o')"},"contact_channel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Channel","description":"Agent callback URL, ENS domain, or wallet address for receipt notification"}},"type":"object","required":["agent_id","title","content"],"title":"AgentFeedbackSubmitRequest"},"AgentFeedbackVoteRequest":{"properties":{"voter_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voter Agent Id","description":"Agent identifier casting the vote (optional)"}},"type":"object","title":"AgentFeedbackVoteRequest"},"AgentOnboardRequest":{"properties":{"agent_name":{"type":"string","title":"Agent Name","default":"AnonymousAutonomousAgent"},"agent_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Address"},"requested_network":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Requested Network","default":"polygon"}},"type":"object","title":"AgentOnboardRequest"},"AgentRegisterRequest":{"properties":{"agent_name":{"type":"string","title":"Agent Name","description":"Name or identifier of calling autonomous agent"},"agent_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Address","description":"Optional Polygon wallet address (0x...)"},"initial_trial_balance_usdc":{"type":"number","minimum":0.0,"title":"Initial Trial Balance Usdc","description":"Trial balance granted on self-onboarding","default":0.05}},"type":"object","required":["agent_name"],"title":"AgentRegisterRequest"},"AgentRegisterResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"agent_name":{"type":"string","title":"Agent Name"},"agent_address":{"type":"string","title":"Agent Address"},"session_key":{"type":"string","title":"Session Key"},"balance_usdc":{"type":"number","title":"Balance Usdc"},"message":{"type":"string","title":"Message"},"capacity":{"additionalProperties":{"type":"integer"},"type":"object","title":"Capacity"},"created_at_utc":{"type":"string","title":"Created At Utc"}},"type":"object","required":["agent_name","agent_address","session_key","balance_usdc","message","capacity","created_at_utc"],"title":"AgentRegisterResponse"},"AgentSessionCloseRequest":{"properties":{"session_token":{"type":"string","title":"Session Token","description":"Active session token to terminate"},"agent_address":{"type":"string","title":"Agent Address","description":"Agent wallet address"}},"type":"object","required":["session_token","agent_address"],"title":"AgentSessionCloseRequest"},"AgentSessionCloseResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"session_token":{"type":"string","title":"Session Token"},"agent_address":{"type":"string","title":"Agent Address"},"queries_executed":{"type":"integer","title":"Queries Executed"},"total_consumed_usdc":{"type":"number","title":"Total Consumed Usdc"},"refunded_balance_usdc":{"type":"number","title":"Refunded Balance Usdc"},"settlement_receipt_hash":{"type":"string","title":"Settlement Receipt Hash"},"closed_at_utc":{"type":"string","title":"Closed At Utc"}},"type":"object","required":["session_token","agent_address","queries_executed","total_consumed_usdc","refunded_balance_usdc","settlement_receipt_hash","closed_at_utc"],"title":"AgentSessionCloseResponse"},"AgentSessionInfoResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"session_token":{"type":"string","title":"Session Token"},"agent_address":{"type":"string","title":"Agent Address"},"allocated_balance_usdc":{"type":"number","title":"Allocated Balance Usdc"},"current_balance_usdc":{"type":"number","title":"Current Balance Usdc"},"queries_executed":{"type":"integer","title":"Queries Executed"},"per_query_cost_usdc":{"type":"number","title":"Per Query Cost Usdc","default":0.05},"remaining_queries_capacity":{"type":"integer","title":"Remaining Queries Capacity"},"status_label":{"type":"string","title":"Status Label"},"expires_at_utc":{"type":"string","title":"Expires At Utc"},"created_at_utc":{"type":"string","title":"Created At Utc"}},"type":"object","required":["session_token","agent_address","allocated_balance_usdc","current_balance_usdc","queries_executed","remaining_queries_capacity","status_label","expires_at_utc","created_at_utc"],"title":"AgentSessionInfoResponse"},"AgentSessionOpenRequest":{"properties":{"agent_address":{"type":"string","title":"Agent Address","description":"Calling agent EVM wallet address (0x...)"},"deposit_amount_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Deposit Amount Usdc","description":"USDC amount to deposit/lock for high-speed micro-queries","default":10.0},"session_duration_hours":{"type":"integer","maximum":168.0,"minimum":1.0,"title":"Session Duration Hours","description":"Session validity in hours (1-168)","default":24},"signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signature","description":"Optional EIP-712 deposit authorization signature"}},"type":"object","required":["agent_address"],"title":"AgentSessionOpenRequest"},"AgentSessionResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"session_token":{"type":"string","title":"Session Token"},"agent_address":{"type":"string","title":"Agent Address"},"allocated_balance_usdc":{"type":"number","title":"Allocated Balance Usdc"},"per_query_cost_usdc":{"type":"number","title":"Per Query Cost Usdc","default":0.05},"remaining_queries_capacity":{"type":"integer","title":"Remaining Queries Capacity"},"expires_at_utc":{"type":"string","title":"Expires At Utc"},"created_at_utc":{"type":"string","title":"Created At Utc"}},"type":"object","required":["session_token","agent_address","allocated_balance_usdc","remaining_queries_capacity","expires_at_utc","created_at_utc"],"title":"AgentSessionResponse"},"AgentWebhookRegistrationRequest":{"properties":{"agent_address":{"type":"string","title":"Agent Address","description":"Agent EVM address (0x...) or '*' for broadcast"},"callback_url":{"type":"string","title":"Callback Url","description":"HTTP/HTTPS webhook callback endpoint"},"subscribed_events":{"items":{"type":"string"},"type":"array","title":"Subscribed Events","description":"Event types to subscribe to (e.g. ['deal.proposed', 'deal.dual_signed'])","default":["*"]},"webhook_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook Secret","description":"Optional shared secret for HMAC-SHA256 signing (auto-generated if omitted)"}},"type":"object","required":["agent_address","callback_url"],"title":"AgentWebhookRegistrationRequest"},"AgentWebhookRegistrationResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"webhook_id":{"type":"string","title":"Webhook Id"},"agent_address":{"type":"string","title":"Agent Address"},"callback_url":{"type":"string","title":"Callback Url"},"subscribed_events":{"items":{"type":"string"},"type":"array","title":"Subscribed Events"},"webhook_secret":{"type":"string","title":"Webhook Secret"},"created_at_utc":{"type":"string","title":"Created At Utc"}},"type":"object","required":["webhook_id","agent_address","callback_url","subscribed_events","webhook_secret","created_at_utc"],"title":"AgentWebhookRegistrationResponse"},"BatteryPassportVCRequest":{"properties":{"battery_id":{"type":"string","title":"Battery Id","description":"Unique battery pack serial/DID (e.g. urn:uuid:...)"},"chemistry":{"type":"string","title":"Chemistry","description":"Battery chemistry: NMC811, LFP, NCMA","default":"NMC811"},"rated_capacity_kwh":{"type":"number","exclusiveMinimum":0.0,"title":"Rated Capacity Kwh","description":"Rated energy capacity in kWh"},"recycled_cobalt_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Recycled Cobalt Pct","description":"Recycled cobalt content %","default":16.0},"recycled_lithium_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Recycled Lithium Pct","description":"Recycled lithium content %","default":6.0},"recycled_nickel_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Recycled Nickel Pct","description":"Recycled nickel content %","default":6.0},"carbon_footprint_kg_co2_per_kwh":{"type":"number","exclusiveMinimum":0.0,"title":"Carbon Footprint Kg Co2 Per Kwh","description":"Total lifecycle footprint kg CO2e/kWh","default":68.5},"provenance_proof_hash":{"type":"string","title":"Provenance Proof Hash","description":"A.GRID upstream mineral verification proof hash"}},"type":"object","required":["battery_id","rated_capacity_kwh","provenance_proof_hash"],"title":"BatteryPassportVCRequest"},"BatteryPassportVCResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"battery_id":{"type":"string","title":"Battery Id"},"vc_token":{"additionalProperties":true,"type":"object","title":"Vc Token"},"did_issuer":{"type":"string","title":"Did Issuer"},"did_subject":{"type":"string","title":"Did Subject"},"qr_code_payload_uri":{"type":"string","title":"Qr Code Payload Uri"},"signature":{"type":"string","title":"Signature"},"issued_at":{"type":"string","title":"Issued At"}},"type":"object","required":["battery_id","vc_token","did_issuer","did_subject","qr_code_payload_uri","signature","issued_at"],"title":"BatteryPassportVCResponse"},"BlackMassAuditVerdict":{"properties":{"is_compliant":{"type":"boolean","title":"Is Compliant"},"status":{"type":"string","title":"Status"},"geofence_verified":{"type":"boolean","title":"Geofence Verified"},"distance_to_facility_km":{"type":"number","title":"Distance To Facility Km"},"bis_license_verified":{"type":"boolean","title":"Bis License Verified"},"recycled_content_compliant":{"type":"boolean","title":"Recycled Content Compliant"},"fluorine_safety_passed":{"type":"boolean","title":"Fluorine Safety Passed"},"eu_battery_reg_eligible":{"type":"boolean","title":"Eu Battery Reg Eligible"},"confidence_score":{"type":"number","title":"Confidence Score"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"}},"type":"object","required":["is_compliant","status","geofence_verified","distance_to_facility_km","bis_license_verified","recycled_content_compliant","fluorine_safety_passed","eu_battery_reg_eligible","confidence_score","reasons"],"title":"BlackMassAuditVerdict"},"BlackMassOriginVerifyRequest":{"properties":{"batch_id":{"type":"string","title":"Batch Id","description":"Recycled black mass batch/lot identifier"},"facility_id":{"type":"string","title":"Facility Id","description":"Hydrometallurgical/shredding facility ID"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"nickel_content_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Nickel Content Pct","description":"Recovered Nickel metal content %","default":22.5},"cobalt_content_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Cobalt Content Pct","description":"Recovered Cobalt metal content %","default":8.5},"lithium_content_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Lithium Content Pct","description":"Recovered Lithium metal content %","default":4.2},"fluorine_impurity_ppm":{"type":"number","minimum":0.0,"title":"Fluorine Impurity Ppm","description":"Fluorine / PVDF residue in ppm (Threshold <= 500 ppm)","default":180.0},"bis_export_license_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bis Export License Id","description":"US BIS Export License Number (e.g. BIS-D123456)"},"recycled_content_ratio":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Recycled Content Ratio","description":"EU Battery Regulation 2023/1542 recycled mass ratio","default":0.98},"source_country":{"$ref":"#/components/schemas/SourceCountry","default":"USA"},"client_identity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Identity"}},"type":"object","required":["batch_id","facility_id","latitude","longitude"],"title":"BlackMassOriginVerifyRequest"},"BlackMassOriginVerifyResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"batch_id":{"type":"string","title":"Batch Id"},"audit_verdict":{"$ref":"#/components/schemas/BlackMassAuditVerdict"},"proof_hash":{"type":"string","title":"Proof Hash"},"onchain_signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Onchain Signature"},"signed_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signed By"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["batch_id","audit_verdict","proof_hash","timestamp"],"title":"BlackMassOriginVerifyResponse"},"CBAMMarkupPenaltyRequest":{"properties":{"import_year":{"type":"integer","maximum":2035.0,"minimum":2026.0,"title":"Import Year","description":"Year of customs entry into EU","default":2026},"product_category":{"type":"string","title":"Product Category","description":"CBAM Annex I goods category","default":"STEEL_ALUMINUM_HYDROGEN"},"tonnage":{"type":"number","exclusiveMinimum":0.0,"title":"Tonnage","description":"Metric tons of imported goods"},"default_embedded_emissions_tco2_per_ton":{"type":"number","exclusiveMinimum":0.0,"title":"Default Embedded Emissions Tco2 Per Ton","description":"EU Default emission factor tCO2e/t","default":2.1},"verified_scope1_2_emissions_tco2_per_ton":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Verified Scope1 2 Emissions Tco2 Per Ton","description":"Accredited 3rd party verified specific emissions"},"eu_allowance_price_eur":{"type":"number","exclusiveMinimum":0.0,"title":"Eu Allowance Price Eur","description":"EUA carbon price in EUR/tCO2","default":85.0}},"type":"object","required":["tonnage"],"title":"CBAMMarkupPenaltyRequest"},"CBAMMarkupPenaltyResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"import_year":{"type":"integer","title":"Import Year"},"markup_penalty_rate":{"type":"number","title":"Markup Penalty Rate"},"is_verified_exempt":{"type":"boolean","title":"Is Verified Exempt"},"total_default_emissions_tco2":{"type":"number","title":"Total Default Emissions Tco2"},"total_verified_emissions_tco2":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Verified Emissions Tco2"},"effective_emissions_billed_tco2":{"type":"number","title":"Effective Emissions Billed Tco2"},"total_cbam_liability_eur":{"type":"number","title":"Total Cbam Liability Eur"},"markup_penalty_surcharge_eur":{"type":"number","title":"Markup Penalty Surcharge Eur"},"savings_with_verified_report_eur":{"type":"number","title":"Savings With Verified Report Eur"},"audit_advice":{"type":"string","title":"Audit Advice"}},"type":"object","required":["import_year","markup_penalty_rate","is_verified_exempt","total_default_emissions_tco2","effective_emissions_billed_tco2","total_cbam_liability_eur","markup_penalty_surcharge_eur","savings_with_verified_report_eur","audit_advice"],"title":"CBAMMarkupPenaltyResponse"},"CobaltAuditVerdict":{"properties":{"ceec_export_cleared":{"type":"boolean","title":"Ceec Export Cleared","description":"Cleared under DRC Mining Code Loi n° 18/001 via CEEC tamper-proof seal"},"asm_segregated":{"type":"boolean","title":"Asm Segregated","description":"Free of uncontrolled artisanal co-mingling; compliant with OECD Annex II Red Flags"},"rmi_rmap_certified":{"type":"boolean","title":"Rmi Rmap Certified","description":"Smelter holds active RMI Responsible Minerals Assurance Process certification"},"child_labor_free":{"type":"boolean","title":"Child Labor Free","description":"Certified zero child labor under ILO Conventions 138 & 182"},"ira_feoc_compliant":{"type":"boolean","title":"Ira Feoc Compliant","description":"Covered nation equity < 25.0%; eligible for US IRA 30D tax credit"},"confidence_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Confidence Score","description":"Algorithmic confidence rating (0-100)"},"defenses_applied":{"items":{"type":"string"},"type":"array","title":"Defenses Applied"}},"type":"object","required":["ceec_export_cleared","asm_segregated","rmi_rmap_certified","child_labor_free","ira_feoc_compliant","confidence_score"],"title":"CobaltAuditVerdict"},"CobaltConcessionEvidence":{"properties":{"concession_name":{"type":"string","title":"Concession Name"},"province":{"type":"string","title":"Province"},"coordinates":{"items":{"type":"number"},"type":"array","title":"Coordinates"},"geofence_distance_km":{"type":"number","title":"Geofence Distance Km"},"geofence_passed":{"type":"boolean","title":"Geofence Passed"},"mine_type":{"type":"string","title":"Mine Type"},"ceec_seal_verified":{"type":"boolean","title":"Ceec Seal Verified"},"egc_custody_verified":{"type":"boolean","title":"Egc Custody Verified"},"child_labor_audit_verified":{"type":"boolean","title":"Child Labor Audit Verified"}},"type":"object","required":["concession_name","province","coordinates","geofence_distance_km","geofence_passed","mine_type","ceec_seal_verified","egc_custody_verified","child_labor_audit_verified"],"title":"CobaltConcessionEvidence"},"CobaltMassBalanceEvidence":{"properties":{"heterogenite_input_tons":{"type":"number","title":"Heterogenite Input Tons"},"hydroxide_output_tons":{"type":"number","title":"Hydroxide Output Tons"},"theoretical_required_ore_tons":{"type":"number","title":"Theoretical Required Ore Tons"},"discrepancy_pct":{"type":"number","title":"Discrepancy Pct"},"is_stoichiometrically_sound":{"type":"boolean","title":"Is Stoichiometrically Sound"},"hydrometallurgical_recovery_pct":{"type":"number","title":"Hydrometallurgical Recovery Pct"}},"type":"object","required":["heterogenite_input_tons","hydroxide_output_tons","theoretical_required_ore_tons","discrepancy_pct","is_stoichiometrically_sound","hydrometallurgical_recovery_pct"],"title":"CobaltMassBalanceEvidence"},"CobaltOriginVerifyRequest":{"properties":{"trace_id":{"type":"string","title":"Trace Id","description":"Unique traceability batch identifier (e.g. COB-COD-2026-HYD01)"},"product":{"type":"string","title":"Product","description":"Beneficiated intermediate product form","default":"Crude Cobalt Hydroxide"},"concession_name":{"type":"string","title":"Concession Name","description":"Mining concession name (e.g. Tenke Fungurume, Kamoto Copper Company, Mutanda Mining)"},"province":{"type":"string","title":"Province","description":"DRC Province (e.g. Lualaba, Haut-Katanga)","default":"Lualaba"},"coordinates":{"items":{"type":"number"},"type":"array","maxItems":2,"minItems":2,"title":"Coordinates","description":"[Latitude, Longitude] centroid of extraction pit"},"mine_type":{"type":"string","title":"Mine Type","description":"Extraction scale: Large-Scale Mining ('LSM') or Artisanal & Small-scale ('ASM')","default":"LSM"},"ceec_seal_id":{"type":"string","title":"Ceec Seal Id","description":"DRC CEEC (Centre d'Expertise) tamper-proof barcode seal / export certificate"},"egc_custody_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Egc Custody Ref","description":"Entreprise Générale du Cobalt (EGC) custody reference if ASM involvement"},"asm_comingled":{"type":"boolean","title":"Asm Comingled","description":"True if uncertified artisanal ore was co-mingled into industrial lot (Trap 1 risk)","default":false},"zero_child_labor_audit_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zero Child Labor Audit Ref","description":"Independent ILO 138/182 zero child labor verification certificate hash/ID"},"heterogenite_ore_input_tons":{"type":"number","exclusiveMinimum":0.0,"title":"Heterogenite Ore Input Tons","description":"Gross heterogenite/copper-cobalt ore input in metric tons"},"ore_grade_co_pct":{"type":"number","maximum":10.0,"minimum":0.2,"title":"Ore Grade Co Pct","description":"Cobalt grade in run-of-mine ore % (standard 1.0% ~ 2.5%)","default":1.5},"refinery_name":{"type":"string","title":"Refinery Name","description":"Refinery / hydrometallurgical leaching plant name"},"refinery_country":{"type":"string","title":"Refinery Country","description":"Country of primary refining (e.g. COD, FIN, CHN)","default":"COD"},"rmi_rmap_smelter_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rmi Rmap Smelter Id","description":"Responsible Minerals Initiative (RMI) RMAP audited smelter ID"},"cobalt_hydroxide_output_tons":{"type":"number","exclusiveMinimum":0.0,"title":"Cobalt Hydroxide Output Tons","description":"Refined crude cobalt hydroxide output in metric tons"},"hydroxide_grade_co_pct":{"type":"number","maximum":45.0,"minimum":15.0,"title":"Hydroxide Grade Co Pct","description":"Cobalt metal content % in hydroxide (standard ~30.0%)","default":30.0},"feoc_equity_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Feoc Equity Pct","description":"Covered nation entity equity/voting share in operator (cap < 25%)","default":0.0},"agent_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Address","description":"Calling agent Polygon wallet address for receipt generation"}},"type":"object","required":["trace_id","concession_name","coordinates","ceec_seal_id","heterogenite_ore_input_tons","refinery_name","cobalt_hydroxide_output_tons"],"title":"CobaltOriginVerifyRequest"},"CobaltOriginVerifyResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"trace_id":{"type":"string","title":"Trace Id"},"product":{"type":"string","title":"Product"},"extraction_concession":{"$ref":"#/components/schemas/CobaltConcessionEvidence"},"refining_facility":{"additionalProperties":true,"type":"object","title":"Refining Facility"},"mass_balance_audit":{"$ref":"#/components/schemas/CobaltMassBalanceEvidence"},"audit_verdict":{"$ref":"#/components/schemas/CobaltAuditVerdict"},"onchain_proof":{"type":"string","title":"Onchain Proof"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["trace_id","product","extraction_concession","refining_facility","mass_balance_audit","audit_verdict","onchain_proof","timestamp"],"title":"CobaltOriginVerifyResponse"},"CompliancePassportResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"oracle":{"type":"string","title":"Oracle","default":"minerals-oracle-x402"},"version":{"type":"string","title":"Version","default":"2.0.0"},"lot_id":{"type":"string","title":"Lot Id"},"mineral_type":{"$ref":"#/components/schemas/MineralType"},"source_country":{"$ref":"#/components/schemas/SourceCountry"},"net_weight_metric_tons":{"type":"number","title":"Net Weight Metric Tons"},"timestamp_utc":{"type":"string","title":"Timestamp Utc"},"network":{"type":"string","title":"Network","default":"Polygon (Chain ID 137)"},"verdict":{"$ref":"#/components/schemas/ComplianceVerdict"},"passport_qr_data":{"type":"string","title":"Passport Qr Data"},"attestation_digest":{"type":"string","title":"Attestation Digest"},"legal_disclaimer":{"$ref":"#/components/schemas/LegalDisclaimerRecord","description":"Legally binding terms of algorithmic limitation and fee-capped liability"},"eip712_signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Eip712 Signature","description":"ECDSA EIP-712 structured cryptographic signature"},"onchain_anchor_tx":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Onchain Anchor Tx","description":"Polygon transaction hash if anchored"},"security_attestation":{"anyOf":[{"$ref":"#/components/schemas/SecurityAttestation"},{"type":"null"}]}},"type":"object","required":["lot_id","mineral_type","source_country","net_weight_metric_tons","timestamp_utc","verdict","passport_qr_data","attestation_digest","legal_disclaimer"],"title":"CompliancePassportResponse"},"ComplianceVerdict":{"properties":{"overall_compliance_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Overall Compliance Score","description":"Overall compliance score (0-100)"},"is_fully_compliant":{"type":"boolean","title":"Is Fully Compliant","description":"True if all critical gates are passed without fatal violation"},"eu_battery_regulation_ready":{"type":"boolean","title":"Eu Battery Regulation Ready","description":"Compliant with EU Battery Regulation 2023/1542 & Passport"},"us_ira_feoc_compliant":{"type":"boolean","title":"Us Ira Feoc Compliant","description":"Compliant with US IRA 30D $7,500 tax credit clean vehicle rules"},"oecd_annex_ii_passed":{"type":"boolean","title":"Oecd Annex Ii Passed","description":"Passed OECD Due Diligence Guidance 12 red flags & 2% mass balance"},"eudr_deforestation_cleared":{"type":"boolean","title":"Eudr Deforestation Cleared","description":"Compliant with EUDR Regulation 2023/1115"},"csddd_civil_liability_shielded":{"type":"boolean","title":"Csddd Civil Liability Shielded","description":"Compliant with EU CSDDD Tier-2/3 traceability standards"},"us_bis_scrap_retention_cleared":{"type":"boolean","title":"Us Bis Scrap Retention Cleared","description":"Compliant with US BIS 15 CFR 744 battery scrap retention mandate (Trap 13)","default":true},"china_tech_jurisdiction_cleared":{"type":"boolean","title":"China Tech Jurisdiction Cleared","description":"Compliant with China Extraterritorial SX refining tech rules (Trap 14)","default":true},"china_tech_licensing_cleared":{"type":"boolean","title":"China Tech Licensing Cleared","description":"Compliant with China Extraterritorial Tech Licensing Jurisdiction (Trap 15)","default":true},"cbam_definitive_period_verified":{"type":"boolean","title":"Cbam Definitive Period Verified","description":"Verified under EU CBAM Definitive Period Scope 1-3 rules","default":true},"downstream_cbam_scope3_cleared":{"type":"boolean","title":"Downstream Cbam Scope3 Cleared","description":"Compliant with EU CBAM 2028 downstream finished/machinery product rules","default":true},"csddd_due_diligence_verified":{"type":"boolean","title":"Csddd Due Diligence Verified","description":"Compliant with EU CSDDD human rights and environmental due diligence audit","default":true},"copper_hvdc_certified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Copper Hvdc Certified","description":"Certified for AI Data Center & HVDC Power Grid infrastructure"},"silver_solar_pv_cleared":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Silver Solar Pv Cleared","description":"Certified for N-type TOPCon high-efficiency solar PV cells"},"zkp_privacy_sealed":{"type":"boolean","title":"Zkp Privacy Sealed","description":"Commercial pricing & supplier contracts blinded via ZKP","default":true},"gotcha_defenses_applied":{"items":{"type":"string"},"type":"array","title":"Gotcha Defenses Applied","description":"List of 16-trap defense rules applied"},"jurisprudence_citations":{"items":{"$ref":"#/components/schemas/TradeJurisprudenceCitation"},"type":"array","title":"Jurisprudence Citations"}},"type":"object","required":["overall_compliance_score","is_fully_compliant","eu_battery_regulation_ready","us_ira_feoc_compliant","oecd_annex_ii_passed","eudr_deforestation_cleared","csddd_civil_liability_shielded"],"title":"ComplianceVerdict"},"CompositeBatteryAuditVerdict":{"properties":{"ira_30d_tax_credit_eligible":{"type":"boolean","title":"Ira 30D Tax Credit Eligible","description":"Eligible for US IRA Section 30D $7,500 clean vehicle credit ($3,750 mineral portion)"},"ira_critical_mineral_fta_ratio_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Ira Critical Mineral Fta Ratio Pct","description":"Calculated % of critical mineral procurement value originating from US FTA partner countries (threshold >= 50%)"},"eu_battery_passport_approved":{"type":"boolean","title":"Eu Battery Passport Approved","description":"Eligible for EU Battery Regulation 2023/1542 mandatory passport registration"},"blended_carbon_footprint_kg_per_kwh":{"type":"number","minimum":0.0,"title":"Blended Carbon Footprint Kg Per Kwh","description":"Blended cradle-to-gate Scope 1-3 carbon footprint (kg CO2e / kWh)"},"composite_confidence_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Composite Confidence Score","description":"Composite algorithmic confidence rating (0-100)"},"lithium_cleared":{"type":"boolean","title":"Lithium Cleared"},"nickel_cleared":{"type":"boolean","title":"Nickel Cleared"},"cobalt_cleared":{"type":"boolean","title":"Cobalt Cleared"},"feoc_taint_detected":{"type":"boolean","title":"Feoc Taint Detected","description":"True if any component mineral carries >=25% covered nation equity/control"},"cbam_carbon_penalty_alert":{"type":"boolean","title":"Cbam Carbon Penalty Alert","description":"True if any processing step (e.g. nickel captive coal) incurs EU CBAM carbon tariff liabilities"},"composite_defenses_applied":{"items":{"type":"string"},"type":"array","title":"Composite Defenses Applied"}},"type":"object","required":["ira_30d_tax_credit_eligible","ira_critical_mineral_fta_ratio_pct","eu_battery_passport_approved","blended_carbon_footprint_kg_per_kwh","composite_confidence_score","lithium_cleared","nickel_cleared","cobalt_cleared","feoc_taint_detected","cbam_carbon_penalty_alert"],"title":"CompositeBatteryAuditVerdict"},"CompositeBatteryVerifyRequest":{"properties":{"battery_pack_id":{"type":"string","title":"Battery Pack Id","description":"Unique EV battery pack or cell batch serial (e.g. BATT-NCM811-2026-PACK01)"},"cell_chemistry":{"type":"string","title":"Cell Chemistry","description":"Cathode active material chemistry (e.g. NCM811, NCM622, NCM523)","default":"NCM811"},"pack_capacity_kwh":{"type":"number","exclusiveMinimum":0.0,"title":"Pack Capacity Kwh","description":"Gross battery pack capacity in kilowatt-hours (kWh)","default":84.0},"lithium_lot":{"$ref":"#/components/schemas/LithiumOriginVerifyRequest","description":"Australian Spodumene Lithium Hydroxide lot data"},"nickel_lot":{"$ref":"#/components/schemas/NickelOriginVerifyRequest","description":"Indonesian Nickel MHP lot data"},"cobalt_lot":{"$ref":"#/components/schemas/CobaltOriginVerifyRequest","description":"DRC Katanga Cobalt Hydroxide lot data"},"agent_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Address","description":"Requesting OEM/tier-1 buyer Polygon wallet address"}},"type":"object","required":["battery_pack_id","lithium_lot","nickel_lot","cobalt_lot"],"title":"CompositeBatteryVerifyRequest"},"CompositeBatteryVerifyResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"battery_pack_id":{"type":"string","title":"Battery Pack Id"},"cell_chemistry":{"type":"string","title":"Cell Chemistry"},"pack_capacity_kwh":{"type":"number","title":"Pack Capacity Kwh"},"merkle_root":{"type":"string","title":"Merkle Root"},"lithium_summary":{"additionalProperties":true,"type":"object","title":"Lithium Summary"},"nickel_summary":{"additionalProperties":true,"type":"object","title":"Nickel Summary"},"cobalt_summary":{"additionalProperties":true,"type":"object","title":"Cobalt Summary"},"composite_verdict":{"$ref":"#/components/schemas/CompositeBatteryAuditVerdict"},"master_onchain_proof":{"type":"string","title":"Master Onchain Proof"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["battery_pack_id","cell_chemistry","pack_capacity_kwh","merkle_root","lithium_summary","nickel_summary","cobalt_summary","composite_verdict","master_onchain_proof","timestamp"],"title":"CompositeBatteryVerifyResponse"},"CopperAuditVerdict":{"properties":{"geofence_verified":{"type":"boolean","title":"Geofence Verified"},"stoichiometric_mass_balance_passed":{"type":"boolean","title":"Stoichiometric Mass Balance Passed"},"sulfuric_acid_ratio_passed":{"type":"boolean","title":"Sulfuric Acid Ratio Passed"},"cochilco_cleared":{"type":"boolean","title":"Cochilco Cleared"},"hvdc_grid_certified":{"type":"boolean","title":"Hvdc Grid Certified"},"feoc_cleared":{"type":"boolean","title":"Feoc Cleared"},"confidence_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Confidence Score"},"defenses_applied":{"items":{"type":"string"},"type":"array","title":"Defenses Applied"}},"type":"object","required":["geofence_verified","stoichiometric_mass_balance_passed","sulfuric_acid_ratio_passed","cochilco_cleared","hvdc_grid_certified","feoc_cleared","confidence_score"],"title":"CopperAuditVerdict"},"CopperOriginVerifyRequest":{"properties":{"lot_id":{"type":"string","title":"Lot Id","description":"Unique enterprise copper lot identifier"},"mine_concession_name":{"type":"string","title":"Mine Concession Name","description":"Canonical mine concession: CHUQUICAMATA, EL_TENIENTE, ANDINA, ESCONDIDA, LOS_PELAMBRES, CERRO_VERDE","default":"CHUQUICAMATA"},"extraction_coordinates":{"prefixItems":[{"type":"number"},{"type":"number"}],"type":"array","maxItems":2,"minItems":2,"title":"Extraction Coordinates","description":"(lat, lon) centroid coordinates"},"source_country":{"$ref":"#/components/schemas/SourceCountry","description":"Country of extraction","default":"CHL"},"feedstock_concentrate_tons":{"type":"number","exclusiveMinimum":0.0,"title":"Feedstock Concentrate Tons","description":"Copper flotation concentrate feed in metric tons"},"concentrate_grade_cu_pct":{"type":"number","maximum":45.0,"minimum":10.0,"title":"Concentrate Grade Cu Pct","description":"Copper concentrate assay grade % (default 28.0% Cu)","default":28.0},"sulfuric_acid_input_tons":{"type":"number","exclusiveMinimum":0.0,"title":"Sulfuric Acid Input Tons","description":"Actual sulfuric acid (H2SO4) consumed in metric tons"},"refined_copper_cathode_tons":{"type":"number","exclusiveMinimum":0.0,"title":"Refined Copper Cathode Tons","description":"Refined Grade A copper cathode output in metric tons"},"copper_cathode_purity_pct":{"type":"number","maximum":100.0,"minimum":99.0,"title":"Copper Cathode Purity Pct","description":"Cathode assay purity % (ASTM B115 Grade 1 requires 99.9935%)","default":99.9935},"cochilco_export_clearance_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cochilco Export Clearance Id","description":"Chile COCHILCO export quota and registration ID"},"hvdc_cable_spec_compliant":{"type":"boolean","title":"Hvdc Cable Spec Compliant","description":"True if certified for AI Data Center HVDC power grid transmission","default":true},"feoc_shareholding_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Feoc Shareholding Pct","description":"Covered nation equity shareholding %","default":0.0},"agent_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Address","description":"Buyer agent Polygon wallet address"}},"type":"object","required":["lot_id","extraction_coordinates","feedstock_concentrate_tons","sulfuric_acid_input_tons","refined_copper_cathode_tons"],"title":"CopperOriginVerifyRequest"},"CopperOriginVerifyResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"lot_id":{"type":"string","title":"Lot Id"},"extraction_origin":{"additionalProperties":true,"type":"object","title":"Extraction Origin"},"mass_balance_audit":{"additionalProperties":true,"type":"object","title":"Mass Balance Audit"},"verdict":{"$ref":"#/components/schemas/CopperAuditVerdict"},"onchain_proof":{"type":"string","title":"Onchain Proof"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["lot_id","extraction_origin","mass_balance_audit","verdict","onchain_proof","timestamp"],"title":"CopperOriginVerifyResponse"},"CustomsVerificationRequest":{"properties":{"tracking_type":{"type":"string","title":"Tracking Type","description":"BOL (Bill of Lading) or CONTAINER","default":"BOL"},"tracking_number":{"type":"string","title":"Tracking Number","description":"B/L or Container Number (e.g. MEDU1234567, MSKU9876543)"},"carrier_code":{"type":"string","title":"Carrier Code","description":"Carrier SCAC code (e.g. MSCU, MAEU, CMAU, HLCU)","default":"MSCU"},"port_of_loading":{"type":"string","title":"Port Of Loading","description":"UN/LOCODE port of loading (e.g. CLPRA, MYPKG, ZADUR)"},"port_of_discharge":{"type":"string","title":"Port Of Discharge","description":"UN/LOCODE port of discharge (e.g. NLRTM, DEHAM, KRPUS)"},"departure_date":{"type":"string","title":"Departure Date","description":"Departure date (YYYY-MM-DD)"},"arrival_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Arrival Date","description":"Actual or estimated arrival date (YYYY-MM-DD)"},"mineral_batch_id":{"type":"string","title":"Mineral Batch Id","description":"Associated A.GRID mineral batch identifier"},"mine_coordinates":{"prefixItems":[{"type":"number"},{"type":"number"}],"type":"array","maxItems":2,"minItems":2,"title":"Mine Coordinates","description":"(lat, lon) coordinates of extraction site"},"gross_weight_kg":{"type":"number","exclusiveMinimum":0.0,"title":"Gross Weight Kg","description":"Cargo gross weight in kilograms"}},"type":"object","required":["tracking_number","port_of_loading","port_of_discharge","departure_date","mineral_batch_id","mine_coordinates","gross_weight_kg"],"title":"CustomsVerificationRequest"},"CustomsVerificationResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"tracking_number":{"type":"string","title":"Tracking Number"},"carrier_name":{"type":"string","title":"Carrier Name"},"customs_clearance_eligible":{"type":"boolean","title":"Customs Clearance Eligible"},"transit_plausibility_passed":{"type":"boolean","title":"Transit Plausibility Passed"},"route_distance_nautical_miles":{"type":"number","title":"Route Distance Nautical Miles"},"implied_speed_knots":{"type":"number","title":"Implied Speed Knots"},"spatial_mine_to_port_km":{"type":"number","title":"Spatial Mine To Port Km"},"proof_hash":{"type":"string","title":"Proof Hash"},"customs_clearance_bundle":{"additionalProperties":true,"type":"object","title":"Customs Clearance Bundle"},"onchain_signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Onchain Signature"},"issued_at":{"type":"string","title":"Issued At"}},"type":"object","required":["tracking_number","carrier_name","customs_clearance_eligible","transit_plausibility_passed","route_distance_nautical_miles","implied_speed_knots","spatial_mine_to_port_km","proof_hash","customs_clearance_bundle","issued_at"],"title":"CustomsVerificationResponse"},"EBLVerificationRequest":{"properties":{"ebl_document_id":{"type":"string","title":"Ebl Document Id","description":"Electronic Bill of Lading reference number"},"ebl_document_hash":{"type":"string","title":"Ebl Document Hash","description":"SHA-256 cryptographic hash of the eBL document"},"carrier_imo_number":{"type":"integer","title":"Carrier Imo Number","description":"7-digit IMO number of the cargo vessel"},"vessel_name":{"type":"string","title":"Vessel Name","description":"Registered vessel name"},"mineral_type":{"$ref":"#/components/schemas/MineralType","description":"Declared mineral cargo"},"gross_weight_metric_tons":{"type":"number","exclusiveMinimum":0.0,"title":"Gross Weight Metric Tons","description":"Bill of Lading manifest weight in MT"},"port_of_loading_code":{"type":"string","title":"Port Of Loading Code","description":"5-letter UN/LOCODE port of loading"},"port_of_discharge_code":{"type":"string","title":"Port Of Discharge Code","description":"5-letter UN/LOCODE port of discharge"},"shipper_name":{"type":"string","title":"Shipper Name","description":"Name of the exporting/shipping entity"},"consignee_name":{"type":"string","title":"Consignee Name","description":"Name of the consignee/receiving entity"}},"type":"object","required":["ebl_document_id","ebl_document_hash","carrier_imo_number","vessel_name","mineral_type","gross_weight_metric_tons","port_of_loading_code","port_of_discharge_code","shipper_name","consignee_name"],"title":"EBLVerificationRequest"},"EBLVerificationResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"ebl_document_id":{"type":"string","title":"Ebl Document Id"},"is_valid":{"type":"boolean","title":"Is Valid"},"carrier_imo_valid":{"type":"boolean","title":"Carrier Imo Valid"},"port_pair_valid":{"type":"boolean","title":"Port Pair Valid"},"ais_anomaly_detected":{"type":"boolean","title":"Ais Anomaly Detected"},"dark_fleet_flag":{"type":"boolean","title":"Dark Fleet Flag"},"hash_integrity":{"type":"boolean","title":"Hash Integrity"},"audit_verdict":{"type":"string","title":"Audit Verdict"},"verification_timestamp_utc":{"type":"string","title":"Verification Timestamp Utc"},"cryptographic_audit_hash":{"type":"string","title":"Cryptographic Audit Hash"}},"type":"object","required":["ebl_document_id","is_valid","carrier_imo_valid","port_pair_valid","ais_anomaly_detected","dark_fleet_flag","hash_integrity","audit_verdict","verification_timestamp_utc","cryptographic_audit_hash"],"title":"EBLVerificationResponse"},"EUIndustrialActVerifyRequest":{"properties":{"component_type":{"type":"string","title":"Component Type","description":"Vehicle/Clean energy component","default":"BATTERY_PACK"},"eu_domestic_value_share_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Eu Domestic Value Share Pct","description":"Percentage of EU domestic content/value add (Target >= 70%)"},"eu_steel_domestic_share_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Eu Steel Domestic Share Pct","description":"Percentage of crude steel from EU (Target >= 40%)","default":55.0},"local_assembly_location":{"type":"string","title":"Local Assembly Location","description":"EU member state where final assembly occurs","default":"DEU"}},"type":"object","required":["eu_domestic_value_share_pct"],"title":"EUIndustrialActVerifyRequest"},"EUIndustrialActVerifyResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"component_type":{"type":"string","title":"Component Type"},"iaa_70pct_threshold_passed":{"type":"boolean","title":"Iaa 70Pct Threshold Passed"},"steel_40pct_threshold_passed":{"type":"boolean","title":"Steel 40Pct Threshold Passed"},"overall_subsidy_eligible":{"type":"boolean","title":"Overall Subsidy Eligible"},"compliance_score":{"type":"number","title":"Compliance Score"},"statutory_citations":{"items":{"type":"string"},"type":"array","title":"Statutory Citations"},"proof_hash":{"type":"string","title":"Proof Hash"}},"type":"object","required":["component_type","iaa_70pct_threshold_passed","steel_40pct_threshold_passed","overall_subsidy_eligible","compliance_score","statutory_citations","proof_hash"],"title":"EUIndustrialActVerifyResponse"},"EcologicalSpatialRecord":{"properties":{"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Mine extraction centroid latitude (min 6 decimals)"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Mine extraction centroid longitude (min 6 decimals)"},"eudr_deforestation_free":{"type":"boolean","title":"Eudr Deforestation Free","description":"Zero deforestation after EUDR cutoff date 2020-12-31","default":true},"periglacial_zone_violation":{"type":"boolean","title":"Periglacial Zone Violation","description":"True if within Argentina Ley 26.639 periglacial protected zone","default":false},"indigenous_territory_encroachment":{"type":"boolean","title":"Indigenous Territory Encroachment","description":"True if encroaching on Brazil Art. 231 indigenous land","default":false},"tailing_dam_dce_certified":{"type":"boolean","title":"Tailing Dam Dce Certified","description":"Brazil ANM 95/2022 tailing dam stability certificate (DCE)","default":true},"aquifer_depletion_alert":{"type":"boolean","title":"Aquifer Depletion Alert","description":"Chile DGA Atacama monitoring well anomaly alert","default":false},"satellite_evidence_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Satellite Evidence Hash","description":"Cryptographic SHA-256 hash of multi-satellite radar proof"},"traces_nt_dds_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Traces Nt Dds Reference","description":"Official EU TRACES-NT Due Diligence Statement (DDS) reference ID"},"satellite_audit_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Satellite Audit Source","description":"Audit source: REMOTE_EUDR_AGENT or LOCAL_STANDALONE","default":"LOCAL_STANDALONE"}},"type":"object","required":["latitude","longitude"],"title":"EcologicalSpatialRecord"},"EudrUniversalSettleRequest":{"properties":{"job_id":{"type":"string","title":"Job Id"},"commodity":{"type":"string","title":"Commodity"},"country_code":{"type":"string","title":"Country Code"},"polygon_coordinates":{"items":{"items":{"type":"number"},"type":"array"},"type":"array","title":"Polygon Coordinates"},"dds_reference_id":{"type":"string","title":"Dds Reference Id"},"deforestation_detected":{"type":"boolean","title":"Deforestation Detected","default":false},"legal_harvest_verified":{"type":"boolean","title":"Legal Harvest Verified","default":true},"recipients":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Recipients"},"truth_payload":{"type":"string","title":"Truth Payload","default":"EUDR 2023/1115 Deforestation-Free Concession Verified"},"chain_id":{"type":"integer","title":"Chain Id","default":137}},"type":"object","required":["job_id","commodity","country_code","polygon_coordinates","dds_reference_id","recipients"],"title":"EudrUniversalSettleRequest"},"ExtractionOriginEvidence":{"properties":{"mine_name":{"type":"string","title":"Mine Name"},"country":{"type":"string","title":"Country"},"minedex_tenement_id":{"type":"string","title":"Minedex Tenement Id"},"coordinates":{"items":{"type":"number"},"type":"array","title":"Coordinates"},"geofence_distance_km":{"type":"number","title":"Geofence Distance Km"},"geofence_passed":{"type":"boolean","title":"Geofence Passed"},"satellite_evidence":{"additionalProperties":true,"type":"object","title":"Satellite Evidence"}},"type":"object","required":["mine_name","country","minedex_tenement_id","coordinates","geofence_distance_km","geofence_passed","satellite_evidence"],"title":"ExtractionOriginEvidence"},"GaslessRelayResponse":{"properties":{"status":{"type":"string","title":"Status","default":"SPONSORED_SUCCESS"},"relay_id":{"type":"string","title":"Relay Id"},"network":{"type":"string","title":"Network"},"chain_id":{"type":"integer","title":"Chain Id"},"operation":{"type":"string","title":"Operation"},"tx_hash":{"type":"string","title":"Tx Hash"},"contract_address":{"type":"string","title":"Contract Address"},"sponsored_gas_pol":{"type":"number","title":"Sponsored Gas Pol"},"relayer_address":{"type":"string","title":"Relayer Address"},"block_timestamp_utc":{"type":"string","title":"Block Timestamp Utc"}},"type":"object","required":["relay_id","network","chain_id","operation","tx_hash","contract_address","sponsored_gas_pol","relayer_address","block_timestamp_utc"],"title":"GaslessRelayResponse"},"GeopoliticalSanctionsRecord":{"properties":{"feoc_shareholding_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Feoc Shareholding Pct","description":"Covered nation (China/Russia/Iran/DPRK) total equity shareholding % (Must be < 25.0% for IRA 30D)"},"feoc_board_control_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Feoc Board Control Pct","description":"Covered nation board seats/voting control % (Must be < 25.0%)"},"contractual_operational_control":{"type":"boolean","title":"Contractual Operational Control","description":"True if covered entity has effective operational control or exclusive offtake veto","default":false},"ofac_sdn_sanctioned":{"type":"boolean","title":"Ofac Sdn Sanctioned","description":"True if associated with OFAC SDN list (e.g. Russia Nornickel)","default":false},"us_substantial_transformation_compliant":{"type":"boolean","title":"Us Substantial Transformation Compliant","description":"Compliant with US CIT origin standards against transit laundering","default":true}},"type":"object","required":["feoc_shareholding_pct","feoc_board_control_pct"],"title":"GeopoliticalSanctionsRecord"},"HPALMassBalanceEvidence":{"properties":{"limonite_input_tons":{"type":"number","title":"Limonite Input Tons"},"mhp_output_tons":{"type":"number","title":"Mhp Output Tons"},"theoretical_required_ore_tons":{"type":"number","title":"Theoretical Required Ore Tons"},"discrepancy_pct":{"type":"number","title":"Discrepancy Pct"},"is_stoichiometrically_sound":{"type":"boolean","title":"Is Stoichiometrically Sound"},"hpal_recovery_yield_pct":{"type":"number","title":"Hpal Recovery Yield Pct"}},"type":"object","required":["limonite_input_tons","mhp_output_tons","theoretical_required_ore_tons","discrepancy_pct","is_stoichiometrically_sound","hpal_recovery_yield_pct"],"title":"HPALMassBalanceEvidence"},"HSCodeTariffInfo":{"properties":{"mineral_type":{"$ref":"#/components/schemas/MineralType","description":"Mineral type"},"hs_code":{"type":"string","title":"Hs Code","description":"WCO 6-digit Harmonized System code"},"description":{"type":"string","title":"Description","description":"Tariff line description"},"importer_jurisdiction":{"type":"string","title":"Importer Jurisdiction","description":"Importing nation (USA, EU, KOR, JPN, CHN)"},"mfn_duty_pct":{"type":"number","title":"Mfn Duty Pct","description":"General Most-Favored-Nation (MFN) tariff rate %"},"fta_preferential_duty_pct":{"type":"number","title":"Fta Preferential Duty Pct","description":"Preferential duty rate % under applicable FTA"},"fta_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fta Name","description":"Applicable Free Trade Agreement"},"section_301_tariff_pct":{"type":"number","title":"Section 301 Tariff Pct","description":"US Section 301 punitive tariff % (e.g. on Chinese goods)","default":0.0},"export_licensing_required":{"type":"boolean","title":"Export Licensing Required","description":"True if origin country requires dual-use/export license","default":false},"export_restriction_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Export Restriction Note","description":"Export policy note (e.g. MOFCOM or Indonesia DMO)"},"eu_cbam_applicable":{"type":"boolean","title":"Eu Cbam Applicable","description":"True if subject to EU Carbon Border Adjustment Mechanism","default":false},"cbam_default_carbon_intensity":{"type":"number","title":"Cbam Default Carbon Intensity","description":"Default embedded carbon benchmark (tCO2e/t)","default":0.0}},"type":"object","required":["mineral_type","hs_code","description","importer_jurisdiction","mfn_duty_pct","fta_preferential_duty_pct"],"title":"HSCodeTariffInfo"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LaborHumanRightsRecord":{"properties":{"child_labor_free_certified":{"type":"boolean","title":"Child Labor Free Certified","description":"Zero-tolerance verified absence of under-18 workers","default":true},"rmi_rmap_audit_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rmi Rmap Audit Id","description":"Responsible Minerals Initiative (RMI) RMAP certified audit ID"},"ilua_registration_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ilua Registration Id","description":"Australia Native Title Act ILUA registration number"},"forced_labor_uapa_cleared":{"type":"boolean","title":"Forced Labor Uapa Cleared","description":"Verified absence of Xinjiang UFLPA or forced labor ties","default":true},"independent_third_party_auditor":{"type":"string","title":"Independent Third Party Auditor","description":"Third-party audit body","default":"SGS / Bureau Veritas / RCS Global"},"csddd_audit_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Csddd Audit Hash","description":"EU CSDDD supply chain human rights and environmental audit SHA-256 hash"}},"type":"object","title":"LaborHumanRightsRecord"},"LegalDisclaimerRecord":{"properties":{"disclaimer_version":{"type":"string","title":"Disclaimer Version","description":"Legal disclaimer terms version","default":"2026.09-v1"},"liability_cap_usdc":{"type":"number","title":"Liability Cap Usdc","description":"Strict maximum liability cap per verification request in USDC","default":0.5},"warranty_disclaimer":{"type":"string","title":"Warranty Disclaimer","description":"Physical warranty exclusion","default":"ALGORITHMIC_VERIFICATION_ONLY: This passport represents mathematical and algorithmic rule verification against codified standards (EU Battery Reg, US IRA FEOC, OECD Annex II, EUDR, CSDDD). The Oracle and its operators issue NO WARRANTY, express or implied, regarding physical ground truth, actual chemical assay, batch weight, or unverified laboratory integrity."},"consequential_damages_waiver":{"type":"string","title":"Consequential Damages Waiver","description":"Consequential damages waiver","default":"ZERO_CONSEQUENTIAL_LIABILITY: The Oracle and its operators bear zero liability for customs seizures, regulatory fines, sanctions penalties, trade suspensions, vessel demurrage, or commercial losses."},"non_delegable_audit_duty":{"type":"string","title":"Non Delegable Audit Duty","description":"Duty of due diligence allocation","default":"NON_DELEGABLE_IMPORTER_DUTY: The recipient retains sole and non-delegable legal obligation to perform independent physical testing, assay verification, and due diligence under applicable customs and trade laws."},"binding_disclaimer_hash":{"type":"string","title":"Binding Disclaimer Hash","description":"SHA-256 hash of normalized disclaimer terms, cryptographically bound into EIP-712 signature"}},"type":"object","required":["binding_disclaimer_hash"],"title":"LegalDisclaimerRecord"},"LithiumAuditVerdict":{"properties":{"ira_compliant":{"type":"boolean","title":"Ira Compliant","description":"Eligible for US IRA 30D $7,500 clean vehicle credit"},"crma_origin_eligible":{"type":"boolean","title":"Crma Origin Eligible","description":"Eligible for EU Critical Raw Materials Act & Battery Passport"},"feoc_risk_detected":{"type":"boolean","title":"Feoc Risk Detected","description":"True if refined in China or >=25% covered nation equity"},"confidence_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Confidence Score","description":"Algorithmic confidence rating (0-100)"},"defenses_applied":{"items":{"type":"string"},"type":"array","title":"Defenses Applied"}},"type":"object","required":["ira_compliant","crma_origin_eligible","feoc_risk_detected","confidence_score"],"title":"LithiumAuditVerdict"},"LithiumOriginVerifyRequest":{"properties":{"trace_id":{"type":"string","title":"Trace Id","description":"Unique traceability ID (e.g. LIT-AU-2026-X091)"},"product":{"type":"string","title":"Product","description":"Refined product form: Lithium Hydroxide, Lithium Carbonate, Spodumene Concentrate","default":"Lithium Hydroxide Monohydrate"},"mine_name":{"type":"string","title":"Mine Name","description":"Name of hard-rock mine (e.g. Greenbushes Lithium Mine, Pilgangoora)"},"mine_country":{"type":"string","title":"Mine Country","description":"ISO alpha-2 country of extraction (AU default)","default":"AU"},"coordinates":{"items":{"type":"number"},"type":"array","maxItems":2,"minItems":2,"title":"Coordinates","description":"[Latitude, Longitude] of extraction centroid"},"minedex_tenement_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Minedex Tenement Id","description":"Western Australia DMIRS MINEDEX tenement ID (e.g., M01/03)"},"spodumene_tonnage_extracted":{"type":"number","exclusiveMinimum":0.0,"title":"Spodumene Tonnage Extracted","description":"Gross run-of-mine or SC6 spodumene input in metric tons"},"spodumene_grade_pct":{"type":"number","maximum":10.0,"minimum":1.0,"title":"Spodumene Grade Pct","description":"Spodumene Li2O concentrate grade percentage (standard 6.0%)","default":6.0},"refinery_facility":{"type":"string","title":"Refinery Facility","description":"Name of refining or chemical conversion plant"},"refinery_country":{"type":"string","title":"Refinery Country","description":"ISO alpha-2 country of the refinery plant (e.g. AU, US, CHN)","default":"AU"},"refined_output_tonnage":{"type":"number","exclusiveMinimum":0.0,"title":"Refined Output Tonnage","description":"Finished lithium product output in metric tons"},"refinery_feoc_equity_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Refinery Feoc Equity Pct","description":"Covered nation entity equity/voting share in refinery","default":0.0},"satellite_vegetation_index":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Satellite Vegetation Index","description":"Sentinel-2 NDVI for the extraction boundary (typically < 0.2 in active pit)"},"sar_backscatter_db":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sar Backscatter Db","description":"Sentinel-1 SAR C-band backscatter in dB"},"agent_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Address","description":"Calling agent Polygon wallet address for receipt generation"}},"type":"object","required":["trace_id","mine_name","coordinates","spodumene_tonnage_extracted","refinery_facility","refined_output_tonnage"],"title":"LithiumOriginVerifyRequest"},"LithiumOriginVerifyResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"trace_id":{"type":"string","title":"Trace Id"},"product":{"type":"string","title":"Product"},"extraction_origin":{"$ref":"#/components/schemas/ExtractionOriginEvidence"},"processing_route":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Processing Route"},"mass_balance_audit":{"$ref":"#/components/schemas/MassBalanceAuditEvidence"},"audit_verdict":{"$ref":"#/components/schemas/LithiumAuditVerdict"},"onchain_proof":{"type":"string","title":"Onchain Proof"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["trace_id","product","extraction_origin","processing_route","mass_balance_audit","audit_verdict","onchain_proof","timestamp"],"title":"LithiumOriginVerifyResponse"},"LogisticsTrackingStateRequest":{"properties":{"tracking_numbers":{"items":{"type":"string"},"type":"array","title":"Tracking Numbers","description":"List of waybill or container tracking numbers"},"carrier_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Carrier Hint","description":"Optional carrier hint: CJ, HANJIN, DHL, FEDEX, MSC"}},"type":"object","required":["tracking_numbers"],"title":"LogisticsTrackingStateRequest"},"LogisticsTrackingStateResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Results"},"total_queried":{"type":"integer","title":"Total Queried"},"clean_schema_version":{"type":"string","title":"Clean Schema Version","default":"v1.2.0"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["results","total_queried","timestamp"],"title":"LogisticsTrackingStateResponse"},"MCPToolCallRequest":{"properties":{"name":{"type":"string","title":"Name"},"arguments":{"additionalProperties":true,"type":"object","title":"Arguments"}},"type":"object","required":["name"],"title":"MCPToolCallRequest"},"MCPToolCallResponse":{"properties":{"content":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Content"},"isError":{"type":"boolean","title":"Iserror","default":false}},"type":"object","required":["content"],"title":"MCPToolCallResponse"},"MaritimeCIIRating":{"type":"string","enum":["A","B","C","D","E"],"title":"MaritimeCIIRating"},"MaritimeLogisticsRecord":{"properties":{"vessel_imo_number":{"type":"integer","title":"Vessel Imo Number","description":"IMO 7-digit ship identification number"},"vessel_name":{"type":"string","title":"Vessel Name","description":"Cargo vessel registered name"},"cii_rating":{"$ref":"#/components/schemas/MaritimeCIIRating","description":"IMO MARPOL Annex VI Carbon Intensity Indicator (A-E)"},"ebl_document_hash":{"type":"string","title":"Ebl Document Hash","description":"UNCITRAL MLETR compliant electronic B/L cryptographic SHA-256 hash"},"transshipment_port":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transshipment Port","description":"Intermediate transit port (e.g. Singapore, Batam)"},"iso_17025_lab_coa_hash":{"type":"string","title":"Iso 17025 Lab Coa Hash","description":"ISO/IEC 17025 accredited laboratory assay COA certificate hash"},"tml_moisture_safe":{"type":"boolean","title":"Tml Moisture Safe","description":"IMSBC Code Transportable Moisture Limit (TML) liquefaction safe","default":true}},"type":"object","required":["vessel_imo_number","vessel_name","cii_rating","ebl_document_hash","iso_17025_lab_coa_hash"],"title":"MaritimeLogisticsRecord"},"MaritimeRouteRequest":{"properties":{"mineral_type":{"$ref":"#/components/schemas/MineralType","description":"Mineral being shipped"},"origin_country":{"$ref":"#/components/schemas/SourceCountry","description":"Origin extraction country"},"destination_country":{"type":"string","title":"Destination Country","description":"Destination market (e.g. USA, KOR, EU, CHN, JPN)"},"cargo_weight_metric_tons":{"type":"number","minimum":1.0,"title":"Cargo Weight Metric Tons","description":"Shipment lot weight in metric tons","default":1000.0},"vessel_imo_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Vessel Imo Number","description":"IMO 7-digit vessel ID"},"cii_rating":{"$ref":"#/components/schemas/MaritimeCIIRating","description":"Vessel IMO MARPOL Carbon Intensity rating","default":"A"},"avoid_chokepoints":{"items":{"type":"string"},"type":"array","title":"Avoid Chokepoints","description":"Chokepoints to bypass (e.g. ['RED_SEA', 'PANAMA_CANAL'])"}},"type":"object","required":["mineral_type","origin_country","destination_country"],"title":"MaritimeRouteRequest"},"MaritimeRouteResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"corridor_id":{"type":"string","title":"Corridor Id"},"origin_port":{"type":"string","title":"Origin Port"},"destination_port":{"type":"string","title":"Destination Port"},"nautical_miles":{"type":"number","title":"Nautical Miles"},"estimated_transit_days":{"type":"number","title":"Estimated Transit Days"},"chokepoints_traversed":{"items":{"type":"string"},"type":"array","title":"Chokepoints Traversed"},"chokepoint_risk_penalty_days":{"type":"number","title":"Chokepoint Risk Penalty Days"},"base_freight_usd_per_mt":{"type":"number","title":"Base Freight Usd Per Mt"},"risk_surcharge_usd_per_mt":{"type":"number","title":"Risk Surcharge Usd Per Mt"},"total_freight_usd":{"type":"number","title":"Total Freight Usd"},"cii_rating":{"$ref":"#/components/schemas/MaritimeCIIRating"},"total_voyage_co2_metric_tons":{"type":"number","title":"Total Voyage Co2 Metric Tons"},"eu_cbam_estimated_surcharge_usd":{"type":"number","title":"Eu Cbam Estimated Surcharge Usd"},"route_advisory":{"type":"string","title":"Route Advisory"},"calculated_at_utc":{"type":"string","title":"Calculated At Utc"}},"type":"object","required":["corridor_id","origin_port","destination_port","nautical_miles","estimated_transit_days","chokepoints_traversed","chokepoint_risk_penalty_days","base_freight_usd_per_mt","risk_surcharge_usd_per_mt","total_freight_usd","cii_rating","total_voyage_co2_metric_tons","eu_cbam_estimated_surcharge_usd","route_advisory","calculated_at_utc"],"title":"MaritimeRouteResponse"},"MassBalanceAuditEvidence":{"properties":{"spodumene_input_metric_tons":{"type":"number","title":"Spodumene Input Metric Tons"},"refined_output_metric_tons":{"type":"number","title":"Refined Output Metric Tons"},"theoretical_required_spodumene_tons":{"type":"number","title":"Theoretical Required Spodumene Tons"},"discrepancy_pct":{"type":"number","title":"Discrepancy Pct"},"is_stoichiometrically_sound":{"type":"boolean","title":"Is Stoichiometrically Sound"}},"type":"object","required":["spodumene_input_metric_tons","refined_output_metric_tons","theoretical_required_spodumene_tons","discrepancy_pct","is_stoichiometrically_sound"],"title":"MassBalanceAuditEvidence"},"MinePermitsRecord":{"properties":{"mining_license_id":{"type":"string","title":"Mining License Id","description":"Government-issued concession or extraction license ID"},"mine_operator_name":{"type":"string","title":"Mine Operator Name","description":"Corporate name of the mining operator"},"simbara_ntpn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Simbara Ntpn","description":"Indonesia SIMBARA/e-PNBP tax payment code (NTPN)"},"simbara_rkab_quota_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Simbara Rkab Quota Id","description":"Indonesia annual approved production quota (RKAB) ID"},"dhe_forex_deposit_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dhe Forex Deposit Ref","description":"Indonesia Bank Indonesia 30% export forex deposit receipt (DHE)"},"ceec_barcode_tag_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ceec Barcode Tag Id","description":"DRC CEEC official tamper-evident barcode tag series"},"egc_artisanal_license":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Egc Artisanal License","description":"DRC EGC monopoly buying license (for artisanal concessions)"},"chile_dga_water_permit_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chile Dga Water Permit Id","description":"Chile DGA brine & freshwater extraction permit ID"},"australia_epbc_ref_no":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Australia Epbc Ref No","description":"Australia Federal EPBC Act MNES environmental approval ID"},"argentina_concession_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Argentina Concession Id","description":"Argentina Provincial mining concession registry ID"},"brazil_anm_license_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brazil Anm License Id","description":"Brazil ANM mining registry license ID"},"china_dual_use_license_no":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"China Dual Use License No","description":"China MOFCOM dual-use export license (Graphite/Antimony)"},"us_bis_scrap_export_license":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Us Bis Scrap Export License","description":"US BIS 15 CFR 744 special export license for black mass / tungsten scrap"},"china_extraterritorial_tech_clearance":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"China Extraterritorial Tech Clearance","description":"China MOFCOM approval for extraterritorial SX refining tech utilization"},"chile_cochilco_export_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chile Cochilco Export Id","description":"Chile COCHILCO copper export registration & quota clearance"},"mexico_se_mining_concession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mexico Se Mining Concession","description":"Mexico Secretaría de Economía mining concession title ID"},"peru_ingemmet_concession_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Peru Ingemmet Concession Id","description":"Peru INGEMMET public mining registry concession ID"}},"type":"object","required":["mining_license_id","mine_operator_name"],"title":"MinePermitsRecord"},"MineSiteSatelliteAuditRequest":{"properties":{"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Mine extraction centroid latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Mine extraction centroid longitude"},"country_code":{"type":"string","maxLength":3,"minLength":2,"title":"Country Code","description":"ISO country code","default":"ID"},"area_hectares":{"type":"number","exclusiveMinimum":0.0,"title":"Area Hectares","description":"Concession area in hectares","default":10.0},"concession_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Concession Id","description":"Optional mining concession identifier"},"production_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Production Date","description":"Production/harvest date (YYYY-MM-DD)"}},"type":"object","required":["latitude","longitude"],"title":"MineSiteSatelliteAuditRequest"},"MineSiteSatelliteAuditResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"is_compliant":{"type":"boolean","title":"Is Compliant"},"deforestation_detected":{"type":"boolean","title":"Deforestation Detected"},"forest_loss_pct":{"type":"number","title":"Forest Loss Pct"},"indigenous_territory_encroachment":{"type":"boolean","title":"Indigenous Territory Encroachment"},"reason":{"type":"string","title":"Reason"},"satellite_evidence_hash":{"type":"string","title":"Satellite Evidence Hash"},"traces_nt_dds_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Traces Nt Dds Reference"},"audit_source":{"type":"string","title":"Audit Source"},"latency_ms":{"type":"number","title":"Latency Ms"}},"type":"object","required":["is_compliant","deforestation_detected","forest_loss_pct","indigenous_territory_encroachment","reason","satellite_evidence_hash","audit_source","latency_ms"],"title":"MineSiteSatelliteAuditResponse"},"MineralLotProvenanceRequest":{"properties":{"lot_id":{"type":"string","title":"Lot Id","description":"Unique enterprise mineral batch/lot identifier (e.g. LOT-2026-NI-IDN-0412)"},"mineral_type":{"$ref":"#/components/schemas/MineralType","description":"Standard critical mineral commodity type"},"source_country":{"$ref":"#/components/schemas/SourceCountry","description":"Primary mining country of origin"},"net_weight_metric_tons":{"type":"number","exclusiveMinimum":0.0,"title":"Net Weight Metric Tons","description":"Gross cargo batch weight in metric tons"},"declared_purity_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Declared Purity Pct","description":"Declared metallurgical assay grade %"},"mine_permits":{"$ref":"#/components/schemas/MinePermitsRecord"},"ecological_spatial":{"$ref":"#/components/schemas/EcologicalSpatialRecord"},"labor_human_rights":{"$ref":"#/components/schemas/LaborHumanRightsRecord"},"refining_mass_balance":{"$ref":"#/components/schemas/RefiningMassBalanceRecord"},"maritime_logistics":{"$ref":"#/components/schemas/MaritimeLogisticsRecord"},"geopolitical_sanctions":{"$ref":"#/components/schemas/GeopoliticalSanctionsRecord"},"is_recycled_black_mass":{"type":"boolean","title":"Is Recycled Black Mass","description":"True if cargo batch originates from shredded battery black mass or secondary scrap","default":false},"us_bis_export_authorized":{"type":"boolean","title":"Us Bis Export Authorized","description":"True if authorized under US BIS 15 CFR 744 scrap retention rules","default":true},"commercial_price_usd_per_ton":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Commercial Price Usd Per Ton","description":"Confidential purchase price per ton (will be ZKP blinded on-chain)"},"agent_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Address","description":"Requesting buyer agent Polygon wallet address (0x...)"}},"type":"object","required":["lot_id","mineral_type","source_country","net_weight_metric_tons","declared_purity_pct","mine_permits","ecological_spatial","labor_human_rights","refining_mass_balance","maritime_logistics","geopolitical_sanctions"],"title":"MineralLotProvenanceRequest"},"MineralType":{"type":"string","enum":["NICKEL_MHP","LITHIUM_HYDROXIDE","LITHIUM_CARBONATE","COBALT_HYDROXIDE","COPPER_CATHODE","COPPER_CONCENTRATE","SILVER_DORE","SILVER_POWDER_SOLAR_PV","NATURAL_GRAPHITE","SYNTHETIC_GRAPHITE","MANGANESE_SULFATE","NEODYMIUM_DYSPROSIUM","ANTIMONY_TRIOXIDE","LITHIUM_BLACK_MASS","NICKEL_COBALT_BLACK_MASS","TUNGSTEN_SCRAP","TUNGSTEN_APT","RARE_EARTHS_NDPR","RECYCLED_BLACK_MASS","FERRONIOBIUM","SCANDIUM_OXIDE"],"title":"MineralType"},"MineralsUniversalSettleRequest":{"properties":{"job_id":{"type":"string","title":"Job Id"},"mineral_type":{"type":"string","title":"Mineral Type"},"smelter_id":{"type":"string","title":"Smelter Id"},"smelter_audit_status":{"type":"string","title":"Smelter Audit Status"},"mine_country_code":{"type":"string","title":"Mine Country Code"},"chain_of_custody_verified":{"type":"boolean","title":"Chain Of Custody Verified","default":true},"child_labor_free":{"type":"boolean","title":"Child Labor Free","default":true},"conflict_region":{"type":"boolean","title":"Conflict Region","default":false},"enhanced_due_diligence":{"type":"boolean","title":"Enhanced Due Diligence","default":true},"recipients":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Recipients"},"chain_id":{"type":"integer","title":"Chain Id","default":137}},"type":"object","required":["job_id","mineral_type","smelter_id","smelter_audit_status","mine_country_code","recipients"],"title":"MineralsUniversalSettleRequest"},"NickelAuditVerdict":{"properties":{"simbara_export_cleared":{"type":"boolean","title":"Simbara Export Cleared","description":"Inaportnet export clearance legally cleared via SIMBARA NTPN"},"wto_ds592_compliant":{"type":"boolean","title":"Wto Ds592 Compliant","description":"Beneficiated MHP compliant with WTO DS592 domestic processing rules"},"cbam_carbon_ready":{"type":"boolean","title":"Cbam Carbon Ready","description":"Free of captive coal power; eligible for EU Battery Regulation"},"ira_feoc_compliant":{"type":"boolean","title":"Ira Feoc Compliant","description":"Covered nation equity < 25.0%; eligible for US IRA 30D credit"},"confidence_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Confidence Score","description":"Algorithmic confidence rating (0-100)"},"defenses_applied":{"items":{"type":"string"},"type":"array","title":"Defenses Applied"}},"type":"object","required":["simbara_export_cleared","wto_ds592_compliant","cbam_carbon_ready","ira_feoc_compliant","confidence_score"],"title":"NickelAuditVerdict"},"NickelConcessionEvidence":{"properties":{"concession_name":{"type":"string","title":"Concession Name"},"region":{"type":"string","title":"Region"},"coordinates":{"items":{"type":"number"},"type":"array","title":"Coordinates"},"geofence_distance_km":{"type":"number","title":"Geofence Distance Km"},"geofence_passed":{"type":"boolean","title":"Geofence Passed"},"simbara_ntpn_verified":{"type":"boolean","title":"Simbara Ntpn Verified"},"dhe_forex_verified":{"type":"boolean","title":"Dhe Forex Verified"}},"type":"object","required":["concession_name","region","coordinates","geofence_distance_km","geofence_passed","simbara_ntpn_verified","dhe_forex_verified"],"title":"NickelConcessionEvidence"},"NickelOriginVerifyRequest":{"properties":{"trace_id":{"type":"string","title":"Trace Id","description":"Unique traceability batch identifier (e.g. NIC-IDN-2026-MHP01)"},"product":{"type":"string","title":"Product","description":"Beneficiated intermediate product form (MHP or Ferronickel)","default":"Nickel Mixed Hydroxide Precipitate (MHP)"},"concession_name":{"type":"string","title":"Concession Name","description":"Mining concession / IUP name (e.g. Morowali Concession, Weda Bay, Sorowako)"},"coordinates":{"items":{"type":"number"},"type":"array","maxItems":2,"minItems":2,"title":"Coordinates","description":"[Latitude, Longitude] of extraction centroid"},"simbara_ntpn":{"type":"string","title":"Simbara Ntpn","description":"Indonesia Ministry of Energy (ESDM) SIMBARA/e-PNBP payment code (NTPN)"},"dhe_forex_deposit_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dhe Forex Deposit Ref","description":"Bank Indonesia 30% export forex deposit receipt reference (DHE BI)"},"limonite_ore_input_tons":{"type":"number","exclusiveMinimum":0.0,"title":"Limonite Ore Input Tons","description":"Gross wet/dry laterite limonite ore input in metric tons"},"ore_grade_ni_pct":{"type":"number","maximum":3.0,"minimum":0.5,"title":"Ore Grade Ni Pct","description":"Limonite ore nickel content % (standard 1.2% ~ 1.5%)","default":1.35},"hpal_refinery_name":{"type":"string","title":"Hpal Refinery Name","description":"High Pressure Acid Leach (HPAL) facility name (e.g. QMB New Energy, Huayue)"},"mhp_output_tons":{"type":"number","exclusiveMinimum":0.0,"title":"Mhp Output Tons","description":"Refined MHP product yield in metric tons"},"mhp_grade_ni_pct":{"type":"number","maximum":45.0,"minimum":30.0,"title":"Mhp Grade Ni Pct","description":"MHP nickel metal content % (standard ~38% ~ 40%)","default":38.5},"captive_coal_power":{"type":"boolean","title":"Captive Coal Power","description":"True if HPAL plant runs on dedicated captive coal-fired power (EU CBAM risk)","default":false},"feoc_equity_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Feoc Equity Pct","description":"Covered nation entity equity/voting share in smelter JV","default":0.0},"agent_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Address","description":"Calling agent Polygon wallet address for receipt generation"}},"type":"object","required":["trace_id","concession_name","coordinates","simbara_ntpn","limonite_ore_input_tons","hpal_refinery_name","mhp_output_tons"],"title":"NickelOriginVerifyRequest"},"NickelOriginVerifyResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"trace_id":{"type":"string","title":"Trace Id"},"product":{"type":"string","title":"Product"},"extraction_concession":{"$ref":"#/components/schemas/NickelConcessionEvidence"},"refining_facility":{"additionalProperties":true,"type":"object","title":"Refining Facility"},"hpal_mass_balance":{"$ref":"#/components/schemas/HPALMassBalanceEvidence"},"audit_verdict":{"$ref":"#/components/schemas/NickelAuditVerdict"},"onchain_proof":{"type":"string","title":"Onchain Proof"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["trace_id","product","extraction_concession","refining_facility","hpal_mass_balance","audit_verdict","onchain_proof","timestamp"],"title":"NickelOriginVerifyResponse"},"NiobiumScandiumAuditVerdict":{"properties":{"is_compliant":{"type":"boolean","title":"Is Compliant"},"status":{"type":"string","title":"Status"},"geofence_verified":{"type":"boolean","title":"Geofence Verified"},"distance_to_concession_km":{"type":"number","title":"Distance To Concession Km"},"grade_assay_certified":{"type":"boolean","title":"Grade Assay Certified"},"defense_procurement_eligible":{"type":"boolean","title":"Defense Procurement Eligible"},"doe_exim_loan_eligible":{"type":"boolean","title":"Doe Exim Loan Eligible"},"confidence_score":{"type":"number","title":"Confidence Score"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"}},"type":"object","required":["is_compliant","status","geofence_verified","distance_to_concession_km","grade_assay_certified","defense_procurement_eligible","doe_exim_loan_eligible","confidence_score","reasons"],"title":"NiobiumScandiumAuditVerdict"},"NiobiumScandiumOriginVerifyRequest":{"properties":{"batch_id":{"type":"string","title":"Batch Id","description":"Lot/batch ID of Ferroniobium alloy or Scandium Oxide"},"tenement_id":{"type":"string","title":"Tenement Id","description":"Concession/Facility ID (e.g., ELK_CREEK, ARAXA, NIOBEC)"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"commodity_type":{"$ref":"#/components/schemas/MineralType","description":"FERRONIOBIUM or SCANDIUM_OXIDE","default":"FERRONIOBIUM"},"fe_nb_grade_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Fe Nb Grade Pct","description":"Ferroniobium Nb content % (ASTM A550 Std >= 65.0%)","default":65.0},"sc2o3_purity_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Sc2O3 Purity Pct","description":"Scandium Oxide Sc2O3 purity % (Std >= 99.5%)","default":99.5},"doe_exim_loan_eligible":{"type":"boolean","title":"Doe Exim Loan Eligible","description":"Certified eligible for US DOE Title XVII & EXIM critical minerals lending","default":true},"ndaa_defense_procurement_eligible":{"type":"boolean","title":"Ndaa Defense Procurement Eligible","description":"Compliant with US NDAA Sec 848 defense procurement (non-covered nation)","default":true},"source_country":{"$ref":"#/components/schemas/SourceCountry","description":"Country of origin","default":"USA"},"client_identity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Identity"}},"type":"object","required":["batch_id","tenement_id","latitude","longitude"],"title":"NiobiumScandiumOriginVerifyRequest"},"NiobiumScandiumOriginVerifyResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"batch_id":{"type":"string","title":"Batch Id"},"commodity_type":{"type":"string","title":"Commodity Type"},"audit_verdict":{"$ref":"#/components/schemas/NiobiumScandiumAuditVerdict"},"proof_hash":{"type":"string","title":"Proof Hash"},"onchain_signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Onchain Signature"},"signed_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signed By"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["batch_id","commodity_type","audit_verdict","proof_hash","timestamp"],"title":"NiobiumScandiumOriginVerifyResponse"},"PaymentReceipt":{"properties":{"receipt_id":{"type":"string","title":"Receipt Id"},"payer_address":{"type":"string","title":"Payer Address"},"amount_paid_usdc":{"type":"number","title":"Amount Paid Usdc"},"pricing_tier":{"$ref":"#/components/schemas/PricingTier"},"timestamp_utc":{"type":"string","title":"Timestamp Utc"},"oracle_state_digest":{"type":"string","title":"Oracle State Digest"},"oracle_receipt_signature":{"type":"string","title":"Oracle Receipt Signature"},"network":{"type":"string","title":"Network","default":"Polygon (Chain ID 137)"}},"type":"object","required":["receipt_id","payer_address","amount_paid_usdc","pricing_tier","timestamp_utc","oracle_state_digest","oracle_receipt_signature"],"title":"PaymentReceipt"},"PricingTier":{"type":"string","enum":["LIGHT","STANDARD","HEAVY","ONCHAIN","ENTERPRISE"],"title":"PricingTier"},"ProcurementRFQRequest":{"properties":{"rfq_id":{"type":"string","title":"Rfq Id","description":"Buyer agent RFQ identifier"},"cell_chemistry":{"type":"string","title":"Cell Chemistry","description":"Target battery cell chemistry (e.g. NCM811, NCM622, LFP)","default":"NCM811"},"pack_capacity_kwh":{"type":"number","exclusiveMinimum":0.0,"title":"Pack Capacity Kwh","description":"Pack capacity in kWh","default":84.0},"lithium_tons":{"type":"number","exclusiveMinimum":0.0,"title":"Lithium Tons"},"lithium_origin_country":{"type":"string","title":"Lithium Origin Country","default":"AUS"},"lithium_feoc_equity_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Lithium Feoc Equity Pct","default":0.0},"nickel_tons":{"type":"number","exclusiveMinimum":0.0,"title":"Nickel Tons"},"nickel_origin_country":{"type":"string","title":"Nickel Origin Country","default":"IDN"},"nickel_feoc_equity_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Nickel Feoc Equity Pct","default":0.0},"cobalt_tons":{"type":"number","exclusiveMinimum":0.0,"title":"Cobalt Tons"},"cobalt_origin_country":{"type":"string","title":"Cobalt Origin Country","default":"COD"},"cobalt_feoc_equity_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Cobalt Feoc Equity Pct","default":0.0}},"type":"object","required":["rfq_id","lithium_tons","nickel_tons","cobalt_tons"],"title":"ProcurementRFQRequest"},"ProcurementRFQResponse":{"properties":{"rfq_id":{"type":"string","title":"Rfq Id"},"cell_chemistry":{"type":"string","title":"Cell Chemistry"},"status":{"type":"string","title":"Status"},"ira_fta_compliant":{"type":"boolean","title":"Ira Fta Compliant"},"ira_fta_value_ratio_pct":{"type":"number","title":"Ira Fta Value Ratio Pct"},"feoc_taint_detected":{"type":"boolean","title":"Feoc Taint Detected"},"tainted_minerals":{"items":{"type":"string"},"type":"array","title":"Tainted Minerals"},"us_subsidy_qualified_per_pack_usd":{"type":"number","title":"Us Subsidy Qualified Per Pack Usd"},"recommendation":{"type":"string","title":"Recommendation"},"composite_merkle_digest":{"type":"string","title":"Composite Merkle Digest"},"simulated_at_utc":{"type":"string","title":"Simulated At Utc"}},"type":"object","required":["rfq_id","cell_chemistry","status","ira_fta_compliant","ira_fta_value_ratio_pct","feoc_taint_detected","tainted_minerals","us_subsidy_qualified_per_pack_usd","recommendation","composite_merkle_digest","simulated_at_utc"],"title":"ProcurementRFQResponse"},"ProvisionKeyRequest":{"properties":{"organization_name":{"type":"string","title":"Organization Name"},"agent_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Identifier","description":"Agent Polygon wallet address (0x...) or public key (Zero PII)"},"contact_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Email","description":"DEPRECATED: Zero PII policy enforced. Ignored if provided."},"tier_plan":{"type":"string","title":"Tier Plan","default":"Enterprise-Platinum-Dedicated"}},"type":"object","required":["organization_name"],"title":"ProvisionKeyRequest"},"RareEarthsAuditVerdict":{"properties":{"is_compliant":{"type":"boolean","title":"Is Compliant"},"status":{"type":"string","title":"Status"},"geofence_verified":{"type":"boolean","title":"Geofence Verified"},"distance_to_concession_km":{"type":"number","title":"Distance To Concession Km"},"purity_certified":{"type":"boolean","title":"Purity Certified"},"radiation_safety_passed":{"type":"boolean","title":"Radiation Safety Passed"},"mofcom_china_content_passed":{"type":"boolean","title":"Mofcom China Content Passed"},"china_content_ratio":{"type":"number","title":"China Content Ratio"},"mofcom_rule_d35_eligible":{"type":"boolean","title":"Mofcom Rule D35 Eligible"},"dfars_2027_compliant":{"type":"boolean","title":"Dfars 2027 Compliant","default":true},"confidence_score":{"type":"number","title":"Confidence Score"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"}},"type":"object","required":["is_compliant","status","geofence_verified","distance_to_concession_km","purity_certified","radiation_safety_passed","mofcom_china_content_passed","china_content_ratio","mofcom_rule_d35_eligible","confidence_score","reasons"],"title":"RareEarthsAuditVerdict"},"RareEarthsOriginVerifyRequest":{"properties":{"batch_id":{"type":"string","title":"Batch Id","description":"Unique lot/batch identifier"},"tenement_id":{"type":"string","title":"Tenement Id","description":"Concession/mine site ID (e.g., MT_WELD, MOUNTAIN_PASS, NECHALACHO, LONGONJO)"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Centroid latitude of extraction site"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Centroid longitude of extraction site"},"ndpr_oxide_purity_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Ndpr Oxide Purity Pct","description":"NdPr Oxide assay purity % (min 99.5%)","default":99.5},"thorium_uranium_radiation_ppm":{"type":"number","minimum":0.0,"title":"Thorium Uranium Radiation Ppm","description":"Total Th+U radionuclide content in ppm (IAEA/Local safety limit <= 500 ppm)","default":45.0},"declared_china_origin_ratio":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Declared China Origin Ratio","description":"Declared ratio of PRC-origin inputs (MOFCOM Notice 61 requires < 0.001 / 0.1%)","default":0.0005},"source_country":{"$ref":"#/components/schemas/SourceCountry","description":"Jurisdiction of origin","default":"AUS"},"client_identity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Identity","description":"Requesting agent public identity or address"}},"type":"object","required":["batch_id","tenement_id","latitude","longitude"],"title":"RareEarthsOriginVerifyRequest"},"RareEarthsOriginVerifyResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"batch_id":{"type":"string","title":"Batch Id"},"audit_verdict":{"$ref":"#/components/schemas/RareEarthsAuditVerdict"},"proof_hash":{"type":"string","title":"Proof Hash"},"onchain_signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Onchain Signature"},"signed_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signed By"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["batch_id","audit_verdict","proof_hash","timestamp"],"title":"RareEarthsOriginVerifyResponse"},"ReceiptVerifyRequest":{"properties":{"receipt_id":{"type":"string","title":"Receipt Id"},"payer_address":{"type":"string","title":"Payer Address"},"amount_paid_usdc":{"type":"number","title":"Amount Paid Usdc"},"pricing_tier":{"type":"string","title":"Pricing Tier"},"network":{"type":"string","title":"Network"},"oracle_state_digest":{"type":"string","title":"Oracle State Digest"},"oracle_receipt_signature":{"type":"string","title":"Oracle Receipt Signature"}},"type":"object","required":["receipt_id","payer_address","amount_paid_usdc","pricing_tier","network","oracle_state_digest","oracle_receipt_signature"],"title":"ReceiptVerifyRequest"},"RefiningMassBalanceRecord":{"properties":{"refinery_id":{"type":"string","title":"Refinery Id","description":"Smelter/refinery global facility identifier"},"feedstock_input_metric_tons":{"type":"number","exclusiveMinimum":0.0,"title":"Feedstock Input Metric Tons","description":"Total ore/feedstock input in metric tons"},"refined_output_metric_tons":{"type":"number","exclusiveMinimum":0.0,"title":"Refined Output Metric Tons","description":"Finished product yield in metric tons"},"recovery_yield_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Recovery Yield Pct","description":"Process recovery efficiency %"},"mass_balance_loss_discrepancy_pct":{"type":"number","minimum":0.0,"title":"Mass Balance Loss Discrepancy Pct","description":"OECD Annex II mass balance loss discrepancy percentage (Must be <= 2.0%)"},"captive_coal_power_used":{"type":"boolean","title":"Captive Coal Power Used","description":"True if refined with captive coal power (EU CBAM risk)","default":false},"cbam_scope1_emissions_kg_co2e":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cbam Scope1 Emissions Kg Co2E","description":"Direct Scope 1 emissions in kg CO2e per kg mineral"},"cbam_scope2_emissions_kg_co2e":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cbam Scope2 Emissions Kg Co2E","description":"Indirect Scope 2 electricity emissions in kg CO2e per kg mineral"},"cbam_scope3_emissions_kg_co2e":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cbam Scope3 Emissions Kg Co2E","description":"Upstream/downstream Scope 3 emissions in kg CO2e per kg mineral"},"cbam_declaration_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cbam Declaration Id","description":"EU CBAM Definitive Period registry declaration reference"},"solvent_extraction_tech_origin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Solvent Extraction Tech Origin","description":"Origin of SX technology: DOMESTIC, WESTERN, CHINA_LICENSED, CHINA_UNLICENSED","default":"DOMESTIC"},"chinese_tech_dependency_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Chinese Tech Dependency Pct","description":"Percentage dependency on Chinese proprietary SX/smelting technology/catalysts","default":0.0},"mofcom_extraterritorial_clearance_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mofcom Extraterritorial Clearance Id","description":"China MOFCOM dual-use extraterritorial technology export authorization ID"},"substitute_western_tech_certified":{"type":"boolean","title":"Substitute Western Tech Certified","description":"Certified availability and operational deployment of non-Chinese Western alternative SX/refining technology","default":false},"sulfuric_acid_input_metric_tons":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sulfuric Acid Input Metric Tons","description":"Sulfuric acid (H2SO4) input in metric tons for copper leach/smelting"},"sulfuric_acid_discrepancy_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sulfuric Acid Discrepancy Pct","description":"Discrepancy % from stoichiometric sulfuric acid requirement (max allowable 5.0%)"},"hvdc_grade_copper_certified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hvdc Grade Copper Certified","description":"True if copper cathode meets ASTM B115 Grade 1 (99.9935% Cu) for HVDC cables"},"solar_pv_topcon_silver_certified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Solar Pv Topcon Silver Certified","description":"True if silver powder/paste meets 99.99% purity for N-type TOPCon solar PV cells"}},"type":"object","required":["refinery_id","feedstock_input_metric_tons","refined_output_metric_tons","recovery_yield_pct","mass_balance_loss_discrepancy_pct"],"title":"RefiningMassBalanceRecord"},"ResponseMeta":{"properties":{"license":{"type":"string","title":"License","description":"Open Source AS-IS Software & Data Reference License","default":"AS-IS"},"disclaimer":{"type":"string","title":"Disclaimer","description":"Binding algorithmic reference disclaimer","default":"This output is an automated algorithmic data reference and does not constitute legal, regulatory, or compliance certification. The user/calling agent assumes all risks regarding real-world application."},"warranty":{"type":"string","title":"Warranty","description":"Standard MIT/Apache 2.0 disclaimer of warranty","default":"PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT."},"service_nature":{"type":"string","title":"Service Nature","description":"Pure computational calculator / data vending machine","default":"Algorithmic Heuristic Calculator & Public Ledger Feed (Stateless M2M)"}},"type":"object","title":"ResponseMeta"},"SMELightweightInput":{"properties":{"supplier_name":{"type":"string","title":"Supplier Name","description":"Corporate or trade name of the SME supplier"},"business_registration_no":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Registration No","description":"Tax or corporate registration identifier"},"mineral_type":{"$ref":"#/components/schemas/MineralType","description":"Mineral or alloy type processed","default":"COPPER_CATHODE"},"source_country":{"$ref":"#/components/schemas/SourceCountry","description":"Declared country of raw material origin","default":"CHL"},"feedstock_input_ton":{"type":"number","exclusiveMinimum":0.0,"title":"Feedstock Input Ton","description":"Raw feedstock or unrefined ingot input in metric tons"},"refined_output_ton":{"type":"number","exclusiveMinimum":0.0,"title":"Refined Output Ton","description":"Finished processed product output in metric tons"},"scrap_recycled_ratio_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Scrap Recycled Ratio Pct","description":"Percentage of secondary recycled scrap utilized","default":0.0},"monthly_electricity_kwh":{"type":"number","minimum":0.0,"title":"Monthly Electricity Kwh","description":"Monthly grid electricity consumption from utility invoice (kWh)"},"grid_region":{"type":"string","title":"Grid Region","description":"Grid emission region: KR_GRID, US_GRID, EU_GRID, CL_GRID","default":"KR_GRID"},"purity_pct":{"type":"number","maximum":100.0,"minimum":80.0,"title":"Purity Pct","description":"Finished product assay purity percentage","default":99.99}},"type":"object","required":["supplier_name","feedstock_input_ton","refined_output_ton","monthly_electricity_kwh"],"title":"SMELightweightInput"},"SMELightweightResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"sme_verification_id":{"type":"string","title":"Sme Verification Id"},"supplier_name":{"type":"string","title":"Supplier Name"},"mineral_type":{"$ref":"#/components/schemas/MineralType"},"scope_1_direct_co2_ton":{"type":"number","title":"Scope 1 Direct Co2 Ton"},"scope_2_indirect_co2_ton":{"type":"number","title":"Scope 2 Indirect Co2 Ton"},"total_embedded_carbon_ton":{"type":"number","title":"Total Embedded Carbon Ton"},"carbon_intensity_ton_co2_per_ton":{"type":"number","title":"Carbon Intensity Ton Co2 Per Ton"},"mass_balance_loss_pct":{"type":"number","title":"Mass Balance Loss Pct"},"mass_balance_compliant":{"type":"boolean","title":"Mass Balance Compliant"},"cbam_ready":{"type":"boolean","title":"Cbam Ready"},"verdict":{"type":"string","title":"Verdict"},"attestation_hash":{"type":"string","title":"Attestation Hash"},"timestamp_utc":{"type":"string","title":"Timestamp Utc"}},"type":"object","required":["sme_verification_id","supplier_name","mineral_type","scope_1_direct_co2_ton","scope_2_indirect_co2_ton","total_embedded_carbon_ton","carbon_intensity_ton_co2_per_ton","mass_balance_loss_pct","mass_balance_compliant","cbam_ready","verdict","attestation_hash","timestamp_utc"],"title":"SMELightweightResponse"},"SecurityAttestation":{"properties":{"security_gate_certified":{"type":"boolean","title":"Security Gate Certified","description":"True if verified and certified by Security Gate x402","default":true},"security_gate_url":{"type":"string","title":"Security Gate Url","description":"Endpoint URL of the certifying security gate"},"security_gate_mode":{"type":"string","title":"Security Gate Mode","description":"Verification mode: REMOTE_GATEWAY or LOCAL_STANDALONE","default":"REMOTE_GATEWAY"},"agent_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Address","description":"Requesting agent wallet address"},"agent_credit_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Credit Tier","description":"FICO-style credit tier (e.g. AAA, AA, A, BBB)"},"agent_credit_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Agent Credit Score","description":"Dynamic agent credit score (300-850)"},"compliance_standard":{"type":"string","title":"Compliance Standard","description":"Regulatory and safety compliance standard","default":"EU_AI_ACT_2024_1689_ART50"},"dual_attestation_hash":{"type":"string","title":"Dual Attestation Hash","description":"Cryptographic joint hash binding oracle digest & security passport"},"latency_ms":{"type":"number","title":"Latency Ms","description":"Verification latency in milliseconds"},"truth_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Truth Hash","description":"EIP-712 physical truth hash from Security Gate adapter"},"verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verdict","description":"Attestation verification verdict: PASSED or FAILED","default":"PASSED"}},"type":"object","required":["security_gate_url","dual_attestation_hash","latency_ms"],"title":"SecurityAttestation"},"SilverAuditVerdict":{"properties":{"geofence_verified":{"type":"boolean","title":"Geofence Verified"},"refining_mass_balance_passed":{"type":"boolean","title":"Refining Mass Balance Passed"},"topcon_solar_pv_certified":{"type":"boolean","title":"Topcon Solar Pv Certified"},"conflict_free_asm_passed":{"type":"boolean","title":"Conflict Free Asm Passed"},"lbma_cleared":{"type":"boolean","title":"Lbma Cleared"},"feoc_cleared":{"type":"boolean","title":"Feoc Cleared"},"confidence_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Confidence Score"},"defenses_applied":{"items":{"type":"string"},"type":"array","title":"Defenses Applied"}},"type":"object","required":["geofence_verified","refining_mass_balance_passed","topcon_solar_pv_certified","conflict_free_asm_passed","lbma_cleared","feoc_cleared","confidence_score"],"title":"SilverAuditVerdict"},"SilverOriginVerifyRequest":{"properties":{"lot_id":{"type":"string","title":"Lot Id","description":"Unique enterprise silver batch identifier"},"mine_concession_name":{"type":"string","title":"Mine Concession Name","description":"Canonical mine concession: TERRONERA, FRESNILLO, ANTAMINA, UCHUCCHACUA, LOS_PELAMBRES","default":"TERRONERA"},"extraction_coordinates":{"prefixItems":[{"type":"number"},{"type":"number"}],"type":"array","maxItems":2,"minItems":2,"title":"Extraction Coordinates","description":"(lat, lon) centroid coordinates"},"source_country":{"$ref":"#/components/schemas/SourceCountry","description":"Country of extraction","default":"MEX"},"feedstock_dore_or_ore_kg":{"type":"number","exclusiveMinimum":0.0,"title":"Feedstock Dore Or Ore Kg","description":"Unrefined Doré bullion or high-grade ore input in kg"},"feedstock_silver_grade_pct":{"type":"number","maximum":98.0,"minimum":10.0,"title":"Feedstock Silver Grade Pct","description":"Doré bullion silver content % (default 75.0% Ag)","default":75.0},"refined_solar_powder_kg":{"type":"number","exclusiveMinimum":0.0,"title":"Refined Solar Powder Kg","description":"Finished electrolytic silver powder/paste yield in kg"},"refined_purity_pct":{"type":"number","maximum":100.0,"minimum":95.0,"title":"Refined Purity Pct","description":"Refined silver assay purity % (Solar PV paste requires >= 99.99%)","default":99.99},"lbma_good_delivery_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lbma Good Delivery Ref","description":"LBMA Good Delivery ref or accredited refiner license ID"},"conflict_free_asm_verified":{"type":"boolean","title":"Conflict Free Asm Verified","description":"Verified free from illegal artisanal laundering or cartel supply","default":true},"topcon_pv_grade_compliant":{"type":"boolean","title":"Topcon Pv Grade Compliant","description":"Certified for N-type TOPCon / HJT solar cell metallization paste","default":true},"feoc_shareholding_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Feoc Shareholding Pct","description":"Covered nation equity shareholding %","default":0.0},"agent_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Address","description":"Buyer agent Polygon wallet address"}},"type":"object","required":["lot_id","extraction_coordinates","feedstock_dore_or_ore_kg","refined_solar_powder_kg"],"title":"SilverOriginVerifyRequest"},"SilverOriginVerifyResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"lot_id":{"type":"string","title":"Lot Id"},"extraction_origin":{"additionalProperties":true,"type":"object","title":"Extraction Origin"},"mass_balance_audit":{"additionalProperties":true,"type":"object","title":"Mass Balance Audit"},"verdict":{"$ref":"#/components/schemas/SilverAuditVerdict"},"onchain_proof":{"type":"string","title":"Onchain Proof"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["lot_id","extraction_origin","mass_balance_audit","verdict","onchain_proof","timestamp"],"title":"SilverOriginVerifyResponse"},"SolanaTruthAttestRequest":{"properties":{"domain":{"type":"string","title":"Domain","description":"Target domain: CONFLICT_MINERALS or EUDR_FOREST","default":"CONFLICT_MINERALS"},"domain_id":{"type":"integer","title":"Domain Id","description":"Numeric domain identifier: 3 for EUDR, 4 for Minerals","default":4},"query_payload":{"additionalProperties":true,"type":"object","title":"Query Payload","description":"Arbitrary verification query payload"},"client_identity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Identity","description":"Requesting agent public key / client identity"},"confidence_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence Score","description":"Truth confidence score threshold","default":0.999}},"type":"object","title":"SolanaTruthAttestRequest"},"SolanaUniversalSettleRequest":{"properties":{"deal_id":{"type":"string","title":"Deal Id","description":"Unique trade deal ID to settle"},"buyer_agent_pubkey":{"type":"string","title":"Buyer Agent Pubkey","description":"Solana public key of buyer agent (Base58)"},"seller_agent_pubkey":{"type":"string","title":"Seller Agent Pubkey","description":"Solana public key of seller agent (Base58)"},"gross_amount_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Gross Amount Usdc","description":"Gross trade settlement amount in USDC"},"oracle_domain":{"type":"string","title":"Oracle Domain","description":"Oracle verification domain","default":"CONFLICT_MINERALS"},"oracle_id":{"type":"integer","title":"Oracle Id","description":"Numeric oracle domain ID","default":4}},"type":"object","required":["deal_id","buyer_agent_pubkey","seller_agent_pubkey","gross_amount_usdc"],"title":"SolanaUniversalSettleRequest"},"SourceCountry":{"type":"string","enum":["IDN","COD","CHL","ARG","AUS","BRA","CHN","ZAF","USA","MEX","PER","CAN","PRT","AGO","ZMB","VNM","KOR","DEU","GRL","EST","KAZ","ESP"],"title":"SourceCountry"},"SponsoredDealAttestationRequest":{"properties":{"deal_id":{"type":"string","title":"Deal Id","description":"Canonical trade deal ID"},"deal_hash":{"type":"string","title":"Deal Hash","description":"EIP-712 bilateral deal hash"},"buyer_agent_address":{"type":"string","title":"Buyer Agent Address","description":"Buyer agent EVM address"},"seller_agent_address":{"type":"string","title":"Seller Agent Address","description":"Seller agent EVM address"},"final_contract_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Final Contract Hash","description":"Oracle sealed contract hash"}},"type":"object","required":["deal_id","deal_hash","buyer_agent_address","seller_agent_address"],"title":"SponsoredDealAttestationRequest"},"SponsoredPassportMintRequest":{"properties":{"lot_id":{"type":"string","title":"Lot Id","description":"Unique mineral lot identifier (e.g. LOT-2026-CHL-001)"},"mineral_type":{"type":"string","title":"Mineral Type","description":"Mineral commodity (e.g. LITHIUM_CARBONATE, NICKEL_MHP)"},"compliance_verdict":{"type":"string","title":"Compliance Verdict","description":"Oracle verdict","default":"COMPLIANT_CLEAN_CORRIDOR"},"agent_address":{"type":"string","title":"Agent Address","description":"Submitting AI agent EVM address"}},"type":"object","required":["lot_id","mineral_type","agent_address"],"title":"SponsoredPassportMintRequest"},"SupplyChainBatchItemResult":{"properties":{"lot_id":{"type":"string","title":"Lot Id"},"supplier_name":{"type":"string","title":"Supplier Name"},"mineral_type":{"$ref":"#/components/schemas/MineralType"},"source_country":{"$ref":"#/components/schemas/SourceCountry"},"verdict":{"$ref":"#/components/schemas/ComplianceVerdict"},"compliance_score":{"type":"number","title":"Compliance Score"},"violations":{"items":{"type":"string"},"type":"array","title":"Violations"},"passport_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Passport Id"}},"type":"object","required":["lot_id","supplier_name","mineral_type","source_country","verdict","compliance_score"],"title":"SupplyChainBatchItemResult"},"SupplyChainBatchRequest":{"properties":{"enterprise_api_key":{"type":"string","title":"Enterprise Api Key","description":"Enterprise VIP or institutional API key"},"batch_title":{"type":"string","title":"Batch Title","description":"Audit batch run description","default":"Tier-Supplier Global Compliance Batch"},"tier_suppliers":{"items":{"$ref":"#/components/schemas/MineralLotProvenanceRequest"},"type":"array","minItems":1,"title":"Tier Suppliers","description":"List of lot verification requests across the supply network"}},"type":"object","required":["enterprise_api_key","tier_suppliers"],"title":"SupplyChainBatchRequest"},"SupplyChainBatchResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"batch_id":{"type":"string","title":"Batch Id"},"batch_title":{"type":"string","title":"Batch Title"},"total_audited":{"type":"integer","title":"Total Audited"},"passed_count":{"type":"integer","title":"Passed Count"},"failed_count":{"type":"integer","title":"Failed Count"},"batch_compliance_rate_pct":{"type":"number","title":"Batch Compliance Rate Pct"},"composite_supply_chain_score":{"type":"number","title":"Composite Supply Chain Score"},"critical_risk_flags":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Critical Risk Flags"},"remediation_guidance":{"items":{"type":"string"},"type":"array","title":"Remediation Guidance"},"results":{"items":{"$ref":"#/components/schemas/SupplyChainBatchItemResult"},"type":"array","title":"Results"},"processed_at_utc":{"type":"string","title":"Processed At Utc"}},"type":"object","required":["batch_id","batch_title","total_audited","passed_count","failed_count","batch_compliance_rate_pct","composite_supply_chain_score","processed_at_utc"],"title":"SupplyChainBatchResponse"},"TradeCorridorFlow":{"properties":{"corridor_id":{"type":"string","title":"Corridor Id","description":"Unique identifier of the trade corridor"},"mineral_type":{"$ref":"#/components/schemas/MineralType","description":"Critical mineral cargo type"},"origin_country":{"$ref":"#/components/schemas/SourceCountry","description":"Country of extraction/export"},"origin_port_name":{"type":"string","title":"Origin Port Name","description":"Port of loading name"},"origin_port_code":{"type":"string","title":"Origin Port Code","description":"UN/LOCODE 5-letter port code"},"destination_country":{"type":"string","title":"Destination Country","description":"Importing nation ISO-3"},"destination_port_name":{"type":"string","title":"Destination Port Name","description":"Port of discharge name"},"destination_port_code":{"type":"string","title":"Destination Port Code","description":"UN/LOCODE 5-letter port code"},"monthly_volume_metric_tons":{"type":"number","title":"Monthly Volume Metric Tons","description":"Average monthly bulk trade volume (MT)"},"standard_distance_nm":{"type":"number","title":"Standard Distance Nm","description":"Standard voyage distance in nautical miles"},"transit_days":{"type":"number","title":"Transit Days","description":"Standard transit days at 13 knots"},"primary_vessel_class":{"type":"string","title":"Primary Vessel Class","description":"Typical bulk carrier class (e.g. Supramax, Panamax, Capesize)"},"chokepoints":{"items":{"type":"string"},"type":"array","title":"Chokepoints","description":"Key maritime chokepoints traversed"},"freight_rate_usd_per_mt":{"type":"number","title":"Freight Rate Usd Per Mt","description":"Current voyage charter freight rate ($/MT)"}},"type":"object","required":["corridor_id","mineral_type","origin_country","origin_port_name","origin_port_code","destination_country","destination_port_name","destination_port_code","monthly_volume_metric_tons","standard_distance_nm","transit_days","primary_vessel_class","freight_rate_usd_per_mt"],"title":"TradeCorridorFlow"},"TradeDealAttestation":{"properties":{"deal_id":{"type":"string","title":"Deal Id"},"status":{"type":"string","title":"Status","description":"Deal status: PROPOSED, DUAL_SIGNED_CONFIRMED, REJECTED, CANCELLED, EXPIRED","default":"DUAL_SIGNED_CONFIRMED"},"deal_hash":{"type":"string","title":"Deal Hash"},"spec":{"$ref":"#/components/schemas/TradeDealSpec"},"seller_signature":{"type":"string","title":"Seller Signature"},"buyer_signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buyer Signature"},"oracle_attestation_signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Oracle Attestation Signature"},"final_contract_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Final Contract Hash"},"onchain_tx_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Onchain Tx Hash","description":"Polygon transaction hash if anchored by gasless relayer"},"verified_at_utc":{"type":"string","title":"Verified At Utc"},"audit_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audit Notes"}},"type":"object","required":["deal_id","deal_hash","spec","seller_signature","verified_at_utc"],"title":"TradeDealAttestation"},"TradeDealCancelRequest":{"properties":{"deal_id":{"type":"string","title":"Deal Id","description":"Deal ID to cancel/revoke"},"seller_agent_address":{"type":"string","title":"Seller Agent Address","description":"Seller agent address executing revocation"},"seller_signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seller Signature","description":"Cryptographic signature confirming cancellation"},"cancellation_reason":{"type":"string","title":"Cancellation Reason","description":"Reason for cancellation","default":"SELLER_WITHDRAWAL"}},"type":"object","required":["deal_id","seller_agent_address"],"title":"TradeDealCancelRequest"},"TradeDealDualSignRequest":{"properties":{"deal_id":{"type":"string","title":"Deal Id","description":"Deal ID to countersign"},"buyer_signature":{"type":"string","title":"Buyer Signature","description":"Buyer agent cryptographic signature over EIP-712 deal hash"},"buyer_agent_address":{"type":"string","title":"Buyer Agent Address","description":"Buyer agent address for verification"}},"type":"object","required":["deal_id","buyer_signature","buyer_agent_address"],"title":"TradeDealDualSignRequest"},"TradeDealListResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"total_count":{"type":"integer","title":"Total Count"},"deals":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Deals"}},"type":"object","required":["total_count","deals"],"title":"TradeDealListResponse"},"TradeDealProposeRequest":{"properties":{"spec":{"$ref":"#/components/schemas/TradeDealSpec","description":"Canonical trade deal terms"},"seller_signature":{"type":"string","title":"Seller Signature","description":"Seller agent cryptographic signature over EIP-712 deal hash"}},"type":"object","required":["spec","seller_signature"],"title":"TradeDealProposeRequest"},"TradeDealRejectRequest":{"properties":{"deal_id":{"type":"string","title":"Deal Id","description":"Deal ID to reject"},"buyer_agent_address":{"type":"string","title":"Buyer Agent Address","description":"Buyer agent address executing rejection"},"buyer_signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buyer Signature","description":"Cryptographic signature confirming rejection"},"rejection_reason":{"type":"string","title":"Rejection Reason","description":"Reason for rejection","default":"TERMS_UNACCEPTABLE"}},"type":"object","required":["deal_id","buyer_agent_address"],"title":"TradeDealRejectRequest"},"TradeDealSpec":{"properties":{"deal_id":{"type":"string","title":"Deal Id","description":"Unique A2A trade deal identifier"},"commodity":{"$ref":"#/components/schemas/MineralType","description":"Traded mineral commodity"},"volume_tons":{"type":"number","exclusiveMinimum":0.0,"title":"Volume Tons","description":"Cargo volume in metric tons"},"unit_price_usd_per_ton":{"type":"number","exclusiveMinimum":0.0,"title":"Unit Price Usd Per Ton","description":"Agreed price per metric ton in USD"},"total_deal_value_usd":{"type":"number","exclusiveMinimum":0.0,"title":"Total Deal Value Usd","description":"Gross deal value in USD"},"origin_country":{"$ref":"#/components/schemas/SourceCountry","description":"Country of extraction"},"destination_country":{"type":"string","title":"Destination Country","description":"Destination market"},"feoc_cleared":{"type":"boolean","title":"Feoc Cleared","description":"True if certified < 25% covered nation equity","default":true},"mass_balance_cleared":{"type":"boolean","title":"Mass Balance Cleared","description":"True if certified under stoichiometric mass balance","default":true},"ebl_document_id":{"type":"string","title":"Ebl Document Id","description":"Associated Electronic Bill of Lading reference"},"buyer_agent_address":{"type":"string","title":"Buyer Agent Address","description":"Buyer agent EVM address (0x...)"},"seller_agent_address":{"type":"string","title":"Seller Agent Address","description":"Seller agent EVM address (0x...)"},"settlement_currency":{"type":"string","title":"Settlement Currency","description":"Settlement cryptocurrency","default":"USDC"},"projected_savings_usd":{"type":"number","title":"Projected Savings Usd","description":"Oracle-calculated tariff and logistics savings in USD","default":0.0},"gain_share_rate_pct":{"type":"number","title":"Gain Share Rate Pct","description":"Agreed gain-share percentage (default 10%)","default":10.0},"calculated_gain_share_fee_usd":{"type":"number","title":"Calculated Gain Share Fee Usd","description":"Calculated gain-share settlement fee in USD","default":0.0},"fee_cap_applied":{"type":"boolean","title":"Fee Cap Applied","description":"True if fee exceeded cap (e.g. $10,000 max)","default":false},"hybrid_settlement_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hybrid Settlement Summary","description":"Detailed hybrid fee breakdown"},"expires_at_utc":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At Utc","description":"Expiration timestamp in ISO UTC (default: 24h after creation)"},"created_at_utc":{"type":"string","title":"Created At Utc"}},"type":"object","required":["deal_id","commodity","volume_tons","unit_price_usd_per_ton","total_deal_value_usd","origin_country","destination_country","ebl_document_id","buyer_agent_address","seller_agent_address","created_at_utc"],"title":"TradeDealSpec"},"TradeDealVerifyResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"deal_id":{"type":"string","title":"Deal Id"},"is_valid":{"type":"boolean","title":"Is Valid"},"deal_status":{"type":"string","title":"Deal Status"},"seller_verified":{"type":"boolean","title":"Seller Verified"},"buyer_verified":{"type":"boolean","title":"Buyer Verified"},"oracle_verified":{"type":"boolean","title":"Oracle Verified"},"deal_hash":{"type":"string","title":"Deal Hash"},"final_contract_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Final Contract Hash"},"onchain_tx_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Onchain Tx Hash","description":"Polygon transaction hash if anchored by gasless relayer"},"compliance_audit_summary":{"type":"string","title":"Compliance Audit Summary"}},"type":"object","required":["deal_id","is_valid","deal_status","seller_verified","buyer_verified","oracle_verified","deal_hash","final_contract_hash","compliance_audit_summary"],"title":"TradeDealVerifyResponse"},"TradeJurisprudenceCitation":{"properties":{"precedent_case_id":{"type":"string","title":"Precedent Case Id","description":"Citation ID (e.g. WTO_DS592, ICSID_ARB_15_31, CIT_SUPERIOR_WIRE)"},"tribunal":{"type":"string","title":"Tribunal","description":"Adjudicating body (e.g. WTO DSB, ICSID, US CIT, UK EWHC)"},"legal_rule_applied":{"type":"string","title":"Legal Rule Applied","description":"Core ratio decidendi or legal doctrine applied to this lot"},"compliance_status":{"type":"string","title":"Compliance Status","description":"COMPLIANT, WARNING, or VIOLATION"}},"type":"object","required":["precedent_case_id","tribunal","legal_rule_applied","compliance_status"],"title":"TradeJurisprudenceCitation"},"TradeRouteOptimizationRequest":{"properties":{"mineral_type":{"$ref":"#/components/schemas/MineralType","description":"Mineral cargo to transport"},"origin_country":{"$ref":"#/components/schemas/SourceCountry","description":"Origin extraction country"},"destination_country":{"type":"string","title":"Destination Country","description":"Destination consuming nation"},"cargo_weight_metric_tons":{"type":"number","exclusiveMinimum":0.0,"title":"Cargo Weight Metric Tons","description":"Cargo volume in metric tons"},"target_delivery_deadline_days":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Target Delivery Deadline Days","description":"Max acceptable transit time in days"},"max_carbon_budget_co2_tons":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Carbon Budget Co2 Tons","description":"Max acceptable voyage CO2 in tons"}},"type":"object","required":["mineral_type","origin_country","destination_country","cargo_weight_metric_tons"],"title":"TradeRouteOptimizationRequest"},"TradeRouteOptimizationResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"mineral_type":{"$ref":"#/components/schemas/MineralType"},"origin_country":{"$ref":"#/components/schemas/SourceCountry"},"destination_country":{"type":"string","title":"Destination Country"},"cargo_weight_metric_tons":{"type":"number","title":"Cargo Weight Metric Tons"},"optimal_corridor_id":{"type":"string","title":"Optimal Corridor Id"},"recommended_route_summary":{"type":"string","title":"Recommended Route Summary"},"options_evaluated":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Options Evaluated"},"estimated_landed_cost_usd_per_mt":{"type":"number","title":"Estimated Landed Cost Usd Per Mt"},"total_freight_and_tariff_usd":{"type":"number","title":"Total Freight And Tariff Usd"},"transit_days":{"type":"number","title":"Transit Days"},"compliance_rating":{"type":"string","title":"Compliance Rating"},"agent_decision":{"anyOf":[{"$ref":"#/components/schemas/AgentDecisionSignal"},{"type":"null"}]},"evaluated_at_utc":{"type":"string","title":"Evaluated At Utc"}},"type":"object","required":["mineral_type","origin_country","destination_country","cargo_weight_metric_tons","optimal_corridor_id","recommended_route_summary","options_evaluated","estimated_landed_cost_usd_per_mt","total_freight_and_tariff_usd","transit_days","compliance_rating","evaluated_at_utc"],"title":"TradeRouteOptimizationResponse"},"TungstenAuditVerdict":{"properties":{"is_compliant":{"type":"boolean","title":"Is Compliant"},"status":{"type":"string","title":"Status"},"geofence_verified":{"type":"boolean","title":"Geofence Verified"},"distance_to_concession_km":{"type":"number","title":"Distance To Concession Km"},"apt_grade_certified":{"type":"boolean","title":"Apt Grade Certified"},"dodd_frank_passed":{"type":"boolean","title":"Dodd Frank Passed"},"ndaa_defense_eligible":{"type":"boolean","title":"Ndaa Defense Eligible"},"confidence_score":{"type":"number","title":"Confidence Score"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"}},"type":"object","required":["is_compliant","status","geofence_verified","distance_to_concession_km","apt_grade_certified","dodd_frank_passed","ndaa_defense_eligible","confidence_score","reasons"],"title":"TungstenAuditVerdict"},"TungstenOriginVerifyRequest":{"properties":{"batch_id":{"type":"string","title":"Batch Id","description":"Lot/batch ID of tungsten concentrate or APT"},"tenement_id":{"type":"string","title":"Tenement Id","description":"Concession ID (e.g., CANTUNG, IMA_PROJECT, PANASQUEIRA, SANGDONG)"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"apt_wo3_grade_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Apt Wo3 Grade Pct","description":"Ammonium Paratungstate WO3 grade % (Std >= 88.5%)","default":88.5},"dodd_frank_conflict_free":{"type":"boolean","title":"Dodd Frank Conflict Free","description":"Certified conflict-free under OECD Due Diligence","default":true},"ndaa_defense_procurement_eligible":{"type":"boolean","title":"Ndaa Defense Procurement Eligible","description":"Eligible under US NDAA Sec 848 non-covered nation procurement","default":true},"source_country":{"$ref":"#/components/schemas/SourceCountry","description":"Country of origin","default":"CAN"},"client_identity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Identity"}},"type":"object","required":["batch_id","tenement_id","latitude","longitude"],"title":"TungstenOriginVerifyRequest"},"TungstenOriginVerifyResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"batch_id":{"type":"string","title":"Batch Id"},"audit_verdict":{"$ref":"#/components/schemas/TungstenAuditVerdict"},"proof_hash":{"type":"string","title":"Proof Hash"},"onchain_signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Onchain Signature"},"signed_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signed By"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["batch_id","audit_verdict","proof_hash","timestamp"],"title":"TungstenOriginVerifyResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VaultBalanceResponse":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","default":"success"},"agent_address":{"type":"string","title":"Agent Address"},"balance_usdc":{"type":"number","title":"Balance Usdc"},"total_deposited_usdc":{"type":"number","title":"Total Deposited Usdc"},"total_consumed_usdc":{"type":"number","title":"Total Consumed Usdc"},"session_key":{"type":"string","title":"Session Key"},"query_count":{"type":"integer","title":"Query Count"},"last_active_utc":{"type":"string","title":"Last Active Utc"},"capacity":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Capacity"},"receipt":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Receipt"}},"type":"object","required":["agent_address","balance_usdc","total_deposited_usdc","total_consumed_usdc","session_key","query_count","last_active_utc"],"title":"VaultBalanceResponse"},"VaultDepositRequest":{"properties":{"agent_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Address"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier"},"amount_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Amount Usdc"},"tx_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tx Hash"},"chain":{"type":"string","title":"Chain","default":"polygon"}},"type":"object","required":["amount_usdc"],"title":"VaultDepositRequest"},"VoucherAuditPackageResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"passport_id":{"type":"string","title":"Passport Id"},"standard_authority":{"type":"string","title":"Standard Authority","default":"MOTIE_K-CBAM_2026 / ISO 14064 / ISO/IEC 17025"},"supplier_metadata":{"additionalProperties":true,"type":"object","title":"Supplier Metadata"},"carbon_accounting_breakdown":{"additionalProperties":true,"type":"object","title":"Carbon Accounting Breakdown"},"mass_balance_audit_trail":{"additionalProperties":true,"type":"object","title":"Mass Balance Audit Trail"},"regulatory_defense_matrix":{"additionalProperties":true,"type":"object","title":"Regulatory Defense Matrix"},"government_voucher_reconciliation_hash":{"type":"string","title":"Government Voucher Reconciliation Hash"},"issued_at_utc":{"type":"string","title":"Issued At Utc"}},"type":"object","required":["passport_id","supplier_metadata","carbon_accounting_breakdown","mass_balance_audit_trail","regulatory_defense_matrix","government_voucher_reconciliation_hash","issued_at_utc"],"title":"VoucherAuditPackageResponse"},"ZKComplianceProofRequest":{"properties":{"batch_id":{"type":"string","title":"Batch Id","description":"Batch identifier to generate private proof for"},"secret_mine_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Secret Mine Latitude","description":"Private: Exact latitude of mine"},"secret_mine_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Secret Mine Longitude","description":"Private: Exact longitude of mine"},"secret_unit_cost_usd":{"type":"number","exclusiveMinimum":0.0,"title":"Secret Unit Cost Usd","description":"Private: Production unit cost in USD"},"secret_supplier_id":{"type":"string","title":"Secret Supplier Id","description":"Private: Internal supplier entity ID"},"public_authorized_zone_root":{"type":"string","title":"Public Authorized Zone Root","description":"Public: Merkle root of approved mining concessions"},"public_china_origin_ratio":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Public China Origin Ratio","description":"Public: Verified China origin content ratio (< 0.001)","default":0.0004},"public_max_carbon_kg_co2":{"type":"number","exclusiveMinimum":0.0,"title":"Public Max Carbon Kg Co2","description":"Public: Upper carbon bound limit","default":100.0}},"type":"object","required":["batch_id","secret_mine_latitude","secret_mine_longitude","secret_unit_cost_usd","secret_supplier_id","public_authorized_zone_root"],"title":"ZKComplianceProofRequest"},"ZKComplianceProofResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"batch_id":{"type":"string","title":"Batch Id"},"zk_proof":{"additionalProperties":true,"type":"object","title":"Zk Proof"},"public_commitment":{"type":"string","title":"Public Commitment"},"nullifier_hash":{"type":"string","title":"Nullifier Hash"},"verification_key_id":{"type":"string","title":"Verification Key Id"},"is_valid_zero_knowledge_proof":{"type":"boolean","title":"Is Valid Zero Knowledge Proof"},"issued_at":{"type":"string","title":"Issued At"}},"type":"object","required":["batch_id","zk_proof","public_commitment","nullifier_hash","verification_key_id","is_valid_zero_knowledge_proof","issued_at"],"title":"ZKComplianceProofResponse"},"ZKProofVerifyRequest":{"properties":{"zk_proof":{"additionalProperties":true,"type":"object","title":"Zk Proof"},"public_commitment":{"type":"string","title":"Public Commitment"},"nullifier_hash":{"type":"string","title":"Nullifier Hash"},"public_authorized_zone_root":{"type":"string","title":"Public Authorized Zone Root"},"public_china_origin_ratio":{"type":"number","title":"Public China Origin Ratio"}},"type":"object","required":["zk_proof","public_commitment","nullifier_hash","public_authorized_zone_root","public_china_origin_ratio"],"title":"ZKProofVerifyRequest"},"ZKProofVerifyResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"is_valid":{"type":"boolean","title":"Is Valid"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"},"verifier_identity":{"type":"string","title":"Verifier Identity"},"verified_at":{"type":"string","title":"Verified At"}},"type":"object","required":["is_valid","reasons","verifier_identity","verified_at"],"title":"ZKProofVerifyResponse"}}}}