@totemsdk/tx-builder

Construct Minima transactions in pure TypeScript.

Provides coin selection, multi-signature transaction management, and the EnhancedBuildParams type used across the SDK. Depends only on @noble/hashes.

Install

npm install @totemsdk/tx-builder @noble/hashes

What's inside

Coin selection

| Export | What it does | |--------|-------------| | CoinSelectionService | Service class for selecting UTXOs to cover a payment | | CoinSelectionResult | Result type: selectedCoins, totalSelected, change, insufficientFunds, fromAddresses | | CoinSelectionOptions | Options: mode ('global' | 'focused'), targetAmount, tokenId, focusedAddress | | CoinSelectionError | Typed error with code: 'INSUFFICIENT_FUNDS', 'FETCH_FAILED', etc. | | SpendableCoin | A coin that is eligible for selection |

Multi-signature

| Export | What it does | |--------|-------------| | MultisigConfig | Configuration for '2of2' or 'mofn' multi-sig (threshold, publicKeys, ownPublicKey) | | PendingMultisigTransaction | A multi-sig transaction awaiting co-signatures |

Transaction types

| Export | What it does | |--------|-------------| | EnhancedBuildParams | Full transaction build parameters (inputs, outputs, transactionState, linkHash) | | EnhancedCoinInput | Input coin with coinId, address, amount, scriptDescriptor, coinProofHex | | EnhancedCoinOutput | Output with address, amount, tokenId, storeState, state |

Usage

Select coins for a payment

import { CoinSelectionService, CoinSelectionError } from '@totemsdk/tx-builder';

const service = new CoinSelectionService(storage, coinFetcher);

try {
  const result = await service.selectCoinsForSend('MxABC...', {
    mode: 'global',
    targetAmount: '10',
    tokenId: '0x00',
  });

  console.log('Selected coins:', result.selectedCoins.length);
  console.log('Change:', result.change);
} catch (err) {
  if (err instanceof CoinSelectionError && err.code === 'INSUFFICIENT_FUNDS') {
    console.error('Not enough funds');
  }
}

Build transaction parameters

import type { EnhancedBuildParams } from '@totemsdk/tx-builder';

// Assemble params to pass to sendComplex() in @totemsdk/connect
const buildParams: EnhancedBuildParams = {
  inputs: [
    {
      coinId: '0xABC...',
      address: 'MxABC...',
      amount: '15',
      tokenId: '0x00',
      scriptDescriptor: { type: 'signedby', publicKey: '0x...' },
      coinProofHex: '...',
    },
  ],
  outputs: [
    { address: 'MxDEF...', amount: '10', tokenId: '0x00' },
    { address: 'MxABC...', amount: '5',  tokenId: '0x00' }, // change
  ],
};

Multi-signature configuration

import type { MultisigConfig } from '@totemsdk/tx-builder';

const config: MultisigConfig = {
  type: 'mofn',
  threshold: 2,
  publicKeys: ['0xAAA...', '0xBBB...', '0xCCC...'],
  ownPublicKey: '0xAAA...',
};

See also

• @totemsdk/txpow — mine and broadcast a completed transaction
• @totemsdk/connect — sendComplex(origin, buildParams) uses EnhancedBuildParams
• @totemsdk/core — WOTS signing primitives
• @totemsdk/wots-lease — key safety for signing slots