Quickstart

import { Networks } from '@stellar/stellar-sdk';
import { smartWalletV1Deployer, smartWalletV1Indexer } from '@soropass/core';

const cfg = {
  rpId: location.hostname, // passkeys are origin-bound, must be your real domain
  rpName: 'Example',
  rpcUrl: 'https://soroban-testnet.stellar.org',
  networkPassphrase: Networks.TESTNET,
};

const deployer = smartWalletV1Deployer({ ...cfg, deployerSecret: DEPLOYER_SECRET });
const indexer = smartWalletV1Indexer({ rpcUrl: cfg.rpcUrl });

import { createPasskey } from '@soropass/core/create';
import { sendSmartWalletTx, browserPasskeySigner } from '@soropass/core/sign';
import { recover } from '@soropass/core/recover';

// 1. Create: mint an ES256 passkey and deploy its smart account.
const account = await createPasskey({ ...cfg, userName: 'alice', deployer });
//   account.contractId · account.credentialId · account.publicKey  → persist credentialId

// 2. Sign + submit: any Soroban operation, authorized by the passkey.
const res = await sendSmartWalletTx({
  operation, // build with @stellar/stellar-sdk (a SAC transfer, a contract call, …)
  rpcUrl: cfg.rpcUrl,
  networkPassphrase: cfg.networkPassphrase,
  sourceSecret: FEE_SOURCE_SECRET, // fee payer; swap in a relayer adapter for production
  sign: browserPasskeySigner({ rpId: cfg.rpId, allowCredentials: [account.credentialId] }),
});
//   res.status · res.hash  → on Stellar Expert

// 3. Recover: on a new device, resolve the wallets this passkey controls.
const wallets = await recover({ rpId: cfg.rpId, indexer });

// 4. Add a backup device: a second passkey signer, on-chain (see /docs/sdk/accounts#addsigner).

import { createCreatePasskeyFlow } from '@soropass/ui/headless';
import { mountCreateScreen } from '@soropass/ui/styled';
import '@soropass/ui/styled.css';

const flow = createCreatePasskeyFlow({
  userActivation: navigator.userActivation, // enforces the Safari user-gesture rule
  async create({ userName }, report) {
    // call report.deploying() when you enter the on-chain deploy phase
    return createPasskey({ ...cfg, userName, deployer });
  },
});

const { unmount } = mountCreateScreen(document.getElementById('slot'), { flow });

import { PasskeyModule, PASSKEY_ID } from '@creit.tech/stellar-wallets-kit/modules/passkey';
import { StellarWalletsKit } from '@creit.tech/stellar-wallets-kit/sdk';
import { Networks } from '@creit.tech/stellar-wallets-kit/types';

const passkey = new PasskeyModule({ ...cfg, indexer, deployer });
StellarWalletsKit.init({ network: Networks.TESTNET, modules: [passkey] });

await passkey.createAccount('alice'); // createAccount lives on the module
StellarWalletsKit.setWallet(PASSKEY_ID);
const { address } = await StellarWalletsKit.getAddress();
const { signedTxXdr } = await StellarWalletsKit.signTransaction(txXdr, { networkPassphrase });