@hyperlane-xyz/provider-sdk 3.0.1 → 4.0.0

package/dist/artifact.d.ts

@@ -1,3 +1,4 @@
+import { ZERO_ADDRESS_HEX_32 } from '@hyperlane-xyz/utils';
 import { ISigner } from './altvm.js';
 import { AnnotatedTx, TxReceipt } from './module.js';
 export declare const ArtifactState: {
@@ -151,5 +152,13 @@ export interface IArtifactManager<TypeKey extends string, ConfigMap extends Reco
     createReader<T extends TypeKey>(type: T): ArtifactReader<ConfigMap[T], D>;
     createWriter<T extends TypeKey>(type: T, signer: ISigner<AnnotatedTx, TxReceipt>): ArtifactWriter<ConfigMap[T], D>;
 }
+export type UnsetArtifactAddress = typeof ZERO_ADDRESS_HEX_32;
+/**
+ * Returns the artifact if DEPLOYED, undefined if UNDERIVED with zero address.
+ * Throws if UNDERIVED with non-zero address.
+ */
+export declare function toDeployedOrUndefined<C, D extends {
+    address: string;
+}>(artifact: ArtifactOnChain<C, D>, name: string): ArtifactDeployed<C, D> | undefined;
 export {};
 //# sourceMappingURL=artifact.d.ts.map

package/dist/artifact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../src/artifact.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../src/artifact.ts"],"names":[],"mappings":"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"}

package/dist/artifact.js

@@ -1,3 +1,4 @@
+import { assert, isEmptyAddress, } from '@hyperlane-xyz/utils';
 export const ArtifactState = {
     NEW: 'new',
     DEPLOYED: 'deployed',
@@ -23,4 +24,14 @@ export function isArtifactDeployed(artifact) {
 export function isArtifactUnderived(artifact) {
     return artifact.artifactState === ArtifactState.UNDERIVED;
 }
+/**
+ * Returns the artifact if DEPLOYED, undefined if UNDERIVED with zero address.
+ * Throws if UNDERIVED with non-zero address.
+ */
+export function toDeployedOrUndefined(artifact, name) {
+    if (isArtifactDeployed(artifact))
+        return artifact;
+    assert(isEmptyAddress(artifact.deployed.address), `Expected ${name} to be DEPLOYED or UNDERIVED with zero address, got UNDERIVED with non-zero address ${artifact.deployed.address}`);
+    return undefined;
+}
 //# sourceMappingURL=artifact.js.map

package/dist/artifact.js.map

@@ -1 +1 @@
-{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../src/artifact.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,KAAK;IACV,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;CACd,CAAC;AAiDX;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAwB;IAExB,OAAO,CACL,QAAQ,CAAC,aAAa,KAAK,SAAS;QACpC,QAAQ,CAAC,aAAa,KAAK,aAAa,CAAC,GAAG,CAC7C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAwB;IAExB,OAAO,QAAQ,CAAC,aAAa,KAAK,aAAa,CAAC,QAAQ,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAwB;IAExB,OAAO,QAAQ,CAAC,aAAa,KAAK,aAAa,CAAC,SAAS,CAAC;AAC5D,CAAC"}
+{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../src/artifact.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,cAAc,GAEf,MAAM,sBAAsB,CAAC;AAI9B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,KAAK;IACV,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;CACd,CAAC;AAiDX;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAwB;IAExB,OAAO,CACL,QAAQ,CAAC,aAAa,KAAK,SAAS;QACpC,QAAQ,CAAC,aAAa,KAAK,aAAa,CAAC,GAAG,CAC7C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAwB;IAExB,OAAO,QAAQ,CAAC,aAAa,KAAK,aAAa,CAAC,QAAQ,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAwB;IAExB,OAAO,QAAQ,CAAC,aAAa,KAAK,aAAa,CAAC,SAAS,CAAC;AAC5D,CAAC;AAkID;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA+B,EAC/B,IAAY;IAEZ,IAAI,kBAAkB,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClD,MAAM,CACJ,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EACzC,YAAY,IAAI,uFAAuF,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,CACnI,CAAC;IACF,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/core.d.ts

@@ -1,5 +1,9 @@
+import { ArtifactNew, UnsetArtifactAddress } from './artifact.js';
+import { ChainLookup } from './chain.js';
 import type { DerivedHookConfig, HookConfig } from './hook.js';
 import type { DerivedIsmConfig, IsmConfig } from './ism.js';
+import { DeployedMailboxArtifact, MailboxArtifactConfig } from './mailbox.js';
+import { DeployedValidatorAnnounceArtifact } from './validator-announce.js';
 export type CoreModuleType = {
     config: CoreConfig;
     derived: DerivedCoreConfig;
@@ -12,9 +16,9 @@ export interface CoreConfig {
     requiredHook: HookConfig | string;
 }
 export interface DerivedCoreConfig extends CoreConfig {
-    defaultIsm: DerivedIsmConfig;
-    defaultHook: DerivedHookConfig;
-    requiredHook: DerivedHookConfig;
+    defaultIsm: DerivedIsmConfig | UnsetArtifactAddress;
+    defaultHook: DerivedHookConfig | UnsetArtifactAddress;
+    requiredHook: DerivedHookConfig | UnsetArtifactAddress;
 }
 export type DeployedCoreAddresses = {
     staticMerkleRootMultisigIsmFactory: string;
@@ -34,4 +38,24 @@ export type DeployedCoreAddresses = {
     merkleTreeHook?: string;
     interchainGasPaymaster?: string;
 };
+/**
+ * Converts CoreConfig to MailboxOnChain artifact format.
+ * Converts nested ISM and hook configs to artifact format.
+ *
+ * @param config CoreConfig with ISM/hook configs or addresses
+ * @param chainLookup Chain lookup for domain resolution
+ * @returns Mailbox artifact ready for deployment
+ */
+export declare function coreConfigToArtifact(config: CoreConfig, chainLookup: ChainLookup): ArtifactNew<MailboxArtifactConfig>;
+/**
+ * Converts CoreWriter result to DeployedCoreAddresses format.
+ * Maps deployed ISM and hook types to factory address fields.
+ *
+ * @param result CoreWriter create() result with mailbox and validator announce artifacts
+ * @returns DeployedCoreAddresses with factory addresses mapped
+ */
+export declare function coreResultToDeployedAddresses(result: {
+    mailbox: DeployedMailboxArtifact;
+    validatorAnnounce: DeployedValidatorAnnounceArtifact | null;
+}): DeployedCoreAddresses;
 //# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE5D,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,SAAS,EAAE,qBAAqB,CAAC;CAClC,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,SAAS,GAAG,MAAM,CAAC;IAC/B,WAAW,EAAE,UAAU,GAAG,MAAM,CAAC;IACjC,YAAY,EAAE,UAAU,GAAG,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,UAAU,EAAE,gBAAgB,CAAC;IAC7B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,YAAY,EAAE,iBAAiB,CAAC;CACjC;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,kCAAkC,EAAE,MAAM,CAAC;IAC3C,iCAAiC,EAAE,MAAM,CAAC;IAC1C,2BAA2B,EAAE,MAAM,CAAC;IACpC,4BAA4B,EAAE,MAAM,CAAC;IACrC,uBAAuB,EAAE,MAAM,CAAC;IAChC,kCAAkC,EAAE,MAAM,CAAC;IAC3C,0CAA0C,EAAE,MAAM,CAAC;IACnD,yCAAyC,EAAE,MAAM,CAAC;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EAGX,oBAAoB,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAM/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAM5D,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAC;AAE5E,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,SAAS,EAAE,qBAAqB,CAAC;CAClC,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,SAAS,GAAG,MAAM,CAAC;IAC/B,WAAW,EAAE,UAAU,GAAG,MAAM,CAAC;IACjC,YAAY,EAAE,UAAU,GAAG,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,UAAU,EAAE,gBAAgB,GAAG,oBAAoB,CAAC;IACpD,WAAW,EAAE,iBAAiB,GAAG,oBAAoB,CAAC;IACtD,YAAY,EAAE,iBAAiB,GAAG,oBAAoB,CAAC;CACxD;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,kCAAkC,EAAE,MAAM,CAAC;IAC3C,iCAAiC,EAAE,MAAM,CAAC;IAC1C,2BAA2B,EAAE,MAAM,CAAC;IACpC,4BAA4B,EAAE,MAAM,CAAC;IACrC,uBAAuB,EAAE,MAAM,CAAC;IAChC,kCAAkC,EAAE,MAAM,CAAC;IAC3C,0CAA0C,EAAE,MAAM,CAAC;IACnD,yCAAyC,EAAE,MAAM,CAAC;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,WAAW,GACvB,WAAW,CAAC,qBAAqB,CAAC,CA6CpC;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,OAAO,EAAE,uBAAuB,CAAC;IACjC,iBAAiB,EAAE,iCAAiC,GAAG,IAAI,CAAC;CAC7D,GAAG,qBAAqB,CAqExB"}

package/dist/core.js

@@ -1,2 +1,128 @@
-export {};
+import { ArtifactState, isArtifactDeployed, } from './artifact.js';
+import { hookConfigToArtifact, } from './hook.js';
+import { ismConfigToArtifact, } from './ism.js';
+/**
+ * Converts CoreConfig to MailboxOnChain artifact format.
+ * Converts nested ISM and hook configs to artifact format.
+ *
+ * @param config CoreConfig with ISM/hook configs or addresses
+ * @param chainLookup Chain lookup for domain resolution
+ * @returns Mailbox artifact ready for deployment
+ */
+export function coreConfigToArtifact(config, chainLookup) {
+    // Convert ISM config to artifact (handles both string addresses and config objects)
+    let defaultIsmArtifact;
+    if (typeof config.defaultIsm === 'string') {
+        defaultIsmArtifact = {
+            artifactState: ArtifactState.UNDERIVED,
+            deployed: { address: config.defaultIsm },
+        };
+    }
+    else {
+        defaultIsmArtifact = ismConfigToArtifact(config.defaultIsm, chainLookup);
+    }
+    // Convert hook configs to artifacts
+    let defaultHookArtifact;
+    if (typeof config.defaultHook === 'string') {
+        defaultHookArtifact = {
+            artifactState: ArtifactState.UNDERIVED,
+            deployed: { address: config.defaultHook },
+        };
+    }
+    else {
+        defaultHookArtifact = hookConfigToArtifact(config.defaultHook, chainLookup);
+    }
+    let requiredHookArtifact;
+    if (typeof config.requiredHook === 'string') {
+        requiredHookArtifact = {
+            artifactState: ArtifactState.UNDERIVED,
+            deployed: { address: config.requiredHook },
+        };
+    }
+    else {
+        requiredHookArtifact = hookConfigToArtifact(config.requiredHook, chainLookup);
+    }
+    return {
+        artifactState: ArtifactState.NEW,
+        config: {
+            owner: config.owner,
+            defaultIsm: defaultIsmArtifact,
+            defaultHook: defaultHookArtifact,
+            requiredHook: requiredHookArtifact,
+        },
+    };
+}
+/**
+ * Converts CoreWriter result to DeployedCoreAddresses format.
+ * Maps deployed ISM and hook types to factory address fields.
+ *
+ * @param result CoreWriter create() result with mailbox and validator announce artifacts
+ * @returns DeployedCoreAddresses with factory addresses mapped
+ */
+export function coreResultToDeployedAddresses(result) {
+    const addresses = {
+        mailbox: result.mailbox.deployed.address,
+        validatorAnnounce: result.validatorAnnounce?.deployed.address ?? '',
+        staticMerkleRootMultisigIsmFactory: '',
+        proxyAdmin: '',
+        staticMerkleRootWeightedMultisigIsmFactory: '',
+        incrementalDomainRoutingIsmFactory: '',
+        staticAggregationHookFactory: '',
+        staticAggregationIsmFactory: '',
+        staticMessageIdMultisigIsmFactory: '',
+        staticMessageIdWeightedMultisigIsmFactory: '',
+        testRecipient: '',
+        interchainAccountRouter: '',
+        domainRoutingIsmFactory: '',
+    };
+    // Map ISM address to factory field based on type
+    const ismArtifact = result.mailbox.config.defaultIsm;
+    if (isArtifactDeployed(ismArtifact)) {
+        const ismAddress = ismArtifact.deployed.address;
+        switch (ismArtifact.config.type) {
+            case 'merkleRootMultisigIsm':
+                addresses.staticMerkleRootMultisigIsmFactory = ismAddress;
+                break;
+            case 'messageIdMultisigIsm':
+                addresses.staticMessageIdMultisigIsmFactory = ismAddress;
+                break;
+            case 'domainRoutingIsm':
+                addresses.domainRoutingIsmFactory = ismAddress;
+                break;
+        }
+    }
+    // Map default hook address to factory field
+    const defaultHookArtifact = result.mailbox.config.defaultHook;
+    if (isArtifactDeployed(defaultHookArtifact)) {
+        const hookAddress = defaultHookArtifact.deployed.address;
+        switch (defaultHookArtifact.config.type) {
+            case 'interchainGasPaymaster':
+                addresses.interchainGasPaymaster = hookAddress;
+                break;
+            case 'merkleTreeHook':
+                addresses.merkleTreeHook = hookAddress;
+                break;
+        }
+    }
+    // Map required hook address to factory field
+    const requiredHookArtifact = result.mailbox.config.requiredHook;
+    if (isArtifactDeployed(requiredHookArtifact)) {
+        const hookAddress = requiredHookArtifact.deployed.address;
+        switch (requiredHookArtifact.config.type) {
+            case 'interchainGasPaymaster':
+                // Only set if not already set by default hook
+                if (!addresses.interchainGasPaymaster) {
+                    addresses.interchainGasPaymaster = hookAddress;
+                }
+                break;
+            case 'merkleTreeHook':
+                // Only set if not already set by default hook
+                if (!addresses.merkleTreeHook) {
+                    addresses.merkleTreeHook = hookAddress;
+                }
+                break;
+        }
+    }
+    return addresses;
+}
 //# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":""}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,aAAa,EACb,kBAAkB,GAEnB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAGL,oBAAoB,GACrB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAGL,mBAAmB,GACpB,MAAM,UAAU,CAAC;AA0ClB;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAkB,EAClB,WAAwB;IAExB,oFAAoF;IACpF,IAAI,kBAAmE,CAAC;IACxE,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC1C,kBAAkB,GAAG;YACnB,aAAa,EAAE,aAAa,CAAC,SAAS;YACtC,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE;SACzC,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,kBAAkB,GAAG,mBAAmB,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAC3E,CAAC;IAED,oCAAoC;IACpC,IAAI,mBAAsE,CAAC;IAC3E,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC3C,mBAAmB,GAAG;YACpB,aAAa,EAAE,aAAa,CAAC,SAAS;YACtC,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE;SAC1C,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,mBAAmB,GAAG,oBAAoB,CAAC,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,oBAAuE,CAAC;IAC5E,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC5C,oBAAoB,GAAG;YACrB,aAAa,EAAE,aAAa,CAAC,SAAS;YACtC,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE;SAC3C,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,oBAAoB,GAAG,oBAAoB,CACzC,MAAM,CAAC,YAAY,EACnB,WAAW,CACZ,CAAC;IACJ,CAAC;IAED,OAAO;QACL,aAAa,EAAE,aAAa,CAAC,GAAG;QAChC,MAAM,EAAE;YACN,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU,EAAE,kBAAkB;YAC9B,WAAW,EAAE,mBAAmB;YAChC,YAAY,EAAE,oBAAoB;SACnC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAG7C;IACC,MAAM,SAAS,GAA0B;QACvC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO;QACxC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE;QACnE,kCAAkC,EAAE,EAAE;QACtC,UAAU,EAAE,EAAE;QACd,0CAA0C,EAAE,EAAE;QAC9C,kCAAkC,EAAE,EAAE;QACtC,4BAA4B,EAAE,EAAE;QAChC,2BAA2B,EAAE,EAAE;QAC/B,iCAAiC,EAAE,EAAE;QACrC,yCAAyC,EAAE,EAAE;QAC7C,aAAa,EAAE,EAAE;QACjB,uBAAuB,EAAE,EAAE;QAC3B,uBAAuB,EAAE,EAAE;KAC5B,CAAC;IAEF,iDAAiD;IACjD,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;IACrD,IAAI,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC;QAChD,QAAQ,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAChC,KAAK,uBAAuB;gBAC1B,SAAS,CAAC,kCAAkC,GAAG,UAAU,CAAC;gBAC1D,MAAM;YACR,KAAK,sBAAsB;gBACzB,SAAS,CAAC,iCAAiC,GAAG,UAAU,CAAC;gBACzD,MAAM;YACR,KAAK,kBAAkB;gBACrB,SAAS,CAAC,uBAAuB,GAAG,UAAU,CAAC;gBAC/C,MAAM;QACV,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;IAC9D,IAAI,kBAAkB,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC5C,MAAM,WAAW,GAAG,mBAAmB,CAAC,QAAQ,CAAC,OAAO,CAAC;QACzD,QAAQ,mBAAmB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACxC,KAAK,wBAAwB;gBAC3B,SAAS,CAAC,sBAAsB,GAAG,WAAW,CAAC;gBAC/C,MAAM;YACR,KAAK,gBAAgB;gBACnB,SAAS,CAAC,cAAc,GAAG,WAAW,CAAC;gBACvC,MAAM;QACV,CAAC;IACH,CAAC;IAED,6CAA6C;IAC7C,MAAM,oBAAoB,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC;IAChE,IAAI,kBAAkB,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC7C,MAAM,WAAW,GAAG,oBAAoB,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC1D,QAAQ,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACzC,KAAK,wBAAwB;gBAC3B,8CAA8C;gBAC9C,IAAI,CAAC,SAAS,CAAC,sBAAsB,EAAE,CAAC;oBACtC,SAAS,CAAC,sBAAsB,GAAG,WAAW,CAAC;gBACjD,CAAC;gBACD,MAAM;YACR,KAAK,gBAAgB;gBACnB,8CAA8C;gBAC9C,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;oBAC9B,SAAS,CAAC,cAAc,GAAG,WAAW,CAAC;gBACzC,CAAC;gBACD,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * as AltVM from './altvm.js';
 export { ChainMetadataForAltVM } from './chain.js';
+export { coreConfigToArtifact, coreResultToDeployedAddresses } from './core.js';
 export { MinimumRequiredGasByAction, GasAction } from './mingas.js';
 export { ProtocolType, ProtocolTypeValue, ProtocolSmallestUnit, SignerConfig, ProtocolProvider, registerProtocol, getProtocolProvider, hasProtocol, listProtocols, } from './protocol.js';
 export { ITransactionSubmitter, TransactionSubmitterConfig, JsonRpcSubmitterConfig, FileSubmitterConfig, } from './submitter.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,0BAA0B,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * as AltVM from './altvm.js';
+export { coreConfigToArtifact, coreResultToDeployedAddresses } from './core.js';
 export { GasAction } from './mingas.js';
 export { ProtocolType, ProtocolSmallestUnit, registerProtocol, getProtocolProvider, hasProtocol, listProtocols, } from './protocol.js';
 export { MockProvider } from './test/AltVMMockProvider.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAEpC,OAAO,EAA8B,SAAS,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EACL,YAAY,EAEZ,oBAAoB,EAGpB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,aAAa,GACd,MAAM,eAAe,CAAC;AAOvB,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,oBAAoB,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EAA8B,SAAS,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EACL,YAAY,EAEZ,oBAAoB,EAGpB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,aAAa,GACd,MAAM,eAAe,CAAC;AAOvB,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/mailbox.d.ts

@@ -0,0 +1,90 @@
+import { Artifact, ArtifactDeployed, ConfigOnChain, IArtifactManager } from './artifact.js';
+import type { ChainLookup } from './chain.js';
+import type { DerivedCoreConfig } from './core.js';
+import type { DeployedHookAddress, DeployedHookArtifact, DerivedHookConfig, HookArtifactConfig } from './hook.js';
+import type { DeployedIsmAddress, DeployedIsmArtifact, DerivedIsmConfig, IsmArtifactConfig } from './ism.js';
+/**
+ * Mailbox configuration for the Artifact API.
+ * Defines the parameters needed to deploy or configure a mailbox.
+ */
+export interface MailboxArtifactConfig {
+    owner: string;
+    defaultIsm: Artifact<IsmArtifactConfig, DeployedIsmAddress>;
+    defaultHook: Artifact<HookArtifactConfig, DeployedHookAddress>;
+    requiredHook: Artifact<HookArtifactConfig, DeployedHookAddress>;
+}
+/**
+ * Deployment data returned after deploying a mailbox.
+ * Contains the on-chain address and optionally the domain ID.
+ */
+export interface DeployedMailboxAddress {
+    address: string;
+    domainId?: number;
+}
+/**
+ * Describes the configuration of a deployed mailbox
+ */
+export type DeployedMailboxArtifact = ArtifactDeployed<ConfigOnChain<MailboxArtifactConfig>, DeployedMailboxAddress>;
+/**
+ * Mailbox artifact configs map
+ */
+export interface MailboxArtifactConfigs {
+    mailbox: MailboxArtifactConfig;
+}
+export type MailboxType = keyof MailboxArtifactConfigs;
+/**
+ * Should be used to implement an object/closure or class that is in charge of coordinating
+ * deployment of a Mailbox config, including nested ISM and Hook deployments.
+ */
+export type IMailboxArtifactManager = IArtifactManager<MailboxType, MailboxArtifactConfigs, DeployedMailboxAddress>;
+/**
+ * Raw mailbox config - uses ArtifactOnChain for nested artifacts instead of Artifact.
+ * This is the format used by protocol implementations that work directly with on-chain state.
+ */
+export type MailboxOnChain = ConfigOnChain<MailboxArtifactConfig>;
+/**
+ * Raw mailbox artifact configs map
+ */
+export interface RawMailboxArtifactConfigs {
+    mailbox: MailboxOnChain;
+}
+/**
+ * Should be used for the specific artifact code that
+ * deploys or reads a single mailbox artifact on chain
+ */
+export type RawMailboxArtifactConfig = RawMailboxArtifactConfigs[MailboxType];
+/**
+ * Describes the configuration of deployed mailbox without nested config expansion
+ */
+export type DeployedRawMailboxArtifact = ArtifactDeployed<RawMailboxArtifactConfig, DeployedMailboxAddress>;
+/**
+ * Should be used to implement an object/closure or class that individually deploys
+ * Mailboxes on chain
+ */
+export interface IRawMailboxArtifactManager extends IArtifactManager<MailboxType, RawMailboxArtifactConfigs, DeployedMailboxAddress> {
+    /**
+     * Read a mailbox by its address.
+     * This is the entry point for reading mailbox configuration from the chain.
+     * @param address The on-chain address of the mailbox
+     * @returns The artifact configuration and deployment data
+     */
+    readMailbox(address: string): Promise<DeployedRawMailboxArtifact>;
+}
+/**
+ * Converts a DeployedMailboxArtifact (with fully expanded nested ISM/hook artifacts)
+ * to the DerivedCoreConfig format for backward compatibility.
+ *
+ * This function is used by CoreArtifactReader to provide the deriveCoreConfig() method
+ * that existing code expects. The conversion functions for ISM and Hook artifacts
+ * must be passed in to avoid circular dependencies.
+ *
+ * @param artifact The deployed mailbox artifact with expanded nested configs
+ * @param chainLookup Chain lookup for converting domain IDs to chain names
+ * @param converters Object containing ismArtifactToDerivedConfig and hookArtifactToDerivedConfig functions
+ * @returns DerivedCoreConfig in the legacy format (from core.ts)
+ */
+export declare function mailboxArtifactToDerivedCoreConfig(artifact: DeployedMailboxArtifact, chainLookup: ChainLookup, converters: {
+    ismArtifactToDerivedConfig: (artifact: DeployedIsmArtifact, chainLookup: ChainLookup) => DerivedIsmConfig;
+    hookArtifactToDerivedConfig: (artifact: DeployedHookArtifact, chainLookup: ChainLookup) => DerivedHookConfig;
+}): DerivedCoreConfig;
+//# sourceMappingURL=mailbox.d.ts.map

package/dist/mailbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../src/mailbox.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,gBAAgB,EAEhB,aAAa,EACb,gBAAgB,EAGjB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAKlB;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,QAAQ,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;IAC5D,WAAW,EAAE,QAAQ,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;IAC/D,YAAY,EAAE,QAAQ,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;CACjE;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,CACpD,aAAa,CAAC,qBAAqB,CAAC,EACpC,sBAAsB,CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,sBAAsB,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,CACpD,WAAW,EACX,sBAAsB,EACtB,sBAAsB,CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC,qBAAqB,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,yBAAyB,CAAC,WAAW,CAAC,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,gBAAgB,CACvD,wBAAwB,EACxB,sBAAsB,CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB,CAClE,WAAW,EACX,yBAAyB,EACzB,sBAAsB,CACvB;IACC;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,uBAAuB,EACjC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE;IACV,0BAA0B,EAAE,CAC1B,QAAQ,EAAE,mBAAmB,EAC7B,WAAW,EAAE,WAAW,KACrB,gBAAgB,CAAC;IACtB,2BAA2B,EAAE,CAC3B,QAAQ,EAAE,oBAAoB,EAC9B,WAAW,EAAE,WAAW,KACrB,iBAAiB,CAAC;CACxB,GACA,iBAAiB,CAenB"}

package/dist/mailbox.js

@@ -0,0 +1,29 @@
+import { toDeployedOrUndefined, } from './artifact.js';
+import { ZERO_ADDRESS_HEX_32 } from '@hyperlane-xyz/utils';
+/**
+ * Converts a DeployedMailboxArtifact (with fully expanded nested ISM/hook artifacts)
+ * to the DerivedCoreConfig format for backward compatibility.
+ *
+ * This function is used by CoreArtifactReader to provide the deriveCoreConfig() method
+ * that existing code expects. The conversion functions for ISM and Hook artifacts
+ * must be passed in to avoid circular dependencies.
+ *
+ * @param artifact The deployed mailbox artifact with expanded nested configs
+ * @param chainLookup Chain lookup for converting domain IDs to chain names
+ * @param converters Object containing ismArtifactToDerivedConfig and hookArtifactToDerivedConfig functions
+ * @returns DerivedCoreConfig in the legacy format (from core.ts)
+ */
+export function mailboxArtifactToDerivedCoreConfig(artifact, chainLookup, converters) {
+    const { defaultIsm, defaultHook, requiredHook, owner } = artifact.config;
+    return {
+        owner,
+        defaultIsm: fromOnChainArtifact(defaultIsm, 'defaultIsm', (a) => converters.ismArtifactToDerivedConfig(a, chainLookup)),
+        defaultHook: fromOnChainArtifact(defaultHook, 'defaultHook', (a) => converters.hookArtifactToDerivedConfig(a, chainLookup)),
+        requiredHook: fromOnChainArtifact(requiredHook, 'requiredHook', (a) => converters.hookArtifactToDerivedConfig(a, chainLookup)),
+    };
+}
+function fromOnChainArtifact(artifact, fieldName, convert) {
+    const deployed = toDeployedOrUndefined(artifact, fieldName);
+    return deployed ? convert(deployed) : ZERO_ADDRESS_HEX_32;
+}
+//# sourceMappingURL=mailbox.js.map

package/dist/mailbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.js","sourceRoot":"","sources":["../src/mailbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAevB,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAgG3D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kCAAkC,CAChD,QAAiC,EACjC,WAAwB,EACxB,UASC;IAED,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC;IAEzE,OAAO;QACL,KAAK;QACL,UAAU,EAAE,mBAAmB,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAC9D,UAAU,CAAC,0BAA0B,CAAC,CAAC,EAAE,WAAW,CAAC,CACtD;QACD,WAAW,EAAE,mBAAmB,CAAC,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CACjE,UAAU,CAAC,2BAA2B,CAAC,CAAC,EAAE,WAAW,CAAC,CACvD;QACD,YAAY,EAAE,mBAAmB,CAAC,YAAY,EAAE,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,CACpE,UAAU,CAAC,2BAA2B,CAAC,CAAC,EAAE,WAAW,CAAC,CACvD;KACF,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,QAA+B,EAC/B,SAAkC,EAClC,OAAgD;IAEhD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC5D,OAAO,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC;AAC5D,CAAC"}

package/dist/protocol.d.ts

@@ -2,10 +2,12 @@ import { IProvider, ISigner } from './altvm.js';
 import type { ChainMetadataForAltVM } from './chain.js';
 import { IRawHookArtifactManager } from './hook.js';
 import { IRawIsmArtifactManager } from './ism.js';
+import { IRawMailboxArtifactManager } from './mailbox.js';
 import { MinimumRequiredGasByAction } from './mingas.js';
 import { AnnotatedTx, TxReceipt } from './module.js';
 import { ITransactionSubmitter, JsonRpcSubmitterConfig, TransactionSubmitterConfig } from './submitter.js';
 import { IRawWarpArtifactManager } from './warp.js';
+import { IRawValidatorAnnounceArtifactManager } from './validator-announce.js';
 export declare enum ProtocolType {
     Ethereum = "ethereum",
     Sealevel = "sealevel",
@@ -71,6 +73,26 @@ export interface ProtocolProvider {
     createWarpArtifactManager(chainMetadata: ChainMetadataForAltVM, context?: {
         mailbox?: string;
     }): IRawWarpArtifactManager;
+    /**
+     * Creates a Mailbox artifact manager for the protocol.
+     * The artifact manager provides protocol-specific readers and writers
+     * that handle Mailbox operations using the Artifact API pattern.
+     *
+     * @param chainMetadata Chain metadata for the target chain
+     * @returns A protocol-specific Mailbox artifact manager
+     */
+    createMailboxArtifactManager(chainMetadata: ChainMetadataForAltVM): IRawMailboxArtifactManager;
+    /**
+     * Creates a Validator Announce artifact manager for the protocol.
+     * The artifact manager provides protocol-specific readers and writers
+     * that handle Validator Announce operations using the Artifact API pattern.
+     *
+     * Not all protocols support validator announce (e.g., Cosmos does not).
+     *
+     * @param chainMetadata Chain metadata for the target chain
+     * @returns A protocol-specific Validator Announce artifact manager, or null if not supported
+     */
+    createValidatorAnnounceArtifactManager(chainMetadata: ChainMetadataForAltVM): IRawValidatorAnnounceArtifactManager | null;
     getMinGas(): MinimumRequiredGasByAction;
 }
 /**

package/dist/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAEpD,oBAAY,YAAY;IACtB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,YAAY,iBAAiB;IAC7B,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAGD,MAAM,MAAM,iBAAiB,GAAG,GAAG,YAAY,EAAE,CAAC;AAElD,eAAO,MAAM,oBAAoB;;;;;;;;;;CAUhC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,IAAI,CAC7B,sBAAsB,EACtB,YAAY,GAAG,gBAAgB,CAChC,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,aAAa,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACzE,YAAY,CACV,aAAa,EAAE,qBAAqB,EACpC,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IAE5C,eAAe,CAAC,OAAO,SAAS,0BAA0B,EACxD,aAAa,EAAE,qBAAqB,EACpC,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAElC;;;;;;;OAOG;IACH,wBAAwB,CACtB,aAAa,EAAE,qBAAqB,GACnC,sBAAsB,CAAC;IAE1B;;;;;;;;OAQG;IACH,yBAAyB,CACvB,aAAa,EAAE,qBAAqB,EACpC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7B,uBAAuB,CAAC;IAE3B;;;;;;;;OAQG;IACH,yBAAyB,CACvB,aAAa,EAAE,qBAAqB,EACpC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7B,uBAAuB,CAAC;IAE3B,SAAS,IAAI,0BAA0B,CAAC;CACzC;AAED;;GAEG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,SAAS,CAAmD;IAEpE,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO;IAI5C,aAAa,IAAI,YAAY,EAAE;IAI/B,gBAAgB,CACd,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,MAAM,gBAAgB,GAC9B,IAAI;IASP,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,gBAAgB;CAS9D;AAKD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,aA/Bf,YAAY,WACb,MAAM,gBAAgB,KAC9B,IA8BqD,CAAC;AAE3D;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,aA9BA,YAAY,KAAG,gBA+Bc,CAAC;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,WAAW,aA3DA,YAAY,KAAG,OA2DuC,CAAC;AAE/E;;;;GAIG;AACH,eAAO,MAAM,aAAa,QA9DP,YAAY,EA+DwB,CAAC"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}

package/dist/protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAe9C,MAAM,CAAN,IAAY,YAUX;AAVD,WAAY,YAAY;IACtB,qCAAqB,CAAA;IACrB,qCAAqB,CAAA;IACrB,iCAAiB,CAAA;IACjB,6CAA6B,CAAA;IAC7B,qCAAqB,CAAA;IACrB,+BAAe,CAAA;IACf,6BAAa,CAAA;IACb,6BAAa,CAAA;IACb,mCAAmB,CAAA;AACrB,CAAC,EAVW,YAAY,KAAZ,YAAY,QAUvB;AAKD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,KAAK;IAC9B,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,UAAU;IACnC,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO;IAC9B,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,OAAO;IACpC,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,KAAK;IAC9B,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO;IAC7B,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,cAAc;IACnC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK;IAC1B,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,SAAS;CAClC,CAAC;AAkEF;;GAEG;AACH,MAAM,OAAO,wBAAwB;IAC3B,SAAS,GAAG,IAAI,GAAG,EAAwC,CAAC;IAEpE,WAAW,CAAC,QAAsB;QAChC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,gBAAgB,CACd,QAAsB,EACtB,OAA+B;QAE/B,MAAM,CACJ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAC3B,aAAa,QAAQ,yBAAyB,CAC/C,CAAC;QAEF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,mBAAmB,CAAC,QAAsB;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,CACJ,OAAO,EACP,aAAa,QAAQ,6CAA6C,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CAC9G,CAAC;QAEF,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;CACF;AAED,8BAA8B;AAC9B,MAAM,gBAAgB,GAAG,IAAI,wBAAwB,EAAE,CAAC;AAExD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAC3B,gBAAgB,CAAC,gBAAgB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,gBAAgB,CAAC,mBAAmB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,gBAAgB,CAAC,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GACxB,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAiB9C,MAAM,CAAN,IAAY,YAUX;AAVD,WAAY,YAAY;IACtB,qCAAqB,CAAA;IACrB,qCAAqB,CAAA;IACrB,iCAAiB,CAAA;IACjB,6CAA6B,CAAA;IAC7B,qCAAqB,CAAA;IACrB,+BAAe,CAAA;IACf,6BAAa,CAAA;IACb,6BAAa,CAAA;IACb,mCAAmB,CAAA;AACrB,CAAC,EAVW,YAAY,KAAZ,YAAY,QAUvB;AAKD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,KAAK;IAC9B,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,UAAU;IACnC,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO;IAC9B,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,OAAO;IACpC,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,KAAK;IAC9B,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO;IAC7B,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,cAAc;IACnC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK;IAC1B,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,SAAS;CAClC,CAAC;AA4FF;;GAEG;AACH,MAAM,OAAO,wBAAwB;IAC3B,SAAS,GAAG,IAAI,GAAG,EAAwC,CAAC;IAEpE,WAAW,CAAC,QAAsB;QAChC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,gBAAgB,CACd,QAAsB,EACtB,OAA+B;QAE/B,MAAM,CACJ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAC3B,aAAa,QAAQ,yBAAyB,CAC/C,CAAC;QAEF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,mBAAmB,CAAC,QAAsB;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,CACJ,OAAO,EACP,aAAa,QAAQ,6CAA6C,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CAC9G,CAAC;QAEF,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;CACF;AAED,8BAA8B;AAC9B,MAAM,gBAAgB,GAAG,IAAI,wBAAwB,EAAE,CAAC;AAExD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAC3B,gBAAgB,CAAC,gBAAgB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,gBAAgB,CAAC,mBAAmB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,gBAAgB,CAAC,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GACxB,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/validator-announce.d.ts

@@ -0,0 +1,67 @@
+import { ArtifactDeployed, IArtifactManager } from './artifact.js';
+/**
+ * Validator Announce configuration for the Artifact API.
+ * Defines the parameters needed to deploy or configure a validator announce contract.
+ */
+export interface ValidatorAnnounceArtifactConfig {
+    mailboxAddress: string;
+}
+/**
+ * Deployment data returned after deploying a validator announce contract.
+ * Contains the on-chain address.
+ */
+export interface DeployedValidatorAnnounceAddress {
+    address: string;
+}
+/**
+ * Describes the configuration of a deployed validator announce contract
+ */
+export type DeployedValidatorAnnounceArtifact = ArtifactDeployed<ValidatorAnnounceArtifactConfig, DeployedValidatorAnnounceAddress>;
+/**
+ * Validator announce artifact configs map
+ */
+export interface ValidatorAnnounceArtifactConfigs {
+    validatorAnnounce: ValidatorAnnounceArtifactConfig;
+}
+export type ValidatorAnnounceType = keyof ValidatorAnnounceArtifactConfigs;
+/**
+ * Should be used to implement an object/closure or class that is in charge of coordinating
+ * deployment of a ValidatorAnnounce config.
+ */
+export type IValidatorAnnounceArtifactManager = IArtifactManager<ValidatorAnnounceType, ValidatorAnnounceArtifactConfigs, DeployedValidatorAnnounceAddress>;
+/**
+ * Raw validator announce config - identical to the compound config since there are no nested artifacts.
+ * Kept for consistency with the artifact API pattern.
+ */
+export interface RawValidatorAnnounceConfig {
+    mailboxAddress: string;
+}
+/**
+ * Raw validator announce artifact configs map
+ */
+export interface RawValidatorAnnounceArtifactConfigs {
+    validatorAnnounce: RawValidatorAnnounceConfig;
+}
+/**
+ * Should be used for the specific artifact code that
+ * deploys or reads a single validator announce artifact on chain
+ */
+export type RawValidatorAnnounceArtifactConfig = RawValidatorAnnounceArtifactConfigs[ValidatorAnnounceType];
+/**
+ * Describes the configuration of deployed validator announce without nested config expansion
+ */
+export type DeployedRawValidatorAnnounceArtifact = ArtifactDeployed<RawValidatorAnnounceArtifactConfig, DeployedValidatorAnnounceAddress>;
+/**
+ * Should be used to implement an object/closure or class that individually deploys
+ * ValidatorAnnounce contracts on chain
+ */
+export interface IRawValidatorAnnounceArtifactManager extends IArtifactManager<ValidatorAnnounceType, RawValidatorAnnounceArtifactConfigs, DeployedValidatorAnnounceAddress> {
+    /**
+     * Read a validator announce contract by its address.
+     * This is the entry point for reading validator announce configuration from the chain.
+     * @param address The on-chain address of the validator announce contract
+     * @returns The artifact configuration and deployment data
+     */
+    readValidatorAnnounce(address: string): Promise<DeployedRawValidatorAnnounceArtifact>;
+}
+//# sourceMappingURL=validator-announce.d.ts.map

package/dist/validator-announce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator-announce.d.ts","sourceRoot":"","sources":["../src/validator-announce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAInE;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC9C,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,iCAAiC,GAAG,gBAAgB,CAC9D,+BAA+B,EAC/B,gCAAgC,CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,iBAAiB,EAAE,+BAA+B,CAAC;CACpD;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,gCAAgC,CAAC;AAE3E;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GAAG,gBAAgB,CAC9D,qBAAqB,EACrB,gCAAgC,EAChC,gCAAgC,CACjC,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD,iBAAiB,EAAE,0BAA0B,CAAC;CAC/C;AAED;;;GAGG;AACH,MAAM,MAAM,kCAAkC,GAC5C,mCAAmC,CAAC,qBAAqB,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,oCAAoC,GAAG,gBAAgB,CACjE,kCAAkC,EAClC,gCAAgC,CACjC,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,oCAAqC,SAAQ,gBAAgB,CAC5E,qBAAqB,EACrB,mCAAmC,EACnC,gCAAgC,CACjC;IACC;;;;;OAKG;IACH,qBAAqB,CACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,oCAAoC,CAAC,CAAC;CAClD"}

package/dist/validator-announce.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validator-announce.js.map

package/dist/validator-announce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator-announce.js","sourceRoot":"","sources":["../src/validator-announce.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperlane-xyz/provider-sdk",
-  "version": "3.0.1",
+  "version": "4.0.0",
   "description": "Protocol Provider SDK for the Hyperlane Protocol",
   "license": "Apache-2.0",
   "repository": "https://github.com/hyperlane-xyz/hyperlane-monorepo",
@@ -17,6 +17,8 @@
     "./hook": "./dist/hook.js",
     "./ism": "./dist/ism.js",
     "./core": "./dist/core.js",
+    "./mailbox": "./dist/mailbox.js",
+    "./validator-announce": "./dist/validator-announce.js",
     "./warp": "./dist/warp.js",
     "./factory": "./dist/factory.js",
     "./submitter": "./dist/submitter.js",
@@ -26,7 +28,7 @@
   "dependencies": {
     "pino": "^8.19.0",
     "zod": "^3.21.2",
-    "@hyperlane-xyz/utils": "27.0.0"
+    "@hyperlane-xyz/utils": "28.0.0"
   },
   "devDependencies": {
     "@types/chai": "^4.3.11",
@@ -37,8 +39,8 @@
     "mocha": "^11.5.0",
     "tsx": "^4.19.1",
     "typescript": "5.8.3",
-    "@hyperlane-xyz/eslint-config": "^27.0.0",
-    "@hyperlane-xyz/tsconfig": "^27.0.0"
+    "@hyperlane-xyz/eslint-config": "^28.0.0",
+    "@hyperlane-xyz/tsconfig": "^28.0.0"
   },
   "scripts": {
     "build": "tsc",