Reporting Credit Outcomes

Reporting outcomes is a powerful way to contribute to the Localcredit ecosystem while improving the accuracy of the shared scoring model. When lenders report anonymized results (repaid, default, partial), the system learns which signals best predict reliability – making scores more predictive for everyone.

Why Report Outcomes?

• Improve the Model: Your data helps refine weights and pattern detection, reducing defaults across the network.

• Build Trust: Transparent reporting demonstrates your commitment to fair lending.

• Potential Benefits: Accurate reporters may receive boosted visibility in the Opportunities feed or governance perks (DAO-decided).

• Fully Anonymized: Borrower identity is never revealed – only aggregated, proof-backed outcomes are used.

How Reporting Works

1. After a loan completes (or reaches a milestone), submit the result via the API.

2. The report is validated and linked to the borrower’s abstract identity via ZK proof.

3. Data is used in periodic model retraining (federated, privacy-preserving).

REST API ReportingUse the /reportOutcome endpoint.Request Examplejson

{
  "loanHash": "0xabc123...",           // Unique identifier for the loan
  "outcome": "repaid",                 // "repaid" | "default" | "partial"
  "amountUsd": 2500,                   // Original loan amount in USD equivalent
  "timestamp": 1736100000,             // Unix timestamp of outcome
  "details": {                         // Optional enriched data
    "daysLate": 0,
    "recoveredAmountUsd": 2500,
    "partialRecoveryPercent": 100
  }
}

JavaScript/TypeScript SDK Exampletypescript

import { Localcredit } from '@localcredit/sdk-js';

const lc = new Localcredit({ apiKey: 'your_key' });

await lc.reportOutcome({
  loanHash: '0xabc123...',
  outcome: 'repaid',           // or 'default' / 'partial'
  amountUsd: 2500,
  timestamp: Date.now(),
  details: {
    daysLate: 0,
    recoveredAmountUsd: 2500
  }
});

On-Chain Reporting (Advanced)For fully decentralized protocols, report directly via the oracle contract (callback pattern similar to score queries).

Solidity Example

function reportLoanOutcome(
    bytes32 loanHash,
    uint8 outcome,      // 0 = repaid, 1 = partial, 2 = default
    uint256 amountUsd,
    uint256 timestamp
) external {
    // Optional: require only authorized lender
    localcreditOracle.reportOutcome(loanHash, outcome, amountUsd, timestamp);
}

Best Practices

• Report as soon as the outcome is final (full repayment, charge-off, etc.).

• Use consistent loanHash format across your system for easier tracking.

• Include details when available – richer data improves model learning.

• Never include borrower PII – the API will reject any personal data.

{
  "success": true,
  "reportId": "rep_abc123",
  "message": "Outcome recorded anonymously"
}

Reported data is aggregated and used only for model improvement. Individual reports are never exposed to other parties.Thank you for reporting – every accurate outcome makes Localcredit smarter and the entire ecosystem safer for lenders and borrowers alike.