---
title: "Ledger Consensus Finality Classifier"
method: POST
path: "/v1/tools/classify_ledger_consensus_finality"
---

# Ledger Consensus Finality Classifier

`POST /v1/tools/classify_ledger_consensus_finality`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/classify_ledger_consensus_finality`
- Auth: none declared

Classifies a ledger-consensus position under a deadline-bounded-inclusion model (XRPL) or a federated-BFT model (Stellar SCP), each expressed as terminal outcome branches rather than a monotone tier ladder. Flags an overstated finality claim and a fee-consuming tec final failure, and names the unprovable-absence gap where validated history is not continuous. Zero PII. Client-side. Works offline.

**Tool URL:** https://ainumbers.co/chaingraph/art-527-classify-ledger-consensus-finality.html

## Request body

- object
  - `as_of_ts` unknown, required
  - `chain_label` unknown, required
  - `claimed_outcome` unknown, required
  - `claimed_tier` unknown, required
  - `continuous_history_ok` unknown, required
  - `externalized` unknown, required
  - `highest_validated_ledger` unknown, required
  - `included_in_ledger` unknown, required
  - `issuer_clawback_enabled` unknown, required
  - `last_ledger_sequence` unknown, required
  - `ledger_validated` unknown, required
  - `quorum_slice_trust_ok` unknown, required
  - `required_tier` unknown, required
  - `result_class` unknown, required
  - `settlement_model` unknown, required
  - `submitted_at_ledger` unknown, required
  - `time_bounds_max` unknown, required

## Response `200`

Successful tool execution result

- object: Derived from the kernel's golden conformance fixtures (chaingraph/kernels/fixtures/art-527-classify-ledger-consensus-finality.fixtures.json) per CONTRACT.md §2.7 truth maintenance.
  - `settlement_model` 'deadline_bounded_inclusion' | 'federated_bft'
  - `outcome` 'final_success' | 'final_failure_tec' | 'final_never_included' | 'expired_unprovable' | 'final' | 'pending'
  - `finality_tier` 'final_success' | 'final_failure_tec' | 'final_never_included' | 'expired_unprovable' | 'final' | 'pending'
  - `reorg_exposure` 'none'
  - `required_tier` string
  - `meets_required_tier` boolean
  - `claimed_tier` string, nullable
  - `claim_verdict` 'claim_supported' | 'claim_overstated' | 'no_claim'
  - `chain_label` string, nullable
  - `as_of_ts` integer
  - `draft_pinned` boolean
  - `rationale` string[]
  - `submitted_at_ledger` integer, nullable
  - `included_in_ledger` integer, nullable
  - `highest_validated_ledger` integer, nullable
  - `result_class` 'tes' | 'tec' | 'other' | 'null', nullable
  - `time_bounds_max` integer, nullable

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)