Follow and Unfollow

This guide explains how to follow and unfollow an Account on Lens.

Lens Account can follow other Lens accounts on the Global Graph or on Custom Graphs.

Follow operations are regulated by Follow Rules set on the target Account and by the Graph Rule of the Graph where the follow relationship is established. More information on this will be provided in due course.

Follow an Account

To follow an account, you need to:

  1. Check Follow permissions

  2. Submit a Follow request

All steps in this section assumes are authenticated as Account Owner or Account Manager.

1

Check Follow Permissions

First, inspect the account's operations.canFollow field to determine if you can follow the account.

Account
fragment Account on Account {  # ...
  operations {    # defaults to the Global Graph    canFollow    isFollowedByMe
    # or use aliases for a specific Graph    # canFollowOnMyGraph: canFollow(request: { graph: "0x123…" })    # isFollowedByMeOnMyGraph: isFollowedByMe(request: { graph: "0x123…" })
    # ...  }}

The value of which can be:

  • YES - Your Account meets the follow criteria the target Account Owner has set.

  • NO - You cannot follow the target Account. This could be for 2 reasons:

    • Your Account already follows the target Account, in this case the operation.isFollowedByMe field will be true.

    • Your Account does not meet the follow criteria the target Account Owner has set.

  • UNKNWOWN - Indicates the Account's follow permissions are not known. This could be due to the use of a Custom Follow Rule (more on this later).

2

Submit Follow Request

Then, if your follow request is allowed, you can proceed with submitting the request.

Use the follow mutation to submit a follow request.

mutation {  follow(    request: {      account: "0x1234567890abcdef1234567890abcdef12345678"
      # optional, defaults to the Global Graph      # graph: EvmAddress
      # optional, the required Graph Rule execution data, if any      # graphRule: GraphRulesInput
      # optional, the required Follow Rule execution data, if any      # followRule: FollowRulesInput    }  ) {    ... on FollowResponse {      hash    }
    ... on SponsoredTransactionRequest {      ...SponsoredTransactionRequest    }
    ... on SelfFundedTransactionRequest {      ...SelfFundedTransactionRequest    }
    ... on TransactionWillFail {      reason    }  }}

Finally, handle the result as explained in the Transaction Lifecycle guide.

Unfollow an Account

To unfollow an account, you need to:

  1. Check Unfollow permissions

  2. Submit an Unfollow request

All steps in this section assumes are authenticated as Account Owner or Account Manager.

1

Check Unfollow Permissions

First, inspect the account's operations.canUnfollow field to determine if you can unfollow the account.

Account
fragment Account on Account {  # ...
  operations {    # defaults to the Global Graph    canUnfollow    isFollowedByMe
    # or use aliases for a specific Graph    # canUnfollowOnMyGraph: canUnfollow(request: { graph: "0x123…" })    # isFollowedByMeOnMyGraph: isFollowedByMe(request: { graph: "0x123…" })  }}

If true, you can unfollow the account. If false, you might not be following them, in which case the operation.isFollowedByMe field will also be false.

2

Submit Unfollow Request

Then, if your unfollow request is allowed, you can proceed with submitting the request.

Use the unfollow mutation to submit an unfollow request.

mutation {  unfollow(    request: {      account: "0x1234567890abcdef1234567890abcdef12345678"
      # optional, defaults to the Global Graph      # graph: EvmAddress
      # optional, the required Graph Rule execution data, if any      # graphRule: GraphRulesInput    }  ) {    ... on UnfollowResponse {      hash    }
    ... on SponsoredTransactionRequest {      ...SponsoredTransactionRequest    }
    ... on SelfFundedTransactionRequest {      ...SelfFundedTransactionRequest    }
    ... on TransactionWillFail {      reason    }  }}

Finally, handle the result as explained in the Transaction Lifecycle guide.

Previous
Custom Feeds
Next
Follow Relationships