EraFlutter client

Create a client

import 'package:era_flutter/era_flutter.dart';

final era = EraFlutter(
  baseUrl: 'https://your-era-endpoint.com',
  publishableKey: 'your_publishable_key',
);

String

required

Base URL of the Era service.

String

required

Publishable key for mobile identity and verification requests.

http.Client

Custom HTTP client. The SDK creates one when omitted.

bool

default:"false"

Close the supplied httpClient when close() is called.

EraFlutterStorage

Custom visitor storage. The default uses SharedPreferencesAsync.

See all Flutter SDK types.

`init([visitorId])`

Loads the stored visitor or creates one.

Future<String> init([String? visitorId])

Pass a lowercase UUIDv4 when your application already has a visitor UUID:

final visitorId = await era.init(
  '22222222-2222-4222-8222-222222222222',
);
// era_vid_22222222-2222-4222-8222-222222222222

`getVisitorId()`

Reads the current visitor without creating one.

Future<String?> getVisitorId()

Returns the stored or in-memory visitor, or null when none exists.

`getVerification()`

Checks whether the current visitor is linked to an Era end user.

Future<VerificationStatus> getVerification()

final status = await era.getVerification();
print(status.eraEndUserId);

eraEndUserId is an opaque Era ID or null.

`startVerification(type, identifier)`

Sends an email or phone verification code.

Future<VerificationChallenge> startVerification(
  VerificationType type,
  String identifier,
)

final challenge = await era.startVerification(
  VerificationType.email,
  'person@example.com',
);

`confirmVerification(challengeId, code)`

Confirms a code and links the current visitor.

Future<VerificationConfirmation> confirmVerification(
  String challengeId,
  String code,
)

final result = await era.confirmVerification(
  challenge.challengeId,
  enteredCode,
);

print(result.verified);     // true
print(result.eraEndUserId); // opaque Era ID

`resendVerification(challengeId)`

Sends another code.

Future<VerificationChallenge> resendVerification(
  String challengeId,
)

Use the returned challenge for later confirm or resend calls.

`resetVisitor()`

Replaces the current visitor and returns the new ID.

Future<String> resetVisitor()

Use this after logout, account switching, or a shared-device user change.

`close()`

Aborts this client’s requests and closes its owned HTTP client.

void close()

Calling close() more than once has no effect. Other methods throw client_closed after the client is closed. See Flutter SDK errors.

Get started

Concepts

Reference

EraFlutter client

Create a client

`init([visitorId])`

`getVisitorId()`

`getVerification()`

`startVerification(type, identifier)`

`confirmVerification(challengeId, code)`

`resendVerification(challengeId)`

`resetVisitor()`

`close()`

​Create a client

​init([visitorId])

​getVisitorId()

​getVerification()

​startVerification(type, identifier)

​confirmVerification(challengeId, code)

​resendVerification(challengeId)

​resetVisitor()

​close()

Create a client

`init([visitorId])`

`getVisitorId()`

`getVerification()`

`startVerification(type, identifier)`

`confirmVerification(challengeId, code)`

`resendVerification(challengeId)`

`resetVisitor()`

`close()`