​
requestSignIn(opts)

Show the Rownd sign-in dialog, or automatically initiate a sign-in.

​
Examples

​
Prompt the user to sign in

requestSignIn() can be called without any parameters and the user can choose to sign in with any of your app’s configured sign-in methods. 
rownd.requestSignIn()

​
Automatically sign in a user using their email

rownd.requestSignIn({
  identifier: 'john.doe@acme.com',
  auto_sign_in: true
})

​
Prompt the user to sign in with Google and save a referral code to their user data

rownd.requestSignIn({
  method: 'google',
  user_data: {
    referral_code: 'ref_123'
  }
})

​
Parameters

​
identifier
string
An email address or phone number (in E164 format) to which a verification message may be sent. If the Rownd app is configured to allow unverified users, then sign-in will complete without verification if the user has not signed in previously.This is frequently used in conjunction with auto_sign_in: true to automatically sign in a specific user.
​
auto_sign_in
boolean
default:"false"
When true, automatically trigger a sign-in attempt if identifier is included or an email address or phone number has already been set in the user data.
​
method
SignInMethod
If set, Rownd will initiate a sign-in with the specified method. Must be one of 'email', 'phone', 'google', 'one_tap', 'passkeys', 'crypto_wallet', or 'anonymous'
​
redirect
boolean
default:"true"
After the sign-in completes, Rownd will redirect to the configured postLoginRedirectUrl or postRegistrationUrl. If false, the user will stay on the verification page. This can be helpful if your site or application cannnot be reached via a traditional redirect, such as if it’s running in an iframe.
​
post_login_redirect
string
An absolute or relative URL for which to redirect the user after the sign-in completes.
This overrides postLoginRedirectUrl and postRegistrationUrl if they are set.
​
user_data
object
Extra user data to append to the user record when sign-in completes.
​
include_user_data
boolean
default:"true"
When true, user data that was previously set using rownd.user.set() will be added to the user record after sign-in.
​
intent
string
This option applies only when you have opted to split the sign-up/sign-in flow via the Rownd dashboard. Valid values are "sign_in" or "sign_up". If you don’t set this value, the user will be presented with the unified sign-in/sign-up flow.
​
login_step
LoginStep
The step in the sign-in dialog to display. Must be one of LoginStep

​
signOut()

Signs out the user, clearing their access token and user data 
rownd.signOut()

​
getAccessToken()

Get the access token for the signed-in user.

​
Parameters

​
waitForToken
boolean
default:"false"
When true, if no access token is present or if it’s expired, the promise will not be resolved until a valid token is available. While unlikely, this could result in waiting forever.

​
user

​
get()
Function
Gets the data associated with the current user
​
set(user_data)
Function
Replaces all of the user data for the current user.
You can call set() prior to a user signing in. This can be useful to construct user data if your app supports an unauthenticated state.
​
setValue(field_name, value)
Function
Sets a specific field in current user’s data.
​
uploadFile(field_name, file)
Function
Upload a file for a specific field
The file parameter must be a javascript File. If the field name corresponds to an image field, the mime type of the file must have an “image/” prefix (e.g. “image/png”)
​
manageAccount()
Function
Show the user profile dialog

​
auth

​
isVerifiedUser()
Function -> boolean
Returns true if the current user is a verified user. In practice, this means that they have at least one piece of verified data (email, phone, etc).

​
requestFields()

Prompt the user to enter values to save in their data. You can specify the fields, submit button content, and the queustion/prompt.

​
Examples

​
Prompt the user to enter their first and last name

rownd.requestFields({
  fields: ['first_name', 'last_name'],
  buttonText: 'Save name',
  questionText: 'What\'s your name?'
});

​
Parameters

​
fields
string[]
List of the field names for which to prompt the user.
The fields must exist in your application’s Data Types in order to save the data to the user’s profile
​
bottonText
string
The text to show on the submit button
​
questionText
string
The prompt or question displayed on the dialog

​
near

​
near
object
The near API allows you to interact with the Rownd’s NEAR integration.
​
ensureImplicitAccount()
function
Creates an implicit NEAR account for the current user if one doesn’t already exist
​
createNamedAccount()
function
Prompts the user to create a named NEAR account
​
connectAccount()
function
Prompts the user to connect a NEAR accuont
​
walletDetails()
function
Opens a dialog showing the details of the user’s implicit NEAR account

​
LoginStep

A step in the Rownd sign-in dialog. Used when calling requestSignIn to show a specific step.
​
INIT
enum
​
NoAccount
enum
​
Success
enum
​
Error
enum
​
Completing
enum