Social Account

The ISME SDK provides social account verification, through which the authentication of social accounts becomes simple, which bind with the DID through the social model. It currently supports the verification of Twitter accounts. If it supports other social accounts in the future, the process will be similar, the basic steps being as follows:

Create Verifier

Before using it, you need to create a verifier instance

import { ISMEVerifier } from '@ismelabs/client'
import { useISME } from '@ismelabs/did-manager'

export default function VerifierDemo() {
  const { client } = useISME()

  const verifier = useMemo(() => {
    return new ISMEVerifier(client, 'https://t0.onebitdev.com/nft3-verifier/')
  }, [client])

  const requestTwitter = async () => {
    const info = await verifier.requestTwitter()
    window.open(info.link)
  }
}

After calling requestTwitter, the SDK will create the details needed to verify the Twitter account, including:

• link - the link that needs to jump to Twitter, which contains the content of the tweet that needs to be posted
• text - the content of the tweet to be posted
• msghash - tweet content hash

Post Tweet

After getting the previous details, jump to link and post a public tweet that contains the text information without additional modification

info

The principle of Twitter account verification is that the ISME Gateway generates a DID signed credential, and then the user publishes a public tweet. The Gateway then reads the public tweet of the specified account. If the previously generated credentials are found, it is determined that the current DID user has The Twitter account. If the tweets are not publicly visible, verification will fail.

Verify Tweet

To verify the tweet, you need to provide the Twitter account name and the msghash. The sample code is as follows

import { ISMEVerifier } from '@ismelabs/client'
import { useISME } from '@ismelabs/did-manager'

export default function VerifierDemo() {
  const { client } = useISME()

  const verifier = useMemo(() => {
    return new ISMEVerifier(client, 'https://t0.onebitdev.com/nft3-verifier/')
  }, [client])

  const verifyTwitter = async () => {
    const result = await client.verifyTwitter('my_twitter_account', '0xe210debb1bad992a0dc373a95f4fbd2d04024d302e498486b214c0af8666f261')
    console.log(result)
  }
}

If the verification is successful, the verification result of the Gateway signature will be returned, which contains multiple fields.

Save Result

After finishing the verification, the result will be saved. The social model introduced in the previous section is designed with this in mind.

import { useState, useMemo } from 'react'
import { ISMEVerifier } from '@ismelabs/client'
import { useISME } from '@ismelabs/did-manager'

export default function VerifierDemo() {
  const { client, account } = useISME()
  const [msghash, setMsghash] = useState('')

  const verifier = useMemo(() => {
    return new ISMEVerifier(client, 'https://t0.onebitdev.com/nft3-verifier/')
  }, [client])

  const requestTwitter = async () => {
    const info = await verifier.requestTwitter()
    setMsghash(info.msghash)
    window.open(info.link)
  }

  const verifyTwitter = async () => {
    const result = await verifier.verifyTwitter('my_twitter_account', msghash)
    await verifier.addTwitter({
      account: account!,
      type: 'twitter',
      proof: result.proof,
      verifier_key: result.verifier_key,
      msghash
    })
  }
}

Verify Result

When displaying the social account on a DID user page, it needs to verify whether the current DID has the ownership of the social account. Since the social data records are controlled and written by the DID user, it needs to verify the verification records. Whether the signature is issued by Gateway, the sample code is as follows:

import { useMemo } from 'react'
import { ISMEVerifier } from '@ismelabs/client'
import { useISME } from '@ismelabs/did-manager'

export default function VerifierDemo() {
  const { client, identifier } = useISME()

  const verifier = useMemo(() => {
    return new ISMEVerifier(client, 'https://t0.onebitdev.com/nft3-verifier/')
  }, [client])

  const list = async () => {
    const items = await client.socialAccount.list(identifier)
    const rows = items.map(item => ({
      ...item,
      verified: verifier.verifyProof({
        did: identifier || '',
        account: item.account,
        type: item.type,
        proof: item.proof,
        verifier_key: item.verifier_key
      })
    }))
    console.log(rows)
  }
}