mirror of https://github.com/status-im/EIPs.git
55 lines
1.9 KiB
Markdown
55 lines
1.9 KiB
Markdown
---
|
|
eip: 1328
|
|
title: WalletConnect Standard URI Format
|
|
author: ligi <ligi@ligi.de>, Pedro Gomes <pedrouid@protonmail.com>
|
|
type: Standards Track
|
|
category: ERC
|
|
status: Draft
|
|
created: 2018-08-15
|
|
discussions-to: https://ethereum-magicians.org/t/wallet-connect-eip/850
|
|
---
|
|
|
|
## Simple Summary
|
|
|
|
A standard to create WalletConnect URIs to initiate connections between applications and wallets.
|
|
|
|
## Abstract
|
|
|
|
This standard defines how the data to connect some application and a wallet can be encoded with a URI. This URI can then be shown either as a QR code or for mobile to mobile as a link.
|
|
|
|
## Specification
|
|
|
|
### Syntax
|
|
|
|
WalletConnect request URI with the following parameters:
|
|
|
|
request = "wc" ":" topic [ "@" version ][ "?" parameters ]
|
|
topic = STRING
|
|
version = 1*DIGIT
|
|
parameters = parameter *( "&" parameter )
|
|
parameter = key "=" value
|
|
key = "bridge" / "key"
|
|
value = STRING
|
|
|
|
### Semantics
|
|
|
|
Required parameters are dependent on the Walletconnect protocol version which currently includes the `key`, hex string of symmetric key, and `bridge`, encoded url of the bridge used for establishing the connection.
|
|
|
|
### Example
|
|
|
|
```
|
|
wc:8a5e5bdc-a0e4-4702-ba63-8f1a5655744f@1?bridge=https%3A%2F%2Fbridge.walletconnect.org&key=41791102999c339c844880b23950704cc43aa840f3739e365323cda4dfa89e7a
|
|
```
|
|
|
|
## Rationale
|
|
|
|
The need for this ERC stems from the discussion to move away from JSON format used in the alpha version of the WalletConnect protocol which makes for very inneficient parsing of the intent of the QR code, making it easier to create better QR code parsers APIs for Wallets to implement. Also by using a URI instead of a JSON inside the QR-Code the Android Intent system can be leveraged.
|
|
|
|
## References
|
|
|
|
1. WalletConnect Technical Specification, https://docs.walletconnect.org/tech-spec
|
|
|
|
## Copyright
|
|
|
|
Copyright and related rights waived via [CC0](https://creativecommons.org/publicdomain/zero/1.0/).
|