Skip to content

fix(xdr): reject AssetCode12 JSON codes shorter than 5 bytes - #1585

Merged
Ryang-21 merged 1 commit into
v17-feature-branchfrom
fix/assetcode12-floor
Aug 4, 2026
Merged

fix(xdr): reject AssetCode12 JSON codes shorter than 5 bytes#1585
Ryang-21 merged 1 commit into
v17-feature-branchfrom
fix/assetcode12-floor

Conversation

@Ryang-21

@Ryang-21 Ryang-21 commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

What

xdr.AssetCode12.fromJson now rejects asset codes shorter than 5 bytes instead of zero-padding them into a valid alphanum12 value. Any JSON decode that reaches it gets the same guard, xdr.Asset.fromJson included.

The output side already had this rule. AssetCode12.toJson floors its trailing-zero trimming at 5 bytes precisely so alphanum12 output stays distinguishable from alphanum4 output, and the flattened AssetCode union override picks its arm back by code length on the way in. Without a matching floor on AssetCode12.fromJson, a 3-byte code like "USD" silently became an alphanum12 asset, which is a different asset on the wire than the alphanum4 "USD" a caller writing that JSON meant. Genuine round trips are unaffected: toJson emits "USD\0\0" for such a value, 5 bytes, which still decodes.

This is stricter than the Rust stellar-xdr reference, which accepts short codes. The divergence is deliberate — Stellar Core rejects alphanum12 codes under 5 characters, so no such asset can exist on-network, and accepting one only produces a value that cannot round-trip back to the JSON it came from.

No changelog entry: the JSON codec being corrected here has not shipped in a release yet.

A related pre-existing gap is filed separately as #1584Asset.fromOperation drops the alphanum12 discriminant for a short code, so a decoded asset re-encodes as alphanum4. That one lives in src/base/asset.ts and is out of scope here.

@github-project-automation github-project-automation Bot moved this to Backlog (Not Ready) in DevX Aug 3, 2026
@Ryang-21
Ryang-21 requested a review from Copilot August 3, 2026 22:07

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Aligns AssetCode12 JSON decoding with encoding rules by rejecting codes shorter than five bytes.

Changes:

  • Adds the five-byte minimum validation.
  • Tests direct and nested decoding plus valid alphanum12 preservation.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
src/xdr/values/to-json.ts Enforces the minimum decoded byte length.
test/unit/xdr/to_json.test.ts Covers invalid short codes and valid decoding.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@Ryang-21
Ryang-21 requested a review from quietbits August 3, 2026 22:10
@Ryang-21
Ryang-21 merged commit b7bf681 into v17-feature-branch Aug 4, 2026
20 of 21 checks passed
@Ryang-21
Ryang-21 deleted the fix/assetcode12-floor branch August 4, 2026 17:16
@github-project-automation github-project-automation Bot moved this from Backlog (Not Ready) to Done in DevX Aug 4, 2026
Ryang-21 added a commit that referenced this pull request Aug 10, 2026
* Class XDR Implementation (#1422)

* feat(xdr): codegen tool + schema source

* feat(xdr): add class-based XDR runtime and sep51 JSON walker

* refactor(numbers): drop LargeInt classes, delegate to new XDR layer

* refactor(base): migrate src/base to new XDR layer; drop legacy xdr.ts + generated

* refactor: migrate downstream consumers (bindings/contract/horizon/rpc/webauth)

* feat(base/scval): add bool to ScValType

* allow opaque xdr types to be initalized via string

* refactor xdr strings to be represented soley via bytes with a dx friendly XdrString wrapper class

* generate a value getter function for void union cases

* add a is() function to the generated XDR union classes for instanceOf checks

* feat(xdr): regenerate schemas against @stellar/js-xdr and add CAP-71 credentials

* feat(xdr): wire the toJSON hook so JSON.stringify emits SEP-0051

* fix(bindings): emit Uint8Array for bytes/bytesN to match scValToNative

* refactor(contract): rename fromJSON to fromJson with deprecated aliases

* feat(xdr): accept ASCII asset codes with zero padding in constructors

* Migrate public API from Buffer to Uint8Array (#1564)

* feat(base): migrate crypto and strkey APIs to Uint8Array

* feat(base)!: migrate value types to Uint8Array

* feat(base)!: migrate transactions, operations, and auth to Uint8Array

* feat!: migrate contract, rpc, and webauth layers to Uint8Array

* build!: drop buffer polyfill and dependency

* fix(horizon): type manage_data value as string to match runtime API

* fix(xdr): emit SEP-51 key `type` instead of Rust-escaped `type_` (#1571)

* build(xdr): regenerate xdr.json via docker from pinned stellar-xdr commit (#1575)

* build(xdr): regenerate schema from stellar-xdr with CAP-83 and CAP-85 ungated (#1576)

* build(xdr): regenerate schema from stellar-xdr with CAP-83 and CAP-85 ungated

* fix(xdr): keep consumers compiling against the regenerated union arms

* fix(vitest): isolate browser dep cache per transport

* feat(xdr): support CAP-83 empty tx set values and CAP-85 external executables (#1577)

* build(xdr): fail the schema download instead of masking it in a pipe

* feat(xdr): support CAP-83 and CAP-85 protocol values

* fix(xdr): bound decimal string length before BigInt parse in JSON decode (#1581)

* fix(xdr): bound decimal string length before BigInt parse in json decode

* refactor(xdr): name the digit-budget constants in bigint-parts

* fix(xdr): restrict fromJson to SEP-0051 keys and reject unknown fields (#1582)

* fix(xdr): restrict fromJson to SEP-51 keys and reject unknown fields

* fix(test): correct horizon corpus fixture path so corpus tests run

* fix(strkey): bound decodeCheck input length before base32 decode (#1583)

* fix(xdr): reject AssetCode12 JSON codes shorter than 5 bytes (#1585)

* fix(horizon)!: make TransactionFailedExtras result_codes.operations optional (#1586)

* Fix: signed payload strkey framing (#1588)

* fix(strkey): validate signed payload framing in decodeCheck

* Fix: xdr json decode validation (#1592)

* fix(xdr): throw on unknown union discriminant in fromXdrObject

* fix(strkey): validate the claimable balance discriminant byte

* fix(xdr): reject non-decimal integer strings in JSON decoding

* V17.0.0 rc.1 (#1593)

* chore(release): cut v17.0.0-rc.1

* fix(spec): restore instanceof Map check lost in the v17 merge

* feat(xdr): add validateXdr static to every generated type (#1597)

* feat(xdr): add validateXdr static to every generated type

* fix(contract): declare error classes, make types self-contained (#1627)

* perf(strkey): reject by length and prefix before decodeCheck throws (#1629)

* fix: restore wide-int bounds statics, document Memo.text break (#1628)

* fix(xdr): restore wide-int MIN_VALUE/MAX_VALUE statics

---------

Co-authored-by: Iveta <quietbits@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

3 participants