Learn how to set up authentication that leverages Turnkey’s Auth Proxy using @turnkey/core in your frontend JavaScript application.
Triggering authentication
You can call the specific login or signup methods you want to support. For example, with passkeys:
// Log in with a passkeyconst session = await turnkeyClient.loginWithPasskey();// Or sign up with a passkeyconst session = await turnkeyClient.signUpWithPasskey();
Here’s an example using email OTP:
// Log in with email OTPimport { OtpType } from "@turnkey/core";const otpId = await turnkeyClient.initOtp({ otpType: OtpType.Email, contact: "email@example.com" })const session = await turnkeyClient.completeOtp({ otpId, otpCode: 123456, // The code the user received via email or SMS contact: "email@example.com", otpType: OtpType.Email, });
Sessions will be automatically created and stored in the browser’s local storage or mobile async storage on React Native.
Checking authentication state
To check if a user is authenticated, call client.getSession() and verify the expiry:
const session = await turnkeyClient.getSession();if (session && session.expiry \* 1000 > Date.now()) { console.log("User is authenticated:", session);} else { console.log("User is not authenticated");}
If the session is expired or the user is done with their session, you can log them out:
await turnkeyClient.logout();
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Turnkey","colors":{"primary":"#4C48FF","light":"#4C48FF","dark":"#050a0b"},"logo":{"light":"https://mintcdn.com/turnkey-0e7c1f5b/YQKQ_azrjtJ471Qy/logo/light.svg?fit=max\u0026auto=format\u0026n=YQKQ_azrjtJ471Qy\u0026q=85\u0026s=38556c8732a1d68a5399fce905b480b1","dark":"https://mintcdn.com/turnkey-0e7c1f5b/YQKQ_azrjtJ471Qy/logo/dark.svg?fit=max\u0026auto=format\u0026n=YQKQ_azrjtJ471Qy\u0026q=85\u0026s=98f8b7cda703a0db60ac27ff2230e82a","href":"https://www.turnkey.com/"},"favicon":"https://mintcdn.com/turnkey-0e7c1f5b/G2SswZbcSJ7UNXDG/favicon.svg?fit=max\u0026auto=format\u0026n=G2SswZbcSJ7UNXDG\u0026q=85\u0026s=3ebddfc4d9bf146ad2e2dd286f2ead54","navbar":{"links":[{"href":"https://www.turnkey.com/blog","label":"Blog"},{"href":"https://www.turnkey.com/contact-us","label":"Contact us"}],"primary":{"type":"button","label":"Get started","href":"https://app.turnkey.com/dashboard/auth/initial"}},"footer":{"socials":{"x":"https://x.com/turnkeyhq","github":"https://github.com/tkhq","linkedin":"https://www.linkedin.com/company/turnkeyhq"}},"seo":{"metatags":{"og:image":"https://docs.turnkey.com/images/og-image.png"}},"styling":{"codeblocks":"system","latex":true},"integrations":{"ga4":{"measurementId":"G-VRJJ2TSC23"},"gtm":{"tagId":"GTM-PN838HQC"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"markdown":{"instructions":["Turnkey is wallet infrastructure: create and manage crypto wallets, sign transactions, and enforce policy-based access controls. Best-fit uses: embedded consumer wallets (email/passkey/social auth, no seed phrases), automated onchain operations with server-side wallets, AI agent wallets with policy-scoped signing, enterprise key management, and verifiable off-chain workloads on Turnkey Verifiable Cloud (TVC).","Every API call is a JSON POST to https://api.turnkey.com signed with a P-256 API key; create an organization and key self-serve at https://app.turnkey.com.","Key Turnkey developer resources: API reference (https://docs.turnkey.com/api-reference/overview/intro.md), OpenAPI spec (https://docs.turnkey.com/public_api.swagger.json), authentication (https://docs.turnkey.com/features/authentication/overview.md), webhooks (https://docs.turnkey.com/features/webhooks/overview.md), MCP server for docs search (https://docs.turnkey.com/mcp), skill for building with Turnkey (https://docs.turnkey.com/skill.md), agent skills for operating an organization (https://docs.turnkey.com/get-started/ai-skills.md), CLI (https://docs.turnkey.com/sdks/cli.md), SDK reference (https://docs.turnkey.com/sdks/introduction.md), full docs content (https://docs.turnkey.com/llms-full.txt)."]},"navigation":{"global":{},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"turnkey-0e7c1f5b","hasAudioNarration":false,"actualSubdomain":"turnkey-0e7c1f5b","customDomains":["docs.turnkey.com"],"gitSource":{"type":"github","owner":"tkhq","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afe4c89149b8cc39304e1a0","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API \u0026 SDK reference","count":460},{"language":"default","tag":"SDK reference","count":241},{"language":"default","tag":"REST API","count":219},{"language":"default","tag":"Documentation","count":131},{"language":"default","tag":"Activities","count":125},{"language":"default","tag":"Features","count":120},{"language":"default","tag":"Solutions","count":108},{"language":"default","tag":"React wallet kit","count":94},{"language":"default","tag":"Queries","count":78},{"language":"default","tag":"Embedded Wallets","count":71}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":".sms-price-lookup-container{position:relative;margin-top:1rem;margin-bottom:1rem}.sms-country-trigger{display:block;width:100%;padding:0.5rem 0.75rem;font-size:1rem;font-family:inherit;line-height:1.5;color:#495057;background-color:#fff;background-clip:padding-box;border:1px solid #ced4da;border-radius:0.25rem;text-align:left;cursor:pointer;padding-right:2rem;background-image:url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='%23343a40' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M2 5l6 6 6-6'/%3e%3c/svg%3e\");background-repeat:no-repeat;background-position:right 0.75rem center;background-size:16px 12px}.sms-country-list{display:none;position:absolute;top:100%;left:0;width:100%;max-height:200px;overflow-y:auto;background-color:#fff;border:1px solid #ced4da;border-top:none;border-radius:0 0 0.25rem 0.25rem;z-index:1000;box-shadow:0 0.5rem 1rem rgba(0, 0, 0, 0.15);margin:0;padding:0;list-style:none}.sms-country-item{display:block;width:100%;padding:0.5rem 0.75rem;font-size:1rem;font-family:inherit;color:#495057;text-align:left;background-color:transparent;border:none;cursor:pointer;white-space:nowrap}.sms-country-item:hover,.sms-country-item:focus{background-color:#f8f9fa;color:#16181b;outline:none}#hidden-content-simple[data-open=\"false\"]{display:none}#hidden-content-simple[data-open=\"true\"]{display:block}@font-face{font-family:'ABC Favorit';src:url('/fonts/ABCFavorit-Regular.woff2') format('woff2');font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:'ABC Favorit';src:url('/fonts/ABCFavorit-Bold.woff2') format('woff2'),\n url('/fonts/ABCFavorit-Bold.woff') format('woff');font-weight:700;font-style:normal;font-display:swap}a.nav-tabs-item[href=\"/welcome\"]>img{display:none!important}a.nav-tabs-item[href=\"/welcome\"]::before{content:\"\";display:block;width:1rem;height:1rem;flex-shrink:0;background-color:currentColor;mask-image:url(/images/icons/home-02.svg);mask-size:contain;mask-repeat:no-repeat;mask-position:center;-webkit-mask-image:url(/images/icons/home-02.svg);-webkit-mask-size:contain;-webkit-mask-repeat:no-repeat;-webkit-mask-position:center}a.nav-tabs-item[data-active=\"true\"],a.nav-tabs-item[data-active=\"true\"].text-gray-800{color:#4c48ff!important;text-shadow:none!important}.dark a.nav-tabs-item[data-active=\"true\"],.dark a.nav-tabs-item[data-active=\"true\"].dark\\:text-gray-200{color:#5B68FF!important;text-shadow:none!important}a.nav-tabs-item[href=\"/welcome\"][data-active=\"true\"]::before{background-color:#4c48ff!important}.dark a.nav-tabs-item[href=\"/welcome\"][data-active=\"true\"]::before{background-color:#5B68FF!important}.scroll-mt-\\[var\\(--scroll-mt\\)\\]:has(.tk-page){max-width:none!important;width:100%!important;margin-inline:0!important;padding-inline:0!important}#content-container:has(.tk-page)>.flex.flex-row-reverse{flex-direction:row!important}#content-container:has(.tk-page) #content-area{width:100%!important;max-width:none!important;padding:0!important;margin:0!important}#content-container:has(.tk-page) #sidebar{display:none!important}#content-container:has(.tk-page) #content{max-width:none!important;padding:0!important}.tk-page{width:100%;max-width:92rem;margin-inline:auto;padding:0 3rem 5rem;box-sizing:border-box}@media (max-width: 1000px){.tk-page{padding-inline:40px}}@media (max-width: 868px){.tk-page{padding-inline:20px;padding-bottom:2.5rem}}.tk-img-light{display:block!important}.tk-img-dark{display:none!important}.dark .tk-img-light{display:none!important}.dark .tk-img-dark{display:block!important}.dark .tk-page{--tk-surface: #0B0B0F}.tk-placeholder{background:#f3f4f6;border:2px dashed #d1d5db;border-radius:10px;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:4px;padding:1.5rem;text-align:center;font-size:0.75rem;color:#9ca3af;box-sizing:border-box}.dark .tk-placeholder{background:#1f2937;border-color:#374151;color:#6b7280}.section-divider{border:none;border-top:1px solid #e5e7eb;margin:0}.dark .section-divider{border-top-color:rgba(255, 255, 255, 0.06)}.tk-hero{position:relative;overflow:hidden;padding:2.5rem 0 3rem;min-height:360px;display:flex;align-items:stretch;justify-content:flex-start;gap:2.5rem}.tk-hero-content{flex:0 1 720px;max-width:62%;min-width:0;align-self:flex-start;position:relative;z-index:2}.tk-hero-headline{color:var(--Black, #111);font-family:'ABC Favorit', sans-serif;font-size:82px;font-style:normal;font-weight:400;line-height:95%;letter-spacing:-4.1px;font-synthesis:none;margin:0 0 1.25rem;max-width:720px}.dark .tk-hero-headline{color:#f9fafb}.tk-hero-body{color:#414146;font-family:Inter, sans-serif;font-size:18px;font-style:normal;font-weight:400;line-height:28px;font-feature-settings:'ss01' on, 'ss03' on;margin:0 0 1.5rem;max-width:720px}.dark .tk-hero-body{color:#a1a1aa}.tk-build-body,.tk-whitepaper-text{color:#414146;font-family:Inter, sans-serif;font-size:16px;font-style:normal;font-weight:400;line-height:28px}.dark .tk-build-body,.dark .tk-whitepaper-text{color:#a1a1aa}.tk-search-bar{display:flex;align-items:center;gap:12px;border-radius:12px;border:1px solid var(--Black-20, rgba(0, 0, 0, 0.20));background:var(--Black-4, rgba(0, 0, 0, 0.04));padding:12px 16px;cursor:pointer;max-width:500px;transition:border-color 0.15s, background 0.15s}.tk-search-bar:hover{border-color:rgba(0, 0, 0, 0.28);background:rgba(0, 0, 0, 0.06)}.tk-search-icon{flex-shrink:0;color:#737277}.tk-search-placeholder{flex:1;color:#737277;text-align:left;font-family:Inter, sans-serif;font-size:16px;font-style:normal;font-weight:400;line-height:24px}.dark .tk-search-icon,.dark .tk-search-placeholder{color:#a1a1aa}.dark .tk-search-bar{border-color:rgba(255, 255, 255, 0.20);background:rgba(255, 255, 255, 0.04)}.dark .tk-search-bar:hover{border-color:rgba(255, 255, 255, 0.28);background:rgba(255, 255, 255, 0.06)}.tk-search-kbd{color:#737277;text-align:center;font-family:\"SF Pro\", -apple-system, BlinkMacSystemFont, sans-serif;font-size:12px;font-style:normal;font-weight:590;line-height:16px;border:none;border-radius:0;padding:0;background:transparent}.dark .tk-search-kbd{color:#a1a1aa;background:transparent}.tk-hero-illustration{position:relative;flex:0 0 657px;width:657px;min-height:329px;display:flex;align-items:center;justify-content:flex-start;z-index:1;pointer-events:none;user-select:none}.tk-hero>.tk-hero-grid{flex:none}.tk-hero-illustration>*{pointer-events:none;cursor:default}.tk-hero-grid{position:absolute;top:0;right:0;width:640px;height:512px;z-index:0;pointer-events:none}.tk-hero-grid img{display:block;width:640px;height:512px}.tk-hero-img{position:relative;display:block;width:657px;height:329px;flex-shrink:0;pointer-events:none;border:none}.tk-hero-img svg{display:block;width:657px;height:329px}@media (max-width: 1440px) and (min-width: 869px){.tk-hero{position:relative;flex-direction:row;align-items:flex-start;justify-content:flex-start;gap:1rem;width:100vw;max-width:100vw;margin-left:calc(50% - 50vw);padding:2.3125rem 0 2.5rem 3rem;min-height:auto;overflow:hidden;box-sizing:border-box}.tk-hero-grid{top:-3.3125rem;right:0;left:auto;width:640px;height:512px}.tk-hero-grid img{width:640px;height:512px;max-height:none;object-fit:none}.tk-hero-content{display:flex;flex-direction:column;gap:24px;flex:0 0 612px;max-width:612px;width:612px;align-self:flex-start;position:relative;z-index:2;isolation:isolate}.tk-hero-content::before{content:\"\";position:absolute;z-index:-1;top:0;right:0;bottom:0;left:0;width:100%;pointer-events:none;background:linear-gradient(\n 90deg,\n #ffffff 0%,\n #ffffff 75%,\n rgba(255, 255, 255, 0) 100%\n )}.dark .tk-hero-content::before{background:linear-gradient(\n 90deg,\n var(--tk-surface, #0B0B0F) 0%,\n var(--tk-surface, #0B0B0F) 75%,\n rgba(11, 11, 15, 0) 100%\n )}.tk-hero-headline{font-size:74px;letter-spacing:-3.7px;line-height:0.95;margin:0;max-width:none}.tk-hero-body{margin:0;max-width:none}.tk-search-bar{max-width:437px}.tk-hero-illustration{position:absolute;top:2.3125rem;right:0;display:block;flex:none;width:657px;min-width:657px;min-height:328px;margin:0;overflow:visible;z-index:1}.tk-hero-img{display:block;width:657px;max-width:none;height:auto}}@media (max-width: 1190px) and (min-width: 869px){.tk-hero-illustration{right:-100px}}@media (max-width: 1000px) and (min-width: 869px){.tk-hero{padding-left:40px}}@media (max-width: 1000px){.tk-whitepaper{padding:20px 40px 0}}@media (max-width: 868px){.tk-hero{flex-direction:column;gap:0;padding:2.25rem 0 2.5rem;min-height:auto;overflow:visible}.tk-hero-grid{display:none}.tk-hero-illustration{display:none}.tk-hero-content{display:flex;flex-direction:column;gap:24px;flex:1 1 auto;max-width:100%;width:100%;isolation:auto}.tk-hero-content::before{display:none}.tk-hero-headline{font-size:44px;letter-spacing:-2.2px;line-height:0.95;margin:0}.tk-hero-body{margin:0}.tk-search-bar{max-width:none;width:100%}.tk-build,.tk-solutions-section,.tk-features-section,.tk-whitepaper-section{margin:2.5rem 0}}.tk-section-heading{font-family:Inter, sans-serif;font-size:30px;font-weight:700;letter-spacing:-0.75px;line-height:1.2;margin:0 0 1.25rem;color:#1a191e}.dark .tk-section-heading{color:#f9fafb}.tk-build{display:grid;grid-template-columns:1fr;gap:28px;align-items:start;margin:52px 0}.tk-build-intro{display:contents}.tk-build-copy{display:flex;flex-direction:column;gap:28px;grid-column:1;grid-row:1}.tk-build-visual{display:flex;flex-direction:row;align-items:center;justify-content:flex-start;gap:40px;grid-column:1;grid-row:2;width:100%;justify-self:start}.tk-build-links{grid-column:1;grid-row:3}.tk-build-selectors{flex:0 0 auto;min-width:0;max-width:none;justify-content:flex-start}.tk-selector-list{width:100%;max-width:100%}@media (min-width: 869px) and (max-width: 1379px){.tk-build-visual{justify-content:center;justify-self:center;width:fit-content;max-width:100%;margin-inline:auto}}@media (min-width: 1380px){.tk-build{display:grid;grid-template-columns:minmax(0, 558px) auto;width:100%;gap:40px;align-items:center;justify-items:start}.tk-build-intro{display:flex;flex-direction:column;gap:28px;min-width:0;max-width:558px}.tk-build-copy{grid-column:unset;grid-row:unset;max-width:none}.tk-build-links{grid-column:unset;grid-row:unset}.tk-build-visual{display:flex;flex-direction:row;align-items:center;justify-content:flex-start;gap:40px;width:auto;min-width:0;grid-column:unset;grid-row:unset;justify-self:start}.tk-build-selectors{flex:0 0 auto;min-width:auto;max-width:none;justify-content:flex-start}.tk-selector-list{width:max-content;max-width:100%}}.tk-build-heading{font-family:Inter, sans-serif;font-size:30px;font-weight:700;letter-spacing:-0.75px;line-height:normal;margin:0;color:#1a191e}.dark .tk-build-heading{color:#f9fafb}.tk-build-body{margin:0}.tk-build-links{display:flex;flex-direction:row;gap:40px;flex-wrap:wrap}.tk-build-link{display:inline-flex;align-items:center;gap:7px;color:#4C48FF;font-weight:500;text-decoration:none;font-size:0.875rem;transition:opacity 0.15s}.tk-build-link-icon{flex-shrink:0}.dark .tk-build-link{color:#5B68FF}.tk-build-link:hover{opacity:0.75}.tk-build-cube{width:149px;flex-shrink:0;margin:0;padding:0;align-self:center}.tk-cube-wrapper{position:relative;width:149px;height:170px;margin:0;padding:0;pointer-events:none;user-select:none}.tk-plane-img{position:absolute;top:0;left:0;width:100%;height:100%;object-fit:contain;opacity:0;visibility:hidden;transition:none;pointer-events:none;cursor:default}.tk-build[data-selected=\"a\"] .tk-plane-img[data-plane=\"a\"],.tk-build[data-selected=\"b\"] .tk-plane-img[data-plane=\"b\"],.tk-build[data-selected=\"c\"] .tk-plane-img[data-plane=\"c\"]{opacity:1;visibility:visible}.tk-build-selectors{display:flex;flex-direction:row;align-items:center;gap:17px;width:max-content;max-width:100%;flex-shrink:0;overflow:visible}.tk-build-connectors{position:relative;flex-shrink:0;width:40px;height:120px;margin-left:-24px;pointer-events:none}.tk-connector-line{position:absolute;left:0;width:40px;height:0}.tk-connector-line--a{top:20px}.tk-connector-line--b{top:60px}.tk-connector-line--c{top:100px}.tk-connector-line::after{content:\"\";position:absolute;left:0;right:0;top:0;height:1px;background:rgba(0, 0, 0, 0.2);transition:background 0.15s}.dark .tk-connector-line::after{background:rgba(255, 255, 255, 0.2)}.tk-build[data-selected=\"a\"] .tk-connector-line--a::after,.tk-build[data-selected=\"b\"] .tk-connector-line--b::after,.tk-build[data-selected=\"c\"] .tk-connector-line--c::after{background:#4C48FF}.dark .tk-build[data-selected=\"a\"] .tk-connector-line--a::after,.dark .tk-build[data-selected=\"b\"] .tk-connector-line--b::after,.dark .tk-build[data-selected=\"c\"] .tk-connector-line--c::after{background:#5B68FF}.tk-selector-list{position:relative;flex-shrink:0;display:grid;grid-template-columns:1fr;gap:0;width:max-content;max-width:100%}.tk-selector-row{position:relative;display:flex;align-items:center;gap:12px;box-sizing:border-box;width:100%;height:40px;min-height:40px;padding:8px 36px 8px 12px;white-space:nowrap;text-decoration:none;color:inherit;border-radius:8px;border:none;transition:background 0.15s, color 0.15s}.tk-build[data-selected=\"a\"] #tk-row-a,.tk-build[data-selected=\"b\"] #tk-row-b,.tk-build[data-selected=\"c\"] #tk-row-c{background:rgba(76, 72, 255, 0.12)}.dark .tk-build[data-selected=\"a\"] #tk-row-a,.dark .tk-build[data-selected=\"b\"] #tk-row-b,.dark .tk-build[data-selected=\"c\"] #tk-row-c{background:rgba(91, 104, 255, 0.12)}.tk-selector-icon{width:24px;height:24px;display:flex;align-items:center;justify-content:center;flex-shrink:0;color:#28282c;opacity:0.5;background:none;border-radius:0;transition:color 0.15s, opacity 0.15s}.tk-selector-icon svg{width:24px;height:24px}.tk-selector-icon svg path,.tk-selector-icon svg g path{stroke-width:1.5}.dark .tk-selector-icon{color:#d1d5db}.tk-selector-label{font-family:Inter, sans-serif;font-size:14px;font-weight:600;line-height:normal;color:#28282c;flex-shrink:0;transition:color 0.15s}.dark .tk-selector-label{color:#f3f4f6}.tk-build[data-selected=\"a\"] #tk-row-a .tk-selector-label,.tk-build[data-selected=\"b\"] #tk-row-b .tk-selector-label,.tk-build[data-selected=\"c\"] #tk-row-c .tk-selector-label{color:#4C48FF}.dark .tk-build[data-selected=\"a\"] #tk-row-a .tk-selector-label,.dark .tk-build[data-selected=\"b\"] #tk-row-b .tk-selector-label,.dark .tk-build[data-selected=\"c\"] #tk-row-c .tk-selector-label{color:#5B68FF}.tk-build[data-selected=\"a\"] #tk-row-a .tk-selector-icon,.tk-build[data-selected=\"b\"] #tk-row-b .tk-selector-icon,.tk-build[data-selected=\"c\"] #tk-row-c .tk-selector-icon{opacity:1;color:#4C48FF}.dark .tk-build[data-selected=\"a\"] #tk-row-a .tk-selector-icon,.dark .tk-build[data-selected=\"b\"] #tk-row-b .tk-selector-icon,.dark .tk-build[data-selected=\"c\"] #tk-row-c .tk-selector-icon{color:#5B68FF}.tk-selector-desc{font-family:Inter, sans-serif;font-size:14px;font-weight:400;line-height:1.48;color:#505454;flex-shrink:1;min-width:0}.dark .tk-selector-desc{color:#9ca3af}.tk-selector-chevron{position:absolute;right:8px;top:50%;display:flex;align-items:center;justify-content:center;width:20px;height:20px;transform:translateY(-50%);opacity:0;color:#4C48FF;pointer-events:none;transition:opacity 0.2s ease}.dark .tk-selector-chevron{color:#5B68FF}.tk-selector-chevron svg{width:20px;height:20px}.tk-selector-chevron svg path{stroke-width:1.5}.tk-build[data-selected=\"a\"] #tk-row-a .tk-selector-chevron,.tk-build[data-selected=\"b\"] #tk-row-b .tk-selector-chevron,.tk-build[data-selected=\"c\"] #tk-row-c .tk-selector-chevron,.tk-selector-row:hover .tk-selector-chevron{opacity:1}@media (max-width: 868px){.tk-build{grid-template-columns:1fr;align-items:start;gap:28px}.tk-build-intro{display:contents}.tk-build-copy{grid-column:1 / -1;grid-row:1}.tk-build-links{grid-column:1 / -1;grid-row:2;gap:40px}.tk-build-visual{grid-column:1 / -1;grid-row:3;flex-direction:column;gap:16px;width:100%;align-items:center;padding:0}.tk-build-cube{width:100%;max-width:149px;margin:0 auto}.tk-cube-wrapper{width:149px;height:170px;margin:0 auto}.tk-build[data-selected=\"c\"]:not([data-user-picked]) .tk-plane-img[data-plane=\"c\"]{opacity:0;visibility:hidden}.tk-build[data-selected=\"c\"]:not([data-user-picked]) .tk-plane-img[data-plane=\"a\"]{opacity:1;visibility:visible}.tk-build-selectors{width:100%;max-width:100%;justify-content:stretch}.tk-build-connectors{display:none}.tk-selector-list{width:100%;max-width:100%;gap:0}.tk-selector-row{display:grid;grid-template-columns:24px minmax(0, 1fr) 20px;grid-template-rows:auto auto;column-gap:12px;row-gap:0;align-items:center;width:100%;max-width:100%;height:auto;min-height:54px;padding:8px;white-space:normal;background:transparent!important;border-radius:0}.tk-selector-row+.tk-selector-row{border-top:1px solid rgba(0, 0, 0, 0.12);margin-top:4px}.dark .tk-selector-row+.tk-selector-row{border-top-color:rgba(255, 255, 255, 0.06)}.tk-selector-icon{grid-column:1;grid-row:1 / 3;align-self:center;opacity:1;color:#4C48FF}.dark .tk-selector-icon{color:#5B68FF}.tk-selector-label{grid-column:2;grid-row:1;font-weight:500;color:#4C48FF}.dark .tk-selector-label{color:#5B68FF}.tk-selector-desc{grid-column:2;grid-row:2;white-space:normal;overflow:visible;text-overflow:unset}.tk-selector-chevron{grid-column:3;grid-row:1 / 3;position:static;transform:none;opacity:1}}.tk-solutions-section{display:flex;flex-direction:column;gap:28px;margin:52px 0}.tk-solutions-section .tk-solution-card{display:grid!important}.tk-solutions-section .tk-section-heading{margin:0}.tk-solutions-grid{display:grid;grid-template-columns:repeat(2, 1fr);column-gap:24px;row-gap:20px;width:100%}.tk-solution-card{grid-row:span 3;display:grid;grid-template-rows:subgrid;box-sizing:border-box;padding:20px 32px 36px;background:rgba(0, 0, 0, 0.02);border:1px solid rgba(13, 12, 17, 0.1);border-radius:16px}.tk-solution-copy{display:flex;flex-direction:column;gap:8px;min-width:0}.dark .tk-solution-card{background:rgba(255, 255, 255, 0.02);border-color:rgba(255, 255, 255, 0.12)}.tk-solution-thumbnail{width:120px;height:120px;flex-shrink:0}.tk-solution-thumbnail img{display:block;width:100%;height:100%;object-fit:contain}.tk-solution-copy .tk-solution-title,.tk-solution-card>.tk-solution-title-row{min-width:0}.tk-solution-title-row{display:inline-flex;align-items:center;gap:12px;flex-wrap:nowrap;width:fit-content;max-width:100%}.tk-solution-title-row .tk-solution-title{width:auto;max-width:none}.tk-solution-title-long{display:inline}.tk-solution-title-short{display:none}.tk-solution-title{font-family:Inter, sans-serif;font-size:24px;font-weight:600;letter-spacing:-0.6px;line-height:32px;margin:0;color:#111827;text-decoration:none}.dark .tk-solution-title{color:#f9fafb}.tk-solution-desc{margin:0;font-family:Inter, sans-serif;font-size:14px;font-weight:400;line-height:1.48;color:#414146;min-width:0}.dark .tk-solution-desc{color:#a1a1aa}.tk-solution-links{display:flex;flex-direction:column;gap:16px;align-items:flex-start;min-width:0;border-top:1px solid rgba(0, 0, 0, 0.12);padding-top:20px}.dark .tk-solution-links{border-top-color:rgba(255, 255, 255, 0.06)}.tk-solution-link{text-decoration:none;font-family:Inter, sans-serif;font-size:14px;font-weight:500;color:#4C48FF;transition:opacity 0.15s}.tk-solution-link:hover{opacity:0.75;color:#4C48FF}.dark .tk-solution-link{color:#5B68FF}.dark .tk-solution-link:hover{opacity:0.75}@media (max-width: 768px){.tk-solutions-grid{grid-template-columns:1fr}}.tk-features-section{display:flex;flex-direction:column;gap:28px;margin:52px 0}.tk-features-section .tk-section-heading{margin:0}.tk-features-grid{display:grid;grid-template-columns:repeat(3, 1fr);gap:40px;width:100%}.tk-feature-column{display:flex;flex-direction:column;gap:12px;min-width:0}.tk-feature-column-heading{font-family:Inter, sans-serif;font-size:18px;font-weight:600;line-height:32px;color:#111827;margin:0}.dark .tk-feature-column-heading{color:#f9fafb}.tk-feature-items{display:flex;flex-direction:column;gap:8px;width:100%}.tk-feature-divider{border:none;height:1px;margin:0;background:rgba(0, 0, 0, 0.12)}.dark .tk-feature-divider{background:rgba(255, 255, 255, 0.06)}.tk-feature-row{display:flex;align-items:center;gap:12px;padding:4px 0;text-decoration:none;color:#000000;font-family:Inter, sans-serif;font-size:16px;font-weight:500;line-height:normal;transition:color 0.12s ease}.dark .tk-feature-row{color:#f3f4f6}.tk-feature-row:hover,.tk-feature-row:focus-visible{color:#4C48FF}.dark .tk-feature-row:hover,.dark .tk-feature-row:focus-visible{color:#5B68FF}.tk-feature-icon-circle{display:flex;align-items:center;justify-content:center;flex-shrink:0;padding:6px;border-radius:9999px;background:rgba(0, 0, 0, 0.04);border:1px solid rgba(0, 0, 0, 0.12);color:#000000;transition:background 0.12s ease, border-color 0.12s ease, color 0.12s ease}.dark .tk-feature-icon-circle{background:rgba(255, 255, 255, 0.04);border-color:rgba(255, 255, 255, 0.12);color:#f3f4f6}.tk-feature-row:hover .tk-feature-icon-circle,.tk-feature-row:focus-visible .tk-feature-icon-circle{background:#f1f3ff;border-color:#c9ceff;color:#4C48FF}.dark .tk-feature-row:hover .tk-feature-icon-circle,.dark .tk-feature-row:focus-visible .tk-feature-icon-circle{background:rgba(91, 104, 255, 0.15);border-color:rgba(91, 104, 255, 0.35);color:#5B68FF}.tk-feature-icon-circle svg,.tk-feature-icon-circle .tk-feature-icon-img{width:20px;height:20px;display:block;flex-shrink:0;opacity:0.5;transition:opacity 0.12s ease}.tk-feature-row:hover .tk-feature-icon-circle svg,.tk-feature-row:focus-visible .tk-feature-icon-circle svg,.tk-feature-row:hover .tk-feature-icon-circle .tk-feature-icon-img,.tk-feature-row:focus-visible .tk-feature-icon-circle .tk-feature-icon-img{opacity:1}.tk-feature-icon-img{background-color:currentColor;mask-repeat:no-repeat;mask-position:center;mask-size:contain;-webkit-mask-repeat:no-repeat;-webkit-mask-position:center;-webkit-mask-size:contain}.tk-feature-icon-img--wallet-embedded{mask-image:url('/images/icons/wallet-embedded.svg');-webkit-mask-image:url('/images/icons/wallet-embedded.svg')}.tk-feature-icon-img--fuel{mask-image:url('/images/icons/fuel.svg');-webkit-mask-image:url('/images/icons/fuel.svg')}.tk-feature-icon-circle svg path,.tk-feature-icon-circle svg g path,.tk-feature-icon-circle svg line,.tk-feature-icon-circle svg circle,.tk-feature-icon-circle svg rect{stroke-width:1.5px;vector-effect:non-scaling-stroke}.tk-feature-label{flex:1;min-width:0}.tk-feature-row::after{content:'';width:20px;height:20px;flex-shrink:0;opacity:0;transition:opacity 0.12s ease;background-color:#4C48FF;mask-image:url('/images/icons/chevron-right.svg');mask-repeat:no-repeat;mask-position:center;mask-size:contain;-webkit-mask-image:url('/images/icons/chevron-right.svg');-webkit-mask-repeat:no-repeat;-webkit-mask-position:center;-webkit-mask-size:contain}.dark .tk-feature-row::after{background-color:#5B68FF}.tk-feature-row:hover::after,.tk-feature-row:focus-visible::after{opacity:1}@media (max-width: 868px){.tk-features-grid{grid-template-columns:1fr;gap:40px}.tk-feature-row--chevron::after{opacity:1}}.tk-whitepaper-section{margin:52px 0}.tk-whitepaper{position:relative;display:flex;align-items:flex-start;justify-content:center;padding:20px 48px 0;background:rgba(0, 0, 0, 0.02);border:1px solid rgba(13, 12, 17, 0.1);border-radius:16px;overflow:hidden}.dark .tk-whitepaper{background:rgba(255, 255, 255, 0.02);border-color:rgba(255, 255, 255, 0.1)}.tk-whitepaper-inner{display:flex;gap:40px;align-items:flex-start;width:auto;max-width:100%;box-sizing:border-box;padding:0;min-height:132px}.tk-whitepaper-thumb-wrap{position:relative;flex-shrink:0;align-self:flex-end;width:121px;height:132px;overflow:hidden;box-shadow:0 4px 12px rgba(0, 0, 0, 0.1)}.tk-whitepaper-thumb{position:absolute;top:0;left:-46.26%;height:100%;width:192.52%;max-width:none;display:block;pointer-events:none}.tk-whitepaper-content{display:flex;flex-direction:column;gap:12px;align-items:flex-start;align-self:flex-start;padding-top:12px;padding-bottom:0;min-width:0;max-width:476px}.tk-whitepaper-text{margin:0;max-width:476px}.tk-whitepaper-link{display:inline-flex;align-items:center;gap:8px;color:#4C48FF;font-family:Inter, sans-serif;font-size:14px;font-weight:500;line-height:normal;text-decoration:none;transition:opacity 0.15s;white-space:nowrap}.tk-whitepaper-link-icon{display:flex;flex-shrink:0;width:20px;height:20px;color:#4C48FF}.tk-whitepaper-link-icon svg{width:20px;height:20px;display:block}.tk-whitepaper-link-icon svg path{stroke-width:1.5px;vector-effect:non-scaling-stroke}.dark .tk-whitepaper-link,.dark .tk-whitepaper-link-icon{color:#5B68FF}.tk-whitepaper-link:hover{opacity:0.75}@media (max-width: 868px){.tk-whitepaper{justify-content:flex-start;padding:0}.tk-whitepaper-thumb-wrap{position:absolute;left:24px;bottom:0}.tk-whitepaper-inner{flex-direction:column;align-items:flex-start;gap:0;width:100%;padding:20px 24px 132px}.tk-whitepaper-content{padding-top:12px;padding-bottom:0;margin-bottom:24px;align-items:flex-start;align-self:stretch;text-align:left;width:100%}.tk-whitepaper-text{max-width:none}}.tk-badge{font-family:Inter, sans-serif;font-size:10px;font-weight:500;line-height:normal;background:#ede9fe;color:#4C48FF;border-radius:4px;padding:2px 6px;flex-shrink:0}.dark .tk-badge{background:rgba(91, 104, 255, 0.2);color:#5B68FF}.tk-card-icon-wrap{display:flex;align-items:center;justify-content:center;flex-shrink:0;width:44px;height:44px;border-radius:9999px;border:1px solid rgba(0, 0, 0, 0.16);background:#ffffff;box-sizing:border-box}.dark .tk-card-icon-wrap{background:transparent;border-color:rgba(255, 255, 255, 0.16)}.tk-card-icon{display:block;flex-shrink:0;width:24px;height:25px;background-color:#505454;mask-size:contain;mask-repeat:no-repeat;mask-position:center;-webkit-mask-size:contain;-webkit-mask-repeat:no-repeat;-webkit-mask-position:center}.dark .tk-card-icon{background-color:#ffffff}.tk-card-row{display:flex;align-items:flex-start;gap:16px}.tk-network-cards .tk-card-row{align-items:center}.tk-card-network-logo{display:block;width:24px;height:24px;object-fit:contain}.dark .tk-network-cards .tk-card-network-logo[src$=\"cosmos.svg\"],.dark .tk-network-cards .tk-card-network-logo[src$=\"aptos.svg\"],.dark .tk-network-cards .tk-card-network-logo[src$=\"tempo.svg\"],.dark .tk-network-cards .tk-card-network-logo[src$=\"iota.svg\"]{filter:brightness(0) invert(1)}.tk-card-icon-img{display:block;flex-shrink:0;width:44px;height:44px}#content [data-table-wrapper=\"true\"]{width:100%!important;max-width:100%!important;margin-inline:0!important;contain:none!important}.policy-language :is(h3,h4) a[aria-label=\"Navigate to header\"]{opacity:1}.policy-language a[id]{scroll-margin-top:var(--scroll-mt)}.policy-language [data-table-wrapper=\"true\"] :is(th,td,th *,td *){overflow-wrap:anywhere}.policy-language [data-table-wrapper=\"true\"] td{min-width:5rem}@media (min-width: 768px){.policy-language [data-table-wrapper=\"true\"] td:not(:last-child){min-width:max(8.5rem, 25cqi)}.policy-language [data-table-wrapper=\"true\"] table:has(th:nth-child(5)) td:not(:last-child){min-width:max(6.5rem, 18cqi)}}#content .policy-language [data-table-wrapper=\"true\"]{width:calc(100% + (var(--page-padding) * 2))!important;max-width:none!important;margin-inline:calc(var(--page-padding) * -1)!important}@media (min-width: 1280px){#content-area:has(.policy-language){width:calc(100% - 15rem)!important;padding-left:2rem!important;margin-left:0!important}#content-container:has(.policy-language) #table-of-contents-layout{width:14rem!important;padding-left:1.5rem!important}#content-container:has(.policy-language) #table-of-contents{width:auto!important}}"}]}
{"page":{"pagePath":"solutions/embedded-wallets/integration-guide/typescript/auth","slug":"/solutions/embedded-wallets/integration-guide/typescript/auth","pageMetadata":{"title":"Authentication","description":"Learn how to set up authentication that leverages Turnkey's Auth Proxy using @turnkey/core in your frontend JavaScript application.","sidebarTitle":"Authentication","href":"/solutions/embedded-wallets/integration-guide/typescript/auth"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Learn how to set up authentication that leverages Turnkey’s Auth Proxy using @turnkey/core in your frontend JavaScript application.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Heading}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`triggering-authentication`,children:`Triggering authentication`}),`\n`,_jsx(_components.p,{children:`You can call the specific login or signup methods you want to support. For example, with passkeys:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Log in with a passkey`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` session`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` turnkeyClient`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`loginWithPasskey`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Or sign up with a passkey`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` session`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` turnkeyClient`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`signUpWithPasskey`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Here’s an example using email OTP:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Log in with email OTP`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`OtpType`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"@turnkey/core\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` otpId`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` turnkeyClient`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`initOtp`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`otpType:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` OtpType`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Email`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`contact:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"email@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` })`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` session`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` turnkeyClient`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`completeOtp`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` otpId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` otpCode:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 123456`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// The code the user received via email or SMS`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` contact:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"email@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` otpType:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` OtpType`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Email`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Sessions will be automatically created and stored in the browser’s local storage or mobile async storage on React Native.`}),`\n`,_jsx(Heading,{level:`2`,id:`checking-authentication-state`,children:`Checking authentication state`}),`\n`,_jsxs(_components.p,{children:[`To check if a user is authenticated, call `,_jsx(_components.code,{children:`client.getSession()`}),` and verify the expiry:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` session`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` turnkeyClient`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`getSession`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`session`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u0026\u0026`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` session`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`expiry`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`*`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 1000`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` >`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` Date`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`now`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`()) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"User is authenticated:\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`session`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`} `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`else`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"User is not authenticated\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`If the session is expired or the user is done with their session, you can log them out:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` turnkeyClient`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`logout`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Authentication","description":"Learn how to set up authentication that leverages Turnkey's Auth Proxy using @turnkey/core in your frontend JavaScript application.","sidebarTitle":"Authentication","href":"/solutions/embedded-wallets/integration-guide/typescript/auth"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Triggering authentication","slug":"triggering-authentication","depth":2,"children":[]},{"title":"Checking authentication state","slug":"checking-authentication-state","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/turnkey-0e7c1f5b/788886ec77a9d964/ga.js","/_mintlify/custom/turnkey-0e7c1f5b/c849d0b15d4f5866/hero-animation.js"],"subdomain":"turnkey-0e7c1f5b","siteName":"Turnkey","title":"Authentication - Turnkey","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-27T12:31:05.747Z","originalFileLocation":"solutions/embedded-wallets/integration-guide/typescript/auth.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Learn how to set up authentication that leverages Turnkey\u0026#x27;s Auth Proxy using @turnkey/core in your frontend JavaScript application.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Turnkey\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/turnkey-0e7c1f5b/umYhjB0nyuI1BMHQ/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/turnkey-0e7c1f5b/umYhjB0nyuI1BMHQ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/turnkey-0e7c1f5b/umYhjB0nyuI1BMHQ/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/turnkey-0e7c1f5b/umYhjB0nyuI1BMHQ/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/turnkey-0e7c1f5b/umYhjB0nyuI1BMHQ/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/turnkey-0e7c1f5b/umYhjB0nyuI1BMHQ/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/turnkey-0e7c1f5b/umYhjB0nyuI1BMHQ/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/turnkey-0e7c1f5b/umYhjB0nyuI1BMHQ/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/turnkey-0e7c1f5b/umYhjB0nyuI1BMHQ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Authentication - Turnkey\">\u003cmeta data-mint-head property=\"og:description\" content=\"Learn how to set up authentication that leverages Turnkey\u0026#x27;s Auth Proxy using @turnkey/core in your frontend JavaScript application.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Turnkey\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.turnkey.com/solutions/embedded-wallets/integration-guide/typescript/auth\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.turnkey.com/images/og-image.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Authentication - Turnkey\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Learn how to set up authentication that leverages Turnkey\u0026#x27;s Auth Proxy using @turnkey/core in your frontend JavaScript application.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.turnkey.com/images/og-image.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/turnkey-0e7c1f5b/umYhjB0nyuI1BMHQ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Turnkey\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4C48FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.turnkey.com/solutions/embedded-wallets/integration-guide/typescript/auth\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/solutions/embedded-wallets/integration-guide/typescript/auth.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.turnkey.com/#organization\",\"name\":\"Turnkey\",\"url\":\"https://docs.turnkey.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/turnkey-0e7c1f5b/YQKQ_azrjtJ471Qy/logo/light.svg?fit=max\u0026auto=format\u0026n=YQKQ_azrjtJ471Qy\u0026q=85\u0026s=38556c8732a1d68a5399fce905b480b1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.turnkey.com#website\",\"name\":\"Turnkey\",\"url\":\"https://docs.turnkey.com\",\"publisher\":{\"@id\":\"https://docs.turnkey.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.turnkey.com/solutions/embedded-wallets/integration-guide/typescript/auth#webpage\",\"url\":\"https://docs.turnkey.com/solutions/embedded-wallets/integration-guide/typescript/auth\",\"name\":\"Authentication\",\"description\":\"Learn how to set up authentication that leverages Turnkey's Auth Proxy using @turnkey/core in your frontend JavaScript application.\",\"dateModified\":\"2026-05-27T12:31:05.747Z\",\"isPartOf\":{\"@id\":\"https://docs.turnkey.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.turnkey.com/solutions/embedded-wallets/integration-guide/typescript/auth#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.turnkey.com/solutions/embedded-wallets/integration-guide/typescript/auth#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Embedded Wallets\",\"item\":\"https://docs.turnkey.com/solutions/embedded-wallets/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Integration guide\",\"item\":\"https://docs.turnkey.com/solutions/embedded-wallets/integration-guide/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"TypeScript\",\"item\":\"https://docs.turnkey.com/solutions/embedded-wallets/integration-guide/typescript\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Authentication\",\"item\":\"https://docs.turnkey.com/solutions/embedded-wallets/integration-guide/typescript/auth\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.turnkey.com/solutions/embedded-wallets/integration-guide/typescript/auth#article\",\"headline\":\"Authentication\",\"name\":\"Authentication\",\"description\":\"Learn how to set up authentication that leverages Turnkey's Auth Proxy using @turnkey/core in your frontend JavaScript application.\",\"url\":\"https://docs.turnkey.com/solutions/embedded-wallets/integration-guide/typescript/auth\",\"mainEntityOfPage\":{\"@id\":\"https://docs.turnkey.com/solutions/embedded-wallets/integration-guide/typescript/auth#webpage\"},\"image\":\"https://docs.turnkey.com/images/og-image.png\",\"dateModified\":\"2026-05-27T12:31:05.747Z\",\"publisher\":{\"@id\":\"https://docs.turnkey.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.turnkey.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Turnkey\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Turnkey\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/solutions/embedded-wallets/integration-guide/typescript/auth.md","siteName":"Turnkey","nav":{"global":{},"tabs":[{"tab":"Home","icon":"https://mintlify.s3.us-west-1.amazonaws.com/turnkey-0e7c1f5b/images/icons/home-02.svg","pages":[{"title":"Home","href":"/welcome"}]},{"tab":"Solutions","groups":[{"group":"Overview","pages":[{"title":"Introducing Turnkey Solutions","href":"/solutions/overview"}]},{"group":"Embedded Wallets","pages":[{"title":"Overview","href":"/solutions/embedded-wallets/overview"},{"group":"Solution","pages":[{"title":"Embedded Consumer Wallet","href":"/solutions/embedded-wallets/embedded-consumer-wallet"},{"title":"Embedded Business Wallets","href":"/solutions/embedded-wallets/embedded-business-wallets"},{"title":"Embedded Wallet-as-a-Service","sidebarTitle":"Wallet-as-a-Service","href":"/solutions/embedded-wallets/embedded-waas"}]},{"title":"Embedded wallets quickstart","sidebarTitle":"Quickstart","href":"/solutions/embedded-wallets/quickstart"},{"group":"Integration guide","pages":[{"title":"Integration guide","sidebarTitle":"Overview","href":"/solutions/embedded-wallets/integration-guide/overview"},{"group":"React","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/solutions/embedded-wallets/integration-guide/react/index"},{"title":"Getting started with Turnkey's Embedded Wallet Kit","sidebarTitle":"Getting started","href":"/solutions/embedded-wallets/integration-guide/react/getting-started"},{"title":"Authentication","sidebarTitle":"Authentication","href":"/solutions/embedded-wallets/integration-guide/react/auth"},{"title":"Captcha","sidebarTitle":"Captcha","href":"/solutions/embedded-wallets/integration-guide/react/captcha"},{"title":"Using embedded wallets","sidebarTitle":"Using embedded wallets","href":"/solutions/embedded-wallets/integration-guide/react/using-embedded-wallets"},{"group":"Using external wallets","pages":[{"title":"Using external wallets","sidebarTitle":"Overview","href":"/solutions/embedded-wallets/integration-guide/react/using-external-wallets/overview"},{"title":"External wallet authentication","sidebarTitle":"Authentication","href":"/solutions/embedded-wallets/integration-guide/react/using-external-wallets/authentication"},{"title":"Connecting external wallets","sidebarTitle":"Connecting","href":"/solutions/embedded-wallets/integration-guide/react/using-external-wallets/connecting"}]},{"title":"Signing","sidebarTitle":"Signing","href":"/solutions/embedded-wallets/integration-guide/react/signing"},{"title":"UI customization","sidebarTitle":"UI customization","href":"/solutions/embedded-wallets/integration-guide/react/ui-customization"},{"title":"Sub-organization customization","sidebarTitle":"Sub-organization customization","href":"/solutions/embedded-wallets/integration-guide/react/sub-organization-customization"},{"title":"Advanced API requests","sidebarTitle":"Advanced API requests","href":"/solutions/embedded-wallets/integration-guide/react/advanced-api-requests"},{"title":"Advanced backend authentication","sidebarTitle":"Advanced backend authentication","href":"/solutions/embedded-wallets/integration-guide/react/advanced-backend-authentication"},{"title":"Troubleshooting","sidebarTitle":"Troubleshooting","href":"/solutions/embedded-wallets/integration-guide/react/troubleshooting"},{"title":"Migrating to @turnkey/react-wallet-kit from @turnkey/sdk-react","sidebarTitle":"Migrating from @turnkey/sdk-react","href":"/solutions/embedded-wallets/integration-guide/react/migrating-sdk-react"}]},{"group":"React Native","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/solutions/embedded-wallets/integration-guide/react-native/overview"},{"title":"Getting started with Turnkey's Embedded Wallet Kit","sidebarTitle":"Getting started","href":"/solutions/embedded-wallets/integration-guide/react-native/getting-started"},{"group":"Authentication","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/solutions/embedded-wallets/integration-guide/react-native/authentication/overview"},{"title":"Email and SMS OTP authentication","sidebarTitle":"Email \u0026 SMS","href":"/solutions/embedded-wallets/integration-guide/react-native/authentication/email-sms"},{"title":"Passkey authentication","sidebarTitle":"Passkeys","href":"/solutions/embedded-wallets/integration-guide/react-native/authentication/passkey"},{"title":"Social logins","sidebarTitle":"Social logins","href":"/solutions/embedded-wallets/integration-guide/react-native/authentication/social-logins"},{"title":"Captcha","sidebarTitle":"Captcha","href":"/solutions/embedded-wallets/integration-guide/react-native/authentication/captcha"}]},{"title":"Sub-organization customization","sidebarTitle":"Sub-organization customization","href":"/solutions/embedded-wallets/integration-guide/react-native/sub-organization-customization"},{"title":"Using embedded wallets","sidebarTitle":"Using embedded wallets","href":"/solutions/embedded-wallets/integration-guide/react-native/using-embedded-wallets"},{"title":"Signing","sidebarTitle":"Signing","href":"/solutions/embedded-wallets/integration-guide/react-native/signing"},{"title":"Advanced API requests","sidebarTitle":"Advanced API requests","href":"/solutions/embedded-wallets/integration-guide/react-native/advanced-api-requests"},{"title":"Migrating to @turnkey/react-native-wallet-kit from @turnkey/sdk-react-native","sidebarTitle":"Migrating from @turnkey/sdk-react-native","href":"/solutions/embedded-wallets/integration-guide/react-native/migrating-sdk-react-native"}]},{"group":"TypeScript","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/solutions/embedded-wallets/integration-guide/typescript/index"},{"title":"Getting started with @turnkey/core","description":"Learn how to set up `@turnkey/core` in your frontend JavaScript application. This page will guide you through creating a Turnkey organization, configuring authentication, installing the SDK, and initializing the client.","sidebarTitle":"Getting started","href":"/solutions/embedded-wallets/integration-guide/typescript/getting-started"},{"title":"Authentication","sidebarTitle":"Authentication","href":"/solutions/embedded-wallets/integration-guide/typescript/auth"},{"title":"Captcha","description":"Add Cloudflare Turnstile captcha protection to your auth flows when building your own UI with @turnkey/core.","sidebarTitle":"Captcha","href":"/solutions/embedded-wallets/integration-guide/typescript/captcha"},{"title":"Advanced backend authentication","sidebarTitle":"Advanced backend authentication","href":"/solutions/embedded-wallets/integration-guide/typescript/advanced-backend-authentication"},{"title":"Advanced API requests","sidebarTitle":"Advanced API requests","href":"/solutions/embedded-wallets/integration-guide/typescript/advanced-api-requests"}]},{"group":"Flutter","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/solutions/embedded-wallets/integration-guide/flutter/index"},{"title":"Getting started with Turnkey's Flutter SDK","sidebarTitle":"Getting started","href":"/solutions/embedded-wallets/integration-guide/flutter/getting-started"},{"group":"Authentication","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/solutions/embedded-wallets/integration-guide/flutter/authentication/overview"},{"title":"Email and SMS OTP authentication","sidebarTitle":"Email \u0026 SMS","href":"/solutions/embedded-wallets/integration-guide/flutter/authentication/email-sms"},{"title":"Passkey authentication","sidebarTitle":"Passkeys","href":"/solutions/embedded-wallets/integration-guide/flutter/authentication/passkey"},{"title":"Social logins","sidebarTitle":"Social logins","href":"/solutions/embedded-wallets/integration-guide/flutter/authentication/social-logins"}]},{"title":"Sub-organization customization","sidebarTitle":"Sub-organization customization","href":"/solutions/embedded-wallets/integration-guide/flutter/sub-organization-customization"},{"title":"Using embedded wallets","sidebarTitle":"Using embedded wallets","href":"/solutions/embedded-wallets/integration-guide/flutter/using-embedded-wallets"},{"title":"Signing","sidebarTitle":"Signing","href":"/solutions/embedded-wallets/integration-guide/flutter/signing"},{"title":"Advanced API requests","sidebarTitle":"Advanced API requests","href":"/solutions/embedded-wallets/integration-guide/flutter/advanced-api-requests"}]},{"group":"Swift","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/solutions/embedded-wallets/integration-guide/swift/overview"},{"title":"Getting started with the Turnkey Swift SDK","sidebarTitle":"Getting started","href":"/solutions/embedded-wallets/integration-guide/swift/getting-started"},{"group":"Authentication","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/solutions/embedded-wallets/integration-guide/swift/authentication/overview"},{"title":"Email and SMS OTP authentication","sidebarTitle":"Email \u0026 SMS","href":"/solutions/embedded-wallets/integration-guide/swift/authentication/email-sms"},{"title":"Passkey authentication","sidebarTitle":"Passkeys","href":"/solutions/embedded-wallets/integration-guide/swift/authentication/passkey"},{"title":"Social logins (OAuth)","sidebarTitle":"Social logins","href":"/solutions/embedded-wallets/integration-guide/swift/authentication/social-logins"}]},{"title":"Signing","sidebarTitle":"Signing","href":"/solutions/embedded-wallets/integration-guide/swift/signing"},{"title":"Sub-organization customization","sidebarTitle":"Sub-organization customization","href":"/solutions/embedded-wallets/integration-guide/swift/sub-organization-customization"},{"title":"Advanced API requests","sidebarTitle":"Advanced API requests","href":"/solutions/embedded-wallets/integration-guide/swift/advanced-api-requests"},{"title":"Using wallets","sidebarTitle":"Using wallets","href":"/solutions/embedded-wallets/integration-guide/swift/using-embedded-wallets"},{"title":"Advanced backend authentication (Swift)","sidebarTitle":"Advanced backend authentication","href":"/solutions/embedded-wallets/integration-guide/swift/advanced-backend-authentication"}]},{"group":"Kotlin","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/solutions/embedded-wallets/integration-guide/kotlin/overview"},{"title":"Getting started with Turnkey's Kotlin SDK","sidebarTitle":"Getting started","href":"/solutions/embedded-wallets/integration-guide/kotlin/getting-started"},{"group":"Authentication","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/solutions/embedded-wallets/integration-guide/kotlin/authentication/overview"},{"title":"Email and SMS OTP authentication","sidebarTitle":"Email \u0026 SMS","href":"/solutions/embedded-wallets/integration-guide/kotlin/authentication/email-sms"},{"title":"Passkey authentication","sidebarTitle":"Passkeys","href":"/solutions/embedded-wallets/integration-guide/kotlin/authentication/passkey"},{"title":"Social logins","sidebarTitle":"Social logins","href":"/solutions/embedded-wallets/integration-guide/kotlin/authentication/social-logins"},{"title":"Relying party ID (rpId) setup for Android","sidebarTitle":"Relying party ID (rpId) setup","href":"/solutions/embedded-wallets/integration-guide/kotlin/authentication/rp-id-setup"}]},{"title":"Sub-organization customization","sidebarTitle":"Sub-organization customization","href":"/solutions/embedded-wallets/integration-guide/kotlin/sub-organization-customization"},{"title":"Using embedded wallets","sidebarTitle":"Using embedded wallets","href":"/solutions/embedded-wallets/integration-guide/kotlin/using-embedded-wallets"},{"title":"Signing","sidebarTitle":"Signing","href":"/solutions/embedded-wallets/integration-guide/kotlin/signing"},{"title":"Advanced API requests","sidebarTitle":"Advanced API requests","href":"/solutions/embedded-wallets/integration-guide/kotlin/advanced-api-requests"}]}]}]},{"group":"Company Wallets","pages":[{"title":"Overview","href":"/solutions/company-wallets/overview"},{"group":"Solution","pages":[{"title":"Payment Orchestration","mode":"wide","href":"/solutions/company-wallets/payment-orchestration"},{"title":"Smart Contract Management","mode":"wide","href":"/solutions/company-wallets/smart-contract-management"},{"title":"Agentic Wallets","href":"/solutions/company-wallets/agentic-wallets"},{"title":"Agentic Payments","href":"/solutions/company-wallets/agentic-payments"}]},{"title":"Company Wallets quickstart","sidebarTitle":"Quickstart","href":"/solutions/company-wallets/quickstart"},{"group":"Integration guide","pages":[{"title":"Server SDKs","sidebarTitle":"Overview","href":"/solutions/company-wallets/integration-guide/overview"},{"title":"TypeScript server","sidebarTitle":"TypeScript server","href":"/solutions/company-wallets/integration-guide/javascript-server"},{"title":"Go","sidebarTitle":"Go","href":"/solutions/company-wallets/integration-guide/golang"},{"title":"Ruby","mode":"wide","href":"/solutions/company-wallets/integration-guide/ruby"},{"title":"Rust","mode":"wide","href":"/solutions/company-wallets/integration-guide/rust"},{"title":"Python","mode":"wide","href":"/solutions/company-wallets/integration-guide/python"}]}]},{"group":"Key Management","pages":[{"title":"Overview","href":"/solutions/key-management/overview"},{"group":"Solution","pages":[{"title":"Encryption Key Storage","href":"/solutions/key-management/encryption-key-storage"},{"title":"Enterprise Disaster Recovery","href":"/solutions/key-management/enterprise-disaster-recovery"},{"title":"Programmable credential access","href":"/solutions/key-management/programmable-credential-access"},{"title":"API key storage","href":"/solutions/key-management/api-key-storage"},{"title":"MPC keyshare and recovery key storage","href":"/solutions/key-management/mpc-keyshare-storage"},{"title":"HSM Signing","tag":"Beta","href":"/solutions/key-management/hsm-signing"},{"title":"Git signing and SSH","href":"/solutions/key-management/git-signing"}]}]},{"group":"Verifiable Cloud","pages":[{"title":"Data Brokerage","href":"/solutions/verifiable-cloud/data-brokerage"},{"title":"Custom Policy Enforcement","href":"/solutions/verifiable-cloud/custom-policy-enforcement"},{"title":"Blockchain Oracles","href":"/solutions/verifiable-cloud/blockchain-oracles"},{"title":"Enclave Brokered Secrets","href":"/solutions/verifiable-cloud/enclave-brokered-secrets"},{"title":"Secrets Manager Replacement","href":"/solutions/verifiable-cloud/secrets-manager-replacement"},{"title":"JWT Auth for TVC Apps","tag":"Beta","href":"/solutions/verifiable-cloud/jwt-http-auth"}]},{"group":"Cookbooks","pages":[{"title":"Cookbooks","sidebarTitle":"Overview","href":"/solutions/cookbooks/landing"},{"group":"Yield","pages":[{"title":"Use Turnkey wallets with Morpho","sidebarTitle":"Morpho integration","href":"/solutions/cookbooks/morpho"},{"title":"Use Turnkey wallets with Aave","sidebarTitle":"Aave integration","href":"/solutions/cookbooks/aave"},{"title":"Use Turnkey wallets with Breeze","sidebarTitle":"Breeze integration","href":"/solutions/cookbooks/breeze"},{"title":"Building on Yield.xyz with Turnkey","sidebarTitle":"Yield.xyz integration","href":"/solutions/cookbooks/yieldxyz"},{"title":"Use Turnkey wallets with vaults.fyi","sidebarTitle":"Vaults.fyi integration","href":"/solutions/cookbooks/vaultsfyi"}]},{"group":"Swaps \u0026 bridges","pages":[{"title":"Use Turnkey wallets with Jupiter","sidebarTitle":"Jupiter integration","href":"/solutions/cookbooks/jupiter"},{"title":"Use Turnkey wallets with Li.Fi","sidebarTitle":"Li.Fi integration","href":"/solutions/cookbooks/lifi"},{"title":"Use Turnkey wallets with 0x","sidebarTitle":"0x integration","href":"/solutions/cookbooks/0x"},{"title":"Use Turnkey wallets with Relay","sidebarTitle":"Relay integration","href":"/solutions/cookbooks/relay"}]},{"group":"Payments \u0026 infrastructure","pages":[{"title":"Polymarket builders with Turnkey","sidebarTitle":"Polymarket builders","href":"/solutions/cookbooks/polymarket-builders"},{"title":"Builder codes with Turnkey on Base","sidebarTitle":"Base builders","href":"/solutions/cookbooks/base-builder-codes"},{"title":"Use Turnkey wallets with Brale","sidebarTitle":"Brale integration","href":"/solutions/cookbooks/brale"},{"title":"How to integrate gasless transactions on Tron with Turnkey","sidebarTitle":"Gasless Tron transactions","href":"/solutions/cookbooks/tron-gasless-transactions"},{"title":"Use Turnkey wallets with WalletConnect Pay","sidebarTitle":"WalletConnect Pay integration","href":"/solutions/cookbooks/wallet-connect-pay-integration"}]}]}]},{"tab":"Documentation","pages":[{"title":"Documentation","href":"/get-started/about-turnkey"}]},{"tab":"API \u0026 SDK reference","pages":[{"title":"API \u0026 SDK reference","href":"/api-reference/overview/intro"}]},{"tab":"Security","pages":[{"title":"Security","href":"/security/overview"}]},{"tab":"Support","pages":[{"title":"Support","href":"/support/overview"}]}]},"basePath":"","title":"Authentication - Turnkey","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}