🌱 Add randomModule API

- isSeedRevealValid
- getRandomBytes

framework/src/modules/random/api.ts

@@ -12,6 +12,40 @@
  * Removal or modification of this copyright notice is prohibited.
  */
 
+import { ImmutableAPIContext } from '../../node/state_machine';
 import { BaseAPI } from '../base_api';
+import { EMPTY_KEY } from '../validators/constants';
+import { STORE_PREFIX_RANDOM } from './constants';
+import { seedRevealSchema } from './schemas';
+import { ValidatorReveals } from './types';
+import { isSeedRevealValidUtil, randomBytesUtil } from './utils';
 
-export class RandomAPI extends BaseAPI {}
+export class RandomAPI extends BaseAPI {
+	public async isSeedRevealValid(
+		apiContext: ImmutableAPIContext,
+		generatorAddress: Buffer,
+		seedReveal: Buffer,
+	): Promise<boolean> {
+		const randomDataStore = apiContext.getStore(this.moduleID, STORE_PREFIX_RANDOM);
+		const { validatorReveals } = await randomDataStore.getWithSchema<ValidatorReveals>(
+			EMPTY_KEY,
+			seedRevealSchema,
+		);
+
+		return isSeedRevealValidUtil(generatorAddress, seedReveal, validatorReveals);
+	}
+
+	public async getRandomBytes(
+		apiContext: ImmutableAPIContext,
+		height: number,
+		numberOfSeeds: number,
+	): Promise<Buffer> {
+		const randomDataStore = apiContext.getStore(this.moduleID, STORE_PREFIX_RANDOM);
+		const { validatorReveals } = await randomDataStore.getWithSchema<ValidatorReveals>(
+			EMPTY_KEY,
+			seedRevealSchema,
+		);
+
+		return randomBytesUtil(height, numberOfSeeds, validatorReveals);
+	}
+}

framework/src/modules/random/constants.ts

@@ -16,3 +16,5 @@ export const DEFAULT_MAX_LENGTH_REVEALS = 206;
 export const STORE_PREFIX_RANDOM = 0x0000;
 export const STORE_PREFIX_REGISTERED_HASH_ONION = Buffer.from('00', 'hex');
 export const STORE_PREFIX_USED_HASH_ONION = Buffer.from('01', 'hex');
+export const RANDOM_SEED_BYTE_SIZE = 8;
+export const EMPTY_KEY = Buffer.alloc(0);

framework/src/modules/random/schemas.ts

@@ -54,8 +54,8 @@ export const seedRevealSchema = {
 				required: ['generatorAddress', 'seedReveal', 'height', 'valid'],
 			},
 		},
-		required: ['validatorReveals'],
 	},
+	required: ['validatorReveals'],
 };
 
 export const blockHeaderAssetRandomModule = {

framework/src/modules/random/types.ts

@@ -48,3 +48,14 @@ export interface GeneratorConfig {
 	readonly defaultPassword?: string;
 	readonly waitThreshold: number;
 }
+
+export interface ValidatorSeedReveal {
+	generatorAddress: Buffer;
+	seedReveal: Buffer;
+	height: number;
+	valid: boolean;
+}
+
+export interface ValidatorReveals {
+	validatorReveals: ValidatorSeedReveal[];
+}