Airstack Developer Docs & FAQs
Launch ExplorerAPI Studio
Ask or search…
⌃K
Links
Comment on page
📬

Has XMTP

Learn how to check if Lens profiles have XMTP enabled on their account or not.

📬 Has XMTP

​Airstack provides easy-to-use APIs for enriching Lens applications and integrating on-chain and off-chain data with Lens.
​XMTP is an Ethereum-based messaging protocol.
Developers building with XMTP can use Airstack to enable Lens users to seamlessly message Ethereum, ENS, Lens, and Farcaster users with XMTP-enabled addresses.
​Airstack is utilized to:
  1. 1.
    check if users have XMTP enabled (required in order to receive XMTP messages)
  2. 2.
    resolve Lens profile names or IDs to 0x Ethereum addresses and vice versa.

Table Of Contents

In this guide you will learn how to use Airstack to:

Pre-requisites

  • An Airstack account (free)
  • Basic knowledge of GraphQL

Get Started

JavaScript/TypeScript/Python
If you are using JavaScript/TypeScript or Python, Install the Airstack SDK:
npm
yarn
pnpm
pip
React
npm install @airstack/airstack-react
Node
npm install @airstack/node
React
yarn add @airstack/airstack-react
Node
yarn add @airstack/node
React
pnpm install @airstack/airstack-react
Node
pnpm install @airstack/node
pip install airstack
Then, add the following snippets to your code:
React
Node
Python
import { init, useQuery } from "@airstack/airstack-react";
​
init("YOUR_AIRSTACK_API_KEY");
​
const query = `YOUR_QUERY`; // Replace with GraphQL Query
​
const Component = () => {
const { data, loading, error } = useQuery(query);
​
if (data) {
return <p>Data: {JSON.stringify(data)}</p>;
}
​
if (loading) {
return <p>Loading...</p>;
}
​
if (error) {
return <p>Error: {error.message}</p>;
}
};
import { init, fetchQuery } from "@airstack/node";
​
init("YOUR_AIRSTACK_API_KEY");
​
const query = `YOUR_QUERY`; // Replace with GraphQL Query
​
const { data, error } = await fetchQuery(query);
​
console.log("data:", data);
console.log("error:", error);
import asyncio
from airstack.execute_query import AirstackClient
​
api_client = AirstackClient(api_key="YOUR_AIRSTACK_API_KEY")
​
query = """YOUR_QUERY""" # Replace with GraphQL Query
​
async def main():
execute_query_client = api_client.create_execute_query_object(
query=query)
​
query_response = await execute_query_client.execute_query()
print(query_response.data)
​
asyncio.run(main())
Other Programming Languages
To access the Airstack APIs in other languages, you can use https://api.airstack.xyz/gql as your GraphQL endpoint.

🤖 AI Natural Language​​

​Airstack provides an AI solution for you to build GraphQL queries to fulfill your use case easily. You can find the AI prompt of each query in the demo's caption or title for yourself to try.
Airstack AI (Demo)

Check Lens Profile Has XMTP Enabled

You can check if a Lens profile has XMTP enabled or not:

Try Demo

https://app.airstack.xyz/query/38TR2Gxuqf
Check Lens Profile has XMTP enabled (Demo)

Code

Query
Response
query MyQuery {
XMTPs(
input: { blockchain: ALL, filter: { owner: { _eq: "lens/@vitalik" } } }
) {
XMTP {
isXMTPEnabled
}
}
}
{
"data": {
"XMTPs": {
"XMTP": [
{
"isXMTPEnabled": true
}
]
}
}
}

Bulk Check Lens Profiles Have XMTP Enabled

You can bulk check a list of Lens profiles have XMTP enabled or not:

Try Demo

https://app.airstack.xyz/query/nNmMc2WyKr
Bulk Check If an Array of Lens Profiles Have XMTP (Demo)

Code

Query
Response
query BulkFetchLensProfilesHaveXMTP {
XMTPs(
input: {
blockchain: ALL
filter: {
owner: { _in: ["lens/@hoobastank", "lens/@22776", "lens_id:0x0187b3"] }
}
limit: 100
}
) {
XMTP {
isXMTPEnabled
owner {
socials(input: { filter: { dappName: { _eq: lens } } }) {
profileName
profileTokenId
profileTokenIdHex
userAssociatedAddresses
}
}
}
}
}
{
"data": {
"XMTPs": {
"XMTP": [
{
"isXMTPEnabled": true,
"owner": {
"socials": [
{
"profileName": "lens/@hoobastank",
"profileTokenId": "77099",
"profileTokenIdHex": "0x012d2b",
"userAssociatedAddresses": [
"0xf81c128e1c660d08c1f33ccd5a06d040a37245eb"
]
}
]
}
},
{
"isXMTPEnabled": true,
"owner": {
"socials": [
{
"profileName": "lens/@22776",
"profileTokenId": "38680",
"profileTokenIdHex": "0x09718",
"userAssociatedAddresses": [
"0x53af8473b558dc42275abcfcaaf3ce2fcbd2c727"
]
}
]
}
},
{
"isXMTPEnabled": true,
"owner": {
"socials": [
{
"profileName": "lens/@vitalik",
"profileTokenId": "100275",
"profileTokenIdHex": "0x0187b3",
"userAssociatedAddresses": [
"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
]
}
]
}
}
]
}
}
}

Get All 0x addresses of Lens profile(s)

You can resolve an array of Lens profile(s) to their 0x addresses for XMTP messaging and displayed in your XMTP application:

Try Demo

https://app.airstack.xyz/query/rmLiJWfGxh
Show 0x addresses of lens/@nader and Lens profile id 100275

Code

Query
Response
query GetAddressesOfLens {
Socials(
input: {
filter: {
identity: { _in: ["lens/@nader", "lens_id:0x0187b3"] }
dappName: { _eq: lens }
}
blockchain: ethereum
}
) {
Social {
profileName
profileTokenId
profileTokenIdHex
userAssociatedAddresses
}
}
}
{
"data": {
"Socials": {
"Social": [
{
"profileName": "lens/@nader",
"profileTokenId": "10402",
"profileTokenIdHex": "0x028a2",
"userAssociatedAddresses": [
"0xb2ebc9b3a788afb1e942ed65b59e9e49a1ee500d"
]
},
{
"profileName": "lens/@vitalik",
"profileTokenId": "100275",
"profileTokenIdHex": "0x0187b3",
"userAssociatedAddresses": [
"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
]
}
]
}
}
}

Get All Lens Profiles Owned by 0x address

You can resolve any 0x address to their Farcaster accounts for XMTP messaging and displayed in your XMTP application:

Try Demo

https://app.airstack.xyz/query/WAIEP13Nr5
Show Lens owned by Ethereum address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

Code

Query
Response
query GetLensOfEthereumAddress {
Socials(
input: {
filter: {
identity: { _in: ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"] }
dappName: { _eq: lens }
}
blockchain: ethereum
}
) {
Social {
profileName
profileTokenId
profileTokenIdHex
userAssociatedAddresses
}
}
}
​
"data": {
"Socials": {
"Social": [
{
"profileName": "lens/@vitalik",
"profileTokenId": "100275",
"profileTokenIdHex": "0x0187b3",
"userAssociatedAddresses": [
"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
]
}
]
}
}
}

Get Lens Followers of Lens Profile(s) that has XMTP Enabled

You can all the Lens followers of Lens profile(s) and see whether they have their XMTP enabled for messaging:

Try Demo

Code

Query
Response
query MyQuery {
SocialFollowers(
input: {filter: {dappName: {_eq: lens}, identity: {_in: ["lens/@stani", "lens_id:0x024", "vitalik.eth", "0xeaf55242a90bb3289dB8184772b0B98562053559"]}}, blockchain: ALL, limit: 200}
) {
Follower {
followerAddress {
addresses
socials {
profileName
profileTokenId
profileTokenIdHex
}
xmtp {
isXMTPEnabled # Indicate if followers have XMTP enabled
}
}
followerProfileId
followerTokenId
followingAddress {
addresses
domains {
name
}
socials {
profileName
profileTokenId
profileTokenIdHex
}
}
followingProfileId
}
}
}
// Some code

Get Lens Following of Lens Profile(s) that has XMTP Enabled

You can all the Lens following of Lens profile(s) and see whether they have their XMTP enabled for messaging:

Try Demo

Code

Query
Response
query MyQuery {
SocialFollowings(
input: {
filter: {
dappName: { _eq: lens }
identity: {
_in: [
"lens/@stani"
"lens_id:0x024"
"vitalik.eth"
"0xeaf55242a90bb3289dB8184772b0B98562053559"
]
}
}
blockchain: ALL
limit: 200
}
) {
Following {
followingAddress {
addresses
socials {
profileName
profileTokenId
profileTokenIdHex
}
xmtp {
isXMTPEnabled # Indicate if following have XMTP enabled
}
}
followingProfileId
followerAddress {
addresses
domains {
name
}
socials {
profileName
profileTokenId
profileTokenIdHex
}
}
followerProfileId
followerTokenId
}
}
}
// Some code

Developer Support

Developer Support

If you have any questions or need help regarding checking if Lens profile(s) have XMTP enabled, please join our Airstack's Telegram group.

More Resources

Previous
Lens Following
Next
Token Holders
Last modified 17h ago