@typeberry/lib 0.5.1 → 0.5.2-03e1aed

package/packages/jam/block-json/refine-context.js

@@ -0,0 +1,18 @@
+import { RefineContext } from "#@typeberry/block/refine-context.js";
+import { json } from "#@typeberry/json-parser";
+import { fromJson } from "./common.js";
+export const refineContextFromJson = json.object({
+    anchor: fromJson.bytes32(),
+    state_root: fromJson.bytes32(),
+    beefy_root: fromJson.bytes32(),
+    lookup_anchor: fromJson.bytes32(),
+    lookup_anchor_slot: "number",
+    prerequisites: json.array(fromJson.bytes32()),
+}, ({ anchor, state_root, beefy_root, lookup_anchor, lookup_anchor_slot, prerequisites }) => RefineContext.create({
+    anchor,
+    stateRoot: state_root,
+    beefyRoot: beefy_root,
+    lookupAnchor: lookup_anchor,
+    lookupAnchorSlot: lookup_anchor_slot,
+    prerequisites,
+}));

package/packages/jam/block-json/tickets-extrinsic.d.ts

@@ -0,0 +1,3 @@
+import { SignedTicket } from "#@typeberry/block/tickets.js";
+export declare const ticketsExtrinsicFromJson: ["array", import("@typeberry/json-parser").FromJsonWithParser<string, SignedTicket> | import("@typeberry/json-parser").FromJsonWithParser<number, SignedTicket> | import("@typeberry/json-parser").FromJsonWithParser<unknown, SignedTicket> | import("@typeberry/json-parser").ObjectFromJson<SignedTicket> | import("@typeberry/json-parser").FromJsonOptional<SignedTicket> | import("@typeberry/json-parser").Parser<unknown, SignedTicket[]>];
+//# sourceMappingURL=tickets-extrinsic.d.ts.map

package/packages/jam/block-json/tickets-extrinsic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tickets-extrinsic.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/block-json/tickets-extrinsic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAc3D,eAAO,MAAM,wBAAwB,obAAqC,CAAC"}

package/packages/jam/block-json/tickets-extrinsic.js

@@ -0,0 +1,10 @@
+import { SignedTicket } from "#@typeberry/block/tickets.js";
+import { Bytes } from "#@typeberry/bytes";
+import { BANDERSNATCH_PROOF_BYTES } from "#@typeberry/crypto/bandersnatch.js";
+import { json } from "#@typeberry/json-parser";
+import { fromJson } from "./common.js";
+const ticketEnvelopeFromJson = json.object({
+    attempt: fromJson.ticketAttempt,
+    signature: json.fromString((v) => Bytes.parseBytes(v, BANDERSNATCH_PROOF_BYTES).asOpaque()),
+}, (x) => SignedTicket.create({ attempt: x.attempt, signature: x.signature }));
+export const ticketsExtrinsicFromJson = json.array(ticketEnvelopeFromJson);

package/packages/jam/block-json/work-report.d.ts

@@ -0,0 +1,5 @@
+import { WorkPackageInfo } from "#@typeberry/block/refine-context.js";
+import { WorkReport } from "#@typeberry/block/work-report.js";
+export declare const segmentRootLookupItemFromJson: import("@typeberry/json-parser").FromJsonWithParser<unknown, WorkPackageInfo>;
+export declare const workReportFromJson: import("@typeberry/json-parser").FromJsonWithParser<unknown, WorkReport>;
+//# sourceMappingURL=work-report.d.ts.map

package/packages/jam/block-json/work-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-report.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/block-json/work-report.ts"],"names":[],"mappings":"AACA,OAAO,EAA2C,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE9G,OAAO,EAAmB,UAAU,EAAE,MAAM,iCAAiC,CAAC;AA4B9E,eAAO,MAAM,6BAA6B,+EAOzC,CAAC;AAEF,eAAO,MAAM,kBAAkB,0EAiC9B,CAAC"}

package/packages/jam/block-json/work-report.js

@@ -0,0 +1,49 @@
+import { tryAsServiceGas } from "#@typeberry/block";
+import { WorkPackageInfo } from "#@typeberry/block/refine-context.js";
+import { tryAsWorkItemsCount } from "#@typeberry/block/work-package.js";
+import { WorkPackageSpec, WorkReport } from "#@typeberry/block/work-report.js";
+import { BytesBlob } from "#@typeberry/bytes";
+import { FixedSizeArray } from "#@typeberry/collections";
+import { json } from "#@typeberry/json-parser";
+import { fromJson } from "./common.js";
+import { refineContextFromJson } from "./refine-context.js";
+import { workResultFromJson } from "./work-result.js";
+const workPackageSpecFromJson = json.object({
+    hash: fromJson.bytes32(),
+    length: "number",
+    erasure_root: fromJson.bytes32(),
+    exports_root: fromJson.bytes32(),
+    exports_count: "number",
+}, ({ hash, length, erasure_root, exports_root, exports_count }) => WorkPackageSpec.create({
+    hash,
+    length,
+    erasureRoot: erasure_root,
+    exportsRoot: exports_root,
+    exportsCount: exports_count,
+}));
+export const segmentRootLookupItemFromJson = json.object({
+    work_package_hash: fromJson.bytes32(),
+    segment_tree_root: fromJson.bytes32(),
+}, ({ work_package_hash, segment_tree_root }) => WorkPackageInfo.create({ workPackageHash: work_package_hash, segmentTreeRoot: segment_tree_root }));
+export const workReportFromJson = json.object({
+    package_spec: workPackageSpecFromJson,
+    context: refineContextFromJson,
+    core_index: "number",
+    authorizer_hash: fromJson.bytes32(),
+    auth_output: json.fromString(BytesBlob.parseBlob),
+    segment_root_lookup: json.array(segmentRootLookupItemFromJson),
+    results: json.array(workResultFromJson),
+    auth_gas_used: json.fromBigInt((x) => tryAsServiceGas(x)),
+}, ({ package_spec, context, core_index, authorizer_hash, auth_output, results, segment_root_lookup, auth_gas_used, }) => {
+    const fixedSizeResults = FixedSizeArray.new(results, tryAsWorkItemsCount(results.length));
+    return WorkReport.create({
+        workPackageSpec: package_spec,
+        context,
+        coreIndex: core_index,
+        authorizerHash: authorizer_hash,
+        authorizationOutput: auth_output,
+        segmentRootLookup: segment_root_lookup,
+        results: fixedSizeResults,
+        authorizationGasUsed: auth_gas_used,
+    });
+});

package/packages/jam/block-json/work-result.d.ts

@@ -0,0 +1,3 @@
+import { WorkResult } from "#@typeberry/block/work-result.js";
+export declare const workResultFromJson: import("@typeberry/json-parser").FromJsonWithParser<unknown, WorkResult>;
+//# sourceMappingURL=work-result.d.ts.map

package/packages/jam/block-json/work-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-result.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/block-json/work-result.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsD,UAAU,EAAE,MAAM,iCAAiC,CAAC;AA6EjH,eAAO,MAAM,kBAAkB,0EAkB9B,CAAC"}

package/packages/jam/block-json/work-result.js

@@ -0,0 +1,64 @@
+import { tryAsServiceGas } from "#@typeberry/block";
+import { WorkExecResult, WorkExecResultKind, WorkRefineLoad, WorkResult } from "#@typeberry/block/work-result.js";
+import { BytesBlob } from "#@typeberry/bytes";
+import { json } from "#@typeberry/json-parser";
+import { tryAsU32 } from "#@typeberry/numbers";
+import { fromJson } from "./common.js";
+// TODO [ToDr] Introduce fromJson.union?
+const workExecResultFromJson = json.object({
+    ok: json.optional(json.fromString(BytesBlob.parseBlob)),
+    out_of_gas: json.optional(json.fromAny(() => null)),
+    panic: json.optional(json.fromAny(() => null)),
+    bad_code: json.optional(json.fromAny(() => null)),
+    code_oversize: json.optional(json.fromAny(() => null)),
+    output_oversize: json.optional(json.fromAny(() => null)),
+}, (val) => {
+    const { ok, out_of_gas, panic, bad_code, code_oversize, output_oversize } = val;
+    if (ok !== undefined) {
+        return new WorkExecResult(tryAsU32(WorkExecResultKind.ok), ok);
+    }
+    if (out_of_gas === null) {
+        return new WorkExecResult(tryAsU32(WorkExecResultKind.outOfGas));
+    }
+    if (panic === null) {
+        return new WorkExecResult(tryAsU32(WorkExecResultKind.panic));
+    }
+    if (bad_code === null) {
+        return new WorkExecResult(tryAsU32(WorkExecResultKind.badCode));
+    }
+    if (code_oversize === null) {
+        return new WorkExecResult(tryAsU32(WorkExecResultKind.codeOversize));
+    }
+    if (output_oversize === null) {
+        return new WorkExecResult(tryAsU32(WorkExecResultKind.digestTooBig));
+    }
+    throw new Error("Invalid WorkExecResult");
+});
+const workRefineLoadFromJson = json.object({
+    gas_used: json.fromNumber((x) => tryAsServiceGas(x)),
+    imports: "number",
+    extrinsic_count: "number",
+    extrinsic_size: "number",
+    exports: "number",
+}, ({ gas_used, imports, extrinsic_count, extrinsic_size, exports }) => WorkRefineLoad.create({
+    gasUsed: tryAsServiceGas(gas_used),
+    importedSegments: tryAsU32(imports),
+    extrinsicCount: tryAsU32(extrinsic_count),
+    extrinsicSize: tryAsU32(extrinsic_size),
+    exportedSegments: tryAsU32(exports),
+}));
+export const workResultFromJson = json.object({
+    service_id: "number",
+    code_hash: fromJson.bytes32(),
+    payload_hash: fromJson.bytes32(),
+    accumulate_gas: json.fromBigInt((x) => tryAsServiceGas(x)),
+    result: workExecResultFromJson,
+    refine_load: workRefineLoadFromJson,
+}, ({ service_id, code_hash, payload_hash, accumulate_gas, result, refine_load }) => WorkResult.create({
+    serviceId: service_id,
+    codeHash: code_hash,
+    payloadHash: payload_hash,
+    gas: accumulate_gas,
+    result,
+    load: refine_load,
+}));

package/packages/jam/config/chain-spec.d.ts

@@ -0,0 +1,90 @@
+import { type U8, type U16, type U32, type U64 } from "#@typeberry/numbers";
+import { WithDebug } from "#@typeberry/utils";
+/**
+ * Estimated number of validators.
+ *
+ * NOTE: Should ONLY be used to pre-allocate some data.
+ *
+ * https://graypaper.fluffylabs.dev/#/5f542d7/418800418800
+ */
+export declare const EST_VALIDATORS = 1023;
+/**
+ * Estimated number of super majority of validators.
+ *
+ * NOTE: Should ONLY be used to pre-allocate some data.
+ */
+export declare const EST_VALIDATORS_SUPER_MAJORITY = 683;
+/**
+ * Estimated number of cores.
+ *
+ * NOTE: Should ONLY be used to pre-allocate some data.
+ *
+ * https://graypaper.fluffylabs.dev/#/5f542d7/414200414200
+ */
+export declare const EST_CORES = 341;
+/**
+ * Estimated epoch length (in time slots).
+ *
+ * NOTE: Should ONLY be used to pre-allocate some data.
+ *
+ * https://graypaper.fluffylabs.dev/#/5f542d7/414800414800
+ */
+export declare const EST_EPOCH_LENGTH = 600;
+/** `W_G`: W_P * W_E = 4104 The size of a segment in octets. */
+export declare const EC_SEGMENT_SIZE = 4104;
+/**
+ * Additional data that has to be passed to the codec to correctly parse incoming bytes.
+ */
+export declare class ChainSpec extends WithDebug {
+    /** Human-readable name of the chain spec. */
+    readonly name: string;
+    /** Number of validators. */
+    readonly validatorsCount: U16;
+    /** 1/3 of number of validators */
+    readonly thirdOfValidators: U16;
+    /** 2/3 of number of validators + 1 */
+    readonly validatorsSuperMajority: U16;
+    /** Number of cores. */
+    readonly coresCount: U16;
+    /**
+     * `D`: Period in timeslots after which an unreferenced preimage may be expunged.
+     *
+     * https://graypaper.fluffylabs.dev/#/9a08063/445800445800?v=0.6.6
+     */
+    readonly preimageExpungePeriod: U32;
+    /** Duration of a timeslot in seconds. */
+    readonly slotDuration: U16;
+    /** Length of the epoch in time slots. */
+    readonly epochLength: U32;
+    /** Length of the ticket contest in time slots. */
+    readonly contestLength: U32;
+    /** The maximum number of tickets each validator can submit. */
+    readonly ticketsPerValidator: U8;
+    /** The maximum number of tickets that can be included in a single block. */
+    readonly maxTicketsPerExtrinsic: U8;
+    /**
+     * `R`: The rotation period of validator-core assignments, in timeslots.
+     *
+     * https://graypaper.fluffylabs.dev/#/5f542d7/417f00417f00
+     */
+    readonly rotationPeriod: U16;
+    /** `W_P`: The number of erasure-coded pieces in a segment. */
+    readonly numberECPiecesPerSegment: U32;
+    /** `W_E`: The basic size of erasure-coded pieces in octets. Computed from `W_E = W_G / W_P`. */
+    readonly erasureCodedPieceSize: U32;
+    /** `G_T`: The total gas allocated across all Accumulation. */
+    readonly maxBlockGas: U64;
+    /** `G_R`: The gas allocated to invoke a work-package’s Refine logic. */
+    readonly maxRefineGas: U64;
+    /** `L`: The maximum age in timeslots of the lookup anchor. */
+    readonly maxLookupAnchorAge: U32;
+    constructor(data: Omit<ChainSpec, "validatorsSuperMajority" | "thirdOfValidators" | "erasureCodedPieceSize">);
+}
+/** Set of values for "tiny" chain as defined in JAM test vectors. */
+export declare const tinyChainSpec: ChainSpec;
+/**
+ * Set of values for "full" chain as defined in JAM test vectors.
+ * Please note that only validatorsCount and epochLength are "full", the rest is copied from "tiny".
+ */
+export declare const fullChainSpec: ChainSpec;
+//# sourceMappingURL=chain-spec.d.ts.map

package/packages/jam/config/chain-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-spec.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/config/chain-spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,EAAE,EAAE,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAClH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,MAAM,CAAC;AACjD;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,MAAM,CAAC;AAC7B;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,+DAA+D;AAC/D,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC;;GAEG;AACH,qBAAa,SAAU,SAAQ,SAAS;IACtC,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAC;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,CAAC;IAChC,sCAAsC;IACtC,QAAQ,CAAC,uBAAuB,EAAE,GAAG,CAAC;IACtC,uBAAuB;IACvB,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,CAAC;IACpC,yCAAyC;IACzC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,mBAAmB,EAAE,EAAE,CAAC;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,sBAAsB,EAAE,EAAE,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,wBAAwB,EAAE,GAAG,CAAC;IACvC,gGAAgG;IAChG,QAAQ,CAAC,qBAAqB,EAAE,GAAG,CAAC;IACpC,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,kBAAkB,EAAE,GAAG,CAAC;gBAErB,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,yBAAyB,GAAG,mBAAmB,GAAG,uBAAuB,CAAC;CAqB7G;AAED,qEAAqE;AACrE,eAAO,MAAM,aAAa,WAiBxB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa,WAexB,CAAC"}

package/packages/jam/config/chain-spec.js

@@ -0,0 +1,140 @@
+import { tryAsU8, tryAsU16, tryAsU32, tryAsU64 } from "#@typeberry/numbers";
+import { WithDebug } from "#@typeberry/utils";
+/**
+ * Estimated number of validators.
+ *
+ * NOTE: Should ONLY be used to pre-allocate some data.
+ *
+ * https://graypaper.fluffylabs.dev/#/5f542d7/418800418800
+ */
+export const EST_VALIDATORS = 1023;
+/**
+ * Estimated number of super majority of validators.
+ *
+ * NOTE: Should ONLY be used to pre-allocate some data.
+ */
+export const EST_VALIDATORS_SUPER_MAJORITY = 683;
+/**
+ * Estimated number of cores.
+ *
+ * NOTE: Should ONLY be used to pre-allocate some data.
+ *
+ * https://graypaper.fluffylabs.dev/#/5f542d7/414200414200
+ */
+export const EST_CORES = 341;
+/**
+ * Estimated epoch length (in time slots).
+ *
+ * NOTE: Should ONLY be used to pre-allocate some data.
+ *
+ * https://graypaper.fluffylabs.dev/#/5f542d7/414800414800
+ */
+export const EST_EPOCH_LENGTH = 600;
+/** `W_G`: W_P * W_E = 4104 The size of a segment in octets. */
+export const EC_SEGMENT_SIZE = 4104;
+/**
+ * Additional data that has to be passed to the codec to correctly parse incoming bytes.
+ */
+export class ChainSpec extends WithDebug {
+    /** Human-readable name of the chain spec. */
+    name;
+    /** Number of validators. */
+    validatorsCount;
+    /** 1/3 of number of validators */
+    thirdOfValidators;
+    /** 2/3 of number of validators + 1 */
+    validatorsSuperMajority;
+    /** Number of cores. */
+    coresCount;
+    /**
+     * `D`: Period in timeslots after which an unreferenced preimage may be expunged.
+     *
+     * https://graypaper.fluffylabs.dev/#/9a08063/445800445800?v=0.6.6
+     */
+    preimageExpungePeriod;
+    /** Duration of a timeslot in seconds. */
+    slotDuration;
+    /** Length of the epoch in time slots. */
+    epochLength;
+    /** Length of the ticket contest in time slots. */
+    contestLength;
+    /** The maximum number of tickets each validator can submit. */
+    ticketsPerValidator;
+    /** The maximum number of tickets that can be included in a single block. */
+    maxTicketsPerExtrinsic;
+    /**
+     * `R`: The rotation period of validator-core assignments, in timeslots.
+     *
+     * https://graypaper.fluffylabs.dev/#/5f542d7/417f00417f00
+     */
+    rotationPeriod;
+    /** `W_P`: The number of erasure-coded pieces in a segment. */
+    numberECPiecesPerSegment;
+    /** `W_E`: The basic size of erasure-coded pieces in octets. Computed from `W_E = W_G / W_P`. */
+    erasureCodedPieceSize;
+    /** `G_T`: The total gas allocated across all Accumulation. */
+    maxBlockGas;
+    /** `G_R`: The gas allocated to invoke a work-package’s Refine logic. */
+    maxRefineGas;
+    /** `L`: The maximum age in timeslots of the lookup anchor. */
+    maxLookupAnchorAge;
+    constructor(data) {
+        super();
+        this.name = data.name;
+        this.validatorsCount = data.validatorsCount;
+        this.thirdOfValidators = tryAsU16(Math.floor(data.validatorsCount / 3));
+        this.validatorsSuperMajority = tryAsU16(Math.floor(data.validatorsCount / 3) * 2 + 1);
+        this.coresCount = data.coresCount;
+        this.slotDuration = data.slotDuration;
+        this.epochLength = data.epochLength;
+        this.rotationPeriod = data.rotationPeriod;
+        this.contestLength = data.contestLength;
+        this.ticketsPerValidator = data.ticketsPerValidator;
+        this.maxTicketsPerExtrinsic = data.maxTicketsPerExtrinsic;
+        this.numberECPiecesPerSegment = data.numberECPiecesPerSegment;
+        this.preimageExpungePeriod = data.preimageExpungePeriod;
+        this.erasureCodedPieceSize = tryAsU32(EC_SEGMENT_SIZE / data.numberECPiecesPerSegment);
+        this.maxBlockGas = data.maxBlockGas;
+        this.maxRefineGas = data.maxRefineGas;
+        this.maxLookupAnchorAge = data.maxLookupAnchorAge;
+    }
+}
+/** Set of values for "tiny" chain as defined in JAM test vectors. */
+export const tinyChainSpec = new ChainSpec({
+    name: "tiny",
+    validatorsCount: tryAsU16(6),
+    coresCount: tryAsU16(2),
+    epochLength: tryAsU32(12),
+    contestLength: tryAsU32(10),
+    maxTicketsPerExtrinsic: tryAsU8(3),
+    rotationPeriod: tryAsU16(4),
+    slotDuration: tryAsU16(6),
+    ticketsPerValidator: tryAsU8(3),
+    numberECPiecesPerSegment: tryAsU32(1026),
+    // https://github.com/davxy/jam-test-vectors/tree/v0.6.6/traces#preimage-expunge-delay
+    preimageExpungePeriod: tryAsU32(32),
+    maxBlockGas: tryAsU64(20_000_000),
+    maxRefineGas: tryAsU64(1_000_000_000),
+    // https://github.com/davxy/jam-conformance/pull/47/files#diff-27e26142b3a96e407dab40d388b63d553f5d9cdb66dec58cd93e63dd434f9e45R260
+    maxLookupAnchorAge: tryAsU32(24),
+});
+/**
+ * Set of values for "full" chain as defined in JAM test vectors.
+ * Please note that only validatorsCount and epochLength are "full", the rest is copied from "tiny".
+ */
+export const fullChainSpec = new ChainSpec({
+    name: "full",
+    validatorsCount: tryAsU16(1023),
+    coresCount: tryAsU16(341),
+    epochLength: tryAsU32(600),
+    contestLength: tryAsU32(500),
+    maxTicketsPerExtrinsic: tryAsU8(16),
+    rotationPeriod: tryAsU16(10),
+    slotDuration: tryAsU16(6),
+    ticketsPerValidator: tryAsU8(2),
+    numberECPiecesPerSegment: tryAsU32(6),
+    preimageExpungePeriod: tryAsU32(19_200),
+    maxBlockGas: tryAsU64(3_500_000_000),
+    maxRefineGas: tryAsU64(5_000_000_000),
+    maxLookupAnchorAge: tryAsU32(14_400),
+});

package/packages/jam/config/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./chain-spec.js";
+export * from "./network.js";
+export * from "./pvm-backend.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/jam/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}

package/packages/jam/config/index.js

@@ -0,0 +1,3 @@
+export * from "./chain-spec.js";
+export * from "./network.js";
+export * from "./pvm-backend.js";

package/packages/jam/config/network.d.ts

@@ -0,0 +1,29 @@
+import type { Opaque } from "#@typeberry/utils";
+/** Peer id. */
+export type PeerId = Opaque<string, "peerId">;
+/** Peer connection details. */
+export type PeerAddress = {
+    /** IPV4 peer address */
+    host: string;
+    /** port number */
+    port: number;
+};
+/** Bootnode class represents a single contact point in the network */
+export declare class Bootnode implements PeerAddress {
+    /** Network address derived from the node's cryptographic public key (always 53-character?) */
+    readonly id: PeerId;
+    /** IP address (either IPv4 or IPv6) of the bootnode */
+    readonly ip: string;
+    /** Port number on which the bootnode is listening for new connections */
+    readonly port: number;
+    constructor(
+    /** Network address derived from the node's cryptographic public key (always 53-character?) */
+    id: PeerId, 
+    /** IP address (either IPv4 or IPv6) of the bootnode */
+    ip: string, 
+    /** Port number on which the bootnode is listening for new connections */
+    port: number);
+    get host(): string;
+    toString(): string;
+}
+//# sourceMappingURL=network.d.ts.map

package/packages/jam/config/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/config/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,eAAe;AACf,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAE9C,+BAA+B;AAC/B,MAAM,MAAM,WAAW,GAAG;IACxB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,sEAAsE;AACtE,qBAAa,QAAS,YAAW,WAAW;IAExC,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM;;IALrB,8FAA8F;IACrF,EAAE,EAAE,MAAM;IACnB,uDAAuD;IAC9C,EAAE,EAAE,MAAM;IACnB,yEAAyE;IAChE,IAAI,EAAE,MAAM;IAGvB,IAAI,IAAI,WAEP;IAED,QAAQ;CAGT"}

package/packages/jam/config/network.js

@@ -0,0 +1,23 @@
+/** Bootnode class represents a single contact point in the network */
+export class Bootnode {
+    id;
+    ip;
+    port;
+    constructor(
+    /** Network address derived from the node's cryptographic public key (always 53-character?) */
+    id, 
+    /** IP address (either IPv4 or IPv6) of the bootnode */
+    ip, 
+    /** Port number on which the bootnode is listening for new connections */
+    port) {
+        this.id = id;
+        this.ip = ip;
+        this.port = port;
+    }
+    get host() {
+        return this.ip;
+    }
+    toString() {
+        return `${this.id}@${this.ip}:${this.port}`;
+    }
+}

package/packages/jam/config/pvm-backend.d.ts

@@ -0,0 +1,10 @@
+/** Implemented PVM Backends names in THE SAME ORDER as enum. */
+export declare const PvmBackendNames: string[];
+/** Implemented PVM Backends to choose from. */
+export declare enum PvmBackend {
+    /** Built-in aka. Typeberry 🫐 interpreter. */
+    BuiltIn = 0,
+    /** Ananas 🍍 interpreter. */
+    Ananas = 1
+}
+//# sourceMappingURL=pvm-backend.d.ts.map

package/packages/jam/config/pvm-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pvm-backend.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/config/pvm-backend.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,eAAO,MAAM,eAAe,UAAyB,CAAC;AAEtD,+CAA+C;AAC/C,oBAAY,UAAU;IACpB,8CAA8C;IAC9C,OAAO,IAAI;IACX,6BAA6B;IAC7B,MAAM,IAAI;CACX"}

package/packages/jam/config/pvm-backend.js

@@ -0,0 +1,10 @@
+/** Implemented PVM Backends names in THE SAME ORDER as enum. */
+export const PvmBackendNames = ["built-in", "ananas"];
+/** Implemented PVM Backends to choose from. */
+export var PvmBackend;
+(function (PvmBackend) {
+    /** Built-in aka. Typeberry 🫐 interpreter. */
+    PvmBackend[PvmBackend["BuiltIn"] = 0] = "BuiltIn";
+    /** Ananas 🍍 interpreter. */
+    PvmBackend[PvmBackend["Ananas"] = 1] = "Ananas";
+})(PvmBackend || (PvmBackend = {}));

package/packages/jam/config-node/authorship.d.ts

@@ -0,0 +1,7 @@
+/** Block authorship options. */
+export declare class AuthorshipOptions {
+    static fromJson: import("@typeberry/json-parser").FromJsonWithParser<unknown, AuthorshipOptions>;
+    static new(): AuthorshipOptions;
+    private constructor();
+}
+//# sourceMappingURL=authorship.d.ts.map

package/packages/jam/config-node/authorship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorship.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/config-node/authorship.ts"],"names":[],"mappings":"AAGA,gCAAgC;AAChC,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,QAAQ,kFAA4F;IAE3G,MAAM,CAAC,GAAG;IAIV,OAAO;CACR"}

package/packages/jam/config-node/authorship.js

@@ -0,0 +1,9 @@
+import { json } from "#@typeberry/json-parser";
+/** Block authorship options. */
+export class AuthorshipOptions {
+    static fromJson = json.object({}, AuthorshipOptions.new);
+    static new() {
+        return new AuthorshipOptions();
+    }
+    constructor() { }
+}

package/packages/jam/config-node/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./jip-chain-spec.js";
+export * from "./node-config.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/jam/config-node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/config-node/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}

package/packages/jam/config-node/index.js

@@ -0,0 +1,2 @@
+export * from "./jip-chain-spec.js";
+export * from "./node-config.js";

package/packages/jam/config-node/jip-chain-spec.d.ts

@@ -0,0 +1,36 @@
+import { type Bytes, BytesBlob } from "#@typeberry/bytes";
+import { Bootnode } from "#@typeberry/config";
+import { WithDebug } from "#@typeberry/utils";
+export declare function parseBootnode(v: string): Bootnode;
+/**
+ * Configuration file for any blockchain network built on the JAM protocol
+ *
+ * Provides all the essential information that a new node
+ * needs to join, connect to others, and understand the blockchain's starting point
+ *
+ *  https://github.com/polkadot-fellows/JIPs/blob/90f809b84a9913a821437225f085cf5153870212/JIP-4.md#jip-4-chainspec-file
+ */
+export declare class JipChainSpec extends WithDebug {
+    /** Optional list of initial contact points for a new node joining the network */
+    readonly bootnodes?: Bootnode[];
+    /** Human-readable identifier for the network */
+    readonly id: string;
+    /** Contains the serialized header of the first `block 0` */
+    readonly genesisHeader: BytesBlob;
+    /**
+     * Initial state of the blockchain at the moment of its creation
+     *
+     * - `key`: is 31-byte object identifier
+     * - `value`: is the data stored at this location, as BytesBlob of any length.
+     */
+    readonly genesisState: Map<Bytes<31>, BytesBlob>;
+    static fromJson: import("@typeberry/json-parser").FromJsonWithParser<unknown, JipChainSpec>;
+    static create({ bootnodes, id, genesisHeader, genesisState, }: {
+        bootnodes?: Bootnode[];
+        id?: string;
+        genesisHeader?: BytesBlob;
+        genesisState?: Map<Bytes<31>, BytesBlob>;
+    }): JipChainSpec;
+    private constructor();
+}
+//# sourceMappingURL=jip-chain-spec.d.ts.map

package/packages/jam/config-node/jip-chain-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jip-chain-spec.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/config-node/jip-chain-spec.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,OAAO,EAAgB,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE3D,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,CAgBjD;AAED;;;;;;;GAOG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,iFAAiF;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IAChC,gDAAgD;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;IAEjD,MAAM,CAAC,QAAQ,6EAcb;IAEF,MAAM,CAAC,MAAM,CAAC,EACZ,SAAc,EACd,EAAO,EACP,aAAiC,EACjC,YAAwB,GACzB,EAAE;QACD,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;QACvB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,aAAa,CAAC,EAAE,SAAS,CAAC;QAC1B,YAAY,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;KAC1C;IAID,OAAO;CAQR"}