How to accept address book request?

Accepting request to address book

Arrange Data

Arrange data in the format

{
    "id": number, // request id
}

Generate & Sign Message

Call this API to get the message

Generate message for sharing address book

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

Body

application/json

idinteger

book*integer

tostring

access*enum

READREADWRITE

pendingboolean

acceptedboolean

createdAtstring (date-time)

updatedAt*string (date-time)

Response

200400401

Successful response

Body

application/json

dataobject

statusinteger

timestampstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://sandbox-api.fetcch.xyz/v1/address-books/request/message', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "access": "READ",
      "updatedAt": "2024-10-30T00:53:58.606Z"
    }),
});
const data = await response.json();

Response

200400401

{
  "data": {
    "message": "text",
    "request": {
      "book": {
        "name": "text",
        "addresses": [
          {
            "address": "text",
            "chainType": "EVM",
            "name": "text"
          }
        ],
        "walletIds": [
          {
            "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"
                  }
                ],
                "ownerId": "text",
                "updatedAt": "2024-10-30T00:53:58.606Z",
                "createdAt": "2024-10-30T00:53:58.606Z"
              },
              "defaultAddress": "text",
              "default": {
                "address": "text",
                "chain": {
                  "name": "text",
                  "symbol": "text",
                  "icon": "text",
                  "rpc": [
                    "text"
                  ],
                  "type": "EVM",
                  "shortName": "text",
                  "infoURL": "text",
                  "updatedAt": "2024-10-30T00:53:58.606Z",
                  "createdAt": "2024-10-30T00:53:58.606Z"
                },
                "isMultisig": false,
                "isSmartContractWallet": false,
                "walletId": {
                  "name": "text",
                  "symbol": "text",
                  "icon": "text",
                  "rpc": [
                    "text"
                  ],
                  "type": "EVM",
                  "shortName": "text",
                  "infoURL": "text",
                  "updatedAt": "2024-10-30T00:53:58.606Z",
                  "createdAt": "2024-10-30T00:53:58.606Z"
                },
                "updatedAt": "2024-10-30T00:53:58.606Z",
                "createdAt": "2024-10-30T00:53:58.606Z"
              },
              "secondary": [
                {
                  "id": "text",
                  "address": "text",
                  "isMultisig": false,
                  "isSmartContractWallet": false,
                  "chain": {
                    "name": "text",
                    "symbol": "text",
                    "icon": "text",
                    "rpc": [
                      "text"
                    ],
                    "type": "EVM",
                    "shortName": "text",
                    "infoURL": "text",
                    "updatedAt": "2024-10-30T00:53:58.606Z",
                    "createdAt": "2024-10-30T00:53:58.606Z"
                  },
                  "walletId": "text",
                  "updatedAt": "2024-10-30T00:53:58.606Z",
                  "createdAt": "2024-10-30T00:53:58.606Z"
                }
              ],
              "currentSignature": "text",
              "previousSignature": "text",
              "isContract": false,
              "syncedAt": "2024-10-30T00:53:58.606Z",
              "createdAt": "2024-10-30T00:53:58.606Z"
            },
            "name": "text",
            "createdAt": "2024-10-30T00:53:58.606Z",
            "updatedAt": "2024-10-30T00:53:58.606Z"
          }
        ],
        "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"
                }
              ],
              "ownerId": "text",
              "updatedAt": "2024-10-30T00:53:58.606Z",
              "createdAt": "2024-10-30T00:53:58.606Z"
            },
            "defaultAddress": "text",
            "default": {
              "address": "text",
              "chain": {
                "name": "text",
                "symbol": "text",
                "icon": "text",
                "rpc": [
                  "text"
                ],
                "type": "EVM",
                "shortName": "text",
                "infoURL": "text",
                "updatedAt": "2024-10-30T00:53:58.606Z",
                "createdAt": "2024-10-30T00:53:58.606Z"
              },
              "isMultisig": false,
              "isSmartContractWallet": false,
              "walletId": {
                "name": "text",
                "symbol": "text",
                "icon": "text",
                "rpc": [
                  "text"
                ],
                "type": "EVM",
                "shortName": "text",
                "infoURL": "text",
                "updatedAt": "2024-10-30T00:53:58.606Z",
                "createdAt": "2024-10-30T00:53:58.606Z"
              },
              "updatedAt": "2024-10-30T00:53:58.606Z",
              "createdAt": "2024-10-30T00:53:58.606Z"
            },
            "secondary": [
              {
                "id": "text",
                "address": "text",
                "isMultisig": false,
                "isSmartContractWallet": false,
                "chain": {
                  "name": "text",
                  "symbol": "text",
                  "icon": "text",
                  "rpc": [
                    "text"
                  ],
                  "type": "EVM",
                  "shortName": "text",
                  "infoURL": "text",
                  "updatedAt": "2024-10-30T00:53:58.606Z",
                  "createdAt": "2024-10-30T00:53:58.606Z"
                },
                "walletId": "text",
                "updatedAt": "2024-10-30T00:53:58.606Z",
                "createdAt": "2024-10-30T00:53:58.606Z"
              }
            ],
            "currentSignature": "text",
            "previousSignature": "text",
            "isContract": false,
            "syncedAt": "2024-10-30T00:53:58.606Z",
            "createdAt": "2024-10-30T00:53:58.606Z"
          },
          "createdAt": "2024-10-30T00:53:58.606Z",
          "updatedAt": "2024-10-30T00:53:58.606Z"
        },
        "requests": [],
        "createdAt": "2024-10-30T00:53:58.606Z",
        "updatedAt": "2024-10-30T00:53:58.606Z"
      },
      "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"
              }
            ],
            "ownerId": "text",
            "updatedAt": "2024-10-30T00:53:58.606Z",
            "createdAt": "2024-10-30T00:53:58.606Z"
          },
          "defaultAddress": "text",
          "default": {
            "address": "text",
            "chain": {
              "name": "text",
              "symbol": "text",
              "icon": "text",
              "rpc": [
                "text"
              ],
              "type": "EVM",
              "shortName": "text",
              "infoURL": "text",
              "updatedAt": "2024-10-30T00:53:58.606Z",
              "createdAt": "2024-10-30T00:53:58.606Z"
            },
            "isMultisig": false,
            "isSmartContractWallet": false,
            "walletId": {
              "name": "text",
              "symbol": "text",
              "icon": "text",
              "rpc": [
                "text"
              ],
              "type": "EVM",
              "shortName": "text",
              "infoURL": "text",
              "updatedAt": "2024-10-30T00:53:58.606Z",
              "createdAt": "2024-10-30T00:53:58.606Z"
            },
            "updatedAt": "2024-10-30T00:53:58.606Z",
            "createdAt": "2024-10-30T00:53:58.606Z"
          },
          "secondary": [
            {
              "id": "text",
              "address": "text",
              "isMultisig": false,
              "isSmartContractWallet": false,
              "chain": {
                "name": "text",
                "symbol": "text",
                "icon": "text",
                "rpc": [
                  "text"
                ],
                "type": "EVM",
                "shortName": "text",
                "infoURL": "text",
                "updatedAt": "2024-10-30T00:53:58.606Z",
                "createdAt": "2024-10-30T00:53:58.606Z"
              },
              "walletId": "text",
              "updatedAt": "2024-10-30T00:53:58.606Z",
              "createdAt": "2024-10-30T00:53:58.606Z"
            }
          ],
          "currentSignature": "text",
          "previousSignature": "text",
          "isContract": false,
          "syncedAt": "2024-10-30T00:53:58.606Z",
          "createdAt": "2024-10-30T00:53:58.606Z"
        },
        "createdAt": "2024-10-30T00:53:58.606Z",
        "updatedAt": "2024-10-30T00:53:58.606Z"
      },
      "access": "READ",
      "pending": true,
      "accepted": false,
      "createdAt": "2024-10-30T00:53:58.606Z",
      "updatedAt": "2024-10-30T00:53:58.606Z"
    }
  },
  "timestamp": "2024-10-30T00:53:58.606Z"
}

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

Call API

Update address book request

PATCHhttps://sandbox-api.fetcch.xyz/v1/address-books/request

Body

application/json

signaturestring

idinteger

Response

200400401

Successful response

Body

application/json

dataobject

statusinteger

timestampstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://sandbox-api.fetcch.xyz/v1/address-books/request', {
    method: 'PATCH',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401

{
  "data": {
    "message": "text",
    "request": {
      "book": {
        "name": "text",
        "addresses": [
          {
            "address": "text",
            "chainType": "EVM",
            "name": "text"
          }
        ],
        "walletIds": [
          {
            "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"
                  }
                ],
                "ownerId": "text",
                "updatedAt": "2024-10-30T00:53:58.606Z",
                "createdAt": "2024-10-30T00:53:58.606Z"
              },
              "defaultAddress": "text",
              "default": {
                "address": "text",
                "chain": {
                  "name": "text",
                  "symbol": "text",
                  "icon": "text",
                  "rpc": [
                    "text"
                  ],
                  "type": "EVM",
                  "shortName": "text",
                  "infoURL": "text",
                  "updatedAt": "2024-10-30T00:53:58.606Z",
                  "createdAt": "2024-10-30T00:53:58.606Z"
                },
                "isMultisig": false,
                "isSmartContractWallet": false,
                "walletId": {
                  "name": "text",
                  "symbol": "text",
                  "icon": "text",
                  "rpc": [
                    "text"
                  ],
                  "type": "EVM",
                  "shortName": "text",
                  "infoURL": "text",
                  "updatedAt": "2024-10-30T00:53:58.606Z",
                  "createdAt": "2024-10-30T00:53:58.606Z"
                },
                "updatedAt": "2024-10-30T00:53:58.606Z",
                "createdAt": "2024-10-30T00:53:58.606Z"
              },
              "secondary": [
                {
                  "id": "text",
                  "address": "text",
                  "isMultisig": false,
                  "isSmartContractWallet": false,
                  "chain": {
                    "name": "text",
                    "symbol": "text",
                    "icon": "text",
                    "rpc": [
                      "text"
                    ],
                    "type": "EVM",
                    "shortName": "text",
                    "infoURL": "text",
                    "updatedAt": "2024-10-30T00:53:58.606Z",
                    "createdAt": "2024-10-30T00:53:58.606Z"
                  },
                  "walletId": "text",
                  "updatedAt": "2024-10-30T00:53:58.606Z",
                  "createdAt": "2024-10-30T00:53:58.606Z"
                }
              ],
              "currentSignature": "text",
              "previousSignature": "text",
              "isContract": false,
              "syncedAt": "2024-10-30T00:53:58.606Z",
              "createdAt": "2024-10-30T00:53:58.606Z"
            },
            "name": "text",
            "createdAt": "2024-10-30T00:53:58.606Z",
            "updatedAt": "2024-10-30T00:53:58.606Z"
          }
        ],
        "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"
                }
              ],
              "ownerId": "text",
              "updatedAt": "2024-10-30T00:53:58.606Z",
              "createdAt": "2024-10-30T00:53:58.606Z"
            },
            "defaultAddress": "text",
            "default": {
              "address": "text",
              "chain": {
                "name": "text",
                "symbol": "text",
                "icon": "text",
                "rpc": [
                  "text"
                ],
                "type": "EVM",
                "shortName": "text",
                "infoURL": "text",
                "updatedAt": "2024-10-30T00:53:58.606Z",
                "createdAt": "2024-10-30T00:53:58.606Z"
              },
              "isMultisig": false,
              "isSmartContractWallet": false,
              "walletId": {
                "name": "text",
                "symbol": "text",
                "icon": "text",
                "rpc": [
                  "text"
                ],
                "type": "EVM",
                "shortName": "text",
                "infoURL": "text",
                "updatedAt": "2024-10-30T00:53:58.606Z",
                "createdAt": "2024-10-30T00:53:58.606Z"
              },
              "updatedAt": "2024-10-30T00:53:58.606Z",
              "createdAt": "2024-10-30T00:53:58.606Z"
            },
            "secondary": [
              {
                "id": "text",
                "address": "text",
                "isMultisig": false,
                "isSmartContractWallet": false,
                "chain": {
                  "name": "text",
                  "symbol": "text",
                  "icon": "text",
                  "rpc": [
                    "text"
                  ],
                  "type": "EVM",
                  "shortName": "text",
                  "infoURL": "text",
                  "updatedAt": "2024-10-30T00:53:58.606Z",
                  "createdAt": "2024-10-30T00:53:58.606Z"
                },
                "walletId": "text",
                "updatedAt": "2024-10-30T00:53:58.606Z",
                "createdAt": "2024-10-30T00:53:58.606Z"
              }
            ],
            "currentSignature": "text",
            "previousSignature": "text",
            "isContract": false,
            "syncedAt": "2024-10-30T00:53:58.606Z",
            "createdAt": "2024-10-30T00:53:58.606Z"
          },
          "createdAt": "2024-10-30T00:53:58.606Z",
          "updatedAt": "2024-10-30T00:53:58.606Z"
        },
        "requests": [],
        "createdAt": "2024-10-30T00:53:58.606Z",
        "updatedAt": "2024-10-30T00:53:58.606Z"
      },
      "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"
              }
            ],
            "ownerId": "text",
            "updatedAt": "2024-10-30T00:53:58.606Z",
            "createdAt": "2024-10-30T00:53:58.606Z"
          },
          "defaultAddress": "text",
          "default": {
            "address": "text",
            "chain": {
              "name": "text",
              "symbol": "text",
              "icon": "text",
              "rpc": [
                "text"
              ],
              "type": "EVM",
              "shortName": "text",
              "infoURL": "text",
              "updatedAt": "2024-10-30T00:53:58.606Z",
              "createdAt": "2024-10-30T00:53:58.606Z"
            },
            "isMultisig": false,
            "isSmartContractWallet": false,
            "walletId": {
              "name": "text",
              "symbol": "text",
              "icon": "text",
              "rpc": [
                "text"
              ],
              "type": "EVM",
              "shortName": "text",
              "infoURL": "text",
              "updatedAt": "2024-10-30T00:53:58.606Z",
              "createdAt": "2024-10-30T00:53:58.606Z"
            },
            "updatedAt": "2024-10-30T00:53:58.606Z",
            "createdAt": "2024-10-30T00:53:58.606Z"
          },
          "secondary": [
            {
              "id": "text",
              "address": "text",
              "isMultisig": false,
              "isSmartContractWallet": false,
              "chain": {
                "name": "text",
                "symbol": "text",
                "icon": "text",
                "rpc": [
                  "text"
                ],
                "type": "EVM",
                "shortName": "text",
                "infoURL": "text",
                "updatedAt": "2024-10-30T00:53:58.606Z",
                "createdAt": "2024-10-30T00:53:58.606Z"
              },
              "walletId": "text",
              "updatedAt": "2024-10-30T00:53:58.606Z",
              "createdAt": "2024-10-30T00:53:58.606Z"
            }
          ],
          "currentSignature": "text",
          "previousSignature": "text",
          "isContract": false,
          "syncedAt": "2024-10-30T00:53:58.606Z",
          "createdAt": "2024-10-30T00:53:58.606Z"
        },
        "createdAt": "2024-10-30T00:53:58.606Z",
        "updatedAt": "2024-10-30T00:53:58.606Z"
      },
      "access": "READ",
      "pending": true,
      "accepted": false,
      "createdAt": "2024-10-30T00:53:58.606Z",
      "updatedAt": "2024-10-30T00:53:58.606Z"
    }
  },
  "timestamp": "2024-10-30T00:53:58.606Z"
}