draft-multiformats-multibase-01

draft-multiformats-multibase-01
Network Working Group J. Benet
Internet-Draft Protocol Labs
Intended status: Standards Track M. Sporny
Expires: July 4, 2019 Digital Bazaar
December 31, 2018
The Multibase Data Format
draft-multiformats-multibase-01
Abstract

Raw binary data is often encoded using a mechanism that enables the
data to be included in human-readable text-based formats. This
mechanism is often referred to as "base-encoding the data". Base-
encoding is often used when expressing binary data in hyperlinks,
cryptographic keys in web pages, or security tokens in application
software. There are a variety of base-encodings, such as base32,
base58, and base64. It is not always possible to differentiate one
base-encoding from another. The purpose of this specification is to
provide a mechanism to be able to deterministically identify the
base-encoding for a particular string of data.

Feedback

This specification is a joint work product of Protocol Labs [
], the
W3C Digital Verification Community Group [
], and the W3C Credentials
Community Group [
]. Feedback related to this specification should
logged in the issue tracker [
] or be sent to public-
credentials@w3.org [
]. .

Status of This Memo

This Internet-Draft is submitted in full conformance with the
provisions of
BCP 78
and
BCP 79

Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet-
Drafts is at

Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."

This Internet-Draft will expire on July 4, 2019.
Benet & Sporny Expires July 4, 2019 [Page 1]
Internet-Draft The Multibase Data Format December 2018
Copyright Notice

This document is subject to
BCP 78
and the IETF Trust's Legal
Provisions Relating to IETF Documents
) in effect on the date of
publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect
to this document.

Table of Contents
. Introduction . . . . . . . . . . . . . . . . . . . . . . . .
. The Multibase Format . . . . . . . . . . . . . . . . . . . .
2.1
. A Multibase Example . . . . . . . . . . . . . . . . . . .
. References . . . . . . . . . . . . . . . . . . . . . . . . .
3.1
. Normative References . . . . . . . . . . . . . . . . . .
3.2
. URIs . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix A
. Security Considerations . . . . . . . . . . . . . .
Appendix B
. Test Values . . . . . . . . . . . . . . . . . . . .
B.1
. Hexadecimal upper-case encoding . . . . . . . . . . . . .
B.2
. Base-32 upper-case encoding, no padding . . . . . . . . .
B.3
. Base-58 Bitcoin encoding . . . . . . . . . . . . . . . .
B.4
. Base-64 with padding and MIME-encoding . . . . . . . . .
Appendix C
. Acknowledgements . . . . . . . . . . . . . . . . . .
Appendix D
. IANA Considerations . . . . . . . . . . . . . . . .
D.1
. The Multibase Algorithms Registry . . . . . . . . . . . .
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . .
. Introduction
This specification describes a forward-compatible data model for
expressing raw binary data in a variety of base-encoding formats such
as base32, base58. and base64.

When text is encoded as bytes, we can usually use a one-size-fits-all
encoding (UTF-8) because we're always encoding to the same set of 256
bytes. When that doesn't work, usually for historical or performance
reasons, we can usually infer the encoding from the context.

However, when bytes are encoded as text (using a base encoding), the
choice of base encoding is often restricted by the context. Worse,
these restrictions can change based on where the data appears in the
text. In some cases, we can only use [a-z0-9]. In others, we can
use a larger set of characters but need a compact encoding. This has
lead to a large set of "base encodings", one for every use-case.
Benet & Sporny Expires July 4, 2019 [Page 2]
Internet-Draft The Multibase Data Format December 2018
Unlike when encoding text to bytes, we can't just standardize around
a single base encoding because there is no optimal encoding for all
cases.

Unfortunately, it's not always clear what base encoding is used;
that's where this specification comes in. It answers the question:

Given data 'd' encoded into text 's', what base is it encoded with?
. The Multibase Format
A multibase-encoded value follows a simple format:

base-encoding-character base-encoded-data

The encoding algorithm is a single character value that is always the
first byte of the data. The possible values for this field are
provided in The Multibase Algorithm Registry [
].
2.1
. A Multibase Example
The following is an encoding of "Hello World!" using the version of
base-58 that utilizes the Bitcoin encoding character set:

z2NEpo7TZRRrLZSi2U

The first byte (z) specifies the multibase encoding algorithm. The
rest of the data specifies the value of the output of the multibase
encoding algorithm.
. References
3.1
. Normative References
RFC2119
] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels",
BCP 14
RFC 2119
DOI 10.17487/RFC2119, March 1997,
>.

RFC4648
] Josefsson, S., "The Base16, Base32, and Base64 Data
Encodings",
RFC 4648
, DOI 10.17487/RFC4648, October 2006,
>.
3.2
. URIs
Benet & Sporny Expires July 4, 2019 [Page 3]
Internet-Draft The Multibase Data Format December 2018
] mailto:public-credentials@w3.org

] #mb-registry

multibase.csv
Appendix A
. Security Considerations
There are a number of security considerations to take into account
when implementing or utilizing this specification. TBD
Appendix B
. Test Values
The multibase examples are chosen to show different encoding
algorithms and different output lengths at play. The input test data
for all of the examples in this section is:

Table 1: Multihash Algorithms Registry
Benet & Sporny Expires July 4, 2019 [Page 6]
Internet-Draft The Multibase Data Format December 2018
NOTE: The most up to date place for developers to find the table
above is
multibase.csv
].

Authors' Addresses

Juan Benet
Protocol Labs
548 Market Street, #51207
San Francisco, CA 94104
US

Phone: +1 619 957 7606
Email: juan@protocol.ai
URI:
Manu Sporny
Digital Bazaar
203 Roanoke Street W.
Blacksburg, VA 24060
US

Phone: +1 540 961 4469
Email: msporny@digitalbazaar.com
URI:
Benet & Sporny Expires July 4, 2019 [Page 7]
Datatracker
draft-multiformats-multibase-01
This is an older version of an Internet-Draft whose latest revision state is "Expired".
Document
Document type
This is an older version of an Internet-Draft whose latest revision state is "Expired".
Expired & archived
This document is an Internet-Draft (I-D).
Anyone may submit an I-D to the IETF.
This I-D is
not endorsed by the IETF
and has
no formal standing
in the
IETF standards process
Select version
00
01
02
03
04
05
06
07
08
Compare versions
Authors
Juan Benet
Manu Sporny
RFC stream
(None)
Other formats
txt
xml
bibtex
bibxml
Report a datatracker bug
Show sidebar by default
Yes
No
Tab to show by default
Info
Contents
HTMLization configuration
HTMLize the plaintext
Plaintextify the HTML
Maximum font size
Page dependencies
Inline
Reference
Citation links
Go to reference section
Go to linked document