MultiSignerManager

Coordinate multi-signer transaction flows via kit.multiSigners.

Overview

MultiSignerManager handles transactions that require signatures from multiple signers. Access it via kit.multiSigners.

// Get all available signers (indexer-backed)
const signers = await kit.multiSigners.getAvailableSigners();

if (kit.multiSigners.needsMultiSigner(signers)) {
  const selected = kit.multiSigners.buildSelectedSigners(signers, activeCredentialId);
  await kit.multiSigners.transfer('CTOKEN...', 'GRECIPIENT...', 100, selected);
}

getAvailableSigners() is indexer-backed - it requires a configured indexer. This mirrors kit.rules.list() for the same reason: the contract does not expose an iterator over active rule IDs after deletions.

Methods

getAvailableSigners()

Discover all signers across all active context rules. Requires indexer access.

const signers = await kit.multiSigners.getAvailableSigners(); // ContractSigner[]

needsMultiSigner()

Check whether the current operation requires more than one signer.

const needs = kit.multiSigners.needsMultiSigner(signers: ContractSigner[]); // boolean

buildSelectedSigners()

Assemble a SelectedSigner[] array for use in multi-sig operations.

const selected = kit.multiSigners.buildSelectedSigners(
  signers: ContractSigner[],
  activeCredentialId?: string
);

Pass activeCredentialId to mark which passkey credential is the currently authenticated one.

transfer()

Execute a token transfer requiring signatures from multiple signers.

const result = await kit.multiSigners.transfer(
  tokenContract: string,
  recipient: string,
  amount: number | bigint | string,
  selectedSigners: SelectedSigner[]
);

operation()

Execute any assembled transaction requiring multi-signer authorization.

const result = await kit.multiSigners.operation(
  assembledTx: AssembledTransaction,
  selectedSigners: SelectedSigner[],
  options?: SubmissionOptions
);

Full Multi-Sig Example

// 1. Discover all signers
const signers = await kit.multiSigners.getAvailableSigners();

// 2. Check if multi-sig is needed
if (!kit.multiSigners.needsMultiSigner(signers)) {
  // Single signer - use the normal transfer path
  await kit.transfer(tokenContract, recipient, amount);
  return;
}

// 3. Build the signer selection
const selected = kit.multiSigners.buildSelectedSigners(
  signers,
  kit.activeCredentialId  // mark which passkey is currently authenticated
);

// 4. Execute
const result = await kit.multiSigners.transfer(tokenContract, recipient, amount, selected);

Types

import type { SelectedSigner } from 'smart-account-kit';

interface SelectedSigner {
  signer: ContractSigner;
  credentialId?: string;  // For passkey signers
  address?: string;       // For G-address signers
}