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

Create Identity

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

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-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" } } ], "dataSourceId": 1, "ownerId": "text", "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "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-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "chainId": 1, "isMultisig": false, "isSmartContractWallet": false, "walletId": { "id": 1, "name": "text", "symbol": "text", "icon": "text", "rpc": [ "text" ], "type": "EVM", "shortName": "text", "infoURL": "text", "chainId": 1, "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "secondary": [ { "id": "text", "address": "text", "isMultisig": false, "isSmartContractWallet": false, "chainId": 1, "chain": { "id": 1, "name": "text", "symbol": "text", "icon": "text", "rpc": [ "text" ], "type": "EVM", "shortName": "text", "infoURL": "text", "chainId": 1, "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "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-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" } } ], "dataSourceId": 1, "ownerId": "text", "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "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-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "chainId": 1, "isMultisig": false, "isSmartContractWallet": false, "walletId": { "id": 1, "name": "text", "symbol": "text", "icon": "text", "rpc": [ "text" ], "type": "EVM", "shortName": "text", "infoURL": "text", "chainId": 1, "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "secondary": [ "[Circular Reference]" ], "nonce": 0, "currentSignature": "text", "previousSignature": "text", "isContract": false, "syncedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" } ], "nonce": 0, "currentSignature": "text", "previousSignature": "text", "isContract": false, "syncedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "status": 1, "timestamp": "2025-05-31T21:16:00.451Z" }

POST /v1/identity HTTP/1.1 Host: sandbox-api.fetcch.xyz secret-key: YOUR_API_KEY Content-Type: application/json Accept: */* Content-Length: 280 { "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-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" } } ], "dataSourceId": 1, "ownerId": "text", "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "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-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "chainId": 1, "isMultisig": false, "isSmartContractWallet": false, "walletId": { "id": 1, "name": "text", "symbol": "text", "icon": "text", "rpc": [ "text" ], "type": "EVM", "shortName": "text", "infoURL": "text", "chainId": 1, "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "secondary": [ { "id": "text", "address": "text", "isMultisig": false, "isSmartContractWallet": false, "chainId": 1, "chain": { "id": 1, "name": "text", "symbol": "text", "icon": "text", "rpc": [ "text" ], "type": "EVM", "shortName": "text", "infoURL": "text", "chainId": 1, "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "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-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" } } ], "dataSourceId": 1, "ownerId": "text", "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "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-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "chainId": 1, "isMultisig": false, "isSmartContractWallet": false, "walletId": { "id": 1, "name": "text", "symbol": "text", "icon": "text", "rpc": [ "text" ], "type": "EVM", "shortName": "text", "infoURL": "text", "chainId": 1, "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "secondary": [ { "id": "text", "address": "text", "isMultisig": false, "isSmartContractWallet": false, "chainId": 1, "chain": { "id": 1, "name": "text", "symbol": "text", "icon": "text", "rpc": [ "text" ], "type": "EVM", "shortName": "text", "infoURL": "text", "chainId": 1, "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "walletId": "text", "identity": "[Circular Reference]", "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" } ], "nonce": 0, "currentSignature": "text", "previousSignature": "text", "isContract": false, "syncedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }, "updatedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" } ], "nonce": 0, "currentSignature": "text", "previousSignature": "text", "isContract": false, "syncedAt": "2025-05-31T21:16:00.451Z", "createdAt": "2025-05-31T21:16:00.451Z" }

Arrange Identity

Generate Message

Create Identity

Important Note

Resolve Identity

Arrange Identity

Generate Message

Create Identity

Important Note

Resolve Identity

Get Identity

Generate Message

Create Identity