Skip to main content

Ethos

You can associate an Ethos-scored EVM wallet with your DEMOS address by following these steps.

1. Connect your wallet

2. Fetch the Ethos Score

Retrieve the Ethos score for the EVM wallet you want to link. The score is fetched from the node via the gcr_routine mechanism. The walletAddress argument must be a valid EVM address (0x[a-fA-F0-9]{40}); the SDK throws if the format is invalid.

3. Send an Identity request

Build an EthosWalletIdentity payload and submit the link transaction. The payload is validated client-side before being sent:
  • chain — required non-empty string (e.g. "evm").
  • subchain — required non-empty string (e.g. "ethereum", "base").
  • address — required EVM address matching 0x[a-fA-F0-9]{40}.
  • score — required, must be a finite, non-negative number.
  • lastSyncedAt — required ISO date string (must parse with Date.parse).
  • profileId — optional Ethos profile id (number, if provided).
  • metadata — optional object (e.g. displayName, username).
A successful transaction response should look like this:

4. Getting linked Ethos identities

After the confirmation block has been forged, you can retrieve the Ethos identities linked to an address. Pass an address to query a specific account or omit it to use the connected wallet’s address.

5. Removing an Ethos identity

You can create a transaction to remove a linked Ethos wallet. The removal payload only needs the identifying fields:
  • chain — required non-empty string.
  • subchain — required non-empty string.
  • address — required EVM address (0x[a-fA-F0-9]{40}).
A successful transaction response should look like this: