Overview
ExternalSignerManager manages Stellar G-address signers - either raw keypairs or connected wallet extensions. Access it via kit.externalSigners.
// Add a keypair (in-memory only)
kit.externalSigners.addFromSecret('SXXX...');
// Connect an external wallet (e.g. Freighter)
await kit.externalSigners.addFromWallet(walletAdapter);
Methods
addFromSecret()
Add a Stellar keypair as an external signer. Stored in memory only - not persisted to storage.
kit.externalSigners.addFromSecret(secretKey: string);
This method is primarily for testing and development. Never use it with real secret keys in production.
addFromWallet()
Connect an external wallet (e.g. Freighter, Lobstr) as a signer.
await kit.externalSigners.addFromWallet(adapter: ExternalWalletAdapter);
restoreConnections()
Restore previously persisted wallet connections on page load.
await kit.externalSigners.restoreConnections();
canSignFor()
Check if a signer is available for a given G-address.
const can = kit.externalSigners.canSignFor(address: string); // boolean
signAuthEntry()
Sign a single auth entry using the signer for the given address.
const signed = await kit.externalSigners.signAuthEntry(
address: string,
authEntry: xdr.SorobanAuthorizationEntry
);
getAll()
Return all registered external signers.
const signers = kit.externalSigners.getAll(); // ConnectedWallet[]
remove()
Remove an external signer by address.
kit.externalSigners.remove(address: string);
Types
import type { ExternalWalletAdapter, ConnectedWallet } from 'smart-account-kit';
interface ExternalWalletAdapter {
getAddress(): Promise<string>;
signAuthEntry(authEntry: xdr.SorobanAuthorizationEntry): Promise<xdr.SorobanAuthorizationEntry>;
disconnect?(): Promise<void>;
}
interface ConnectedWallet {
address: string;
adapter: ExternalWalletAdapter;
}
StellarWalletsKit Integration
The SDK ships with a StellarWalletsKitAdapter for first-class @creit-tech/stellar-wallets-kit support:
import { StellarWalletsKitAdapter } from 'smart-account-kit';
const adapter = new StellarWalletsKitAdapter({
kit: stellarWalletsKit,
onConnectionChange: (connected) => {
console.log('External wallet:', connected ? 'connected' : 'disconnected');
},
});
await kit.externalSigners.addFromWallet(adapter);
