@qubic.org/registry 0.2.0

package/dist/payload.js

@@ -0,0 +1,305 @@
+export class PayloadBuildError extends Error {
+    constructor(message, options) {
+        super(message, { cause: options?.cause });
+        this.name = 'PayloadBuildError';
+    }
+}
+/**
+ * Encodes a contract call input into binary using registry field descriptors.
+ *
+ * Field encoding rules:
+ *   uint8/16/32    → DataView.setUintN (little-endian)
+ *   uint64/sint64  → DataView.setBigUint64 / setBigInt64 (little-endian)
+ *   uint128        → two consecutive uint64 LE (lo word first, hi word second)
+ *   id             → 32-byte public key via injected identityToPublicKey
+ *   bytes          → Uint8Array copied verbatim (must be exactly field.byteLength)
+ *   struct         → recursively encoded using structs[field.structRef].fields
+ *   array          → N items encoded sequentially
+ *
+ * Advanced mode: pass a Uint8Array as the value for any field. Its length must
+ * equal field.byteLength — it is copied verbatim without type coercion.
+ *
+ * @throws {PayloadBuildError} on type mismatch, out-of-range value, or length mismatch
+ */
+export function buildPayload(fields, structs, input, identityToPublicKey) {
+    const totalSize = fields.reduce((s, f) => s + f.byteLength, 0);
+    const buf = new Uint8Array(totalSize);
+    const view = new DataView(buf.buffer);
+    for (const field of fields) {
+        const raw = input[field.name];
+        if (raw === undefined) {
+            throw new PayloadBuildError(`Missing field "${field.name}"`);
+        }
+        // Advanced mode: Uint8Array verbatim copy
+        if (raw instanceof Uint8Array) {
+            if (raw.byteLength !== field.byteLength) {
+                throw new PayloadBuildError(`Field "${field.name}": Uint8Array length ${raw.byteLength} !== expected ${field.byteLength}`);
+            }
+            buf.set(raw, field.offset);
+            continue;
+        }
+        encodeField(field, raw, buf, view, field.offset, structs, identityToPublicKey);
+    }
+    return buf;
+}
+// ── Shared scalar encoder ─────────────────────────────────────────────────────
+function writeScalar(type, fieldName, value, buf, view, offset, identityToPublicKey) {
+    switch (type) {
+        case 'uint8':
+        case 'sint8':
+            if (typeof value !== 'number')
+                throw new PayloadBuildError(`Field "${fieldName}": expected number`);
+            view.setUint8(offset, value);
+            break;
+        case 'uint16':
+        case 'sint16':
+            if (typeof value !== 'number')
+                throw new PayloadBuildError(`Field "${fieldName}": expected number`);
+            view.setUint16(offset, value, true);
+            break;
+        case 'uint32':
+        case 'sint32':
+            if (typeof value !== 'number')
+                throw new PayloadBuildError(`Field "${fieldName}": expected number`);
+            view.setUint32(offset, value, true);
+            break;
+        case 'uint64':
+            if (typeof value !== 'bigint')
+                throw new PayloadBuildError(`Field "${fieldName}": expected bigint`);
+            view.setBigUint64(offset, value, true);
+            break;
+        case 'sint64':
+            if (typeof value !== 'bigint')
+                throw new PayloadBuildError(`Field "${fieldName}": expected bigint`);
+            view.setBigInt64(offset, value, true);
+            break;
+        case 'uint128': {
+            if (typeof value !== 'bigint')
+                throw new PayloadBuildError(`Field "${fieldName}": expected bigint`);
+            view.setBigUint64(offset, value & 0xffffffffffffffffn, true);
+            view.setBigUint64(offset + 8, value >> 64n, true);
+            break;
+        }
+        case 'id': {
+            if (typeof value !== 'string')
+                throw new PayloadBuildError(`Field "${fieldName}": expected Identity string`);
+            buf.set(identityToPublicKey(value).subarray(0, 32), offset);
+            break;
+        }
+        default:
+            throw new PayloadBuildError(`Scalar encoding not supported for type "${type}"`);
+    }
+}
+// ── Shared scalar decoder ─────────────────────────────────────────────────────
+function readScalar(type, data, view, offset, publicKeyToIdentity) {
+    switch (type) {
+        case 'uint8':
+        case 'sint8':
+            return view.getUint8(offset);
+        case 'uint16':
+        case 'sint16':
+            return view.getUint16(offset, true);
+        case 'uint32':
+        case 'sint32':
+            return view.getUint32(offset, true);
+        case 'uint64':
+            return view.getBigUint64(offset, true);
+        case 'sint64':
+            return view.getBigInt64(offset, true);
+        case 'uint128': {
+            const lo = view.getBigUint64(offset, true);
+            const hi = view.getBigUint64(offset + 8, true);
+            return lo + hi * 2n ** 64n;
+        }
+        case 'id':
+            return publicKeyToIdentity(data.subarray(offset, offset + 32));
+        default:
+            throw new PayloadBuildError(`Scalar decoding not supported for type "${type}"`);
+    }
+}
+// ── Field encoder ─────────────────────────────────────────────────────────────
+function encodeField(field, value, buf, view, offset, structs, identityToPublicKey) {
+    switch (field.type) {
+        case 'uint8':
+        case 'sint8':
+        case 'uint16':
+        case 'sint16':
+        case 'uint32':
+        case 'sint32':
+        case 'uint64':
+        case 'sint64':
+        case 'uint128':
+        case 'id':
+            writeScalar(field.type, field.name, value, buf, view, offset, identityToPublicKey);
+            break;
+        case 'bytes': {
+            if (!(value instanceof Uint8Array))
+                throw new PayloadBuildError(`Field "${field.name}": expected Uint8Array`);
+            if (value.byteLength !== field.byteLength)
+                throw new PayloadBuildError(`Field "${field.name}": Uint8Array length ${value.byteLength} !== expected ${field.byteLength}`);
+            buf.set(value, offset);
+            break;
+        }
+        case 'struct': {
+            if (field.structRef === undefined)
+                throw new PayloadBuildError(`Field "${field.name}": missing structRef`);
+            const namedStruct = structs[field.structRef];
+            if (!namedStruct)
+                throw new PayloadBuildError(`Field "${field.name}": struct "${field.structRef}" not found`);
+            if (typeof value !== 'object' ||
+                value === null ||
+                Array.isArray(value) ||
+                value instanceof Uint8Array)
+                throw new PayloadBuildError(`Field "${field.name}": expected object for struct`);
+            const nested = value;
+            for (const sf of namedStruct.fields) {
+                const sv = nested[sf.name];
+                if (sv === undefined)
+                    throw new PayloadBuildError(`Struct field "${sf.name}" missing`);
+                encodeField(sf, sv, buf, view, offset + sf.offset, structs, identityToPublicKey);
+            }
+            break;
+        }
+        case 'array': {
+            if (!Array.isArray(value))
+                throw new PayloadBuildError(`Field "${field.name}": expected array`);
+            if (field.arrayItemByteLength === undefined)
+                throw new PayloadBuildError(`Field "${field.name}": missing arrayItemByteLength`);
+            const itemLen = field.arrayItemByteLength;
+            const itemType = field.arrayItemType ?? 'uint8';
+            for (let i = 0; i < value.length; i++) {
+                const itemOffset = offset + i * itemLen;
+                if (field.arrayItemStructRef !== undefined) {
+                    const namedStruct = structs[field.arrayItemStructRef];
+                    if (!namedStruct)
+                        throw new PayloadBuildError(`Field "${field.name}": struct item "${field.arrayItemStructRef}" not found`);
+                    const itemVal = value[i];
+                    for (const sf of namedStruct.fields) {
+                        const sv = itemVal[sf.name];
+                        if (sv === undefined)
+                            throw new PayloadBuildError(`Array struct field "${sf.name}" missing`);
+                        encodeField(sf, sv, buf, view, itemOffset + sf.offset, structs, identityToPublicKey);
+                    }
+                }
+                else {
+                    writeScalar(itemType, field.name, value[i], buf, view, itemOffset, identityToPublicKey);
+                }
+            }
+            break;
+        }
+        default:
+            throw new PayloadBuildError(`Unknown field type: ${field.type}`);
+    }
+}
+// ── Field decoder ─────────────────────────────────────────────────────────────
+/**
+ * Decodes binary payload bytes into a typed record using registry field descriptors.
+ * Mirror of buildPayload — same field dispatch logic, reversed direction.
+ */
+export function decodePayload(data, fields, structs, publicKeyToIdentity) {
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const result = {};
+    for (const field of fields) {
+        result[field.name] = decodeField(field, data, view, field.offset, structs, publicKeyToIdentity);
+    }
+    return result;
+}
+function decodeField(field, data, view, offset, structs, publicKeyToIdentity) {
+    switch (field.type) {
+        case 'uint8':
+        case 'sint8':
+        case 'uint16':
+        case 'sint16':
+        case 'uint32':
+        case 'sint32':
+        case 'uint64':
+        case 'sint64':
+        case 'uint128':
+        case 'id':
+            return readScalar(field.type, data, view, offset, publicKeyToIdentity);
+        case 'bytes':
+            return data.slice(offset, offset + field.byteLength);
+        case 'struct': {
+            if (field.structRef === undefined)
+                throw new PayloadBuildError(`Field "${field.name}": missing structRef`);
+            const namedStruct = structs[field.structRef];
+            if (!namedStruct)
+                throw new PayloadBuildError(`Field "${field.name}": struct "${field.structRef}" not found`);
+            const nested = {};
+            for (const sf of namedStruct.fields) {
+                nested[sf.name] = decodeField(sf, data, view, offset + sf.offset, structs, publicKeyToIdentity);
+            }
+            return nested;
+        }
+        case 'array': {
+            if (field.arrayLength === undefined)
+                throw new PayloadBuildError(`Field "${field.name}": missing arrayLength`);
+            const items = [];
+            const itemLen = field.arrayItemByteLength ?? 0;
+            const itemType = field.arrayItemType ?? 'uint8';
+            for (let i = 0; i < field.arrayLength; i++) {
+                const itemOffset = offset + i * itemLen;
+                if (field.arrayItemStructRef !== undefined) {
+                    const namedStruct = structs[field.arrayItemStructRef];
+                    if (namedStruct) {
+                        const nested = {};
+                        for (const sf of namedStruct.fields) {
+                            nested[sf.name] = decodeField(sf, data, view, itemOffset + sf.offset, structs, publicKeyToIdentity);
+                        }
+                        items.push(nested);
+                    }
+                }
+                else {
+                    items.push(readScalar(itemType, data, view, itemOffset, publicKeyToIdentity));
+                }
+            }
+            return items;
+        }
+        default:
+            throw new PayloadBuildError(`Unknown field type: ${field.type}`);
+    }
+}
+/**
+ * Builds a payload from an ordered list of typed fields — no registry, no field names.
+ * For use with unknown or custom contracts.
+ *
+ * @example
+ * const payload = buildPayloadManual([
+ *   { type: 'uint64', value: 5_000_000n },
+ *   { type: 'uint32', value: 150 },
+ * ])
+ */
+export function buildPayloadManual(fields) {
+    const sizes = {
+        uint8: 1,
+        sint8: 1,
+        uint16: 2,
+        sint16: 2,
+        uint32: 4,
+        sint32: 4,
+        uint64: 8,
+        sint64: 8,
+        uint128: 16,
+        id: 32,
+    };
+    let totalSize = 0;
+    for (const f of fields) {
+        totalSize += f.value instanceof Uint8Array ? f.value.byteLength : (sizes[f.type] ?? 0);
+    }
+    const buf = new Uint8Array(totalSize);
+    const view = new DataView(buf.buffer);
+    let offset = 0;
+    for (const f of fields) {
+        if (f.value instanceof Uint8Array) {
+            buf.set(f.value, offset);
+            offset += f.value.byteLength;
+        }
+        else {
+            const size = sizes[f.type] ?? 0;
+            writeScalar(f.type, '', f.value, buf, view, offset, () => new Uint8Array(32));
+            offset += size;
+        }
+    }
+    return buf;
+}
+//# sourceMappingURL=payload.js.map

package/dist/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../src/payload.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;QACzC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAqB,EACrB,OAAoC,EACpC,KAA8C,EAC9C,mBAAqD;IAErD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAA;IAC9D,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAA;IACrC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAErC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC7B,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,iBAAiB,CAAC,kBAAkB,KAAK,CAAC,IAAI,GAAG,CAAC,CAAA;QAC9D,CAAC;QAED,0CAA0C;QAC1C,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;YAC9B,IAAI,GAAG,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,EAAE,CAAC;gBACxC,MAAM,IAAI,iBAAiB,CACzB,UAAU,KAAK,CAAC,IAAI,wBAAwB,GAAG,CAAC,UAAU,iBAAiB,KAAK,CAAC,UAAU,EAAE,CAC9F,CAAA;YACH,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;YAC1B,SAAQ;QACV,CAAC;QAED,WAAW,CAAC,KAAK,EAAE,GAAiB,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAA;IAC9F,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,iFAAiF;AAEjF,SAAS,WAAW,CAClB,IAAe,EACf,SAAiB,EACjB,KAAiB,EACjB,GAAe,EACf,IAAc,EACd,MAAc,EACd,mBAAqD;IAErD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO,CAAC;QACb,KAAK,OAAO;YACV,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAC3B,MAAM,IAAI,iBAAiB,CAAC,UAAU,SAAS,oBAAoB,CAAC,CAAA;YACtE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;YAC5B,MAAK;QACP,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAC3B,MAAM,IAAI,iBAAiB,CAAC,UAAU,SAAS,oBAAoB,CAAC,CAAA;YACtE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;YACnC,MAAK;QACP,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAC3B,MAAM,IAAI,iBAAiB,CAAC,UAAU,SAAS,oBAAoB,CAAC,CAAA;YACtE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;YACnC,MAAK;QACP,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAC3B,MAAM,IAAI,iBAAiB,CAAC,UAAU,SAAS,oBAAoB,CAAC,CAAA;YACtE,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;YACtC,MAAK;QACP,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAC3B,MAAM,IAAI,iBAAiB,CAAC,UAAU,SAAS,oBAAoB,CAAC,CAAA;YACtE,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;YACrC,MAAK;QACP,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAC3B,MAAM,IAAI,iBAAiB,CAAC,UAAU,SAAS,oBAAoB,CAAC,CAAA;YACtE,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,GAAG,mBAAmB,EAAE,IAAI,CAAC,CAAA;YAC5D,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,GAAG,EAAE,IAAI,CAAC,CAAA;YACjD,MAAK;QACP,CAAC;QACD,KAAK,IAAI,CAAC,CAAC,CAAC;YACV,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAC3B,MAAM,IAAI,iBAAiB,CAAC,UAAU,SAAS,6BAA6B,CAAC,CAAA;YAC/E,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,CAAA;YAC3D,MAAK;QACP,CAAC;QACD;YACE,MAAM,IAAI,iBAAiB,CAAC,2CAA2C,IAAI,GAAG,CAAC,CAAA;IACnF,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF,SAAS,UAAU,CACjB,IAAe,EACf,IAAgB,EAChB,IAAc,EACd,MAAc,EACd,mBAA+C;IAE/C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO,CAAC;QACb,KAAK,OAAO;YACV,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;QAC9B,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QACrC,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QACrC,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QACxC,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QACvC,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;YAC1C,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,CAAA;YAC9C,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,GAAG,CAAA;QAC5B,CAAC;QACD,KAAK,IAAI;YACP,OAAO,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC,CAAA;QAChE;YACE,MAAM,IAAI,iBAAiB,CAAC,2CAA2C,IAAI,GAAG,CAAC,CAAA;IACnF,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF,SAAS,WAAW,CAClB,KAAkB,EAClB,KAAiB,EACjB,GAAe,EACf,IAAc,EACd,MAAc,EACd,OAAoC,EACpC,mBAAqD;IAErD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,OAAO,CAAC;QACb,KAAK,OAAO,CAAC;QACb,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC;QACf,KAAK,IAAI;YACP,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAA;YAClF,MAAK;QACP,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC;gBAChC,MAAM,IAAI,iBAAiB,CAAC,UAAU,KAAK,CAAC,IAAI,wBAAwB,CAAC,CAAA;YAC3E,IAAI,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU;gBACvC,MAAM,IAAI,iBAAiB,CACzB,UAAU,KAAK,CAAC,IAAI,wBAAwB,KAAK,CAAC,UAAU,iBAAiB,KAAK,CAAC,UAAU,EAAE,CAChG,CAAA;YACH,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;YACtB,MAAK;QACP,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;gBAC/B,MAAM,IAAI,iBAAiB,CAAC,UAAU,KAAK,CAAC,IAAI,sBAAsB,CAAC,CAAA;YACzE,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;YAC5C,IAAI,CAAC,WAAW;gBACd,MAAM,IAAI,iBAAiB,CAAC,UAAU,KAAK,CAAC,IAAI,cAAc,KAAK,CAAC,SAAS,aAAa,CAAC,CAAA;YAC7F,IACE,OAAO,KAAK,KAAK,QAAQ;gBACzB,KAAK,KAAK,IAAI;gBACd,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBACpB,KAAK,YAAY,UAAU;gBAE3B,MAAM,IAAI,iBAAiB,CAAC,UAAU,KAAK,CAAC,IAAI,+BAA+B,CAAC,CAAA;YAClF,MAAM,MAAM,GAAG,KAAsB,CAAA;YACrC,KAAK,MAAM,EAAE,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;gBACpC,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA;gBAC1B,IAAI,EAAE,KAAK,SAAS;oBAAE,MAAM,IAAI,iBAAiB,CAAC,iBAAiB,EAAE,CAAC,IAAI,WAAW,CAAC,CAAA;gBACtF,WAAW,CACT,EAAE,EACF,EAAgB,EAChB,GAAG,EACH,IAAI,EACJ,MAAM,GAAG,EAAE,CAAC,MAAM,EAClB,OAAO,EACP,mBAAmB,CACpB,CAAA;YACH,CAAC;YACD,MAAK;QACP,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBACvB,MAAM,IAAI,iBAAiB,CAAC,UAAU,KAAK,CAAC,IAAI,mBAAmB,CAAC,CAAA;YACtE,IAAI,KAAK,CAAC,mBAAmB,KAAK,SAAS;gBACzC,MAAM,IAAI,iBAAiB,CAAC,UAAU,KAAK,CAAC,IAAI,gCAAgC,CAAC,CAAA;YACnF,MAAM,OAAO,GAAG,KAAK,CAAC,mBAAmB,CAAA;YACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,aAAa,IAAI,OAAO,CAAA;YAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,GAAG,OAAO,CAAA;gBACvC,IAAI,KAAK,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;oBAC3C,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAA;oBACrD,IAAI,CAAC,WAAW;wBACd,MAAM,IAAI,iBAAiB,CACzB,UAAU,KAAK,CAAC,IAAI,mBAAmB,KAAK,CAAC,kBAAkB,aAAa,CAC7E,CAAA;oBACH,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAkB,CAAA;oBACzC,KAAK,MAAM,EAAE,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;wBACpC,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA;wBAC3B,IAAI,EAAE,KAAK,SAAS;4BAClB,MAAM,IAAI,iBAAiB,CAAC,uBAAuB,EAAE,CAAC,IAAI,WAAW,CAAC,CAAA;wBACxE,WAAW,CACT,EAAE,EACF,EAAgB,EAChB,GAAG,EACH,IAAI,EACJ,UAAU,GAAG,EAAE,CAAC,MAAM,EACtB,OAAO,EACP,mBAAmB,CACpB,CAAA;oBACH,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,WAAW,CACT,QAAQ,EACR,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,CAAC,CAAe,EACtB,GAAG,EACH,IAAI,EACJ,UAAU,EACV,mBAAmB,CACpB,CAAA;gBACH,CAAC;YACH,CAAC;YACD,MAAK;QACP,CAAC;QACD;YACE,MAAM,IAAI,iBAAiB,CAAC,uBAAuB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IACpE,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAgB,EAChB,MAAqB,EACrB,OAAoC,EACpC,mBAA+C;IAE/C,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;IACxE,MAAM,MAAM,GAAkB,EAAE,CAAA;IAChC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAA;IACjG,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,WAAW,CAClB,KAAkB,EAClB,IAAgB,EAChB,IAAc,EACd,MAAc,EACd,OAAoC,EACpC,mBAA+C;IAE/C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,OAAO,CAAC;QACb,KAAK,OAAO,CAAC;QACb,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC;QACf,KAAK,IAAI;YACP,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAA;QACxE,KAAK,OAAO;YACV,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,CAAA;QACtD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;gBAC/B,MAAM,IAAI,iBAAiB,CAAC,UAAU,KAAK,CAAC,IAAI,sBAAsB,CAAC,CAAA;YACzE,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;YAC5C,IAAI,CAAC,WAAW;gBACd,MAAM,IAAI,iBAAiB,CAAC,UAAU,KAAK,CAAC,IAAI,cAAc,KAAK,CAAC,SAAS,aAAa,CAAC,CAAA;YAC7F,MAAM,MAAM,GAAkB,EAAE,CAAA;YAChC,KAAK,MAAM,EAAE,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;gBACpC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,WAAW,CAC3B,EAAE,EACF,IAAI,EACJ,IAAI,EACJ,MAAM,GAAG,EAAE,CAAC,MAAM,EAClB,OAAO,EACP,mBAAmB,CACpB,CAAA;YACH,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;gBACjC,MAAM,IAAI,iBAAiB,CAAC,UAAU,KAAK,CAAC,IAAI,wBAAwB,CAAC,CAAA;YAC3E,MAAM,KAAK,GAAiB,EAAE,CAAA;YAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,mBAAmB,IAAI,CAAC,CAAA;YAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,aAAa,IAAI,OAAO,CAAA;YAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3C,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,GAAG,OAAO,CAAA;gBACvC,IAAI,KAAK,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;oBAC3C,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAA;oBACrD,IAAI,WAAW,EAAE,CAAC;wBAChB,MAAM,MAAM,GAAkB,EAAE,CAAA;wBAChC,KAAK,MAAM,EAAE,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;4BACpC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,WAAW,CAC3B,EAAE,EACF,IAAI,EACJ,IAAI,EACJ,UAAU,GAAG,EAAE,CAAC,MAAM,EACtB,OAAO,EACP,mBAAmB,CACpB,CAAA;wBACH,CAAC;wBACD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;oBACpB,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAA;gBAC/E,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAA;QACd,CAAC;QACD;YACE,MAAM,IAAI,iBAAiB,CAAC,uBAAuB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IACpE,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAA6D;IAE7D,MAAM,KAAK,GAA2B;QACpC,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,EAAE;QACX,EAAE,EAAE,EAAE;KACP,CAAA;IACD,IAAI,SAAS,GAAG,CAAC,CAAA;IACjB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,SAAS,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACxF,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAA;IACrC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACrC,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,EAAE,CAAC;YAClC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;YACxB,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,UAAU,CAAA;QAC9B,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC/B,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAA;YAC7E,MAAM,IAAI,IAAI,CAAA;QAChB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,48 @@
+import type { AbiLookupResult, ContractAbiVersion, ContractCallBase, ContractRegistry } from './types.js';
+export declare class AbiNotFoundError extends Error {
+    readonly contractIndex: number;
+    readonly epoch: number;
+    constructor(contractIndex: number, epoch: number, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Returns the ABI version active at the given epoch for the given contract.
+ * @throws {AbiNotFoundError} if no version covers the epoch.
+ */
+export declare function getAbi(registry: ContractRegistry, contractIndex: number, epoch: number): AbiLookupResult;
+/**
+ * Returns all ABI versions for a contract, sorted by effectiveFromEpoch ASC.
+ */
+export declare function getAbiHistory(registry: ContractRegistry, contractIndex: number): ContractAbiVersion[];
+/**
+ * Returns the currently-active ABI version (effectiveToEpoch === null).
+ * @throws {AbiNotFoundError} if none exists.
+ */
+export declare function getCurrentAbi(registry: ContractRegistry, contractIndex: number): ContractAbiVersion;
+/**
+ * Finds a procedure by inputType ordinal.
+ * @throws if not found.
+ */
+export declare function getProcedure(version: ContractAbiVersion, inputType: number): ContractCallBase;
+/**
+ * Finds a function by inputType ordinal.
+ * @throws if not found.
+ */
+export declare function getFunction(version: ContractAbiVersion, inputType: number): ContractCallBase;
+/**
+ * Returns the contract name for a given index.
+ * @throws if the index is not registered.
+ */
+export declare function findContractByIndex(registry: ContractRegistry, contractIndex: number): string;
+/**
+ * Returns the contract index for a given name (case-insensitive).
+ * @throws if not found.
+ */
+export declare function findContractByName(registry: ContractRegistry, name: string): number;
+/**
+ * Validates the registry for structural correctness.
+ * @throws with a descriptive message on any inconsistency.
+ */
+export declare function validateRegistry(registry: ContractRegistry): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAEnB,qBAAa,gBAAiB,SAAQ,KAAK;IAEvC,QAAQ,CAAC,aAAa,EAAE,MAAM;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM;gBADb,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAOhC;AAED;;;GAGG;AACH,wBAAgB,MAAM,CACpB,QAAQ,EAAE,gBAAgB,EAC1B,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,eAAe,CAcjB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,gBAAgB,EAC1B,aAAa,EAAE,MAAM,GACpB,kBAAkB,EAAE,CAItB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,gBAAgB,EAC1B,aAAa,EAAE,MAAM,GACpB,kBAAkB,CAMpB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAO7F;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAK5F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAI7F;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAiCjE"}

package/dist/registry.js

@@ -0,0 +1,151 @@
+export class AbiNotFoundError extends Error {
+    contractIndex;
+    epoch;
+    constructor(contractIndex, epoch, options) {
+        super(`No ABI found for contract ${contractIndex} at epoch ${epoch}`, {
+            cause: options?.cause,
+        });
+        this.contractIndex = contractIndex;
+        this.epoch = epoch;
+        this.name = 'AbiNotFoundError';
+    }
+}
+/**
+ * Returns the ABI version active at the given epoch for the given contract.
+ * @throws {AbiNotFoundError} if no version covers the epoch.
+ */
+export function getAbi(registry, contractIndex, epoch) {
+    const versions = registry.versions.filter((v) => v.contractIndex === contractIndex);
+    const version = versions.find((v) => v.effectiveFromEpoch <= epoch && epoch <= (v.effectiveToEpoch ?? Number.POSITIVE_INFINITY));
+    if (!version)
+        throw new AbiNotFoundError(contractIndex, epoch);
+    const maxFrom = versions.reduce((m, v) => Math.max(m, v.effectiveFromEpoch), 0);
+    const isCurrent = version.effectiveToEpoch === null;
+    return {
+        version,
+        isCurrent,
+        isRegistryPossiblyStale: isCurrent && epoch > maxFrom,
+    };
+}
+/**
+ * Returns all ABI versions for a contract, sorted by effectiveFromEpoch ASC.
+ */
+export function getAbiHistory(registry, contractIndex) {
+    return registry.versions
+        .filter((v) => v.contractIndex === contractIndex)
+        .sort((a, b) => a.effectiveFromEpoch - b.effectiveFromEpoch);
+}
+/**
+ * Returns the currently-active ABI version (effectiveToEpoch === null).
+ * @throws {AbiNotFoundError} if none exists.
+ */
+export function getCurrentAbi(registry, contractIndex) {
+    const version = registry.versions.find((v) => v.contractIndex === contractIndex && v.effectiveToEpoch === null);
+    if (!version)
+        throw new AbiNotFoundError(contractIndex, -1);
+    return version;
+}
+/**
+ * Finds a procedure by inputType ordinal.
+ * @throws if not found.
+ */
+export function getProcedure(version, inputType) {
+    const proc = version.procedures.find((p) => p.inputType === inputType);
+    if (!proc)
+        throw new Error(`Procedure inputType ${inputType} not found in contract ${version.contractName}`);
+    return proc;
+}
+/**
+ * Finds a function by inputType ordinal.
+ * @throws if not found.
+ */
+export function getFunction(version, inputType) {
+    const fn = version.functions.find((f) => f.inputType === inputType);
+    if (!fn)
+        throw new Error(`Function inputType ${inputType} not found in contract ${version.contractName}`);
+    return fn;
+}
+/**
+ * Returns the contract name for a given index.
+ * @throws if the index is not registered.
+ */
+export function findContractByIndex(registry, contractIndex) {
+    const version = registry.versions.find((v) => v.contractIndex === contractIndex);
+    if (!version)
+        throw new Error(`Contract index ${contractIndex} not found in registry`);
+    return version.contractName;
+}
+/**
+ * Returns the contract index for a given name (case-insensitive).
+ * @throws if not found.
+ */
+export function findContractByName(registry, name) {
+    const lower = name.toLowerCase();
+    const version = registry.versions.find((v) => v.contractName.toLowerCase() === lower);
+    if (!version)
+        throw new Error(`Contract name "${name}" not found in registry`);
+    return version.contractIndex;
+}
+/**
+ * Validates the registry for structural correctness.
+ * @throws with a descriptive message on any inconsistency.
+ */
+export function validateRegistry(registry) {
+    const byContract = new Map();
+    for (const v of registry.versions) {
+        const list = byContract.get(v.contractIndex) ?? [];
+        list.push(v);
+        byContract.set(v.contractIndex, list);
+    }
+    for (const [contractIndex, versions] of byContract) {
+        const currentVersions = versions.filter((v) => v.effectiveToEpoch === null);
+        if (currentVersions.length > 1) {
+            throw new Error(`Contract ${contractIndex} has multiple current versions (effectiveToEpoch === null)`);
+        }
+        const sorted = [...versions].sort((a, b) => a.effectiveFromEpoch - b.effectiveFromEpoch);
+        for (let i = 0; i < sorted.length - 1; i++) {
+            const a = sorted[i];
+            const b = sorted[i + 1];
+            if (a === undefined || b === undefined)
+                continue;
+            const aEnd = a.effectiveToEpoch ?? Number.POSITIVE_INFINITY;
+            if (aEnd >= b.effectiveFromEpoch) {
+                throw new Error(`Contract ${contractIndex} has overlapping epoch ranges: [${a.effectiveFromEpoch}, ${a.effectiveToEpoch}] and [${b.effectiveFromEpoch}, ${b.effectiveToEpoch}]`);
+            }
+        }
+        for (const v of versions) {
+            validateVersion(v);
+        }
+    }
+}
+function validateVersion(v) {
+    for (const call of [...v.procedures, ...v.functions]) {
+        const inputSum = call.inputFields.reduce((s, f) => s + f.byteLength, 0);
+        if (inputSum !== call.inputSize) {
+            throw new Error(`Contract ${v.contractName} ${call.kind} "${call.name}": inputSize ${call.inputSize} !== sum of inputField byteLengths ${inputSum}`);
+        }
+        const outputSum = call.outputFields.reduce((s, f) => s + f.byteLength, 0);
+        if (outputSum !== call.outputSize) {
+            throw new Error(`Contract ${v.contractName} ${call.kind} "${call.name}": outputSize ${call.outputSize} !== sum of outputField byteLengths ${outputSum}`);
+        }
+        for (const field of [...call.inputFields, ...call.outputFields]) {
+            validateField(field, v);
+        }
+    }
+}
+function validateField(field, v) {
+    if (field.type === 'array') {
+        const len = field.arrayLength ?? 0;
+        const itemLen = field.arrayItemByteLength ?? 0;
+        if (len * itemLen !== field.byteLength) {
+            throw new Error(`Contract ${v.contractName} field "${field.name}": arrayLength × arrayItemByteLength !== byteLength`);
+        }
+        if (field.arrayItemStructRef !== undefined && !(field.arrayItemStructRef in v.structs)) {
+            throw new Error(`Contract ${v.contractName} field "${field.name}": arrayItemStructRef "${field.arrayItemStructRef}" not found in structs`);
+        }
+    }
+    if (field.type === 'struct' && field.structRef !== undefined && !(field.structRef in v.structs)) {
+        throw new Error(`Contract ${v.contractName} field "${field.name}": structRef "${field.structRef}" not found in structs`);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,80 @@
+export type FieldType = 'uint8' | 'uint16' | 'uint32' | 'uint64' | 'sint8' | 'sint16' | 'sint32' | 'sint64' | 'uint128' | 'id' | 'bytes' | 'array' | 'struct';
+export interface BinaryField {
+    name: string;
+    type: FieldType;
+    /** Byte offset from start of enclosing struct. */
+    offset: number;
+    /** Total byte footprint — always authoritative. For arrays: arrayLength × arrayItemByteLength. */
+    byteLength: number;
+    description?: string;
+    arrayLength?: number;
+    arrayItemType?: FieldType;
+    arrayItemByteLength?: number;
+    arrayItemStructRef?: string;
+    structRef?: string;
+}
+export interface NamedStruct {
+    name: string;
+    fields: BinaryField[];
+    /** Sum of all field byteLengths; pre-computed. */
+    byteLength: number;
+}
+export interface ContractCallBase {
+    kind: 'procedure' | 'function';
+    /** Declaration-order ordinal, starts at 1. */
+    inputType: number;
+    name: string;
+    description?: string;
+    inputFields: BinaryField[];
+    outputFields: BinaryField[];
+    /** Sum of inputField byteLengths; 0 if no input. */
+    inputSize: number;
+    outputSize: number;
+    /** tx.amount used as invocationReward. */
+    requiresAmount?: boolean;
+    sourceRef?: string;
+}
+/** Per-epoch snapshot stored in data/epochs/{epoch}/{name}.json. No range metadata — epoch is the folder. */
+export interface ContractSnapshot {
+    contractIndex: number;
+    contractName: string;
+    /** Deterministic 60-char Qubic identity derived from contractIndex. */
+    contractAddress?: string;
+    /** Epoch this snapshot was taken at; matches the parent folder name. */
+    epoch: number;
+    coreVersion?: string;
+    coreCommit?: string;
+    structs: Record<string, NamedStruct>;
+    procedures: ContractCallBase[];
+    functions: ContractCallBase[];
+    changelog?: string;
+}
+/** Version-range entry stored in registry.json. Spans one or more epochs where ABI was identical. */
+export interface ContractAbiVersion {
+    contractIndex: number;
+    contractName: string;
+    /** Deterministic 60-char Qubic identity derived from contractIndex. */
+    contractAddress?: string;
+    effectiveFromEpoch: number;
+    /** null = currently active */
+    effectiveToEpoch: number | null;
+    coreVersion?: string;
+    coreCommit?: string;
+    structs: Record<string, NamedStruct>;
+    procedures: ContractCallBase[];
+    functions: ContractCallBase[];
+    changelog?: string;
+}
+export interface ContractRegistry {
+    schemaVersion: 1;
+    updatedAt: string;
+    /** Sorted: contractIndex ASC, effectiveFromEpoch ASC. */
+    versions: ContractAbiVersion[];
+}
+export interface AbiLookupResult {
+    version: ContractAbiVersion;
+    isCurrent: boolean;
+    /** epoch > latest known for this contract AND isCurrent=true */
+    isRegistryPossiblyStale: boolean;
+}
+//# 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":"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"}

package/dist/types.js

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

package/dist/types.js.map

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