@aztec/node-keystore 0.0.1-fake-c83136db25

package/dest/config.d.ts

@@ -0,0 +1,7 @@
+import { type ConfigMappingsType } from '@aztec/foundation/config';
+export type KeyStoreConfig = {
+    keyStoreDirectory: string | undefined;
+};
+export declare const keyStoreConfigMappings: ConfigMappingsType<KeyStoreConfig>;
+export declare function getKeyStoreConfigFromEnv(): KeyStoreConfig;
+//# sourceMappingURL=config.d.ts.map

package/dest/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAyB,MAAM,0BAA0B,CAAC;AAE1F,MAAM,MAAM,cAAc,GAAG;IAC3B,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,kBAAkB,CAAC,cAAc,CAKrE,CAAC;AAEF,wBAAgB,wBAAwB,IAAI,cAAc,CAEzD"}

package/dest/config.js

@@ -0,0 +1,10 @@
+import { getConfigFromMappings } from '@aztec/foundation/config';
+export const keyStoreConfigMappings = {
+    keyStoreDirectory: {
+        env: 'KEY_STORE_DIRECTORY',
+        description: 'Location of key store directory'
+    }
+};
+export function getKeyStoreConfigFromEnv() {
+    return getConfigFromMappings(keyStoreConfigMappings);
+}

package/dest/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './loader.js';
+export * from './schemas.js';
+export * from './signer.js';
+export * from './keystore_manager.js';
+export * from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/dest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC"}

package/dest/index.js

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './loader.js';
+export * from './schemas.js';
+export * from './signer.js';
+export * from './keystore_manager.js';
+export * from './config.js';

package/dest/keystore_manager.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Keystore Manager
+ *
+ * Manages keystore configuration and delegates signing operations to appropriate signers.
+ */
+import type { EthSigner } from '@aztec/ethereum';
+import { Buffer32 } from '@aztec/foundation/buffer';
+import { EthAddress } from '@aztec/foundation/eth-address';
+import type { Signature } from '@aztec/foundation/eth-signature';
+import type { AztecAddress } from '@aztec/stdlib/aztec-address';
+import type { TypedDataDefinition } from 'viem';
+import type { EthAccounts, EthRemoteSignerConfig, KeyStore, ProverKeyStore, ValidatorKeyStore as ValidatorKeystoreConfig } from './types.js';
+/**
+ * Error thrown when keystore operations fail
+ */
+export declare class KeystoreError extends Error {
+    cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Keystore Manager - coordinates signing operations based on keystore configuration
+ */
+export declare class KeystoreManager {
+    private readonly keystore;
+    /**
+     * Create a keystore manager from a parsed configuration.
+     * Performs a lightweight duplicate-attester check without decrypting JSON V3 or deriving mnemonics.
+     * @param keystore Parsed keystore configuration
+     */
+    constructor(keystore: KeyStore);
+    /**
+     * Validates all remote signers in the keystore are accessible and have the required addresses.
+     * Should be called after construction if validation is needed.
+     */
+    validateSigners(): Promise<void>;
+    /**
+     * Validates that attester addresses are unique across all validators
+     * Only checks simple private key attesters, not JSON-V3 or mnemonic attesters,
+     * these are validated when decrypting the JSON-V3 keystore files
+     * @throws KeystoreError if duplicate attester addresses are found
+     */
+    private validateUniqueAttesterAddresses;
+    /**
+     * Best-effort address extraction that avoids decryption/derivation (no JSON-V3 or mnemonic processing).
+     * This is used at construction time to check for obvious duplicates without throwing for invalid inputs.
+     */
+    private extractAddressesWithoutSensitiveOperations;
+    /**
+     * Extract addresses from EthAccounts without sensitive operations (no decryption/derivation).
+     */
+    private extractAddressesFromEthAccountsNonSensitive;
+    /**
+     * Create signers for validator attester accounts
+     */
+    createAttesterSigners(validatorIndex: number): EthSigner[];
+    /**
+     * Create signers for validator publisher accounts (falls back to attester if not specified)
+     */
+    createPublisherSigners(validatorIndex: number): EthSigner[];
+    createAllValidatorPublisherSigners(): EthSigner[];
+    /**
+     * Create signers for slasher accounts
+     */
+    createSlasherSigners(): EthSigner[];
+    /**
+     * Create signers for prover accounts
+     */
+    createProverSigners(): {
+        id: EthAddress | undefined;
+        signers: EthSigner[];
+    } | undefined;
+    /**
+     * Get validator configuration by index
+     */
+    getValidator(index: number): ValidatorKeystoreConfig;
+    /**
+     * Get validator count
+     */
+    getValidatorCount(): number;
+    /**
+     * Get coinbase address for validator (falls back to the specific attester address)
+     */
+    getCoinbaseAddress(validatorIndex: number, attesterAddress: EthAddress): EthAddress;
+    /**
+     * Get fee recipient for validator
+     */
+    getFeeRecipient(validatorIndex: number): AztecAddress;
+    /**
+     * Get the raw slasher configuration as provided in the keystore file.
+     * @returns The slasher accounts configuration or undefined if not set
+     */
+    getSlasherAccounts(): EthAccounts | undefined;
+    /**
+     * Get the raw prover configuration as provided in the keystore file.
+     * @returns The prover configuration or undefined if not set
+     */
+    getProverConfig(): ProverKeyStore | undefined;
+    /**
+     * Resolves attester accounts (including JSON V3 and mnemonic) and checks for duplicate addresses across validators.
+     * Throws if the same resolved address appears in more than one validator configuration.
+     */
+    validateResolvedUniqueAttesterAddresses(): void;
+    /**
+     * Create signers from EthAccounts configuration
+     */
+    private createSignersFromEthAccounts;
+    /**
+     * Create a signer from a single EthAccount configuration
+     */
+    private createSignerFromEthAccount;
+    /**
+     * Create signer from JSON V3 keystore file or directory
+     */
+    private createSignerFromJsonV3;
+    /**
+     * Create signer from a single JSON V3 keystore file
+     */
+    private createSignerFromSingleJsonV3File;
+    /**
+     * Create signers from mnemonic configuration using BIP44 derivation
+     */
+    private createSignersFromMnemonic;
+    /**
+     * Sign message with a specific signer
+     */
+    signMessage(signer: EthSigner, message: Buffer32): Promise<Signature>;
+    /**
+     * Sign typed data with a specific signer
+     */
+    signTypedData(signer: EthSigner, typedData: TypedDataDefinition): Promise<Signature>;
+    /**
+     * Get the effective remote signer configuration for a specific attester address
+     * Precedence: account-level override > validator-level config > file-level default
+     */
+    getEffectiveRemoteSignerConfig(validatorIndex: number, attesterAddress: EthAddress): EthRemoteSignerConfig | undefined;
+    /** Extract ETH accounts from AttesterAccounts */
+    private extractEthAccountsFromAttester;
+}
+//# sourceMappingURL=keystore_manager.d.ts.map

package/dest/keystore_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keystore_manager.d.ts","sourceRoot":"","sources":["../src/keystore_manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAKhE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAKhD,OAAO,KAAK,EAGV,WAAW,EAEX,qBAAqB,EAErB,QAAQ,EAER,cAAc,EACd,iBAAiB,IAAI,uBAAuB,EAC7C,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAGpB,KAAK,CAAC,EAAE,KAAK;gBAD7B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IAEpC;;;;OAIG;gBACS,QAAQ,EAAE,QAAQ;IAK9B;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAwEtC;;;;;OAKG;IACH,OAAO,CAAC,+BAA+B;IAkBvC;;;OAGG;IACH,OAAO,CAAC,0CAA0C;IAKlD;;OAEG;IACH,OAAO,CAAC,2CAA2C;IA+CnD;;OAEG;IACH,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,EAAE;IAM1D;;OAEG;IACH,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,EAAE;IAc3D,kCAAkC,IAAI,SAAS,EAAE;IAWjD;;OAEG;IACH,oBAAoB,IAAI,SAAS,EAAE;IAQnC;;OAEG;IACH,mBAAmB,IAAI;QAAE,EAAE,EAAE,UAAU,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,SAAS,EAAE,CAAA;KAAE,GAAG,SAAS;IAiCvF;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,uBAAuB;IAOpD;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,GAAG,UAAU;IAWnF;;OAEG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY;IAKrD;;;OAGG;IACH,kBAAkB,IAAI,WAAW,GAAG,SAAS;IAI7C;;;OAGG;IACH,eAAe,IAAI,cAAc,GAAG,SAAS;IAI7C;;;OAGG;IACH,uCAAuC,IAAI,IAAI;IAqB/C;;OAEG;IACH,OAAO,CAAC,4BAA4B;IA+BpC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA2ClC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkD9B;;OAEG;IACH,OAAO,CAAC,gCAAgC;IAwBxC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA8BjC;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAI3E;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;IAI1F;;;OAGG;IACH,8BAA8B,CAC5B,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,UAAU,GAC1B,qBAAqB,GAAG,SAAS;IA0GpC,iDAAiD;IACjD,OAAO,CAAC,8BAA8B;CAyBvC"}