Class Identities

constructor

• new Identities(): Identities

• Returns Identities

formats

addDiscordIdentity

• addDiscordIdentity(demos, payload, referralCode?): Promise<RPCResponseWithValidityData>

• Add a discord identity to the GCR.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • payload: DiscordProof

    The payload to add the identity to.
  • OptionalreferralCode: string

  Returns Promise<RPCResponseWithValidityData>

  The response from the RPC call.

addDomainIdentity

• addDomainIdentity(demos, hostname, referralCode?): Promise<RPCResponseWithValidityData>

• Add a domain identity to the GCR (CCI).

  Proves the connected wallet controls a web domain by pointing at a well-known file the owner hosts: https://<host>/.well-known/demos-cci.txt. The file body must be the payload from createDomainProofPayload. The node fetches the file over HTTPS (the TLS cert binds the content to the hostname), verifies the signed payload against the sender, and writes a web2.domain entry on the CCI.

  Mirrors addTwitterIdentity.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • hostname: string

    The domain being claimed (e.g. "example.com"). A full URL is also accepted; only the hostname is used.
  • OptionalreferralCode: string

    Optional referral code for incentive points.

  Returns Promise<RPCResponseWithValidityData>

  The response from the RPC call.

  Example

  const identities = new Identities()
  // 1. Generate the proof the user hosts at /.well-known/demos-cci.txt
  const proof = await identities.createDomainProofPayload(demos)
  // 2. After the file is live, link the domain:
  await identities.addDomainIdentity(demos, "example.com")
  Copy

addEthosIdentity

• addEthosIdentity(demos, payload): Promise<RPCResponseWithValidityData>

• Link an Ethos wallet identity to the GCR.

  Parameters

  • demos: Demos

    A Demos instance used to communicate with the RPC.
  • payload: EthosWalletIdentity

    The Ethos wallet identity data to be linked.

  Returns Promise<RPCResponseWithValidityData>

  The RPC response for the identity inference operation.

addGithubIdentity

• addGithubIdentity(demos, payload, referralCode?): Promise<RPCResponseWithValidityData>

• Add a github identity to the GCR.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • payload: GithubProof

    The payload to add the identity to.
  • OptionalreferralCode: string

  Returns Promise<RPCResponseWithValidityData>

  The response from the RPC call.

addHumanPassportIdentity

• addHumanPassportIdentity(demos, payload): Promise<RPCResponseWithValidityData>

• Link a Human Passport identity to the GCR.

  Verifies the Human Passport score via the node and persists the identity if the score meets the threshold (default: 20).

  Parameters

  • demos: Demos

    A Demos instance used to communicate with the RPC.
  • payload: HumanPassportIdentityData

    The Human Passport identity data to be linked.

  Returns Promise<RPCResponseWithValidityData>

  The RPC response for the identity inference operation.

  Example

  const result = await identities.addHumanPassportIdentity(demos, {
      address: "0x...",
      verificationMethod: "api"
  })
  Copy

addNomisIdentity

• addNomisIdentity(demos, payload): Promise<RPCResponseWithValidityData>

• Link a Nomis wallet identity to the GCR.

  Infers and persists the Nomis identity using the provided Nomis wallet identity payload.

  Parameters

  • demos: Demos

    A Demos instance used to communicate with the RPC.
  • payload: NomisWalletIdentity

    The Nomis wallet identity data to be linked.

  Returns Promise<RPCResponseWithValidityData>

  The RPC response for the identity inference operation.

addTelegramIdentity

• addTelegramIdentity(demos, payload, referralCode?): Promise<RPCResponseWithValidityData>

• Add a telegram identity to the GCR. This method is designed to work with telegram bot attestations.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • payload: TelegramSignedAttestation

    The telegram identity payload containing user and bot signatures.
  • OptionalreferralCode: string

    Optional referral code for incentive points.

  Returns Promise<RPCResponseWithValidityData>

  The response from the RPC call.

addTwitterIdentity

• addTwitterIdentity(demos, payload, referralCode?): Promise<RPCResponseWithValidityData>

• Add a twitter identity to the GCR.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • payload: `https://x.com/${string}/${string}`

    The payload to add the identity to.
  • OptionalreferralCode: string

  Returns Promise<RPCResponseWithValidityData>

  The response from the RPC call.

addUnstoppableDomainIdentity

• addUnstoppableDomainIdentity(demos, signingAddress, signature, challenge, resolutionData, referralCode?): Promise<RPCResponseWithValidityData>

• Add an Unstoppable Domain identity to the GCR.

  Flow:

  1. User selects an authorized address from their domain records
  2. User signs challenge with their wallet (MetaMask for EVM, Phantom for Solana)
  3. Submit domain + signature for verification

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC
  • signingAddress: string

    The address used to sign (from domain's authorized addresses)
  • signature: string

    Signature from the signing address
  • challenge: string
  • resolutionData: UnifiedDomainResolution
  • OptionalreferralCode: string

    Optional referral code

  Returns Promise<RPCResponseWithValidityData>

  The response from the RPC call

  Example

  const identities = new Identities()
  // Get signable addresses for the domain
  const addresses = await identities.getUDSignableAddresses("brad.crypto")
  const signingAddress = addresses[0].address // User selects address
  
  // Generate challenge with selected address
  const challenge = identities.generateUDChallenge(demos.publicKey, signingAddress)
  
  // User signs challenge (EVM example with MetaMask)
  const signature = await ethereum.request({
      method: 'personal_sign',
      params: [challenge, signingAddress]
  })
  
  await identities.addUnstoppableDomainIdentity(
      demos,
      "brad.crypto",
      signingAddress,
      signature,
      challenge
  )
  Copy

addWeb2IdentityViaTLSN

• addWeb2IdentityViaTLSN(demos, context, proof, recvHash, proofRanges, revealedRecv, username, userId, referralCode?): Promise<RPCResponseWithValidityData>

• Add a Web2 identity via TLSNotary attestation.

  This generic method uses a cryptographic proof from TLSNotary to verify identity ownership. The context determines which platform's API was attested:

  • "github": api.github.com/user
  • "discord": discord.com/api/users/@me
  • "telegram": backend's /api/telegram/user

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • context: TLSNIdentityContext

    The platform context ("github", "discord", or "telegram").
  • proof: TLSNotaryPresentation

    The TLSNotary presentation (from attestResult.presentation).
  • recvHash: string
  • proofRanges: TLSNProofRanges
  • revealedRecv: number[]
  • username: string

    Username from the proven response.
  • userId: string | number

    User ID from the proven response.
  • OptionalreferralCode: string

    Optional referral code.

  Returns Promise<RPCResponseWithValidityData>

  The response from the RPC call.

bindPqcIdentity

• bindPqcIdentity(demos, algorithms?): Promise<RPCResponseWithValidityData>

• Parameters

  • demos: Demos
  • algorithms: PQCAlgorithm[] | "all" = "all"

  Returns Promise<RPCResponseWithValidityData>

createDomainProofPayload

• createDomainProofPayload(demos, hostname): Promise<string>

• Build the proof payload a domain owner must host to prove control.

  Host the returned string at https://<host>/.well-known/demos-cci.txt, then call addDomainIdentity. The format is identical to the web2 proof payload, so the node verifies it with the same parser.

  The signed message is domain-separated and bound to the host + signer (dacs-domain:v1:<host>:<ed25519Address>), so a signature cannot be lifted across domains, identities, or web2 contexts (node #897 / DEM-767). NOTE: the exact message shape MUST stay in lockstep with the node's verifyWeb2Proof reconstruction. Freshness (nonce/issuedAt) is the Tier-2 follow-up tracked in DEM-767.

  Parameters

  • demos: Demos

    A connected Demos instance.
  • hostname: string

    The domain this proof is for (e.g. "example.com"). Must be the same domain later passed to addDomainIdentity.

  Returns Promise<string>

  The proof payload string (demos:dw2p:<algorithm>:<signature>).

createWeb2ProofPayload

• createWeb2ProofPayload(demos): Promise<string>

• Create a web2 proof payload for use with web2 identity inference.

  Parameters

  • demos: Demos

  Returns Promise<string>

  The web2 proof payload string.

generateUDChallenge

• generateUDChallenge(demosPublicKey, signingAddress): string

• Generate a challenge message for Unstoppable Domain ownership verification.

  The user must sign this challenge with one of their domain's authorized addresses using MetaMask (EVM) or Phantom (Solana) wallet.

  Parameters

  • demosPublicKey: string

    The user's Demos public key (hex string)
  • signingAddress: string

    The address that will sign the challenge (from domain's authorized addresses)

  Returns string

  Challenge message to be signed

getDemosIdsByDiscord

• getDemosIdsByDiscord(demos, username, userId?): Promise<Account[]>

• Get demos accounts by linked discord identity.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • username: string

    The username to get the account for.
  • OptionaluserId: string

    The user id to get the account for.

  Returns Promise<Account[]>

  The account associated with the identity.

getDemosIdsByGithub

• getDemosIdsByGithub(demos, username, userId?): Promise<Account[]>

• Get demos accounts by linked github identity.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • username: string

    The username to get the account for.
  • OptionaluserId: string

    The user id to get the account for.

  Returns Promise<Account[]>

  The account associated with the identity.

getDemosIdsByIdentity

• getDemosIdsByIdentity(demos, identity): Promise<Account[]>

• Get demos accounts by linked web2 or web3 identity.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • identity: FindDemosIdByWeb2IdentityQuery | FindDemosIdByWeb3IdentityQuery

    The identity to get the account for.

  Returns Promise<Account[]>

  The account associated with the identity.

getDemosIdsByTelegram

• getDemosIdsByTelegram(demos, username, userId?): Promise<Account[]>

• Get demos accounts by linked telegram identity.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • username: string

    The username to get the account for.
  • OptionaluserId: string

    The user id to get the account for.

  Returns Promise<Account[]>

  The account associated with the identity.

getDemosIdsByTwitter

• getDemosIdsByTwitter(demos, username, userId?): Promise<Account[]>

• Get demos accounts by linked twitter identity.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • username: string

    The username to get the account for.
  • OptionaluserId: string

  Returns Promise<Account[]>

  The account associated with the username.

getDemosIdsByWeb2Identity

• getDemosIdsByWeb2Identity(demos, context, username, userId?): Promise<Account[]>

• Get demos accounts by linked web2 identity.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • context:
        | "github"
        | "twitter"
        | "telegram"
        | "discord"

    The context of the identity to get the account for.
  • username: string

    The username to get the account for.
  • OptionaluserId: string

    The user id to get the account for.

  Returns Promise<Account[]>

  The account associated with the identity.

getDemosIdsByWeb3Identity

• getDemosIdsByWeb3Identity(demos, chain, address): Promise<Account[]>

• Get demos accounts by linked web3 identity.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • chain: `${string}.${string}`

    The chain as a string containing the chain and subchain separated by a period (eg. "eth.mainnet" | "solana.mainnet", etc.)
  • address: string

    The address to get the account for.

  Returns Promise<Account[]>

  The account associated with the identity.

getEthosIdentities

• getEthosIdentities(demos, address?): Promise<RPCResponse>

• Get the Ethos identities associated with an address.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • Optionaladdress: string

    The address to get identities for. Defaults to the connected wallet's address.

  Returns Promise<RPCResponse>

  The identities associated with the address.

getEthosScore

• getEthosScore(demos, walletAddress): Promise<RPCResponse>

• Retrieve the Ethos reputation score for a given wallet address.

  Parameters

  • demos: Demos

    A Demos instance used to communicate with the RPC.
  • walletAddress: string

    The EVM wallet address to retrieve the Ethos score for.

  Returns Promise<RPCResponse>

  The RPC response containing the Ethos score data.

getHumanPassportIdentities

• getHumanPassportIdentities(demos, demosAddress): Promise<SavedHumanPassportIdentity[]>

• Get Human Passport identities for a Demos address.

  Parameters

  • demos: Demos

    A Demos instance used to communicate with the RPC.
  • demosAddress: string

    The Demos address to get identities for.

  Returns Promise<SavedHumanPassportIdentity[]>

  The RPC response containing the Human Passport identities.

getHumanPassportScore

• getHumanPassportScore(demos, address): Promise<RPCResponseWithValidityData>

• Fetch Human Passport score for an address.

  Calls the getHumanPassportScore GCR routine via the Demos RPC. This fetches the score from the node's cached data, not directly from Human Passport API.

  Parameters

  • demos: Demos

    A Demos instance used to communicate with the RPC.
  • address: string

    The EVM address to retrieve the Human Passport score for.

  Returns Promise<RPCResponseWithValidityData>

  The RPC response containing the Human Passport score data.

getIdentities

• getIdentities(demos, call?, address?): Promise<RPCResponse>

• Get the identities associated with an address.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • call: string = "getIdentities"
  • Optionaladdress: string

    The address to get identities for.

  Returns Promise<RPCResponse>

  The identities associated with the address.

getNomisScore

• getNomisScore(demos, walletAddress, chain?, subchain?, scoreType?): Promise<RPCResponse>

• Fetch a Nomis score for a wallet.

  Calls the getNomisScore GCR routine via the Demos RPC.

  Parameters

  • demos: Demos

    A Demos instance used to communicate with the RPC.
  • walletAddress: string

    The wallet address to retrieve the Nomis score for.
  • Optionalchain: string

    Optional blockchain type (e.g. "evm", "solana").
  • Optionalsubchain: string

    Optional subchain or network identifier.
  • OptionalscoreType: number

    Optional Nomis score type identifier.

  Returns Promise<RPCResponse>

  The RPC response containing the Nomis score data.

getReferralInfo

• getReferralInfo(demos, address?): Promise<RPCResponse>

• Get referral information for an address.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • Optionaladdress: string

    The address to get referral info for. Defaults to the connected wallet's address.

  Returns Promise<RPCResponse>

  The referral information associated with the address.

getUDIdentities

• getUDIdentities(demos, address?): Promise<RPCResponse>

• Get the Unstoppable Domain identities associated with an address.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC
  • Optionaladdress: string

    The address to get identities for. Defaults to the connected wallet's address.

  Returns Promise<RPCResponse>

  The identities associated with the address.

getUserPoints

• getUserPoints(demos, address?): Promise<RPCResponseWithValidityData>

• Get the points associated with an identity

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC
  • Optionaladdress: string

    The address to get points for. Defaults to the connected wallet's address.

  Returns Promise<RPCResponseWithValidityData>

  The points data for the identity

getWeb2Identities

• getWeb2Identities(demos, address?): Promise<RPCResponse>

• Get the web2 identities associated with an address.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • Optionaladdress: string

    The address to get identities for.

  Returns Promise<RPCResponse>

  The identities associated with the address.

getXmIdentities

• getXmIdentities(demos, address?): Promise<RPCResponse>

• Get the crosschain identities associated with an address.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • Optionaladdress: string

    The address to get identities for.

  Returns Promise<RPCResponse>

  The identities associated with the address.

inferWeb2Identity

• inferWeb2Identity(demos, payload): Promise<RPCResponseWithValidityData>

• Infer a web2 identity from a proof payload.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • payload: Web2CoreTargetIdentityPayload

    The payload to infer the identity from.

  Returns Promise<RPCResponseWithValidityData>

  The validity data of the identity transaction.

inferXmIdentity

• inferXmIdentity(demos, payload, referralCode?): Promise<RPCResponseWithValidityData>

• Infer a crosschain identity from a signature.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • payload: InferFromSignaturePayload

    The payload to infer the identity from.
  • OptionalreferralCode: string

  Returns Promise<RPCResponseWithValidityData>

  The validity data of the identity transaction.

removeDomainIdentity

• removeDomainIdentity(demos, hostname): Promise<RPCResponseWithValidityData>

• Remove a domain identity from the GCR (CCI).

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • hostname: string

    The domain to unlink (e.g. "example.com").

  Returns Promise<RPCResponseWithValidityData>

  The response from the RPC call.

removeEthosIdentity

• removeEthosIdentity(demos, payload): Promise<RPCResponseWithValidityData>

• Remove an Ethos wallet identity from the GCR.

  Parameters

  • demos: Demos

    A Demos instance used to communicate with the RPC.
  • payload: EthosIdentityRemoveData

    The identifying data for the Ethos identity to remove (chain, subchain, address).

  Returns Promise<RPCResponseWithValidityData>

  The RPC response for the identity removal operation.

removeHumanPassportIdentity

• removeHumanPassportIdentity(demos, address): Promise<RPCResponseWithValidityData>

• Remove a Human Passport identity from the GCR.

  Parameters

  • demos: Demos

    A Demos instance used to communicate with the RPC.
  • address: string

    The EVM address of the Human Passport identity to remove.

  Returns Promise<RPCResponseWithValidityData>

  The RPC response for the identity removal operation.

removeNomisIdentity

• removeNomisIdentity(demos, payload): Promise<RPCResponseWithValidityData>

• Remove a Nomis wallet identity from the GCR.

  Parameters

  • demos: Demos

    A Demos instance used to communicate with the RPC.
  • payload: NomisWalletIdentity

    The Nomis wallet identity data identifying the identity to remove.

  Returns Promise<RPCResponseWithValidityData>

  The RPC response for the identity removal operation.

removePqcIdentity

• removePqcIdentity(demos, algorithms?): Promise<RPCResponseWithValidityData>

• Parameters

  • demos: Demos
  • algorithms: PQCAlgorithm[] | "all" = "all"

  Returns Promise<RPCResponseWithValidityData>

removeUnstoppableDomainIdentity

• removeUnstoppableDomainIdentity(demos, domain): Promise<RPCResponseWithValidityData>

• Remove an Unstoppable Domain identity from the GCR.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC
  • domain: string

    The UD domain (e.g., "brad.crypto")

  Returns Promise<RPCResponseWithValidityData>

  The validity data response from the RPC

removeWeb2Identity

• removeWeb2Identity(demos, payload): Promise<RPCResponseWithValidityData>

• Remove a web2 identity from the network.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • payload: {
        context: string;
        username: string;
    }

    The payload to remove the identity.

    • context: string

    • username: string

  Returns Promise<RPCResponseWithValidityData>

  The response from the RPC call.

removeWeb2IdentityViaTLSN

• removeWeb2IdentityViaTLSN(demos, context, username): Promise<RPCResponseWithValidityData>

• Remove a Web2 identity that was added via TLSNotary.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • context: TLSNIdentityContext

    The platform context ("github", "discord", or "telegram").
  • username: string

    The username to remove.

  Returns Promise<RPCResponseWithValidityData>

  The response from the RPC call.

removeXmIdentity

• removeXmIdentity(demos, payload): Promise<RPCResponseWithValidityData>

• Remove a crosschain identity from the network.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • payload: XMCoreTargetIdentityPayload

    The payload to remove the identity.

  Returns Promise<RPCResponseWithValidityData>

  The response from the RPC call.

resolveUDDomain

• resolveUDDomain(demos, domain): Promise<UnifiedDomainResolution>

• Resolve a domain to its owner's address and other metadata.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC
  • domain: string

    The UD domain (e.g., "brad.crypto")

  Returns Promise<UnifiedDomainResolution>

  The unified domain resolution result

validateReferralCode

• validateReferralCode(demos, referralCode): Promise<RPCResponse>

• Validate a referral code to check if it exists and is valid.

  Parameters

  • demos: Demos

    A Demos instance to communicate with the RPC.
  • referralCode: string

    The referral code to validate.

  Returns Promise<RPCResponse>

  The validation result containing validity status, referrer public key, and message.