@aztec/stdlib 3.0.0-canary.a9708bd → 3.0.0-manual.20251030

package/dest/contract/contract_class_metadata.d.ts

@@ -0,0 +1,8 @@
+import type { ContractArtifact } from '../abi/abi.js';
+import type { ContractClassWithId } from './interfaces/contract_class.js';
+export interface ContractClassMetadata {
+    contractClass?: ContractClassWithId | undefined;
+    isContractClassPubliclyRegistered: boolean;
+    artifact?: ContractArtifact | undefined;
+}
+//# sourceMappingURL=contract_class_metadata.d.ts.map

package/dest/contract/contract_class_metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract_class_metadata.d.ts","sourceRoot":"","sources":["../../src/contract/contract_class_metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAChD,iCAAiC,EAAE,OAAO,CAAC;IAC3C,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACzC"}

package/dest/contract/contract_class_metadata.js

@@ -0,0 +1 @@
+export { };

package/dest/contract/contract_instance.d.ts

@@ -5,6 +5,14 @@ import { type ContractArtifact, type FunctionAbi } from '../abi/index.js';
 import { AztecAddress } from '../aztec-address/index.js';
 import { PublicKeys } from '../keys/public_keys.js';
 import type { ContractInstance, ContractInstanceWithAddress } from './interfaces/contract_instance.js';
+export type ContractInstantiationData = {
+    constructorArtifact?: FunctionAbi | string;
+    constructorArgs?: any[];
+    skipArgsDecoding?: boolean;
+    salt: Fr;
+    publicKeys?: PublicKeys;
+    deployer?: AztecAddress;
+};
 export declare class SerializableContractInstance {
     readonly version: 1;
     readonly salt: Fr;
@@ -27,12 +35,5 @@ export declare class SerializableContractInstance {
  * @param opts - Options for the contract's instantiation.
  * @returns - The contract instance
  */
-export declare function getContractInstanceFromInstantiationParams(artifact: ContractArtifact, opts: {
-    constructorArtifact?: FunctionAbi | string;
-    constructorArgs?: any[];
-    skipArgsDecoding?: boolean;
-    salt?: Fr;
-    publicKeys?: PublicKeys;
-    deployer?: AztecAddress;
-}): Promise<ContractInstanceWithAddress>;
+export declare function getContractInstanceFromInstantiationParams(artifact: ContractArtifact, opts: ContractInstantiationData): Promise<ContractInstanceWithAddress>;
 //# sourceMappingURL=contract_instance.d.ts.map

package/dest/contract/contract_instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract_instance.d.ts","sourceRoot":"","sources":["../../src/contract/contract_instance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAiC,MAAM,6BAA6B,CAAC;AAC1F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAKjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAMpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAIvG,qBAAa,4BAA4B;IACvC,SAAgB,OAAO,IAAW;IAClC,SAAgB,IAAI,EAAE,EAAE,CAAC;IACzB,SAAgB,QAAQ,EAAE,YAAY,CAAC;IACvC,SAAgB,sBAAsB,EAAE,EAAE,CAAC;IAC3C,SAAgB,uBAAuB,EAAE,EAAE,CAAC;IAC5C,SAAgB,kBAAkB,EAAE,EAAE,CAAC;IACvC,SAAgB,UAAU,EAAE,UAAU,CAAC;gBAE3B,QAAQ,EAAE,gBAAgB;IAY/B,QAAQ;IAYf,+DAA+D;IAC/D,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,2BAA2B;IAI/D,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY;WAa1C,MAAM,CAAC,IAAI,GAAE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAM;IAalE,MAAM,CAAC,OAAO;CAWf;AAED;;;;;GAKG;AACH,wBAAsB,0CAA0C,CAC9D,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE;IACJ,mBAAmB,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3C,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,IAAI,CAAC,EAAE,EAAE,CAAC;IACV,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB,GACA,OAAO,CAAC,2BAA2B,CAAC,CA0BtC"}
+{"version":3,"file":"contract_instance.d.ts","sourceRoot":"","sources":["../../src/contract/contract_instance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAiC,MAAM,6BAA6B,CAAC;AAC1F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAKjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAMpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAIvG,MAAM,MAAM,yBAAyB,GAAG;IACtC,mBAAmB,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3C,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,IAAI,EAAE,EAAE,CAAC;IACT,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB,CAAC;AAEF,qBAAa,4BAA4B;IACvC,SAAgB,OAAO,IAAW;IAClC,SAAgB,IAAI,EAAE,EAAE,CAAC;IACzB,SAAgB,QAAQ,EAAE,YAAY,CAAC;IACvC,SAAgB,sBAAsB,EAAE,EAAE,CAAC;IAC3C,SAAgB,uBAAuB,EAAE,EAAE,CAAC;IAC5C,SAAgB,kBAAkB,EAAE,EAAE,CAAC;IACvC,SAAgB,UAAU,EAAE,UAAU,CAAC;gBAE3B,QAAQ,EAAE,gBAAgB;IAY/B,QAAQ;IAYf,+DAA+D;IAC/D,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,2BAA2B;IAI/D,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY;WAa1C,MAAM,CAAC,IAAI,GAAE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAM;IAalE,MAAM,CAAC,OAAO;CAWf;AAED;;;;;GAKG;AACH,wBAAsB,0CAA0C,CAC9D,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,2BAA2B,CAAC,CAyBtC"}

package/dest/contract/contract_instance.js

@@ -77,7 +77,6 @@ export class SerializableContractInstance {
  * @returns - The contract instance
  */ export async function getContractInstanceFromInstantiationParams(artifact, opts) {
     const args = opts.constructorArgs ?? [];
-    const salt = opts.salt ?? Fr.random();
     const constructorArtifact = getConstructorArtifact(artifact, opts.constructorArtifact);
     const deployer = opts.deployer ?? AztecAddress.ZERO;
     const contractClass = await getContractClassFromArtifact(artifact);
@@ -88,7 +87,7 @@ export class SerializableContractInstance {
         originalContractClassId: contractClass.id,
         initializationHash,
         publicKeys,
-        salt,
+        salt: opts.salt,
         deployer,
         version: 1
     };

package/dest/contract/contract_metadata.d.ts

@@ -0,0 +1,7 @@
+import type { ContractInstanceWithAddress } from './interfaces/contract_instance.js';
+export interface ContractMetadata {
+    contractInstance?: ContractInstanceWithAddress | undefined;
+    isContractInitialized: boolean;
+    isContractPublished: boolean;
+}
+//# sourceMappingURL=contract_metadata.d.ts.map

package/dest/contract/contract_metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract_metadata.d.ts","sourceRoot":"","sources":["../../src/contract/contract_metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAErF,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,CAAC,EAAE,2BAA2B,GAAG,SAAS,CAAC;IAC3D,qBAAqB,EAAE,OAAO,CAAC;IAC/B,mBAAmB,EAAE,OAAO,CAAC;CAC9B"}

package/dest/contract/contract_metadata.js

@@ -0,0 +1 @@
+export { };

package/dest/contract/index.d.ts

@@ -1,8 +1,10 @@
 export * from './artifact_hash.js';
 export * from './contract_address.js';
 export * from './contract_class.js';
+export * from './contract_class_metadata.js';
 export * from './contract_class_id.js';
 export * from './contract_instance.js';
+export * from './contract_metadata.js';
 export * from './contract_instance_update.js';
 export * from './private_function.js';
 export * from './private_function_membership_proof.js';

package/dest/contract/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dest/contract/index.js

@@ -1,8 +1,10 @@
 export * from './artifact_hash.js';
 export * from './contract_address.js';
 export * from './contract_class.js';
+export * from './contract_class_metadata.js';
 export * from './contract_class_id.js';
 export * from './contract_instance.js';
+export * from './contract_metadata.js';
 export * from './contract_instance_update.js';
 export * from './private_function.js';
 export * from './private_function_membership_proof.js';

package/dest/contract/interfaces/contract_class.d.ts

@@ -14,7 +14,7 @@ export interface ContractClass {
     /**
      * Hash of the contract artifact. The specification of this hash is not enforced by the protocol. Should include
      * commitments to code of utility functions and compilation metadata. Intended to be used by clients to verify that
-     * an off-chain fetched artifact matches a registered class.
+     * an offchain fetched artifact matches a registered class.
      */
     artifactHash: Fr;
     /** List of individual private functions, constructors included. */
@@ -120,7 +120,7 @@ interface ContractClassCommitments {
 }
 /** A contract class with its precomputed id. */
 export type ContractClassWithId = ContractClass & Pick<ContractClassCommitments, 'id'>;
-export declare const ContractClassWithIdSchema: z.ZodObject<z.objectUtil.extendShape<{
+export declare const ContractClassWithIdSchema: z.ZodObject<{
     version: z.ZodLiteral<1>;
     artifactHash: z.ZodType<Fr, any, string>;
     privateFunctions: z.ZodArray<z.ZodObject<{
@@ -146,9 +146,9 @@ export declare const ContractClassWithIdSchema: z.ZodObject<z.objectUtil.extendS
         type: "Buffer";
         data: number[];
     }>]>;
-}, {
+} & {
     id: z.ZodType<Fr, any, string>;
-}>, "strip", z.ZodTypeAny, {
+}, "strip", z.ZodTypeAny, {
     version: 1;
     id: Fr;
     artifactHash: Fr;

package/dest/contract/interfaces/contract_instance.d.ts

@@ -59,11 +59,11 @@ export declare const ContractInstanceSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     version: 1;
     salt: Fr;
-    publicKeys: PublicKeys;
     deployer: AztecAddress;
     currentContractClassId: Fr;
     originalContractClassId: Fr;
     initializationHash: Fr;
+    publicKeys: PublicKeys;
 }, {
     version: 1;
     publicKeys: {
@@ -109,11 +109,11 @@ export declare const ContractInstanceWithAddressSchema: z.ZodIntersection<z.ZodO
 }, "strip", z.ZodTypeAny, {
     version: 1;
     salt: Fr;
-    publicKeys: PublicKeys;
     deployer: AztecAddress;
     currentContractClassId: Fr;
     originalContractClassId: Fr;
     initializationHash: Fr;
+    publicKeys: PublicKeys;
 }, {
     version: 1;
     publicKeys: {

package/dest/epoch-helpers/index.d.ts

@@ -39,12 +39,16 @@ export declare function getEpochNumberAtTimestamp(ts: bigint, constants: Pick<L1
 /** Returns the epoch number for a given slot. */
 export declare function getEpochAtSlot(slot: bigint, constants: Pick<L1RollupConstants, 'epochDuration'>): bigint;
 /** Returns the range of L2 slots (inclusive) for a given epoch number. */
-export declare function getSlotRangeForEpoch(epochNumber: bigint, constants: Pick<L1RollupConstants, 'epochDuration'>): bigint[];
+export declare function getSlotRangeForEpoch(epochNumber: bigint, constants: Pick<L1RollupConstants, 'epochDuration'>): [bigint, bigint];
 /**
  * Returns the range of L1 timestamps (inclusive) for a given epoch number.
  * Note that the endTimestamp is the start timestamp of the last L1 slot for the epoch.
  */
-export declare function getTimestampRangeForEpoch(epochNumber: bigint, constants: Pick<L1RollupConstants, 'l1GenesisTime' | 'slotDuration' | 'epochDuration' | 'ethereumSlotDuration'>): bigint[];
+export declare function getTimestampRangeForEpoch(epochNumber: bigint, constants: Pick<L1RollupConstants, 'l1GenesisTime' | 'slotDuration' | 'epochDuration' | 'ethereumSlotDuration'>): [bigint, bigint];
+/**
+ * Returns the start timestamp for a given epoch number.
+ */
+export declare function getStartTimestampForEpoch(epochNumber: bigint, constants: Pick<L1RollupConstants, 'l1GenesisTime' | 'slotDuration' | 'epochDuration'>): bigint;
 /**
  * Returns the epoch number at which proofs are no longer accepted for a given epoch.
  * See l1-contracts/src/core/libraries/TimeLib.sol
@@ -55,4 +59,6 @@ export declare function getProofSubmissionDeadlineEpoch(epochNumber: bigint, con
  * Computed as the start of the given epoch plus the proof submission window.
  */
 export declare function getProofSubmissionDeadlineTimestamp(epochNumber: bigint, constants: Pick<L1RollupConstants, 'l1GenesisTime' | 'slotDuration' | 'epochDuration' | 'proofSubmissionEpochs'>): bigint;
+/** Returns the timestamp to start building a block for a given L2 slot. Computed as the start timestamp of the slot minus one L1 slot duration. */
+export declare function getSlotStartBuildTimestamp(slotNumber: number | bigint, constants: Pick<L1RollupConstants, 'l1GenesisTime' | 'slotDuration' | 'ethereumSlotDuration'>): number;
 //# sourceMappingURL=index.d.ts.map

package/dest/epoch-helpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/epoch-helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,iBAOpC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;EAOE,CAAC;AAEvC,iDAAiD;AACjD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,CAAC,UAGrE;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,CAAC,UAElH;AAED,sDAAsD;AACtD,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,GAAG,eAAe,CAAC,UAGvF;AAED,iDAAiD;AACjD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,UAE/F;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,YAG5G;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,sBAAsB,CAAC,YAUhH;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,UAG5D;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,uBAAuB,CAAC,UAOjH"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/epoch-helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,iBAOpC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;EAOE,CAAC;AAEvC,iDAAiD;AACjD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,CAAC,UAGrE;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,CAAC,UAElH;AAED,sDAAsD;AACtD,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,GAAG,eAAe,CAAC,UAGvF;AAED,iDAAiD;AACjD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,UAE/F;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,GAClD,CAAC,MAAM,EAAE,MAAM,CAAC,CAGlB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,sBAAsB,CAAC,GAC9G,CAAC,MAAM,EAAE,MAAM,CAAC,CASlB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,GAAG,eAAe,CAAC,UAIvF;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,UAG5D;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,uBAAuB,CAAC,UAOjH;AAED,mJAAmJ;AACnJ,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,GAAG,sBAAsB,CAAC,GAC5F,MAAM,CAER"}

package/dest/epoch-helpers/index.js

@@ -46,6 +46,12 @@ export const L1RollupConstantsSchema = z.object({
         constants.l1GenesisTime + endSlot * BigInt(constants.slotDuration) + BigInt((ethereumSlotsPerL2Slot - 1) * constants.ethereumSlotDuration)
     ];
 }
+/**
+ * Returns the start timestamp for a given epoch number.
+ */ export function getStartTimestampForEpoch(epochNumber, constants) {
+    const [startSlot] = getSlotRangeForEpoch(epochNumber, constants);
+    return getTimestampForSlot(startSlot, constants);
+}
 /**
  * Returns the epoch number at which proofs are no longer accepted for a given epoch.
  * See l1-contracts/src/core/libraries/TimeLib.sol
@@ -62,3 +68,6 @@ export const L1RollupConstantsSchema = z.object({
     const [deadlineSlot] = getSlotRangeForEpoch(deadlineEpoch, constants);
     return getTimestampForSlot(deadlineSlot, constants);
 }
+/** Returns the timestamp to start building a block for a given L2 slot. Computed as the start timestamp of the slot minus one L1 slot duration. */ export function getSlotStartBuildTimestamp(slotNumber, constants) {
+    return Number(constants.l1GenesisTime) + Number(slotNumber) * constants.slotDuration - constants.ethereumSlotDuration;
+}

package/dest/fees/transaction_fee.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction_fee.d.ts","sourceRoot":"","sources":["../../src/fees/transaction_fee.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAEnD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAc3F;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,GAAG,EAAE,CAGlG"}
+{"version":3,"file":"transaction_fee.d.ts","sourceRoot":"","sources":["../../src/fees/transaction_fee.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAInD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAuB3F;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,GAAG,EAAE,CAGlG"}

package/dest/fees/transaction_fee.js

@@ -1,3 +1,4 @@
+import { strict as assert } from 'assert';
 import { GasFees } from '../gas/gas_fees.js';
 /**
  * Compute the effective gas fees that should be used to compute the transaction fee.
@@ -5,6 +6,8 @@ import { GasFees } from '../gas/gas_fees.js';
  */ export function computeEffectiveGasFees(gasFees, gasSettings) {
     const { maxFeesPerGas, maxPriorityFeesPerGas } = gasSettings;
     const minBigInt = (f1, f2)=>f1 < f2 ? f1 : f2;
+    assert(maxFeesPerGas.feePerDaGas >= gasFees.feePerDaGas, `maxFeesPerGas.feePerDaGas must be greater than or equal to gasFees.feePerDaGas, but got maxFeesPerGas.feePerDaGas=${maxFeesPerGas.feePerDaGas} and gasFees.feePerDaGas=${gasFees.feePerDaGas}`);
+    assert(maxFeesPerGas.feePerL2Gas >= gasFees.feePerL2Gas, `maxFeesPerGas.feePerL2Gas must be greater than or equal to gasFees.feePerL2Gas, but got maxFeesPerGas.feePerL2Gas=${maxFeesPerGas.feePerL2Gas} and gasFees.feePerL2Gas=${gasFees.feePerL2Gas}`);
     const priorityFees = new GasFees(minBigInt(maxPriorityFeesPerGas.feePerDaGas, maxFeesPerGas.feePerDaGas - gasFees.feePerDaGas), minBigInt(maxPriorityFeesPerGas.feePerL2Gas, maxFeesPerGas.feePerL2Gas - gasFees.feePerL2Gas));
     const effectiveFees = new GasFees(gasFees.feePerDaGas + priorityFees.feePerDaGas, gasFees.feePerL2Gas + priorityFees.feePerL2Gas);
     return effectiveFees;

package/dest/file-store/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/file-store/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAIlE,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AASnE,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAC3F,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAgC9F,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAC3G,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/file-store/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAIlE,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAWnE,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAC3F,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AA6C9F,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAC3G,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dest/file-store/factory.js

@@ -2,8 +2,10 @@ import { createLogger } from '@aztec/foundation/log';
 import { GoogleCloudFileStore } from './gcs.js';
 import { HttpFileStore } from './http.js';
 import { LocalFileStore } from './local.js';
+import { S3FileStore } from './s3.js';
 const supportedExamples = [
     `gs://bucket-name/path/to/store`,
+    `s3://bucket-name/path/to/store`,
     `file:///absolute/local/path/to/store`,
     `https://host/path`
 ];
@@ -30,6 +32,22 @@ export async function createFileStore(config, logger = createLogger('stdlib:file
         } catch  {
             throw new Error(`Invalid google cloud store definition: '${config}'.`);
         }
+    } else if (config.startsWith('s3://')) {
+        try {
+            const url = new URL(config);
+            const bucket = url.host;
+            const path = url.pathname.replace(/^\/+/, '');
+            const endpoint = url.searchParams.get('endpoint');
+            const publicBaseUrl = url.searchParams.get('publicBaseUrl') ?? undefined;
+            logger.info(`Creating S3 file store at ${bucket} ${path}`);
+            const store = new S3FileStore(bucket, path, {
+                endpoint: endpoint ?? undefined,
+                publicBaseUrl
+            });
+            return store;
+        } catch  {
+            throw new Error(`Invalid S3 store definition: '${config}'.`);
+        }
     } else {
         throw new Error(`Unknown file store config: '${config}'. Supported values are ${supportedExamples.join(', ')}.`);
     }

package/dest/file-store/interface.d.ts

@@ -14,9 +14,15 @@ export type FileStoreSaveOptions = {
 };
 /** Simple file store. */
 export interface FileStore extends ReadOnlyFileStore {
-    /** Saves contents to the given path. Returns an URI that can be used later to `read` the file. */
+    /**
+     * Saves contents to the given path. Returns an URI that can be used later to `read` the file.
+     * Default: `compress` is false unless explicitly set.
+     */
     save(path: string, data: Buffer, opts?: FileStoreSaveOptions): Promise<string>;
-    /** Uploads contents from a local file. Returns an URI that can be used later to `read` the file. */
+    /**
+     * Uploads contents from a local file. Returns an URI that can be used later to `read` the file.
+     * Default: `compress` is true unless explicitly set to false.
+     */
     upload(destPath: string, srcPath: string, opts?: FileStoreSaveOptions): Promise<string>;
 }
 //# sourceMappingURL=interface.d.ts.map

package/dest/file-store/interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/file-store/interface.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,MAAM,WAAW,iBAAiB;IAChC,iGAAiG;IACjG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,wGAAwG;IACxG,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,8DAA8D;IAC9D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,MAAM,oBAAoB,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE/G,yBAAyB;AACzB,MAAM,WAAW,SAAU,SAAQ,iBAAiB;IAClD,kGAAkG;IAClG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/E,oGAAoG;IACpG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACzF"}
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/file-store/interface.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,MAAM,WAAW,iBAAiB;IAChC,iGAAiG;IACjG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,wGAAwG;IACxG,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,8DAA8D;IAC9D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,MAAM,oBAAoB,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE/G,yBAAyB;AACzB,MAAM,WAAW,SAAU,SAAQ,iBAAiB;IAClD;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/E;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACzF"}

package/dest/file-store/s3.d.ts

@@ -0,0 +1,26 @@
+import { type Logger } from '@aztec/foundation/log';
+import type { FileStore, FileStoreSaveOptions } from './interface.js';
+export declare class S3FileStore implements FileStore {
+    private readonly bucketName;
+    private readonly basePath;
+    private readonly log;
+    private readonly s3;
+    private readonly region;
+    private readonly endpoint?;
+    private readonly publicBaseUrl?;
+    constructor(bucketName: string, basePath: string, opts: {
+        endpoint?: string;
+        publicBaseUrl?: string;
+    }, log?: Logger);
+    save(path: string, data: Buffer, opts?: FileStoreSaveOptions): Promise<string>;
+    upload(destPath: string, srcPath: string, opts?: FileStoreSaveOptions): Promise<string>;
+    read(pathOrUrlStr: string): Promise<Buffer>;
+    download(pathOrUrlStr: string, destPath: string): Promise<void>;
+    exists(pathOrUrlStr: string): Promise<boolean>;
+    private extractUserMetadata;
+    private detectContentType;
+    private buildReturnedUrl;
+    private getBucketAndKey;
+    private getFullPath;
+}
+//# sourceMappingURL=s3.d.ts.map

package/dest/file-store/s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../../src/file-store/s3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAiBlE,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAMtE,qBAAa,WAAY,YAAW,SAAS;IAOzC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IATtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;gBAGrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EACjC,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,EAClC,GAAG,GAAE,MAA6C;IAiBxD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBlF,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC;IA6D3F,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW3C,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/D,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe3D,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,gBAAgB;IA0BxB,OAAO,CAAC,eAAe;IA2BvB,OAAO,CAAC,WAAW;CAKpB"}

package/dest/file-store/s3.js

@@ -0,0 +1,252 @@
+import { createLogger } from '@aztec/foundation/log';
+import { GetObjectCommand, HeadObjectCommand, PutObjectCommand, S3Client } from '@aws-sdk/client-s3';
+import { createReadStream, createWriteStream } from 'fs';
+import { mkdir, mkdtemp, stat, unlink } from 'fs/promises';
+import { tmpdir } from 'os';
+import { basename, dirname, join } from 'path';
+import { finished } from 'stream/promises';
+import { createGzip } from 'zlib';
+function normalizeBasePath(path) {
+    return path?.replace(/^\/+|\/+$/g, '') ?? '';
+}
+export class S3FileStore {
+    bucketName;
+    basePath;
+    log;
+    s3;
+    region;
+    endpoint;
+    publicBaseUrl;
+    constructor(bucketName, basePath, opts, log = createLogger('stdlib:s3-file-store')){
+        this.bucketName = bucketName;
+        this.basePath = basePath;
+        this.log = log;
+        this.endpoint = opts.endpoint;
+        this.region = this.endpoint ? 'auto' : process.env.AWS_REGION ?? process.env.AWS_DEFAULT_REGION ?? 'us-east-1';
+        this.publicBaseUrl = opts.publicBaseUrl;
+        const clientOptions = {};
+        if (this.endpoint) {
+            clientOptions.region = 'auto';
+            clientOptions.endpoint = this.endpoint;
+            clientOptions.forcePathStyle = true;
+        } else {
+            clientOptions.region = this.region;
+        }
+        this.s3 = new S3Client(clientOptions);
+    }
+    async save(path, data, opts = {}) {
+        const key = this.getFullPath(path);
+        const shouldCompress = !!opts.compress;
+        const body = shouldCompress ? (await import('zlib')).gzipSync(data) : data;
+        const contentLength = body.length;
+        const contentType = this.detectContentType(key, shouldCompress);
+        const put = new PutObjectCommand({
+            Bucket: this.bucketName,
+            Key: key,
+            Body: body,
+            ContentType: contentType,
+            CacheControl: opts.metadata?.['Cache-control'],
+            Metadata: this.extractUserMetadata(opts.metadata),
+            ContentLength: contentLength
+        });
+        await this.s3.send(put);
+        return this.buildReturnedUrl(key, !!opts.public);
+    }
+    async upload(destPath, srcPath, opts = {}) {
+        const key = this.getFullPath(destPath);
+        const shouldCompress = opts.compress !== false; // default true like GCS impl
+        await mkdir(dirname(srcPath), {
+            recursive: true
+        }).catch(()=>undefined);
+        let contentLength;
+        let bodyPath = srcPath;
+        // We don't set Content-Encoding and we avoid SigV4 streaming (aws-chunked).
+        // With AWS SigV4 streaming uploads (Content-Encoding: aws-chunked[,gzip]), servers require
+        // x-amz-decoded-content-length (the size of the decoded payload) and an exact Content-Length
+        // that includes chunk metadata. For on-the-fly compression, providing
+        // those values without buffering or a pre-pass is impractical. Instead, we pre-gzip to a temp file
+        // to know ContentLength up-front and upload the gzipped bytes as-is, omitting Content-Encoding.
+        // Reference: AWS SigV4 streaming (chunked upload) requirements —
+        // https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-streaming.html
+        if (shouldCompress) {
+            // Pre-gzip to a temp file so we know the exact length for R2/S3 headers
+            const tmpDir = await mkdtemp(join(tmpdir(), 's3-upload-'));
+            const gzPath = join(tmpDir, `${basename(srcPath)}.gz`);
+            const source = createReadStream(srcPath);
+            const gz = createGzip();
+            const out = createWriteStream(gzPath);
+            try {
+                await finished(source.pipe(gz).pipe(out));
+                const st = await stat(gzPath);
+                contentLength = st.size;
+                bodyPath = gzPath;
+            } catch (err) {
+                // Ensure temp file is removed on failure
+                await unlink(gzPath).catch(()=>undefined);
+                throw err;
+            }
+        } else {
+            const st = await stat(srcPath);
+            contentLength = st.size;
+            bodyPath = srcPath;
+        }
+        const bodyStream = createReadStream(bodyPath);
+        const contentType = this.detectContentType(key, shouldCompress);
+        try {
+            const put = new PutObjectCommand({
+                Bucket: this.bucketName,
+                Key: key,
+                Body: bodyStream,
+                ContentType: contentType,
+                CacheControl: opts.metadata?.['Cache-control'],
+                Metadata: this.extractUserMetadata(opts.metadata),
+                // Explicitly set ContentLength so R2 can compute x-amz-decoded-content-length correctly
+                ContentLength: contentLength
+            });
+            await this.s3.send(put);
+        } finally{
+            if (shouldCompress && bodyPath !== srcPath) {
+                await unlink(bodyPath).catch(()=>undefined);
+            }
+        }
+        return this.buildReturnedUrl(key, !!opts.public);
+    }
+    async read(pathOrUrlStr) {
+        const { bucket, key } = this.getBucketAndKey(pathOrUrlStr);
+        const out = await this.s3.send(new GetObjectCommand({
+            Bucket: bucket,
+            Key: key
+        }));
+        const stream = out.Body;
+        const chunks = [];
+        for await (const chunk of stream){
+            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        }
+        return Buffer.concat(chunks);
+    }
+    async download(pathOrUrlStr, destPath) {
+        const { bucket, key } = this.getBucketAndKey(pathOrUrlStr);
+        const out = await this.s3.send(new GetObjectCommand({
+            Bucket: bucket,
+            Key: key
+        }));
+        await mkdir(dirname(destPath), {
+            recursive: true
+        });
+        const write = createWriteStream(destPath);
+        await finished(out.Body.pipe(write));
+    }
+    async exists(pathOrUrlStr) {
+        try {
+            const { bucket, key } = this.getBucketAndKey(pathOrUrlStr);
+            await this.s3.send(new HeadObjectCommand({
+                Bucket: bucket,
+                Key: key
+            }));
+            return true;
+        } catch (err) {
+            const code = err?.$metadata?.httpStatusCode ?? err?.name ?? err?.Code;
+            if (code === 404 || code === 'NotFound' || code === 'NoSuchKey') {
+                return false;
+            }
+            this.log.warn(`Error checking existence for ${pathOrUrlStr}: ${err?.message ?? String(err)}`);
+            return false;
+        }
+    }
+    extractUserMetadata(meta) {
+        if (!meta) {
+            return undefined;
+        }
+        const { ['Cache-control']: _ignored, ...rest } = meta;
+        return Object.keys(rest).length ? rest : undefined;
+    }
+    detectContentType(key, isCompressed) {
+        // Basic content type inference
+        const lower = key.toLowerCase();
+        if (lower.endsWith('.json') || lower.endsWith('.json.gz')) {
+            return 'application/json';
+        }
+        if (lower.endsWith('.txt') || lower.endsWith('.log') || lower.endsWith('.csv') || lower.endsWith('.md')) {
+            return 'text/plain; charset=utf-8';
+        }
+        if (lower.endsWith('.db') || lower.endsWith('.sqlite') || lower.endsWith('.bin')) {
+            return 'application/octet-stream';
+        }
+        if (lower.endsWith('.wasm') || lower.endsWith('.wasm.gz')) {
+            return 'application/wasm';
+        }
+        // If compressed, prefer octet-stream unless known
+        if (isCompressed) {
+            return 'application/octet-stream';
+        }
+        return undefined;
+    }
+    buildReturnedUrl(key, makePublic) {
+        if (!makePublic) {
+            return `s3://${this.bucketName}/${key}`;
+        }
+        if (this.publicBaseUrl) {
+            const base = this.publicBaseUrl.replace(/\/$/, '');
+            // key already includes basePath via getFullPath, so do not prefix basePath again
+            const full = key.replace(/^\/+/, '');
+            return `${base}/${full}`;
+        }
+        // Try to synthesize a URL from endpoint if available (works for public R2 buckets)
+        if (this.endpoint) {
+            try {
+                const url = new URL(this.endpoint);
+                return `https://${this.bucketName}.${url.host}/${key}`;
+            } catch  {
+            // fallthrough
+            }
+        }
+        // Fallback to AWS style URL if region looks valid
+        return `https://${this.bucketName}.s3.${this.region}.amazonaws.com/${key}`;
+    }
+    getBucketAndKey(pathOrUrlStr) {
+        if (URL.canParse(pathOrUrlStr)) {
+            const url = new URL(pathOrUrlStr);
+            if (url.protocol === 's3:') {
+                return {
+                    bucket: url.host,
+                    key: url.pathname.replace(/^\/+/, '')
+                };
+            }
+            // For https URLs, try to infer virtual-hosted or path-style
+            if (url.protocol === 'https:' || url.protocol === 'http:') {
+                // If the URL matches the configured publicBaseUrl host, map back to our bucket and key
+                if (this.publicBaseUrl && url.host === new URL(this.publicBaseUrl).host) {
+                    return {
+                        bucket: this.bucketName,
+                        key: url.pathname.replace(/^\/+/, '')
+                    };
+                }
+                const hostParts = url.host.split('.');
+                if (hostParts.length > 3 && (hostParts[1] === 's3' || hostParts[hostParts.length - 2] === 'r2')) {
+                    // virtual hosted
+                    return {
+                        bucket: hostParts[0],
+                        key: url.pathname.replace(/^\/+/, '')
+                    };
+                } else if (this.endpoint && url.host === new URL(this.endpoint).host) {
+                    // path-style at custom endpoint
+                    const [bucket, ...rest] = url.pathname.replace(/^\/+/, '').split('/');
+                    return {
+                        bucket,
+                        key: rest.join('/')
+                    };
+                }
+            }
+        }
+        // Treat as path
+        return {
+            bucket: this.bucketName,
+            key: this.getFullPath(pathOrUrlStr)
+        };
+    }
+    getFullPath(path) {
+        const base = normalizeBasePath(this.basePath);
+        const rel = path.replace(/^\/+/, '');
+        return base ? join(base, rel) : rel;
+    }
+}

package/dest/hash/hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/hash/hash.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,WAAW,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAG3D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,CAE1F;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAEpF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAErF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAEnF;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAEzG;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAM1D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAM/D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAEzD;AAED,wBAAsB,6BAA6B,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,eAMtG;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,WAAW,EACX,OAAO,EACP,aAAa,EACb,OAAO,GACR,EAAE;IACD,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,EAAE,EAAE,CAAC;IACZ,aAAa,EAAE,EAAE,CAAC;IAClB,OAAO,EAAE,EAAE,CAAC;CACb,MAEA"}
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/hash/hash.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,WAAW,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAG3D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,CAE1F;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAEpF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAErF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAEnF;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAEzG;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAM1D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAEzD;AAED,wBAAsB,6BAA6B,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,eAMtG;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,WAAW,EACX,OAAO,EACP,aAAa,EACb,OAAO,GACR,EAAE;IACD,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,EAAE,EAAE,CAAC;IACZ,aAAa,EAAE,EAAE,CAAC;IAClB,OAAO,EAAE,EAAE,CAAC;CACb,MAEA"}

package/dest/hash/hash.js

@@ -103,9 +103,6 @@ import { Fr } from '@aztec/foundation/fields';
  * @param calldata - Calldata to hash.
  * @returns Hash of the calldata.
  */ export function computeCalldataHash(calldata) {
-    if (calldata.length === 0) {
-        return Promise.resolve(Fr.ZERO);
-    }
     return poseidon2HashWithSeparator(calldata, GeneratorIndex.PUBLIC_CALLDATA);
 }
 /**