Browser SDK

import { FastAuthClient } from "@fast-auth-near/browser-sdk";
import { JavascriptProvider } from "@fast-auth-near/javascript-provider";
import { connect } from "near-api-js";

// 1. Build a provider for your platform (web = JavascriptProvider).
const provider = new JavascriptProvider({
  network: "testnet",
  clientId: "your-auth0-client-id",
});

// 2. Set up a NEAR connection.
const { connection } = await connect({
  networkId: "testnet",
  nodeUrl: "https://rpc.testnet.near.org",
});

// 3. Create the client with the deployed contract ids.
const client = new FastAuthClient(provider, connection, {
  fastAuthContractId: "fast-auth.testnet",
  mpcContractId: "v1.signer-prod.testnet",
});

// 4. Authenticate, then obtain an initialized signer.
await client.login();
const signer = await client.getSigner();

// 5. Derive the user's NEAR public key.
const publicKey = await signer.getPublicKey();

const client = new FastAuthClient(provider, connection, {
  fastAuthContractId: "fast-auth.testnet",
  mpcContractId: "v1.signer-prod.testnet",
});

// Arguments to login() are passed straight through to the provider.
await client.login();

try {
  const signer = await client.getSigner();
  // signer is already initialized — use it directly.
} catch (error) {
  // Thrown with code USER_NOT_LOGGED_IN if the session is missing.
  console.error("Login required:", error);
}

await client.logout();

// Derived public key (defaults to ed25519).
const publicKey = await signer.getPublicKey();
const secpKey = await signer.getPublicKey("secp256k1");

// Build (but don't send) an account-creation action.
const action = await signer.createAccount("alice.testnet", {
  algorithm: "ed25519",
});

// 1. Read the pending request the provider produced.
const { signatureRequest } = await signer.getSignatureRequest();

// 2. Build the on-chain `sign` action for the NEAR Auth contract.
const signAction = await signer.createSignAction(signatureRequest);

// 3. Submit that action in a transaction to obtain the MPC signature,
//    decode it (see FastAuthSignature), then broadcast the real transaction.
const signature = FastAuthSignature.fromBase64(base64Result);
const outcome = await signer.sendTransaction(transaction, signature, "ed25519");

import { FastAuthSignature } from "@fast-auth-near/browser-sdk";

// Decode the MPC result returned from the `sign` call.
const signature = FastAuthSignature.fromBase64(base64Result);

// Recover raw bytes if you need them directly (defaults to ed25519).
const ed25519Bytes = signature.recover();        // 64 bytes: R‖S
const secp256k1Bytes = signature.recover("secp256k1"); // 65 bytes: r‖s‖v

import { FastAuthClient, FastAuthSignature } from "@fast-auth-near/browser-sdk";
import { JavascriptProvider } from "@fast-auth-near/javascript-provider";
import { connect } from "near-api-js";

const provider = new JavascriptProvider({
  network: "testnet",
  clientId: "your-auth0-client-id",
});

const { connection } = await connect({
  networkId: "testnet",
  nodeUrl: "https://rpc.testnet.near.org",
});

const client = new FastAuthClient(provider, connection, {
  fastAuthContractId: "fast-auth.testnet",
  mpcContractId: "v1.signer-prod.testnet",
});

// 1. Authenticate and obtain an initialized signer.
await client.login();
const signer = await client.getSigner();

// 2. Derive the user's NEAR public key.
const publicKey = await signer.getPublicKey();

// 3. Ask the provider to embed a transaction into the JWT and sign it.
await signer.requestTransactionSignature(/* provider-specific args */);
const { signatureRequest } = await signer.getSignatureRequest();

// 4. Build the on-chain `sign` action, submit it to get the MPC result,
//    then decode and broadcast the final transaction.
const signAction = await signer.createSignAction(signatureRequest);
const signature = FastAuthSignature.fromBase64(base64Result);
const outcome = await signer.sendTransaction(transaction, signature, "ed25519");