tbc-tx-parser 0.1.0

package/README.md

@@ -0,0 +1,214 @@
+# tbc-tx-parser
+
+An SDK for decoding raw TBC transactions (`txraw`) into on-chain facts and asset flows for wallets, block explorers, and debugging tools.
+
+## Installation
+
+```bash
+npm install tbc-tx-parser
+```
+
+```bash
+pnpm add tbc-tx-parser
+```
+
+## Supported Features
+
+Currently supported:
+
+- Native TBC transfers, coinbase rewards, self/change flows, fees, and common locking-script outputs.
+- FT / StableCoin mint, transfer, merge, and mixed FT/TBC transactions.
+- NFT collection mint, ordinary NFT mint/transfer, and hash-only Hold burn detection.
+- OrderBook placement, cancellation, update, and matching semantics.
+- PoolNFT create, init, increase liquidity, consume liquidity, TBC-to-FT swaps, FT-to-TBC swaps, merge FT in pool, standalone LP merge, and LP burn.
+- PiggyBank freeze / unfreeze.
+
+The parser never accesses the network or fetches prevouts by txid. The caller must provide `inputUtxos` for every transaction input.
+Coinbase reward transactions have no spendable input prevouts and are the only exception that may omit `inputUtxos`.
+
+## Basic Usage
+
+```ts
+import { decodeTxRaw } from 'tbc-tx-parser';
+
+const result = await decodeTxRaw(txraw, {
+  inputUtxos,
+});
+```
+
+## Input UTXOs
+
+Asset-flow decoding requires the prevout for every input. Passing only `txraw` throws because the parser cannot reliably determine where assets originated:
+
+```ts
+const result = await decodeTxRaw(txraw, {
+  inputUtxos: {
+    'prevTxid:0': {
+      satoshis: 1000000,
+      lockingScript: '76a914...88ac',
+    },
+  },
+});
+```
+
+The key format is:
+
+```ts
+`${prevTxid}:${vout}`
+```
+
+An array ordered by input may also be used:
+
+```ts
+const result = await decodeTxRaw(txraw, {
+  inputUtxos: [
+    {
+      satoshis: 1000000,
+      lockingScript: '76a914...88ac',
+    },
+  ],
+});
+```
+
+Contract-asset inputs also require their paired unspendable tape prevouts:
+
+- FT / StableCoin Code input: `associatedTape` is `vout + 1` in the same transaction and must be a zero-satoshi `FTape`.
+- NFT Code input: `associatedTape` is `vout + 2` in the same transaction and must be a zero-satoshi `NTape`; the same spend must also contain the corresponding NFT Hold input. `associatedOrigin` should provide the origin UTXO referenced by the Code script. A Mint NHold origin proves collection membership, while an ordinary P2PKH origin proves a standalone NFT that does not use a collection UTXO.
+- PoolNFT state input: when the state prevout does not directly carry the PoolNFT tape, provide the adjacent PoolNFT OP_RETURN tape at `vout + 1` as `associatedTape` so the parser can compare the previous and current pool states.
+
+If a paired tape is missing, scripts do not match, or an input prevout is not a valid script for the asset, the result does not emit strongly verified protocol asset flows. Related positive-value locking outputs are displayed as TBC flowing to an address, a known contract, or an unknown locking script.
+
+## Return Value
+
+```ts
+const result = await decodeTxRaw(txraw, { inputUtxos });
+
+result.txid;
+result.version;
+result.locktime;
+result.size;
+result.chain.inputs;
+result.chain.outputs;
+result.chain.fee;
+result.assetFlows;
+```
+
+Common fields:
+
+- `chain.inputs`: transaction inputs and decoded prevout facts.
+- `chain.outputs`: transaction outputs, addresses, script classifications, and protocol tape state.
+- `chain.fee`: transaction fee.
+- `assetFlows`: primary asset-flow data for application displays.
+
+The top-level SDK result does not expose `transactionType`. Transaction-type labels can make `unknown` or weakly evidenced transactions look definitive, so presentation layers should build descriptions from verifiable facts in `assetFlows`, `chain.inputs`, and `chain.outputs`.
+
+The current version also keeps internal `semantic`, `protocolDetails`, and `unsupported` data private. These remain internal protocol-classification and diagnostic capabilities and can later be exposed through an optional diagnostic result if an explorer or protocol-details view needs them.
+
+Core `assetFlows` structure:
+
+```ts
+result.assetFlows[0]?.purpose;   // transfer | self | fee | lock | release | mint | merge | burn | state | unknown
+result.assetFlows[0]?.direction; // in | out | self | unknown
+result.assetFlows[0]?.asset;     // { type: 'tbc' | 'ft' | 'stablecoin' | 'nft', ... }
+result.assetFlows[0]?.amount;    // Present for divisible assets such as TBC/FT; absent from NFT flows
+result.assetFlows[0]?.from;      // address / addresses / hash / txid / vout
+result.assetFlows[0]?.to;        // address / addresses / hash / script / txid / vout
+result.assetFlows[0]?.context;   // optional { protocol, recognized, action?, markers? }
+```
+
+Protocol-specific flows retain a generic `purpose` and may include `context`. For example, PiggyBank freeze and OrderBook placement both use `purpose: "lock"`, while `context.protocol` and `context.action` distinguish `piggyBank/freeze` from `orderBook/placeBuy` or `orderBook/placeSell`. Recognized OrderBook context is attached only to placement locks. Match settlement and match fee-recipient payments are plain transfers, cancellation refunds are releases, and recreated partial-fill or update order state is read from `chain.outputs[].script.data.orderBook` rather than exposed as an asset flow. OrderBook fee-recipient payments use `purpose: "transfer"`. PoolNFT reserve snapshots are likewise read from `chain.outputs[].script.data.poolNft`; `assetFlows` contains only the pool's observable transfers, LP mint/burn, self/change, and visible fee flows. Unknown contract carriers remain `purpose: "transfer"` and use `protocol: "unknown"` with `recognized: false`; marker evidence may be included without guessing a protocol name. When no owner address or hash can be extracted from a locking script, the destination is represented by `to.script`.
+
+Display guidance:
+
+- Summarize what a transaction does from `assetFlows`, script facts, and application context.
+- Use `assetFlows` as the primary source for showing how assets move.
+- Read `chain.inputs` / `chain.outputs` `script.data` when displaying contract state or protocol tape fields.
+
+## Amount Units
+
+TBC amounts use satoshis:
+
+```ts
+result.chain.outputs[0].satoshis;
+result.chain.fee?.satoshis;
+```
+
+FT / StableCoin / PoolNFT LP amounts use raw smallest-unit strings:
+
+```ts
+result.assetFlows[0]?.amount;
+```
+
+NFTs are indivisible, so ordinary NFT flows do not contain `amount`. `supply` is collection-creation metadata and does not represent a quantity for an individual NFT. An NFT minted from a collection Mint NHold may include `collectionId`; a standalone NFT originating from ordinary P2PKH retains only its own `contractId` and has no collection fields.
+
+## PoolNFT Notes
+
+PoolNFT is a composite protocol. Decoding considers all of the following rather than relying only on the PoolNFT tape:
+
+- Previous pool state input.
+- Current pool state output.
+- PoolNFT OP_RETURN tape.
+- FT A / FTLP movements.
+- TBC reserve delta, payout, and fee output.
+- LP token identity, partial hash, and burn receiver.
+
+The active PoolNFT fixture corpus contains exactly 18 real testnet broadcasts: the nine operations above for one unlocked and one public-key-locked PoolNFT v2 pool. Both modes use independent ordinary FT contracts and independent pools. The locked cases have `withLock: true`; the unlocked cases have `withLock: false`; all 18 cases use `withLockTime: false`.
+
+Current PoolNFT coverage includes the primary paths and several false-positive protections:
+
+- Reserve delta, FT A amount, and fee relationships for both swap directions.
+- FT A, LP, and TBC relationships for increase / consume liquidity.
+- LP change, no-visible-fee cases, and small TBC rounding boundaries during consume.
+- Current FT A reserve validation for merge FT in pool.
+- Standalone FTLP merges remain FT self flows without recreating PoolNFT state.
+- Standalone FTLP burns remain FT burn flows without recreating PoolNFT state.
+- Multiple PoolNFT tapes or multiple previous PoolNFT state inputs are currently treated as unsupported and do not produce PoolNFT movements.
+
+If the caller omits the previous pool state's associated tape, PoolNFT may still be recognized as `heuristic`, but a complete state delta cannot be calculated.
+
+### Regenerating PoolNFT broadcast fixtures
+
+The runner is testnet-only and resumable. Its key file, public transaction journal, and generated candidates remain ignored under `scripts/`. Preserve the journal until fixture generation finishes: it records both the 18 target transactions and the preparation transactions needed to resume safely. Preparation transactions are never promoted as fixtures.
+
+Run the read-only checks first:
+
+```bash
+TBC_KEYS_FILE=/absolute/path/to/tbc-test-addresses.json \
+TBC_POOL_NFT_JOURNAL=/absolute/path/to/pool-nft-broadcast-journal.json \
+npm run pool-nft:preflight
+
+TBC_POOL_NFT_JOURNAL=/absolute/path/to/pool-nft-broadcast-journal.json \
+npm run pool-nft:status
+```
+
+Broadcast each lifecycle only when testnet spending is intended. `TBC_BROADCAST=1` is an explicit mutation guard and these commands spend testnet UTXOs:
+
+```bash
+TBC_BROADCAST=1 TBC_KEYS_FILE=/absolute/path/to/tbc-test-addresses.json \
+TBC_POOL_NFT_JOURNAL=/absolute/path/to/pool-nft-broadcast-journal.json \
+npm run pool-nft:run -- unlocked
+
+TBC_BROADCAST=1 TBC_KEYS_FILE=/absolute/path/to/tbc-test-addresses.json \
+TBC_POOL_NFT_JOURNAL=/absolute/path/to/pool-nft-broadcast-journal.json \
+npm run pool-nft:run -- locked
+```
+
+After `status` reports all 18 targets complete, generate reviewed candidates without broadcasting:
+
+```bash
+TBC_POOL_NFT_JOURNAL=/absolute/path/to/pool-nft-broadcast-journal.json \
+npm run pool-nft:fixtures
+```
+
+The generator re-fetches every target raw transaction from testnet, verifies its txid, decodes its prevouts, validates lock flags, rejects public `purpose: "state"` flows, and writes candidates under `scripts/pool-nft-generated/`. Pool reserve state belongs under `chain.outputs[].script.data.poolNft`; only observable transfers, mint/burn, self/change, and visible fees belong in `assetFlows`.
+
+## Notes
+
+- The SDK does not access the network.
+- The SDK does not accept a `network` parameter.
+- The SDK does not query transactions by `txid`.
+- The SDK does not fetch input prevouts; callers must provide `inputUtxos`.
+- The SDK does not currently expose top-level `transactionType`, `semantic`, `protocolDetails`, or `unsupported` fields.
+- TBC addresses use canonical TBC address encoding.
+- `tbc-lib-js` and `tbc-contract` are runtime dependencies installed with the npm package.
+- `docs/`, `scripts/`, and `tests/` are not published to npm; the package contains only `dist`, `README.md`, and `package.json`.

package/dist/adapters/partial-sha256.d.ts

@@ -0,0 +1,2 @@
+export declare function calculatePartialSha256(input: Buffer): string;
+//# sourceMappingURL=partial-sha256.d.ts.map

package/dist/adapters/partial-sha256.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partial-sha256.d.ts","sourceRoot":"","sources":["../../src/adapters/partial-sha256.ts"],"names":[],"mappings":"AAEA,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,UAEnD"}

package/dist/adapters/partial-sha256.js

@@ -0,0 +1,5 @@
+import partialSha256 from 'tbc-lib-js/lib/util/partial-sha256.js';
+export function calculatePartialSha256(input) {
+    return partialSha256.calculate_partial_hash(input);
+}
+//# sourceMappingURL=partial-sha256.js.map

package/dist/adapters/partial-sha256.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"partial-sha256.js","sourceRoot":"","sources":["../../src/adapters/partial-sha256.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,uCAAuC,CAAC;AAElE,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,OAAO,aAAa,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC"}

package/dist/adapters/tbc-lib.d.ts

@@ -0,0 +1,4 @@
+import * as tbcModule from 'tbc-lib-js';
+export declare const tbc: typeof tbcModule;
+export type TbcScript = InstanceType<typeof tbc.Script>;
+//# sourceMappingURL=tbc-lib.d.ts.map

package/dist/adapters/tbc-lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tbc-lib.d.ts","sourceRoot":"","sources":["../../src/adapters/tbc-lib.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,YAAY,CAAC;AAGxC,eAAO,MAAM,GAAG,EAA2E,OAAO,SAAS,CAAC;AAC5G,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC"}

package/dist/adapters/tbc-lib.js

@@ -0,0 +1,4 @@
+import * as tbcModule from 'tbc-lib-js';
+// Normalize tbc-lib-js imports across ESM and CJS so callers do not handle default-export compatibility.
+export const tbc = (tbcModule.default ?? tbcModule);
+//# sourceMappingURL=tbc-lib.js.map

package/dist/adapters/tbc-lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tbc-lib.js","sourceRoot":"","sources":["../../src/adapters/tbc-lib.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,YAAY,CAAC;AAExC,yGAAyG;AACzG,MAAM,CAAC,MAAM,GAAG,GAAG,CAAE,SAA4C,CAAC,OAAO,IAAI,SAAS,CAAqB,CAAC"}

package/dist/constants/chain.d.ts

@@ -0,0 +1,4 @@
+export declare const TBC_DECIMALS = 6;
+export declare const SATOSHIS_PER_TBC = 1000000;
+export declare const TBC_SYMBOL = "TBC";
+//# sourceMappingURL=chain.d.ts.map

package/dist/constants/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../src/constants/chain.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,YAAY,IAAI,CAAC;AAG9B,eAAO,MAAM,gBAAgB,UAAY,CAAC;AAG1C,eAAO,MAAM,UAAU,QAAQ,CAAC"}

package/dist/constants/chain.js

@@ -0,0 +1,7 @@
+// Decimal precision used when converting between display TBC and satoshis.
+export const TBC_DECIMALS = 6;
+// Native smallest-unit conversion: 1 TBC = 1,000,000 satoshis.
+export const SATOSHIS_PER_TBC = 1_000_000;
+// Native asset symbol used in public asset-flow and semantic results.
+export const TBC_SYMBOL = 'TBC';
+//# sourceMappingURL=chain.js.map

package/dist/constants/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../../src/constants/chain.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAE9B,+DAA+D;AAC/D,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAE1C,sEAAsE;AACtE,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC"}

package/dist/core/chain.d.ts

@@ -0,0 +1,10 @@
+import type { DecodedInput, DecodedOutput, ScriptDetail, ScriptKind } from '../types.js';
+export declare function parseScriptWithHex(scriptHex: string): ScriptDetail;
+export declare function inferScriptKind(script: ScriptDetail): ScriptKind;
+export declare function calculateChainStats(inputs: DecodedInput[], outputs: DecodedOutput[], size: number): {
+    inputValue: number | undefined;
+    outputValue: number;
+    fee: number | undefined;
+    feeRate: number | undefined;
+};
+//# sourceMappingURL=chain.d.ts.map

package/dist/core/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../src/core/chain.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAKlE;AAGD,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAkBhE;AAGD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM;;;;;EAcjG"}

package/dist/core/chain.js

@@ -0,0 +1,41 @@
+import { parseScript } from '../script-parser.js';
+import { ScriptType } from '../types.js';
+// The script parser returns structured facts; restore raw hex here for chain facts and debugging displays.
+export function parseScriptWithHex(scriptHex) {
+    return {
+        ...parseScript(scriptHex),
+        hex: scriptHex,
+    };
+}
+// Reduce detailed script results to the broad classifications required by the public chain layer.
+export function inferScriptKind(script) {
+    if (script.originUtxo) {
+        return 'contract';
+    }
+    if (script.type === ScriptType.P2PKH) {
+        return 'p2pkh';
+    }
+    if (script.type === ScriptType.MULTISIG) {
+        return 'multisig';
+    }
+    if (script.data) {
+        return 'op_return';
+    }
+    return 'unrecognized';
+}
+// Calculate fees only when every input prevout amount is known to avoid reporting fees from incomplete data.
+export function calculateChainStats(inputs, outputs, size) {
+    const inputValue = inputs.every((input) => input.prevout?.satoshis !== undefined)
+        ? inputs.reduce((sum, input) => sum + (input.prevout?.satoshis ?? 0), 0)
+        : undefined;
+    const outputValue = outputs.reduce((sum, output) => sum + output.satoshis, 0);
+    const valueDelta = inputValue === undefined ? undefined : inputValue - outputValue;
+    const fee = valueDelta === undefined || valueDelta < 0 ? undefined : valueDelta;
+    return {
+        inputValue,
+        outputValue,
+        fee,
+        feeRate: fee === undefined ? undefined : Math.ceil(fee / Math.max(1, Math.ceil(size / 1000))),
+    };
+}
+//# sourceMappingURL=chain.js.map

package/dist/core/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../../src/core/chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,2GAA2G;AAC3G,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,OAAO;QACL,GAAG,WAAW,CAAC,SAAS,CAAC;QACzB,GAAG,EAAE,SAAS;KACf,CAAC;AACJ,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,KAAK,EAAE,CAAC;QACrC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,QAAQ,EAAE,CAAC;QACxC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,6GAA6G;AAC7G,MAAM,UAAU,mBAAmB,CAAC,MAAsB,EAAE,OAAwB,EAAE,IAAY;IAChG,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS,CAAC;QAC/E,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9E,MAAM,UAAU,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,GAAG,WAAW,CAAC;IACnF,MAAM,GAAG,GAAG,UAAU,KAAK,SAAS,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;IAEhF,OAAO;QACL,UAAU;QACV,WAAW;QACX,GAAG;QACH,OAAO,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;KAC9F,CAAC;AACJ,CAAC"}

package/dist/core/input-utxos.d.ts

@@ -0,0 +1,3 @@
+import type { DecodeTxRawOptions, InputUTXODetail } from '../types.js';
+export declare function parseInputUtxo(txid: string, outputIndex: number, inputIndex: number, options: DecodeTxRawOptions): InputUTXODetail | undefined;
+//# sourceMappingURL=input-utxos.d.ts.map

package/dist/core/input-utxos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-utxos.d.ts","sourceRoot":"","sources":["../../src/core/input-utxos.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA2DxF,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,kBAAkB,GAC1B,eAAe,GAAG,SAAS,CA2B7B"}

package/dist/core/input-utxos.js

@@ -0,0 +1,69 @@
+import { parseScriptWithHex } from './chain.js';
+function parseAssociatedInputUtxo(value) {
+    if (!value) {
+        return undefined;
+    }
+    const script = parseScriptWithHex(value.lockingScript);
+    return {
+        txid: value.txid,
+        outputIndex: value.outputIndex,
+        script,
+        address: script.address ?? script.data?.address,
+        satoshis: value.satoshis,
+    };
+}
+// Record-form input UTXOs use on-chain outpoints as keys.
+function getInputUtxoKey(txid, outputIndex) {
+    return `${txid}:${outputIndex}`;
+}
+// Support array and Record inputs; array mode can progressively match by input index or outpoint.
+function findInputUtxo(inputUtxos, txid, outputIndex, inputIndex) {
+    if (!inputUtxos) {
+        return undefined;
+    }
+    if (Array.isArray(inputUtxos)) {
+        return inputUtxos.find((utxo, index) => {
+            if (utxo.inputIndex !== undefined) {
+                return utxo.inputIndex === inputIndex;
+            }
+            if (utxo.txid !== undefined && utxo.outputIndex !== undefined) {
+                return utxo.txid === txid && utxo.outputIndex === outputIndex;
+            }
+            if (utxo.txid !== undefined) {
+                return utxo.txid === txid;
+            }
+            if (utxo.outputIndex !== undefined) {
+                return utxo.outputIndex === outputIndex;
+            }
+            return index === inputIndex;
+        });
+    }
+    return inputUtxos[getInputUtxoKey(txid, outputIndex)] ?? inputUtxos[inputIndex.toString()];
+}
+// Parse caller-provided prevouts into fact-layer structures consumed directly by chain inputs.
+export function parseInputUtxo(txid, outputIndex, inputIndex, options) {
+    const inputUtxo = findInputUtxo(options.inputUtxos, txid, outputIndex, inputIndex);
+    if (!inputUtxo) {
+        return undefined;
+    }
+    if (!Number.isFinite(inputUtxo.satoshis) || inputUtxo.satoshis < 0) {
+        return {
+            script: { asm: '' },
+            error: 'invalid input utxo satoshis',
+        };
+    }
+    const script = parseScriptWithHex(inputUtxo.lockingScript);
+    // associatedTape is the key prevout used to verify input-state continuity for FT, NFT, PoolNFT, and similar protocols.
+    const associatedTape = parseAssociatedInputUtxo(inputUtxo.associatedTape);
+    const associatedOrigin = parseAssociatedInputUtxo(inputUtxo.associatedOrigin);
+    return {
+        script,
+        address: script.address ?? script.data?.address,
+        hash: script.data?.hash,
+        satoshis: inputUtxo.satoshis,
+        ...(inputUtxo.contractId ? { contractId: inputUtxo.contractId } : {}),
+        ...(associatedTape ? { associatedTape } : {}),
+        ...(associatedOrigin ? { associatedOrigin } : {}),
+    };
+}
+//# sourceMappingURL=input-utxos.js.map

package/dist/core/input-utxos.js.map

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

package/dist/core/public-chain-compression.d.ts

@@ -0,0 +1,4 @@
+import type { PublicDecodedInput, PublicDecodedOutput } from '../types.js';
+export declare function compressPublicInputs(inputs: PublicDecodedInput[], minimumRunLength?: number): PublicDecodedInput[];
+export declare function compressPublicOutputs(outputs: PublicDecodedOutput[], minimumRunLength?: number): PublicDecodedOutput[];
+//# sourceMappingURL=public-chain-compression.d.ts.map

package/dist/core/public-chain-compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-chain-compression.d.ts","sourceRoot":"","sources":["../../src/core/public-chain-compression.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAoB3E,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,kBAAkB,EAAE,EAC5B,gBAAgB,SAA6B,GAC5C,kBAAkB,EAAE,CAiCtB;AAaD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,mBAAmB,EAAE,EAC9B,gBAAgB,SAA6B,GAC5C,mBAAmB,EAAE,CA+BvB"}

package/dist/core/public-chain-compression.js

@@ -0,0 +1,87 @@
+import { ScriptType } from '../types.js';
+const DEFAULT_MINIMUM_RUN_LENGTH = 3;
+function samePublicPrevout(left, right) {
+    return JSON.stringify(left.prevout) === JSON.stringify(right.prevout);
+}
+function continuesTbcInputRun(previous, current) {
+    return !previous.compression &&
+        !current.compression &&
+        previous.prevout?.script.type === ScriptType.P2PKH &&
+        current.prevout?.script.type === ScriptType.P2PKH &&
+        current.index === previous.index + 1 &&
+        current.prevTxid === previous.prevTxid &&
+        current.vout === previous.vout + 1 &&
+        current.sequence === previous.sequence &&
+        samePublicPrevout(previous, current);
+}
+export function compressPublicInputs(inputs, minimumRunLength = DEFAULT_MINIMUM_RUN_LENGTH) {
+    const compressed = [];
+    for (let start = 0; start < inputs.length;) {
+        let end = start + 1;
+        while (end < inputs.length && continuesTbcInputRun(inputs[end - 1], inputs[end])) {
+            end += 1;
+        }
+        const run = inputs.slice(start, end);
+        const first = run[0];
+        const last = run[run.length - 1];
+        if (first && last && run.length >= minimumRunLength && first.prevout?.satoshis !== undefined) {
+            compressed.push({
+                ...first,
+                compression: {
+                    type: 'tbcInputs',
+                    count: run.length,
+                    indexRange: { from: first.index, to: last.index },
+                    prevTxid: first.prevTxid,
+                    voutRange: { from: first.vout, to: last.vout },
+                    satoshisPerInput: first.prevout.satoshis,
+                    totalSatoshis: run.reduce((sum, input) => sum + (input.prevout?.satoshis ?? 0), 0),
+                },
+            });
+        }
+        else {
+            compressed.push(...run);
+        }
+        start = end;
+    }
+    return compressed;
+}
+function continuesTbcOutputRun(previous, current) {
+    return !previous.compression &&
+        !current.compression &&
+        previous.script.type === ScriptType.P2PKH &&
+        current.script.type === ScriptType.P2PKH &&
+        current.index === previous.index + 1 &&
+        current.satoshis === previous.satoshis &&
+        current.address === previous.address &&
+        JSON.stringify(current.script) === JSON.stringify(previous.script);
+}
+export function compressPublicOutputs(outputs, minimumRunLength = DEFAULT_MINIMUM_RUN_LENGTH) {
+    const compressed = [];
+    for (let start = 0; start < outputs.length;) {
+        let end = start + 1;
+        while (end < outputs.length && continuesTbcOutputRun(outputs[end - 1], outputs[end])) {
+            end += 1;
+        }
+        const run = outputs.slice(start, end);
+        const first = run[0];
+        const last = run[run.length - 1];
+        if (first && last && run.length >= minimumRunLength) {
+            compressed.push({
+                ...first,
+                compression: {
+                    type: 'tbcOutputs',
+                    count: run.length,
+                    indexRange: { from: first.index, to: last.index },
+                    satoshisPerOutput: first.satoshis,
+                    totalSatoshis: run.reduce((sum, output) => sum + output.satoshis, 0),
+                },
+            });
+        }
+        else {
+            compressed.push(...run);
+        }
+        start = end;
+    }
+    return compressed;
+}
+//# sourceMappingURL=public-chain-compression.js.map

package/dist/core/public-chain-compression.js.map

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

package/dist/core/public-script.d.ts

@@ -0,0 +1,4 @@
+import type { PublicScriptDetail, ScriptDetail } from '../types.js';
+export declare const PUBLIC_SCRIPT_COMPACTION_THRESHOLD_BYTES = 256;
+export declare function sanitizeScriptForPublicResult(script: ScriptDetail): PublicScriptDetail;
+//# sourceMappingURL=public-script.d.ts.map

package/dist/core/public-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-script.d.ts","sourceRoot":"","sources":["../../src/core/public-script.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,kBAAkB,EAElB,YAAY,EAEb,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,wCAAwC,MAAM,CAAC;AAgG5D,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,YAAY,GAAG,kBAAkB,CAyBtF"}

package/dist/core/public-script.js

@@ -0,0 +1,94 @@
+import { createHash } from 'node:crypto';
+export const PUBLIC_SCRIPT_COMPACTION_THRESHOLD_BYTES = 256;
+const PUBLIC_ASM_EDGE_MAX_BYTES = 256;
+function scriptByteLength(hex) {
+    return hex && hex.length % 2 === 0 && /^[0-9a-f]*$/iu.test(hex)
+        ? Buffer.from(hex, 'hex').length
+        : undefined;
+}
+function tbcApiScriptHash(hex) {
+    return createHash('sha256')
+        .update(Buffer.from(hex, 'hex'))
+        .digest()
+        .reverse()
+        .toString('hex');
+}
+function takeWholeTokens(tokens, maxBytes, fromEnd = false) {
+    const selected = [];
+    const ordered = fromEnd ? [...tokens].reverse() : tokens;
+    for (const token of ordered) {
+        const candidate = fromEnd ? [token, ...selected].join(' ') : [...selected, token].join(' ');
+        if (Buffer.byteLength(candidate, 'utf8') > maxBytes) {
+            break;
+        }
+        if (fromEnd) {
+            selected.unshift(token);
+        }
+        else {
+            selected.push(token);
+        }
+    }
+    return selected.join(' ');
+}
+function compactAsm(asm) {
+    const tokens = asm.trim() ? asm.trim().split(/\s+/u) : [];
+    return {
+        byteLength: Buffer.byteLength(asm, 'utf8'),
+        prefix: takeWholeTokens(tokens, PUBLIC_ASM_EDGE_MAX_BYTES),
+        suffix: takeWholeTokens(tokens, PUBLIC_ASM_EDGE_MAX_BYTES, true),
+    };
+}
+function sanitizeFtTape(ftTape) {
+    return {
+        name: ftTape.name,
+        symbol: ftTape.symbol,
+        decimal: ftTape.decimal,
+        ...(ftTape.lockTime !== undefined ? { lockTime: ftTape.lockTime } : {}),
+        ...(ftTape.isStableCoin !== undefined ? { isStableCoin: ftTape.isStableCoin } : {}),
+    };
+}
+function sanitizeNftTape(nftTape) {
+    const { file: _file, media: _media, image: _image, ...publicTape } = nftTape;
+    return publicTape;
+}
+function sanitizeCollectionTape(collectionTape) {
+    return {
+        collectionName: collectionTape.collectionName,
+        ...(collectionTape.description !== undefined ? { description: collectionTape.description } : {}),
+        supply: collectionTape.supply,
+    };
+}
+function sanitizeData(data) {
+    if (!data) {
+        return undefined;
+    }
+    const { nftHoldLabel: _nftHoldLabel, nftHoldType: _nftHoldType, ...publicData } = data;
+    const sanitizedData = {
+        ...publicData,
+        ...(data.ftTape ? { ftTape: sanitizeFtTape(data.ftTape) } : {}),
+        ...(data.nftTape ? { nftTape: sanitizeNftTape(data.nftTape) } : {}),
+        ...(data.collectionTape ? { collectionTape: sanitizeCollectionTape(data.collectionTape) } : {}),
+    };
+    return Object.keys(sanitizedData).length ? sanitizedData : undefined;
+}
+export function sanitizeScriptForPublicResult(script) {
+    const { asm, hex, data: scriptData, ...scriptFacts } = script;
+    const byteLength = scriptByteLength(hex);
+    const shouldCompact = byteLength !== undefined && byteLength > PUBLIC_SCRIPT_COMPACTION_THRESHOLD_BYTES;
+    const data = sanitizeData(scriptData);
+    return {
+        ...scriptFacts,
+        asm: shouldCompact ? compactAsm(asm) : asm,
+        ...(hex
+            ? {
+                hex: {
+                    ...(!shouldCompact ? { value: hex } : {}),
+                    byteLength: byteLength ?? Buffer.from(hex, 'hex').length,
+                    scriptHash: tbcApiScriptHash(hex),
+                },
+            }
+            : {}),
+        ...(data ? { data } : {}),
+    };
+}
+//# sourceMappingURL=public-script.js.map

package/dist/core/public-script.js.map

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