How to create identity?

Create Identity under your own namespace

Process of creating an identity

Arrange Identity

Arrange identity in the format

{
  "id": "string",
  "identifier": "string",
  "provider": "string",
  "default": {
    "address": "address",
    "chain": number,
    "isMultisig": boolean,
    "isSmartContractWallet": boolean
  },
  "secondary": [
    {
      "address": "address",
      "chain": number,
      "isMultisig": boolean,
      "isSmartContractWallet": boolean
    },
    {
      "address": "address",
      "chain": number,
      "isMultisig": boolean,
      "isSmartContractWallet": boolean
    }
  ]
}

Generate Message

Using the above arranged identity, generate a message using the below endpoint and sign it using default address by following guide for respective chains

Generate Message

POSThttps://sandbox-api.fetcch.xyz/v1/identity/generate-message

Body

application/json

id*string

identifier*string

provider*string

default*DefaultAddress (object)

secondaryarray of SecondaryAddress (object)

currentSignaturestring

previousSignaturestring

Response

200400401

Body

application/json

dataGenerateMessage (object)

statusinteger

timestampstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://sandbox-api.fetcch.xyz/v1/identity/generate-message', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "id": "text",
      "identifier": "text",
      "provider": "text",
      "default": {}
    }),
});
const data = await response.json();

Response

200400401

{
  "data": {
    "message": "text",
    "identity": {
      "id": "text",
      "identifier": "text",
      "providerId": "text",
      "provider": {
        "id": "text",
        "logo": "text",
        "apiKey": "text",
        "delimiter": "text",
        "txHash": "text",
        "registry": [
          {
            "address": "text",
            "chainType": "EVM",
            "txHash": "text",
            "providerId": "text"
          }
        ],
        "dataSourceId": 0,
        "ownerId": "text",
        "updatedAt": "2024-12-21T14:33:53.332Z",
        "createdAt": "2024-12-21T14:33:53.332Z"
      },
      "defaultAddress": "text",
      "default": {
        "address": "text",
        "chain": {
          "id": 0,
          "name": "text",
          "symbol": "text",
          "icon": "text",
          "rpc": [
            "text"
          ],
          "type": "EVM",
          "shortName": "text",
          "infoURL": "text",
          "chainId": 0,
          "updatedAt": "2024-12-21T14:33:53.332Z",
          "createdAt": "2024-12-21T14:33:53.332Z"
        },
        "chainId": 0,
        "isMultisig": false,
        "isSmartContractWallet": false,
        "walletId": {
          "id": 0,
          "name": "text",
          "symbol": "text",
          "icon": "text",
          "rpc": [
            "text"
          ],
          "type": "EVM",
          "shortName": "text",
          "infoURL": "text",
          "chainId": 0,
          "updatedAt": "2024-12-21T14:33:53.332Z",
          "createdAt": "2024-12-21T14:33:53.332Z"
        },
        "updatedAt": "2024-12-21T14:33:53.332Z",
        "createdAt": "2024-12-21T14:33:53.332Z"
      },
      "secondary": [
        {
          "id": "text",
          "address": "text",
          "isMultisig": false,
          "isSmartContractWallet": false,
          "chainId": 0,
          "chain": {
            "id": 0,
            "name": "text",
            "symbol": "text",
            "icon": "text",
            "rpc": [
              "text"
            ],
            "type": "EVM",
            "shortName": "text",
            "infoURL": "text",
            "chainId": 0,
            "updatedAt": "2024-12-21T14:33:53.332Z",
            "createdAt": "2024-12-21T14:33:53.332Z"
          },
          "walletId": "text",
          "updatedAt": "2024-12-21T14:33:53.332Z",
          "createdAt": "2024-12-21T14:33:53.332Z"
        }
      ],
      "nonce": 0,
      "currentSignature": "text",
      "previousSignature": "text",
      "isContract": false,
      "syncedAt": "2024-12-21T14:33:53.332Z",
      "createdAt": "2024-12-21T14:33:53.332Z"
    },
    "nonce": 0
  },
  "status": 0,
  "timestamp": "2024-12-21T14:33:53.332Z"
}

After generating message, you need to sign message using appropriate functions for respective chains, check our guide for each blockchain here

Create Identity

After signing the message, add the generated signature in the arranged identity, at currentSignature

Now, data should look something like this

{
  "id": "string",
  "identifier": "string",
  "provider": "string",
  "default": {
    "address": "address",
    "chain": number,
    "isMultisig": boolean,
    "isSmartContractWallet": boolean
  },
  "secondary": [
    {
      "address": "address",
      "chain": number,
      "isMultisig": boolean,
      "isSmartContractWallet": boolean
    },
    {
      "address": "address",
      "chain": number,
      "isMultisig": boolean,
      "isSmartContractWallet": boolean
    }
  ],
  "currentSignature": "string"
}

Call Create Identity API

Important Note

If default chain is APTOS, then while calling this API, swap default address with public key of the same address, so that we can easily verify signatures

Create Identity

POSThttps://sandbox-api.fetcch.xyz/v1/identity

Body

application/json

id*string

identifier*string

provider*string

default*DefaultAddress (object)

secondaryarray of SecondaryAddress (object)

currentSignaturestring

previousSignaturestring

Response

200400401

Headers

Body

application/json

id*string

identifier*string

providerId*string

providerProvider (object)

defaultAddress*string

defaultDefaultAddress (object)

secondaryarray of OtherAddress (object)

nonceinteger

currentSignature*string

previousSignaturestring

isContractboolean

syncedAt*string (date-time)

createdAtstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://sandbox-api.fetcch.xyz/v1/identity', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "id": "text",
      "identifier": "text",
      "provider": "text",
      "default": {}
    }),
});
const data = await response.json();

Response

200400401

{
  "id": "text",
  "identifier": "text",
  "providerId": "text",
  "provider": {
    "id": "text",
    "logo": "text",
    "apiKey": "text",
    "delimiter": "text",
    "txHash": "text",
    "registry": [
      {
        "address": "text",
        "chainType": "EVM",
        "txHash": "text",
        "providerId": "text"
      }
    ],
    "dataSourceId": 0,
    "ownerId": "text",
    "updatedAt": "2024-12-21T14:33:53.332Z",
    "createdAt": "2024-12-21T14:33:53.332Z"
  },
  "defaultAddress": "text",
  "default": {
    "address": "text",
    "chain": {
      "id": 0,
      "name": "text",
      "symbol": "text",
      "icon": "text",
      "rpc": [
        "text"
      ],
      "type": "EVM",
      "shortName": "text",
      "infoURL": "text",
      "chainId": 0,
      "updatedAt": "2024-12-21T14:33:53.332Z",
      "createdAt": "2024-12-21T14:33:53.332Z"
    },
    "chainId": 0,
    "isMultisig": false,
    "isSmartContractWallet": false,
    "walletId": {
      "id": 0,
      "name": "text",
      "symbol": "text",
      "icon": "text",
      "rpc": [
        "text"
      ],
      "type": "EVM",
      "shortName": "text",
      "infoURL": "text",
      "chainId": 0,
      "updatedAt": "2024-12-21T14:33:53.332Z",
      "createdAt": "2024-12-21T14:33:53.332Z"
    },
    "updatedAt": "2024-12-21T14:33:53.332Z",
    "createdAt": "2024-12-21T14:33:53.332Z"
  },
  "secondary": [
    {
      "id": "text",
      "address": "text",
      "isMultisig": false,
      "isSmartContractWallet": false,
      "chainId": 0,
      "chain": {
        "id": 0,
        "name": "text",
        "symbol": "text",
        "icon": "text",
        "rpc": [
          "text"
        ],
        "type": "EVM",
        "shortName": "text",
        "infoURL": "text",
        "chainId": 0,
        "updatedAt": "2024-12-21T14:33:53.332Z",
        "createdAt": "2024-12-21T14:33:53.332Z"
      },
      "walletId": "text",
      "updatedAt": "2024-12-21T14:33:53.332Z",
      "createdAt": "2024-12-21T14:33:53.332Z"
    }
  ],
  "nonce": 0,
  "currentSignature": "text",
  "previousSignature": "text",
  "isContract": false,
  "syncedAt": "2024-12-21T14:33:53.332Z",
  "createdAt": "2024-12-21T14:33:53.332Z"
}

Identity should now be created, if faced with any error, check our troubleshooting guide or ask in our discord

Resolve Identity

Get Identity

GEThttps://sandbox-api.fetcch.xyz/v1/identity

Query parameters

Response

200400401

Body

application/json

dataIdentity (object)

statusinteger

timestampstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://sandbox-api.fetcch.xyz/v1/identity', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400401

{
  "data": {
    "id": "text",
    "identifier": "text",
    "providerId": "text",
    "provider": {
      "id": "text",
      "logo": "text",
      "apiKey": "text",
      "delimiter": "text",
      "txHash": "text",
      "registry": [
        {
          "address": "text",
          "chainType": "EVM",
          "txHash": "text",
          "providerId": "text"
        }
      ],
      "dataSourceId": 0,
      "ownerId": "text",
      "updatedAt": "2024-12-21T14:33:53.332Z",
      "createdAt": "2024-12-21T14:33:53.332Z"
    },
    "defaultAddress": "text",
    "default": {
      "address": "text",
      "chain": {
        "id": 0,
        "name": "text",
        "symbol": "text",
        "icon": "text",
        "rpc": [
          "text"
        ],
        "type": "EVM",
        "shortName": "text",
        "infoURL": "text",
        "chainId": 0,
        "updatedAt": "2024-12-21T14:33:53.332Z",
        "createdAt": "2024-12-21T14:33:53.332Z"
      },
      "chainId": 0,
      "isMultisig": false,
      "isSmartContractWallet": false,
      "walletId": {
        "id": 0,
        "name": "text",
        "symbol": "text",
        "icon": "text",
        "rpc": [
          "text"
        ],
        "type": "EVM",
        "shortName": "text",
        "infoURL": "text",
        "chainId": 0,
        "updatedAt": "2024-12-21T14:33:53.332Z",
        "createdAt": "2024-12-21T14:33:53.332Z"
      },
      "updatedAt": "2024-12-21T14:33:53.332Z",
      "createdAt": "2024-12-21T14:33:53.332Z"
    },
    "secondary": [
      {
        "id": "text",
        "address": "text",
        "isMultisig": false,
        "isSmartContractWallet": false,
        "chainId": 0,
        "chain": {
          "id": 0,
          "name": "text",
          "symbol": "text",
          "icon": "text",
          "rpc": [
            "text"
          ],
          "type": "EVM",
          "shortName": "text",
          "infoURL": "text",
          "chainId": 0,
          "updatedAt": "2024-12-21T14:33:53.332Z",
          "createdAt": "2024-12-21T14:33:53.332Z"
        },
        "walletId": "text",
        "updatedAt": "2024-12-21T14:33:53.332Z",
        "createdAt": "2024-12-21T14:33:53.332Z"
      }
    ],
    "nonce": 0,
    "currentSignature": "text",
    "previousSignature": "text",
    "isContract": false,
    "syncedAt": "2024-12-21T14:33:53.332Z",
    "createdAt": "2024-12-21T14:33:53.332Z"
  },
  "status": 0,
  "timestamp": "2024-12-21T14:33:53.332Z"
}