@btc-vision/transaction 1.8.0-beta.9 → 1.8.0-rc.1

package/browser/abi/ABICoder.d.ts

@@ -1,41 +1,20 @@
-export declare enum ABIDataTypes {
-    UINT8 = "UINT8",
-    UINT16 = "UINT16",
-    UINT32 = "UINT32",
-    UINT64 = "UINT64",
-    UINT128 = "UINT128",
-    UINT256 = "UINT256",
-    INT8 = "INT8",
-    INT16 = "INT16",
-    INT32 = "INT32",
-    INT64 = "INT64",
-    INT128 = "INT128",
-    BOOL = "BOOL",
-    ADDRESS = "ADDRESS",
-    EXTENDED_ADDRESS = "EXTENDED_ADDRESS",
-    STRING = "STRING",
-    BYTES4 = "BYTES4",
-    BYTES32 = "BYTES32",
-    BYTES = "BYTES",
-    ADDRESS_UINT256_TUPLE = "ADDRESS_UINT256_TUPLE",
-    EXTENDED_ADDRESS_UINT256_TUPLE = "EXTENDED_ADDRESS_UINT256_TUPLE",
-    SCHNORR_SIGNATURE = "SCHNORR_SIGNATURE",
-    ARRAY_OF_ADDRESSES = "ARRAY_OF_ADDRESSES",
-    ARRAY_OF_EXTENDED_ADDRESSES = "ARRAY_OF_EXTENDED_ADDRESSES",
-    ARRAY_OF_UINT256 = "ARRAY_OF_UINT256",
-    ARRAY_OF_UINT128 = "ARRAY_OF_UINT128",
-    ARRAY_OF_UINT64 = "ARRAY_OF_UINT64",
-    ARRAY_OF_UINT32 = "ARRAY_OF_UINT32",
-    ARRAY_OF_UINT16 = "ARRAY_OF_UINT16",
-    ARRAY_OF_UINT8 = "ARRAY_OF_UINT8",
-    ARRAY_OF_STRING = "ARRAY_OF_STRING",
-    ARRAY_OF_BYTES = "ARRAY_OF_BYTES",
-    ARRAY_OF_BUFFERS = "ARRAY_OF_BUFFERS"
-}
+import { BinaryReader } from '../buffer/BinaryReader.js';
+import { AbiType } from './AbiTypes.js';
 export declare class ABICoder {
-    decodeData(data: Uint8Array, types: ABIDataTypes[]): unknown[];
+    decodeData(data: Uint8Array, types: AbiType[]): unknown[];
     encodeSelector(selectorIdentifier: string): string;
     numericSelectorToHex(selector: number): string;
+    /**
+     * Decodes a single value from the reader based on the ABI type.
+     * Supports ABIDataTypes enum values, tuple arrays, and struct objects.
+     */
+    decodeSingleValue(reader: BinaryReader, type: AbiType): unknown;
+    /** Decodes a single-element tuple as a flat typed array (u16 count + values). */
+    private decodeArray;
+    /** Decodes a multi-element tuple as array of tuple entries (u16 count + entries). */
+    private decodeTuple;
+    /** Decodes a struct as a single object with named fields (inline, no count prefix). */
+    private decodeStruct;
     private sha256;
 }
 //# sourceMappingURL=ABICoder.d.ts.map

package/browser/abi/ABICoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ABICoder.d.ts","sourceRoot":"","sources":["../../src/abi/ABICoder.ts"],"names":[],"mappings":"AAGA,oBAAY,YAAY;IAEpB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,OAAO,YAAY;IAGnB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;IACf,KAAK,UAAU;IACf,MAAM,WAAW;IAGjB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,gBAAgB,qBAAqB;IACrC,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,KAAK,UAAU;IAGf,qBAAqB,0BAA0B;IAC/C,8BAA8B,mCAAmC;IAGjE,iBAAiB,sBAAsB;IAGvC,kBAAkB,uBAAuB;IACzC,2BAA2B,gCAAgC;IAC3D,gBAAgB,qBAAqB;IACrC,gBAAgB,qBAAqB;IACrC,eAAe,oBAAoB;IACnC,eAAe,oBAAoB;IACnC,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;CACxC;AAED,qBAAa,QAAQ;IACV,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE;IA6G9D,cAAc,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM;IAQlD,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIrD,OAAO,CAAC,MAAM;CAGjB"}
+{"version":3,"file":"ABICoder.d.ts","sourceRoot":"","sources":["../../src/abi/ABICoder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,qBAAa,QAAQ;IACV,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE;IAWzD,cAAc,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM;IAQlD,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIrD;;;OAGG;IACI,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO;IAoFtE,iFAAiF;IACjF,OAAO,CAAC,WAAW;IAWnB,qFAAqF;IACrF,OAAO,CAAC,WAAW;IAenB,uFAAuF;IACvF,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,MAAM;CAGjB"}

package/browser/abi/ABIDataTypes.d.ts

@@ -0,0 +1,35 @@
+export declare enum ABIDataTypes {
+    UINT8 = "UINT8",
+    UINT16 = "UINT16",
+    UINT32 = "UINT32",
+    UINT64 = "UINT64",
+    UINT128 = "UINT128",
+    UINT256 = "UINT256",
+    INT8 = "INT8",
+    INT16 = "INT16",
+    INT32 = "INT32",
+    INT64 = "INT64",
+    INT128 = "INT128",
+    BOOL = "BOOL",
+    ADDRESS = "ADDRESS",
+    EXTENDED_ADDRESS = "EXTENDED_ADDRESS",
+    STRING = "STRING",
+    BYTES4 = "BYTES4",
+    BYTES32 = "BYTES32",
+    BYTES = "BYTES",
+    ADDRESS_UINT256_TUPLE = "ADDRESS_UINT256_TUPLE",
+    EXTENDED_ADDRESS_UINT256_TUPLE = "EXTENDED_ADDRESS_UINT256_TUPLE",
+    SCHNORR_SIGNATURE = "SCHNORR_SIGNATURE",
+    ARRAY_OF_ADDRESSES = "ARRAY_OF_ADDRESSES",
+    ARRAY_OF_EXTENDED_ADDRESSES = "ARRAY_OF_EXTENDED_ADDRESSES",
+    ARRAY_OF_UINT256 = "ARRAY_OF_UINT256",
+    ARRAY_OF_UINT128 = "ARRAY_OF_UINT128",
+    ARRAY_OF_UINT64 = "ARRAY_OF_UINT64",
+    ARRAY_OF_UINT32 = "ARRAY_OF_UINT32",
+    ARRAY_OF_UINT16 = "ARRAY_OF_UINT16",
+    ARRAY_OF_UINT8 = "ARRAY_OF_UINT8",
+    ARRAY_OF_STRING = "ARRAY_OF_STRING",
+    ARRAY_OF_BYTES = "ARRAY_OF_BYTES",
+    ARRAY_OF_BUFFERS = "ARRAY_OF_BUFFERS"
+}
+//# sourceMappingURL=ABIDataTypes.d.ts.map

package/browser/abi/ABIDataTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ABIDataTypes.d.ts","sourceRoot":"","sources":["../../src/abi/ABIDataTypes.ts"],"names":[],"mappings":"AAAA,oBAAY,YAAY;IAEpB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,OAAO,YAAY;IAGnB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;IACf,KAAK,UAAU;IACf,MAAM,WAAW;IAGjB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,gBAAgB,qBAAqB;IACrC,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,KAAK,UAAU;IAGf,qBAAqB,0BAA0B;IAC/C,8BAA8B,mCAAmC;IAGjE,iBAAiB,sBAAsB;IAGvC,kBAAkB,uBAAuB;IACzC,2BAA2B,gCAAgC;IAC3D,gBAAgB,qBAAqB;IACrC,gBAAgB,qBAAqB;IACrC,eAAe,oBAAoB;IACnC,eAAe,oBAAoB;IACnC,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;CACxC"}

package/browser/abi/AbiTypes.d.ts

@@ -0,0 +1,46 @@
+import { Address } from '../keypair/Address.js';
+import { AddressMap } from '../deterministic/AddressMap.js';
+import { ExtendedAddressMap } from '../deterministic/ExtendedAddressMap.js';
+import { SchnorrSignature } from '../buffer/BinaryReader.js';
+import { ABIDataTypes } from './ABIDataTypes.js';
+/**
+ * Recursive ABI type definition:
+ * - Simple: ABIDataTypes enum value (e.g. ABIDataTypes.ADDRESS)
+ * - Tuple: ordered array of AbiType (e.g. [ABIDataTypes.ADDRESS, ABIDataTypes.UINT8])
+ * - Struct: named fields mapping to AbiType (e.g. { field1: ABIDataTypes.ADDRESS, field2: ABIDataTypes.UINT256 })
+ * - Nested: any combination (e.g. [ABIDataTypes.ADDRESS, { inner: ABIDataTypes.UINT8 }])
+ */
+export type AbiType = ABIDataTypes | AbiType[] | {
+    [field: string]: AbiType;
+};
+/**
+ * Maps an AbiType to its corresponding TypeScript type at the type level.
+ *
+ * Usage with `as const`:
+ * ```ts
+ * const abi = { name: 'balance', type: ABIDataTypes.UINT256 } as const;
+ * type Result = InferAbiType<typeof abi.type>; // bigint
+ *
+ * const structAbi = { name: 'status', type: { minted: ABIDataTypes.UINT256, active: ABIDataTypes.BOOL } } as const;
+ * type StatusResult = InferAbiType<typeof structAbi.type>; // { minted: bigint; active: boolean }
+ * ```
+ */
+export type InferAbiType<T extends AbiType> = T extends ABIDataTypes.UINT8 | ABIDataTypes.UINT16 | ABIDataTypes.UINT32 | ABIDataTypes.INT8 | ABIDataTypes.INT16 | ABIDataTypes.INT32 ? number : T extends ABIDataTypes.UINT64 | ABIDataTypes.UINT128 | ABIDataTypes.UINT256 | ABIDataTypes.INT64 | ABIDataTypes.INT128 ? bigint : T extends ABIDataTypes.BOOL ? boolean : T extends ABIDataTypes.STRING ? string : T extends ABIDataTypes.ADDRESS | ABIDataTypes.EXTENDED_ADDRESS ? Address : T extends ABIDataTypes.BYTES | ABIDataTypes.BYTES4 | ABIDataTypes.BYTES32 ? Uint8Array : T extends ABIDataTypes.SCHNORR_SIGNATURE ? SchnorrSignature : T extends ABIDataTypes.ADDRESS_UINT256_TUPLE ? AddressMap<bigint> : T extends ABIDataTypes.EXTENDED_ADDRESS_UINT256_TUPLE ? ExtendedAddressMap<bigint> : T extends ABIDataTypes.ARRAY_OF_ADDRESSES | ABIDataTypes.ARRAY_OF_EXTENDED_ADDRESSES ? Address[] : T extends ABIDataTypes.ARRAY_OF_UINT256 | ABIDataTypes.ARRAY_OF_UINT128 | ABIDataTypes.ARRAY_OF_UINT64 ? bigint[] : T extends ABIDataTypes.ARRAY_OF_UINT32 | ABIDataTypes.ARRAY_OF_UINT16 | ABIDataTypes.ARRAY_OF_UINT8 ? number[] : T extends ABIDataTypes.ARRAY_OF_STRING ? string[] : T extends ABIDataTypes.ARRAY_OF_BYTES | ABIDataTypes.ARRAY_OF_BUFFERS ? Uint8Array[] : T extends Record<string, AbiType> ? {
+    [K in keyof T]: T[K] extends AbiType ? InferAbiType<T[K]> : never;
+} : T extends readonly [infer Single extends AbiType] ? InferAbiType<Single>[] : T extends readonly [AbiType, AbiType, ...AbiType[]] ? {
+    [K in keyof T]: T[K] extends AbiType ? InferAbiType<T[K]> : T[K];
+}[] : T extends readonly AbiType[] ? unknown[] : never;
+/**
+ * Canonical string → ABIDataTypes mapping.
+ * Only includes canonical ABI-style names (not AssemblyScript aliases).
+ */
+export declare const StrToAbiType: {
+    [key: string]: ABIDataTypes;
+};
+/**
+ * Canonical reverse mapping: ABIDataTypes → canonical string.
+ */
+export declare const AbiTypeToStr: {
+    [key in ABIDataTypes]: string;
+};
+//# sourceMappingURL=AbiTypes.d.ts.map

package/browser/abi/AbiTypes.d.ts.map

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

package/browser/abi/TupleUtils.d.ts

@@ -0,0 +1,25 @@
+import { ABIDataTypes } from './ABIDataTypes.js';
+import { AbiType } from './AbiTypes.js';
+/**
+ * Type guard: returns true if the ABI type is a tuple (ordered array of types).
+ */
+export declare function isAbiTuple(type: AbiType): type is AbiType[];
+/**
+ * Type guard: returns true if the ABI type is a struct (named fields).
+ */
+export declare function isAbiStruct(type: AbiType): type is {
+    [field: string]: AbiType;
+};
+/**
+ * Type guard: returns true if the ABI type is a simple ABIDataTypes enum value.
+ */
+export declare function isSimpleAbiType(type: AbiType): type is ABIDataTypes;
+/**
+ * Converts a structured AbiType into a canonical selector string.
+ * - Simple: ABIDataTypes.ADDRESS → "address"
+ * - Struct: { a: ADDRESS, b: UINT256 } → "tuple(address,uint256)" (inline, no [])
+ * - Single-element tuple: [UINT256] → "uint256[]"
+ * - Multi-element tuple: [ADDRESS, UINT256] → "tuple(address,uint256)[]"
+ */
+export declare function abiTypeToSelectorString(type: AbiType): string;
+//# sourceMappingURL=TupleUtils.d.ts.map

package/browser/abi/TupleUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TupleUtils.d.ts","sourceRoot":"","sources":["../../src/abi/TupleUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,OAAO,EAAE,CAE3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI;IAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAE/E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,YAAY,CAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CA0B7D"}