Skip to main content
Use the TypeScript SDK session APIs after authentication to restore wallet state, issue ID tokens, and manage credential access.

​
Session Restore

The default storage backend is browser localStorage when it is available. Non-browser runtimes use in-memory storage unless you provide a custom StorageManager. OIDC redirect state defaults to browser sessionStorage. Browser signing defaults to a non-extractable WebCrypto P-256 credential stored through IndexedDB when available, so raw private key bytes are not written to localStorage. 
import { MemoryStorageManager, OMSClient } from '@0xsequence/typescript-sdk'

const oms = new OMSClient({
  publishableKey: 'YOUR_PROJECT_ACCESS_KEY',
  projectId: 'YOUR_PROJECT_ID',
  storage: new MemoryStorageManager(),
  redirectAuthStorage: new MemoryStorageManager(),
})

if (oms.wallet.session.walletAddress) {
  console.log('Restored wallet:', oms.wallet.session.walletAddress)
}
Returns oms.wallet.session returns OMSClientSessionState with walletAddress, expiresAt, loginType, and sessionEmail.

​
Session Expiry Events

Register an onSessionExpired listener when the app should react as soon as the active wallet session expires. 
const unsubscribe = oms.wallet.onSessionExpired((event) => {
  console.log('Session expired at:', event.expiredAt)
  console.log('Expired wallet:', event.session.walletAddress)
})

// Call when the component, route, or service no longer needs updates.
unsubscribe()
The SDK replays the latest expired-session event to new listeners until a new auth flow, new wallet session, or sign out clears it. Listener errors are ignored by the SDK so app callbacks do not change wallet operation results. Parameters
ParameterTypeDescription
listenerOMSClientSessionExpiredListenerCallback that receives { session, expiredAt } when the wallet session expires.
Returns Returns () => void, an unsubscribe function that removes the listener.

​
List Wallets

List wallets available to the authenticated credential. 
const wallets = await oms.wallet.listWallets()

for (const wallet of wallets) {
  console.log(wallet.id, wallet.type, wallet.address)
}
Parameters Takes no parameters. Returns Returns Promise<OmsWallet[]>.

​
Get ID Token

Request an ID token for the active wallet session. Send this token to your backend when using backend wallet verification. 
const idToken = await oms.wallet.getIdToken({
  ttlSeconds: 300,
})
Parameters
ParameterTypeDescription
ttlSecondsnumber or undefinedOptional token lifetime in seconds.
customClaimsRecord<string, unknown> or undefinedOptional custom claims to include in the token.
Returns Returns Promise<string>.

​
List Access

List credentials that currently have access to the active wallet. 
const grants = await oms.wallet.listAccess()

for (const grant of grants) {
  console.log(grant.credentialId, grant.expiresAt, grant.isCaller)
}
Parameters
ParameterTypeDescription
pageSizenumber or undefinedOptional page size used while following Wallet API cursors.
Returns Returns Promise<AccessGrant[]>.

​
List Access Pages

Use listAccessPages when your UI should render credential access one page at a time. 
for await (const page of oms.wallet.listAccessPages({ pageSize: 25 })) {
  for (const grant of page.grants) {
    console.log(grant.credentialId, grant.isCaller)
  }
}
Parameters
ParameterTypeDescription
pageSizenumber or undefinedOptional page size for each Wallet API request.
Returns Returns AsyncIterable<AccessGrantPage>.

​
Revoke Access

Revoke another credential’s access to the active wallet. 
await oms.wallet.revokeAccess({
  targetCredentialId: 'credential-id',
})
Parameters
ParameterTypeDescription
targetCredentialIdstringCredential ID returned by listAccess.
Returns Returns Promise<void>.

​
Sign Out

await oms.wallet.signOut()
Signing out clears wallet metadata from storage, pending OIDC redirect auth state, and the configured credential signer when supported. Parameters Takes no parameters. Returns Returns Promise<void>.