{
      "tool_id": "art-325-tvm-irr",
      "tool_version": "1.0.0",
      "display_name": "Internal Rate of Return (IRR)",
      "mcp_name": "compute_irr",
      "mandate_type": "analytics_mandate",
      "wave": 57,
      "gpu": false,
      "url": "https://ainumbers.co/chaingraph/art-325-tvm-irr.html",
      "description": "Internal rate of return for an equal-period cash flow series, solved by deterministic bisection over a declared rate bracket with declared tolerance and iteration cap. Never Newton/derivative-based, so no float-drift nondeterminism. Reports whether the bracket contained a sign change and whether the search converged.",
      "input_schema_ref": "chaingraph/art-325-tvm-irr.html#manifest",
      "consumes": [],
      "feeds": [],
      "status": "live",
      "conformance_fixtures": true,
      "compute_capability": "server",
      "compute_images": [{"system":"sha256-source","image_id":"sha256:ce6c2877623d0c8092e2ec9a670ce48ce411824ec8006e77f813ecce62070b6d","valid_from":"2026-07-10"},{"system":"risc0","image_id":"sha256:a1a0bc89b5b1febaeda3519f6dbade0fa5ac16beeb143c4e1b01689573567bc6","valid_from":"2026-07-16"}],
      "export_capability": [
        "json"
      ],
      "compute_proof_ready": "ready",
      "compute_proof": {
        "type": "ZkVmReceipt",
        "system": "risc0",
        "receiptFormat": "groth16-bn254",
        "imageId": "sha256:a1a0bc89b5b1febaeda3519f6dbade0fa5ac16beeb143c4e1b01689573567bc6",
        "seal": "CGcHoi5fZLCAl+KPTf1IJKVPYKndsnldUImGfFza+FgwTeQlgESKYtO/bYcHT6AiLKywKTuHunRlAO5Sl3+elg9xtmq2nXoBbogUMt7JmtK1NFeHzolDY6RfyNevDitzIAT2rEukjw0keONAGyhAok3MOyNtbwvV3ULdu5CsiPYNsYDDfRpt+C5WYNNV9zP8LEvuGWp1BbQpLkRvf74Z4gxSlOMo3DgmAHIQkZspu+dZUoq9MqC46aS7RycMELpeK80FWomO9LSwbtK9ClOsE5khLk6D8Z3SaOk9NQ9w0zIHCwwppVecAIs7QnOnn1o5g0lmELcBUIkoE+Hi5PaXVg==",
        "journal": {
          "chaingraph_version": "0.4.0",
          "kernel_digest": "sha256:ce6c2877623d0c8092e2ec9a670ce48ce411824ec8006e77f813ecce62070b6d",
          "output": {
            "bracket_hi_pct": 1000,
            "bracket_lo_pct": -99.99,
            "converged": true,
            "irr_pct": 14.488844,
            "iterations": 34,
            "method": "bisection",
            "note": "IRR solved by deterministic bisection over the declared [bracket_lo, bracket_hi] rate bracket with declared tolerance and iteration cap — never Newton/derivative-based, so no float-drift nondeterminism. Requires a sign change in NPV(bracket_lo)..NPV(bracket_hi); widen the bracket if bracket_valid is false. Equal-period cash flows only (index 0..n-1); for irregular dated flows use XIRR.",
            "num_cash_flows": 5,
            "regulatory_basis": "Standard internal rate of return, textbook definition (root of NPV as a function of the discount rate)",
            "tolerance": 1e-09
          }
        }
      }
    }