Verida Documentation
  • Welcome
  • Network Overview
  • Start Building
  • Verida Wallet
  • Whitepapers
  • Glossary
  • Protocol
    • Core concepts
      • Design Principles
      • Decentralized Identity
      • Confidential Databases
      • Confidential Compute
      • Accounts and Identity
      • Data Storage
      • Application Contexts
      • Messaging
      • Schemas
      • Data Sharing
    • Client SDK
      • Getting Started
      • How It Works
      • Authentication
      • Data
      • Queries
      • Permissions
      • Messaging
      • Account Profiles
      • Events
      • Command Line Tools
      • Configuration
      • React Native
      • Advanced
    • Verida Connect SDK
      • Getting Started
      • WebUser
      • WalletConnect Support
      • Authentication Server
    • Blockchain Bridge
    • Run a Node
      • Database Node
        • Setup
        • Operations
        • FAQ
      • Compute Node
    • Verida Networks
  • Extensions
    • Credentials
      • Verifiable Credentials Developer SDK
      • cheqd Credential Service
      • Privado ID (fmr Polygon ID)
      • zkPass credentials
      • Reclaim Protocol credential
    • Verida URIs
    • Vue Components
Powered by GitBook
On this page
  • Open messaging​
  • Fetching messages (Inbox)​
  • Get messages​
  • Listen for messages​
  • Sending messages (Outbox)​
  • Opening your app​
  • Setting avatar and name​
  • Built-in Message Types​
  • Examples​
  • Sending data​
  • Requesting data​

Was this helpful?

  1. Protocol
  2. Client SDK

Messaging

PreviousPermissionsNextAccount Profiles

Last updated 7 months ago

Was this helpful?

Every application has a built-in inbox for receiving messages and an outbox for sending messages. This allows users and applications to send data between each other knowing nothing than the other user’s DID and application name.

Learn more about the messaging architecture.

Open messaging

You can simply open the messaging capabilities for the currently connected application context as follows:

const messaging = await context.getMessaging()

Fetching messages (Inbox)

Get messages

You can retrieve the 20 most recent messages:

const messages = await messaging.getMessages()

Alternatively, specify optional filter and options parameters:

const filter = {
    type: 'inbox/dataRequest'
}
const options = {
  limit: 20,
  skip: 0,
  sort: [{ sentAt: 'desc' }]
}
const messages = await messaging.getMessages(filter, options)

Your application can register a callback function to listen for new inbox messages:

const listener = await messaging.onMessage(function(inboxEntry) {
    console.log('New inbox message received', inboxEntry)
})
  • type — The type of inbox entry. This references a full schema URL.

You can stop listening:

listener.cancel()

Your application can send messages to other accounts on the Verida network.

This example sends a contact record to a user’s Verida Wallet:

const did = 'did:vda:polyamoy:0x6B2a1bE81ee770cbB4648801e343E135e8D2Aa6F'
const type = 'inbox/type/dataSend'

// Generate an inbox message containing an array of data
const data = {
    data: [
        {
            firstName: 'Verida',
            lastName: 'Example',
            email: 'verida.example@example.com',
            schema: 'https://common.schemas.verida.io/social/contact/v0.1.0/schema.json'
        }
    ]
}
const message = 'Sending you a contact'
const config = {
    recipientContextName: 'Verida: Vault'
}

messaging.send(did, type, data, message, config)

This could be used in two scenarios:

  • A user sending their own data from one application they control to another

  • A user sending data to another user within the same application

The Verida account must have already logged in and created the application context before you can send it an inbox message. For example, assume you are sending an inbox message to an application context called “Verida: Documents”. If the recipient account has never logged into that context the inbox message will fail because that account has no inbox available.

It can be helpful if the Wallet opens your application in a web browser after the user accepts a message. You can enable this by providing an optional parameter to the config.

ie:

const config = {
    recipientContextName: 'Verida: Vault',
    openUrl: 'https://www.myapp.com/custom-page'
}

When sending an inbox message, the sender avatar and name are automatically loaded from the public profile of the sending Verida Account. You will need to set these for your account so they can be loaded by applications across the network (including the Verida Wallet).

You could add your Verida Account to the Verida Wallet and use the mobile app to set a profile avatar and name. This will then be the default for every application used by the sending Verida Account. Alternatively, you could manually set the profile information for the application context sending the inbox message. See Account Profiles for more information on how to achieve this.

Data can be sent to an account (see Outbox example above)

Data can be requested from an account:

const did = 'did:vda:polyamoy:0x6B2a1bE81ee770cbB4648801e343E135e8D2Aa6F'
const type = 'inbox/type/dataRequest'

// Generate an inbox message containing an array of data
const data = {
    requestSchema: 'https://common.schemas.verida.io/social/contact/v0.1.0/schema.json',
    filter: {},
    userSelect: true
}
const message = 'Please share your contact details'
const config = {
    recipientContextName: 'Verida: Vault'
}

messaging.send(did, type, data, message, config)

Options:

  • filter: A JSON filter to apply to the search when locating suitable data to share

  • userSelect: Boolean value indicating if the user can select the data to be returned. If false all matching data will be returned.

  • userSelectLimit: Integer limiting how many records a user can select.

Listen for messages

The inboxEntry object utilizes the . The two most important properties are:

data — The data contained in the inbox entry. This will be an object adhering to the schema specified in type. .

Sending messages (Outbox)

Opening your app

Setting avatar and name

Built-in Message Types

See for details on each supported inbox message type.

— Send one or many pieces of data to a user

— Request data from a user, supports optional filters and conditions around user’s selecting data

— Send a generic message / notification to a user

Examples

Sending data

Requesting data

​
​
​
​
inbox/entry schema
See a list of currently supported inbox types
​
​
​
​
core schemas repository
dataSend
dataRequest
message
​
​
​