@aztec/aztec-node 0.0.1-commit.c2eed6949 → 0.0.1-commit.c52d6e7
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/aztec-node/block_response_helpers.d.ts +25 -0
- package/dest/aztec-node/block_response_helpers.d.ts.map +1 -0
- package/dest/aztec-node/block_response_helpers.js +112 -0
- package/dest/aztec-node/config.d.ts +16 -4
- package/dest/aztec-node/config.d.ts.map +1 -1
- package/dest/aztec-node/config.js +15 -5
- package/dest/aztec-node/node_public_calls_simulator.d.ts +97 -0
- package/dest/aztec-node/node_public_calls_simulator.d.ts.map +1 -0
- package/dest/aztec-node/node_public_calls_simulator.js +351 -0
- package/dest/aztec-node/public_data_overrides.d.ts +13 -0
- package/dest/aztec-node/public_data_overrides.d.ts.map +1 -0
- package/dest/aztec-node/public_data_overrides.js +21 -0
- package/dest/aztec-node/register_node_rpc_handlers.d.ts +10 -0
- package/dest/aztec-node/register_node_rpc_handlers.d.ts.map +1 -0
- package/dest/aztec-node/register_node_rpc_handlers.js +31 -0
- package/dest/aztec-node/server.d.ts +128 -133
- package/dest/aztec-node/server.d.ts.map +1 -1
- package/dest/aztec-node/server.js +376 -848
- package/dest/bin/index.js +15 -10
- package/dest/factory.d.ts +33 -0
- package/dest/factory.d.ts.map +1 -0
- package/dest/factory.js +531 -0
- package/dest/index.d.ts +3 -1
- package/dest/index.d.ts.map +1 -1
- package/dest/index.js +2 -0
- package/dest/modules/block_parameter.d.ts +25 -0
- package/dest/modules/block_parameter.d.ts.map +1 -0
- package/dest/modules/block_parameter.js +100 -0
- package/dest/modules/node_block_provider.d.ts +19 -0
- package/dest/modules/node_block_provider.d.ts.map +1 -0
- package/dest/modules/node_block_provider.js +112 -0
- package/dest/modules/node_tx_receipt.d.ts +24 -0
- package/dest/modules/node_tx_receipt.d.ts.map +1 -0
- package/dest/modules/node_tx_receipt.js +70 -0
- package/dest/modules/node_world_state_queries.d.ts +65 -0
- package/dest/modules/node_world_state_queries.d.ts.map +1 -0
- package/dest/modules/node_world_state_queries.js +272 -0
- package/dest/sentinel/config.d.ts +3 -2
- package/dest/sentinel/config.d.ts.map +1 -1
- package/dest/sentinel/config.js +15 -5
- package/dest/sentinel/factory.d.ts +5 -3
- package/dest/sentinel/factory.d.ts.map +1 -1
- package/dest/sentinel/factory.js +12 -5
- package/dest/sentinel/sentinel.d.ts +145 -21
- package/dest/sentinel/sentinel.d.ts.map +1 -1
- package/dest/sentinel/sentinel.js +226 -104
- package/dest/sentinel/store.d.ts +8 -8
- package/dest/sentinel/store.d.ts.map +1 -1
- package/dest/sentinel/store.js +25 -17
- package/dest/test/index.d.ts +3 -3
- package/dest/test/index.d.ts.map +1 -1
- package/package.json +28 -26
- package/src/aztec-node/block_response_helpers.ts +161 -0
- package/src/aztec-node/config.ts +30 -7
- package/src/aztec-node/node_public_calls_simulator.ts +394 -0
- package/src/aztec-node/public_data_overrides.ts +35 -0
- package/src/aztec-node/register_node_rpc_handlers.ts +29 -0
- package/src/aztec-node/server.ts +507 -1092
- package/src/bin/index.ts +19 -12
- package/src/factory.ts +697 -0
- package/src/index.ts +2 -0
- package/src/modules/block_parameter.ts +93 -0
- package/src/modules/node_block_provider.ts +149 -0
- package/src/modules/node_tx_receipt.ts +115 -0
- package/src/modules/node_world_state_queries.ts +374 -0
- package/src/sentinel/README.md +103 -0
- package/src/sentinel/config.ts +18 -6
- package/src/sentinel/factory.ts +21 -6
- package/src/sentinel/sentinel.ts +276 -129
- package/src/sentinel/store.ts +26 -18
- package/src/test/index.ts +2 -2
|
@@ -371,59 +371,59 @@ function _apply_decs_2203_r(targetClass, memberDecs, classDecs, parentClass) {
|
|
|
371
371
|
return (_apply_decs_2203_r = applyDecs2203RFactory())(targetClass, memberDecs, classDecs, parentClass);
|
|
372
372
|
}
|
|
373
373
|
var _dec, _initProto;
|
|
374
|
-
import { createArchiver } from '@aztec/archiver';
|
|
375
374
|
import { BBCircuitVerifier, BatchChonkVerifier, QueuedIVCVerifier } from '@aztec/bb-prover';
|
|
376
375
|
import { TestCircuitVerifier } from '@aztec/bb-prover/test';
|
|
377
|
-
import {
|
|
378
|
-
import { Blob } from '@aztec/blob-lib';
|
|
379
|
-
import { EpochCache } from '@aztec/epoch-cache';
|
|
380
|
-
import { createEthereumChain } from '@aztec/ethereum/chain';
|
|
381
|
-
import { getPublicClient, makeL1HttpTransport } from '@aztec/ethereum/client';
|
|
382
|
-
import { RegistryContract, RollupContract } from '@aztec/ethereum/contracts';
|
|
376
|
+
import { pickL1ContractAddresses } from '@aztec/ethereum/l1-contract-addresses';
|
|
383
377
|
import { BlockNumber } from '@aztec/foundation/branded-types';
|
|
384
|
-
import {
|
|
385
|
-
import { Fr } from '@aztec/foundation/curves/bn254';
|
|
378
|
+
import { compactArray, pick, unique } from '@aztec/foundation/collection';
|
|
386
379
|
import { EthAddress } from '@aztec/foundation/eth-address';
|
|
387
380
|
import { BadRequestError } from '@aztec/foundation/json-rpc';
|
|
388
381
|
import { createLogger } from '@aztec/foundation/log';
|
|
382
|
+
import { retryUntil } from '@aztec/foundation/retry';
|
|
389
383
|
import { count } from '@aztec/foundation/string';
|
|
390
|
-
import {
|
|
391
|
-
import { MembershipWitness } from '@aztec/foundation/trees';
|
|
384
|
+
import { Timer } from '@aztec/foundation/timer';
|
|
392
385
|
import { KeystoreManager, loadKeystores, mergeKeystores } from '@aztec/node-keystore';
|
|
393
|
-
import {
|
|
394
|
-
import {
|
|
395
|
-
import { createP2PClient, createTxValidatorForAcceptingTxsOverRPC, getDefaultAllowedSetupFunctions } from '@aztec/p2p';
|
|
386
|
+
import { uploadSnapshot } from '@aztec/node-lib/actions';
|
|
387
|
+
import { createTxValidatorForAcceptingTxsOverRPC, getDefaultAllowedSetupFunctions } from '@aztec/p2p';
|
|
396
388
|
import { ProtocolContractAddress } from '@aztec/protocol-contracts';
|
|
397
|
-
import {
|
|
398
|
-
import {
|
|
399
|
-
import {
|
|
400
|
-
import { PublicProcessorFactory } from '@aztec/simulator/server';
|
|
401
|
-
import { AttestationsBlockWatcher, EpochPruneWatcher, createSlasher } from '@aztec/slasher';
|
|
402
|
-
import { CollectionLimitsConfig, PublicSimulatorConfig } from '@aztec/stdlib/avm';
|
|
403
|
-
import { AztecAddress } from '@aztec/stdlib/aztec-address';
|
|
404
|
-
import { BlockHash, L2Block } from '@aztec/stdlib/block';
|
|
405
|
-
import { GasFees } from '@aztec/stdlib/gas';
|
|
406
|
-
import { computePublicDataTreeLeafSlot } from '@aztec/stdlib/hash';
|
|
389
|
+
import { STANDARD_MULTI_CALL_ENTRYPOINT_ADDRESS } from '@aztec/standard-contracts/multi-call-entrypoint';
|
|
390
|
+
import { inspectBlockParameter } from '@aztec/stdlib/block';
|
|
391
|
+
import { GasFees, getNetworkTxGasLimits } from '@aztec/stdlib/gas';
|
|
407
392
|
import { AztecNodeAdminConfigSchema } from '@aztec/stdlib/interfaces/client';
|
|
408
393
|
import { tryStop } from '@aztec/stdlib/interfaces/server';
|
|
409
|
-
import {
|
|
410
|
-
import { InboxLeaf } from '@aztec/stdlib/messaging';
|
|
411
|
-
import { MerkleTreeId, NullifierMembershipWitness, PublicDataWitness } from '@aztec/stdlib/trees';
|
|
412
|
-
import { PublicSimulationOutput, TxReceipt, TxStatus } from '@aztec/stdlib/tx';
|
|
413
|
-
import { getPackageVersion } from '@aztec/stdlib/update-checker';
|
|
394
|
+
import { NullDebugLogStore } from '@aztec/stdlib/logs';
|
|
414
395
|
import { Attributes, getTelemetryClient, trackSpan } from '@aztec/telemetry-client';
|
|
415
|
-
import {
|
|
416
|
-
import {
|
|
417
|
-
import {
|
|
418
|
-
import {
|
|
419
|
-
import { createKeyStoreForValidator } from './config.js';
|
|
396
|
+
import { NodeKeystoreAdapter, ValidatorClient } from '@aztec/validator-client';
|
|
397
|
+
import { NodeBlockProvider } from '../modules/node_block_provider.js';
|
|
398
|
+
import { NodeTxReceiptBuilder } from '../modules/node_tx_receipt.js';
|
|
399
|
+
import { NodeWorldStateQueries } from '../modules/node_world_state_queries.js';
|
|
420
400
|
import { NodeMetrics } from './node_metrics.js';
|
|
401
|
+
import { NodePublicCallsSimulator } from './node_public_calls_simulator.js';
|
|
421
402
|
_dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
422
403
|
[Attributes.TX_HASH]: tx.getTxHash().toString()
|
|
423
404
|
}));
|
|
424
405
|
/**
|
|
425
406
|
* The aztec node.
|
|
426
407
|
*/ export class AztecNodeService {
|
|
408
|
+
static{
|
|
409
|
+
({ e: [_initProto] } = _apply_decs_2203_r(this, [
|
|
410
|
+
[
|
|
411
|
+
_dec,
|
|
412
|
+
2,
|
|
413
|
+
"simulatePublicCalls"
|
|
414
|
+
]
|
|
415
|
+
], []));
|
|
416
|
+
}
|
|
417
|
+
metrics;
|
|
418
|
+
// Prevent two snapshot operations to happen simultaneously
|
|
419
|
+
isUploadingSnapshot = (_initProto(this), false);
|
|
420
|
+
// Saved minTxsPerBlock used by `pauseSequencer` to restore production-sequencer config on resume.
|
|
421
|
+
sequencerPausedMinTxsPerBlock;
|
|
422
|
+
nodePublicCallsSimulator;
|
|
423
|
+
worldStateQueries;
|
|
424
|
+
blockProvider;
|
|
425
|
+
txReceiptBuilder;
|
|
426
|
+
tracer;
|
|
427
427
|
config;
|
|
428
428
|
p2pClient;
|
|
429
429
|
blockSource;
|
|
@@ -435,10 +435,12 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
435
435
|
proverNode;
|
|
436
436
|
slasherClient;
|
|
437
437
|
validatorsSentinel;
|
|
438
|
-
|
|
438
|
+
stopStartedWatchers;
|
|
439
439
|
l1ChainId;
|
|
440
440
|
version;
|
|
441
441
|
globalVariableBuilder;
|
|
442
|
+
rollupContract;
|
|
443
|
+
feeProvider;
|
|
442
444
|
epochCache;
|
|
443
445
|
packageVersion;
|
|
444
446
|
peerProofVerifier;
|
|
@@ -449,56 +451,77 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
449
451
|
validatorClient;
|
|
450
452
|
keyStoreManager;
|
|
451
453
|
debugLogStore;
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
this.
|
|
468
|
-
this.
|
|
469
|
-
this.
|
|
470
|
-
this.
|
|
471
|
-
this.
|
|
472
|
-
this.
|
|
473
|
-
this.
|
|
474
|
-
this.
|
|
475
|
-
this.
|
|
476
|
-
this.
|
|
477
|
-
this.
|
|
478
|
-
this.
|
|
479
|
-
this.
|
|
480
|
-
this.
|
|
481
|
-
this.
|
|
482
|
-
this.
|
|
483
|
-
this.
|
|
484
|
-
this.
|
|
485
|
-
this.
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
this.
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
|
|
454
|
+
automineSequencer;
|
|
455
|
+
avmSimulator;
|
|
456
|
+
constructor(deps){
|
|
457
|
+
this.config = deps.config;
|
|
458
|
+
this.p2pClient = deps.p2pClient;
|
|
459
|
+
this.blockSource = deps.blockSource;
|
|
460
|
+
this.logsSource = deps.logsSource;
|
|
461
|
+
this.contractDataSource = deps.contractDataSource;
|
|
462
|
+
this.l1ToL2MessageSource = deps.l1ToL2MessageSource;
|
|
463
|
+
this.worldStateSynchronizer = deps.worldStateSynchronizer;
|
|
464
|
+
this.sequencer = deps.sequencer;
|
|
465
|
+
this.proverNode = deps.proverNode;
|
|
466
|
+
this.slasherClient = deps.slasherClient;
|
|
467
|
+
this.validatorsSentinel = deps.validatorsSentinel;
|
|
468
|
+
this.stopStartedWatchers = deps.stopStartedWatchers;
|
|
469
|
+
this.l1ChainId = deps.l1ChainId;
|
|
470
|
+
this.version = deps.version;
|
|
471
|
+
this.globalVariableBuilder = deps.globalVariableBuilder;
|
|
472
|
+
this.rollupContract = deps.rollupContract;
|
|
473
|
+
this.feeProvider = deps.feeProvider;
|
|
474
|
+
this.epochCache = deps.epochCache;
|
|
475
|
+
this.packageVersion = deps.packageVersion;
|
|
476
|
+
this.peerProofVerifier = deps.peerProofVerifier;
|
|
477
|
+
this.rpcProofVerifier = deps.rpcProofVerifier;
|
|
478
|
+
this.telemetry = deps.telemetry ?? getTelemetryClient();
|
|
479
|
+
this.log = deps.log ?? createLogger('node');
|
|
480
|
+
this.blobClient = deps.blobClient;
|
|
481
|
+
this.validatorClient = deps.validatorClient;
|
|
482
|
+
this.keyStoreManager = deps.keyStoreManager;
|
|
483
|
+
this.debugLogStore = deps.debugLogStore ?? new NullDebugLogStore();
|
|
484
|
+
this.automineSequencer = deps.automineSequencer;
|
|
485
|
+
this.avmSimulator = deps.avmSimulator;
|
|
486
|
+
this.metrics = new NodeMetrics(this.telemetry, 'AztecNodeService');
|
|
487
|
+
this.tracer = this.telemetry.getTracer('AztecNodeService');
|
|
488
|
+
// The node never represents a proposer's payout addresses, so the simulator zeroes coinbase and
|
|
489
|
+
// fee recipient. The signature context only needs chain id + rollup address (see signature_utils).
|
|
490
|
+
this.nodePublicCallsSimulator = new NodePublicCallsSimulator({
|
|
491
|
+
blockSource: this.blockSource,
|
|
492
|
+
worldStateSynchronizer: this.worldStateSynchronizer,
|
|
493
|
+
l1ToL2MessageSource: this.l1ToL2MessageSource,
|
|
494
|
+
contractDataSource: this.contractDataSource,
|
|
495
|
+
globalVariableBuilder: this.globalVariableBuilder,
|
|
496
|
+
rollupContract: this.rollupContract,
|
|
497
|
+
epochCache: this.epochCache,
|
|
498
|
+
signatureContext: {
|
|
499
|
+
chainId: this.l1ChainId,
|
|
500
|
+
rollupAddress: this.config.rollupAddress
|
|
501
|
+
},
|
|
502
|
+
config: this.config,
|
|
503
|
+
avmSimulator: this.avmSimulator,
|
|
504
|
+
telemetry: this.telemetry,
|
|
505
|
+
log: this.log.createChild('public-calls-simulator')
|
|
506
|
+
});
|
|
507
|
+
this.worldStateQueries = new NodeWorldStateQueries({
|
|
508
|
+
worldStateSynchronizer: this.worldStateSynchronizer,
|
|
509
|
+
blockSource: this.blockSource,
|
|
510
|
+
l1ToL2MessageSource: this.l1ToL2MessageSource,
|
|
511
|
+
log: this.log.createChild('world-state-queries')
|
|
512
|
+
});
|
|
513
|
+
this.blockProvider = new NodeBlockProvider(this.blockSource);
|
|
514
|
+
this.txReceiptBuilder = new NodeTxReceiptBuilder({
|
|
515
|
+
p2pClient: this.p2pClient,
|
|
516
|
+
blockSource: this.blockSource,
|
|
517
|
+
debugLogStore: this.debugLogStore
|
|
518
|
+
});
|
|
496
519
|
this.log.info(`Aztec Node version: ${this.packageVersion}`);
|
|
497
|
-
this.log.info(`Aztec Node started on chain 0x${l1ChainId.toString(16)}`, config
|
|
498
|
-
// A defensive check that protects us against introducing a bug in the complex
|
|
520
|
+
this.log.info(`Aztec Node started on chain 0x${this.l1ChainId.toString(16)}`, pickL1ContractAddresses(this.config));
|
|
521
|
+
// A defensive check that protects us against introducing a bug in the complex node creation flow. We must
|
|
499
522
|
// never have debugLogStore enabled when not in test mode because then we would be accumulating debug logs in
|
|
500
523
|
// memory which could be a DoS vector on the sequencer (since no fees are paid for debug logs).
|
|
501
|
-
if (debugLogStore.isEnabled && config.realProofs) {
|
|
524
|
+
if (this.debugLogStore.isEnabled && this.config.realProofs) {
|
|
502
525
|
throw new Error('debugLogStore should never be enabled when realProofs are set');
|
|
503
526
|
}
|
|
504
527
|
}
|
|
@@ -509,313 +532,58 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
509
532
|
const status = await this.worldStateSynchronizer.status();
|
|
510
533
|
return status.syncSummary;
|
|
511
534
|
}
|
|
512
|
-
|
|
535
|
+
getChainTips() {
|
|
513
536
|
return this.blockSource.getL2Tips();
|
|
514
537
|
}
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
|
|
525
|
-
|
|
526
|
-
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
|
|
533
|
-
const keyStores = loadKeystores(config.keyStoreDirectory);
|
|
534
|
-
keyStoreManager = new KeystoreManager(mergeKeystores(keyStores));
|
|
535
|
-
} else {
|
|
536
|
-
const rawKeyStores = [];
|
|
537
|
-
const validatorKeyStore = createKeyStoreForValidator(config);
|
|
538
|
-
if (validatorKeyStore) {
|
|
539
|
-
rawKeyStores.push(validatorKeyStore);
|
|
540
|
-
}
|
|
541
|
-
if (config.enableProverNode) {
|
|
542
|
-
const proverKeyStore = createKeyStoreForProver(config);
|
|
543
|
-
if (proverKeyStore) {
|
|
544
|
-
rawKeyStores.push(proverKeyStore);
|
|
545
|
-
}
|
|
546
|
-
}
|
|
547
|
-
if (rawKeyStores.length > 0) {
|
|
548
|
-
keyStoreManager = new KeystoreManager(rawKeyStores.length === 1 ? rawKeyStores[0] : mergeKeystores(rawKeyStores));
|
|
549
|
-
}
|
|
550
|
-
}
|
|
551
|
-
await keyStoreManager?.validateSigners();
|
|
552
|
-
// If we are a validator, verify our configuration before doing too much more.
|
|
553
|
-
if (!config.disableValidator) {
|
|
554
|
-
if (keyStoreManager === undefined) {
|
|
555
|
-
throw new Error('Failed to create key store, a requirement for running a validator');
|
|
556
|
-
}
|
|
557
|
-
if (!keyStoreProvided && process.env.NODE_ENV !== 'test') {
|
|
558
|
-
log.warn("Keystore created from env: it's recommended to use a file-based key store for production");
|
|
559
|
-
}
|
|
560
|
-
ValidatorClient.validateKeyStoreConfiguration(keyStoreManager, log);
|
|
561
|
-
}
|
|
562
|
-
// validate that the actual chain id matches that specified in configuration
|
|
563
|
-
if (config.l1ChainId !== ethereumChain.chainInfo.id) {
|
|
564
|
-
throw new Error(`RPC URL configured for chain id ${ethereumChain.chainInfo.id} but expected id ${config.l1ChainId}`);
|
|
565
|
-
}
|
|
566
|
-
const publicClient = createPublicClient({
|
|
567
|
-
chain: ethereumChain.chainInfo,
|
|
568
|
-
transport: makeL1HttpTransport(config.l1RpcUrls, {
|
|
569
|
-
timeout: config.l1HttpTimeoutMS
|
|
570
|
-
}),
|
|
571
|
-
pollingInterval: config.viemPollingIntervalMS
|
|
572
|
-
});
|
|
573
|
-
const l1ContractsAddresses = await RegistryContract.collectAddresses(publicClient, config.l1Contracts.registryAddress, config.rollupVersion ?? 'canonical');
|
|
574
|
-
// Overwrite the passed in vars.
|
|
575
|
-
config.l1Contracts = {
|
|
576
|
-
...config.l1Contracts,
|
|
577
|
-
...l1ContractsAddresses
|
|
578
|
-
};
|
|
579
|
-
const rollupContract = new RollupContract(publicClient, config.l1Contracts.rollupAddress.toString());
|
|
580
|
-
const [l1GenesisTime, slotDuration, rollupVersionFromRollup, rollupManaLimit] = await Promise.all([
|
|
581
|
-
rollupContract.getL1GenesisTime(),
|
|
582
|
-
rollupContract.getSlotDuration(),
|
|
583
|
-
rollupContract.getVersion(),
|
|
584
|
-
rollupContract.getManaLimit().then(Number)
|
|
585
|
-
]);
|
|
586
|
-
config.rollupVersion ??= Number(rollupVersionFromRollup);
|
|
587
|
-
if (config.rollupVersion !== Number(rollupVersionFromRollup)) {
|
|
588
|
-
log.warn(`Registry looked up and returned a rollup with version (${config.rollupVersion}), but this does not match with version detected from the rollup directly: (${rollupVersionFromRollup}).`);
|
|
589
|
-
}
|
|
590
|
-
const blobClient = await createBlobClientWithFileStores(config, log.createChild('blob-client'));
|
|
591
|
-
// attempt snapshot sync if possible
|
|
592
|
-
await trySnapshotSync(config, log);
|
|
593
|
-
const epochCache = await EpochCache.create(config.l1Contracts.rollupAddress, config, {
|
|
594
|
-
dateProvider
|
|
595
|
-
});
|
|
596
|
-
const archiver = await createArchiver(config, {
|
|
597
|
-
blobClient,
|
|
598
|
-
epochCache,
|
|
599
|
-
telemetry,
|
|
600
|
-
dateProvider
|
|
601
|
-
}, {
|
|
602
|
-
blockUntilSync: !config.skipArchiverInitialSync
|
|
603
|
-
});
|
|
604
|
-
// now create the merkle trees and the world state synchronizer
|
|
605
|
-
const worldStateSynchronizer = await createWorldStateSynchronizer(config, archiver, options.prefilledPublicData, telemetry);
|
|
606
|
-
const useRealVerifiers = config.realProofs || config.debugForceTxProofVerification;
|
|
607
|
-
let peerProofVerifier;
|
|
608
|
-
let rpcProofVerifier;
|
|
609
|
-
if (useRealVerifiers) {
|
|
610
|
-
peerProofVerifier = await BatchChonkVerifier.new(config, config.bbChonkVerifyMaxBatch, 'peer');
|
|
611
|
-
const rpcVerifier = await BBCircuitVerifier.new(config);
|
|
612
|
-
rpcProofVerifier = new QueuedIVCVerifier(rpcVerifier, config.numConcurrentIVCVerifiers);
|
|
613
|
-
} else {
|
|
614
|
-
peerProofVerifier = new TestCircuitVerifier(config.proverTestVerificationDelayMs);
|
|
615
|
-
rpcProofVerifier = new TestCircuitVerifier(config.proverTestVerificationDelayMs);
|
|
616
|
-
}
|
|
617
|
-
let debugLogStore;
|
|
618
|
-
if (!config.realProofs) {
|
|
619
|
-
log.warn(`Aztec node is accepting fake proofs`);
|
|
620
|
-
debugLogStore = new InMemoryDebugLogStore();
|
|
621
|
-
log.info('Aztec node started in test mode (realProofs set to false) hence debug logs from public functions will be collected and served');
|
|
622
|
-
} else {
|
|
623
|
-
debugLogStore = new NullDebugLogStore();
|
|
624
|
-
}
|
|
625
|
-
const proverOnly = config.enableProverNode && config.disableValidator;
|
|
626
|
-
if (proverOnly) {
|
|
627
|
-
log.info('Starting in prover-only mode: skipping validator, sequencer, sentinel, and slasher subsystems');
|
|
628
|
-
}
|
|
629
|
-
// create the tx pool and the p2p client, which will need the l2 block source
|
|
630
|
-
const p2pClient = await createP2PClient(config, archiver, peerProofVerifier, worldStateSynchronizer, epochCache, packageVersion, dateProvider, telemetry, deps.p2pClientDeps);
|
|
631
|
-
// We'll accumulate sentinel watchers here
|
|
632
|
-
const watchers = [];
|
|
633
|
-
// Create FullNodeCheckpointsBuilder for block proposal handling and tx validation.
|
|
634
|
-
// Override maxTxsPerCheckpoint with the validator-specific limit if set.
|
|
635
|
-
const validatorCheckpointsBuilder = new FullNodeCheckpointsBuilder({
|
|
636
|
-
...config,
|
|
637
|
-
l1GenesisTime,
|
|
638
|
-
slotDuration: Number(slotDuration),
|
|
639
|
-
rollupManaLimit,
|
|
640
|
-
maxTxsPerCheckpoint: config.validateMaxTxsPerCheckpoint
|
|
641
|
-
}, worldStateSynchronizer, archiver, dateProvider, telemetry);
|
|
642
|
-
let validatorClient;
|
|
643
|
-
if (!proverOnly) {
|
|
644
|
-
// Create validator client if required
|
|
645
|
-
validatorClient = await createValidatorClient(config, {
|
|
646
|
-
checkpointsBuilder: validatorCheckpointsBuilder,
|
|
647
|
-
worldState: worldStateSynchronizer,
|
|
648
|
-
p2pClient,
|
|
649
|
-
telemetry,
|
|
650
|
-
dateProvider,
|
|
651
|
-
epochCache,
|
|
652
|
-
blockSource: archiver,
|
|
653
|
-
l1ToL2MessageSource: archiver,
|
|
654
|
-
keyStoreManager,
|
|
655
|
-
blobClient,
|
|
656
|
-
slashingProtectionDb: deps.slashingProtectionDb
|
|
657
|
-
});
|
|
658
|
-
// If we have a validator client, register it as a source of offenses for the slasher,
|
|
659
|
-
// and have it register callbacks on the p2p client *before* we start it, otherwise messages
|
|
660
|
-
// like attestations or auths will fail.
|
|
661
|
-
if (validatorClient) {
|
|
662
|
-
watchers.push(validatorClient);
|
|
663
|
-
if (!options.dontStartSequencer) {
|
|
664
|
-
await validatorClient.registerHandlers();
|
|
665
|
-
}
|
|
666
|
-
}
|
|
667
|
-
}
|
|
668
|
-
// If there's no validator client, create a BlockProposalHandler to handle block proposals
|
|
669
|
-
// for monitoring or reexecution. Reexecution (default) allows us to follow the pending chain,
|
|
670
|
-
// while non-reexecution is used for validating the proposals and collecting their txs.
|
|
671
|
-
if (!validatorClient) {
|
|
672
|
-
const reexecute = !!config.alwaysReexecuteBlockProposals;
|
|
673
|
-
log.info(`Setting up block proposal handler` + (reexecute ? ' with reexecution of proposals' : ''));
|
|
674
|
-
createBlockProposalHandler(config, {
|
|
675
|
-
checkpointsBuilder: validatorCheckpointsBuilder,
|
|
676
|
-
worldState: worldStateSynchronizer,
|
|
677
|
-
epochCache,
|
|
678
|
-
blockSource: archiver,
|
|
679
|
-
l1ToL2MessageSource: archiver,
|
|
680
|
-
p2pClient,
|
|
681
|
-
dateProvider,
|
|
682
|
-
telemetry
|
|
683
|
-
}).register(p2pClient, reexecute);
|
|
684
|
-
}
|
|
685
|
-
// Start world state and wait for it to sync to the archiver.
|
|
686
|
-
await worldStateSynchronizer.start();
|
|
687
|
-
// Start p2p. Note that it depends on world state to be running.
|
|
688
|
-
await p2pClient.start();
|
|
689
|
-
let validatorsSentinel;
|
|
690
|
-
let epochPruneWatcher;
|
|
691
|
-
let attestationsBlockWatcher;
|
|
692
|
-
if (!proverOnly) {
|
|
693
|
-
validatorsSentinel = await createSentinel(epochCache, archiver, p2pClient, config);
|
|
694
|
-
if (validatorsSentinel && config.slashInactivityPenalty > 0n) {
|
|
695
|
-
watchers.push(validatorsSentinel);
|
|
696
|
-
}
|
|
697
|
-
if (config.slashPrunePenalty > 0n || config.slashDataWithholdingPenalty > 0n) {
|
|
698
|
-
epochPruneWatcher = new EpochPruneWatcher(archiver, archiver, epochCache, p2pClient.getTxProvider(), validatorCheckpointsBuilder, config);
|
|
699
|
-
watchers.push(epochPruneWatcher);
|
|
700
|
-
}
|
|
701
|
-
// We assume we want to slash for invalid attestations unless all max penalties are set to 0
|
|
702
|
-
if (config.slashProposeInvalidAttestationsPenalty > 0n || config.slashAttestDescendantOfInvalidPenalty > 0n) {
|
|
703
|
-
attestationsBlockWatcher = new AttestationsBlockWatcher(archiver, epochCache, config);
|
|
704
|
-
watchers.push(attestationsBlockWatcher);
|
|
705
|
-
}
|
|
706
|
-
}
|
|
707
|
-
// Start p2p-related services once the archiver has completed sync
|
|
708
|
-
void archiver.waitForInitialSync().then(async ()=>{
|
|
709
|
-
await p2pClient.start();
|
|
710
|
-
await validatorsSentinel?.start();
|
|
711
|
-
await epochPruneWatcher?.start();
|
|
712
|
-
await attestationsBlockWatcher?.start();
|
|
713
|
-
log.info(`All p2p services started`);
|
|
714
|
-
}).catch((err)=>log.error('Failed to start p2p services after archiver sync', err));
|
|
715
|
-
const globalVariableBuilder = new GlobalVariableBuilder(dateProvider, publicClient, {
|
|
716
|
-
l1Contracts: config.l1Contracts,
|
|
717
|
-
ethereumSlotDuration: config.ethereumSlotDuration,
|
|
718
|
-
rollupVersion: BigInt(config.rollupVersion),
|
|
719
|
-
l1GenesisTime,
|
|
720
|
-
slotDuration: Number(slotDuration)
|
|
721
|
-
});
|
|
722
|
-
// Validator enabled, create/start relevant service
|
|
723
|
-
let sequencer;
|
|
724
|
-
let slasherClient;
|
|
725
|
-
if (!config.disableValidator && validatorClient) {
|
|
726
|
-
// We create a slasher only if we have a sequencer, since all slashing actions go through the sequencer publisher
|
|
727
|
-
// as they are executed when the node is selected as proposer.
|
|
728
|
-
const validatorAddresses = keyStoreManager ? NodeKeystoreAdapter.fromKeyStoreManager(keyStoreManager).getAddresses() : [];
|
|
729
|
-
slasherClient = await createSlasher(config, config.l1Contracts, getPublicClient(config), watchers, dateProvider, epochCache, validatorAddresses, undefined);
|
|
730
|
-
await slasherClient.start();
|
|
731
|
-
const l1TxUtils = config.sequencerPublisherForwarderAddress ? await createForwarderL1TxUtilsFromSigners(publicClient, keyStoreManager.createAllValidatorPublisherSigners(), config.sequencerPublisherForwarderAddress, {
|
|
732
|
-
...config,
|
|
733
|
-
scope: 'sequencer'
|
|
734
|
-
}, {
|
|
735
|
-
telemetry,
|
|
736
|
-
logger: log.createChild('l1-tx-utils'),
|
|
737
|
-
dateProvider,
|
|
738
|
-
kzg: Blob.getViemKzgInstance()
|
|
739
|
-
}) : await createL1TxUtilsFromSigners(publicClient, keyStoreManager.createAllValidatorPublisherSigners(), {
|
|
740
|
-
...config,
|
|
741
|
-
scope: 'sequencer'
|
|
742
|
-
}, {
|
|
743
|
-
telemetry,
|
|
744
|
-
logger: log.createChild('l1-tx-utils'),
|
|
745
|
-
dateProvider,
|
|
746
|
-
kzg: Blob.getViemKzgInstance()
|
|
747
|
-
});
|
|
748
|
-
// Create a funder L1TxUtils from the keystore funding account (if configured)
|
|
749
|
-
const fundingSigner = keyStoreManager?.createFundingSigner();
|
|
750
|
-
let funderL1TxUtils;
|
|
751
|
-
if (fundingSigner) {
|
|
752
|
-
const [funder] = await createL1TxUtilsFromSigners(publicClient, [
|
|
753
|
-
fundingSigner
|
|
754
|
-
], {
|
|
755
|
-
...config,
|
|
756
|
-
scope: 'sequencer'
|
|
757
|
-
}, {
|
|
758
|
-
telemetry,
|
|
759
|
-
logger: log.createChild('l1-tx-utils:funder'),
|
|
760
|
-
dateProvider
|
|
761
|
-
});
|
|
762
|
-
funderL1TxUtils = funder;
|
|
763
|
-
}
|
|
764
|
-
// Create and start the sequencer client
|
|
765
|
-
const checkpointsBuilder = new CheckpointsBuilder({
|
|
766
|
-
...config,
|
|
767
|
-
l1GenesisTime,
|
|
768
|
-
slotDuration: Number(slotDuration),
|
|
769
|
-
rollupManaLimit
|
|
770
|
-
}, worldStateSynchronizer, archiver, dateProvider, telemetry, debugLogStore);
|
|
771
|
-
sequencer = await SequencerClient.new(config, {
|
|
772
|
-
...deps,
|
|
773
|
-
epochCache,
|
|
774
|
-
l1TxUtils,
|
|
775
|
-
funderL1TxUtils,
|
|
776
|
-
validatorClient,
|
|
777
|
-
p2pClient,
|
|
778
|
-
worldStateSynchronizer,
|
|
779
|
-
slasherClient,
|
|
780
|
-
checkpointsBuilder,
|
|
781
|
-
l2BlockSource: archiver,
|
|
782
|
-
l1ToL2MessageSource: archiver,
|
|
783
|
-
telemetry,
|
|
784
|
-
dateProvider,
|
|
785
|
-
blobClient,
|
|
786
|
-
nodeKeyStore: keyStoreManager,
|
|
787
|
-
globalVariableBuilder
|
|
788
|
-
});
|
|
789
|
-
}
|
|
790
|
-
if (!options.dontStartSequencer && sequencer) {
|
|
791
|
-
await sequencer.start();
|
|
792
|
-
log.verbose(`Sequencer started`);
|
|
793
|
-
} else if (sequencer) {
|
|
794
|
-
log.warn(`Sequencer created but not started`);
|
|
538
|
+
getL1Constants() {
|
|
539
|
+
return this.blockSource.getL1Constants();
|
|
540
|
+
}
|
|
541
|
+
getSyncedL2SlotNumber() {
|
|
542
|
+
return this.blockSource.getSyncedL2SlotNumber();
|
|
543
|
+
}
|
|
544
|
+
getSyncedL2EpochNumber() {
|
|
545
|
+
return this.blockSource.getSyncedL2EpochNumber();
|
|
546
|
+
}
|
|
547
|
+
getSyncedL1Timestamp() {
|
|
548
|
+
return this.blockSource.getL1Timestamp();
|
|
549
|
+
}
|
|
550
|
+
getCheckpointsData(query) {
|
|
551
|
+
return this.blockSource.getCheckpointsData(query);
|
|
552
|
+
}
|
|
553
|
+
async getBlockNumber(tip) {
|
|
554
|
+
if (tip === undefined || tip === 'proposed') {
|
|
555
|
+
return this.blockSource.getBlockNumber();
|
|
795
556
|
}
|
|
796
|
-
|
|
797
|
-
|
|
798
|
-
|
|
799
|
-
|
|
800
|
-
|
|
801
|
-
|
|
802
|
-
|
|
803
|
-
|
|
804
|
-
|
|
805
|
-
|
|
806
|
-
|
|
807
|
-
|
|
808
|
-
|
|
809
|
-
|
|
810
|
-
if (!options.dontStartProverNode) {
|
|
811
|
-
await proverNode.start();
|
|
812
|
-
log.info(`Prover node subsystem started`);
|
|
813
|
-
} else {
|
|
814
|
-
log.info(`Prover node subsystem created but not started`);
|
|
815
|
-
}
|
|
557
|
+
return await this.blockSource.getBlockNumber({
|
|
558
|
+
tag: tip
|
|
559
|
+
}) ?? BlockNumber.ZERO;
|
|
560
|
+
}
|
|
561
|
+
async getCheckpointNumber(tip) {
|
|
562
|
+
const tips = await this.blockSource.getL2Tips();
|
|
563
|
+
switch(tip){
|
|
564
|
+
case undefined:
|
|
565
|
+
case 'checkpointed':
|
|
566
|
+
return tips.checkpointed.checkpoint.number;
|
|
567
|
+
case 'proven':
|
|
568
|
+
return tips.proven.checkpoint.number;
|
|
569
|
+
case 'finalized':
|
|
570
|
+
return tips.finalized.checkpoint.number;
|
|
816
571
|
}
|
|
817
|
-
|
|
818
|
-
|
|
572
|
+
}
|
|
573
|
+
getBlock(param, options = {}) {
|
|
574
|
+
return this.blockProvider.getBlock(param, options);
|
|
575
|
+
}
|
|
576
|
+
getBlockData(param) {
|
|
577
|
+
return this.blockProvider.getBlockData(param);
|
|
578
|
+
}
|
|
579
|
+
getBlocks(from, limit, options = {}) {
|
|
580
|
+
return this.blockProvider.getBlocks(from, limit, options);
|
|
581
|
+
}
|
|
582
|
+
getCheckpoint(param, options = {}) {
|
|
583
|
+
return this.blockProvider.getCheckpoint(param, options);
|
|
584
|
+
}
|
|
585
|
+
getCheckpoints(from, limit, options = {}) {
|
|
586
|
+
return this.blockProvider.getCheckpoints(from, limit, options);
|
|
819
587
|
}
|
|
820
588
|
/**
|
|
821
589
|
* Returns the sequencer client instance.
|
|
@@ -823,6 +591,9 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
823
591
|
*/ getSequencer() {
|
|
824
592
|
return this.sequencer;
|
|
825
593
|
}
|
|
594
|
+
/** Test-only: returns the AutomineSequencer when wired via `useAutomineSequencer`. */ getAutomineSequencer() {
|
|
595
|
+
return this.automineSequencer;
|
|
596
|
+
}
|
|
826
597
|
/** Returns the prover node subsystem, if enabled. */ getProverNode() {
|
|
827
598
|
return this.proverNode;
|
|
828
599
|
}
|
|
@@ -839,7 +610,7 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
839
610
|
* Method to return the currently deployed L1 contract addresses.
|
|
840
611
|
* @returns - The currently deployed L1 contract addresses.
|
|
841
612
|
*/ getL1ContractAddresses() {
|
|
842
|
-
return Promise.resolve(this.config
|
|
613
|
+
return Promise.resolve(pickL1ContractAddresses(this.config));
|
|
843
614
|
}
|
|
844
615
|
getEncodedEnr() {
|
|
845
616
|
return Promise.resolve(this.p2pClient.getEnr()?.encodeTxt());
|
|
@@ -857,14 +628,20 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
857
628
|
return Promise.resolve(this.p2pClient.isReady() ?? false);
|
|
858
629
|
}
|
|
859
630
|
async getNodeInfo() {
|
|
860
|
-
const [nodeVersion, rollupVersion, chainId, enr, contractAddresses, protocolContractAddresses] = await Promise.all([
|
|
631
|
+
const [nodeVersion, rollupVersion, chainId, enr, contractAddresses, protocolContractAddresses, l1Constants] = await Promise.all([
|
|
861
632
|
this.getNodeVersion(),
|
|
862
633
|
this.getVersion(),
|
|
863
634
|
this.getChainId(),
|
|
864
635
|
this.getEncodedEnr(),
|
|
865
636
|
this.getL1ContractAddresses(),
|
|
866
|
-
this.getProtocolContractAddresses()
|
|
637
|
+
this.getProtocolContractAddresses(),
|
|
638
|
+
this.blockSource.getL1Constants()
|
|
867
639
|
]);
|
|
640
|
+
// Gas limits a single tx may declare on this network, derived from network-wide constants only (the
|
|
641
|
+
// timetable's blocks-per-checkpoint and the network-minimum per-block multipliers) — never this node's
|
|
642
|
+
// local caps or configured multipliers, which can make the node stricter at block-building time but
|
|
643
|
+
// cannot define what the network accepts for relay. Clients read txsLimits to set fallback gas limits.
|
|
644
|
+
const maxTxGas = getNetworkTxGasLimits(this.config, l1Constants);
|
|
868
645
|
const nodeInfo = {
|
|
869
646
|
nodeVersion,
|
|
870
647
|
l1ChainId: chainId,
|
|
@@ -872,71 +649,26 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
872
649
|
enr,
|
|
873
650
|
l1ContractAddresses: contractAddresses,
|
|
874
651
|
protocolContractAddresses: protocolContractAddresses,
|
|
875
|
-
realProofs: !!this.config.realProofs
|
|
652
|
+
realProofs: !!this.config.realProofs,
|
|
653
|
+
txsLimits: {
|
|
654
|
+
gas: {
|
|
655
|
+
daGas: maxTxGas.daGas,
|
|
656
|
+
l2Gas: maxTxGas.l2Gas
|
|
657
|
+
}
|
|
658
|
+
}
|
|
876
659
|
};
|
|
877
660
|
return nodeInfo;
|
|
878
661
|
}
|
|
879
|
-
|
|
880
|
-
|
|
881
|
-
* @param block - The block parameter (block number, block hash, or 'latest').
|
|
882
|
-
* @returns The requested block.
|
|
883
|
-
*/ async getBlock(block) {
|
|
884
|
-
if (BlockHash.isBlockHash(block)) {
|
|
885
|
-
return this.getBlockByHash(block);
|
|
886
|
-
}
|
|
887
|
-
const blockNumber = block === 'latest' ? await this.getBlockNumber() : block;
|
|
888
|
-
if (blockNumber === BlockNumber.ZERO) {
|
|
889
|
-
return this.buildInitialBlock();
|
|
890
|
-
}
|
|
891
|
-
return await this.blockSource.getL2Block(blockNumber);
|
|
892
|
-
}
|
|
893
|
-
/**
|
|
894
|
-
* Get a block specified by its hash.
|
|
895
|
-
* @param blockHash - The block hash being requested.
|
|
896
|
-
* @returns The requested block.
|
|
897
|
-
*/ async getBlockByHash(blockHash) {
|
|
898
|
-
const initialBlockHash = await this.#getInitialHeaderHash();
|
|
899
|
-
if (blockHash.equals(initialBlockHash)) {
|
|
900
|
-
return this.buildInitialBlock();
|
|
901
|
-
}
|
|
902
|
-
return await this.blockSource.getL2BlockByHash(blockHash);
|
|
903
|
-
}
|
|
904
|
-
buildInitialBlock() {
|
|
905
|
-
const initialHeader = this.worldStateSynchronizer.getCommitted().getInitialHeader();
|
|
906
|
-
return L2Block.empty(initialHeader);
|
|
662
|
+
async getCurrentMinFees() {
|
|
663
|
+
return await this.feeProvider.getCurrentMinFees();
|
|
907
664
|
}
|
|
908
|
-
/**
|
|
909
|
-
|
|
910
|
-
* @param archive - The archive root being requested.
|
|
911
|
-
* @returns The requested block.
|
|
912
|
-
*/ async getBlockByArchive(archive) {
|
|
913
|
-
return await this.blockSource.getL2BlockByArchive(archive);
|
|
914
|
-
}
|
|
915
|
-
/**
|
|
916
|
-
* Method to request blocks. Will attempt to return all requested blocks but will return only those available.
|
|
917
|
-
* @param from - The start of the range of blocks to return.
|
|
918
|
-
* @param limit - The maximum number of blocks to obtain.
|
|
919
|
-
* @returns The blocks requested.
|
|
920
|
-
*/ async getBlocks(from, limit) {
|
|
921
|
-
return await this.blockSource.getBlocks(from, BlockNumber(limit)) ?? [];
|
|
922
|
-
}
|
|
923
|
-
async getCheckpoints(from, limit) {
|
|
924
|
-
return await this.blockSource.getCheckpoints(from, limit) ?? [];
|
|
925
|
-
}
|
|
926
|
-
async getCheckpointedBlocks(from, limit) {
|
|
927
|
-
return await this.blockSource.getCheckpointedBlocks(from, limit) ?? [];
|
|
928
|
-
}
|
|
929
|
-
getCheckpointsDataForEpoch(epochNumber) {
|
|
930
|
-
return this.blockSource.getCheckpointsDataForEpoch(epochNumber);
|
|
931
|
-
}
|
|
932
|
-
/**
|
|
933
|
-
* Method to fetch the current min L2 fees.
|
|
934
|
-
* @returns The current min L2 fees.
|
|
935
|
-
*/ async getCurrentMinFees() {
|
|
936
|
-
return await this.globalVariableBuilder.getCurrentMinFees();
|
|
665
|
+
/** Returns predicted min fees for the current slot and next N slots. */ async getPredictedMinFees(manaUsage) {
|
|
666
|
+
return await this.feeProvider.getPredictedMinFees(manaUsage);
|
|
937
667
|
}
|
|
938
668
|
async getMaxPriorityFees() {
|
|
939
|
-
for await (const tx of this.p2pClient.iteratePendingTxs(
|
|
669
|
+
for await (const tx of this.p2pClient.iteratePendingTxs({
|
|
670
|
+
includeProof: false
|
|
671
|
+
})){
|
|
940
672
|
return tx.getGasSettings().maxPriorityFeesPerGas;
|
|
941
673
|
}
|
|
942
674
|
return GasFees.from({
|
|
@@ -945,21 +677,6 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
945
677
|
});
|
|
946
678
|
}
|
|
947
679
|
/**
|
|
948
|
-
* Method to fetch the latest block number synchronized by the node.
|
|
949
|
-
* @returns The block number.
|
|
950
|
-
*/ async getBlockNumber() {
|
|
951
|
-
return await this.blockSource.getBlockNumber();
|
|
952
|
-
}
|
|
953
|
-
async getProvenBlockNumber() {
|
|
954
|
-
return await this.blockSource.getProvenBlockNumber();
|
|
955
|
-
}
|
|
956
|
-
async getCheckpointedBlockNumber() {
|
|
957
|
-
return await this.blockSource.getCheckpointedL2BlockNumber();
|
|
958
|
-
}
|
|
959
|
-
getCheckpointNumber() {
|
|
960
|
-
return this.blockSource.getCheckpointNumber();
|
|
961
|
-
}
|
|
962
|
-
/**
|
|
963
680
|
* Method to fetch the version of the package.
|
|
964
681
|
* @returns The node package version
|
|
965
682
|
*/ getNodeVersion() {
|
|
@@ -980,54 +697,18 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
980
697
|
getContractClass(id) {
|
|
981
698
|
return this.contractDataSource.getContractClass(id);
|
|
982
699
|
}
|
|
983
|
-
getContract(address) {
|
|
984
|
-
|
|
985
|
-
|
|
986
|
-
|
|
987
|
-
let upToBlockNumber;
|
|
988
|
-
if (referenceBlock) {
|
|
989
|
-
const initialBlockHash = await this.#getInitialHeaderHash();
|
|
990
|
-
if (referenceBlock.equals(initialBlockHash)) {
|
|
991
|
-
upToBlockNumber = BlockNumber(0);
|
|
992
|
-
} else {
|
|
993
|
-
const header = await this.blockSource.getBlockHeaderByHash(referenceBlock);
|
|
994
|
-
if (!header) {
|
|
995
|
-
throw new Error(`Block ${referenceBlock.toString()} not found in the node. This might indicate a reorg has occurred.`);
|
|
996
|
-
}
|
|
997
|
-
upToBlockNumber = header.globalVariables.blockNumber;
|
|
998
|
-
}
|
|
700
|
+
async getContract(address, referenceBlock = 'latest') {
|
|
701
|
+
const blockData = await this.getBlockData(referenceBlock);
|
|
702
|
+
if (!blockData) {
|
|
703
|
+
throw new Error(`Reference block ${inspectBlockParameter(referenceBlock)} not found when querying contract ${address}. If the node API has been queried with an anchor block hash, possibly a reorg has occurred.`);
|
|
999
704
|
}
|
|
1000
|
-
return this.
|
|
1001
|
-
}
|
|
1002
|
-
async getPublicLogsByTagsFromContract(contractAddress, tags, page, referenceBlock) {
|
|
1003
|
-
let upToBlockNumber;
|
|
1004
|
-
if (referenceBlock) {
|
|
1005
|
-
const initialBlockHash = await this.#getInitialHeaderHash();
|
|
1006
|
-
if (referenceBlock.equals(initialBlockHash)) {
|
|
1007
|
-
upToBlockNumber = BlockNumber(0);
|
|
1008
|
-
} else {
|
|
1009
|
-
const header = await this.blockSource.getBlockHeaderByHash(referenceBlock);
|
|
1010
|
-
if (!header) {
|
|
1011
|
-
throw new Error(`Block ${referenceBlock.toString()} not found in the node. This might indicate a reorg has occurred.`);
|
|
1012
|
-
}
|
|
1013
|
-
upToBlockNumber = header.globalVariables.blockNumber;
|
|
1014
|
-
}
|
|
1015
|
-
}
|
|
1016
|
-
return this.logsSource.getPublicLogsByTagsFromContract(contractAddress, tags, page, upToBlockNumber);
|
|
705
|
+
return this.contractDataSource.getContract(address, blockData.header.globalVariables.timestamp);
|
|
1017
706
|
}
|
|
1018
|
-
|
|
1019
|
-
|
|
1020
|
-
* @param filter - The filter to apply to the logs.
|
|
1021
|
-
* @returns The requested logs.
|
|
1022
|
-
*/ getPublicLogs(filter) {
|
|
1023
|
-
return this.logsSource.getPublicLogs(filter);
|
|
707
|
+
getPrivateLogsByTags(query) {
|
|
708
|
+
return this.logsSource.getPrivateLogsByTags(query);
|
|
1024
709
|
}
|
|
1025
|
-
|
|
1026
|
-
|
|
1027
|
-
* @param filter - The filter to apply to the logs.
|
|
1028
|
-
* @returns The requested logs.
|
|
1029
|
-
*/ getContractClassLogs(filter) {
|
|
1030
|
-
return this.logsSource.getContractClassLogs(filter);
|
|
710
|
+
getPublicLogsByTags(query) {
|
|
711
|
+
return this.logsSource.getPublicLogsByTags(query);
|
|
1031
712
|
}
|
|
1032
713
|
/**
|
|
1033
714
|
* Method to submit a transaction to the p2p pool.
|
|
@@ -1047,34 +728,23 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
1047
728
|
});
|
|
1048
729
|
throw new Error(`Invalid tx: ${reason}`);
|
|
1049
730
|
}
|
|
1050
|
-
|
|
731
|
+
try {
|
|
732
|
+
await this.p2pClient.sendTx(tx);
|
|
733
|
+
} catch (err) {
|
|
734
|
+
this.metrics.receivedTx(timer.ms(), false);
|
|
735
|
+
this.log.warn(`Mempool rejected tx ${txHash}: ${err.message}`, {
|
|
736
|
+
txHash
|
|
737
|
+
});
|
|
738
|
+
throw err;
|
|
739
|
+
}
|
|
1051
740
|
const duration = timer.ms();
|
|
1052
741
|
this.metrics.receivedTx(duration, true);
|
|
1053
742
|
this.log.info(`Received tx ${txHash} in ${duration}ms`, {
|
|
1054
743
|
txHash
|
|
1055
744
|
});
|
|
1056
745
|
}
|
|
1057
|
-
|
|
1058
|
-
|
|
1059
|
-
// as a fallback if we don't find a settled receipt in the archiver.
|
|
1060
|
-
const txPoolStatus = await this.p2pClient.getTxStatus(txHash);
|
|
1061
|
-
const isKnownToPool = txPoolStatus === 'pending' || txPoolStatus === 'mined';
|
|
1062
|
-
// Then get the actual tx from the archiver, which tracks every tx in a mined block.
|
|
1063
|
-
const settledTxReceipt = await this.blockSource.getSettledTxReceipt(txHash);
|
|
1064
|
-
let receipt;
|
|
1065
|
-
if (settledTxReceipt) {
|
|
1066
|
-
receipt = settledTxReceipt;
|
|
1067
|
-
} else if (isKnownToPool) {
|
|
1068
|
-
// If the tx is in the pool but not in the archiver, it's pending.
|
|
1069
|
-
// This handles race conditions between archiver and p2p, where the archiver
|
|
1070
|
-
// has pruned the block in which a tx was mined, but p2p has not caught up yet.
|
|
1071
|
-
receipt = new TxReceipt(txHash, TxStatus.PENDING, undefined, undefined);
|
|
1072
|
-
} else {
|
|
1073
|
-
// Otherwise, if we don't know the tx, we consider it dropped.
|
|
1074
|
-
receipt = new TxReceipt(txHash, TxStatus.DROPPED, undefined, 'Tx dropped by P2P node');
|
|
1075
|
-
}
|
|
1076
|
-
this.debugLogStore.decorateReceiptWithLogs(txHash.toString(), receipt);
|
|
1077
|
-
return receipt;
|
|
746
|
+
getTxReceipt(txHash, options) {
|
|
747
|
+
return this.txReceiptBuilder.getTxReceipt(txHash, options);
|
|
1078
748
|
}
|
|
1079
749
|
getTxEffect(txHash) {
|
|
1080
750
|
return this.blockSource.getTxEffect(txHash);
|
|
@@ -1083,16 +753,20 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
1083
753
|
* Method to stop the aztec node.
|
|
1084
754
|
*/ async stop() {
|
|
1085
755
|
this.log.info(`Stopping Aztec Node`);
|
|
1086
|
-
await
|
|
1087
|
-
await tryStop(this.epochPruneWatcher);
|
|
756
|
+
await this.stopStartedWatchers();
|
|
1088
757
|
await tryStop(this.slasherClient);
|
|
1089
758
|
await Promise.all([
|
|
1090
759
|
tryStop(this.peerProofVerifier),
|
|
1091
760
|
tryStop(this.rpcProofVerifier)
|
|
1092
761
|
]);
|
|
1093
762
|
await tryStop(this.sequencer);
|
|
763
|
+
await tryStop(this.automineSequencer);
|
|
1094
764
|
await tryStop(this.proverNode);
|
|
1095
765
|
await tryStop(this.p2pClient);
|
|
766
|
+
// Dispose the AVM backend before world state: it kills the bb-avm-sim processes and closes the CDB IPC
|
|
767
|
+
// server, releasing their connections to the WSDB so it shuts down cleanly (and freeing the
|
|
768
|
+
// Server/Socket/ChildProcess handles that would otherwise keep the process alive after teardown).
|
|
769
|
+
await this.avmSimulator?.[Symbol.asyncDispose]();
|
|
1096
770
|
await tryStop(this.worldStateSynchronizer);
|
|
1097
771
|
await tryStop(this.blockSource);
|
|
1098
772
|
await tryStop(this.blobClient);
|
|
@@ -1110,272 +784,94 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
1110
784
|
* @param limit - The number of items to returns
|
|
1111
785
|
* @param after - The last known pending tx. Used for pagination
|
|
1112
786
|
* @returns - The pending txs.
|
|
1113
|
-
*/ getPendingTxs(limit, after) {
|
|
1114
|
-
return this.p2pClient.getPendingTxs(limit, after);
|
|
787
|
+
*/ getPendingTxs(limit, after, options) {
|
|
788
|
+
return this.p2pClient.getPendingTxs(limit, after, options);
|
|
1115
789
|
}
|
|
1116
790
|
getPendingTxCount() {
|
|
1117
791
|
return this.p2pClient.getPendingTxCount();
|
|
1118
792
|
}
|
|
793
|
+
getPeers(includePending) {
|
|
794
|
+
return this.p2pClient.getPeers(includePending);
|
|
795
|
+
}
|
|
796
|
+
getCheckpointAttestationsForSlot(slot, proposalPayloadHash) {
|
|
797
|
+
return this.p2pClient.getCheckpointAttestationsForSlot(slot, proposalPayloadHash);
|
|
798
|
+
}
|
|
799
|
+
getProposalsForSlot(slot) {
|
|
800
|
+
return this.p2pClient.getProposalsForSlot(slot);
|
|
801
|
+
}
|
|
1119
802
|
/**
|
|
1120
|
-
* Method to retrieve a single tx from the mempool or unfinalized chain.
|
|
803
|
+
* Method to retrieve a single tx from the mempool or unfinalized chain. The tx's proof is only loaded and returned
|
|
804
|
+
* when `includeProof` is set.
|
|
1121
805
|
* @param txHash - The transaction hash to return.
|
|
806
|
+
* @param options - Options for the returned tx (eg whether to include its proof).
|
|
1122
807
|
* @returns - The tx if it exists.
|
|
1123
|
-
*/ getTxByHash(txHash) {
|
|
1124
|
-
return
|
|
808
|
+
*/ getTxByHash(txHash, options) {
|
|
809
|
+
return this.p2pClient.getTxByHashFromPool(txHash, {
|
|
810
|
+
includeProof: !!options?.includeProof
|
|
811
|
+
});
|
|
1125
812
|
}
|
|
1126
813
|
/**
|
|
1127
|
-
* Method to retrieve txs from the mempool or unfinalized chain.
|
|
814
|
+
* Method to retrieve txs from the mempool or unfinalized chain. The txs' proofs are only loaded and returned when
|
|
815
|
+
* `includeProof` is set.
|
|
1128
816
|
* @param txHash - The transaction hash to return.
|
|
817
|
+
* @param options - Options for the returned txs (eg whether to include their proofs).
|
|
1129
818
|
* @returns - The txs if it exists.
|
|
1130
|
-
*/ async getTxsByHash(txHashes) {
|
|
1131
|
-
|
|
1132
|
-
|
|
1133
|
-
async findLeavesIndexes(referenceBlock, treeId, leafValues) {
|
|
1134
|
-
const committedDb = await this.getWorldState(referenceBlock);
|
|
1135
|
-
const maybeIndices = await committedDb.findLeafIndices(treeId, leafValues.map((x)=>x.toBuffer()));
|
|
1136
|
-
// Filter out undefined values to query block numbers only for found leaves
|
|
1137
|
-
const definedIndices = maybeIndices.filter((x)=>x !== undefined);
|
|
1138
|
-
// Now we find the block numbers for the defined indices
|
|
1139
|
-
const blockNumbers = await committedDb.getBlockNumbersForLeafIndices(treeId, definedIndices);
|
|
1140
|
-
// Build a map from leaf index to block number
|
|
1141
|
-
const indexToBlockNumber = new Map();
|
|
1142
|
-
for(let i = 0; i < definedIndices.length; i++){
|
|
1143
|
-
const blockNumber = blockNumbers[i];
|
|
1144
|
-
if (blockNumber === undefined) {
|
|
1145
|
-
throw new Error(`Block number is undefined for leaf index ${definedIndices[i]} in tree ${MerkleTreeId[treeId]}`);
|
|
1146
|
-
}
|
|
1147
|
-
indexToBlockNumber.set(definedIndices[i], blockNumber);
|
|
1148
|
-
}
|
|
1149
|
-
// Get unique block numbers in order to optimize num calls to getLeafValue function.
|
|
1150
|
-
const uniqueBlockNumbers = [
|
|
1151
|
-
...new Set(indexToBlockNumber.values())
|
|
1152
|
-
];
|
|
1153
|
-
// Now we obtain the block hashes from the archive tree (block number = leaf index in archive tree).
|
|
1154
|
-
const blockHashes = await Promise.all(uniqueBlockNumbers.map((blockNumber)=>{
|
|
1155
|
-
return committedDb.getLeafValue(MerkleTreeId.ARCHIVE, BigInt(blockNumber));
|
|
1156
|
-
}));
|
|
1157
|
-
// Build a map from block number to block hash
|
|
1158
|
-
const blockNumberToHash = new Map();
|
|
1159
|
-
for(let i = 0; i < uniqueBlockNumbers.length; i++){
|
|
1160
|
-
const blockHash = blockHashes[i];
|
|
1161
|
-
if (blockHash === undefined) {
|
|
1162
|
-
throw new Error(`Block hash is undefined for block number ${uniqueBlockNumbers[i]}`);
|
|
1163
|
-
}
|
|
1164
|
-
blockNumberToHash.set(uniqueBlockNumbers[i], blockHash);
|
|
1165
|
-
}
|
|
1166
|
-
// Create DataInBlock objects by combining indices, blockNumbers and blockHashes and return them.
|
|
1167
|
-
return maybeIndices.map((index)=>{
|
|
1168
|
-
if (index === undefined) {
|
|
1169
|
-
return undefined;
|
|
1170
|
-
}
|
|
1171
|
-
const blockNumber = indexToBlockNumber.get(index);
|
|
1172
|
-
if (blockNumber === undefined) {
|
|
1173
|
-
throw new Error(`Block number not found for leaf index ${index} in tree ${MerkleTreeId[treeId]}`);
|
|
1174
|
-
}
|
|
1175
|
-
const blockHash = blockNumberToHash.get(blockNumber);
|
|
1176
|
-
if (blockHash === undefined) {
|
|
1177
|
-
throw new Error(`Block hash not found for block number ${blockNumber}`);
|
|
1178
|
-
}
|
|
1179
|
-
return {
|
|
1180
|
-
l2BlockNumber: blockNumber,
|
|
1181
|
-
l2BlockHash: new BlockHash(blockHash),
|
|
1182
|
-
data: index
|
|
1183
|
-
};
|
|
819
|
+
*/ async getTxsByHash(txHashes, options) {
|
|
820
|
+
const txs = await this.p2pClient.getTxsByHashFromPool(txHashes, {
|
|
821
|
+
includeProof: !!options?.includeProof
|
|
1184
822
|
});
|
|
823
|
+
return compactArray(txs);
|
|
1185
824
|
}
|
|
1186
|
-
|
|
1187
|
-
|
|
1188
|
-
// which is the archive tree root BEFORE the anchor block was added (i.e. the state after block N-1).
|
|
1189
|
-
// So we need the world state at block N-1, not block N, to produce a sibling path matching that root.
|
|
1190
|
-
const referenceBlockNumber = await this.resolveBlockNumber(referenceBlock);
|
|
1191
|
-
if (referenceBlockNumber === BlockNumber.ZERO) {
|
|
1192
|
-
// Block 0 (the initial block) has an empty archive, so no membership witness can exist.
|
|
1193
|
-
return undefined;
|
|
1194
|
-
}
|
|
1195
|
-
const committedDb = await this.getWorldState(BlockNumber(referenceBlockNumber - 1));
|
|
1196
|
-
const [pathAndIndex] = await committedDb.findSiblingPaths(MerkleTreeId.ARCHIVE, [
|
|
1197
|
-
blockHash
|
|
1198
|
-
]);
|
|
1199
|
-
return pathAndIndex === undefined ? undefined : MembershipWitness.fromSiblingPath(pathAndIndex.index, pathAndIndex.path);
|
|
825
|
+
findLeavesIndexes(referenceBlock, treeId, leafValues) {
|
|
826
|
+
return this.worldStateQueries.findLeavesIndexes(referenceBlock, treeId, leafValues);
|
|
1200
827
|
}
|
|
1201
|
-
|
|
1202
|
-
|
|
1203
|
-
const [pathAndIndex] = await committedDb.findSiblingPaths(MerkleTreeId.NOTE_HASH_TREE, [
|
|
1204
|
-
noteHash
|
|
1205
|
-
]);
|
|
1206
|
-
return pathAndIndex === undefined ? undefined : MembershipWitness.fromSiblingPath(pathAndIndex.index, pathAndIndex.path);
|
|
828
|
+
getBlockHashMembershipWitness(referenceBlock, blockHash) {
|
|
829
|
+
return this.worldStateQueries.getBlockHashMembershipWitness(referenceBlock, blockHash);
|
|
1207
830
|
}
|
|
1208
|
-
|
|
1209
|
-
|
|
1210
|
-
const [witness] = await db.findSiblingPaths(MerkleTreeId.L1_TO_L2_MESSAGE_TREE, [
|
|
1211
|
-
l1ToL2Message
|
|
1212
|
-
]);
|
|
1213
|
-
if (!witness) {
|
|
1214
|
-
return undefined;
|
|
1215
|
-
}
|
|
1216
|
-
// REFACTOR: Return a MembershipWitness object
|
|
1217
|
-
return [
|
|
1218
|
-
witness.index,
|
|
1219
|
-
witness.path
|
|
1220
|
-
];
|
|
831
|
+
getNoteHashMembershipWitness(referenceBlock, noteHash) {
|
|
832
|
+
return this.worldStateQueries.getNoteHashMembershipWitness(referenceBlock, noteHash);
|
|
1221
833
|
}
|
|
1222
|
-
|
|
1223
|
-
|
|
1224
|
-
return messageIndex ? InboxLeaf.checkpointNumberFromIndex(messageIndex) : undefined;
|
|
834
|
+
getL1ToL2MessageMembershipWitness(referenceBlock, l1ToL2Message) {
|
|
835
|
+
return this.worldStateQueries.getL1ToL2MessageMembershipWitness(referenceBlock, l1ToL2Message);
|
|
1225
836
|
}
|
|
1226
|
-
|
|
1227
|
-
|
|
1228
|
-
* @param l1ToL2Message - The L1 to L2 message to check.
|
|
1229
|
-
* @returns Whether the message is synced and ready to be included in a block.
|
|
1230
|
-
*/ async isL1ToL2MessageSynced(l1ToL2Message) {
|
|
1231
|
-
const messageIndex = await this.l1ToL2MessageSource.getL1ToL2MessageIndex(l1ToL2Message);
|
|
1232
|
-
return messageIndex !== undefined;
|
|
837
|
+
getL1ToL2MessageCheckpoint(l1ToL2Message) {
|
|
838
|
+
return this.worldStateQueries.getL1ToL2MessageCheckpoint(l1ToL2Message);
|
|
1233
839
|
}
|
|
1234
840
|
/**
|
|
1235
841
|
* Returns all the L2 to L1 messages in an epoch.
|
|
842
|
+
*
|
|
843
|
+
* @deprecated Use {@link getL2ToL1MembershipWitness} to get an L2-to-L1 message witness directly.
|
|
844
|
+
*
|
|
1236
845
|
* @param epoch - The epoch at which to get the data.
|
|
1237
846
|
* @returns The L2 to L1 messages (empty array if the epoch is not found).
|
|
1238
|
-
*/
|
|
1239
|
-
|
|
1240
|
-
const checkpointedBlocks = await this.blockSource.getCheckpointedBlocksForEpoch(epoch);
|
|
1241
|
-
const blocksInCheckpoints = chunkBy(checkpointedBlocks, (cb)=>cb.block.header.globalVariables.slotNumber).map((group)=>group.map((cb)=>cb.block));
|
|
1242
|
-
return blocksInCheckpoints.map((blocks)=>blocks.map((block)=>block.body.txEffects.map((txEffect)=>txEffect.l2ToL1Msgs)));
|
|
1243
|
-
}
|
|
1244
|
-
async getNullifierMembershipWitness(referenceBlock, nullifier) {
|
|
1245
|
-
const db = await this.getWorldState(referenceBlock);
|
|
1246
|
-
const [witness] = await db.findSiblingPaths(MerkleTreeId.NULLIFIER_TREE, [
|
|
1247
|
-
nullifier.toBuffer()
|
|
1248
|
-
]);
|
|
1249
|
-
if (!witness) {
|
|
1250
|
-
return undefined;
|
|
1251
|
-
}
|
|
1252
|
-
const { index, path } = witness;
|
|
1253
|
-
const leafPreimage = await db.getLeafPreimage(MerkleTreeId.NULLIFIER_TREE, index);
|
|
1254
|
-
if (!leafPreimage) {
|
|
1255
|
-
return undefined;
|
|
1256
|
-
}
|
|
1257
|
-
return new NullifierMembershipWitness(index, leafPreimage, path);
|
|
847
|
+
*/ getL2ToL1Messages(epoch) {
|
|
848
|
+
return this.worldStateQueries.getL2ToL1Messages(epoch);
|
|
1258
849
|
}
|
|
1259
|
-
|
|
1260
|
-
|
|
1261
|
-
|
|
1262
|
-
|
|
1263
|
-
|
|
1264
|
-
}
|
|
1265
|
-
const { index, alreadyPresent } = findResult;
|
|
1266
|
-
if (alreadyPresent) {
|
|
1267
|
-
throw new Error(`Cannot prove nullifier non-inclusion: nullifier ${nullifier.toBigInt()} already exists in the tree`);
|
|
1268
|
-
}
|
|
1269
|
-
const preimageData = await committedDb.getLeafPreimage(MerkleTreeId.NULLIFIER_TREE, index);
|
|
1270
|
-
const siblingPath = await committedDb.getSiblingPath(MerkleTreeId.NULLIFIER_TREE, BigInt(index));
|
|
1271
|
-
return new NullifierMembershipWitness(BigInt(index), preimageData, siblingPath);
|
|
1272
|
-
}
|
|
1273
|
-
async getPublicDataWitness(referenceBlock, leafSlot) {
|
|
1274
|
-
const committedDb = await this.getWorldState(referenceBlock);
|
|
1275
|
-
const lowLeafResult = await committedDb.getPreviousValueIndex(MerkleTreeId.PUBLIC_DATA_TREE, leafSlot.toBigInt());
|
|
1276
|
-
if (!lowLeafResult) {
|
|
1277
|
-
return undefined;
|
|
1278
|
-
} else {
|
|
1279
|
-
const preimage = await committedDb.getLeafPreimage(MerkleTreeId.PUBLIC_DATA_TREE, lowLeafResult.index);
|
|
1280
|
-
const path = await committedDb.getSiblingPath(MerkleTreeId.PUBLIC_DATA_TREE, lowLeafResult.index);
|
|
1281
|
-
return new PublicDataWitness(lowLeafResult.index, preimage, path);
|
|
1282
|
-
}
|
|
850
|
+
/**
|
|
851
|
+
* Returns the L2-to-L1 membership witness for a message in `txHash`. Passthrough to the
|
|
852
|
+
* archiver's locally-cached resolver — see {@link Archiver.getL2ToL1MembershipWitness}.
|
|
853
|
+
*/ getL2ToL1MembershipWitness(txHash, message, messageIndexInTx) {
|
|
854
|
+
return this.worldStateQueries.getL2ToL1MembershipWitness(txHash, message, messageIndexInTx);
|
|
1283
855
|
}
|
|
1284
|
-
|
|
1285
|
-
|
|
1286
|
-
const leafSlot = await computePublicDataTreeLeafSlot(contract, slot);
|
|
1287
|
-
const lowLeafResult = await committedDb.getPreviousValueIndex(MerkleTreeId.PUBLIC_DATA_TREE, leafSlot.toBigInt());
|
|
1288
|
-
if (!lowLeafResult || !lowLeafResult.alreadyPresent) {
|
|
1289
|
-
return Fr.ZERO;
|
|
1290
|
-
}
|
|
1291
|
-
const preimage = await committedDb.getLeafPreimage(MerkleTreeId.PUBLIC_DATA_TREE, lowLeafResult.index);
|
|
1292
|
-
return preimage.leaf.value;
|
|
1293
|
-
}
|
|
1294
|
-
async getBlockHeader(block = 'latest') {
|
|
1295
|
-
if (BlockHash.isBlockHash(block)) {
|
|
1296
|
-
const initialBlockHash = await this.#getInitialHeaderHash();
|
|
1297
|
-
if (block.equals(initialBlockHash)) {
|
|
1298
|
-
// Block source doesn't handle initial header so we need to handle the case separately.
|
|
1299
|
-
return this.worldStateSynchronizer.getCommitted().getInitialHeader();
|
|
1300
|
-
}
|
|
1301
|
-
return this.blockSource.getBlockHeaderByHash(block);
|
|
1302
|
-
} else {
|
|
1303
|
-
// Block source doesn't handle initial header so we need to handle the case separately.
|
|
1304
|
-
const blockNumber = block === 'latest' ? await this.getBlockNumber() : block;
|
|
1305
|
-
if (blockNumber === BlockNumber.ZERO) {
|
|
1306
|
-
return this.worldStateSynchronizer.getCommitted().getInitialHeader();
|
|
1307
|
-
}
|
|
1308
|
-
return this.blockSource.getBlockHeader(block);
|
|
1309
|
-
}
|
|
856
|
+
getNullifierMembershipWitness(referenceBlock, nullifier) {
|
|
857
|
+
return this.worldStateQueries.getNullifierMembershipWitness(referenceBlock, nullifier);
|
|
1310
858
|
}
|
|
1311
|
-
|
|
1312
|
-
|
|
1313
|
-
* @param archive - The archive root being requested.
|
|
1314
|
-
* @returns The requested block header.
|
|
1315
|
-
*/ async getBlockHeaderByArchive(archive) {
|
|
1316
|
-
return await this.blockSource.getBlockHeaderByArchive(archive);
|
|
859
|
+
getLowNullifierMembershipWitness(referenceBlock, nullifier) {
|
|
860
|
+
return this.worldStateQueries.getLowNullifierMembershipWitness(referenceBlock, nullifier);
|
|
1317
861
|
}
|
|
1318
|
-
|
|
1319
|
-
return this.
|
|
862
|
+
getPublicDataWitness(referenceBlock, leafSlot) {
|
|
863
|
+
return this.worldStateQueries.getPublicDataWitness(referenceBlock, leafSlot);
|
|
1320
864
|
}
|
|
1321
|
-
|
|
1322
|
-
return this.
|
|
865
|
+
getPublicStorageAt(referenceBlock, contract, slot) {
|
|
866
|
+
return this.worldStateQueries.getPublicStorageAt(referenceBlock, contract, slot);
|
|
1323
867
|
}
|
|
1324
868
|
/**
|
|
1325
869
|
* Simulates the public part of a transaction with the current state.
|
|
1326
870
|
* @param tx - The transaction to simulate.
|
|
1327
|
-
|
|
1328
|
-
|
|
1329
|
-
|
|
1330
|
-
|
|
1331
|
-
const teardownGasLimit = gasSettings.teardownGasLimits.l2Gas;
|
|
1332
|
-
if (txGasLimit + teardownGasLimit > this.config.rpcSimulatePublicMaxGasLimit) {
|
|
1333
|
-
throw new BadRequestError(`Transaction total gas limit ${txGasLimit + teardownGasLimit} (${txGasLimit} + ${teardownGasLimit}) exceeds maximum gas limit ${this.config.rpcSimulatePublicMaxGasLimit} for simulation`);
|
|
1334
|
-
}
|
|
1335
|
-
const txHash = tx.getTxHash();
|
|
1336
|
-
const latestBlockNumber = await this.blockSource.getBlockNumber();
|
|
1337
|
-
const blockNumber = BlockNumber.add(latestBlockNumber, 1);
|
|
1338
|
-
// If sequencer is not initialized, we just set these values to zero for simulation.
|
|
1339
|
-
const coinbase = EthAddress.ZERO;
|
|
1340
|
-
const feeRecipient = AztecAddress.ZERO;
|
|
1341
|
-
const newGlobalVariables = await this.globalVariableBuilder.buildGlobalVariables(blockNumber, coinbase, feeRecipient);
|
|
1342
|
-
const publicProcessorFactory = new PublicProcessorFactory(this.contractDataSource, new DateProvider(), this.telemetry, this.log.getBindings());
|
|
1343
|
-
this.log.verbose(`Simulating public calls for tx ${txHash}`, {
|
|
1344
|
-
globalVariables: newGlobalVariables.toInspect(),
|
|
1345
|
-
txHash,
|
|
1346
|
-
blockNumber
|
|
1347
|
-
});
|
|
1348
|
-
// Ensure world-state has caught up with the latest block we loaded from the archiver
|
|
1349
|
-
await this.worldStateSynchronizer.syncImmediate(latestBlockNumber);
|
|
1350
|
-
const merkleTreeFork = await this.worldStateSynchronizer.fork();
|
|
1351
|
-
try {
|
|
1352
|
-
const config = PublicSimulatorConfig.from({
|
|
1353
|
-
skipFeeEnforcement,
|
|
1354
|
-
collectDebugLogs: true,
|
|
1355
|
-
collectHints: false,
|
|
1356
|
-
collectCallMetadata: true,
|
|
1357
|
-
collectStatistics: false,
|
|
1358
|
-
collectionLimits: CollectionLimitsConfig.from({
|
|
1359
|
-
maxDebugLogMemoryReads: this.config.rpcSimulatePublicMaxDebugLogMemoryReads
|
|
1360
|
-
})
|
|
1361
|
-
});
|
|
1362
|
-
const processor = publicProcessorFactory.create(merkleTreeFork, newGlobalVariables, config);
|
|
1363
|
-
// REFACTOR: Consider merging ProcessReturnValues into ProcessedTx
|
|
1364
|
-
const [processedTxs, failedTxs, _usedTxs, returns, debugLogs] = await processor.process([
|
|
1365
|
-
tx
|
|
1366
|
-
]);
|
|
1367
|
-
// REFACTOR: Consider returning the error rather than throwing
|
|
1368
|
-
if (failedTxs.length) {
|
|
1369
|
-
this.log.warn(`Simulated tx ${txHash} fails: ${failedTxs[0].error}`, {
|
|
1370
|
-
txHash
|
|
1371
|
-
});
|
|
1372
|
-
throw failedTxs[0].error;
|
|
1373
|
-
}
|
|
1374
|
-
const [processedTx] = processedTxs;
|
|
1375
|
-
return new PublicSimulationOutput(processedTx.revertReason, processedTx.globalVariables, processedTx.txEffect, returns, processedTx.gasUsed, debugLogs);
|
|
1376
|
-
} finally{
|
|
1377
|
-
await merkleTreeFork.close();
|
|
1378
|
-
}
|
|
871
|
+
* @param skipFeeEnforcement - If true, fee enforcement is skipped.
|
|
872
|
+
* @param overrides - Optional pre-simulation overrides applied to the ephemeral fork and contract DB.
|
|
873
|
+
**/ simulatePublicCalls(tx, skipFeeEnforcement = false, overrides) {
|
|
874
|
+
return this.nodePublicCallsSimulator.simulate(tx, skipFeeEnforcement, overrides);
|
|
1379
875
|
}
|
|
1380
876
|
async isValidTx(tx, { isSimulation, skipFeeEnforcement } = {}) {
|
|
1381
877
|
const db = this.worldStateSynchronizer.getCommitted();
|
|
@@ -1384,6 +880,9 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
1384
880
|
const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
|
|
1385
881
|
const blockNumber = BlockNumber(await this.blockSource.getBlockNumber() + 1);
|
|
1386
882
|
const l1Constants = await this.blockSource.getL1Constants();
|
|
883
|
+
// Enforce the same network admission limit the node advertises in getNodeInfo (network-wide, not this
|
|
884
|
+
// node's local caps), so a tx the wallet sized against txsLimits is not rejected here.
|
|
885
|
+
const networkTxGasLimits = getNetworkTxGasLimits(this.config, l1Constants);
|
|
1387
886
|
const validator = createTxValidatorForAcceptingTxsOverRPC(db, this.contractDataSource, verifier, {
|
|
1388
887
|
timestamp: nextSlotTimestamp,
|
|
1389
888
|
blockNumber,
|
|
@@ -1395,10 +894,10 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
1395
894
|
],
|
|
1396
895
|
gasFees: await this.getCurrentMinFees(),
|
|
1397
896
|
skipFeeEnforcement,
|
|
897
|
+
isSimulation,
|
|
1398
898
|
txsPermitted: !this.config.disableTransactions,
|
|
1399
|
-
|
|
1400
|
-
|
|
1401
|
-
maxBlockDAGas: this.config.validateMaxDABlockGas
|
|
899
|
+
maxTxL2Gas: networkTxGasLimits.l2Gas,
|
|
900
|
+
maxTxDAGas: networkTxGasLimits.daGas
|
|
1402
901
|
}, this.log.getBindings());
|
|
1403
902
|
return await validator.validateTx(tx);
|
|
1404
903
|
}
|
|
@@ -1412,7 +911,20 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
1412
911
|
...this.config,
|
|
1413
912
|
...config
|
|
1414
913
|
};
|
|
1415
|
-
|
|
914
|
+
// If the sequencer is currently paused via pauseSequencer(), record the caller's desired
|
|
915
|
+
// minTxsPerBlock as the restore value (so resumeSequencer applies it) and keep the freeze
|
|
916
|
+
// (MAX_SAFE_INTEGER) applied to the underlying sequencer. Without this guard, forwarding
|
|
917
|
+
// the new minTxsPerBlock to the sequencer would silently unpause block production while
|
|
918
|
+
// pauseSequencer() still considers it paused.
|
|
919
|
+
const sequencerUpdate = {
|
|
920
|
+
...config
|
|
921
|
+
};
|
|
922
|
+
if (this.sequencerPausedMinTxsPerBlock !== undefined && sequencerUpdate.minTxsPerBlock !== undefined) {
|
|
923
|
+
this.sequencerPausedMinTxsPerBlock = sequencerUpdate.minTxsPerBlock;
|
|
924
|
+
delete sequencerUpdate.minTxsPerBlock;
|
|
925
|
+
}
|
|
926
|
+
this.sequencer?.updateConfig(sequencerUpdate);
|
|
927
|
+
this.automineSequencer?.updateConfig(sequencerUpdate);
|
|
1416
928
|
this.slasherClient?.updateConfig(config);
|
|
1417
929
|
this.validatorsSentinel?.updateConfig(config);
|
|
1418
930
|
await this.p2pClient.updateP2PConfig(config);
|
|
@@ -1441,7 +953,7 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
1441
953
|
classRegistry: ProtocolContractAddress.ContractClassRegistry,
|
|
1442
954
|
feeJuice: ProtocolContractAddress.FeeJuice,
|
|
1443
955
|
instanceRegistry: ProtocolContractAddress.ContractInstanceRegistry,
|
|
1444
|
-
multiCallEntrypoint:
|
|
956
|
+
multiCallEntrypoint: STANDARD_MULTI_CALL_ENTRYPOINT_ADDRESS
|
|
1445
957
|
});
|
|
1446
958
|
}
|
|
1447
959
|
registerContractFunctionSignatures(signatures) {
|
|
@@ -1492,7 +1004,7 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
1492
1004
|
});
|
|
1493
1005
|
return Promise.resolve();
|
|
1494
1006
|
}
|
|
1495
|
-
async rollbackTo(targetBlock, force) {
|
|
1007
|
+
async rollbackTo(targetBlock, force, resumeSync = true) {
|
|
1496
1008
|
const archiver = this.blockSource;
|
|
1497
1009
|
if (!('rollbackTo' in archiver)) {
|
|
1498
1010
|
throw new Error('Archiver implementation does not support rollbacks.');
|
|
@@ -1520,9 +1032,13 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
1520
1032
|
this.log.error(`Error during rollback`, err);
|
|
1521
1033
|
throw err;
|
|
1522
1034
|
} finally{
|
|
1523
|
-
|
|
1524
|
-
|
|
1525
|
-
|
|
1035
|
+
if (resumeSync) {
|
|
1036
|
+
this.log.info(`Resuming world state and archiver sync.`);
|
|
1037
|
+
this.worldStateSynchronizer.resumeSync();
|
|
1038
|
+
archiver.resume();
|
|
1039
|
+
} else {
|
|
1040
|
+
this.log.info(`Sync left paused after rollback (resumeSync=false).`);
|
|
1041
|
+
}
|
|
1526
1042
|
}
|
|
1527
1043
|
}
|
|
1528
1044
|
async pauseSync() {
|
|
@@ -1536,18 +1052,51 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
1536
1052
|
this.blockSource.resume();
|
|
1537
1053
|
return Promise.resolve();
|
|
1538
1054
|
}
|
|
1539
|
-
|
|
1540
|
-
if (
|
|
1541
|
-
|
|
1055
|
+
pauseSequencer() {
|
|
1056
|
+
if (this.automineSequencer) {
|
|
1057
|
+
this.automineSequencer.pause();
|
|
1058
|
+
return Promise.resolve();
|
|
1059
|
+
}
|
|
1060
|
+
if (this.sequencer) {
|
|
1061
|
+
if (this.sequencerPausedMinTxsPerBlock === undefined) {
|
|
1062
|
+
this.sequencerPausedMinTxsPerBlock = this.sequencer.getSequencer().getConfig().minTxsPerBlock ?? 0;
|
|
1063
|
+
this.sequencer.updateConfig({
|
|
1064
|
+
minTxsPerBlock: Number.MAX_SAFE_INTEGER
|
|
1065
|
+
});
|
|
1066
|
+
this.log.info(`Sequencer paused (minTxsPerBlock set to MAX_SAFE_INTEGER)`, {
|
|
1067
|
+
previousMinTxsPerBlock: this.sequencerPausedMinTxsPerBlock
|
|
1068
|
+
});
|
|
1069
|
+
}
|
|
1070
|
+
return Promise.resolve();
|
|
1542
1071
|
}
|
|
1543
|
-
|
|
1072
|
+
throw new BadRequestError('Cannot pause sequencer: no sequencer is running');
|
|
1073
|
+
}
|
|
1074
|
+
resumeSequencer() {
|
|
1075
|
+
if (this.automineSequencer) {
|
|
1076
|
+
this.automineSequencer.resume();
|
|
1077
|
+
return Promise.resolve();
|
|
1078
|
+
}
|
|
1079
|
+
if (this.sequencer) {
|
|
1080
|
+
if (this.sequencerPausedMinTxsPerBlock !== undefined) {
|
|
1081
|
+
const restored = this.sequencerPausedMinTxsPerBlock;
|
|
1082
|
+
this.sequencerPausedMinTxsPerBlock = undefined;
|
|
1083
|
+
this.sequencer.updateConfig({
|
|
1084
|
+
minTxsPerBlock: restored
|
|
1085
|
+
});
|
|
1086
|
+
this.log.info(`Sequencer resumed (minTxsPerBlock restored)`, {
|
|
1087
|
+
minTxsPerBlock: restored
|
|
1088
|
+
});
|
|
1089
|
+
}
|
|
1090
|
+
return Promise.resolve();
|
|
1091
|
+
}
|
|
1092
|
+
throw new BadRequestError('Cannot resume sequencer: no sequencer is running');
|
|
1544
1093
|
}
|
|
1545
1094
|
getSlashOffenses(round) {
|
|
1546
1095
|
if (!this.slasherClient) {
|
|
1547
1096
|
throw new Error(`Slasher client not enabled`);
|
|
1548
1097
|
}
|
|
1549
1098
|
if (round === 'all') {
|
|
1550
|
-
return this.slasherClient.
|
|
1099
|
+
return this.slasherClient.getOffenses();
|
|
1551
1100
|
} else {
|
|
1552
1101
|
return this.slasherClient.gatherOffensesForRound(round === 'current' ? undefined : BigInt(round));
|
|
1553
1102
|
}
|
|
@@ -1619,81 +1168,60 @@ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
|
|
|
1619
1168
|
this.keyStoreManager = newManager;
|
|
1620
1169
|
this.log.info('Keystore reloaded: coinbase, feeRecipient, and attester keys updated');
|
|
1621
1170
|
}
|
|
1622
|
-
|
|
1623
|
-
if (
|
|
1624
|
-
|
|
1625
|
-
|
|
1626
|
-
|
|
1627
|
-
|
|
1628
|
-
|
|
1629
|
-
|
|
1630
|
-
|
|
1631
|
-
|
|
1632
|
-
|
|
1633
|
-
|
|
1171
|
+
async mineBlock() {
|
|
1172
|
+
if (this.automineSequencer) {
|
|
1173
|
+
await this.automineSequencer.buildEmptyBlock();
|
|
1174
|
+
return;
|
|
1175
|
+
}
|
|
1176
|
+
if (!this.sequencer) {
|
|
1177
|
+
throw new BadRequestError('Cannot mine block: no sequencer is running');
|
|
1178
|
+
}
|
|
1179
|
+
const currentBlockNumber = await this.getBlockNumber();
|
|
1180
|
+
// Use slot duration + 50% buffer as the timeout so this works on running networks too
|
|
1181
|
+
const { slotDuration } = await this.blockSource.getL1Constants();
|
|
1182
|
+
const timeoutSeconds = Math.ceil(slotDuration * 1.5);
|
|
1183
|
+
// Temporarily set minTxsPerBlock to 0 so the sequencer produces a block even with no txs
|
|
1184
|
+
const originalMinTxsPerBlock = this.sequencer.getSequencer().getConfig().minTxsPerBlock;
|
|
1185
|
+
this.sequencer.updateConfig({
|
|
1186
|
+
minTxsPerBlock: 0
|
|
1187
|
+
});
|
|
1634
1188
|
try {
|
|
1635
|
-
//
|
|
1636
|
-
|
|
1637
|
-
|
|
1638
|
-
|
|
1639
|
-
|
|
1640
|
-
|
|
1641
|
-
|
|
1642
|
-
|
|
1643
|
-
|
|
1644
|
-
|
|
1645
|
-
|
|
1646
|
-
if (BlockHash.isBlockHash(block)) {
|
|
1647
|
-
const initialBlockHash = await this.#getInitialHeaderHash();
|
|
1648
|
-
if (block.equals(initialBlockHash)) {
|
|
1649
|
-
// Block source doesn't handle initial header so we need to handle the case separately.
|
|
1650
|
-
return this.worldStateSynchronizer.getSnapshot(BlockNumber.ZERO);
|
|
1651
|
-
}
|
|
1652
|
-
const header = await this.blockSource.getBlockHeaderByHash(block);
|
|
1653
|
-
if (!header) {
|
|
1654
|
-
throw new Error(`Block hash ${block.toString()} not found when querying world state. If the node API has been queried with anchor block hash possibly a reorg has occurred.`);
|
|
1655
|
-
}
|
|
1656
|
-
blockNumber = header.getBlockNumber();
|
|
1657
|
-
} else {
|
|
1658
|
-
blockNumber = block;
|
|
1659
|
-
}
|
|
1660
|
-
// Check it's within world state sync range
|
|
1661
|
-
if (blockNumber > blockSyncedTo) {
|
|
1662
|
-
throw new Error(`Queried block ${block} not yet synced by the node (node is synced upto ${blockSyncedTo}).`);
|
|
1189
|
+
// Trigger the sequencer to produce a block immediately
|
|
1190
|
+
void this.sequencer.trigger();
|
|
1191
|
+
// Wait for the new L2 block to appear
|
|
1192
|
+
await retryUntil(async ()=>{
|
|
1193
|
+
const newBlockNumber = await this.getBlockNumber();
|
|
1194
|
+
return newBlockNumber > currentBlockNumber ? true : undefined;
|
|
1195
|
+
}, 'mineBlock', timeoutSeconds, 0.1);
|
|
1196
|
+
} finally{
|
|
1197
|
+
this.sequencer.updateConfig({
|
|
1198
|
+
minTxsPerBlock: originalMinTxsPerBlock
|
|
1199
|
+
});
|
|
1663
1200
|
}
|
|
1664
|
-
|
|
1665
|
-
|
|
1666
|
-
|
|
1667
|
-
|
|
1668
|
-
const blockHash = await snapshot.getLeafValue(MerkleTreeId.ARCHIVE, BigInt(blockNumber));
|
|
1669
|
-
if (!blockHash || !new BlockHash(blockHash).equals(block)) {
|
|
1670
|
-
throw new Error(`Block hash ${block.toString()} not found in world state at block number ${blockNumber}. If the node API has been queried with anchor block hash possibly a reorg has occurred.`);
|
|
1671
|
-
}
|
|
1201
|
+
}
|
|
1202
|
+
async prove(upToCheckpoint) {
|
|
1203
|
+
if (!this.automineSequencer) {
|
|
1204
|
+
throw new BadRequestError('Cannot prove checkpoint: no automine sequencer is running');
|
|
1672
1205
|
}
|
|
1673
|
-
return
|
|
1206
|
+
return await this.automineSequencer.prove(upToCheckpoint);
|
|
1674
1207
|
}
|
|
1675
|
-
|
|
1676
|
-
if (
|
|
1677
|
-
|
|
1208
|
+
async warpL2TimeAtLeastTo(targetTimestamp) {
|
|
1209
|
+
if (!this.automineSequencer) {
|
|
1210
|
+
throw new BadRequestError('Cannot warp L2 time: no automine sequencer is running');
|
|
1678
1211
|
}
|
|
1679
|
-
|
|
1680
|
-
|
|
1681
|
-
|
|
1682
|
-
|
|
1683
|
-
|
|
1684
|
-
const header = await this.blockSource.getBlockHeaderByHash(block);
|
|
1685
|
-
if (!header) {
|
|
1686
|
-
throw new Error(`Block hash ${block.toString()} not found.`);
|
|
1687
|
-
}
|
|
1688
|
-
return header.getBlockNumber();
|
|
1212
|
+
await this.automineSequencer.warpTo(targetTimestamp);
|
|
1213
|
+
}
|
|
1214
|
+
async warpL2TimeAtLeastBy(duration) {
|
|
1215
|
+
if (!this.automineSequencer) {
|
|
1216
|
+
throw new BadRequestError('Cannot warp L2 time: no automine sequencer is running');
|
|
1689
1217
|
}
|
|
1690
|
-
|
|
1218
|
+
await this.automineSequencer.warpBy(duration);
|
|
1691
1219
|
}
|
|
1692
1220
|
/**
|
|
1693
|
-
*
|
|
1694
|
-
* @
|
|
1695
|
-
|
|
1696
|
-
|
|
1697
|
-
return
|
|
1221
|
+
* Returns a committed world-state view at `block`, driving sync first. Delegates to
|
|
1222
|
+
* {@link NodeWorldStateQueries.getWorldState}; kept as a protected method so subclasses and tests can
|
|
1223
|
+
* exercise the node's block-resolution and reorg-aware sync behavior.
|
|
1224
|
+
*/ getWorldState(block) {
|
|
1225
|
+
return this.worldStateQueries.getWorldState(block);
|
|
1698
1226
|
}
|
|
1699
1227
|
}
|