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

post

Authorizations

Body

idstringrequired

identifierstringrequired

providerstringrequired

defaultobjectrequired

secondaryobject[]optional

currentSignaturestringoptional

previousSignaturestringoptional

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://sandbox-api.fetcch.xyz/v1/identity/generate-message' \
  --header 'secret-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "text",
    "identifier": "text",
    "provider": "text",
    "default": {
      "address": "text",
      "chain": 1,
      "isSmartContractWallet": true,
      "isMultisig": true
    },
    "secondary": [
      {
        "address": "text",
        "chain": 1,
        "isSmartContractWallet": true,
        "isMultisig": true
      }
    ],
    "currentSignature": "text",
    "previousSignature": "text"
  }'

application/json

200

400

401

200

{
  "data": {
    "message": "ds"
  },
  "status": 200,
  "timestamp": ""
}

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

post

Authorizations

Body

idstringrequired

identifierstringrequired

providerstringrequired

defaultobjectrequired

secondaryobject[]optional

currentSignaturestringoptional

previousSignaturestringoptional

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://sandbox-api.fetcch.xyz/v1/identity' \
  --header 'secret-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "text",
    "identifier": "text",
    "provider": "text",
    "default": {
      "address": "text",
      "chain": 1,
      "isSmartContractWallet": true,
      "isMultisig": true
    },
    "secondary": [
      {
        "address": "text",
        "chain": 1,
        "isSmartContractWallet": true,
        "isMultisig": true
      }
    ],
    "currentSignature": "text",
    "previousSignature": "text"
  }'

application/json

200

400

401

200

{
  "id": "text",
  "identifier": "text",
  "providerId": "text",
  "provider": {
    "id": "text",
    "logo": "text",
    "apiKey": "text",
    "delimiter": "text",
    "txHash": "text",
    "registry": [
      "[Circular Reference]"
    ],
    "dataSourceId": 1,
    "ownerId": "text",
    "updatedAt": "2025-03-22T05:34:16.798Z",
    "createdAt": "2025-03-22T05:34:16.798Z"
  },
  "defaultAddress": "text",
  "default": {
    "address": "text",
    "chain": {
      "id": 1,
      "name": "text",
      "symbol": "text",
      "icon": "text",
      "rpc": [
        "text"
      ],
      "type": "EVM",
      "shortName": "text",
      "infoURL": "text",
      "chainId": 1,
      "updatedAt": "2025-03-22T05:34:16.798Z",
      "createdAt": "2025-03-22T05:34:16.798Z"
    },
    "chainId": 1,
    "isMultisig": true,
    "isSmartContractWallet": true,
    "walletId": {
      "id": 1,
      "name": "text",
      "symbol": "text",
      "icon": "text",
      "rpc": [
        "text"
      ],
      "type": "EVM",
      "shortName": "text",
      "infoURL": "text",
      "chainId": 1,
      "updatedAt": "2025-03-22T05:34:16.798Z",
      "createdAt": "2025-03-22T05:34:16.798Z"
    },
    "updatedAt": "2025-03-22T05:34:16.798Z",
    "createdAt": "2025-03-22T05:34:16.798Z"
  },
  "secondary": [
    {
      "id": "text",
      "address": "text",
      "isMultisig": true,
      "isSmartContractWallet": true,
      "chainId": 1,
      "chain": {
        "id": 1,
        "name": "text",
        "symbol": "text",
        "icon": "text",
        "rpc": [
          "text"
        ],
        "type": "EVM",
        "shortName": "text",
        "infoURL": "text",
        "chainId": 1,
        "updatedAt": "2025-03-22T05:34:16.798Z",
        "createdAt": "2025-03-22T05:34:16.798Z"
      },
      "walletId": "text",
      "identity": "[Circular Reference]",
      "updatedAt": "2025-03-22T05:34:16.798Z",
      "createdAt": "2025-03-22T05:34:16.798Z"
    }
  ],
  "nonce": 1,
  "currentSignature": "text",
  "previousSignature": "text",
  "isContract": true,
  "syncedAt": "2025-03-22T05:34:16.798Z",
  "createdAt": "2025-03-22T05:34:16.798Z"
}

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

Resolve Identity

Get Identity

get

Authorizations

Query parameters

idstringoptional

Example: satyams@fetcch

addressstringoptional

Example: 0x8E9e20b90efa7d0A072bfc8b0C74D96104F1F6FE

signedMessagestringoptional

Example: 0x8E9e20b90efa7d0A072bfc8b0C74D96104F1F6FE34423232

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://sandbox-api.fetcch.xyz/v1/identity' \
  --header 'secret-key: YOUR_API_KEY'

200

400

401

200

{
  "data": {
    "id": "text",
    "identifier": "text",
    "providerId": "text",
    "provider": {
      "id": "text",
      "logo": "text",
      "apiKey": "text",
      "delimiter": "text",
      "txHash": "text",
      "registry": [
        "[Circular Reference]"
      ],
      "dataSourceId": 1,
      "ownerId": "text",
      "updatedAt": "2025-03-22T05:34:16.798Z",
      "createdAt": "2025-03-22T05:34:16.798Z"
    },
    "defaultAddress": "text",
    "default": {
      "address": "text",
      "chain": {
        "id": 1,
        "name": "text",
        "symbol": "text",
        "icon": "text",
        "rpc": [
          "text"
        ],
        "type": "EVM",
        "shortName": "text",
        "infoURL": "text",
        "chainId": 1,
        "updatedAt": "2025-03-22T05:34:16.798Z",
        "createdAt": "2025-03-22T05:34:16.798Z"
      },
      "chainId": 1,
      "isMultisig": true,
      "isSmartContractWallet": true,
      "walletId": {
        "id": 1,
        "name": "text",
        "symbol": "text",
        "icon": "text",
        "rpc": [
          "text"
        ],
        "type": "EVM",
        "shortName": "text",
        "infoURL": "text",
        "chainId": 1,
        "updatedAt": "2025-03-22T05:34:16.798Z",
        "createdAt": "2025-03-22T05:34:16.798Z"
      },
      "updatedAt": "2025-03-22T05:34:16.798Z",
      "createdAt": "2025-03-22T05:34:16.798Z"
    },
    "secondary": [
      {
        "id": "text",
        "address": "text",
        "isMultisig": true,
        "isSmartContractWallet": true,
        "chainId": 1,
        "chain": {
          "id": 1,
          "name": "text",
          "symbol": "text",
          "icon": "text",
          "rpc": [
            "text"
          ],
          "type": "EVM",
          "shortName": "text",
          "infoURL": "text",
          "chainId": 1,
          "updatedAt": "2025-03-22T05:34:16.798Z",
          "createdAt": "2025-03-22T05:34:16.798Z"
        },
        "walletId": "text",
        "identity": "[Circular Reference]",
        "updatedAt": "2025-03-22T05:34:16.798Z",
        "createdAt": "2025-03-22T05:34:16.798Z"
      }
    ],
    "nonce": 1,
    "currentSignature": "text",
    "previousSignature": "text",
    "isContract": true,
    "syncedAt": "2025-03-22T05:34:16.798Z",
    "createdAt": "2025-03-22T05:34:16.798Z"
  },
  "status": 1,
  "timestamp": "2025-03-22T05:34:16.798Z"
}