@aztec/foundation 0.0.1-commit.8c0b8ff → 0.0.1-commit.8cb2d04d8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dest/branded-types/buffer32_hash.d.ts +24 -0
- package/dest/branded-types/buffer32_hash.d.ts.map +1 -0
- package/dest/branded-types/buffer32_hash.js +19 -0
- package/dest/branded-types/checkpoint_number.d.ts +4 -1
- package/dest/branded-types/checkpoint_number.d.ts.map +1 -1
- package/dest/branded-types/checkpoint_number.js +3 -0
- package/dest/branded-types/index.d.ts +2 -1
- package/dest/branded-types/index.d.ts.map +1 -1
- package/dest/branded-types/index.js +1 -0
- package/dest/buffer/buffer16.d.ts +3 -1
- package/dest/buffer/buffer16.d.ts.map +1 -1
- package/dest/buffer/buffer32.d.ts +28 -61
- package/dest/buffer/buffer32.d.ts.map +1 -1
- package/dest/buffer/buffer32.js +26 -60
- package/dest/collection/index.d.ts +2 -1
- package/dest/collection/index.d.ts.map +1 -1
- package/dest/collection/index.js +1 -0
- package/dest/collection/lru_set.d.ts +35 -0
- package/dest/collection/lru_set.d.ts.map +1 -0
- package/dest/collection/lru_set.js +95 -0
- package/dest/config/env_var.d.ts +2 -2
- package/dest/config/env_var.d.ts.map +1 -1
- package/dest/config/index.d.ts +48 -30
- package/dest/config/index.d.ts.map +1 -1
- package/dest/config/index.js +21 -30
- package/dest/config/network_config.d.ts +6 -6
- package/dest/config/network_config.js +2 -2
- package/dest/config/network_name.d.ts +2 -2
- package/dest/config/network_name.d.ts.map +1 -1
- package/dest/config/network_name.js +2 -0
- package/dest/crypto/aes128/index.d.ts +2 -1
- package/dest/crypto/aes128/index.d.ts.map +1 -1
- package/dest/crypto/aes128/index.js +11 -2
- package/dest/crypto/bls/bn254_keystore.d.ts +1 -10
- package/dest/crypto/bls/bn254_keystore.d.ts.map +1 -1
- package/dest/crypto/bls/bn254_keystore.js +0 -17
- package/dest/curves/bls12/field.d.ts +1 -1
- package/dest/curves/bls12/field.d.ts.map +1 -1
- package/dest/curves/bls12/field.js +0 -5
- package/dest/curves/bn254/field.d.ts +17 -16
- package/dest/curves/bn254/field.d.ts.map +1 -1
- package/dest/curves/bn254/field.js +18 -13
- package/dest/eth-address/index.d.ts +1 -1
- package/dest/eth-address/index.d.ts.map +1 -1
- package/dest/eth-address/index.js +0 -3
- package/dest/fifo/fifo_frame_reader.d.ts +41 -0
- package/dest/fifo/fifo_frame_reader.d.ts.map +1 -0
- package/dest/fifo/fifo_frame_reader.js +74 -0
- package/dest/fifo/index.d.ts +2 -0
- package/dest/fifo/index.d.ts.map +1 -0
- package/dest/fifo/index.js +1 -0
- package/dest/jest/setup.js +24 -0
- package/dest/json-rpc/client/fetch.d.ts +1 -1
- package/dest/json-rpc/client/fetch.d.ts.map +1 -1
- package/dest/json-rpc/client/fetch.js +4 -3
- package/dest/json-rpc/client/undici.d.ts +1 -1
- package/dest/json-rpc/client/undici.d.ts.map +1 -1
- package/dest/json-rpc/client/undici.js +5 -3
- package/dest/log/pino-logger.d.ts +1 -1
- package/dest/log/pino-logger.d.ts.map +1 -1
- package/dest/log/pino-logger.js +17 -2
- package/dest/queue/batch_queue.d.ts +1 -1
- package/dest/queue/batch_queue.d.ts.map +1 -1
- package/dest/queue/batch_queue.js +1 -0
- package/dest/retry/index.d.ts +12 -1
- package/dest/retry/index.d.ts.map +1 -1
- package/dest/retry/index.js +21 -0
- package/dest/serialize/buffer_reader.d.ts +7 -20
- package/dest/serialize/buffer_reader.d.ts.map +1 -1
- package/dest/serialize/buffer_reader.js +5 -18
- package/dest/serialize/field_reader.d.ts +5 -13
- package/dest/serialize/field_reader.d.ts.map +1 -1
- package/dest/serialize/field_reader.js +0 -13
- package/dest/sleep/index.d.ts +2 -1
- package/dest/sleep/index.d.ts.map +1 -1
- package/dest/sleep/index.js +10 -1
- package/dest/string/index.js +1 -1
- package/dest/timer/date.d.ts +3 -1
- package/dest/timer/date.d.ts.map +1 -1
- package/dest/timer/date.js +4 -0
- package/dest/transport/dispatch/create_dispatch_proxy.d.ts +11 -2
- package/dest/transport/dispatch/create_dispatch_proxy.d.ts.map +1 -1
- package/dest/transport/index.d.ts +1 -2
- package/dest/transport/index.d.ts.map +1 -1
- package/dest/transport/index.js +0 -1
- package/dest/trees/balanced_merkle_tree_root.d.ts +2 -3
- package/dest/trees/balanced_merkle_tree_root.d.ts.map +1 -1
- package/dest/trees/balanced_merkle_tree_root.js +2 -3
- package/dest/trees/hasher.d.ts +3 -2
- package/dest/trees/hasher.d.ts.map +1 -1
- package/dest/trees/hasher.js +5 -5
- package/dest/trees/indexed_merkle_tree_calculator.d.ts +1 -1
- package/dest/trees/indexed_merkle_tree_calculator.d.ts.map +1 -1
- package/dest/trees/indexed_merkle_tree_calculator.js +5 -1
- package/dest/trees/merkle_tree_calculator.d.ts +4 -2
- package/dest/trees/merkle_tree_calculator.d.ts.map +1 -1
- package/dest/trees/merkle_tree_calculator.js +1 -5
- package/dest/trees/sibling_path.d.ts +2 -2
- package/dest/trees/sibling_path.d.ts.map +1 -1
- package/dest/trees/sibling_path.js +1 -5
- package/dest/trees/unbalanced_merkle_tree_root.d.ts +2 -3
- package/dest/trees/unbalanced_merkle_tree_root.d.ts.map +1 -1
- package/dest/trees/unbalanced_merkle_tree_root.js +2 -3
- package/package.json +3 -2
- package/src/branded-types/buffer32_hash.ts +42 -0
- package/src/branded-types/checkpoint_number.ts +5 -0
- package/src/branded-types/index.ts +1 -0
- package/src/buffer/buffer16.ts +3 -0
- package/src/buffer/buffer32.ts +36 -65
- package/src/collection/index.ts +1 -0
- package/src/collection/lru_set.ts +115 -0
- package/src/config/env_var.ts +12 -7
- package/src/config/index.ts +96 -84
- package/src/config/network_config.ts +1 -1
- package/src/config/network_name.ts +4 -1
- package/src/crypto/aes128/index.ts +11 -2
- package/src/crypto/bls/bn254_keystore.ts +0 -23
- package/src/curves/bls12/field.ts +0 -7
- package/src/curves/bn254/field.ts +25 -31
- package/src/eth-address/index.ts +0 -4
- package/src/fifo/fifo_frame_reader.ts +98 -0
- package/src/fifo/index.ts +1 -0
- package/src/jest/setup.mjs +27 -0
- package/src/json-rpc/client/fetch.ts +4 -3
- package/src/json-rpc/client/undici.ts +5 -3
- package/src/log/pino-logger.ts +19 -2
- package/src/queue/batch_queue.ts +1 -0
- package/src/retry/index.ts +30 -0
- package/src/serialize/buffer_reader.ts +6 -29
- package/src/serialize/field_reader.ts +4 -22
- package/src/sleep/index.ts +10 -1
- package/src/string/index.ts +1 -1
- package/src/timer/date.ts +6 -0
- package/src/transport/dispatch/create_dispatch_proxy.ts +11 -1
- package/src/transport/index.ts +0 -1
- package/src/trees/balanced_merkle_tree_root.ts +2 -5
- package/src/trees/hasher.ts +6 -3
- package/src/trees/indexed_merkle_tree_calculator.ts +5 -1
- package/src/trees/membership_witness.ts +2 -2
- package/src/trees/merkle_tree_calculator.ts +4 -10
- package/src/trees/sibling_path.ts +1 -2
- package/src/trees/unbalanced_merkle_tree_root.ts +2 -5
- package/dest/crypto/serialize.d.ts +0 -51
- package/dest/crypto/serialize.d.ts.map +0 -1
- package/dest/crypto/serialize.js +0 -68
- package/dest/transport/dispatch/create_dispatch_fn.d.ts +0 -25
- package/dest/transport/dispatch/create_dispatch_fn.d.ts.map +0 -1
- package/dest/transport/dispatch/create_dispatch_fn.js +0 -17
- package/src/crypto/serialize.ts +0 -85
- package/src/transport/dispatch/create_dispatch_fn.ts +0 -35
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { BaseBuffer32 } from '../buffer/buffer32.js';
|
|
2
|
+
import type { Branded } from './types.js';
|
|
3
|
+
/** A branded Buffer32 representing a block proposal hash, used for p2p deduplication. */
|
|
4
|
+
export type BlockProposalHash = Branded<BaseBuffer32, 'BlockProposalHash'>;
|
|
5
|
+
/** Creates a BlockProposalHash from a BaseBuffer32. */
|
|
6
|
+
export declare function BlockProposalHash(buf: BaseBuffer32): BlockProposalHash;
|
|
7
|
+
export declare namespace BlockProposalHash {
|
|
8
|
+
var fromBuffer: (buf: Buffer<ArrayBufferLike>) => BlockProposalHash;
|
|
9
|
+
}
|
|
10
|
+
/** A branded Buffer32 representing a checkpoint proposal hash, used for p2p deduplication. */
|
|
11
|
+
export type CheckpointProposalHash = Branded<BaseBuffer32, 'CheckpointProposalHash'>;
|
|
12
|
+
/** Creates a CheckpointProposalHash from a BaseBuffer32. */
|
|
13
|
+
export declare function CheckpointProposalHash(buf: BaseBuffer32): CheckpointProposalHash;
|
|
14
|
+
export declare namespace CheckpointProposalHash {
|
|
15
|
+
var fromBuffer: (buf: Buffer<ArrayBufferLike>) => CheckpointProposalHash;
|
|
16
|
+
}
|
|
17
|
+
/** A branded Buffer32 representing a checkpoint attestation hash, used for p2p deduplication. */
|
|
18
|
+
export type CheckpointAttestationHash = Branded<BaseBuffer32, 'CheckpointAttestationHash'>;
|
|
19
|
+
/** Creates a CheckpointAttestationHash from a BaseBuffer32. */
|
|
20
|
+
export declare function CheckpointAttestationHash(buf: BaseBuffer32): CheckpointAttestationHash;
|
|
21
|
+
export declare namespace CheckpointAttestationHash {
|
|
22
|
+
var fromBuffer: (buf: Buffer<ArrayBufferLike>) => CheckpointAttestationHash;
|
|
23
|
+
}
|
|
24
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVmZmVyMzJfaGFzaC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2JyYW5kZWQtdHlwZXMvYnVmZmVyMzJfaGFzaC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUUxRCxPQUFPLEtBQUssRUFBRSxPQUFPLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFFMUMseUZBQXlGO0FBQ3pGLE1BQU0sTUFBTSxpQkFBaUIsR0FBRyxPQUFPLENBQUMsWUFBWSxFQUFFLG1CQUFtQixDQUFDLENBQUM7QUFFM0UsdURBQXVEO0FBQ3ZELHdCQUFnQixpQkFBaUIsQ0FBQyxHQUFHLEVBQUUsWUFBWSxHQUFHLGlCQUFpQixDQUV0RTs7OztBQU9ELDhGQUE4RjtBQUM5RixNQUFNLE1BQU0sc0JBQXNCLEdBQUcsT0FBTyxDQUFDLFlBQVksRUFBRSx3QkFBd0IsQ0FBQyxDQUFDO0FBRXJGLDREQUE0RDtBQUM1RCx3QkFBZ0Isc0JBQXNCLENBQUMsR0FBRyxFQUFFLFlBQVksR0FBRyxzQkFBc0IsQ0FFaEY7Ozs7QUFPRCxpR0FBaUc7QUFDakcsTUFBTSxNQUFNLHlCQUF5QixHQUFHLE9BQU8sQ0FBQyxZQUFZLEVBQUUsMkJBQTJCLENBQUMsQ0FBQztBQUUzRiwrREFBK0Q7QUFDL0Qsd0JBQWdCLHlCQUF5QixDQUFDLEdBQUcsRUFBRSxZQUFZLEdBQUcseUJBQXlCLENBRXRGIn0=
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"buffer32_hash.d.ts","sourceRoot":"","sources":["../../src/branded-types/buffer32_hash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,yFAAyF;AACzF,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC;AAE3E,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CAEtE;;;;AAOD,8FAA8F;AAC9F,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC;AAErF,4DAA4D;AAC5D,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,YAAY,GAAG,sBAAsB,CAEhF;;;;AAOD,iGAAiG;AACjG,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,YAAY,EAAE,2BAA2B,CAAC,CAAC;AAE3F,+DAA+D;AAC/D,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,YAAY,GAAG,yBAAyB,CAEtF"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { Buffer32 } from '../buffer/buffer32.js';
|
|
2
|
+
/** Creates a BlockProposalHash from a BaseBuffer32. */ export function BlockProposalHash(buf) {
|
|
3
|
+
return buf;
|
|
4
|
+
}
|
|
5
|
+
/** Creates a BlockProposalHash from a raw Buffer. */ BlockProposalHash.fromBuffer = function(buf) {
|
|
6
|
+
return new Buffer32(buf);
|
|
7
|
+
};
|
|
8
|
+
/** Creates a CheckpointProposalHash from a BaseBuffer32. */ export function CheckpointProposalHash(buf) {
|
|
9
|
+
return buf;
|
|
10
|
+
}
|
|
11
|
+
/** Creates a CheckpointProposalHash from a raw Buffer. */ CheckpointProposalHash.fromBuffer = function(buf) {
|
|
12
|
+
return new Buffer32(buf);
|
|
13
|
+
};
|
|
14
|
+
/** Creates a CheckpointAttestationHash from a BaseBuffer32. */ export function CheckpointAttestationHash(buf) {
|
|
15
|
+
return buf;
|
|
16
|
+
}
|
|
17
|
+
/** Creates a CheckpointAttestationHash from a raw Buffer. */ CheckpointAttestationHash.fromBuffer = function(buf) {
|
|
18
|
+
return new Buffer32(buf);
|
|
19
|
+
};
|
|
@@ -35,6 +35,9 @@ export declare namespace CheckpointNumber {
|
|
|
35
35
|
export declare namespace CheckpointNumber {
|
|
36
36
|
var isValid: (value: unknown) => value is CheckpointNumber;
|
|
37
37
|
}
|
|
38
|
+
export declare namespace CheckpointNumber {
|
|
39
|
+
var add: (n: CheckpointNumber, increment: number) => CheckpointNumber;
|
|
40
|
+
}
|
|
38
41
|
export declare namespace CheckpointNumber {
|
|
39
42
|
var ZERO: CheckpointNumber;
|
|
40
43
|
}
|
|
@@ -51,4 +54,4 @@ export declare const CheckpointNumberSchema: z.ZodEffects<z.ZodPipeline<z.ZodUni
|
|
|
51
54
|
* Accepts numbers, bigints, or strings and coerces them to CheckpointNumber.
|
|
52
55
|
*/
|
|
53
56
|
export declare const CheckpointNumberPositiveSchema: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, CheckpointNumber, string | number | bigint>;
|
|
54
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
57
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hlY2twb2ludF9udW1iZXIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9icmFuZGVkLXR5cGVzL2NoZWNrcG9pbnRfbnVtYmVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFeEIsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFDckQsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBRTFDOzs7Ozs7Ozs7Ozs7O0dBYUc7QUFDSCxNQUFNLE1BQU0sZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLE1BQU0sRUFBRSxrQkFBa0IsQ0FBQyxDQUFDO0FBRW5FOzs7OztHQUtHO0FBQ0gsd0JBQWdCLGdCQUFnQixDQUFDLEtBQUssRUFBRSxNQUFNLEdBQUcsZ0JBQWdCLENBUWhFOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBMEVEOzs7R0FHRztBQUNILGVBQU8sTUFBTSxzQkFBc0IsMklBQWdDLENBQUM7QUFFcEU7OztHQUdHO0FBQ0gsZUFBTyxNQUFNLDhCQUE4QiwySUFBZ0MsQ0FBQyJ9
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"checkpoint_number.d.ts","sourceRoot":"","sources":["../../src/branded-types/checkpoint_number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAEnE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAQhE
|
|
1
|
+
{"version":3,"file":"checkpoint_number.d.ts","sourceRoot":"","sources":["../../src/branded-types/checkpoint_number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAEnE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAQhE;;;;;;;;;;;;;;;;;;;;;;AA0ED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,2IAAgC,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,8BAA8B,2IAAgC,CAAC"}
|
|
@@ -55,6 +55,9 @@ import { z } from 'zod';
|
|
|
55
55
|
*/ CheckpointNumber.isValid = function(value) {
|
|
56
56
|
return typeof value === 'number' && Number.isInteger(value) && value >= 0;
|
|
57
57
|
};
|
|
58
|
+
/** Increments a CheckpointNumber by a given value. */ CheckpointNumber.add = function(n, increment) {
|
|
59
|
+
return CheckpointNumber(n + increment);
|
|
60
|
+
};
|
|
58
61
|
/** The zero checkpoint value. */ CheckpointNumber.ZERO = CheckpointNumber(0);
|
|
59
62
|
/** Initial checkpoint. */ CheckpointNumber.INITIAL = CheckpointNumber(1);
|
|
60
63
|
/**
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
export { BlockNumber, BlockNumberSchema, BlockNumberPositiveSchema } from './block_number.js';
|
|
2
|
+
export { BlockProposalHash, CheckpointAttestationHash, CheckpointProposalHash } from './buffer32_hash.js';
|
|
2
3
|
export { CheckpointNumber, CheckpointNumberSchema, CheckpointNumberPositiveSchema } from './checkpoint_number.js';
|
|
3
4
|
export { EpochNumber, EpochNumberSchema } from './epoch.js';
|
|
4
5
|
export { IndexWithinCheckpoint, IndexWithinCheckpointSchema } from './index_within_checkpoint.js';
|
|
5
6
|
export { SlotNumber, SlotNumberSchema } from './slot.js';
|
|
6
7
|
export type { Branded } from './types.js';
|
|
7
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
8
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9icmFuZGVkLXR5cGVzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxXQUFXLEVBQUUsaUJBQWlCLEVBQUUseUJBQXlCLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUM5RixPQUFPLEVBQUUsaUJBQWlCLEVBQUUseUJBQXlCLEVBQUUsc0JBQXNCLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUMxRyxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsc0JBQXNCLEVBQUUsOEJBQThCLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUNsSCxPQUFPLEVBQUUsV0FBVyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sWUFBWSxDQUFDO0FBQzVELE9BQU8sRUFBRSxxQkFBcUIsRUFBRSwyQkFBMkIsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBQ2xHLE9BQU8sRUFBRSxVQUFVLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxXQUFXLENBQUM7QUFFekQsWUFBWSxFQUFFLE9BQU8sRUFBRSxNQUFNLFlBQVksQ0FBQyJ9
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/branded-types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAClH,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAClG,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAEzD,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/branded-types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC1G,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAClH,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAClG,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAEzD,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
export { BlockNumber, BlockNumberSchema, BlockNumberPositiveSchema } from './block_number.js';
|
|
2
|
+
export { BlockProposalHash, CheckpointAttestationHash, CheckpointProposalHash } from './buffer32_hash.js';
|
|
2
3
|
export { CheckpointNumber, CheckpointNumberSchema, CheckpointNumberPositiveSchema } from './checkpoint_number.js';
|
|
3
4
|
export { EpochNumber, EpochNumberSchema } from './epoch.js';
|
|
4
5
|
export { IndexWithinCheckpoint, IndexWithinCheckpointSchema } from './index_within_checkpoint.js';
|
|
@@ -9,6 +9,8 @@ export declare class Buffer16 {
|
|
|
9
9
|
* The buffer containing the hash.
|
|
10
10
|
*/
|
|
11
11
|
buffer: Buffer;
|
|
12
|
+
/** Branding for nominal typing. */
|
|
13
|
+
private readonly _branding;
|
|
12
14
|
/**
|
|
13
15
|
* The size of the hash in bytes.
|
|
14
16
|
*/
|
|
@@ -77,4 +79,4 @@ export declare class Buffer16 {
|
|
|
77
79
|
*/
|
|
78
80
|
static random(): Buffer16;
|
|
79
81
|
}
|
|
80
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
82
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVmZmVyMTYuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9idWZmZXIvYnVmZmVyMTYudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDekQsT0FBTyxFQUFFLFlBQVksRUFBc0MsTUFBTSw2QkFBNkIsQ0FBQztBQUUvRixPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sTUFBTSxDQUFDO0FBSS9COztHQUVHO0FBQ0gscUJBQWEsUUFBUTtJQWVqQjs7T0FFRztJQUNJLE1BQU0sRUFBRSxNQUFNO0lBakJ2QixtQ0FBbUM7SUFDbkMsaUJBQXlCLFNBQVMsQ0FBYTtJQUUvQzs7T0FFRztJQUNILE9BQWMsSUFBSSxTQUFNO0lBRXhCOztPQUVHO0lBQ0gsT0FBYyxJQUFJLFdBQTZDO0lBRS9EO0lBQ0U7O09BRUc7SUFDSSxNQUFNLEVBQUUsTUFBTSxFQUt0QjtJQUVEOzs7T0FHRztJQUNJLFFBQVEsNEJBRWQ7SUFFRDs7OztPQUlHO0lBQ0gsT0FBYyxVQUFVLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxZQUFZLFlBR3JEO0lBRUQ7Ozs7T0FJRztJQUNJLE1BQU0sQ0FBQyxJQUFJLEVBQUUsUUFBUSxHQUFHLE9BQU8sQ0FFckM7SUFFRDs7O09BR0c7SUFDSSxNQUFNLElBQUksT0FBTyxDQUV2QjtJQUVEOzs7T0FHRztJQUNJLFFBQVEsa0JBRWQ7SUFFRCxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUMsV0FFZjtJQUVELE1BQU0sa0JBRUw7SUFFRDs7O09BR0c7SUFDSSxRQUFRLFdBRWQ7SUFFRDs7T0FFRztJQUNILE9BQWMsVUFBVSxDQUFDLElBQUksRUFBRSxNQUFNLFlBRXBDO0lBRUQsT0FBYyxTQUFTLENBQUMsSUFBSSxFQUFFLEVBQUUsWUFFL0I7SUFFRDs7T0FFRztJQUNILE9BQWMsVUFBVSxDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsUUFBUSxDQVE5QztJQUVEOzs7O09BSUc7SUFDSCxPQUFjLFVBQVUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxHQUFHLFFBQVEsQ0FFOUM7SUFFRDs7O09BR0c7SUFDSCxPQUFjLE1BQU0sSUFBSSxRQUFRLENBRS9CO0NBQ0YifQ==
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"buffer16.d.ts","sourceRoot":"","sources":["../../src/buffer/buffer16.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EAAE,YAAY,EAAsC,MAAM,6BAA6B,CAAC;AAE/F,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAI/B;;GAEG;AACH,qBAAa,QAAQ;
|
|
1
|
+
{"version":3,"file":"buffer16.d.ts","sourceRoot":"","sources":["../../src/buffer/buffer16.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EAAE,YAAY,EAAsC,MAAM,6BAA6B,CAAC;AAE/F,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAI/B;;GAEG;AACH,qBAAa,QAAQ;IAejB;;OAEG;IACI,MAAM,EAAE,MAAM;IAjBvB,mCAAmC;IACnC,iBAAyB,SAAS,CAAa;IAE/C;;OAEG;IACH,OAAc,IAAI,SAAM;IAExB;;OAEG;IACH,OAAc,IAAI,WAA6C;IAE/D;IACE;;OAEG;IACI,MAAM,EAAE,MAAM,EAKtB;IAED;;;OAGG;IACI,QAAQ,4BAEd;IAED;;;;OAIG;IACH,OAAc,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,YAGrD;IAED;;;;OAIG;IACI,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAErC;IAED;;;OAGG;IACI,MAAM,IAAI,OAAO,CAEvB;IAED;;;OAGG;IACI,QAAQ,kBAEd;IAED,CAAC,OAAO,CAAC,MAAM,CAAC,WAEf;IAED,MAAM,kBAEL;IAED;;;OAGG;IACI,QAAQ,WAEd;IAED;;OAEG;IACH,OAAc,UAAU,CAAC,IAAI,EAAE,MAAM,YAEpC;IAED,OAAc,SAAS,CAAC,IAAI,EAAE,EAAE,YAE/B;IAED;;OAEG;IACH,OAAc,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAQ9C;IAED;;;;OAIG;IACH,OAAc,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAE9C;IAED;;;OAGG;IACH,OAAc,MAAM,IAAI,QAAQ,CAE/B;CACF"}
|
|
@@ -2,86 +2,53 @@ import type { Fr } from '@aztec/foundation/curves/bn254';
|
|
|
2
2
|
import { BufferReader } from '@aztec/foundation/serialize';
|
|
3
3
|
import { inspect } from 'util';
|
|
4
4
|
/**
|
|
5
|
-
*
|
|
5
|
+
* Abstract unbranded base class for 32-byte buffers.
|
|
6
|
+
* Extend this instead of Buffer32 when defining a branded subtype
|
|
7
|
+
* to avoid inheriting Buffer32's `_branding`.
|
|
6
8
|
*/
|
|
7
|
-
export declare class
|
|
8
|
-
/**
|
|
9
|
-
* The buffer containing the hash.
|
|
10
|
-
*/
|
|
9
|
+
export declare abstract class BaseBuffer32 {
|
|
10
|
+
/** The buffer containing the data. */
|
|
11
11
|
buffer: Buffer;
|
|
12
|
-
/**
|
|
13
|
-
* The size of the hash in bytes.
|
|
14
|
-
*/
|
|
12
|
+
/** The size of the buffer in bytes. */
|
|
15
13
|
static SIZE: number;
|
|
16
|
-
/**
|
|
17
|
-
* Buffer32 with value zero.
|
|
18
|
-
*/
|
|
19
|
-
static ZERO: Buffer32;
|
|
20
14
|
constructor(
|
|
21
|
-
/**
|
|
22
|
-
* The buffer containing the hash.
|
|
23
|
-
*/
|
|
15
|
+
/** The buffer containing the data. */
|
|
24
16
|
buffer: Buffer);
|
|
25
|
-
/**
|
|
26
|
-
* Returns the raw buffer of the hash.
|
|
27
|
-
* @returns The buffer containing the hash.
|
|
28
|
-
*/
|
|
17
|
+
/** Returns the raw buffer. */
|
|
29
18
|
toBuffer(): Buffer<ArrayBufferLike>;
|
|
30
|
-
/**
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
* @returns A new Buffer32 object.
|
|
34
|
-
*/
|
|
35
|
-
static fromBuffer(buffer: Buffer | BufferReader): Buffer32;
|
|
36
|
-
/**
|
|
37
|
-
* Checks if this hash and another hash are equal.
|
|
38
|
-
* @param hash - A hash to compare with.
|
|
39
|
-
* @returns True if the hashes are equal, false otherwise.
|
|
40
|
-
*/
|
|
41
|
-
equals(hash: Buffer32): boolean;
|
|
42
|
-
/**
|
|
43
|
-
* Returns true if this hash is zero.
|
|
44
|
-
* @returns True if this hash is zero.
|
|
45
|
-
*/
|
|
19
|
+
/** Checks if this and another buffer are equal. */
|
|
20
|
+
equals(hash: BaseBuffer32): boolean;
|
|
21
|
+
/** Returns true if all bytes are zero. */
|
|
46
22
|
isZero(): boolean;
|
|
47
|
-
/**
|
|
48
|
-
* Convert this hash to a hex string.
|
|
49
|
-
* @returns The hex string.
|
|
50
|
-
*/
|
|
23
|
+
/** Convert to a hex string. */
|
|
51
24
|
toString(): `0x${string}`;
|
|
52
25
|
[inspect.custom](): string;
|
|
53
26
|
toJSON(): `0x${string}`;
|
|
54
|
-
/**
|
|
55
|
-
* Convert this hash to a big int.
|
|
56
|
-
* @returns The big int.
|
|
57
|
-
*/
|
|
27
|
+
/** Convert to a big int. */
|
|
58
28
|
toBigInt(): bigint;
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
29
|
+
}
|
|
30
|
+
/** A branded 32-byte buffer. */
|
|
31
|
+
export declare class Buffer32 extends BaseBuffer32 {
|
|
32
|
+
/** Branding for nominal typing. */
|
|
33
|
+
private readonly _branding;
|
|
34
|
+
/** Buffer32 with value zero. */
|
|
35
|
+
static ZERO: Buffer32;
|
|
36
|
+
/** Creates a Buffer32 from a buffer. */
|
|
37
|
+
static fromBuffer(buffer: Buffer | BufferReader): Buffer32;
|
|
38
|
+
/** Creates a Buffer32 from a bigint. */
|
|
62
39
|
static fromBigInt(hash: bigint): Buffer32;
|
|
63
40
|
static fromField(hash: Fr): Buffer32;
|
|
64
41
|
/**
|
|
65
|
-
* Converts
|
|
66
|
-
* Verifies the input is 28 bytes.
|
|
42
|
+
* Converts from a buffer of 28 bytes.
|
|
67
43
|
* @param buffer - The 28 byte buffer to construct from.
|
|
68
44
|
* @returns A Buffer32 created from the input buffer with 4 bytes 0 padding at the front.
|
|
69
45
|
*/
|
|
70
46
|
static fromBuffer28(buffer: Buffer): Buffer32;
|
|
71
|
-
/**
|
|
72
|
-
* Converts a string into a Buffer32 object.
|
|
73
|
-
*/
|
|
47
|
+
/** Converts a string into a Buffer32 object. */
|
|
74
48
|
static fromString(str: string): Buffer32;
|
|
75
|
-
/**
|
|
76
|
-
* Converts a number into a Buffer32 object.
|
|
77
|
-
* @param num - The number to convert.
|
|
78
|
-
* @returns A new Buffer32 object.
|
|
79
|
-
*/
|
|
49
|
+
/** Converts a number into a Buffer32 object. */
|
|
80
50
|
static fromNumber(num: number): Buffer32;
|
|
81
|
-
/**
|
|
82
|
-
* Generates a random Buffer32.
|
|
83
|
-
* @returns A new Buffer32 object.
|
|
84
|
-
*/
|
|
51
|
+
/** Generates a random Buffer32. */
|
|
85
52
|
static random(): Buffer32;
|
|
86
53
|
}
|
|
87
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
54
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVmZmVyMzIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9idWZmZXIvYnVmZmVyMzIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDekQsT0FBTyxFQUFFLFlBQVksRUFBc0MsTUFBTSw2QkFBNkIsQ0FBQztBQUUvRixPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sTUFBTSxDQUFDO0FBSS9COzs7O0dBSUc7QUFDSCw4QkFBc0IsWUFBWTtJQUs5QixzQ0FBc0M7SUFDL0IsTUFBTSxFQUFFLE1BQU07SUFMdkIsdUNBQXVDO0lBQ3ZDLE9BQWMsSUFBSSxTQUFNO0lBRXhCO0lBQ0Usc0NBQXNDO0lBQy9CLE1BQU0sRUFBRSxNQUFNLEVBS3RCO0lBRUQsOEJBQThCO0lBQ3ZCLFFBQVEsNEJBRWQ7SUFFRCxtREFBbUQ7SUFDNUMsTUFBTSxDQUFDLElBQUksRUFBRSxZQUFZLEdBQUcsT0FBTyxDQUV6QztJQUVELDBDQUEwQztJQUNuQyxNQUFNLElBQUksT0FBTyxDQUV2QjtJQUVELCtCQUErQjtJQUN4QixRQUFRLGtCQUVkO0lBRUQsQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLFdBRWY7SUFFRCxNQUFNLGtCQUVMO0lBRUQsNEJBQTRCO0lBQ3JCLFFBQVEsV0FFZDtDQUNGO0FBRUQsZ0NBQWdDO0FBQ2hDLHFCQUFhLFFBQVMsU0FBUSxZQUFZO0lBQ3hDLG1DQUFtQztJQUNuQyxpQkFBeUIsU0FBUyxDQUFhO0lBRS9DLGdDQUFnQztJQUNoQyxPQUFjLElBQUksV0FBNkM7SUFFL0Qsd0NBQXdDO0lBQ3hDLE9BQWMsVUFBVSxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsWUFBWSxZQUdyRDtJQUVELHdDQUF3QztJQUN4QyxPQUFjLFVBQVUsQ0FBQyxJQUFJLEVBQUUsTUFBTSxZQUVwQztJQUVELE9BQWMsU0FBUyxDQUFDLElBQUksRUFBRSxFQUFFLFlBRS9CO0lBRUQ7Ozs7T0FJRztJQUNILE9BQWMsWUFBWSxDQUFDLE1BQU0sRUFBRSxNQUFNLFlBTXhDO0lBRUQsZ0RBQWdEO0lBQ2hELE9BQWMsVUFBVSxDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsUUFBUSxDQVE5QztJQUVELGdEQUFnRDtJQUNoRCxPQUFjLFVBQVUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxHQUFHLFFBQVEsQ0FFOUM7SUFFRCxtQ0FBbUM7SUFDbkMsT0FBYyxNQUFNLElBQUksUUFBUSxDQUUvQjtDQUNGIn0=
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"buffer32.d.ts","sourceRoot":"","sources":["../../src/buffer/buffer32.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EAAE,YAAY,EAAsC,MAAM,6BAA6B,CAAC;AAE/F,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAI/B
|
|
1
|
+
{"version":3,"file":"buffer32.d.ts","sourceRoot":"","sources":["../../src/buffer/buffer32.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EAAE,YAAY,EAAsC,MAAM,6BAA6B,CAAC;AAE/F,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAI/B;;;;GAIG;AACH,8BAAsB,YAAY;IAK9B,sCAAsC;IAC/B,MAAM,EAAE,MAAM;IALvB,uCAAuC;IACvC,OAAc,IAAI,SAAM;IAExB;IACE,sCAAsC;IAC/B,MAAM,EAAE,MAAM,EAKtB;IAED,8BAA8B;IACvB,QAAQ,4BAEd;IAED,mDAAmD;IAC5C,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAEzC;IAED,0CAA0C;IACnC,MAAM,IAAI,OAAO,CAEvB;IAED,+BAA+B;IACxB,QAAQ,kBAEd;IAED,CAAC,OAAO,CAAC,MAAM,CAAC,WAEf;IAED,MAAM,kBAEL;IAED,4BAA4B;IACrB,QAAQ,WAEd;CACF;AAED,gCAAgC;AAChC,qBAAa,QAAS,SAAQ,YAAY;IACxC,mCAAmC;IACnC,iBAAyB,SAAS,CAAa;IAE/C,gCAAgC;IAChC,OAAc,IAAI,WAA6C;IAE/D,wCAAwC;IACxC,OAAc,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,YAGrD;IAED,wCAAwC;IACxC,OAAc,UAAU,CAAC,IAAI,EAAE,MAAM,YAEpC;IAED,OAAc,SAAS,CAAC,IAAI,EAAE,EAAE,YAE/B;IAED;;;;OAIG;IACH,OAAc,YAAY,CAAC,MAAM,EAAE,MAAM,YAMxC;IAED,gDAAgD;IAChD,OAAc,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAQ9C;IAED,gDAAgD;IAChD,OAAc,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAE9C;IAED,mCAAmC;IACnC,OAAc,MAAM,IAAI,QAAQ,CAE/B;CACF"}
|
package/dest/buffer/buffer32.js
CHANGED
|
@@ -5,54 +5,28 @@ import { inspect } from 'util';
|
|
|
5
5
|
import { bufferToHex } from '../string/index.js';
|
|
6
6
|
_computedKey = inspect.custom;
|
|
7
7
|
/**
|
|
8
|
-
*
|
|
9
|
-
|
|
8
|
+
* Abstract unbranded base class for 32-byte buffers.
|
|
9
|
+
* Extend this instead of Buffer32 when defining a branded subtype
|
|
10
|
+
* to avoid inheriting Buffer32's `_branding`.
|
|
11
|
+
*/ export class BaseBuffer32 {
|
|
10
12
|
buffer;
|
|
11
|
-
/**
|
|
12
|
-
|
|
13
|
-
*/ static SIZE = 32;
|
|
14
|
-
/**
|
|
15
|
-
* Buffer32 with value zero.
|
|
16
|
-
*/ static ZERO = new Buffer32(Buffer.alloc(Buffer32.SIZE));
|
|
17
|
-
constructor(/**
|
|
18
|
-
* The buffer containing the hash.
|
|
19
|
-
*/ buffer){
|
|
13
|
+
/** The size of the buffer in bytes. */ static SIZE = 32;
|
|
14
|
+
constructor(/** The buffer containing the data. */ buffer){
|
|
20
15
|
this.buffer = buffer;
|
|
21
|
-
if (buffer.length !==
|
|
22
|
-
throw new Error(`Expected buffer to have length ${
|
|
16
|
+
if (buffer.length !== BaseBuffer32.SIZE) {
|
|
17
|
+
throw new Error(`Expected buffer to have length ${BaseBuffer32.SIZE} but was ${buffer.length}`);
|
|
23
18
|
}
|
|
24
19
|
}
|
|
25
|
-
/**
|
|
26
|
-
* Returns the raw buffer of the hash.
|
|
27
|
-
* @returns The buffer containing the hash.
|
|
28
|
-
*/ toBuffer() {
|
|
20
|
+
/** Returns the raw buffer. */ toBuffer() {
|
|
29
21
|
return this.buffer;
|
|
30
22
|
}
|
|
31
|
-
/**
|
|
32
|
-
* Creates a Buffer32 from a buffer.
|
|
33
|
-
* @param buffer - The buffer to create from.
|
|
34
|
-
* @returns A new Buffer32 object.
|
|
35
|
-
*/ static fromBuffer(buffer) {
|
|
36
|
-
const reader = BufferReader.asReader(buffer);
|
|
37
|
-
return new Buffer32(reader.readBytes(Buffer32.SIZE));
|
|
38
|
-
}
|
|
39
|
-
/**
|
|
40
|
-
* Checks if this hash and another hash are equal.
|
|
41
|
-
* @param hash - A hash to compare with.
|
|
42
|
-
* @returns True if the hashes are equal, false otherwise.
|
|
43
|
-
*/ equals(hash) {
|
|
23
|
+
/** Checks if this and another buffer are equal. */ equals(hash) {
|
|
44
24
|
return this.buffer.equals(hash.buffer);
|
|
45
25
|
}
|
|
46
|
-
/**
|
|
47
|
-
* Returns true if this hash is zero.
|
|
48
|
-
* @returns True if this hash is zero.
|
|
49
|
-
*/ isZero() {
|
|
26
|
+
/** Returns true if all bytes are zero. */ isZero() {
|
|
50
27
|
return this.buffer.equals(Buffer.alloc(32, 0));
|
|
51
28
|
}
|
|
52
|
-
/**
|
|
53
|
-
* Convert this hash to a hex string.
|
|
54
|
-
* @returns The hex string.
|
|
55
|
-
*/ toString() {
|
|
29
|
+
/** Convert to a hex string. */ toString() {
|
|
56
30
|
return bufferToHex(this.buffer);
|
|
57
31
|
}
|
|
58
32
|
[_computedKey]() {
|
|
@@ -61,23 +35,24 @@ _computedKey = inspect.custom;
|
|
|
61
35
|
toJSON() {
|
|
62
36
|
return this.toString();
|
|
63
37
|
}
|
|
64
|
-
/**
|
|
65
|
-
|
|
66
|
-
* @returns The big int.
|
|
67
|
-
*/ toBigInt() {
|
|
68
|
-
return deserializeBigInt(this.buffer, 0, Buffer32.SIZE).elem;
|
|
38
|
+
/** Convert to a big int. */ toBigInt() {
|
|
39
|
+
return deserializeBigInt(this.buffer, 0, BaseBuffer32.SIZE).elem;
|
|
69
40
|
}
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
41
|
+
}
|
|
42
|
+
/** A branded 32-byte buffer. */ export class Buffer32 extends BaseBuffer32 {
|
|
43
|
+
/** Buffer32 with value zero. */ static ZERO = new Buffer32(Buffer.alloc(Buffer32.SIZE));
|
|
44
|
+
/** Creates a Buffer32 from a buffer. */ static fromBuffer(buffer) {
|
|
45
|
+
const reader = BufferReader.asReader(buffer);
|
|
46
|
+
return new Buffer32(reader.readBytes(Buffer32.SIZE));
|
|
47
|
+
}
|
|
48
|
+
/** Creates a Buffer32 from a bigint. */ static fromBigInt(hash) {
|
|
73
49
|
return new Buffer32(serializeBigInt(hash, Buffer32.SIZE));
|
|
74
50
|
}
|
|
75
51
|
static fromField(hash) {
|
|
76
52
|
return new Buffer32(serializeBigInt(hash.toBigInt()));
|
|
77
53
|
}
|
|
78
54
|
/**
|
|
79
|
-
* Converts
|
|
80
|
-
* Verifies the input is 28 bytes.
|
|
55
|
+
* Converts from a buffer of 28 bytes.
|
|
81
56
|
* @param buffer - The 28 byte buffer to construct from.
|
|
82
57
|
* @returns A Buffer32 created from the input buffer with 4 bytes 0 padding at the front.
|
|
83
58
|
*/ static fromBuffer28(buffer) {
|
|
@@ -90,9 +65,7 @@ _computedKey = inspect.custom;
|
|
|
90
65
|
]);
|
|
91
66
|
return new Buffer32(padded);
|
|
92
67
|
}
|
|
93
|
-
/**
|
|
94
|
-
* Converts a string into a Buffer32 object.
|
|
95
|
-
*/ static fromString(str) {
|
|
68
|
+
/** Converts a string into a Buffer32 object. */ static fromString(str) {
|
|
96
69
|
if (str.startsWith('0x')) {
|
|
97
70
|
str = str.slice(2);
|
|
98
71
|
}
|
|
@@ -101,17 +74,10 @@ _computedKey = inspect.custom;
|
|
|
101
74
|
}
|
|
102
75
|
return new Buffer32(Buffer.from(str, 'hex'));
|
|
103
76
|
}
|
|
104
|
-
/**
|
|
105
|
-
* Converts a number into a Buffer32 object.
|
|
106
|
-
* @param num - The number to convert.
|
|
107
|
-
* @returns A new Buffer32 object.
|
|
108
|
-
*/ static fromNumber(num) {
|
|
77
|
+
/** Converts a number into a Buffer32 object. */ static fromNumber(num) {
|
|
109
78
|
return new Buffer32(serializeBigInt(BigInt(num), Buffer32.SIZE));
|
|
110
79
|
}
|
|
111
|
-
/**
|
|
112
|
-
* Generates a random Buffer32.
|
|
113
|
-
* @returns A new Buffer32 object.
|
|
114
|
-
*/ static random() {
|
|
80
|
+
/** Generates a random Buffer32. */ static random() {
|
|
115
81
|
return new Buffer32(Buffer.from(randomBytes(Buffer32.SIZE)));
|
|
116
82
|
}
|
|
117
83
|
}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
1
|
export * from './array.js';
|
|
2
|
+
export * from './lru_set.js';
|
|
2
3
|
export * from './object.js';
|
|
3
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
4
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jb2xsZWN0aW9uL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsWUFBWSxDQUFDO0FBQzNCLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsYUFBYSxDQUFDIn0=
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collection/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collection/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}
|
package/dest/collection/index.js
CHANGED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A bounded set with Least Recently Used (LRU) eviction.
|
|
3
|
+
* Both {@link has} and {@link add} count as an access and refresh the entry's
|
|
4
|
+
* recency, so items that are actively checked stay in the set longest.
|
|
5
|
+
*
|
|
6
|
+
* Uses a doubly-linked list for O(1) ordering and a Map for O(1) lookup.
|
|
7
|
+
* Head = least recent, tail = most recent.
|
|
8
|
+
*/
|
|
9
|
+
export declare class LruSet<T> {
|
|
10
|
+
private readonly maxSize;
|
|
11
|
+
/** Map from value to its linked-list node for O(1) lookup. */
|
|
12
|
+
private readonly map;
|
|
13
|
+
private head;
|
|
14
|
+
private tail;
|
|
15
|
+
constructor(maxSize: number);
|
|
16
|
+
/** Number of entries in the set. */
|
|
17
|
+
get size(): number;
|
|
18
|
+
/**
|
|
19
|
+
* Returns true if the item is in the set.
|
|
20
|
+
* Refreshes the item's recency so it becomes the most recently used.
|
|
21
|
+
*/
|
|
22
|
+
has(item: T): boolean;
|
|
23
|
+
/**
|
|
24
|
+
* Adds an item to the set. If the item already exists, refreshes its recency.
|
|
25
|
+
* If the set is at capacity, evicts the least recently used item.
|
|
26
|
+
*/
|
|
27
|
+
add(item: T): void;
|
|
28
|
+
/** Removes all entries from the set. */
|
|
29
|
+
clear(): void;
|
|
30
|
+
/** Unlinks a node from its current position and relinks it at the tail. */
|
|
31
|
+
private moveToTail;
|
|
32
|
+
/** Evicts the head (least recently used) node. */
|
|
33
|
+
private evictHead;
|
|
34
|
+
}
|
|
35
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibHJ1X3NldC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NvbGxlY3Rpb24vbHJ1X3NldC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFPQTs7Ozs7OztHQU9HO0FBQ0gscUJBQWEsTUFBTSxDQUFDLENBQUM7SUFNUCxPQUFPLENBQUMsUUFBUSxDQUFDLE9BQU87SUFMcEMsOERBQThEO0lBQzlELE9BQU8sQ0FBQyxRQUFRLENBQUMsR0FBRyxDQUE0QjtJQUNoRCxPQUFPLENBQUMsSUFBSSxDQUF5QjtJQUNyQyxPQUFPLENBQUMsSUFBSSxDQUF5QjtJQUVyQyxZQUE2QixPQUFPLEVBQUUsTUFBTSxFQUkzQztJQUVELG9DQUFvQztJQUNwQyxJQUFJLElBQUksSUFBSSxNQUFNLENBRWpCO0lBRUQ7OztPQUdHO0lBQ0gsR0FBRyxDQUFDLElBQUksRUFBRSxDQUFDLEdBQUcsT0FBTyxDQU9wQjtJQUVEOzs7T0FHRztJQUNILEdBQUcsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxHQUFHLElBQUksQ0FtQmpCO0lBRUQsd0NBQXdDO0lBQ3hDLEtBQUssSUFBSSxJQUFJLENBSVo7SUFFRCwyRUFBMkU7SUFDM0UsT0FBTyxDQUFDLFVBQVU7SUF3QmxCLGtEQUFrRDtJQUNsRCxPQUFPLENBQUMsU0FBUztDQVdsQiJ9
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lru_set.d.ts","sourceRoot":"","sources":["../../src/collection/lru_set.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,qBAAa,MAAM,CAAC,CAAC;IAMP,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA4B;IAChD,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,IAAI,CAAyB;IAErC,YAA6B,OAAO,EAAE,MAAM,EAI3C;IAED,oCAAoC;IACpC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAOpB;IAED;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAmBjB;IAED,wCAAwC;IACxC,KAAK,IAAI,IAAI,CAIZ;IAED,2EAA2E;IAC3E,OAAO,CAAC,UAAU;IAwBlB,kDAAkD;IAClD,OAAO,CAAC,SAAS;CAWlB"}
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
/** Node in a doubly-linked list used by {@link LruSet}. */ /**
|
|
2
|
+
* A bounded set with Least Recently Used (LRU) eviction.
|
|
3
|
+
* Both {@link has} and {@link add} count as an access and refresh the entry's
|
|
4
|
+
* recency, so items that are actively checked stay in the set longest.
|
|
5
|
+
*
|
|
6
|
+
* Uses a doubly-linked list for O(1) ordering and a Map for O(1) lookup.
|
|
7
|
+
* Head = least recent, tail = most recent.
|
|
8
|
+
*/ export class LruSet {
|
|
9
|
+
maxSize;
|
|
10
|
+
/** Map from value to its linked-list node for O(1) lookup. */ map;
|
|
11
|
+
head;
|
|
12
|
+
tail;
|
|
13
|
+
constructor(maxSize){
|
|
14
|
+
this.maxSize = maxSize;
|
|
15
|
+
this.map = new Map();
|
|
16
|
+
if (maxSize < 1) {
|
|
17
|
+
throw new Error('LruSet maxSize must be at least 1');
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
/** Number of entries in the set. */ get size() {
|
|
21
|
+
return this.map.size;
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* Returns true if the item is in the set.
|
|
25
|
+
* Refreshes the item's recency so it becomes the most recently used.
|
|
26
|
+
*/ has(item) {
|
|
27
|
+
const node = this.map.get(item);
|
|
28
|
+
if (!node) {
|
|
29
|
+
return false;
|
|
30
|
+
}
|
|
31
|
+
this.moveToTail(node);
|
|
32
|
+
return true;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Adds an item to the set. If the item already exists, refreshes its recency.
|
|
36
|
+
* If the set is at capacity, evicts the least recently used item.
|
|
37
|
+
*/ add(item) {
|
|
38
|
+
const existing = this.map.get(item);
|
|
39
|
+
if (existing) {
|
|
40
|
+
this.moveToTail(existing);
|
|
41
|
+
return;
|
|
42
|
+
}
|
|
43
|
+
if (this.map.size >= this.maxSize) {
|
|
44
|
+
this.evictHead();
|
|
45
|
+
}
|
|
46
|
+
const node = {
|
|
47
|
+
value: item,
|
|
48
|
+
prev: this.tail,
|
|
49
|
+
next: undefined
|
|
50
|
+
};
|
|
51
|
+
if (this.tail) {
|
|
52
|
+
this.tail.next = node;
|
|
53
|
+
} else {
|
|
54
|
+
this.head = node;
|
|
55
|
+
}
|
|
56
|
+
this.tail = node;
|
|
57
|
+
this.map.set(item, node);
|
|
58
|
+
}
|
|
59
|
+
/** Removes all entries from the set. */ clear() {
|
|
60
|
+
this.map.clear();
|
|
61
|
+
this.head = undefined;
|
|
62
|
+
this.tail = undefined;
|
|
63
|
+
}
|
|
64
|
+
/** Unlinks a node from its current position and relinks it at the tail. */ moveToTail(node) {
|
|
65
|
+
if (node === this.tail) {
|
|
66
|
+
return;
|
|
67
|
+
}
|
|
68
|
+
// Unlink
|
|
69
|
+
if (node.prev) {
|
|
70
|
+
node.prev.next = node.next;
|
|
71
|
+
} else {
|
|
72
|
+
this.head = node.next;
|
|
73
|
+
}
|
|
74
|
+
if (node.next) {
|
|
75
|
+
node.next.prev = node.prev;
|
|
76
|
+
}
|
|
77
|
+
// Relink at tail
|
|
78
|
+
node.prev = this.tail;
|
|
79
|
+
node.next = undefined;
|
|
80
|
+
if (this.tail) {
|
|
81
|
+
this.tail.next = node;
|
|
82
|
+
}
|
|
83
|
+
this.tail = node;
|
|
84
|
+
}
|
|
85
|
+
/** Evicts the head (least recently used) node. */ evictHead() {
|
|
86
|
+
const oldHead = this.head;
|
|
87
|
+
this.map.delete(oldHead.value);
|
|
88
|
+
this.head = oldHead.next;
|
|
89
|
+
if (this.head) {
|
|
90
|
+
this.head.prev = undefined;
|
|
91
|
+
} else {
|
|
92
|
+
this.tail = undefined;
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
}
|