@subsquid/evm-codec 0.2.1 → 1.0.0

package/lib/sink/hex.d.ts

@@ -0,0 +1,33 @@
+import { type Sink } from '../codec';
+export declare class HexSink implements Sink {
+    #private;
+    private pos;
+    private buf;
+    private stack;
+    constructor(fields: number, capacity?: number);
+    result(): string;
+    toString(): string;
+    reserve(additional: number): void;
+    size(): number;
+    u8(val: number): void;
+    i8(val: number): void;
+    u16(val: number): void;
+    i16(val: number): void;
+    u32(val: number): void;
+    i32(val: number): void;
+    u64(val: bigint): void;
+    i64(val: bigint): void;
+    u128(val: bigint): void;
+    i128(val: bigint): void;
+    u256(val: bigint): void;
+    i256(val: bigint): void;
+    bytes(val: Uint8Array | string): void;
+    staticBytes(len: number, val: Uint8Array | string): void;
+    address(val: string): void;
+    string(val: string): void;
+    bool(val: boolean): void;
+    openTail(slotsCount?: number): void;
+    openArray(count: number): void;
+    closeTail(): void;
+}
+//# sourceMappingURL=hex.d.ts.map

package/lib/sink/hex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../src/sink/hex.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,IAAI,EAAC,MAAM,UAAU,CAAA;AA2B7C,qBAAa,OAAQ,YAAW,IAAI;;IAChC,OAAO,CAAC,GAAG,CAAI;IACf,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,KAAK,CAA+E;gBAEhF,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAqC;IAUzE,MAAM,IAAI,MAAM;IAMhB,QAAQ,IAAI,MAAM;IAIlB,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOjC,IAAI;IA4CJ,EAAE,CAAC,GAAG,EAAE,MAAM;IAMd,EAAE,CAAC,GAAG,EAAE,MAAM;IAKd,GAAG,CAAC,GAAG,EAAE,MAAM;IAMf,GAAG,CAAC,GAAG,EAAE,MAAM;IAKf,GAAG,CAAC,GAAG,EAAE,MAAM;IAUf,GAAG,CAAC,GAAG,EAAE,MAAM;IAKf,GAAG,CAAC,GAAG,EAAE,MAAM;IAMf,GAAG,CAAC,GAAG,EAAE,MAAM;IAKf,IAAI,CAAC,GAAG,EAAE,MAAM;IAMhB,IAAI,CAAC,GAAG,EAAE,MAAM;IAKhB,IAAI,CAAC,GAAG,EAAE,MAAM;IAMhB,IAAI,CAAC,GAAG,EAAE,MAAM;IAWhB,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM;IAqC9B,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,MAAM;IAwBjD,OAAO,CAAC,GAAG,EAAE,MAAM;IAWnB,MAAM,CAAC,GAAG,EAAE,MAAM;IAIlB,IAAI,CAAC,GAAG,EAAE,OAAO;IAQjB,QAAQ,CAAC,UAAU,SAAI;IASvB,SAAS,CAAC,KAAK,EAAE,MAAM;IA8BvB,SAAS;CAMZ"}

package/lib/sink/hex.js

@@ -0,0 +1,289 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HexSink = void 0;
+const node_assert_1 = __importDefault(require("node:assert"));
+const util_internal_hex_1 = require("@subsquid/util-internal-hex");
+const codec_1 = require("../codec");
+const bounds_1 = require("./bounds");
+const HEX_BYTE = 2;
+const WORD_HEX = codec_1.WORD_SIZE * HEX_BYTE;
+const CODE_0 = 48; // '0'
+const CODE_A_UPPER = 65; // 'A'
+const CODE_F_UPPER = 70; // 'F'
+// Precomputed ASCII codes for hex nibbles 0–15 ('0'–'9', 'a'–'f').
+const NIBBLE_CODE = new Uint8Array(16);
+for (let i = 0; i < 10; i++)
+    NIBBLE_CODE[i] = 48 + i;
+for (let i = 10; i < 16; i++)
+    NIBBLE_CODE[i] = 87 + i;
+// At or above this many input bytes the native Buffer.toString('hex') path
+// is cheaper than a per-byte JS loop.
+const BUFFER_HEX_CUTOFF = 64;
+class HexSink {
+    pos = 0;
+    buf;
+    stack = [];
+    constructor(fields, capacity = Math.max(fields * codec_1.WORD_SIZE, 1280)) {
+        this.buf = Buffer.alloc(capacity * HEX_BYTE, CODE_0);
+        this.stack.push({
+            start: 0,
+            jumpBackPtr: 0,
+            size: fields * codec_1.WORD_SIZE,
+            countWord: false,
+        });
+    }
+    result() {
+        (0, node_assert_1.default)(this.stack.length === 1, 'Cannot get result during dynamic encoding');
+        const chars = this.size() * HEX_BYTE;
+        return `0x${this.buf.toString('latin1', 0, chars)}`;
+    }
+    toString() {
+        return this.result();
+    }
+    reserve(additional) {
+        const needed = (this.pos + additional) * HEX_BYTE;
+        if (this.buf.length < needed) {
+            this.#allocate(needed);
+        }
+    }
+    size() {
+        return this.stack[this.stack.length - 1].size;
+    }
+    #allocate(cap) {
+        cap = Math.max(cap, this.buf.length * 2);
+        const grown = Buffer.alloc(cap, CODE_0);
+        grown.set(this.buf);
+        this.buf = grown;
+    }
+    // Right-align `hex` in a 32-byte ABI word at the current position.
+    // Left padding is implicit because buf is pre-filled with '0'.
+    #writeWordRight(hex) {
+        (0, node_assert_1.default)(hex.length <= WORD_HEX, `hex string too long for one word: ${hex.length} chars`);
+        const buf = this.buf;
+        const start = this.pos * HEX_BYTE + WORD_HEX - hex.length;
+        for (let i = 0; i < hex.length; i++) {
+            buf[start + i] = hex.charCodeAt(i);
+        }
+        this.pos += codec_1.WORD_SIZE;
+    }
+    // Copy `len` hex chars from `hex` starting at `srcStart` into buf at
+    // `dstStart`, lowercasing any A–F so output is canonical lowercase.
+    #copyHexLower(hex, srcStart, dstStart, len) {
+        const buf = this.buf;
+        for (let i = 0; i < len; i++) {
+            const c = hex.charCodeAt(srcStart + i);
+            buf[dstStart + i] = c >= CODE_A_UPPER && c <= CODE_F_UPPER ? c + 32 : c;
+        }
+    }
+    // Encode binary `src` bytes as hex ASCII codes directly into buf at
+    // `dstStart` using the NIBBLE_CODE lookup table.
+    #encodeBytes(src, srcLen, dstStart) {
+        const buf = this.buf;
+        for (let i = 0; i < srcLen; i++) {
+            const b = src[i];
+            buf[dstStart + i * 2] = NIBBLE_CODE[b >> 4];
+            buf[dstStart + i * 2 + 1] = NIBBLE_CODE[b & 0xf];
+        }
+    }
+    u8(val) {
+        if (val < 0 || val > bounds_1.U8_MAX)
+            this.#oob(val, 'uint8', 0, bounds_1.U8_MAX);
+        this.reserve(codec_1.WORD_SIZE);
+        this.#writeWordRight(val.toString(16));
+    }
+    i8(val) {
+        if (val < bounds_1.I8_MIN || val > bounds_1.I8_MAX)
+            this.#oob(val, 'int8', bounds_1.I8_MIN, bounds_1.I8_MAX);
+        this.#i256(BigInt(val));
+    }
+    u16(val) {
+        if (val < 0 || val > bounds_1.U16_MAX)
+            this.#oob(val, 'uint16', 0, bounds_1.U16_MAX);
+        this.reserve(codec_1.WORD_SIZE);
+        this.#writeWordRight(val.toString(16));
+    }
+    i16(val) {
+        if (val < bounds_1.I16_MIN || val > bounds_1.I16_MAX)
+            this.#oob(val, 'int16', bounds_1.I16_MIN, bounds_1.I16_MAX);
+        this.#i256(BigInt(val));
+    }
+    u32(val) {
+        if (val < 0 || val > bounds_1.U32_MAX)
+            this.#oob(val, 'uint32', 0, bounds_1.U32_MAX);
+        this.reserve(codec_1.WORD_SIZE);
+        this.#writeWordRight(val.toString(16));
+    }
+    #u32Raw(val) {
+        this.#writeWordRight(val.toString(16));
+    }
+    i32(val) {
+        if (val < bounds_1.I32_MIN || val > bounds_1.I32_MAX)
+            this.#oob(val, 'int32', bounds_1.I32_MIN, bounds_1.I32_MAX);
+        this.#i256(BigInt(val));
+    }
+    u64(val) {
+        if (val < 0n || val > bounds_1.U64_MAX_BI)
+            this.#oob(val, 'uint64', 0n, bounds_1.U64_MAX_BI);
+        this.reserve(codec_1.WORD_SIZE);
+        this.#writeWordRight(val.toString(16));
+    }
+    i64(val) {
+        if (val < bounds_1.I64_MIN_BI || val > bounds_1.I64_MAX_BI)
+            this.#oob(val, 'int64', bounds_1.I64_MIN_BI, bounds_1.I64_MAX_BI);
+        this.#i256(val);
+    }
+    u128(val) {
+        if (val < 0n || val > bounds_1.U128_MAX_BI)
+            this.#oob(val, 'uint128', 0n, bounds_1.U128_MAX_BI);
+        this.reserve(codec_1.WORD_SIZE);
+        this.#writeWordRight(val.toString(16));
+    }
+    i128(val) {
+        if (val < bounds_1.I128_MIN_BI || val > bounds_1.I128_MAX_BI)
+            this.#oob(val, 'int128', bounds_1.I128_MIN_BI, bounds_1.I128_MAX_BI);
+        this.#i256(val);
+    }
+    u256(val) {
+        if (val < 0n || val > bounds_1.U256_MAX_BI)
+            this.#oob(val, 'uint256', 0n, bounds_1.U256_MAX_BI);
+        this.reserve(codec_1.WORD_SIZE);
+        this.#writeWordRight(val.toString(16));
+    }
+    i256(val) {
+        if (val < bounds_1.I256_MIN_BI || val > bounds_1.I256_MAX_BI)
+            this.#oob(val, 'int256', bounds_1.I256_MIN_BI, bounds_1.I256_MAX_BI);
+        this.#i256(val);
+    }
+    #i256(val) {
+        const uval = val >= 0n ? val : val + bounds_1.U256_BASE;
+        this.reserve(codec_1.WORD_SIZE);
+        this.#writeWordRight(uval.toString(16));
+    }
+    bytes(val) {
+        if (typeof val === 'string') {
+            if (!(0, util_internal_hex_1.isHex)(val)) {
+                throw new Error(`Expected hex string or Uint8Array, got: ${val}`);
+            }
+            const nibbles = val.length - 2;
+            const size = nibbles >> 1;
+            this.u32(size);
+            const wordsCount = (size + codec_1.WORD_SIZE - 1) >> 5;
+            const reservedSize = wordsCount << 5;
+            this.reserve(reservedSize);
+            const dst = this.pos * HEX_BYTE;
+            if (nibbles >= BUFFER_HEX_CUTOFF * HEX_BYTE) {
+                this.buf.write(val.slice(2).toLowerCase(), dst, nibbles, 'latin1');
+            }
+            else {
+                this.#copyHexLower(val, 2, dst, nibbles);
+            }
+            this.pos += reservedSize;
+            this.#increaseCurrentDataAreaSize(reservedSize + codec_1.WORD_SIZE);
+        }
+        else {
+            const size = val.length;
+            this.u32(size);
+            const wordsCount = (size + codec_1.WORD_SIZE - 1) >> 5;
+            const reservedSize = wordsCount << 5;
+            this.reserve(reservedSize);
+            const dst = this.pos * HEX_BYTE;
+            if (size >= BUFFER_HEX_CUTOFF) {
+                const hex = Buffer.from(val.buffer, val.byteOffset, size).toString('hex');
+                this.buf.write(hex, dst, hex.length, 'latin1');
+            }
+            else {
+                this.#encodeBytes(val, size, dst);
+            }
+            this.pos += reservedSize;
+            this.#increaseCurrentDataAreaSize(reservedSize + codec_1.WORD_SIZE);
+        }
+    }
+    staticBytes(len, val) {
+        if (len > 32) {
+            throw new Error(`bytes${len} is not a valid type`);
+        }
+        this.reserve(codec_1.WORD_SIZE);
+        if (typeof val === 'string') {
+            if (!(0, util_internal_hex_1.isHex)(val)) {
+                throw new Error(`Expected hex string or Uint8Array, got: ${val}`);
+            }
+            const nibbles = val.length - 2;
+            if (nibbles > len * HEX_BYTE) {
+                throw new Error(`invalid data size for bytes${len}`);
+            }
+            this.#copyHexLower(val, 2, this.pos * HEX_BYTE, nibbles);
+            this.pos += codec_1.WORD_SIZE;
+        }
+        else {
+            if (val.length > len) {
+                throw new Error(`invalid data size for bytes${len}`);
+            }
+            this.#encodeBytes(val, val.length, this.pos * HEX_BYTE);
+            this.pos += codec_1.WORD_SIZE;
+        }
+    }
+    address(val) {
+        if (val.length === 42 && val.charCodeAt(0) === 0x30 && val.charCodeAt(1) === 0x78) {
+            this.reserve(codec_1.WORD_SIZE);
+            // 20-byte address right-aligned in a 32-byte word: skip 12 zero bytes (24 hex chars) of padding
+            this.#copyHexLower(val, 2, this.pos * HEX_BYTE + 24, 40);
+            this.pos += codec_1.WORD_SIZE;
+            return;
+        }
+        this.u256(BigInt(val));
+    }
+    string(val) {
+        this.bytes(bounds_1.TEXT_ENCODER.encode(val));
+    }
+    bool(val) {
+        this.u8(val ? 1 : 0);
+    }
+    #oob(val, typeName, min, max) {
+        throw new Error(`${val} is out of bounds for ${typeName}[${min}, ${max}]`);
+    }
+    openTail(slotsCount = 0) {
+        const offset = this.size();
+        this.reserve(codec_1.WORD_SIZE);
+        this.#u32Raw(offset);
+        const dataAreaStart = this.#currentDataAreaStart();
+        this.#pushDataArea(dataAreaStart + offset, slotsCount, false);
+        this.pos = dataAreaStart + offset;
+    }
+    openArray(count) {
+        const offset = this.size();
+        this.reserve(codec_1.WORD_SIZE);
+        this.#u32Raw(offset);
+        const dataAreaStart = this.#currentDataAreaStart();
+        this.#pushDataArea(dataAreaStart + offset + codec_1.WORD_SIZE, count, true);
+        this.pos = dataAreaStart + offset;
+        this.reserve(codec_1.WORD_SIZE);
+        this.#u32Raw(count);
+    }
+    #currentDataAreaStart() {
+        return this.stack[this.stack.length - 1].start;
+    }
+    #increaseCurrentDataAreaSize(amount) {
+        this.stack[this.stack.length - 1].size += amount;
+    }
+    #pushDataArea(dataAreaStart, slotsCount, countWord) {
+        const size = slotsCount * codec_1.WORD_SIZE;
+        this.reserve(dataAreaStart + size);
+        this.stack.push({
+            start: dataAreaStart,
+            jumpBackPtr: this.pos,
+            size,
+            countWord,
+        });
+    }
+    closeTail() {
+        (0, node_assert_1.default)(this.stack.length > 1, 'No dynamic encoding started');
+        const { jumpBackPtr, size, countWord } = this.stack.pop();
+        this.#increaseCurrentDataAreaSize(size + (countWord ? codec_1.WORD_SIZE : 0));
+        this.pos = jumpBackPtr;
+    }
+}
+exports.HexSink = HexSink;
+//# sourceMappingURL=hex.js.map

package/lib/sink/hex.js.map

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

package/lib/{src.d.ts → src/bytes.d.ts}

@@ -1,11 +1,12 @@
-export declare class Src {
+import { type Src } from '../codec';
+export declare class BytesSrc implements Src {
     #private;
     private buf;
     private view;
     private pos;
     private oldPos;
     constructor(buf: Uint8Array);
-    slice(start: number, end?: number): Src;
+    slice(start: number, end?: number): BytesSrc;
     u8(): number;
     i8(): number;
     u16(): number;
@@ -20,11 +21,12 @@ export declare class Src {
     i256(): bigint;
     address(): string;
     bytes(): Uint8Array;
+    bytesHex(): string;
     staticBytes(len: number): Uint8Array;
+    staticBytesHex(len: number): string;
     string(): string;
     bool(): boolean;
-    private assertLength;
-    safeJump(pos: number, typeName: string): void;
+    jump(pos: number, typeName?: string): void;
     jumpBack(): void;
 }
-//# sourceMappingURL=src.d.ts.map
+//# sourceMappingURL=bytes.d.ts.map

package/lib/src/bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../src/src/bytes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,GAAG,EAAC,MAAM,UAAU,CAAA;AAY5C,qBAAa,QAAS,YAAW,GAAG;;IAKpB,OAAO,CAAC,GAAG;IAJvB,OAAO,CAAC,IAAI,CAAU;IACtB,OAAO,CAAC,GAAG,CAAI;IACf,OAAO,CAAC,MAAM,CAAI;gBAEE,GAAG,EAAE,UAAU;IAInC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,QAAQ;IAI5C,EAAE,IAAI,MAAM;IAOZ,EAAE,IAAI,MAAM;IAIZ,GAAG,IAAI,MAAM;IAOb,GAAG,IAAI,MAAM;IAIb,GAAG,IAAI,MAAM;IAOb,GAAG,IAAI,MAAM;IAIb,GAAG,IAAI,MAAM;IAWb,GAAG,IAAI,MAAM;IAMb,IAAI,IAAI,MAAM;IAYd,IAAI,IAAI,MAAM;IAMd,IAAI,IAAI,MAAM;IAMd,IAAI,IAAI,MAAM;IAOd,OAAO,IAAI,MAAM;IAMjB,KAAK,IAAI,UAAU;IAUnB,QAAQ,IAAI,MAAM;IAUlB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU;IASpC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IASnC,MAAM,IAAI,MAAM;IAUhB,IAAI,IAAI,OAAO;IAYf,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAW1C,QAAQ,IAAI,IAAI;CAGnB"}

package/lib/src/bytes.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BytesSrc = void 0;
+const codec_1 = require("../codec");
+const util_internal_hex_1 = require("@subsquid/util-internal-hex");
+const I64_SIGN_BIT = 1n << 63n;
+const I64_RANGE = 1n << 64n;
+const I128_SIGN_BIT = 1n << 127n;
+const I128_RANGE = 1n << 128n;
+const I256_SIGN_BIT = 1n << 255n;
+const I256_RANGE = 1n << 256n;
+const TEXT_DECODER = new TextDecoder('utf-8');
+class BytesSrc {
+    buf;
+    view;
+    pos = 0;
+    oldPos = 0;
+    constructor(buf) {
+        this.buf = buf;
+        this.view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    }
+    slice(start, end) {
+        return new BytesSrc(this.buf.subarray(start, end));
+    }
+    u8() {
+        this.pos += codec_1.WORD_SIZE - 1;
+        let val = this.view.getUint8(this.pos);
+        this.pos += 1;
+        return val;
+    }
+    i8() {
+        return Number(this.i256());
+    }
+    u16() {
+        this.pos += codec_1.WORD_SIZE - 2;
+        let val = this.view.getUint16(this.pos, false);
+        this.pos += 2;
+        return val;
+    }
+    i16() {
+        return Number(this.i256());
+    }
+    u32() {
+        this.pos += codec_1.WORD_SIZE - 4;
+        let val = this.view.getUint32(this.pos, false);
+        this.pos += 4;
+        return val;
+    }
+    i32() {
+        return Number(this.i256());
+    }
+    u64() {
+        this.pos += codec_1.WORD_SIZE - 8;
+        return this.#u64();
+    }
+    #u64() {
+        let val = this.view.getBigUint64(this.pos, false);
+        this.pos += 8;
+        return val;
+    }
+    i64() {
+        this.pos += codec_1.WORD_SIZE - 8;
+        const raw = this.#u64();
+        return raw < I64_SIGN_BIT ? raw : raw - I64_RANGE;
+    }
+    u128() {
+        this.pos += codec_1.WORD_SIZE - 16;
+        return this.#u128();
+    }
+    #u128() {
+        const hi = this.view.getBigUint64(this.pos, false);
+        const lo = this.view.getBigUint64(this.pos + 8, false);
+        this.pos += 16;
+        return (hi << 64n) | lo;
+    }
+    i128() {
+        this.pos += codec_1.WORD_SIZE - 16;
+        const raw = this.#u128();
+        return raw < I128_SIGN_BIT ? raw : raw - I128_RANGE;
+    }
+    u256() {
+        const hi = this.#u128();
+        const lo = this.#u128();
+        return (hi << 128n) | lo;
+    }
+    i256() {
+        const hi = this.#u128();
+        const lo = this.#u128();
+        const raw = (hi << 128n) | lo;
+        return raw < I256_SIGN_BIT ? raw : raw - I256_RANGE;
+    }
+    address() {
+        const start = this.pos + codec_1.WORD_SIZE - 20;
+        this.pos += codec_1.WORD_SIZE;
+        return (0, util_internal_hex_1.toHex)(this.buf, start, 20);
+    }
+    bytes() {
+        const ptr = this.u32();
+        this.jump(ptr);
+        const len = Number(this.u256());
+        this.#assertLength(len, 'bytes');
+        const val = this.buf.subarray(this.pos, this.pos + len);
+        this.jumpBack();
+        return val;
+    }
+    bytesHex() {
+        const ptr = this.u32();
+        this.jump(ptr);
+        const len = Number(this.u256());
+        this.#assertLength(len, 'bytes');
+        const val = (0, util_internal_hex_1.toHex)(this.buf, this.pos, len);
+        this.jumpBack();
+        return val;
+    }
+    staticBytes(len) {
+        if (len > 32) {
+            throw new Error(`bytes${len} is not a valid type`);
+        }
+        const val = this.buf.subarray(this.pos, this.pos + len);
+        this.pos += codec_1.WORD_SIZE;
+        return val;
+    }
+    staticBytesHex(len) {
+        if (len > 32) {
+            throw new Error(`bytes${len} is not a valid type`);
+        }
+        const start = this.pos;
+        this.pos += codec_1.WORD_SIZE;
+        return (0, util_internal_hex_1.toHex)(this.buf, start, len);
+    }
+    string() {
+        const ptr = this.u32();
+        this.jump(ptr, 'string');
+        const len = Number(this.u256());
+        this.#assertLength(len, 'string');
+        const val = TEXT_DECODER.decode(this.buf.subarray(this.pos, this.pos + len));
+        this.jumpBack();
+        return val;
+    }
+    bool() {
+        return !!this.u8();
+    }
+    #assertLength(len, typeName) {
+        if (this.buf.length - this.pos < len) {
+            throw new RangeError(`Unexpected end of input. Attempting to read ${typeName} of length ${len} from ${(0, util_internal_hex_1.toHex)(this.buf)}`);
+        }
+    }
+    jump(pos, typeName) {
+        if (pos < 0 || pos >= this.buf.length) {
+            const what = typeName ? `${typeName} ` : '';
+            throw new RangeError(`Unexpected pointer location: 0x${pos.toString(16)}. Attempting to read ${what}from ${(0, util_internal_hex_1.toHex)(this.buf)}`);
+        }
+        this.oldPos = this.pos;
+        this.pos = pos;
+    }
+    jumpBack() {
+        this.pos = this.oldPos;
+    }
+}
+exports.BytesSrc = BytesSrc;
+//# sourceMappingURL=bytes.js.map

package/lib/src/bytes.js.map

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

package/lib/src/hex.d.ts

@@ -0,0 +1,33 @@
+import { type Src } from '../codec';
+export declare class HexSrc implements Src {
+    #private;
+    private readonly buf;
+    private readonly base;
+    private readonly endChar;
+    private pos;
+    private oldPos;
+    constructor(hex: string, strOffset?: number, strEnd?: number);
+    slice(start: number, end?: number): HexSrc;
+    u8(): number;
+    i8(): number;
+    u16(): number;
+    i16(): number;
+    u32(): number;
+    i32(): number;
+    u64(): bigint;
+    i64(): bigint;
+    u128(): bigint;
+    i128(): bigint;
+    u256(): bigint;
+    i256(): bigint;
+    address(): string;
+    bytes(): Uint8Array;
+    bytesHex(): string;
+    staticBytes(len: number): Uint8Array;
+    staticBytesHex(len: number): string;
+    string(): string;
+    bool(): boolean;
+    jump(pos: number, typeName?: string): void;
+    jumpBack(): void;
+}
+//# sourceMappingURL=hex.d.ts.map

package/lib/src/hex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../src/src/hex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,GAAG,EAAC,MAAM,UAAU,CAAA;AAc5C,qBAAa,MAAO,YAAW,GAAG;;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,MAAM,CAAQ;gBAEV,GAAG,EAAE,MAAM,EAAE,SAAS,SAAI,EAAE,MAAM,GAAE,MAAmB;IAQnE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM;IAM1C,EAAE,IAAI,MAAM;IAOZ,EAAE,IAAI,MAAM;IAIZ,GAAG,IAAI,MAAM;IAOb,GAAG,IAAI,MAAM;IAIb,GAAG,IAAI,MAAM;IAOb,GAAG,IAAI,MAAM;IAIb,GAAG,IAAI,MAAM;IAOb,GAAG,IAAI,MAAM;IAKb,IAAI,IAAI,MAAM;IAOd,IAAI,IAAI,MAAM;IAKd,IAAI,IAAI,MAAM;IAMd,IAAI,IAAI,MAAM;IAKd,OAAO,IAAI,MAAM;IAOjB,KAAK,IAAI,UAAU;IAWnB,QAAQ,IAAI,MAAM;IAUlB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU;IASpC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IASnC,MAAM,IAAI,MAAM;IAWhB,IAAI,IAAI,OAAO;IAef,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAY1C,QAAQ,IAAI,IAAI;CAGnB"}