tbc-tx-parser 0.1.0

package/dist/types/script.d.ts

@@ -0,0 +1,180 @@
+import type { OrderBookData, PiggyBankData, PoolNftTapeData } from './protocol.js';
+export declare const ScriptType: {
+    readonly P2PKH: "P2PKH";
+    readonly P2PK: "P2PK";
+    readonly P2SH: "P2SH";
+    readonly MULTISIG: "MULTISIG";
+    readonly OP_RETURN: "OP_RETURN";
+    readonly UNKNOWN: "UNKNOWN";
+};
+export type ScriptType = (typeof ScriptType)[keyof typeof ScriptType];
+export interface NftTapeData {
+    nftName?: string;
+    symbol?: string;
+    file?: string;
+    description?: string;
+    attributes?: string;
+    collectionId?: string;
+    collectionIndex?: number;
+    [key: string]: unknown;
+}
+export interface CollectionTapeData {
+    collectionName: string;
+    description?: string;
+    supply: number;
+    [key: string]: unknown;
+}
+export interface ScriptOpReturnData {
+    type?: string;
+    publicKeyHash?: string;
+    address?: string;
+    hash?: string;
+    flag?: 'address' | 'hash' | 'unknown';
+    codeType?: string;
+    ftTape?: {
+        name: string;
+        symbol: string;
+        amount: number;
+        displayAmount: string;
+        rawAmount: string;
+        amountSlots: string[];
+        decimal: number;
+        lockTime?: number;
+        isStableCoin?: boolean;
+    };
+    nftTape?: NftTapeData;
+    collectionTape?: CollectionTapeData;
+    nftHoldType?: 'mint' | 'current';
+    nftHoldLabel?: string;
+    poolNft?: PoolNftTapeData;
+    orderBook?: OrderBookData;
+    piggyBank?: PiggyBankData;
+    hexParts?: string[];
+    asciiParts?: string[];
+}
+export interface ScriptDetail {
+    asm: string;
+    hex?: string;
+    type?: ScriptType;
+    address?: string;
+    data?: ScriptOpReturnData;
+    originUtxo?: {
+        txid: string;
+        vout: number;
+    };
+}
+export interface CompactPublicAsm {
+    byteLength: number;
+    prefix: string;
+    suffix: string;
+}
+export interface PublicScriptHex {
+    value?: string;
+    byteLength: number;
+    scriptHash: string;
+}
+export type CompactPublicHex = Omit<PublicScriptHex, 'value'>;
+export type PublicNftTapeData = Omit<NonNullable<ScriptOpReturnData['nftTape']>, 'file' | 'media' | 'image'>;
+export type PublicCollectionTapeData = Pick<CollectionTapeData, 'collectionName' | 'description' | 'supply'>;
+export type PublicScriptOpReturnData = Omit<ScriptOpReturnData, 'nftTape' | 'collectionTape' | 'nftHoldLabel' | 'nftHoldType'> & {
+    nftTape?: PublicNftTapeData;
+    collectionTape?: PublicCollectionTapeData;
+};
+export interface PublicScriptDetail extends Omit<ScriptDetail, 'asm' | 'hex' | 'data'> {
+    asm: string | CompactPublicAsm;
+    hex?: PublicScriptHex;
+    data?: PublicScriptOpReturnData;
+}
+export interface ParsedAssociatedInputUtxo {
+    txid: string;
+    outputIndex: number;
+    script: ScriptDetail;
+    address?: string;
+    satoshis: number;
+}
+export interface InputUTXODetail {
+    script: ScriptDetail;
+    address?: string;
+    hash?: string;
+    satoshis?: number;
+    error?: string;
+    contractId?: string;
+    associatedTape?: ParsedAssociatedInputUtxo;
+    associatedOrigin?: ParsedAssociatedInputUtxo;
+}
+export interface PublicParsedAssociatedInputUtxo extends Omit<ParsedAssociatedInputUtxo, 'script'> {
+    script: PublicScriptDetail;
+}
+export interface PublicInputUTXODetail extends Omit<InputUTXODetail, 'script' | 'associatedTape' | 'associatedOrigin'> {
+    script: PublicScriptDetail;
+    associatedTape?: PublicParsedAssociatedInputUtxo;
+    associatedOrigin?: PublicParsedAssociatedInputUtxo;
+}
+export interface AssociatedDecodeInputUtxo {
+    txid: string;
+    outputIndex: number;
+    satoshis: number;
+    lockingScript: string;
+}
+export interface DecodeInputUtxo {
+    inputIndex?: number;
+    txid?: string;
+    outputIndex?: number;
+    satoshis: number;
+    lockingScript: string;
+    contractId?: string;
+    associatedTape?: AssociatedDecodeInputUtxo;
+    associatedOrigin?: AssociatedDecodeInputUtxo;
+}
+export interface DecodedInput {
+    index: number;
+    prevTxid: string;
+    vout: number;
+    sequence: number;
+    unlockingScript: ScriptDetail;
+    prevout?: InputUTXODetail;
+}
+export interface CompressionRange {
+    from: number;
+    to: number;
+}
+export interface TbcInputCompression {
+    type: 'tbcInputs';
+    count: number;
+    indexRange: CompressionRange;
+    prevTxid: string;
+    voutRange: CompressionRange;
+    satoshisPerInput: number;
+    totalSatoshis: number;
+}
+export type PublicDecodedInput = Omit<DecodedInput, 'unlockingScript' | 'prevout'> & {
+    prevout?: PublicInputUTXODetail;
+    compression?: TbcInputCompression;
+};
+export type ScriptKind = 'p2pkh' | 'multisig' | 'op_return' | 'contract' | 'unrecognized';
+export interface NftMintSlotsCompression {
+    type: 'nftMintSlots';
+    count: number;
+    indexRange: CompressionRange;
+    satoshisPerOutput: number;
+}
+export interface TbcOutputCompression {
+    type: 'tbcOutputs';
+    count: number;
+    indexRange: CompressionRange;
+    satoshisPerOutput: number;
+    totalSatoshis: number;
+}
+export type OutputCompression = NftMintSlotsCompression | TbcOutputCompression;
+export interface DecodedOutput {
+    index: number;
+    satoshis: number;
+    script: ScriptDetail;
+    address?: string;
+    scriptKind: ScriptKind;
+    compression?: OutputCompression;
+}
+export type PublicDecodedOutput = Omit<DecodedOutput, 'scriptKind' | 'script'> & {
+    script: PublicScriptDetail;
+};
+//# sourceMappingURL=script.d.ts.map

package/dist/types/script.d.ts.map

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

package/dist/types/script.js

@@ -0,0 +1,9 @@
+export const ScriptType = {
+    P2PKH: 'P2PKH',
+    P2PK: 'P2PK',
+    P2SH: 'P2SH',
+    MULTISIG: 'MULTISIG',
+    OP_RETURN: 'OP_RETURN',
+    UNKNOWN: 'UNKNOWN',
+};
+//# sourceMappingURL=script.js.map

package/dist/types/script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.js","sourceRoot":"","sources":["../../src/types/script.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;CACV,CAAC"}

package/dist/types/semantic.d.ts

@@ -0,0 +1,94 @@
+export type SemanticConfidence = 'exact' | 'heuristic' | 'partial';
+export type SemanticPartyRole = 'creator' | 'sender' | 'receiver' | 'buyer' | 'seller' | 'miner' | 'feeCollector' | 'self' | 'orderHolder' | 'pool' | 'burn' | 'unknown';
+export interface SemanticParty {
+    role: SemanticPartyRole;
+    address?: string;
+    hash?: string;
+    inputIndex?: number;
+    outputIndex?: number;
+    label?: string;
+}
+export interface PoolNftAssetMetadata {
+    version: 1 | 2;
+    serviceFeeRate?: number;
+    lpPlan?: number;
+    withLock?: boolean;
+    withLockTime?: boolean;
+}
+export type SemanticAsset = {
+    type: 'native';
+    symbol: 'TBC';
+} | {
+    type: 'ft' | 'stablecoin';
+    symbol: string;
+    name?: string;
+    contractId?: string;
+    decimal?: number;
+} | {
+    type: 'nft';
+    subtype?: never;
+    symbol?: string;
+    name?: string;
+    collectionId?: string;
+    contractId?: string;
+    poolNft?: never;
+} | {
+    type: 'nft';
+    subtype: 'poolNft';
+    contractId: string;
+    poolNft: PoolNftAssetMetadata;
+    symbol?: never;
+    name?: never;
+    collectionId?: never;
+} | {
+    type: 'nftCollection';
+    symbol?: never;
+    name?: string;
+    collectionId: string;
+    contractId: string;
+};
+export interface SemanticAmount {
+    satoshis?: number;
+    rawAmount?: string;
+    displayAmount?: string;
+    decimal?: number;
+}
+export type SemanticEffectKind = 'transfer' | 'self' | 'fee' | 'mint' | 'burn' | 'state' | 'orderLock' | 'orderRelease';
+export interface SemanticEffect {
+    kind: SemanticEffectKind;
+    asset: SemanticAsset;
+    amount: SemanticAmount;
+    from?: SemanticParty;
+    to?: SemanticParty;
+    inputIndex?: number;
+    outputIndex?: number;
+    tapeOutputIndex?: number;
+    movementIndex?: number;
+    source: 'decoded' | 'derived';
+}
+export type SemanticRelationKind = 'nativeCoinbase' | 'nativeTransfer' | 'ftTransfer' | 'stablecoinTransfer' | 'nftCollectionMint' | 'nftMint' | 'nftTransfer' | 'nftBurn' | 'orderBookOrder' | 'orderBookCancel' | 'orderBookMatch' | 'orderBookUpdate' | 'poolNftAction';
+export interface SemanticRelation {
+    kind: SemanticRelationKind;
+    confidence: SemanticConfidence;
+    inputIndexes?: number[];
+    outputIndexes?: number[];
+    movementIndexes?: number[];
+    orderIndexes?: number[];
+    buyOrderIndex?: number;
+    sellOrderIndex?: number;
+    remainingOrderIndexes?: number[];
+    oldOrderIndex?: number;
+    newOrderIndex?: number;
+    changedFields?: string[];
+    priceRaw?: string;
+    matchedSatoshis?: number;
+}
+export interface TransactionSemantic {
+    type: string;
+    confidence: SemanticConfidence;
+    actors: SemanticParty[];
+    effects: SemanticEffect[];
+    relations: SemanticRelation[];
+    notes?: string[];
+}
+//# sourceMappingURL=semantic.d.ts.map

package/dist/types/semantic.d.ts.map

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

package/dist/types/semantic.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=semantic.js.map

package/dist/types/semantic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.js","sourceRoot":"","sources":["../../src/types/semantic.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,6 @@
+export { SATOSHIS_PER_TBC, TBC_DECIMALS, TBC_SYMBOL } from './constants/chain.js';
+export * from './types/script.js';
+export type { AssetFlow, AssetFlowContext, AssetFlowDirection, AssetFlowEndpoint, AssetFlowPurpose, ChainLayer, DecodeTxRawOptions, DecodeTxRawResult, ProtocolDetails, ProtocolLayer, TransactionAmount, TransactionAsset, UnsupportedProtocol, } from './types/result.js';
+export type { FungibleTokenMovement, NftMovement, OrderBookData, OrderBookOrder, PiggyBankData, PiggyBankMovement, PoolNftMovement, PoolNftTapeData, } from './types/protocol.js';
+export type { SemanticAmount, SemanticAsset, SemanticConfidence, SemanticEffect, SemanticEffectKind, SemanticParty, SemanticPartyRole, SemanticRelation, SemanticRelationKind, TransactionSemantic, } from './types/semantic.js';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClF,cAAc,mBAAmB,CAAC;AAElC,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,qBAAqB,EACrB,WAAW,EACX,aAAa,EACb,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}

package/dist/types.js

@@ -0,0 +1,4 @@
+// Preserve the unified public ./types.js entry point while re-exporting split type modules.
+export { SATOSHIS_PER_TBC, TBC_DECIMALS, TBC_SYMBOL } from './constants/chain.js';
+export * from './types/script.js';
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClF,cAAc,mBAAmB,CAAC"}

package/dist/utils/asm-converter.d.ts

@@ -0,0 +1,7 @@
+export declare function convertNodeAsmToSdkAsm(nodeAsm: string): string;
+export declare function convertSdkAsmToNodeAsm(sdkAsm: string): string;
+export declare function convertHexToSdkAsm(hex: string): string;
+export declare function convertSdkAsmToHex(sdkAsm: string): string;
+export declare function convertHexToNodeAsm(hex: string): string;
+export declare function convertNodeAsmToHex(nodeAsm: string): string;
+//# sourceMappingURL=asm-converter.d.ts.map

package/dist/utils/asm-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asm-converter.d.ts","sourceRoot":"","sources":["../../src/utils/asm-converter.ts"],"names":[],"mappings":"AAGA,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoC9D;AAGD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAkC7D;AAGD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgBtD;AAGD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWzD;AAGD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG3D"}

package/dist/utils/asm-converter.js

@@ -0,0 +1,105 @@
+import { tbc } from '../adapters/tbc-lib.js';
+// Convert numeric opcodes from node ASM into the OP_N form accepted by the TBC SDK.
+export function convertNodeAsmToSdkAsm(nodeAsm) {
+    if (!nodeAsm || typeof nodeAsm !== 'string') {
+        return nodeAsm;
+    }
+    return nodeAsm
+        .split(/\s+/)
+        .map((token) => {
+        if (!token.trim()) {
+            return token;
+        }
+        if (/^[0-9a-fA-F]+$/.test(token) && token.length > 6) {
+            return token;
+        }
+        if (/^\d+$/.test(token)) {
+            const num = parseInt(token, 10);
+            if (num >= 0 && num <= 16) {
+                return `OP_${num}`;
+            }
+            if (num > 16 && num <= 16777215) {
+                return num.toString(16);
+            }
+            if (num > 16777215) {
+                return num.toString(16);
+            }
+        }
+        if (/^[0-9a-fA-F]+$/.test(token) && token.length <= 6 && /[a-fA-F]/.test(token)) {
+            return token;
+        }
+        return token;
+    })
+        .join(' ');
+}
+// Convert SDK OP_N output back to the numeric opcode form commonly returned by nodes.
+export function convertSdkAsmToNodeAsm(sdkAsm) {
+    if (!sdkAsm || typeof sdkAsm !== 'string') {
+        return sdkAsm;
+    }
+    return sdkAsm
+        .split(/\s+/)
+        .map((token) => {
+        if (!token.trim()) {
+            return token;
+        }
+        const opMatch = token.match(/^OP_(\d+)$/);
+        if (opMatch && opMatch[1]) {
+            const num = parseInt(opMatch[1], 10);
+            if (num >= 0 && num <= 16) {
+                return num.toString();
+            }
+        }
+        if (/^[0-9a-fA-F]+$/.test(token)) {
+            if (token.length > 6) {
+                return token;
+            }
+            const num = parseInt(token, 16);
+            if (num > 16 && num <= 16777215) {
+                return num.toString();
+            }
+        }
+        return token;
+    })
+        .join(' ');
+}
+// Use tbc.Script for all hex/SDK-ASM conversion instead of maintaining custom opcode codecs.
+export function convertHexToSdkAsm(hex) {
+    if (!hex || typeof hex !== 'string') {
+        throw new Error('Invalid HEX input');
+    }
+    try {
+        const sanitizedHex = hex.replace(/\s+/g, '').toLowerCase();
+        if (!/^[0-9a-f]+$/.test(sanitizedHex)) {
+            throw new Error('Invalid HEX format');
+        }
+        const script = tbc.Script.fromString(sanitizedHex);
+        return script.toASM();
+    }
+    catch (error) {
+        throw new Error(`Failed to convert HEX to SDK ASM: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+// Convert SDK ASM back to hex for script editing, debugging, and fixture reproduction.
+export function convertSdkAsmToHex(sdkAsm) {
+    if (!sdkAsm || typeof sdkAsm !== 'string') {
+        throw new Error('Invalid SDK ASM input');
+    }
+    try {
+        const script = tbc.Script.fromASM(sdkAsm.trim());
+        return script.toHex();
+    }
+    catch (error) {
+        throw new Error(`Failed to convert SDK ASM to HEX: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+// Provide a convenient public conversion entry point using node-style ASM.
+export function convertHexToNodeAsm(hex) {
+    const sdkAsm = convertHexToSdkAsm(hex);
+    return convertSdkAsmToNodeAsm(sdkAsm);
+}
+export function convertNodeAsmToHex(nodeAsm) {
+    const sdkAsm = convertNodeAsmToSdkAsm(nodeAsm);
+    return convertSdkAsmToHex(sdkAsm);
+}
+//# sourceMappingURL=asm-converter.js.map

package/dist/utils/asm-converter.js.map

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

package/dist/utils/binary.d.ts

@@ -0,0 +1,3 @@
+export declare function readUInt64LEBigInt(buffer: Buffer): bigint;
+export declare function readUInt64LEBigIntAt(buffer: Buffer, offset: number): bigint | undefined;
+//# sourceMappingURL=binary.d.ts.map

package/dist/utils/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../src/utils/binary.ts"],"names":[],"mappings":"AACA,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMzD;AAGD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMvF"}

package/dist/utils/binary.js

@@ -0,0 +1,17 @@
+// Binary readers for protocol amount and fee-rate fields, which are commonly little-endian uint64 values.
+export function readUInt64LEBigInt(buffer) {
+    let result = BigInt(0);
+    for (let i = 0; i < buffer.length; i++) {
+        result += BigInt(buffer[i] ?? 0) << BigInt(8 * i);
+    }
+    return result;
+}
+// Read a complete eight-byte uint64 at an offset, returning undefined for truncated data.
+export function readUInt64LEBigIntAt(buffer, offset) {
+    const slice = buffer.subarray(offset, offset + 8);
+    if (slice.length !== 8) {
+        return undefined;
+    }
+    return readUInt64LEBigInt(slice);
+}
+//# sourceMappingURL=binary.js.map

package/dist/utils/binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.js","sourceRoot":"","sources":["../../src/utils/binary.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAC1G,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,IAAI,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,MAAc;IACjE,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;IAClD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC"}

package/dist/utils/multi-sig.d.ts

@@ -0,0 +1,9 @@
+export declare function getMultiSigAddress(pubKeys: string[], signatureCount: number, publicKeyCount: number): string;
+export declare function getSignatureAndPublicKeyCount(address: string): {
+    signatureCount: number;
+    publicKeyCount: number;
+};
+export declare function getMultiSigLockScript(address: string): string;
+export declare function getCombineHash(address: string): string;
+export declare function parseMultiSigAddressFromASM(asm: string): string | null;
+//# sourceMappingURL=multi-sig.d.ts.map

package/dist/utils/multi-sig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-sig.d.ts","sourceRoot":"","sources":["../../src/utils/multi-sig.ts"],"names":[],"mappings":"AAUA,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,MAAM,EAAE,EACjB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,GACpB,MAAM,CAiBR;AAGD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG;IAC/D,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACvB,CAYA;AAGD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoC7D;AAGD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQtD;AAGD,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8CtE"}

package/dist/utils/multi-sig.js

@@ -0,0 +1,125 @@
+import { tbc } from '../adapters/tbc-lib.js';
+// TBC MultiSig addresses encode a hash of concatenated public keys with an m/n prefix; they are not standard P2SH.
+function getHash(pubKeys) {
+    const pubKeyBuffers = pubKeys.map(pubKey => Buffer.from(pubKey, 'hex'));
+    const combined = Buffer.concat(pubKeyBuffers);
+    return tbc.crypto.Hash.sha256ripemd160(combined);
+}
+// Build a TBC MultiSig address whose first byte encodes both required signatures and public-key count.
+export function getMultiSigAddress(pubKeys, signatureCount, publicKeyCount) {
+    if (signatureCount < 1 || signatureCount > 6) {
+        throw new Error('Invalid signatureCount.');
+    }
+    else if (publicKeyCount < 3 || publicKeyCount > 10) {
+        throw new Error('Invalid publicKeyCount.');
+    }
+    else if (signatureCount > publicKeyCount) {
+        throw new Error('SignatureCount must be less than publicKeyCount.');
+    }
+    const hash = getHash(pubKeys);
+    const prefix = (signatureCount << 4) | (publicKeyCount & 0x0f);
+    const versionBuffer = Buffer.from([prefix]);
+    const addressBuffer = Buffer.concat([versionBuffer, hash]);
+    const addressHash = tbc.crypto.Hash.sha256sha256(addressBuffer);
+    const checksum = addressHash.subarray(0, 4);
+    const addressWithChecksum = Buffer.concat([addressBuffer, checksum]);
+    return tbc.encoding.Base58.encode(addressWithChecksum);
+}
+// Decode m/n parameters from the first address byte for locking-script reconstruction and display.
+export function getSignatureAndPublicKeyCount(address) {
+    const buf = Buffer.from(tbc.encoding.Base58.decode(address));
+    if (buf.length === 0) {
+        throw new Error('Invalid address: empty buffer');
+    }
+    const prefix = buf[0];
+    if (prefix === undefined) {
+        throw new Error('Invalid address: prefix is undefined');
+    }
+    const signatureCount = (prefix >> 4) & 0x0f;
+    const publicKeyCount = prefix & 0x0f;
+    return { signatureCount, publicKeyCount };
+}
+// Rebuild locking-script ASM under TBC MultiSig conventions for combine-hash calculation and debugging.
+export function getMultiSigLockScript(address) {
+    const buf = Buffer.from(tbc.encoding.Base58.decode(address));
+    if (buf.length < 21) {
+        throw new Error('Invalid address: buffer too short');
+    }
+    const { signatureCount, publicKeyCount } = getSignatureAndPublicKeyCount(address);
+    if (signatureCount < 1 || signatureCount > 6) {
+        throw new Error('Invalid signatureCount.');
+    }
+    else if (publicKeyCount < 3 || publicKeyCount > 10) {
+        throw new Error('Invalid publicKeyCount.');
+    }
+    else if (signatureCount > publicKeyCount) {
+        throw new Error('SignatureCount must be less than publicKeyCount.');
+    }
+    const hash = Buffer.from(buf.subarray(1, 21)).toString('hex');
+    let lockScriptPrefix = '';
+    for (let i = 0; i < publicKeyCount - 1; i++) {
+        lockScriptPrefix = lockScriptPrefix + '21 OP_SPLIT ';
+    }
+    for (let i = 0; i < publicKeyCount; i++) {
+        lockScriptPrefix = lockScriptPrefix + `OP_${publicKeyCount - 1} OP_PICK `;
+    }
+    for (let i = 0; i < publicKeyCount - 1; i++) {
+        lockScriptPrefix = lockScriptPrefix + 'OP_CAT ';
+    }
+    const script_asm = `OP_${signatureCount} OP_SWAP ` +
+        lockScriptPrefix +
+        `OP_HASH160 ${hash} OP_EQUALVERIFY OP_${publicKeyCount} OP_CHECKMULTISIG`;
+    return script_asm;
+}
+// A MultiSig combine hash is the locking-script hash with a trailing 01 protocol marker.
+export function getCombineHash(address) {
+    const combine_hash = tbc.crypto.Hash.sha256ripemd160(tbc.crypto.Hash.sha256(tbc.Script.fromASM(getMultiSigLockScript(address)).toBuffer())).toString('hex') + '01';
+    return combine_hash;
+}
+// Extract MultiSig m/n and hash160 from script ASM and recover the project's MultiSig address form.
+export function parseMultiSigAddressFromASM(asm) {
+    try {
+        const parts = asm.split(/\s+/).filter(p => p.length > 0);
+        if (!parts.includes('OP_CHECKMULTISIG')) {
+            return null;
+        }
+        const hash160Index = parts.indexOf('OP_HASH160');
+        if (hash160Index !== -1 && hash160Index + 1 < parts.length) {
+            const hash = parts[hash160Index + 1];
+            if (hash && typeof hash === 'string' && /^[0-9a-fA-F]{40}$/.test(hash)) {
+                const equalVerifyIndex = parts.indexOf('OP_EQUALVERIFY');
+                if (equalVerifyIndex !== -1 && equalVerifyIndex + 1 < parts.length) {
+                    const opN = parts[equalVerifyIndex + 1];
+                    if (opN) {
+                        const nMatch = opN.match(/^OP_(\d+)$/);
+                        if (nMatch && nMatch[1]) {
+                            const publicKeyCount = parseInt(nMatch[1], 10);
+                            const opM = parts[0];
+                            if (opM) {
+                                const mMatch = opM.match(/^OP_(\d+)$/);
+                                if (mMatch && mMatch[1]) {
+                                    const signatureCount = parseInt(mMatch[1], 10);
+                                    if (typeof hash === 'string') {
+                                        const prefix = (signatureCount << 4) | (publicKeyCount & 0x0f);
+                                        const versionBuffer = Buffer.from([prefix]);
+                                        const hashBuffer = Buffer.from(hash, 'hex');
+                                        const addressBuffer = Buffer.concat([versionBuffer, hashBuffer]);
+                                        const addressHash = tbc.crypto.Hash.sha256sha256(addressBuffer);
+                                        const checksum = addressHash.subarray(0, 4);
+                                        const addressWithChecksum = Buffer.concat([addressBuffer, checksum]);
+                                        return tbc.encoding.Base58.encode(addressWithChecksum);
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=multi-sig.js.map

package/dist/utils/multi-sig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-sig.js","sourceRoot":"","sources":["../../src/utils/multi-sig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAE7C,mHAAmH;AACnH,SAAS,OAAO,CAAC,OAAiB;IACjC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC9C,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,kBAAkB,CACjC,OAAiB,EACjB,cAAsB,EACtB,cAAsB;IAEtB,IAAI,cAAc,GAAG,CAAC,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;SAAM,IAAI,cAAc,GAAG,CAAC,IAAI,cAAc,GAAG,EAAE,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;SAAM,IAAI,cAAc,GAAG,cAAc,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,CAAC,cAAc,IAAI,CAAC,CAAC,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC/D,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC;IAC3D,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrE,OAAO,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;AACxD,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,6BAA6B,CAAC,OAAe;IAI5D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7D,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,cAAc,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAC5C,MAAM,cAAc,GAAG,MAAM,GAAG,IAAI,CAAC;IACrC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AAC3C,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACpD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7D,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAElF,IAAI,cAAc,GAAG,CAAC,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;SAAM,IAAI,cAAc,GAAG,CAAC,IAAI,cAAc,GAAG,EAAE,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;SAAM,IAAI,cAAc,GAAG,cAAc,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9D,IAAI,gBAAgB,GAAG,EAAE,CAAC;IAE1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,gBAAgB,GAAG,gBAAgB,GAAG,cAAc,CAAC;IACtD,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,gBAAgB,GAAG,gBAAgB,GAAG,MAAM,cAAc,GAAG,CAAC,WAAW,CAAC;IAC3E,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,gBAAgB,GAAG,gBAAgB,GAAG,SAAS,CAAC;IACjD,CAAC;IAED,MAAM,UAAU,GACf,MAAM,cAAc,WAAW;QAC/B,gBAAgB;QAChB,cAAc,IAAI,sBAAsB,cAAc,mBAAmB,CAAC;IAE3E,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,cAAc,CAAC,OAAe;IAC7C,MAAM,YAAY,GACjB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAC9B,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CACrB,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAC7D,CACD,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAC1B,OAAO,YAAY,CAAC;AACrB,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,2BAA2B,CAAC,GAAW;IACtD,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEzD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC;QACb,CAAC;QAED,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACjD,IAAI,YAAY,KAAK,CAAC,CAAC,IAAI,YAAY,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;YACrC,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxE,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;gBACzD,IAAI,gBAAgB,KAAK,CAAC,CAAC,IAAI,gBAAgB,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;oBACpE,MAAM,GAAG,GAAG,KAAK,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC;oBACxC,IAAI,GAAG,EAAE,CAAC;wBACT,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;wBACvC,IAAI,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;4BACzB,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BAC/C,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;4BACrB,IAAI,GAAG,EAAE,CAAC;gCACT,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;gCACvC,IAAI,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;oCACzB,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oCAC/C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;wCAC9B,MAAM,MAAM,GAAG,CAAC,cAAc,IAAI,CAAC,CAAC,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;wCAC/D,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;wCAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;wCAC5C,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;wCACjE,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;wCAChE,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;wCAC5C,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;wCACrE,OAAO,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;oCACxD,CAAC;gCACF,CAAC;4BACF,CAAC;wBACF,CAAC;oBACF,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC"}

package/dist/utils/token-amount.d.ts

@@ -0,0 +1,3 @@
+export declare function formatTokenRawAmount(rawAmount: bigint | string, decimal: number): string;
+export declare function toTokenAmountNumber(rawAmount: bigint | string, decimal: number): number;
+//# sourceMappingURL=token-amount.d.ts.map