API Documentation | BlockAuth RAW Website

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 address
  • getUserByUsername - returns a registered user object by their username
  • getUserById - 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&params=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:

http://bce.asia/api/cortex/v1/blockauth?method=getUserByAddress&key=your-api-key&chain=bce&params=0xc4Acc3EfDaA0Ff0820022418c3DfAf1471494E29|0xf88d2b4319c10197499f3f9b35f6008f0631dac6

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:

http://bce.asia/api/cortex/v1/blockauth?method=getUserByUsername&key=your-api-key&chain=bce&params=blockauth|msmalley

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:

http://bce.asia/api/cortex/v1/blockauth?method=getUserById&key=your-api-key&chain=bce&params=0xc4Acc3EfDaA0Ff0820022418c3DfAf1471494E29|UKPP007

Data returned should look similar to this:

"results":
{
    "address": "0xfcdb15204daa58575c477df7b46df4ffa431f61b",
    "username": "msmalley",
    "id": "007",
    "name": "Mark Smalley",
    "url": "http://smalley.my",
    "blocked": false
}

Table of Contents

join our mission to take the cryptic out of crypto

 

GET UPDATES CONTACT TEAM