@lodestar/types 1.39.0-dev.c151a164f2 → 1.39.0-dev.c630c55067

package/lib/index.d.ts

@@ -3,8 +3,10 @@ import type { SSZTypesFor } from "./sszTypes.js";
 import * as ssz from "./sszTypes.js";
 import { sszTypesFor } from "./sszTypes.js";
 export { sszTypesFor, SSZTypesFor, ssz };
+export * from "./utils/array.js";
 export * from "./utils/container.js";
 export { ExecutionAddressType } from "./utils/executionAddress.js";
+export * as rewards from "./utils/rewards.js";
 export { StringType, stringType } from "./utils/stringType.js";
 export * from "./utils/typeguards.js";
 export * from "./utils/validatorStatus.js";

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAE3B,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAC,WAAW,EAAE,WAAW,EAAE,GAAG,EAAC,CAAC;AAGvC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AAEjE,OAAO,EAAC,UAAU,EAAE,UAAU,EAAC,MAAM,uBAAuB,CAAC;AAE7D,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAE3B,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAC,WAAW,EAAE,WAAW,EAAE,GAAG,EAAC,CAAC;AAEvC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAC,UAAU,EAAE,UAAU,EAAC,MAAM,uBAAuB,CAAC;AAE7D,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC"}

package/lib/index.js

@@ -2,9 +2,11 @@ export * from "./types.js";
 import * as ssz from "./sszTypes.js";
 import { sszTypesFor } from "./sszTypes.js";
 export { sszTypesFor, ssz };
+export * from "./utils/array.js";
 // Container utils
 export * from "./utils/container.js";
 export { ExecutionAddressType } from "./utils/executionAddress.js";
+export * as rewards from "./utils/rewards.js";
 // String type
 export { StringType, stringType } from "./utils/stringType.js";
 // Typeguards

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAG3B,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAC,WAAW,EAAe,GAAG,EAAC,CAAC;AAEvC,kBAAkB;AAClB,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AACjE,cAAc;AACd,OAAO,EAAC,UAAU,EAAE,UAAU,EAAC,MAAM,uBAAuB,CAAC;AAC7D,aAAa;AACb,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAG3B,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAC,WAAW,EAAe,GAAG,EAAC,CAAC;AAEvC,cAAc,kBAAkB,CAAC;AACjC,kBAAkB;AAClB,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,cAAc;AACd,OAAO,EAAC,UAAU,EAAE,UAAU,EAAC,MAAM,uBAAuB,CAAC;AAC7D,aAAa;AACb,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC"}

package/lib/utils/array.d.ts

@@ -0,0 +1,3 @@
+import { ArrayType, Type } from "@chainsafe/ssz";
+export declare function ArrayOf<T>(elementType: Type<T>, limit?: number): ArrayType<Type<T>, unknown, unknown>;
+//# sourceMappingURL=array.d.ts.map

package/lib/utils/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/utils/array.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAoC,IAAI,EAA+B,MAAM,gBAAgB,CAAC;AAE/G,wBAAgB,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,SAAW,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAQvG"}

package/lib/utils/array.js

@@ -0,0 +1,11 @@
+import { ListBasicType, ListCompositeType, isBasicType, isCompositeType } from "@chainsafe/ssz";
+export function ArrayOf(elementType, limit = Infinity) {
+    if (isCompositeType(elementType)) {
+        return new ListCompositeType(elementType, limit);
+    }
+    if (isBasicType(elementType)) {
+        return new ListBasicType(elementType, limit);
+    }
+    throw Error(`Unknown type ${elementType.typeName}`);
+}
+//# sourceMappingURL=array.js.map

package/lib/utils/array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../src/utils/array.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,aAAa,EAAE,iBAAiB,EAAQ,WAAW,EAAE,eAAe,EAAC,MAAM,gBAAgB,CAAC;AAE/G,MAAM,UAAU,OAAO,CAAI,WAAoB,EAAE,KAAK,GAAG,QAAQ;IAC/D,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAoD,CAAC;IACtG,CAAC;IACD,IAAI,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,aAAa,CAAC,WAAW,EAAE,KAAK,CAAoD,CAAC;IAClG,CAAC;IACD,MAAM,KAAK,CAAC,gBAAgB,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;AACtD,CAAC"}

package/lib/utils/rewards.d.ts

@@ -0,0 +1,111 @@
+import { ContainerType, ValueOf } from "@chainsafe/ssz";
+export declare const BlockRewardsType: ContainerType<{
+    /** Proposer of the block, the proposer index who receives these rewards */
+    proposerIndex: import("@chainsafe/ssz").UintNumberType;
+    /** Total block reward, equal to attestations + sync_aggregate + proposer_slashings + attester_slashings */
+    total: import("@chainsafe/ssz").UintNumberType;
+    /** Block reward component due to included attestations */
+    attestations: import("@chainsafe/ssz").UintNumberType;
+    /** Block reward component due to included sync_aggregate */
+    syncAggregate: import("@chainsafe/ssz").UintNumberType;
+    /** Block reward component due to included proposer_slashings */
+    proposerSlashings: import("@chainsafe/ssz").UintNumberType;
+    /** Block reward component due to included attester_slashings */
+    attesterSlashings: import("@chainsafe/ssz").UintNumberType;
+}>;
+export declare const AttestationsRewardType: ContainerType<{
+    /** Reward for head vote. Could be negative to indicate penalty */
+    head: import("@chainsafe/ssz").UintNumberType;
+    /** Reward for target vote. Could be negative to indicate penalty */
+    target: import("@chainsafe/ssz").UintNumberType;
+    /** Reward for source vote. Could be negative to indicate penalty */
+    source: import("@chainsafe/ssz").UintNumberType;
+    /** Inclusion delay reward (phase0 only) */
+    inclusionDelay: import("@chainsafe/ssz").UintNumberType;
+    /** Inactivity penalty. Should be a negative number to indicate penalty */
+    inactivity: import("@chainsafe/ssz").UintNumberType;
+}>;
+export declare const IdealAttestationsRewardsType: ContainerType<{
+    effectiveBalance: import("@chainsafe/ssz").UintNumberType;
+    /** Reward for head vote. Could be negative to indicate penalty */
+    head: import("@chainsafe/ssz").UintNumberType;
+    /** Reward for target vote. Could be negative to indicate penalty */
+    target: import("@chainsafe/ssz").UintNumberType;
+    /** Reward for source vote. Could be negative to indicate penalty */
+    source: import("@chainsafe/ssz").UintNumberType;
+    /** Inclusion delay reward (phase0 only) */
+    inclusionDelay: import("@chainsafe/ssz").UintNumberType;
+    /** Inactivity penalty. Should be a negative number to indicate penalty */
+    inactivity: import("@chainsafe/ssz").UintNumberType;
+}>;
+export declare const TotalAttestationsRewardsType: ContainerType<{
+    validatorIndex: import("@chainsafe/ssz").UintNumberType;
+    /** Reward for head vote. Could be negative to indicate penalty */
+    head: import("@chainsafe/ssz").UintNumberType;
+    /** Reward for target vote. Could be negative to indicate penalty */
+    target: import("@chainsafe/ssz").UintNumberType;
+    /** Reward for source vote. Could be negative to indicate penalty */
+    source: import("@chainsafe/ssz").UintNumberType;
+    /** Inclusion delay reward (phase0 only) */
+    inclusionDelay: import("@chainsafe/ssz").UintNumberType;
+    /** Inactivity penalty. Should be a negative number to indicate penalty */
+    inactivity: import("@chainsafe/ssz").UintNumberType;
+}>;
+export declare const AttestationsRewardsType: ContainerType<{
+    idealRewards: import("@chainsafe/ssz").ArrayType<import("@chainsafe/ssz").Type<import("@chainsafe/ssz").ValueOfFields<{
+        effectiveBalance: import("@chainsafe/ssz").UintNumberType;
+        /** Reward for head vote. Could be negative to indicate penalty */
+        head: import("@chainsafe/ssz").UintNumberType;
+        /** Reward for target vote. Could be negative to indicate penalty */
+        target: import("@chainsafe/ssz").UintNumberType;
+        /** Reward for source vote. Could be negative to indicate penalty */
+        source: import("@chainsafe/ssz").UintNumberType;
+        /** Inclusion delay reward (phase0 only) */
+        inclusionDelay: import("@chainsafe/ssz").UintNumberType;
+        /** Inactivity penalty. Should be a negative number to indicate penalty */
+        inactivity: import("@chainsafe/ssz").UintNumberType;
+    }>>, unknown, unknown>;
+    totalRewards: import("@chainsafe/ssz").ArrayType<import("@chainsafe/ssz").Type<import("@chainsafe/ssz").ValueOfFields<{
+        validatorIndex: import("@chainsafe/ssz").UintNumberType;
+        /** Reward for head vote. Could be negative to indicate penalty */
+        head: import("@chainsafe/ssz").UintNumberType;
+        /** Reward for target vote. Could be negative to indicate penalty */
+        target: import("@chainsafe/ssz").UintNumberType;
+        /** Reward for source vote. Could be negative to indicate penalty */
+        source: import("@chainsafe/ssz").UintNumberType;
+        /** Inclusion delay reward (phase0 only) */
+        inclusionDelay: import("@chainsafe/ssz").UintNumberType;
+        /** Inactivity penalty. Should be a negative number to indicate penalty */
+        inactivity: import("@chainsafe/ssz").UintNumberType;
+    }>>, unknown, unknown>;
+}>;
+export declare const SyncCommitteeRewardsType: import("@chainsafe/ssz").ArrayType<import("@chainsafe/ssz").Type<import("@chainsafe/ssz").ValueOfFields<{
+    validatorIndex: import("@chainsafe/ssz").UintNumberType;
+    reward: import("@chainsafe/ssz").UintNumberType;
+}>>, unknown, unknown>;
+/**
+ * Rewards info for a single block. Every reward value is in Gwei.
+ */
+export type BlockRewards = ValueOf<typeof BlockRewardsType>;
+/**
+ * Rewards for a single set of (ideal or actual depending on usage) attestations. Reward value is in Gwei
+ */
+export type AttestationsReward = ValueOf<typeof AttestationsRewardType>;
+/**
+ * Rewards info for ideal attestations ie. Maximum rewards could be earned by making timely head, target and source vote.
+ * `effectiveBalance` is in Gwei
+ */
+export type IdealAttestationsReward = ValueOf<typeof IdealAttestationsRewardsType>;
+/**
+ * Rewards info for actual attestations
+ */
+export type TotalAttestationsReward = ValueOf<typeof TotalAttestationsRewardsType>;
+export type AttestationsRewards = ValueOf<typeof AttestationsRewardsType>;
+/**
+ * Rewards info for sync committee participation. Every reward value is in Gwei.
+ * Note: In the case that block proposer is present in `SyncCommitteeRewards`, the reward value only reflects rewards for
+ * participating in sync committee. Please refer to `BlockRewards.syncAggregate` for rewards of proposer including sync committee
+ * outputs into their block
+ */
+export type SyncCommitteeRewards = ValueOf<typeof SyncCommitteeRewardsType>;
+//# sourceMappingURL=rewards.d.ts.map

package/lib/utils/rewards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewards.d.ts","sourceRoot":"","sources":["../../src/utils/rewards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAE,OAAO,EAAC,MAAM,gBAAgB,CAAC;AAItD,eAAO,MAAM,gBAAgB;IAEzB,2EAA2E;;IAE3E,2GAA2G;;IAE3G,0DAA0D;;IAE1D,4DAA4D;;IAE5D,gEAAgE;;IAEhE,gEAAgE;;EAInE,CAAC;AAEF,eAAO,MAAM,sBAAsB;IAE/B,kEAAkE;;IAElE,oEAAoE;;IAEpE,oEAAoE;;IAEpE,2CAA2C;;IAE3C,0EAA0E;;EAI7E,CAAC;AAEF,eAAO,MAAM,4BAA4B;;IAdrC,kEAAkE;;IAElE,oEAAoE;;IAEpE,oEAAoE;;IAEpE,2CAA2C;;IAE3C,0EAA0E;;EAY7E,CAAC;AAEF,eAAO,MAAM,4BAA4B;;IAtBrC,kEAAkE;;IAElE,oEAAoE;;IAEpE,oEAAoE;;IAEpE,2CAA2C;;IAE3C,0EAA0E;;EAoB7E,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;QA9BhC,kEAAkE;;QAElE,oEAAoE;;QAEpE,oEAAoE;;QAEpE,2CAA2C;;QAE3C,0EAA0E;;;;;QAR1E,kEAAkE;;QAElE,oEAAoE;;QAEpE,oEAAoE;;QAEpE,2CAA2C;;QAE3C,0EAA0E;;;EA4B7E,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;sBAQpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAExE;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEnF,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/lib/utils/rewards.js

@@ -0,0 +1,46 @@
+import { ContainerType } from "@chainsafe/ssz";
+import { UintNum64, ValidatorIndex } from "../sszTypes.js";
+import { ArrayOf } from "./array.js";
+export const BlockRewardsType = new ContainerType({
+    /** Proposer of the block, the proposer index who receives these rewards */
+    proposerIndex: ValidatorIndex,
+    /** Total block reward, equal to attestations + sync_aggregate + proposer_slashings + attester_slashings */
+    total: UintNum64,
+    /** Block reward component due to included attestations */
+    attestations: UintNum64,
+    /** Block reward component due to included sync_aggregate */
+    syncAggregate: UintNum64,
+    /** Block reward component due to included proposer_slashings */
+    proposerSlashings: UintNum64,
+    /** Block reward component due to included attester_slashings */
+    attesterSlashings: UintNum64,
+}, { jsonCase: "eth2" });
+export const AttestationsRewardType = new ContainerType({
+    /** Reward for head vote. Could be negative to indicate penalty */
+    head: UintNum64,
+    /** Reward for target vote. Could be negative to indicate penalty */
+    target: UintNum64,
+    /** Reward for source vote. Could be negative to indicate penalty */
+    source: UintNum64,
+    /** Inclusion delay reward (phase0 only) */
+    inclusionDelay: UintNum64,
+    /** Inactivity penalty. Should be a negative number to indicate penalty */
+    inactivity: UintNum64,
+}, { jsonCase: "eth2" });
+export const IdealAttestationsRewardsType = new ContainerType({
+    ...AttestationsRewardType.fields,
+    effectiveBalance: UintNum64,
+}, { jsonCase: "eth2" });
+export const TotalAttestationsRewardsType = new ContainerType({
+    ...AttestationsRewardType.fields,
+    validatorIndex: ValidatorIndex,
+}, { jsonCase: "eth2" });
+export const AttestationsRewardsType = new ContainerType({
+    idealRewards: ArrayOf(IdealAttestationsRewardsType),
+    totalRewards: ArrayOf(TotalAttestationsRewardsType),
+}, { jsonCase: "eth2" });
+export const SyncCommitteeRewardsType = ArrayOf(new ContainerType({
+    validatorIndex: ValidatorIndex,
+    reward: UintNum64,
+}, { jsonCase: "eth2" }));
+//# sourceMappingURL=rewards.js.map

package/lib/utils/rewards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewards.js","sourceRoot":"","sources":["../../src/utils/rewards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAU,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAC,SAAS,EAAE,cAAc,EAAC,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAC,OAAO,EAAC,MAAM,YAAY,CAAC;AAEnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,aAAa,CAC/C;IACE,2EAA2E;IAC3E,aAAa,EAAE,cAAc;IAC7B,2GAA2G;IAC3G,KAAK,EAAE,SAAS;IAChB,0DAA0D;IAC1D,YAAY,EAAE,SAAS;IACvB,4DAA4D;IAC5D,aAAa,EAAE,SAAS;IACxB,gEAAgE;IAChE,iBAAiB,EAAE,SAAS;IAC5B,gEAAgE;IAChE,iBAAiB,EAAE,SAAS;CAC7B,EACD,EAAC,QAAQ,EAAE,MAAM,EAAC,CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,aAAa,CACrD;IACE,kEAAkE;IAClE,IAAI,EAAE,SAAS;IACf,oEAAoE;IACpE,MAAM,EAAE,SAAS;IACjB,oEAAoE;IACpE,MAAM,EAAE,SAAS;IACjB,2CAA2C;IAC3C,cAAc,EAAE,SAAS;IACzB,0EAA0E;IAC1E,UAAU,EAAE,SAAS;CACtB,EACD,EAAC,QAAQ,EAAE,MAAM,EAAC,CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,aAAa,CAC3D;IACE,GAAG,sBAAsB,CAAC,MAAM;IAChC,gBAAgB,EAAE,SAAS;CAC5B,EACD,EAAC,QAAQ,EAAE,MAAM,EAAC,CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,aAAa,CAC3D;IACE,GAAG,sBAAsB,CAAC,MAAM;IAChC,cAAc,EAAE,cAAc;CAC/B,EACD,EAAC,QAAQ,EAAE,MAAM,EAAC,CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,aAAa,CACtD;IACE,YAAY,EAAE,OAAO,CAAC,4BAA4B,CAAC;IACnD,YAAY,EAAE,OAAO,CAAC,4BAA4B,CAAC;CACpD,EACD,EAAC,QAAQ,EAAE,MAAM,EAAC,CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAC7C,IAAI,aAAa,CACf;IACE,cAAc,EAAE,cAAc;IAC9B,MAAM,EAAE,SAAS;CAClB,EACD,EAAC,QAAQ,EAAE,MAAM,EAAC,CACnB,CACF,CAAC"}

package/package.json

@@ -11,7 +11,7 @@
   "bugs": {
     "url": "https://github.com/ChainSafe/lodestar/issues"
   },
-  "version": "1.39.0-dev.c151a164f2",
+  "version": "1.39.0-dev.c630c55067",
   "type": "module",
   "exports": {
     ".": {
@@ -77,7 +77,7 @@
   "types": "lib/index.d.ts",
   "dependencies": {
     "@chainsafe/ssz": "^1.2.2",
-    "@lodestar/params": "1.39.0-dev.c151a164f2",
+    "@lodestar/params": "1.39.0-dev.c630c55067",
     "ethereum-cryptography": "^2.0.0"
   },
   "keywords": [
@@ -86,5 +86,5 @@
     "beacon",
     "blockchain"
   ],
-  "gitHead": "754677d50463b1608d590c4d1b10076b3000655c"
+  "gitHead": "ead055ee9d3179f198a25ba5c984e8509dea31d7"
 }

package/src/index.ts

@@ -5,9 +5,11 @@ import * as ssz from "./sszTypes.js";
 import {sszTypesFor} from "./sszTypes.js";
 export {sszTypesFor, SSZTypesFor, ssz};
 
+export * from "./utils/array.js";
 // Container utils
 export * from "./utils/container.js";
 export {ExecutionAddressType} from "./utils/executionAddress.js";
+export * as rewards from "./utils/rewards.js";
 // String type
 export {StringType, stringType} from "./utils/stringType.js";
 // Typeguards

package/src/utils/array.ts

@@ -0,0 +1,11 @@
+import {ArrayType, ListBasicType, ListCompositeType, Type, isBasicType, isCompositeType} from "@chainsafe/ssz";
+
+export function ArrayOf<T>(elementType: Type<T>, limit = Infinity): ArrayType<Type<T>, unknown, unknown> {
+  if (isCompositeType(elementType)) {
+    return new ListCompositeType(elementType, limit) as unknown as ArrayType<Type<T>, unknown, unknown>;
+  }
+  if (isBasicType(elementType)) {
+    return new ListBasicType(elementType, limit) as unknown as ArrayType<Type<T>, unknown, unknown>;
+  }
+  throw Error(`Unknown type ${elementType.typeName}`);
+}

package/src/utils/rewards.ts

@@ -0,0 +1,102 @@
+import {ContainerType, ValueOf} from "@chainsafe/ssz";
+import {UintNum64, ValidatorIndex} from "../sszTypes.js";
+import {ArrayOf} from "./array.js";
+
+export const BlockRewardsType = new ContainerType(
+  {
+    /** Proposer of the block, the proposer index who receives these rewards */
+    proposerIndex: ValidatorIndex,
+    /** Total block reward, equal to attestations + sync_aggregate + proposer_slashings + attester_slashings */
+    total: UintNum64,
+    /** Block reward component due to included attestations */
+    attestations: UintNum64,
+    /** Block reward component due to included sync_aggregate */
+    syncAggregate: UintNum64,
+    /** Block reward component due to included proposer_slashings */
+    proposerSlashings: UintNum64,
+    /** Block reward component due to included attester_slashings */
+    attesterSlashings: UintNum64,
+  },
+  {jsonCase: "eth2"}
+);
+
+export const AttestationsRewardType = new ContainerType(
+  {
+    /** Reward for head vote. Could be negative to indicate penalty */
+    head: UintNum64,
+    /** Reward for target vote. Could be negative to indicate penalty */
+    target: UintNum64,
+    /** Reward for source vote. Could be negative to indicate penalty */
+    source: UintNum64,
+    /** Inclusion delay reward (phase0 only) */
+    inclusionDelay: UintNum64,
+    /** Inactivity penalty. Should be a negative number to indicate penalty */
+    inactivity: UintNum64,
+  },
+  {jsonCase: "eth2"}
+);
+
+export const IdealAttestationsRewardsType = new ContainerType(
+  {
+    ...AttestationsRewardType.fields,
+    effectiveBalance: UintNum64,
+  },
+  {jsonCase: "eth2"}
+);
+
+export const TotalAttestationsRewardsType = new ContainerType(
+  {
+    ...AttestationsRewardType.fields,
+    validatorIndex: ValidatorIndex,
+  },
+  {jsonCase: "eth2"}
+);
+
+export const AttestationsRewardsType = new ContainerType(
+  {
+    idealRewards: ArrayOf(IdealAttestationsRewardsType),
+    totalRewards: ArrayOf(TotalAttestationsRewardsType),
+  },
+  {jsonCase: "eth2"}
+);
+
+export const SyncCommitteeRewardsType = ArrayOf(
+  new ContainerType(
+    {
+      validatorIndex: ValidatorIndex,
+      reward: UintNum64,
+    },
+    {jsonCase: "eth2"}
+  )
+);
+
+/**
+ * Rewards info for a single block. Every reward value is in Gwei.
+ */
+export type BlockRewards = ValueOf<typeof BlockRewardsType>;
+
+/**
+ * Rewards for a single set of (ideal or actual depending on usage) attestations. Reward value is in Gwei
+ */
+export type AttestationsReward = ValueOf<typeof AttestationsRewardType>;
+
+/**
+ * Rewards info for ideal attestations ie. Maximum rewards could be earned by making timely head, target and source vote.
+ * `effectiveBalance` is in Gwei
+ */
+export type IdealAttestationsReward = ValueOf<typeof IdealAttestationsRewardsType>;
+
+/**
+ * Rewards info for actual attestations
+ */
+export type TotalAttestationsReward = ValueOf<typeof TotalAttestationsRewardsType>;
+
+export type AttestationsRewards = ValueOf<typeof AttestationsRewardsType>;
+
+/**
+ * Rewards info for sync committee participation. Every reward value is in Gwei.
+ * Note: In the case that block proposer is present in `SyncCommitteeRewards`, the reward value only reflects rewards for
+ * participating in sync committee. Please refer to `BlockRewards.syncAggregate` for rewards of proposer including sync committee
+ * outputs into their block
+ */
+export type SyncCommitteeRewards = ValueOf<typeof SyncCommitteeRewardsType>;