AIP 2: URI Format for ADAMANT Source

AuthorDmitriy Soloduhin
Discussions-Tohttps://github.com/Adamant-im/AIPs/issues/2
StatusDraft
TypeStandards
CategoryARC
Created2018-05-02

Simple Summary

A standard way of creating ADAMANT URIs for various use-cases.

Abstract

URIs embedded in QR-codes, hyperlinks in web-pages, emails or chat messages provide for robust cross-application signaling between very loosely coupled applications. A standardized URI format allows for instant invocation of the user’s preferred wallet application and simplifies usage.

Motivation

Help integrating ADAMANT into the World. Standartise QR-codes between different ADAMANT Messenger realizations.

Specification

Syntax

ADAMANT URIs contain “adm” in their schema (protocol) part and are constructed as follows:

request                 = "adm" ":" address [?parameters]
address                 = string
parameters              = (argument=value[&])*
argument                = uri encoded string
value                   = uri encoded string

Semantics

address is mandatory and starts with U letter. It should follow ADAMANT address format.

parameters is optional argument-value pairs and defines specific actions to be done with following address. Some specifications should follow in consecutive ARCs.

Commonly known parameters:

  • label is a contact name. Often used on business cards.

Examples

adm:U9821606738809290000?label=John+Doe

Rationale

This ARC is needed to ensure that all ADAMANT Messengers realizations support same URI format.

Copyright and related rights waived via CC0.