paytaca-cli 0.4.1 → 0.5.0

package/dist/wallet/cauldron/pools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pools.js","sourceRoot":"","sources":["../../../src/wallet/cauldron/pools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAe,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAgB,MAAM,UAAU,CAAA;AAe3D;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,GAAG,EAAE,IAAI,CAAC,SAAS;QACnB,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,EAAE;QACnB,aAAa,EAAE,IAAI,CAAC,IAAI;QACxB,aAAa,EAAE,IAAI,CAAC,IAAI;QACxB,UAAU,EAAE,IAAI,CAAC,MAAM;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,YAAY,EAAE,IAAI,CAAC,MAAM;KAC1B,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAe;IAC/C,MAAM,WAAW,GAAG,EAAE,oBAAoB,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;IAChE,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAA;IAC/B,MAAM,oBAAoB,GAAG,KAAK,CAAC,6BAA6B,CAAC,WAAW,CAAC,CAAA;IAC7E,OAAO;QACL,OAAO,EAAE,GAAG;QACZ,UAAU,EAAE,WAAW;QACvB,QAAQ,EAAE;YACR,KAAK,EAAE,IAAI,CAAC,UAAU;YACtB,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC;SACrC;QACD,MAAM,EAAE;YACN,gBAAgB,EAAE,oBAAoB;YACtC,KAAK,EAAE;gBACL,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;gBACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB;YACD,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;SAC1B;KACF,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAe;IACvD,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAA;IAC/C,OAAO,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;AAC7D,CAAC;AAeD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAMjC;IACC,MAAM,cAAc,GAAG,SAAS,CAAC,eAAe,KAAK,mBAAmB,CAAA;IACxE,MAAM,aAAa,GAAG,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAA;IAChF,MAAM,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAA;IAE7E,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAA;IACxC,OAAO;QACL,EAAE,EAAE,UAAU,CAAC,gBAAgB;QAC/B,MAAM,EAAE,UAAU,CAAC,MAAM,GAAG,aAAa;QACzC,KAAK,EAAE;YACL,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU;YAC5C,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,QAAQ;SACpC;KACF,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CACvB,IAAgD,EAChD,aAAqB,EACrB,aAAsB;IAEtB,IAAI,kBAAkB,GAAG,CAAC,CAAA;IAC1B,IAAI,eAAe,GAAG,aAAa,CAAA;IACnC,IAAI,aAAa,EAAE,CAAC;QAClB,kBAAkB,GAAG,aAAa,CAAA;QAClC,eAAe,GAAG,CAAC,CAAA;IACrB,CAAC;IAED,MAAM,UAAU,GAAG,GAAG,IAAI,MAAM,CAAC,kBAAkB,CAAC,CAAA;IACpD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,WAAW,CAAA;IAE/D,MAAM,OAAO,GAAG,EAAE,IAAI,eAAe,CAAA;IACrC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,OAAO,CAAA;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,CAAA;AACvC,CAAC"}

package/dist/wallet/cauldron/pools.test.d.ts

@@ -0,0 +1,3 @@
+import { type MicroPool } from './pools.js';
+export type { MicroPool };
+//# sourceMappingURL=pools.test.d.ts.map

package/dist/wallet/cauldron/pools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pools.test.d.ts","sourceRoot":"","sources":["../../../src/wallet/cauldron/pools.test.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,YAAY,CAAA;AAmKnB,YAAY,EAAE,SAAS,EAAE,CAAA"}

package/dist/wallet/cauldron/pools.test.js

@@ -0,0 +1,149 @@
+import { describe, it, expect } from 'vitest';
+import { NATIVE_BCH_TOKEN_ID } from '@cashlab/common';
+import { binToHex } from '@cashlab/common/libauth.js';
+import { apiPoolToMicroPool, microPoolToPoolV0, poolTradeToOutput, parseRate, } from './pools.js';
+import { attemptTrade, getEntriesSize } from './transact.js';
+// Real active LIFT pool from the riften indexer
+const LIFT_TOKEN_ID = '5932b2fd4915d6a75d3ec53282cd49118149a2176ee67ed68b1111ff0786f7fc';
+const apiPools = [
+    {
+        owner_p2pkh_addr: 'bitcoincash:zqytt7jjxds269xxm60lprpd8ea786xw3cjfh7pwpk',
+        owner_pkh: '08b5fa523360ad14c6de9ff08c2d3e7be3e8ce8e',
+        pool_id: '5a6a8da19aecf4198537ac006bcc32bb6c3be514338db813a5610a11ff8c9500',
+        sats: 7746405,
+        token_id: LIFT_TOKEN_ID,
+        tokens: 95698,
+        tx_pos: 5,
+        txid: 'd49d46592026c574e877c3d6cbad0bbd3302262ae08e318669eaa39d19b94ed5',
+    },
+    {
+        owner_p2pkh_addr: 'bitcoincash:zqwap58dm58cdvz9hgpg83lghd8rjjycn59gkys6cc',
+        owner_pkh: '1dd0d0eddd0f86b045ba0283c7e8bb4e3948989d',
+        pool_id: '6ac2944e341080772c4ed274033687fd4441d6e6ee976560dae9c83581b9f809',
+        sats: 10848211,
+        token_id: LIFT_TOKEN_ID,
+        tokens: 133950,
+        tx_pos: 1,
+        txid: '09b048f14763e4a4bba08e236c653e678b79991ec500f8d0a457874de62e3980',
+    },
+];
+function pools() {
+    return apiPools.map(apiPoolToMicroPool).map(microPoolToPoolV0);
+}
+describe('apiPoolToMicroPool', () => {
+    it('maps indexer pool fields onto a MicroPool', () => {
+        const micro = apiPoolToMicroPool(apiPools[0]);
+        expect(micro.pkh).toBe(apiPools[0].owner_pkh);
+        expect(micro.new_utxo_txid).toBe(apiPools[0].txid);
+        expect(micro.new_utxo_n).toBe(apiPools[0].tx_pos);
+        expect(micro.token_id).toBe(LIFT_TOKEN_ID);
+        expect(micro.sats).toBe(apiPools[0].sats);
+        expect(micro.token_amount).toBe(apiPools[0].tokens);
+        expect(micro.is_withdrawn).toBe(false);
+    });
+});
+describe('microPoolToPoolV0', () => {
+    it('produces a valid PoolV0 with generated locking bytecode', () => {
+        const micro = apiPoolToMicroPool(apiPools[0]);
+        const poolV0 = microPoolToPoolV0(micro);
+        expect(poolV0.version).toBe('0');
+        expect(binToHex(poolV0.parameters.withdraw_pubkey_hash)).toBe(apiPools[0].owner_pkh);
+        expect(poolV0.outpoint.index).toBe(apiPools[0].tx_pos);
+        expect(binToHex(poolV0.outpoint.txhash)).toBe(apiPools[0].txid);
+        expect(poolV0.output.token.token_id).toBe(LIFT_TOKEN_ID);
+        expect(poolV0.output.token.amount).toBe(BigInt(apiPools[0].tokens));
+        expect(poolV0.output.amount).toBe(BigInt(apiPools[0].sats));
+        // Locking bytecode must be non-empty and start with a valid pool script
+        expect(poolV0.output.locking_bytecode.length).toBeGreaterThan(0);
+    });
+});
+describe('attemptTrade', () => {
+    it('computes a best-rate sell trade across pools', () => {
+        const result = attemptTrade({
+            pools: pools(),
+            isBuyingToken: false,
+            supply: 1000n, // 10.00 LIFT
+        });
+        expect(result.entries.length).toBeGreaterThan(0);
+        expect(result.summary.supply).toBe(1000n);
+        expect(result.summary.demand).toBeGreaterThan(0n);
+        expect(result.entries[0].supply_token_id).toBe(LIFT_TOKEN_ID);
+        expect(result.entries[0].demand_token_id).toBe(NATIVE_BCH_TOKEN_ID);
+        expect(result.summary.trade_fee).toBeGreaterThan(0n);
+    });
+    it('computes a best-rate buy trade across pools', () => {
+        const result = attemptTrade({
+            pools: pools(),
+            isBuyingToken: true,
+            demand: 1000n,
+        });
+        expect(result.entries[0].supply_token_id).toBe(NATIVE_BCH_TOKEN_ID);
+        expect(result.entries[0].demand_token_id).toBe(LIFT_TOKEN_ID);
+        expect(result.summary.supply).toBeGreaterThan(0n);
+        expect(result.summary.demand).toBe(1000n);
+    });
+});
+describe('getEntriesSize', () => {
+    it('returns positive input and output sizes', () => {
+        const tradeResult = attemptTrade({
+            pools: pools(),
+            isBuyingToken: false,
+            supply: 1000n,
+        });
+        const sizes = getEntriesSize(tradeResult);
+        expect(sizes.inputFees).toBeGreaterThan(0);
+        expect(sizes.outputFees).toBeGreaterThan(0);
+    });
+});
+describe('poolTradeToOutput', () => {
+    it('computes the post-trade pool output', () => {
+        const tradeResult = attemptTrade({
+            pools: pools(),
+            isBuyingToken: false,
+            supply: 1000n,
+        });
+        const entry = tradeResult.entries[0];
+        const output = poolTradeToOutput(entry);
+        expect(output.amount).toBe(entry.pool.output.amount - entry.demand);
+        expect(output.token.amount).toBe(entry.pool.output.token.amount + entry.supply);
+        expect(output.token.category).toBe(entry.pool.output.token.token_id);
+    });
+});
+describe('parseRate', () => {
+    it('formats a sell price (token→BCH)', () => {
+        // rate = supply/demand scaled to denominator 1e13.
+        // For a sell: price = (num*10^8/den) / 10^tokenDecimals
+        // num=3, den=1, decimals=2 → (3*10^8/1)/100 = 3000000
+        const rate = { numerator: 3n, denominator: 1n };
+        expect(parseRate(rate, 2, false)).toBe('3000000.00');
+    });
+    it('formats a buy price (BCH→token)', () => {
+        // For a buy: price = (num*10^tokenDecimals/den) / 10^8
+        // num=1, den=3, decimals=2 → (1*100/3)/10^8 = 0.00000033
+        const rate = { numerator: 1n, denominator: 3n };
+        expect(parseRate(rate, 2, true)).toBe('0.00000033');
+    });
+    it('matches the app formula on a real LIFT trade', () => {
+        // SELL: supply=1000 token base units → demand=80378 sats across 2 pools
+        const sellTrade = attemptTrade({
+            pools: pools(),
+            isBuyingToken: false,
+            supply: 1000n,
+        });
+        // rate = supply*1e13/demand
+        const sellRate = sellTrade.summary.rate;
+        expect(sellRate.denominator).toBe(10000000000000n);
+        expect(sellRate.numerator).toBe(124412152579n);
+        expect(parseRate(sellRate, 2, false)).toBe('12441.21');
+        // BUY: demand=1000 token base units → supply=81569 sats across 2 pools
+        const buyTrade = attemptTrade({
+            pools: pools(),
+            isBuyingToken: true,
+            demand: 1000n,
+        });
+        const buyRate = buyTrade.summary.rate;
+        expect(buyRate.numerator).toBe(815690000000000n);
+        expect(parseRate(buyRate, 2, true)).toBe('0.00008156');
+    });
+});
+//# sourceMappingURL=pools.test.js.map

package/dist/wallet/cauldron/pools.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pools.test.js","sourceRoot":"","sources":["../../../src/wallet/cauldron/pools.test.ts"],"names":[],"mappings":"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"}

package/dist/wallet/cauldron/swap.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Cauldron swap orchestration: quote estimation and on-chain execution.
+ *
+ * This is the generic swap primitive (token ⇄ BCH). Higher-level callers
+ * (e.g. an MCP payment wrapper) can use estimateSwap() to price a swap and
+ * executeSwap() to broadcast it, mirroring the paytaca-app cauldron flow.
+ */
+import { type PoolV0, type TradeResult } from '@cashlab/cauldron';
+import type { BchWallet } from '../bch.js';
+import { type CauldronTokenData } from './api.js';
+export type SwapDirection = 'buy' | 'sell';
+export interface SwapQuote {
+    tokenId: string;
+    tokenData: CauldronTokenData;
+    direction: SwapDirection;
+    isBuyingToken: boolean;
+    pools: PoolV0[];
+    tradeResult: TradeResult;
+    /** Human-readable price. */
+    rate: string;
+    /** Token amount in base units. */
+    tokenAmount: bigint;
+    /** BCH amount involved in base units (satoshis). */
+    bchAmount: bigint;
+    /** Trade fee in satoshis. */
+    tradeFee: bigint;
+}
+export interface EstimateSwapOpts {
+    /** 64-char hex token category. */
+    tokenId: string;
+    /** 'buy' = spend BCH to receive tokens, 'sell' = spend tokens to receive BCH. */
+    direction: SwapDirection;
+    /** Token amount in base units (sell: amount supplied; buy: amount received). */
+    amount: bigint;
+}
+export interface ExecuteSwapOpts extends EstimateSwapOpts {
+    bchWallet: BchWallet;
+    mnemonic: string;
+    derivationPath: string;
+}
+export interface SwapResult {
+    success: boolean;
+    txid?: string;
+    transaction?: string;
+    error?: string;
+    quote?: SwapQuote;
+}
+/**
+ * Estimate a swap: fetch pools + token data and compute the best-rate trade.
+ */
+export declare function estimateSwap(opts: EstimateSwapOpts): Promise<SwapQuote>;
+/**
+ * Format a SwapQuote for human display.
+ */
+export declare function formatQuote(quote: SwapQuote): string;
+/**
+ * Execute a swap: build + sign the trade transaction and broadcast it.
+ */
+export declare function executeSwap(opts: ExecuteSwapOpts): Promise<SwapResult>;
+/**
+ * Build + sign the trade transaction (no broadcast).
+ */
+export declare function buildSignedTradeTx(opts: {
+    bchWallet: BchWallet;
+    mnemonic: string;
+    derivationPath: string;
+    quote: SwapQuote;
+}): Promise<import("@cashlab/cauldron").TradeTxResult>;
+//# sourceMappingURL=swap.d.ts.map

package/dist/wallet/cauldron/swap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swap.d.ts","sourceRoot":"","sources":["../../../src/wallet/cauldron/swap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAe,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE1C,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,UAAU,CAAA;AASjB,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,CAAA;AAE1C,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,iBAAiB,CAAA;IAC5B,SAAS,EAAE,aAAa,CAAA;IACxB,aAAa,EAAE,OAAO,CAAA;IACtB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,WAAW,EAAE,WAAW,CAAA;IACxB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,iFAAiF;IACjF,SAAS,EAAE,aAAa,CAAA;IACxB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,SAAS,EAAE,SAAS,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,SAAS,CAAC,CA8CpB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAwBpD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAkD5E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,SAAS,EAAE,SAAS,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,SAAS,CAAA;CACjB,sDA+BA"}

package/dist/wallet/cauldron/swap.js

@@ -0,0 +1,173 @@
+/**
+ * Cauldron swap orchestration: quote estimation and on-chain execution.
+ *
+ * This is the generic swap primitive (token ⇄ BCH). Higher-level callers
+ * (e.g. an MCP payment wrapper) can use estimateSwap() to price a swap and
+ * executeSwap() to broadcast it, mirroring the paytaca-app cauldron flow.
+ */
+import { ExchangeLab } from '@cashlab/cauldron';
+import { binToHex } from '@cashlab/common/libauth.js';
+import { LibauthHDWallet } from '../keys.js';
+import { fetchPoolsForToken, fetchTokenData, } from './api.js';
+import { apiPoolToMicroPool, microPoolToPoolV0, parseRate } from './pools.js';
+import { attemptTrade, createInputAndOutput, watchtowerUtxosToSpendableCoins, } from './transact.js';
+/**
+ * Estimate a swap: fetch pools + token data and compute the best-rate trade.
+ */
+export async function estimateSwap(opts) {
+    const { tokenId, direction, amount } = opts;
+    const [tokenData, apiPools] = await Promise.all([
+        fetchTokenData(tokenId),
+        fetchPoolsForToken(tokenId),
+    ]);
+    if (!tokenData) {
+        throw new Error(`No cauldron token data found for ${tokenId}`);
+    }
+    if (apiPools.length === 0) {
+        throw new Error(`No active cauldron pools for token ${tokenId}`);
+    }
+    const pools = apiPools.map(apiPoolToMicroPool).map(microPoolToPoolV0);
+    const isBuyingToken = direction === 'buy';
+    const tradeResult = attemptTrade({
+        pools,
+        isBuyingToken,
+        supply: isBuyingToken ? undefined : amount,
+        demand: isBuyingToken ? amount : undefined,
+    });
+    // supply/demand semantics depend on direction:
+    //   sell: supply=token, demand=BCH
+    //   buy:  supply=BCH,   demand=token
+    const tokenAmount = isBuyingToken
+        ? tradeResult.summary.demand
+        : tradeResult.summary.supply;
+    const bchAmount = isBuyingToken
+        ? tradeResult.summary.supply
+        : tradeResult.summary.demand;
+    const decimals = tokenData.bcmr.token.decimals;
+    return {
+        tokenId,
+        tokenData,
+        direction,
+        isBuyingToken,
+        pools,
+        tradeResult,
+        rate: parseRate(tradeResult.summary.rate, decimals, isBuyingToken),
+        tokenAmount,
+        bchAmount,
+        tradeFee: tradeResult.summary.trade_fee,
+    };
+}
+/**
+ * Format a SwapQuote for human display.
+ */
+export function formatQuote(quote) {
+    const { tokenData, direction, rate, tokenAmount, bchAmount, tradeFee } = quote;
+    const decimals = tokenData.bcmr.token.decimals;
+    const tokenSymbol = tokenData.bcmr.token.symbol || tokenData.display_symbol;
+    const tokenFormatted = (Number(tokenAmount) / 10 ** decimals).toFixed(decimals);
+    const bchFormatted = (Number(bchAmount) / 10 ** 8).toFixed(8);
+    const feeFormatted = (Number(tradeFee) / 10 ** 8).toFixed(8);
+    if (direction === 'sell') {
+        // Rate semantics (matches paytaca-app): '1 {demandSymbol} ≈ {rate} {supplySymbol}'.
+        // Selling tokens → demand is BCH, rate is tokens-per-BCH.
+        return [
+            `Sell ${tokenFormatted} ${tokenSymbol} for ${bchFormatted} BCH`,
+            `Rate: 1 BCH ≈ ${rate} ${tokenSymbol}`,
+            `Trade fee: ~${feeFormatted} BCH`,
+        ].join('\n');
+    }
+    // Buying tokens → demand is the token, rate is BCH-per-token.
+    return [
+        `Buy ${tokenFormatted} ${tokenSymbol} for ${bchFormatted} BCH`,
+        `Rate: 1 ${tokenSymbol} ≈ ${rate} BCH`,
+        `Trade fee: ~${feeFormatted} BCH`,
+    ].join('\n');
+}
+/**
+ * Execute a swap: build + sign the trade transaction and broadcast it.
+ */
+export async function executeSwap(opts) {
+    const { bchWallet, mnemonic, derivationPath } = opts;
+    let quote;
+    try {
+        quote = await estimateSwap(opts);
+    }
+    catch (err) {
+        return { success: false, error: err?.message || String(err) };
+    }
+    let txHex;
+    try {
+        const tradeTx = await buildSignedTradeTx({
+            bchWallet,
+            mnemonic,
+            derivationPath,
+            quote,
+        });
+        txHex = binToHex(tradeTx.txbin);
+    }
+    catch (err) {
+        return { success: false, error: err?.message || String(err), quote };
+    }
+    try {
+        const broadcastResponse = await bchWallet.watchtower.BCH._api.post('broadcast/', { transaction: txHex });
+        const data = broadcastResponse.data;
+        // Mempool test API compatibility
+        if (data?.result) {
+            data[data.success ? 'txid' : 'error'] = data.result;
+            delete data.result;
+        }
+        return {
+            success: Boolean(data?.success),
+            txid: data?.txid,
+            transaction: txHex,
+            error: data?.error,
+            quote,
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            transaction: txHex,
+            error: err?.message || String(err),
+            quote,
+        };
+    }
+}
+/**
+ * Build + sign the trade transaction (no broadcast).
+ */
+export async function buildSignedTradeTx(opts) {
+    const { bchWallet, mnemonic, derivationPath, quote } = opts;
+    const hdWallet = new LibauthHDWallet(mnemonic, derivationPath, bchWallet.isChipnet ? 'chipnet' : 'mainnet');
+    const spendableCoins = await collectSpendableCoins({
+        bchWallet,
+        hdWallet,
+        tokenId: quote.tokenId,
+        isBuyingToken: quote.isBuyingToken,
+    });
+    const { inputCoins, payouts } = createInputAndOutput({
+        tradeResult: quote.tradeResult,
+        spendableCoins,
+    });
+    const exlab = new ExchangeLab();
+    const tradeTx = exlab.createTradeTx(quote.tradeResult.entries, inputCoins, payouts, null, 1n);
+    exlab.verifyTradeTx(tradeTx);
+    return tradeTx;
+}
+/**
+ * Collect the wallet UTXOs needed for the swap as SpendableCoins.
+ * Selling needs the token's UTXOs + BCH; buying needs BCH only.
+ */
+async function collectSpendableCoins(opts) {
+    const { bchWallet, hdWallet, tokenId, isBuyingToken } = opts;
+    // BCH inputs: all UTXOs, filtered client-side to non-token ones so that
+    // other token holdings are never accidentally consumed.
+    const [allUtxos, tokenUtxos] = await Promise.all([
+        bchWallet.getUtxos(),
+        isBuyingToken ? Promise.resolve([]) : bchWallet.getUtxos({ category: tokenId }),
+    ]);
+    const bchUtxos = allUtxos.filter((utxo) => !utxo.is_cashtoken);
+    const utxos = [...bchUtxos, ...tokenUtxos];
+    return watchtowerUtxosToSpendableCoins({ utxos, wallet: hdWallet });
+}
+//# sourceMappingURL=swap.js.map

package/dist/wallet/cauldron/swap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swap.js","sourceRoot":"","sources":["../../../src/wallet/cauldron/swap.ts"],"names":[],"mappings":"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"}

package/dist/wallet/cauldron/transact.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Cauldron trade transaction building.
+ *
+ * Adapted from: paytaca-app/src/wallet/cauldron/transact.js.
+ *
+ * Uses @cashlab/cauldron's ExchangeLab to construct a best-rate trade across
+ * the active pools, then createInputAndOutput() selects the wallet coins and
+ * payout rules needed to fund and settle it. The final signed transaction is
+ * produced by ExchangeLab.createTradeTx() (libauth templates).
+ */
+import { ExchangeLab, type PoolV0, type TradeResult } from '@cashlab/cauldron';
+import { type PayoutRule, type SpendableCoin } from '@cashlab/common';
+import type { LibauthHDWallet } from '../keys.js';
+export interface AttemptTradeOpts {
+    exlab?: ExchangeLab;
+    pools: PoolV0[];
+    isBuyingToken: boolean;
+    supply?: bigint;
+    demand?: bigint;
+    txFeePerByte?: bigint;
+}
+/**
+ * Attempt a best-rate trade across the given pools.
+ *
+ * - Selling token → BCH: pass `supply` (token amount in base units).
+ * - Buying token with BCH: pass `demand` (token amount in base units to receive).
+ */
+export declare function attemptTrade(opts: AttemptTradeOpts): TradeResult;
+export interface PlatformFee {
+    to: string;
+    amount: bigint;
+}
+/**
+ * Select the wallet coins and payout rules needed to fund + settle a trade.
+ * Mirrors paytaca-app createInputAndOutput().
+ */
+export declare function createInputAndOutput(opts: {
+    tradeResult: TradeResult;
+    spendableCoins: SpendableCoin[];
+    platformFee?: PlatformFee;
+    tokenOutputSats?: bigint;
+}): {
+    inputCoins: SpendableCoin[];
+    payouts: PayoutRule[];
+};
+/**
+ * Sum the on-chain byte sizes of the pool inputs and outputs for a trade.
+ */
+export declare function getEntriesSize(tradeResult: TradeResult): {
+    inputFees: number;
+    outputFees: number;
+};
+/**
+ * Build a signed transaction for a trade using test coins, then optionally
+ * verify it. Used to validate a trade before broadcasting.
+ */
+export declare function testTradeResult(opts: {
+    exlab?: ExchangeLab;
+    tradeResult: TradeResult;
+    verify?: boolean;
+}): import("@cashlab/cauldron").TradeTxResult;
+/**
+ * Convert watchtower UTXOs into @cashlab/common SpendableCoins.
+ * Mirrors paytaca-app watchtowerUtxosToSpendableCoins().
+ */
+export interface WatchtowerUtxo {
+    txid: string;
+    vout: number;
+    value: number;
+    tokenid?: string;
+    amount?: number;
+    address_path: string;
+    is_cashtoken?: boolean;
+}
+export declare function watchtowerUtxosToSpendableCoins(opts: {
+    utxos: WatchtowerUtxo[];
+    wallet: LibauthHDWallet;
+}): SpendableCoin[];
+/**
+ * On-chain byte size of a transaction input for a given unlocking script.
+ * Mirrors cashscript getInputSize().
+ */
+export declare function getInputSize(inputScript: Uint8Array): number;
+interface SizedOutput {
+    to: Uint8Array | string;
+    amount: bigint;
+    token?: {
+        category?: string;
+        amount: bigint;
+    };
+}
+/**
+ * On-chain byte size of a transaction output.
+ * Mirrors cashscript getOutputSize() (string `to` is treated as a CashAddress).
+ */
+export declare function getOutputSize(output: SizedOutput): number;
+export {};
+//# sourceMappingURL=transact.d.ts.map

package/dist/wallet/cauldron/transact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transact.d.ts","sourceRoot":"","sources":["../../../src/wallet/cauldron/transact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,WAAW,EAEX,KAAK,MAAM,EACX,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,aAAa,EAEnB,MAAM,iBAAiB,CAAA;AAUxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AASjD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,aAAa,EAAE,OAAO,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,CA8BhE;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,WAAW,EAAE,WAAW,CAAA;IACxB,cAAc,EAAE,aAAa,EAAE,CAAA;IAC/B,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,GAAG;IAAE,UAAU,EAAE,aAAa,EAAE,CAAC;IAAC,OAAO,EAAE,UAAU,EAAE,CAAA;CAAE,CAkIzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG;IACxD,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB,CAcA;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,WAAW,EAAE,WAAW,CAAA;IACxB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,6CAmEA;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE;IACpD,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,MAAM,EAAE,eAAe,CAAA;CACxB,GAAG,aAAa,EAAE,CAmClB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,UAAU,GAAG,MAAM,CAI5D;AAED,UAAU,WAAW;IACnB,EAAE,EAAE,UAAU,GAAG,MAAM,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA+BzD"}