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

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

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

Resolve Identity

PreviousHow to resolve identity?NextHow to update identity?

Last updated 1 year ago

{ "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 } ] }

{ "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", "provider": { "id": "text", "logo": "text", "apiKey": "text", "delimiter": "text", "txHash": "text", "registry": "[Circular Reference]", "dataSourceId": 1, "ownerId": "text", "updatedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" } } ], "dataSourceId": 1, "ownerId": "text", "updatedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "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-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "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-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "updatedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "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-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "walletId": "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", "provider": { "id": "text", "logo": "text", "apiKey": "text", "delimiter": "text", "txHash": "text", "registry": "[Circular Reference]", "dataSourceId": 1, "ownerId": "text", "updatedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" } } ], "dataSourceId": 1, "ownerId": "text", "updatedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "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-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "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-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "updatedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "secondary": [ "[Circular Reference]" ], "nonce": 1, "currentSignature": "text", "previousSignature": "text", "isContract": true, "syncedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "updatedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" } ], "nonce": 1, "currentSignature": "text", "previousSignature": "text", "isContract": true, "syncedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "status": 1, "timestamp": "2025-04-03T04:50:06.531Z" }

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" }'

{ "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", "provider": { "id": "text", "logo": "text", "apiKey": "text", "delimiter": "text", "txHash": "text", "registry": [ "[Circular Reference]" ], "dataSourceId": 1, "ownerId": "text", "updatedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" } } ], "dataSourceId": 1, "ownerId": "text", "updatedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "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-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "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-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "updatedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "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-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "walletId": "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", "provider": { "id": "text", "logo": "text", "apiKey": "text", "delimiter": "text", "txHash": "text", "registry": [ "[Circular Reference]" ], "dataSourceId": 1, "ownerId": "text", "updatedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" } } ], "dataSourceId": 1, "ownerId": "text", "updatedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "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-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "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-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "updatedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "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-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "walletId": "text", "identity": "[Circular Reference]", "updatedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" } ], "nonce": 1, "currentSignature": "text", "previousSignature": "text", "isContract": true, "syncedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }, "updatedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" } ], "nonce": 1, "currentSignature": "text", "previousSignature": "text", "isContract": true, "syncedAt": "2025-04-03T04:50:06.531Z", "createdAt": "2025-04-03T04:50:06.531Z" }

Arrange Identity

Generate Message

Create Identity

Important Note

Resolve Identity

Arrange Identity

Generate Message

Create Identity

Important Note

Resolve Identity

Get Identity

Generate Message

Show child attributes

Show child attributes

Create Identity

Show child attributes

Show child attributes