Guides

import { createPasskey } from '@soropass/core/create';

const account = await createPasskey({ ...cfg, userName: 'alice', deployer });
// Touch ID / Windows Hello → ES256 passkey → v1 smart-wallet deployed + funded.
// Persist account.credentialId (and account.contractId) for fast reconnects.

import { sendSmartWalletTx, browserPasskeySigner } from '@soropass/core/sign';
import { Contract, Address, nativeToScVal } from '@stellar/stellar-sdk';

// A native-asset (SAC) transfer FROM the smart wallet.
const transfer = new Contract(NATIVE_SAC).call(
  'transfer',
  Address.fromString(account.contractId).toScVal(),
  Address.fromString(destination).toScVal(),
  nativeToScVal(amount, { type: 'i128' }),
);

const res = await sendSmartWalletTx({
  operation: transfer,
  rpcUrl: cfg.rpcUrl,
  networkPassphrase: cfg.networkPassphrase,
  sourceSecret: FEE_SOURCE_SECRET,
  sign: browserPasskeySigner({ rpId: cfg.rpId, allowCredentials: [account.credentialId] }),
});
// res.status === 'SUCCESS' · res.hash → on Stellar Expert

// Same call, but `sign` is a random software key that is NOT a registered signer.
try {
  await sendSmartWalletTx({ operation: transfer, ...cfg, sourceSecret, sign: wrongKeySigner });
} catch (err) {
  // Rejected on-chain during the enforcing re-simulation, exactly as intended. No funds move.
}

import { registerPasskey } from '@soropass/core/create';
import { addSigner } from '@soropass/core/recover';

const backup = await registerPasskey({ ...cfg, userName: 'backup' }); // register WITHOUT deploying
await addSigner({
  walletContractId: account.contractId,
  newSigner: backup,
  rpcUrl: cfg.rpcUrl,
  networkPassphrase: cfg.networkPassphrase,
  sourceSecret: FEE_SOURCE_SECRET,
  sign: browserPasskeySigner({ rpId: cfg.rpId, allowCredentials: [account.credentialId] }),
});
// The wallet is now multi-signer: both passkeys work.

import { recover } from '@soropass/core/recover';

const wallets = await recover({ rpId: cfg.rpId, indexer });
// wallets: { contractId, credentialId }[], resolved from on-chain signer_added events.