API Reference

Interactive API docs located at: https://api.v2.walletchat.fun/docs/index.html

Full API reference is included here, subsections are broken out in the navigate pane. Current API version is: https://api.v2.walletchat.fun

Sign In with signed nonce value, currently JWT token returned should be valid for 24 hours

post

Every call the to API after this signin should present the JWT Bearer token for authenticated access. Upon request we can change the timeout to greater than 24 hours, or setup an addtional dedicated API for an agreed upon development and maintenance cost

Body

addressstringoptional

msgstringoptional

namestringoptional

noncestringoptional

sigstringoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/signin' \
  --header 'Content-Type: application/json' \
  --data '{
    "address": "text",
    "msg": "text",
    "name": "text",
    "nonce": "text",
    "sig": "text"
  }'

application/json

200

200

1

OK

If the current wallet doesn't have a valid local JWT, need to request a new nonce to sign

get

As part of the login process, we need a user to sign a nonce genrated from the API, to prove the user in fact the owner of the wallet they are siging in from. JWT currently set to 24 hour validity (could change this upon request)

Path parameters

addressanyrequired

wallet address to get nonce to sign

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/users/{address}/nonce'

200

200

No body

OK

CreateCommunityChatitem creates GroupChatitem just with community tag (likely could be consolidated)

post

Community Chat Data

Authorizations

Body

context_typestringoptional

fromaddrstringoptional

idintegeroptional

messagestringoptional

nftaddrstringoptional

sender_namestringoptional

timestampstringoptional

timestamp_dtmstringoptional

typestringoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/community' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "context_type": "text",
    "fromaddr": "text",
    "id": 1,
    "message": "text",
    "nftaddr": "text",
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "type": "text"
  }'

application/json

200

200

[
  {
    "context_type": "text",
    "fromaddr": "text",
    "id": 1,
    "message": "text",
    "nftaddr": "text",
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "type": "text"
  }
]

OK

Get Community Chat Landing Page Info

get

TODO: need a creation API for communities, which includes specificied welcome message text, Twitter handle, page title

Authorizations

Path parameters

addressanyrequired

Wallet Address

addressanyrequired

Wallet Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/community/{community}/{address}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "has_messaged": true,
    "is_verified": true,
    "joined": true,
    "logo": "text",
    "members": 1,
    "messages": [
      {
        "context_type": "text",
        "fromaddr": "text",
        "id": 1,
        "message": "text",
        "nftaddr": "text",
        "sender_name": "text",
        "timestamp": "text",
        "timestamp_dtm": "text",
        "type": "text"
      }
    ],
    "name": "text",
    "social": [
      {
        "type": "text",
        "username": "text"
      }
    ],
    "tweets": [
      {
        "attachments": {
          "media_keys": [
            "text"
          ]
        },
        "author_id": "text",
        "created_at": "text",
        "id": "text",
        "media": {
          "media_keys": [
            "text"
          ]
        },
        "text": "text",
        "user": {
          "id": "text",
          "name": "text",
          "profile_image_url": "text",
          "username": "text"
        }
      }
    ]
  }
]

OK

Join an NFT or Community group chat

post

Bookmarks keep an NFT/Community group chat in the sidebar

Authorizations

Body

chainstringoptional

idintegeroptional

nftaddrstringoptional

walletaddrstringoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/create_bookmark' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "chain": "text",
    "id": 1,
    "nftaddr": "text",
    "walletaddr": "text"
  }'

application/json

200

200

[
  {
    "chain": "text",
    "id": 1,
    "nftaddr": "text",
    "walletaddr": "text"
  }
]

OK

Create/Insert DM Chat Message (1-to-1 messaging)

post

For DMs, Chatitem data struct is used to store each message and associated info. REQUIRED: fromaddr, toaddr, message (see data struct section at bottom of page for more detailed info on each paramter) Other fields are generally filled in by the backed REST API and used as return parameters ID is auto generated and should never be used as input.

Authorizations

Body

encrypted_sym_lit_keystringoptional

USE IF USING LIT ENCRYPTION

fromaddrstringrequired

*** REQUIRED INPUT ***

idintegeroptional

AUTO-GENERATED (PRIMARY KEY)

lit_access_conditionsstringoptional

messagestringrequired

*** REQUIRED INPUT ***

nftaddrstringoptional

ONLY USED FOR NFT DM CONTEXT

nftidstringoptional

ONLY USED FOR NFT DM CONTEXT

readbooleanoptional

DEFAULT FALSE

sender_namestringoptional

AUTO-SET BY BACKED FOR RETURN VALUE

timestampstringoptional

AUTO-SET BY REST API

timestamp_dtmstringoptional

USED FOR SORTING WHEN TIME FORMAT NEEDED

toaddrstringrequired

*** REQUIRED INPUT ***

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/create_chatitem' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }'

application/json

200

200

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

OK

Comments are used within an NFT community chat

post

Comments are meant to be public, someday having an up/downvote method for auto-moderation

Authorizations

Body

fromaddrstringoptional

idintegeroptional

messagestringoptional

namestringoptional

nftaddrstringoptional

nftidintegeroptional

timestampstringoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/create_comments' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "fromaddr": "text",
    "id": 1,
    "message": "text",
    "name": "text",
    "nftaddr": "text",
    "nftid": 1,
    "timestamp": "text"
  }'

application/json

200

200

[
  {
    "fromaddr": "text",
    "id": 1,
    "message": "text",
    "name": "text",
    "nftaddr": "text",
    "nftid": 1,
    "timestamp": "text"
  }
]

OK

CreateCommunity creates new custom community chat

post

Community Chat Creation

Authorizations

Body

communitystringoptional

socialobject[]optional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/create_community' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "community": "text",
    "social": [
      {
        "name": "text",
        "type": "text"
      }
    ]
  }'

application/json

200

200

[
  {
    "community": "text",
    "social": [
      {
        "name": "text",
        "type": "text"
      }
    ]
  }
]

OK

Create/Insert chat message for Community/NFT/Group Messaging

post

Currently used for all messages outside of DMs

Authorizations

Body

context_typestringoptional

fromaddrstringoptional

idintegeroptional

messagestringoptional

nftaddrstringoptional

sender_namestringoptional

timestampstringoptional

timestamp_dtmstringoptional

typestringoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/create_groupchatitem' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "context_type": "text",
    "fromaddr": "text",
    "id": 1,
    "message": "text",
    "nftaddr": "text",
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "type": "text"
  }'

application/json

200

200

[
  {
    "context_type": "text",
    "fromaddr": "text",
    "id": 1,
    "message": "text",
    "nftaddr": "text",
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "type": "text"
  }
]

OK

Leave an NFT or Community group chat

post

Bookmarks keep an NFT/Community group chat in the sidebar

Authorizations

Body

chainstringoptional

idintegeroptional

nftaddrstringoptional

walletaddrstringoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/delete_bookmark' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "chain": "text",
    "id": 1,
    "nftaddr": "text",
    "walletaddr": "text"
  }'

application/json

200

200

[
  {
    "chain": "text",
    "id": 1,
    "nftaddr": "text",
    "walletaddr": "text"
  }
]

OK

Delete Single Chat Item (DM)

delete

Can only delete messages sent, cannot delete incoming messages

Authorizations

Path parameters

idanyrequired

message ID

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url '/v1/delete_chatitem/{id}' \
  --header 'Authorization: YOUR_API_KEY'

204

204

No body

No Content

Delete Public Comments for given FROM wallet address, NFT Contract and ID

delete

NFTs have a public comment section

Authorizations

Path parameters

addressanyrequired

FROM Wallet Address

nftaddranyrequired

NFT Contract Address

nftidanyrequired

NFT ID

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url '/v1/delete_comments/{fromaddr}/{nftaddr}/{nftid}' \
  --header 'Authorization: YOUR_API_KEY'

204

204

No body

No Content

Delete Settings Info

delete

TODO: not yet used

Authorizations

Path parameters

addressanyrequired

Wallet Address

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url '/v1/delete_settings/{address}' \
  --header 'Authorization: YOUR_API_KEY'

204

204

No body

No Content

Delete All Chat Items (DMs) between FROM and TO given addresses

delete

Currently deletes all chat items between these two addresses

Authorizations

Path parameters

toaddranyrequired

TO: Address

fromaddranyrequired

FROM: Address

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url '/v1/deleteall_chatitems/{fromaddr}/{toaddr}' \
  --header 'Authorization: YOUR_API_KEY'

204

204

No body

No Content

Check if a wallet address has bookmarked/joined given NFT contract

get

This used for UI purposes, checking if a user/wallet has bookmarked a community.

Authorizations

Path parameters

addressanyrequired

Wallet Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/get_bookmarks/{address}/' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "chain": "text",
    "id": 1,
    "nftaddr": "text",
    "walletaddr": "text"
  }
]

OK

Check if a wallet address has bookmarked/joined given NFT contract

get

This used for UI purposes, checking if a user/wallet has bookmarked a community.

Authorizations

Path parameters

walletaddranyrequired

Wallet Address

nftaddranyrequired

NFT Contract Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/get_bookmarks/{walletaddr}/{nftaddr}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

No body

OK

Get Public Comments for given NFT Contract and ID

get

NFTs have a public comment section

Authorizations

Path parameters

addressanyrequired

Wallet Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/get_comments/{nftaddr}/{nftid}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "fromaddr": "text",
    "id": 1,
    "message": "text",
    "name": "text",
    "nftaddr": "text",
    "nftid": 1,
    "timestamp": "text"
  }
]

OK

Get Public Comments Count for given NFT Contract and ID

get

NFTs have a public comment section

Authorizations

Path parameters

nftaddranyrequired

NFT Contract Address

nftidanyrequired

NFT ID

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/get_comments_cnt/{nftaddr}/{nftid}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

1

OK

Get group chat items, given a wallt FROM address and NFT Contract Address

get

Get all group chat items for a given wallet (useraddress) for a given NFT Contract Address (TODO: fix up var names)

Authorizations

Path parameters

addressanyrequired

NFT Address

useraddressanyrequired

FROM: wallet address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/get_groupchatitems/{address}/{useraddress}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "context_type": "text",
    "fromaddr": "text",
    "id": 1,
    "message": "text",
    "nftaddr": "text",
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "type": "text"
  }
]

OK

Get Unread Groupchat Items (TODO: cleanup naming convention here)

get

For group chat unread counts, currently the database stores a timestamp for each time a user enters a group chat. We though in the design it would be impractical to keep a read/unread count copy per user per message, but if this method doesn't proof to be fine grained enough, we could add a boolean relational table of read messgages per user.

Path parameters

nameanyrequired

Common Name Mapped to User/Community

Responses

text/plain

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/get_groupchatitems_unreadcnt/{address}/{useraddress}'

200

200

1

OK

Get Inbox Summary With Last Message

get

Get Each 1-on-1 Conversation, NFT and Community Chat For Display in Inbox

Authorizations

Path parameters

addressanyrequired

Wallet Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/get_inbox/{address}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "chain": "text",
    "context_type": "text",
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "logo": "text",
    "message": "text",
    "name": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text",
    "type": "text",
    "unread": 1
  }
]

OK

Get Settings Info

get

TODO: not yet used

Authorizations

Path parameters

addressanyrequired

Wallet Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/get_settings/{address}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "domain": "text",
    "email": "text",
    "id": 1,
    "notify24": "text",
    "notifydm": "text",
    "signupsite": "text",
    "verified": "text",
    "walletaddr": "text"
  }
]

OK

Get all unread messages TO a specific user, used for total count notification at top notification bar

get

Get Each 1-on-1 Conversation, NFT and Community Chat For Display in Inbox

Authorizations

Path parameters

addressanyrequired

Wallet Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/get_unread_cnt/{address}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

1

OK

Get all unread messages for a specific NFT context

get

Get Unread count for specifc NFT context given a wallet address and specific NFT

Authorizations

Path parameters

addressanyrequired

Wallet Address

nftaddranyrequired

NFT Contract Address

nftidanyrequired

NFT ID

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/get_unread_cnt/{address}/{nftaddr}/{nftid}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

1

OK

Get all unread messages between two addresses

get

Get Unread count for DMs

Authorizations

Path parameters

toaddranyrequired

TO: Wallet Address

fromanyrequired

FROM: Wallet Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/get_unread_cnt/{fromaddr}/{toaddr}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

1

OK

Get all unread messages TO a specific user, used for total count notification at top notification bar

get

Get Each 1-on-1 Conversation, NFT and Community Chat For Display in Inbox

Authorizations

Path parameters

addressanyrequired

Wallet Address

typeanyrequired

Message Type - nft|community|dm|all

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/get_unread_cnt_by_type/{address}/{type}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

1

OK

Get all unread messages for all NFT related chats for given user

get

Get Unread count for all NFT contexts given a wallet address

Authorizations

Path parameters

addressanyrequired

Wallet Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/get_unread_cnt_nft/{address}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

1

OK

Get Chat Item For Given Wallet Address

get

Get all Chat Items for DMs for a given wallet address

Authorizations

Path parameters

toaddranyrequired

Wallet Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/getall_chatitems/{address}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

OK

Get Chat Data Between Two Addresses

get

Get chat data between the given two addresses, TO and FROM and interchangable here

Authorizations

Path parameters

toaddranyrequired

TO: Wallet Address

fromanyrequired

FROM: Wallet Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/getall_chatitems/{fromaddr}/{toaddr}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

OK

Get Chat Data Between Two Addresses

get

Get chat data between the given two addresses, TO and FROM and interchangable here

Authorizations

Path parameters

toaddranyrequired

TO: Wallet Address

fromanyrequired

FROM: Wallet Address

timeanyrequired

Load only messages after this time

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/getall_chatitems/{fromaddr}/{toaddr}/${time}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

OK

Get NFT Related Chat Items For Given Wallet Address

get

Get ALL NFT context items for a given wallet address

Authorizations

Path parameters

toaddranyrequired

Wallet Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/getnft_chatitems/{address}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

OK

Get NFT Related Chat Items For Given NFT Contract and ID, relating to one wallet

get

Get all specified NFT contract and ID items for a given wallet address

Authorizations

Path parameters

addressanyrequired

Wallet Address

nftaddranyrequired

NFT Contract Address

nftidanyrequired

NFT ID

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/getnft_chatitems/{address}/{nftaddr}/{nftid}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

OK

Get NFT Related Chat Items For Given NFT Contract and ID, between two wallet addresses (TO and FROM are interchangable)

get

Get ALL NFT context items for a specifc NFT context convo between two wallets

Authorizations

Path parameters

nftaddranyrequired

NFT Contract Address

nftidanyrequired

NFT ID

toaddranyrequired

TO: Wallet Address

fromanyrequired

FROM: Wallet Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/getnft_chatitems/{fromaddr}/{toaddr}/{nftaddr}/{nftid}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

OK

Get NFT Related Chat Items For Given NFT Contract and ID

get

Get ALL NFT context items for a given wallet address

Authorizations

Path parameters

nftaddranyrequired

NFT Contract Address

nftidanyrequired

NFT ID

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/getnft_chatitems/{nftaddr}/{nftid}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

OK

Get Recently Read Messages

get

Get newly read messages to update READ status for lazy loading

Authorizations

Path parameters

toaddranyrequired

TO: Wallet Address

fromanyrequired

FROM: Wallet Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/getread_chatitems/{fromaddr}/{toaddr}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

OK

Store Image in DB for later user

post

Currently used for the WC HQ Logo, stores the base64 raw data of the profile image for a community

Authorizations

Body

addrstringoptional

base64datastringoptional

idintegeroptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/image' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "addr": "text",
    "base64data": "text",
    "id": 1
  }'

application/json

200

200

[
  {
    "addr": "text",
    "base64data": "text",
    "id": 1
  }
]

OK

Store Image in DB for later user (update existing photo)

put

Currently used for the WC HQ Logo, stores the base64 raw data of the profile image for a community

Authorizations

Body

addrstringoptional

base64datastringoptional

idintegeroptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url '/v1/image' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "addr": "text",
    "base64data": "text",
    "id": 1
  }'

application/json

200

200

[
  {
    "chain": "text",
    "id": 1,
    "nftaddr": "text",
    "walletaddr": "text"
  }
]

OK

Get Thumbnail Image Data

get

Retreive image data for use with user/community/nft group dislayed icon

Authorizations

Path parameters

nameanyrequired

Wallet/NFT Address Mapped to User/Community

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/image/{addr}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "addr": "text",
    "base64data": "text",
    "id": 1
  }
]

OK

Store Image in Bucket Storage

post

public facing PFP storage to make it faster for UI to get and load images

Authorizations

Body

addrstringoptional

base64datastringoptional

idintegeroptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/imagepfp' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "addr": "text",
    "base64data": "text",
    "id": 1
  }'

application/json

200

200

[
  {
    "addr": "text",
    "base64data": "text",
    "id": 1
  }
]

OK

Check if given wallet address owns an NFT from given contract address

get

API user could check this directly via any third party service like NFTPort, Moralis as well

Authorizations

Path parameters

contractanyrequired

NFT Contract Address

walletanyrequired

Wallet Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/is_owner/{contract}/{wallet}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "has_messaged": true,
    "is_verified": true,
    "joined": true,
    "logo": "text",
    "members": 1,
    "messages": [
      {
        "context_type": "text",
        "fromaddr": "text",
        "id": 1,
        "message": "text",
        "nftaddr": "text",
        "sender_name": "text",
        "timestamp": "text",
        "timestamp_dtm": "text",
        "type": "text"
      }
    ],
    "name": "text",
    "social": [
      {
        "type": "text",
        "username": "text"
      }
    ],
    "tweets": [
      {
        "attachments": {
          "media_keys": [
            "text"
          ]
        },
        "author_id": "text",
        "created_at": "text",
        "id": "text",
        "media": {
          "media_keys": [
            "text"
          ]
        },
        "text": "text",
        "user": {
          "id": "text",
          "name": "text",
          "profile_image_url": "text",
          "username": "text"
        }
      }
    ]
  }
]

OK

give a common name to a user address, or NFT collection

post

Give a common name (Kevin.eth, BillyTheKid, etc) to an Address

Authorizations

Body

addressstringoptional

ADDRESS

domainstringoptional

DOMAIN

idintegeroptional

namestringoptional

NAME

signupsitestringoptional

SITE USER SIGNED UP FROM

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/name' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "address": "text",
    "domain": "text",
    "id": 1,
    "name": "text",
    "signupsite": "text"
  }'

application/json

200

200

1

OK

get the common name which has been mapped to an address

get

get the given a common name (Kevin.eth, BillyTheKid, etc) what has already been mapped to an Address

Authorizations

Path parameters

addressanyrequired

Get Name for given address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/name/{name}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "address": "text",
    "id": 1,
    "name": "text"
  }
]

OK

Get all unread messages TO a specific user, used for total count notification at top notification bar

get

Get Unread count just given an address

Authorizations

Path parameters

addressanyrequired

Wallet Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/unreadcount/{address}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

1

OK

Update Message Read Status of a given DM chat message

put

Currently this only update the message read/unread status. It could update the entire JSON struct upon request, however we only needed this functionality currently and it saved re-encryption of the data. TODO: TO/FROM address in the URL is not needed/not used anymore.

Authorizations

Body

encrypted_sym_lit_keystringoptional

USE IF USING LIT ENCRYPTION

fromaddrstringrequired

*** REQUIRED INPUT ***

idintegeroptional

AUTO-GENERATED (PRIMARY KEY)

lit_access_conditionsstringoptional

messagestringrequired

*** REQUIRED INPUT ***

nftaddrstringoptional

ONLY USED FOR NFT DM CONTEXT

nftidstringoptional

ONLY USED FOR NFT DM CONTEXT

readbooleanoptional

DEFAULT FALSE

sender_namestringoptional

AUTO-SET BY BACKED FOR RETURN VALUE

timestampstringoptional

AUTO-SET BY REST API

timestamp_dtmstringoptional

USED FOR SORTING WHEN TIME FORMAT NEEDED

toaddrstringrequired

*** REQUIRED INPUT ***

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url '/v1/update_chatitem/{fromaddr}/{toaddr}' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }'

application/json

200

200

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

OK

Settings hold a user address and the email address for notifications if they opt-in

post

Update settings, email address, daily notifications and per DM notifications

Authorizations

Body

domainstringoptional

DOMAIN

emailstringoptional

Publickey string json:"publickey"

idintegeroptional

AUTO-GENERATED (PRIMARY KEY)

notify24stringoptional

RECEIVE NOTIFICATION FOR EVERY DM RECEIVED (string value true/false)

notifydmstringoptional

RECEIVE DAILY NOTIFICATION SUMMARY EMAIL (string value true/false)

signupsitestringoptional

LATEST SITE WHERE NOTIFICATIONS EMAIL WAS ENTERED

verifiedstringoptional

USER CONFIRMED EMAIL OR NOT (string value true/false)

walletaddrstringrequired

*** REQUIRED INPUT ***

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/update_settings' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "domain": "text",
    "email": "text",
    "id": 1,
    "notify24": "text",
    "notifydm": "text",
    "signupsite": "text",
    "verified": "text",
    "walletaddr": "text"
  }'

application/json

200

200

[
  {
    "domain": "text",
    "email": "text",
    "id": 1,
    "notify24": "text",
    "notifydm": "text",
    "signupsite": "text",
    "verified": "text",
    "walletaddr": "text"
  }
]

OK

Link a user can click in email to verify email address, will have unique code

get

Users will get an email when signing-up to verify email, to ensure we do not send spam

Authorizations

Body

domainstringoptional

DOMAIN

emailstringoptional

Publickey string json:"publickey"

idintegeroptional

AUTO-GENERATED (PRIMARY KEY)

notify24stringoptional

RECEIVE NOTIFICATION FOR EVERY DM RECEIVED (string value true/false)

notifydmstringoptional

RECEIVE DAILY NOTIFICATION SUMMARY EMAIL (string value true/false)

signupsitestringoptional

LATEST SITE WHERE NOTIFICATIONS EMAIL WAS ENTERED

verifiedstringoptional

USER CONFIRMED EMAIL OR NOT (string value true/false)

walletaddrstringrequired

*** REQUIRED INPUT ***

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/verify_email/{email}/{verification_code}' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "domain": "text",
    "email": "text",
    "id": 1,
    "notify24": "text",
    "notifydm": "text",
    "signupsite": "text",
    "verified": "text",
    "walletaddr": "text"
  }'

application/json

200

200

[
  {
    "domain": "text",
    "email": "text",
    "id": 1,
    "notify24": "text",
    "notifydm": "text",
    "signupsite": "text",
    "verified": "text",
    "walletaddr": "text"
  }
]

OK