Re: [jose] Canonical JSON form

Jim Schaad <> Fri, 12 October 2018 16:26 UTC

Return-Path: <>
Received: from localhost (localhost []) by (Postfix) with ESMTP id A9F9E130DE6 for <>; Fri, 12 Oct 2018 09:26:29 -0700 (PDT)
X-Virus-Scanned: amavisd-new at
X-Spam-Flag: NO
X-Spam-Score: -1.9
X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Received: from ([]) by localhost ( []) (amavisd-new, port 10024) with ESMTP id WCBbw5rM7UPP for <>; Fri, 12 Oct 2018 09:26:26 -0700 (PDT)
Received: from ( []) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by (Postfix) with ESMTPS id B923A130DEB for <>; Fri, 12 Oct 2018 09:26:25 -0700 (PDT)
Received: from Jude ( by ( with Microsoft SMTP Server (TLS) id 15.0.1347.2; Fri, 12 Oct 2018 09:21:39 -0700
From: Jim Schaad <>
To: 'Bret Jordan' <>, 'Anders Rundgren' <>
CC: 'Carsten Bormann' <>, "'Manger, James'" <>, 'Kathleen Moriarty' <>, <>, 'Phil Hunt' <>
References: <> <> <> <> <00ad01d460f4$69ae8a00$3d0b9e00$> <> <> <> <> <> <> <> <> <> <> <>
In-Reply-To: <>
Date: Fri, 12 Oct 2018 09:26:15 -0700
Message-ID: <017e01d46248$4e040280$ea0c0780$>
MIME-Version: 1.0
Content-Type: multipart/alternative; boundary="----=_NextPart_000_017F_01D4620D.A1A837C0"
X-Mailer: Microsoft Outlook 16.0
Thread-Index: AQNnP1/vuW81sZle9dbx86Tf75xU2AFuBXA/AqJ1qI4BeDi93AGy0bp+AoVGtcgBWQ3ouAHMBZ2PAgPtnXwBomSRnAJU7RiuARLhWd8DID9IqAHgTXhlAXrBW+MCTiSuwKEQJWTA
Content-Language: en-us
X-Originating-IP: []
Archived-At: <>
Subject: Re: [jose] Canonical JSON form
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Javascript Object Signing and Encryption <>
List-Unsubscribe: <>, <>
List-Archive: <>
List-Post: <>
List-Help: <>
List-Subscribe: <>, <>
X-List-Received-Date: Fri, 12 Oct 2018 16:26:30 -0000



From: jose <> On Behalf Of Bret Jordan
Sent: Friday, October 12, 2018 8:20 AM
To: Anders Rundgren <>
Cc: Carsten Bormann <>rg>; Manger, James <>om>; Kathleen Moriarty <>om>;; Phil Hunt <>
Subject: Re: [jose] Canonical JSON form


Please correct me if I am wrong…. The way I understand the problem is as follows:



1) If you verified the JSON string at consumption time, before it has been unmarshal-ed, then all you need to do is decide how to handle white space and carriage returns.  You could basically regex remove all white space and CR / CRLF and have a workable solution.


[JLS] Which is what JOSE does – passes the string in a form that will not be unmarshal-ed.


2) Where this breaks down is, when a tool unmarshals the data into a map or struct, then you have no guarantee that you would recreate the keys in the same order (a struct may force it to the order of the struct definition). So you have no way of being able to verify the hash after it has been unmarshal-ed.  Further, if you recreate the JSON and send it back out, the next person that gets the data might have a hash that can not be verified in option 1 above.


3) Another problem once you have unmarshal-ed the data is what do you do with JSON numbers.  Some programming languages store them as a float, some as who-knows-what.  So you would need a way to ensure that the number was always stored in the same way, especially for strongly typed systems (is this architecture dependent too?). So the options here are, if the ontology / semantics of the JSON data were well defined in schema (a meaning it was standardized and documented), then the code could know what it should do and interoperability tests could be made to ensure that it worked.


[JLS]  The issue is not so much what the format that the number is stored internally in, the problem is how is the number serialized out. Some have dealt with this problem by storing the string version of the number along side the numeric version.  Not what I consider to be an acceptable solution but it may be the only one that works.


What am I not understanding here?  And what am I missing?





PGP Fingerprint: 63B4 FC53 680A 6B7D 1447  F2C0 74F8 ACAE 7415 0050

"Without cryptography vihv vivc ce xhrnrw, however, the only thing that can not be unscrambled is an egg."

On Oct 12, 2018, at 12:38 AM, Anders Rundgren < <> > wrote:


On 2018-10-11 22:05, Bret Jordan wrote:

I really like what you have done with this.  I am trying to figure out if it will work 100% for my needs, or if it will need some tweaking.  If it does work, then I think we should really try and figure out how we get your work standardized.

Thanx Bret!

The I-D provides quite a lot of features including an extension option that can be used for adding possibly missing functionality.

There is one thing that is good to know for anyone thinking about standardizing Canonical JSON and that's the fact that canonicalization also can be performed on the text level as described by:

This has the advantage that it is very simple and supports the entire JSON RFC without restrictions.

So why didn't I took this [superficially obvious] route? There are several reasons for that:

A downside of source level canonicalization is that it doesn't integrate with JSON parsers and serializers. was explicitly designed to eventually be an option of a standard JSON serializer as it already is in my Java reference implementation.

Another issue is that it is unclear what the value is with using the JSON "Number" format outside of the IEEE range.  In fact, it excludes parsers like JavaScript's JSON.parse() unless JavaScaript would be updated to always use a "BigNumber" as fundamental numeric type.