:root {
  /* Colors */
  --privy-bg: #ffffff;
  --privy-bg-elevated: #f1f2f9;
  --privy-bg-success: #dcfce7;
  --privy-bg-info: #e0e7ff;
  --privy-bg-warning: #fef3c7;
  --privy-bg-hero: #c4d4f6;
  --privy-text-primary: #010110;
  --privy-text-muted: #64668b;
  --privy-text-placeholder: #9498b8;
  --privy-border: #e2e3f0;
  --privy-border-success: #22c55e;
  --privy-border-info: #818cf8;
  --privy-border-warning: #f59e0b;
  --privy-icon-success: #16a34a;
  --privy-icon-info: #4f46e5;
  --privy-icon-warning: #d97706;

  --privy-dark-bg: #010110;
  --privy-dark-bg-elevated: #22222a;
  --privy-dark-bg-success: #bbf7d02e;
  --privy-dark-bg-info: #c7d2fe2e;
  --privy-dark-bg-warning: #fde68a2e;
  --privy-dark-bg-hero: #22222a;
  --privy-dark-text-primary: #ffffff;
  --privy-dark-text-muted: #cbcde1;
  --privy-dark-border: #333455;
  --privy-dark-icon-success: #86efac;
  --privy-dark-icon-info: #a5b4fc;
  --privy-dark-icon-warning: #fcd34d;

  /* one off colors */
  --privy-light-codeblock-bg: #f2f4fd;
  --privy-light-codeblock-highlight-bg: rgba(91, 79, 255, 0.2);
  --privy-light-codeblock-highlight-left-border: rgba(91, 79, 255, 1);
  --privy-dark-codeblock-highlight-bg: rgba(209, 49, 108, 0.2);
  --privy-dark-codeblock-highlight-left-border: rgba(209, 49, 108, 1);
}

html {
  scroll-behavior: smooth;
}

/* Search bar */
.dark #search-bar-entry {
  background-color: var(--privy-dark-bg-elevated);
}

/* Navbar CTA button */
#topbar-cta-button a span {
  background-color: var(--privy-text-primary);
}

#topbar-cta-button a:hover * {
  opacity: 1;
}

#topbar-cta-button a svg {
  color: currentColor;
}

.dark #topbar-cta-button a span {
  color: var(--privy-dark-bg);
  background-color: var(--privy-dark-text-primary);
}

.dark #topbar-cta-button a {
  color: var(--privy-dark-bg);
}

/* Card */
.card {
  border-width: 0;
  border-radius: 8px;
  box-shadow: 0 0 0 1px var(--privy-border);
}

.card:hover {
  box-shadow: 0 0 0 2px var(--privy-text-primary);
}

.dark .card {
  box-shadow: 0 0 0 0;
  background-color: var(--privy-dark-bg-elevated);
}

.dark .card:hover {
  box-shadow: 0 0 0 2px var(--privy-dark-text-primary);
}

/* Hero */
.hero {
  width: 100%;
  background-image: url('https://privy-assets-public.s3.us-east-1.amazonaws.com/bg-light.png');
  background-size: cover;
  background-repeat: no-repeat;
  background-position: center;
  margin-bottom: 62px;
  padding: 114px 32px 84px 32px;

  display: flex;
  flex-direction: column;
  gap: 24px;

  color: var(--privy-text-primary);

  transition: background-image 0.3s ease-in-out;
}

.dark .hero {
  background-image: url('https://privy-assets-public.s3.us-east-1.amazonaws.com/bg-darkgray.png');
  color: var(--privy-dark-text-primary);
}

.hero h1 {
  font-size: 52px;
  font-weight: 500;
  /* font-family: 'ABC Favorit Variable Unlicensed Trial', 'Inter-regular', sans-serif; */
}

.hero .search {
  width: 100%;
  max-width: 450px;
  height: 40px;
  border-radius: 8px;
  border: 1px solid var(--privy-border);
  background-color: white;
  margin: 0 auto;
  color: var(--privy-text-placeholder);
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 0 16px;
  font-size: 14px;
  cursor: pointer;
}

.hero .details-text {
  max-width: 38rem;
  margin: 0 auto;
  background: rgba(256, 256, 256, 0.6);
}

.dark .hero .details-text {
  background: rgba(0, 0, 0, 0);
}

.dark .hero .search {
  background-color: transparent;
}

.subtitle {
  color: var(--privy-text-primary);
  font-size: 20px;
  font-weight: 600;
}

.dark .subtitle {
  color: var(--privy-dark-text-primary);
}

/* Misc */
.no-underline {
  text-decoration: none !important;
  border-bottom: 0px;
}

.no-underline p {
  margin: 0;
}

/* Callouts */
/* Callouts - Tip */
div[data-callout-type='tip'] {
  border-radius: 12px;
  background-color: var(--privy-bg-success);
  border-color: var(--privy-border-success);

  & > div {
    color: var(--privy-text-primary);
  }

  & a {
    transition: border 100ms ease-in-out;
    border-color: var(--privy-text-primary);
  }

  & > div > svg {
    color: var(--privy-icon-success);
  }
}

.dark div[data-callout-type='tip'] {
  background-color: var(--privy-dark-bg-success);
  border-width: 0;

  & > div {
    color: var(--privy-dark-text-primary);
  }

  & a {
    border-color: var(--privy-dark-text-primary);
  }

  & > div > svg {
    color: var(--privy-dark-icon-success);
  }
}

/* Callouts - Info */
div[data-callout-type='info'] {
  border-radius: 12px;
  background-color: var(--privy-bg-info);
  border-color: var(--privy-border-info);

  & > div {
    color: var(--privy-text-primary);
  }

  & a {
    transition: border 100ms ease-in-out;
    border-color: var(--privy-text-primary);
  }

  & > div > svg {
    color: var(--privy-icon-info);
  }
}

.dark div[data-callout-type='info'] {
  background-color: var(--privy-dark-bg-info);
  border-width: 0;

  & > div {
    color: var(--privy-dark-text-primary);
  }

  & a {
    transition: border 100ms ease-in-out;
    border-color: var(--privy-dark-text-primary);
  }

  & > div > svg {
    color: var(--privy-dark-icon-info);
  }
}

/* Callouts - Warning */
div[data-callout-type='warning'] {
  border-radius: 12px;
  background-color: var(--privy-bg-warning);
  border-color: var(--privy-border-warning);

  & > div {
    color: var(--privy-text-primary);
  }

  & a {
    transition: border 100ms ease-in-out;
    border-color: var(--privy-text-primary);
  }

  & > div > svg {
    color: var(--privy-icon-warning);
  }
}

.dark div[data-callout-type='warning'] {
  background-color: var(--privy-dark-bg-warning);
  border-width: 0;

  & > div {
    color: var(--privy-dark-text-primary);
  }

  & a {
    border-color: var(--privy-dark-text-primary);
  }

  & > div > svg {
    color: var(--privy-dark-icon-warning);
  }
}

/* Navigation items */
#navigation-items li a {
  border-radius: 6px;

  &.bg-primary\/10 {
    background-color: var(--privy-bg-elevated);
  }
}

.dark #navigation-items li a.bg-primary\/10 {
  background-color: var(--privy-dark-bg-elevated);
}

/* Codeblocks */
.codeblock-dark {
  border-radius: 12px;
}

.dark\:bg-codeblock:is(.dark *):not([id*='accordion'] *) {
  background-color: var(--privy-dark-bg-hero);
}

body .codeblock-light,
.codeblock-light:is(.bg-white) {
  background-color: var(--privy-light-codeblock-bg);
  border: none;
}

html:not(.dark) .codeblock-light .line-highlight,
html:not(.dark) .codeblock-light .line-highlight:after,
html:not(.dark) .codeblock-light .line-highlight:before {
  background: var(--privy-light-codeblock-highlight-bg);
}

html:not(.dark) .codeblock-light .line-highlight:before {
  left: -1.25rem;
  border-left: 4px solid var(--privy-light-codeblock-highlight-left-border);
}

html:is(.dark) .codeblock-light .line-highlight,
html:is(.dark) .codeblock-light .line-highlight:after,
html:is(.dark) .codeblock-light .line-highlight:before {
  background: var(--privy-dark-codeblock-highlight-bg);
}

html:is(.dark) .codeblock-light .line-highlight:before {
  left: -1.25rem;
  border-left: 4px solid var(--privy-dark-codeblock-highlight-left-border);
}

/* Tables */
table > thead {
  text-align: left;
}

.prose
  :where(a):not(:has(svg)):not(:has(code)):not(
    :where([class~='not-prose'], [class~='not-prose'] *)
  ):not(.dark *) {
  border-bottom: 1px solid var(--privy-text-primary);
}

.prose :where(a code):not(:where([class~='not-prose'], [class~='not-prose'] *)):not(.dark *) {
  text-decoration-color: var(--privy-text-primary);
}

.prose
  :where(a:has(code)):not(:has(svg)):not(:where([class~='not-prose'], [class~='not-prose'] *)) {
  border-bottom: none;
}

/* hide the up arrow from cards */
.card .lucide-arrow-up-right {
  display: none;
}

/* Recipes page */
.recipes {
  width: 100%;
  margin-bottom: 62px;
  padding: 74px 32px 84px 32px;
  background-size: cover;

  display: flex;
  flex-direction: column;
  gap: 24px;

  color: var(--privy-text-primary);

  transition: background-image 0.3s ease-in-out;
}

.dark .recipes {
  color: var(--privy-dark-text-primary);
}

.recipes h1 {
  font-size: 52px;
  font-weight: 400;
  /* font-family: 'ABC Favorit Variable Unlicensed Trial', 'Inter-regular', sans-serif; */
}

.recipes .search {
  width: 100%;
  max-width: 450px;
  height: 40px;
  border-radius: 8px;
  border: 1px solid var(--privy-border);
  background-color: white;
  margin: 0 auto;
  color: var(--privy-text-placeholder);
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 0 16px;
  font-size: 14px;
  cursor: pointer;
}

.dark .recipes .search {
  background-color: transparent;
}

#navbar a[href='/welcome'] {
  display: none;
}

#navbar a[href='/basics/get-started/about'] {
  margin-left: 0px;
}


function clickOnSearch() {
  document.getElementById('search-bar-entry-mobile').click();
}


window['_fs_host'] = 'fullstory.com';
window['_fs_script'] = 'edge.fullstory.com/s/fs.js';
window['_fs_org'] = 'o-22TCHH-na1';
window['_fs_namespace'] = 'FS';
!(function (m, n, e, t, l, o, g, y) {
  var s,
    f,
    a = (function (h) {
      return (
        !(h in m) ||
        (m.console &&
          m.console.log &&
          m.console.log('FullStory namespace conflict. Please set window["_fs_namespace"].'),
        !1)
      );
    })(e);
  function p(b) {
    var h,
      d = [];
    function j() {
      h &&
        (d.forEach(function (b) {
          var d;
          try {
            d = b[h[0]] && b[h[0]](h[1]);
          } catch (h) {
            return void (b[3] && b[3](h));
          }
          d && d.then ? d.then(b[2], b[3]) : b[2] && b[2](d);
        }),
        (d.length = 0));
    }
    function r(b) {
      return function (d) {
        h || ((h = [b, d]), j());
      };
    }
    return (
      b(r(0), r(1)),
      {
        then: function (b, h) {
          return p(function (r, i) {
            d.push([b, h, r, i]), j();
          });
        }
      }
    );
  }
  a &&
    ((g = m[e] =
      (function () {
        var b = function (b, d, j, r) {
          function i(i, c) {
            h(b, d, j, i, c, r);
          }
          r = r || 2;
          var c,
            u = /Async$/;
          return u.test(b)
            ? ((b = b.replace(u, '')), 'function' == typeof Promise ? new Promise(i) : p(i))
            : h(b, d, j, c, c, r);
        };
        function h(h, d, j, r, i, c) {
          return b._api ? b._api(h, d, j, r, i, c) : (b.q && b.q.push([h, d, j, r, i, c]), null);
        }
        return (b.q = []), b;
      })()),
    (y = function (b) {
      function h(h) {
        'function' == typeof h[4] && h[4](new Error(b));
      }
      var d = g.q;
      if (d) {
        for (var j = 0; j < d.length; j++) h(d[j]);
        (d.length = 0), (d.push = h);
      }
    }),
    (function () {
      ((o = n.createElement(t)).async = !0),
        (o.crossOrigin = 'anonymous'),
        (o.src = 'https://' + l),
        (o.onerror = function () {
          y('Error loading ' + l);
        });
      var b = n.getElementsByTagName(t)[0];
      b && b.parentNode ? b.parentNode.insertBefore(o, b) : n.head.appendChild(o);
    })(),
    (function () {
      function b() {}
      function h(b, h, d) {
        g(b, h, d, 1);
      }
      function d(b, d, j) {
        h('setProperties', {type: b, properties: d}, j);
      }
      function j(b, h) {
        d('user', b, h);
      }
      function r(b, h, d) {
        j(
          {
            uid: b
          },
          d
        ),
          h && j(h, d);
      }
      (g.identify = r),
        (g.setUserVars = j),
        (g.identifyAccount = b),
        (g.clearUserCookie = b),
        (g.setVars = d),
        (g.event = function (b, d, j) {
          h(
            'trackEvent',
            {
              name: b,
              properties: d
            },
            j
          );
        }),
        (g.anonymize = function () {
          r(!1);
        }),
        (g.shutdown = function () {
          h('shutdown');
        }),
        (g.restart = function () {
          h('restart');
        }),
        (g.log = function (b, d) {
          h('log', {level: b, msg: d});
        }),
        (g.consent = function (b) {
          h('setIdentity', {consent: !arguments.length || b});
        });
    })(),
    (s = 'fetch'),
    (f = 'XMLHttpRequest'),
    (g._w = {}),
    (g._w[f] = m[f]),
    (g._w[s] = m[s]),
    m[s] &&
      (m[s] = function () {
        return g._w[s].apply(this, arguments);
      }),
    (g._v = '2.0.0'));
})(window, document, window._fs_namespace, 'script', window._fs_script);


Authentication methods

Overview

Privy docs

Welcome

About Privy

Create an account

Choose your platform

JWT-based auth

Authentication state

Access tokens

Logging users out

UI components

Chain support

Update a wallet

Exporting private keys

Import a wallet

UI library

Usage

UI Component

Configure chain types

Configure external connector chains

Configure wallet options

Connect an external wallet

Connect or create a wallet

Authenticate a connected wallet

Interfacing with common libraries

Policies & controls

Securing wallet actions with multi-signature quorum approvals

Creating key quorums

Using key quorums

Migrating existing users to Privy

The user object

Handling the user object

Access user data securely with Privy identity tokens

Identity tokens

Linking accounts to users

Unlinking accounts from users

Updating user accounts

Deleting users

Allow list

Deny list

Handling Events

Security

Architecture

Security architecture

Policy and controls

Wallet policies and controls

User authentication

User authorization keys

Security checklist

Content Security Policies (CSPs)

Guidance for Content Security Policies (CSPs)

Security FAQs

Threat models & security FAQ

Integrating with wagmi

Optimize your setup

Funding wallets with Apple Pay and Google Pay

Integrating OneBalance

Building a Farcaster Frame

Configure log in with Telegram

Seamless Telegram login

Writing to Farcaster

Login with Lens

Configure allowed domains

Configure cookies

Configure allowed OAuth redirect URLs

Setting a system theme for the Privy modal

Customize your application

Configure account transfer

Configure cloud recovery of embedded wallets

Configure SMS login

Login with Apple

Mocking tokens for testing

Integrating with tRPC

Integrating with EIP-7702

Introduction

Securing Privy API requests with authorization signatures

Authorization signatures

Making Privy API requests idempotent with idempotency keys

Idempotency keys

Create wallet

Get wallet

Update a wallet's policies or authorization key configuration.

Update wallet

Get wallets

Export wallet

Create policy

Get policy

Update policy

Delete policy

Get transaction

Create key quorum

Get key quorum

Update key quorum

Delete key quorum

Create a user, with an associated wallet and authentication accounts.

Create user

Obtain a user session signer to enable wallet access.

Authenticate

Create a new user with linked accounts. Optionally pre-generate embedded wallets for the user.

Authorization keys

Quorum approvals

Policies

Overview

Authentication methods

Authorization keys

Quorum approvals

Policies

​Authentication methods

Authentication methods