BlockAuth - Self Managed Ethereum Identities
The BlockAuth.org protocol provides a super simple way for you to manage your own digital identities.
The BCE Toolbox Wallet has support for registered names and profile URLs.
We provide the following useful wrapper functions through our wallet endpoint:
getUserByAddress
- returns a registered user object by their addressgetUserByUsername
- returns a registered user object by their usernamegetUserById
- returns a registered user object by their id
The chain
parameter is optional and used to select a valid network.
The contractAddress
options listed below can also be replaced by specific reserved keywords such as blockauth
- which will then help to use our internal records to find the most up-to-date contract address associated with that particular keyword.
This allows for more memorable options - &method=getUserByUsername¶ms=blockauth|msmalley
- as an example.
Required options should be set via GET params
and piped if using URLs - for example - ?params=option_one|option_two
More information on each of the available methods
can be seen below:
getUserByAddress
( contractAddress
, userAddress
)
Both a valid Ethereum contractAddress
and userAddress
are required.
An example URL request:
Data returned should look similar to this:
"results":
{
"address": "0xfcdb15204daa58575c477df7b46df4ffa431f61b",
"username": "msmalley",
"id": "007",
"name": "Mark Smalley",
"url": "http://smalley.my",
"blocked": false
}
getUserByUsername
( contractAddress
, username
)
Both a valid Ethereum contractAddress
and username
are required.
An example URL request:
Notice the example above uses the blockauth
keyword instead of a contract address...
Data returned should look similar to this:
"results":
{
"address": "0xfcdb15204daa58575c477df7b46df4ffa431f61b",
"username": "msmalley",
"id": "UKPP007",
"name": "Mark Smalley",
"url": "http://smalley.my",
"blocked": false
}
getUserById
( contractAddress
, id
)
Both a valid Ethereum contractAddress
and id
are required.
An example URL request:
Data returned should look similar to this:
"results":
{
"address": "0xfcdb15204daa58575c477df7b46df4ffa431f61b",
"username": "msmalley",
"id": "007",
"name": "Mark Smalley",
"url": "http://smalley.my",
"blocked": false
}