Sign and verify with TypeScript - Polygon Developer Docs

Signing uses the active wallet session and does not submit a transaction. Signature verification uses the public wallet API. It can verify an explicit wallet without authentication.

Sign and verify a message

import { Networks } from '@polygonlabs/oms-wallet'

const message = 'Approve checkout order 1042'

const signature = await omsWallet.wallet.signMessage({
  network: Networks.amoy,
  message,
})

const isValid = await omsWallet.wallet.isValidMessageSignature({
  network: Networks.amoy,
  message,
  signature,
})

signMessage requires an active Ethereum wallet. Verification checks the active wallet’s address unless you pass walletAddress.

Verify an explicit wallet publicly

With walletAddress, verification needs no session, only the project’s publishable key.

import { Networks, OMSWallet } from '@polygonlabs/oms-wallet'

const publicWallet = new OMSWallet({
  publishableKey: 'YOUR_PUBLISHABLE_KEY',
})

const isValid = await publicWallet.wallet.isValidMessageSignature({
  network: Networks.amoy,
  walletAddress: '0x1111111111111111111111111111111111111111',
  message: 'Approve checkout order 1042',
  signature: submittedSignature,
})

This call is read-only and does not establish, restore, or change a wallet session.

Sign and verify a Solana message

For a selected Solana wallet, use the Solana-specific methods. Off-chain messages do not take a network because they are not cluster-specific.

const message = 'Approve login for example.com'

const signature = await omsWallet.wallet.signSolanaMessage({ message })

const isValid = await omsWallet.wallet.isValidSolanaMessageSignature({
  message,
  signature,
})

Solana verification can also target an explicit walletAddress without a session. Signing still requires an active Solana wallet session.

Sign and verify a Tron message

For a selected Tron wallet, use the Tron-specific methods. Like Solana, they take no network argument.

const message = 'Approve login for example.com'

const signature = await omsWallet.wallet.signTronMessage({ message })

const isValid = await omsWallet.wallet.isValidTronMessageSignature({
  message,
  signature,
})

Tron verification can also target an explicit Base58Check walletAddress without a session. Signing requires an active Tron wallet session.

Sign and verify typed data

import { Networks, WalletType } from '@polygonlabs/oms-wallet'

const typedData = {
  domain: {
    name: 'Checkout',
    version: '1',
    chainId: 80002n,
  },
  types: {
    Order: [
      { name: 'orderId', type: 'uint256' },
      { name: 'amount', type: 'uint256' },
    ],
  },
  primaryType: 'Order',
  message: {
    orderId: 1042n,
    amount: 1_000_000n,
  },
} as const

const signature = await omsWallet.wallet.signTypedData({
  network: Networks.amoy,
  typedData,
})

const activeWallet = omsWallet.wallet.activeWallet

if (activeWallet?.type !== WalletType.Ethereum) {
  throw new Error('An Ethereum wallet is required')
}

const isValid = await omsWallet.wallet.isValidTypedDataSignature({
  network: Networks.amoy,
  walletAddress: activeWallet.address,
  typedData,
  signature,
})

typedData is typed as unknown in both public parameter interfaces. The SDK accepts a JSON-compatible typed-data object and converts nested bigint values to decimal strings for the wallet API. Use the same semantic typed data for signing and verification. With an explicit walletAddress, you can also verify a typed-data signature from a client that is signed out. For a Tron wallet, sign and verify TIP-712 typed data with signTronTypedData and isValidTronTypedDataSignature. They take no network; the typed-data domain identifies the chain. Address values in Tron typed data can be Base58Check addresses.

const tronTypedData = {
  domain: {
    name: 'Checkout',
    version: '1',
    chainId: 3448148188n, // Tron Nile
  },
  types: {
    Payout: [
      { name: 'recipient', type: 'address' },
      { name: 'amount', type: 'uint256' },
    ],
  },
  primaryType: 'Payout',
  message: {
    recipient: 'TBXSw8fM4jpQkGc6zZjsVABFpVN7UvXPdV',
    amount: 1_000_000n,
  },
} as const

const tronSignature = await omsWallet.wallet.signTronTypedData({
  typedData: tronTypedData,
})

const isValidTron = await omsWallet.wallet.isValidTronTypedDataSignature({
  typedData: tronTypedData,
  signature: tronSignature,
})

Every verification method returns Promise<boolean>. A false result means the signature did not validate for the supplied target and payload; request or response failures still throw SDK errors.