Multi-Signer Wallet

OotleWallet is a multi-signer wallet that manages multiple key providers — one per address. This is useful when a transaction requires authorizations from several components.

Setup

import { OotleWallet } from "@tari-project/ootle";

const wallet = new OotleWallet();
wallet.registerKeyProvider(addressA, signerA);
wallet.registerKeyProvider(addressB, signerB);
wallet.setDefaultSigner(addressA);

Sign with the default signer

wallet.signTransaction is the lower-level per-signer call: it hashes unsignedTx with the seal signer’s public key so each signature matches the final seal hash.

const signatures = await wallet.signTransaction(unsignedTx, sealPublicKey);

For an end-to-end flow, prefer the free signTransaction(signers, unsignedTx) / sendTransaction(...) helpers in @tari-project/ootle, which generate and thread the seal keypair for you.

Authorize for a specific address

const auth = await wallet.authorizeTransaction(addressB, unsignedTx, sealPublicKey);

Use with stealth transfers

OotleWallet integrates with WalletStealthAuthorizer for stealth transfers:

import { WalletStealthAuthorizer } from "@tari-project/ootle";

const authorizer = WalletStealthAuthorizer.fromSpec(wallet, stealthSpec, { viewSecret });
const authorized = await authorizer.prepare(provider); // hydrates the balance proof, signs each spent input
const envelope = await authorized.seal(); // collects account + one-time signatures, seals the envelope
// submit `envelope` via your provider

The authorizer uses the wallet’s registered key providers to sign on behalf of each input owner, threading a single shared seal keypair through every signature.