Skip to main content

QWED Finance GitHub Action

QWED Finance v2.0 includes a production-ready GitHub Action to verify financial logic in your CI/CD pipeline.

Usage

Basic Verification

jobs:
  verify:
    runs-on: ubuntu-latest
    steps:
      - name: Verify IRR Calculation
        uses: QWED-AI/qwed-finance@v2
        with:
          action: verify
          verification_type: irr
          cashflows: "-1000, 300, 400, 500, 600"
          llm_output: "24.89%"

SARIF Scanning (Security Dashboard)

QWED automatically outputs SARIF reports that integrate with GitHub Advanced Security.
jobs:
  scan:
    runs-on: ubuntu-latest
    permissions:
      security-events: write
    steps:
      - name: Scan Financial Models
        uses: QWED-AI/qwed-finance@v2
        with:
          action: scan
          scan_target: ./models
          scan_type: npv
      
      - name: Upload SARIF
        uses: github/codeql-action/upload-sarif@v2
        with:
          sarif_file: qwed-results.sarif

Inputs

InputDescriptionRequiredDefault
actionMode: verify (single check) or scan (audit files)Noverify
verification_typenpv, irr, ytm, sharpeYes (for verify)-
llm_outputThe value claimed by the LLM (e.g., “15.4%“)Yes (for verify)-
scan_targetDirectory to scan for logic filesYes (for scan)-

Supported Verification Types

TypeParams (Env Vars)Description
npvINPUT_CASHFLOWS, INPUT_RATENet Present Value
irrINPUT_CASHFLOWSInternal Rate of Return
ytmINPUT_FACE_VALUE, INPUT_COUPON_RATE, INPUT_PRICE, INPUT_YEARSYield to Maturity
sharpeINPUT_RETURN, INPUT_RISK_FREE, INPUT_VOLATILITYSharpe Ratio
:::info Zero-Config SARIF When running in scan mode, the action automatically generates qwed-results.sarif. No extra configuration needed. ::: Use these actions to expand verification coverage across other QWED extensions.
IconExtension actionWhen to use it
⚖️QWED Legal VerificationYou validate contracts, policy text, or legal citations in CI.
🧾QWED Protocol VerificationYou enforce protocol rules and deterministic behavior checks.
🛒QWED Commerce AuditorYou audit checkout and transaction logs for commerce workflows.
For finance-specific checks, use QWED Finance Guard.