paytaca-cli 0.4.0 → 0.5.0

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

@@ -0,0 +1,58 @@
+/**
+ * Cauldron (riften indexer) REST client.
+ *
+ * Adapted from: paytaca-app/src/wallet/cauldron/api.js, tokens.js,
+ * and pool-tracker.ts. Uses the global fetch API (Node 20+) instead of axios.
+ */
+/**
+ * An active pool as returned by the cauldron indexer.
+ * GET /cauldron/pool/active?token=<category>
+ */
+export interface ApiPool {
+    owner_p2pkh_addr: string;
+    owner_pkh: string;
+    pool_id: string;
+    sats: number;
+    token_id: string;
+    tokens: number;
+    tx_pos: number;
+    txid: string;
+}
+/**
+ * A cauldron-listed token (market info + BCMR metadata).
+ * GET /cauldron/tokens/list_cached_by_ids?ids=<category>
+ */
+export interface CauldronTokenData {
+    token_id: string;
+    display_name: string;
+    display_symbol: string;
+    price_now: number;
+    price_now_usd: number;
+    tvl_sats: number;
+    bcmr: {
+        name: string;
+        description: string;
+        token: {
+            category: string;
+            decimals: number;
+            symbol: string;
+        };
+        uris?: {
+            icon?: string;
+            web?: string;
+        };
+    };
+}
+export declare class CauldronApiError extends Error {
+    status?: number;
+    constructor(message: string, status?: number);
+}
+/**
+ * Fetch the active cauldron pools for a token category.
+ */
+export declare function fetchPoolsForToken(tokenId: string): Promise<ApiPool[]>;
+/**
+ * Fetch market + BCMR data for a single token category.
+ */
+export declare function fetchTokenData(tokenId: string): Promise<CauldronTokenData | undefined>;
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/wallet/cauldron/api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,KAAK,EAAE;YACL,QAAQ,EAAE,MAAM,CAAA;YAChB,QAAQ,EAAE,MAAM,CAAA;YAChB,MAAM,EAAE,MAAM,CAAA;SACf,CAAA;QACD,IAAI,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KACvC,CAAA;CACF;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;gBACH,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAK7C;AA6BD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAQ5E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAYxC"}

package/dist/wallet/cauldron/api.js

@@ -0,0 +1,60 @@
+/**
+ * Cauldron (riften indexer) REST client.
+ *
+ * Adapted from: paytaca-app/src/wallet/cauldron/api.js, tokens.js,
+ * and pool-tracker.ts. Uses the global fetch API (Node 20+) instead of axios.
+ */
+const CAULDRON_INDEXER_BASE_URL = 'https://indexer.riften.net';
+export class CauldronApiError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.name = 'CauldronApiError';
+        this.status = status;
+    }
+}
+async function getJson(path, params = {}) {
+    const url = new URL(CAULDRON_INDEXER_BASE_URL + path);
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null || value === '')
+            continue;
+        url.searchParams.set(key, String(value));
+    }
+    let response;
+    try {
+        response = await fetch(url.toString());
+    }
+    catch (err) {
+        throw new CauldronApiError(`Cauldron indexer unreachable: ${err?.message || err}`);
+    }
+    if (!response.ok) {
+        throw new CauldronApiError(`Cauldron indexer request failed (${response.status} ${response.statusText})`, response.status);
+    }
+    return response.json();
+}
+/**
+ * Fetch the active cauldron pools for a token category.
+ */
+export async function fetchPoolsForToken(tokenId) {
+    const data = await getJson('/cauldron/pool/active', {
+        token: tokenId,
+    });
+    if (!Array.isArray(data.active)) {
+        throw new CauldronApiError('Unexpected response from cauldron pool endpoint');
+    }
+    return data.active;
+}
+/**
+ * Fetch market + BCMR data for a single token category.
+ */
+export async function fetchTokenData(tokenId) {
+    const data = await getJson('/cauldron/tokens/list_cached_by_ids', {
+        ids: tokenId,
+        limit: 1,
+        offset: 0,
+        by: 'score',
+        order: 'desc',
+    });
+    return Array.isArray(data) ? data[0] : undefined;
+}
+//# sourceMappingURL=api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/wallet/cauldron/api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,yBAAyB,GAAG,4BAA4B,CAAA;AAwC9D,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,MAAM,CAAS;IACf,YAAY,OAAe,EAAE,MAAe;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF;AAED,KAAK,UAAU,OAAO,CACpB,IAAY,EACZ,SAAsD,EAAE;IAExD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;IACrD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;YAAE,SAAQ;QACnE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IAC1C,CAAC;IAED,IAAI,QAAkB,CAAA;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAA;IACxC,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,MAAM,IAAI,gBAAgB,CAAC,iCAAiC,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC,CAAA;IACpF,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,gBAAgB,CACxB,oCAAoC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,GAAG,EAC7E,QAAQ,CAAC,MAAM,CAChB,CAAA;IACH,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAAgB,CAAA;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAe;IACtD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAuB,uBAAuB,EAAE;QACxE,KAAK,EAAE,OAAO;KACf,CAAC,CAAA;IACF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,gBAAgB,CAAC,iDAAiD,CAAC,CAAA;IAC/E,CAAC;IACD,OAAO,IAAI,CAAC,MAAmB,CAAA;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAe;IAEf,MAAM,IAAI,GAAG,MAAM,OAAO,CACxB,qCAAqC,EACrC;QACE,GAAG,EAAE,OAAO;QACZ,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,CAAC;QACT,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,MAAM;KACd,CACF,CAAA;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAClD,CAAC"}

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

@@ -0,0 +1,66 @@
+/**
+ * Cauldron pool conversions and helpers.
+ *
+ * Adapted from: paytaca-app/src/wallet/cauldron/utils.js and pool-tracker.ts.
+ * Converts indexer ApiPool entries into @cashlab/cauldron PoolV0 objects.
+ */
+import { type PoolV0 } from '@cashlab/cauldron';
+import { type ApiPool } from './api.js';
+export interface MicroPool {
+    pool_id: string;
+    pkh: string;
+    is_withdrawn: boolean;
+    spent_utxo_hash: string;
+    new_utxo_hash: string;
+    new_utxo_txid: string;
+    new_utxo_n: number;
+    token_id: string;
+    sats: number;
+    token_amount: number;
+}
+/**
+ * Convert an indexer ApiPool to a MicroPool.
+ */
+export declare function apiPoolToMicroPool(pool: ApiPool): MicroPool;
+/**
+ * Convert a MicroPool to a @cashlab/cauldron PoolV0.
+ */
+export declare function microPoolToPoolV0(pool: MicroPool): PoolV0;
+/**
+ * Fetch + convert active pools for a token category into PoolV0 objects.
+ */
+export declare function fetchPoolV0ForToken(tokenId: string): Promise<PoolV0[]>;
+/**
+ * Compute the post-trade state of a pool output (used for fee estimation).
+ * Mirrors paytaca-app poolTradeToCashscriptOutput().
+ */
+export interface PoolTradeOutput {
+    to: Uint8Array;
+    amount: bigint;
+    token: {
+        amount: bigint;
+        category: string;
+    };
+}
+/**
+ * @param poolTrade A @cashlab/cauldron PoolTrade
+ * @returns The pool's resulting output after the trade
+ */
+export declare function poolTradeToOutput(poolTrade: {
+    supply_token_id: string;
+    demand_token_id: string;
+    supply: bigint;
+    demand: bigint;
+    pool: PoolV0;
+}): PoolTradeOutput;
+/**
+ * Parse a trade rate (price) into a human-readable string.
+ * Mirrors paytaca-app parseRate().
+ *
+ * @param isBuyingToken true when BCH is spent to buy tokens (price in BCH per token)
+ */
+export declare function parseRate(rate: {
+    numerator: bigint;
+    denominator: bigint;
+}, tokenDecimals: number, isBuyingToken: boolean): string;
+//# sourceMappingURL=pools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pools.d.ts","sourceRoot":"","sources":["../../../src/wallet/cauldron/pools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAG5D,OAAO,EAAsB,KAAK,OAAO,EAAE,MAAM,UAAU,CAAA;AAE3D,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,OAAO,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAa3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAoBzD;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAG5E;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,UAAU,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;CACF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE;IAC3C,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb,GAAG,eAAe,CAclB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAChD,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,OAAO,GACrB,MAAM,CAcR"}

package/dist/wallet/cauldron/pools.js

@@ -0,0 +1,96 @@
+/**
+ * Cauldron pool conversions and helpers.
+ *
+ * Adapted from: paytaca-app/src/wallet/cauldron/utils.js and pool-tracker.ts.
+ * Converts indexer ApiPool entries into @cashlab/cauldron PoolV0 objects.
+ */
+import { ExchangeLab } from '@cashlab/cauldron';
+import { NATIVE_BCH_TOKEN_ID } from '@cashlab/common';
+import { hexToBin } from '@cashlab/common/libauth.js';
+import { fetchPoolsForToken } from './api.js';
+/**
+ * Convert an indexer ApiPool to a MicroPool.
+ */
+export function apiPoolToMicroPool(pool) {
+    return {
+        pool_id: pool.pool_id,
+        pkh: pool.owner_pkh,
+        is_withdrawn: false,
+        spent_utxo_hash: '',
+        new_utxo_hash: pool.txid,
+        new_utxo_txid: pool.txid,
+        new_utxo_n: pool.tx_pos,
+        token_id: pool.token_id,
+        sats: pool.sats,
+        token_amount: pool.tokens,
+    };
+}
+/**
+ * Convert a MicroPool to a @cashlab/cauldron PoolV0.
+ */
+export function microPoolToPoolV0(pool) {
+    const pool0Params = { withdraw_pubkey_hash: hexToBin(pool.pkh) };
+    const exlab = new ExchangeLab();
+    const pool0LockingBytecode = exlab.generatePoolV0LockingBytecode(pool0Params);
+    return {
+        version: '0',
+        parameters: pool0Params,
+        outpoint: {
+            index: pool.new_utxo_n,
+            txhash: hexToBin(pool.new_utxo_txid),
+        },
+        output: {
+            locking_bytecode: pool0LockingBytecode,
+            token: {
+                amount: BigInt(pool.token_amount),
+                token_id: pool.token_id,
+            },
+            amount: BigInt(pool.sats),
+        },
+    };
+}
+/**
+ * Fetch + convert active pools for a token category into PoolV0 objects.
+ */
+export async function fetchPoolV0ForToken(tokenId) {
+    const pools = await fetchPoolsForToken(tokenId);
+    return pools.map(apiPoolToMicroPool).map(microPoolToPoolV0);
+}
+/**
+ * @param poolTrade A @cashlab/cauldron PoolTrade
+ * @returns The pool's resulting output after the trade
+ */
+export function poolTradeToOutput(poolTrade) {
+    const isSupplyingBch = poolTrade.supply_token_id === NATIVE_BCH_TOKEN_ID;
+    const satoshisDelta = isSupplyingBch ? poolTrade.supply : poolTrade.demand * -1n;
+    const tokenDelta = isSupplyingBch ? poolTrade.demand * -1n : poolTrade.supply;
+    const poolOutput = poolTrade.pool.output;
+    return {
+        to: poolOutput.locking_bytecode,
+        amount: poolOutput.amount + satoshisDelta,
+        token: {
+            amount: poolOutput.token.amount + tokenDelta,
+            category: poolOutput.token.token_id,
+        },
+    };
+}
+/**
+ * Parse a trade rate (price) into a human-readable string.
+ * Mirrors paytaca-app parseRate().
+ *
+ * @param isBuyingToken true when BCH is spent to buy tokens (price in BCH per token)
+ */
+export function parseRate(rate, tokenDecimals, isBuyingToken) {
+    let multiplierDecimals = 8;
+    let divisorDecimals = tokenDecimals;
+    if (isBuyingToken) {
+        multiplierDecimals = tokenDecimals;
+        divisorDecimals = 8;
+    }
+    const multiplier = 10n ** BigInt(multiplierDecimals);
+    const _price = (rate.numerator * multiplier) / rate.denominator;
+    const divisor = 10 ** divisorDecimals;
+    const price = Number(_price) / divisor;
+    return price.toFixed(divisorDecimals);
+}
+//# sourceMappingURL=pools.js.map

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

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

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"}