How to create address books?

Process of creating address book

Arrange Data

Arrange address book data in the format

{
    "name": "string"
    "addresses": {
        "address": "address",
        "chainType": "EVM" | "APTOS" | "SOLANA",
        "name": "string"
    }[],
    "walletIds": {
        "walletId": "string",
        "name": "string"
    },
    "ownerId": "string"
}

Generate & Sign Message

Generate message using this API and above data

Generate message for address book

POSThttps://sandbox-api.fetcch.xyz/v1/address-books/message

Body

application/json

idinteger

name*string

addressesarray of string

walletIdsarray of string

owner*string

createdAtstring (date-time)

updatedAt*string (date-time)

Response

201400401

Successful response

Body

application/json

dataobject

statusinteger

timestampstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://sandbox-api.fetcch.xyz/v1/address-books/message', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "owner": "text",
      "updatedAt": "2024-12-21T15:13:11.086Z"
    }),
});
const data = await response.json();

Response

201400401

{
  "data": {
    "message": "text",
    "book": {
      "id": 0,
      "name": "text",
      "addresses": [
        {
          "id": 0,
          "address": "text",
          "chainType": "EVM",
          "name": "text",
          "addressBookId": 0
        }
      ],
      "walletIds": [
        {
          "id": 0,
          "walletId": "text",
          "wallet": {
            "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-21T15:13:11.086Z",
              "createdAt": "2024-12-21T15:13:11.086Z"
            },
            "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-21T15:13:11.086Z",
                "createdAt": "2024-12-21T15:13:11.086Z"
              },
              "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-21T15:13:11.086Z",
                "createdAt": "2024-12-21T15:13:11.086Z"
              },
              "updatedAt": "2024-12-21T15:13:11.086Z",
              "createdAt": "2024-12-21T15:13:11.086Z"
            },
            "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-21T15:13:11.086Z",
                  "createdAt": "2024-12-21T15:13:11.086Z"
                },
                "walletId": "text",
                "updatedAt": "2024-12-21T15:13:11.086Z",
                "createdAt": "2024-12-21T15:13:11.086Z"
              }
            ],
            "nonce": 0,
            "currentSignature": "text",
            "previousSignature": "text",
            "isContract": false,
            "syncedAt": "2024-12-21T15:13:11.086Z",
            "createdAt": "2024-12-21T15:13:11.086Z"
          },
          "name": "text",
          "addressBookId": 0,
          "createdAt": "2024-12-21T15:13:11.086Z",
          "updatedAt": "2024-12-21T15:13:11.086Z"
        }
      ],
      "ownerId": "text",
      "owner": {
        "owner": "text",
        "ownerId": "text",
        "ownerIdentity": {
          "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-21T15:13:11.086Z",
            "createdAt": "2024-12-21T15:13:11.086Z"
          },
          "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-21T15:13:11.086Z",
              "createdAt": "2024-12-21T15:13:11.086Z"
            },
            "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-21T15:13:11.086Z",
              "createdAt": "2024-12-21T15:13:11.086Z"
            },
            "updatedAt": "2024-12-21T15:13:11.086Z",
            "createdAt": "2024-12-21T15:13:11.086Z"
          },
          "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-21T15:13:11.086Z",
                "createdAt": "2024-12-21T15:13:11.086Z"
              },
              "walletId": "text",
              "updatedAt": "2024-12-21T15:13:11.086Z",
              "createdAt": "2024-12-21T15:13:11.086Z"
            }
          ],
          "nonce": 0,
          "currentSignature": "text",
          "previousSignature": "text",
          "isContract": false,
          "syncedAt": "2024-12-21T15:13:11.086Z",
          "createdAt": "2024-12-21T15:13:11.086Z"
        },
        "createdAt": "2024-12-21T15:13:11.086Z",
        "updatedAt": "2024-12-21T15:13:11.086Z"
      },
      "requests": [
        {
          "id": 0,
          "bookId": 0,
          "toId": "text",
          "to": {
            "owner": "text",
            "ownerId": "text",
            "ownerIdentity": {
              "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-21T15:13:11.086Z",
                "createdAt": "2024-12-21T15:13:11.086Z"
              },
              "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-21T15:13:11.086Z",
                  "createdAt": "2024-12-21T15:13:11.086Z"
                },
                "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-21T15:13:11.086Z",
                  "createdAt": "2024-12-21T15:13:11.086Z"
                },
                "updatedAt": "2024-12-21T15:13:11.086Z",
                "createdAt": "2024-12-21T15:13:11.086Z"
              },
              "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-21T15:13:11.086Z",
                    "createdAt": "2024-12-21T15:13:11.086Z"
                  },
                  "walletId": "text",
                  "updatedAt": "2024-12-21T15:13:11.086Z",
                  "createdAt": "2024-12-21T15:13:11.086Z"
                }
              ],
              "nonce": 0,
              "currentSignature": "text",
              "previousSignature": "text",
              "isContract": false,
              "syncedAt": "2024-12-21T15:13:11.086Z",
              "createdAt": "2024-12-21T15:13:11.086Z"
            },
            "createdAt": "2024-12-21T15:13:11.086Z",
            "updatedAt": "2024-12-21T15:13:11.086Z"
          },
          "access": "READ",
          "pending": true,
          "accepted": false,
          "createdAt": "2024-12-21T15:13:11.086Z",
          "updatedAt": "2024-12-21T15:13:11.086Z"
        }
      ],
      "createdAt": "2024-12-21T15:13:11.086Z",
      "updatedAt": "2024-12-21T15:13:11.086Z"
    }
  },
  "status": 0,
  "timestamp": "2024-12-21T15:13:11.086Z"
}

Sign the above message by following signature guidelines mentioned here according to the chain you are using

Call Create Address Book API

Create Address Book

POSThttps://sandbox-api.fetcch.xyz/v1/address-books

Body

application/json

idinteger

signaturestring

name*string

addressesarray of string

walletIdsarray of string

owner*string

createdAtstring (date-time)

updatedAt*string (date-time)

Response

201400401

Successful response

Body

application/json

dataAddressBook (object)

statusinteger

timestampstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://sandbox-api.fetcch.xyz/v1/address-books', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "owner": "text",
      "updatedAt": "2024-12-21T15:13:11.086Z"
    }),
});
const data = await response.json();

Response

201400401

{
  "data": {
    "id": 0,
    "name": "text",
    "addresses": [
      {
        "id": 0,
        "address": "text",
        "chainType": "EVM",
        "name": "text",
        "addressBookId": 0
      }
    ],
    "walletIds": [
      {
        "id": 0,
        "walletId": "text",
        "wallet": {
          "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-21T15:13:11.086Z",
            "createdAt": "2024-12-21T15:13:11.086Z"
          },
          "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-21T15:13:11.086Z",
              "createdAt": "2024-12-21T15:13:11.086Z"
            },
            "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-21T15:13:11.086Z",
              "createdAt": "2024-12-21T15:13:11.086Z"
            },
            "updatedAt": "2024-12-21T15:13:11.086Z",
            "createdAt": "2024-12-21T15:13:11.086Z"
          },
          "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-21T15:13:11.086Z",
                "createdAt": "2024-12-21T15:13:11.086Z"
              },
              "walletId": "text",
              "updatedAt": "2024-12-21T15:13:11.086Z",
              "createdAt": "2024-12-21T15:13:11.086Z"
            }
          ],
          "nonce": 0,
          "currentSignature": "text",
          "previousSignature": "text",
          "isContract": false,
          "syncedAt": "2024-12-21T15:13:11.086Z",
          "createdAt": "2024-12-21T15:13:11.086Z"
        },
        "name": "text",
        "addressBookId": 0,
        "createdAt": "2024-12-21T15:13:11.086Z",
        "updatedAt": "2024-12-21T15:13:11.086Z"
      }
    ],
    "ownerId": "text",
    "owner": {
      "owner": "text",
      "ownerId": "text",
      "ownerIdentity": {
        "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-21T15:13:11.086Z",
          "createdAt": "2024-12-21T15:13:11.086Z"
        },
        "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-21T15:13:11.086Z",
            "createdAt": "2024-12-21T15:13:11.086Z"
          },
          "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-21T15:13:11.086Z",
            "createdAt": "2024-12-21T15:13:11.086Z"
          },
          "updatedAt": "2024-12-21T15:13:11.086Z",
          "createdAt": "2024-12-21T15:13:11.086Z"
        },
        "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-21T15:13:11.086Z",
              "createdAt": "2024-12-21T15:13:11.086Z"
            },
            "walletId": "text",
            "updatedAt": "2024-12-21T15:13:11.086Z",
            "createdAt": "2024-12-21T15:13:11.086Z"
          }
        ],
        "nonce": 0,
        "currentSignature": "text",
        "previousSignature": "text",
        "isContract": false,
        "syncedAt": "2024-12-21T15:13:11.086Z",
        "createdAt": "2024-12-21T15:13:11.086Z"
      },
      "createdAt": "2024-12-21T15:13:11.086Z",
      "updatedAt": "2024-12-21T15:13:11.086Z"
    },
    "requests": [
      {
        "id": 0,
        "bookId": 0,
        "toId": "text",
        "to": {
          "owner": "text",
          "ownerId": "text",
          "ownerIdentity": {
            "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-21T15:13:11.086Z",
              "createdAt": "2024-12-21T15:13:11.086Z"
            },
            "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-21T15:13:11.086Z",
                "createdAt": "2024-12-21T15:13:11.086Z"
              },
              "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-21T15:13:11.086Z",
                "createdAt": "2024-12-21T15:13:11.086Z"
              },
              "updatedAt": "2024-12-21T15:13:11.086Z",
              "createdAt": "2024-12-21T15:13:11.086Z"
            },
            "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-21T15:13:11.086Z",
                  "createdAt": "2024-12-21T15:13:11.086Z"
                },
                "walletId": "text",
                "updatedAt": "2024-12-21T15:13:11.086Z",
                "createdAt": "2024-12-21T15:13:11.086Z"
              }
            ],
            "nonce": 0,
            "currentSignature": "text",
            "previousSignature": "text",
            "isContract": false,
            "syncedAt": "2024-12-21T15:13:11.086Z",
            "createdAt": "2024-12-21T15:13:11.086Z"
          },
          "createdAt": "2024-12-21T15:13:11.086Z",
          "updatedAt": "2024-12-21T15:13:11.086Z"
        },
        "access": "READ",
        "pending": true,
        "accepted": false,
        "createdAt": "2024-12-21T15:13:11.086Z",
        "updatedAt": "2024-12-21T15:13:11.086Z"
      }
    ],
    "createdAt": "2024-12-21T15:13:11.086Z",
    "updatedAt": "2024-12-21T15:13:11.086Z"
  },
  "status": 0,
  "timestamp": "2024-12-21T15:13:11.086Z"
}