> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xdrcheck.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK conformance matrix

> Every pinned Go, JavaScript, Python and Rust SDK release against the corpus: agrees, diverges and not run per release, what a divergence means, and what the current releases still get wrong.

For SDK and XDR-library maintainers: how each pinned release of the Go, JavaScript, Python and Rust SDKs handles every corpus entry, and which entries the current release still gets wrong. After this page you can find your release's column, see what a divergence means for your users, and rerun any cell.

`xdrcheck conform` sends every corpus entry to a driver that runs one SDK at one pinned version (a **column**). The driver decodes the bytes, re-encodes them and reports the values it read; the runner compares them with the entry's expected values, which come from the bytes and never from an SDK. The public set has 21 columns; pull-request CI runs the 16 of the `pr` set (`drivers/sets.toml`).

## How to read a row

One cell per entry and column, folded over the entry's variants and conformance levels. A row of the tables below counts the cells of one column.

| Term | Meaning |
| - | - |
| **Agrees** | Every applicable variant and level gave the expected result: identical bytes after the round trip, the expected values, and the expected refusal where the entry must be refused |
| **Diverges** | The SDK gave a different result, and the entry declares that divergence for this SDK and version range. The run expects it: CI fails when a declared divergence stops reproducing, and when an undeclared one appears |
| **Not run** | No variant or level of the entry applies to the column (an API the SDK lacks, a type the release predates, a level the driver does not run). Not run is not a pass |
| **required** | The current release of each SDK family; the `required` set gates CI |
| **historical** | An earlier release kept as a regression pin, including the releases before a fix so the fix stays proven |
| **extra** | A release run in the public set only, or a reference column such as stellar-core |
| **In the PR set** | Whether pull-request CI runs this column |

A divergence on your release means one of these, depending on the entry: your decoder accepts bytes stellar-core would never emit, or refuses bytes it does emit; a round trip changes the bytes; or a value your users read (an address, an amount, an ID, a map order) differs from what the ledger holds. The entry's manifest names the [finding](https://docs.xdrcheck.dev/results/findings.md) that describes it. Not every divergence is a defect: a refusal that comes from a column's decode profile (the Rust `limits-default` limits) is declared with that profile and is the profile working as documented.

## Go (go-stellar-sdk)

| Column | Role | In the PR set | Agrees | Diverges | Not run |
| - | - | - | - | - | - |
| `go@v0.7.1` | historical | yes | 321 | 28 | 93 |
| `go@v0.7.2` | historical | yes | 340 | 9 | 93 |
| `go@v0.7.3` | historical | yes | 340 | 9 | 93 |
| `go@v0.8.0` | historical | yes | 421 | 6 | 15 |
| `go@v0.9.0` | required | yes | 421 | 6 | 15 |

## JavaScript (@stellar/stellar-sdk)

| Column | Role | In the PR set | Agrees | Diverges | Not run |
| - | - | - | - | - | - |
| `js@16.3.0` | extra | no | 317 | 41 | 84 |
| `js@16.3.1` | extra | no | 323 | 35 | 84 |
| `js@16.4.1` | extra | no | 394 | 33 | 15 |
| `js@17.2.0` | historical | yes | 330 | 28 | 84 |
| `js@17.2.1` | historical | yes | 339 | 19 | 84 |
| `js@17.3.0` | historical | yes | 432 | 6 | 4 |
| `js@17.4.0` | required | yes | 432 | 6 | 4 |

## Python (stellar-sdk)

| Column | Role | In the PR set | Agrees | Diverges | Not run |
| - | - | - | - | - | - |
| `python@17.0.0` | extra | no | 419 | 16 | 7 |
| `python@17.0.1` | extra | yes | 425 | 10 | 7 |

## Rust (stellar-xdr)

| Column | Role | In the PR set | Agrees | Diverges | Not run |
| - | - | - | - | - | - |
| `rust@28.0.0:limits-default` | historical | yes | 320 | 4 | 118 |
| `rust@28.0.0:limits-none` | historical | yes | 317 | 7 | 118 |
| `rust@28.0.1:limits-default` | historical | yes | 321 | 3 | 118 |
| `rust@28.0.1:limits-none` | historical | yes | 318 | 6 | 118 |
| `rust@30.0.0:limits-default` | required | yes | 401 | 1 | 40 |
| `rust@30.0.0:limits-none` | required | yes | 398 | 4 | 40 |

## stellar-core (reference column)

| Column | Role | In the PR set | Agrees | Diverges | Not run |
| - | - | - | - | - | - |
| `core@30.0.0` | extra | no | 346 | 0 | 96 |

## Divergences on the current releases

The entries where a `required` column diverges: what the current release of each SDK still gets wrong. Each link goes to the entry's row on [CAP coverage](https://docs.xdrcheck.dev/caps/overview.md). To see the cell yourself, run `xdrcheck conform run --columns 'COLUMN' --entries ENTRY` ([commands](https://docs.xdrcheck.dev/reference/cli.md)).

* `go@v0.9.0`: [`cap-0066/p22-restore-with-backfilled-restored-changes`](https://docs.xdrcheck.dev/caps/overview#cap-66), [`classic/real-result-codes.testnet-5380224`](https://docs.xdrcheck.dev/caps/overview#classic), [`strkey/api-encode-signed-payload-empty`](https://docs.xdrcheck.dev/caps/overview#strkey), [`strkey/sep-0023-v1.4.0-vectors.invalid-15`](https://docs.xdrcheck.dev/caps/overview#strkey), [`xdr-strict/api-transaction-parse-trailing-bytes.one-byte-in-final-quantum`](https://docs.xdrcheck.dev/caps/overview#xdr-strict), [`xdr-strict/api-transaction-parse-trailing-bytes.two-bytes-in-final-quantum`](https://docs.xdrcheck.dev/caps/overview#xdr-strict)
* `js@17.4.0`: [`cap-0021/precond-v2-min-seq-num-zero`](https://docs.xdrcheck.dev/caps/overview#cap-21), [`cap-0046/scval-error-budget-exceeded-limit`](https://docs.xdrcheck.dev/caps/overview#cap-46), [`cap-0046/scval-error-storage-exceeded-limit`](https://docs.xdrcheck.dev/caps/overview#cap-46), [`strkey/api-encode-signed-payload-65-bytes`](https://docs.xdrcheck.dev/caps/overview#strkey), [`strkey/api-encode-signed-payload-empty`](https://docs.xdrcheck.dev/caps/overview#strkey), [`xdr-strict/api-float-union-discriminant-custom-schema`](https://docs.xdrcheck.dev/caps/overview#xdr-strict)
* `rust@30.0.0:limits-default`: [`xdr-strict/bool-value-2`](https://docs.xdrcheck.dev/caps/overview#xdr-strict)
* `rust@30.0.0:limits-none`: [`xdr-strict/bool-value-2`](https://docs.xdrcheck.dev/caps/overview#xdr-strict), [`xdr-strict/length-prefix-exceeds-input.6h2`](https://docs.xdrcheck.dev/caps/overview#xdr-strict), [`xdr-strict/length-prefix-exceeds-input.6h3`](https://docs.xdrcheck.dev/caps/overview#xdr-strict), [`xdr-strict/length-prefix-exceeds-input.6h4`](https://docs.xdrcheck.dev/caps/overview#xdr-strict)

## Three js-stellar-sdk defects, before and after their fixes

`js@17.2.0`, `js@17.2.1` and `js@17.3.0` are the releases before the fixes of three js-stellar-sdk defects (pool asset and map-key order, colliding map keys, muxed and offer IDs). Each runs on the release before its fix, which shows the declared divergence, and on the next release, which agrees (`make verify-conformance OFFLINE=1`). The transcripts are in `evidence/js-1766/`, `evidence/js-1785/` and `evidence/js-1789/`; [Known incidents](https://docs.xdrcheck.dev/results/incidents.md) lists every public incident.

## Across SDK families

Whether a defect class first found in one SDK also reproduces in the others, with the versions, is on [Findings](https://docs.xdrcheck.dev/results/findings.md#across-sdk-families).

## Limits

* A cell is a result on the corpus only. An SDK that agrees on every entry can still mishandle a shape the corpus does not hold.
* The matrix is a snapshot of the pinned releases at corpus version `30.0.0-dev`; a newer release has no column until it is pinned in `pins.toml`.
* The Python SDK is a community SDK; its columns run in the same way as the others.

The data is `evidence/results/conformance-matrix.json` (`make results-conformance`); the rules are on [Conformance rules](https://docs.xdrcheck.dev/reference/driver-protocol.md#conformance-rules) and the design on [Conformance](https://docs.xdrcheck.dev/architecture/conformance.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.