diff --git a/EIPS/eip-1328.md b/EIPS/eip-1328.md new file mode 100644 index 0000000000000..90fb6d21a5c0d --- /dev/null +++ b/EIPS/eip-1328.md @@ -0,0 +1,49 @@ +--- +eip: 1328 +title: WalletConnect Standard URI Format +authors: ligi , Pedro Gomes +type: Standards Track +category: ERC +status: Draft +created: 2018-08-15 +discussions-to: https://ethereum-magicians.org/t/wallet-connect-eip/850 +requires: 831 +--- + +## Simple Summary + +A standard to create WalletConnect URIs for establishing connections between wallets and applications. + +## 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 + +Function call URIs follow the ERC-831 URI format, with the following parameters: + + request = "ethereum" ":" [ "wc-" ]sessionID [ "@" version ][ "?" parameters ] + sessionID = STRING + version = 1*DIGIT + parameters = parameter *( "&" parameter ) + parameter = key "=" value + key = "name" / "bridge" / "symKey" + value = NUMBER / STRING + +### Semantics + +Required parameters are dependent on the WalletConnect standard version which currently is specified to only include mobile-to-desktop connection sessions which only require `name` which describes the dapp name, `bridge` which includes the bridge URL, `symKey` which includes the symmetric key in base64. + +## Rationale + +The need for this ERC stems from the discussion to move away from JSON format used in current beta version of the WalletConnect standard 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 for other compatible EIPs using the ERC-831 URI format for Ethereum. Also by using a URI instead of a JSON inside the QR-Code the Android Intent system can be leveraged. + +## References + +1. ERC-831, http://eips.ethereum.org/EIPS/eip-831 + +## Copyright + +Copyright and related rights waived via [CC0](https://creativecommons.org/publicdomain/zero/1.0/).