@hyperlane-xyz/radix-sdk 27.0.0 → 28.0.0

package/dist/mailbox/mailbox.js

@@ -0,0 +1,171 @@
+import { ArtifactState, } from '@hyperlane-xyz/provider-sdk/artifact';
+import { ZERO_ADDRESS_HEX_32, eqAddressRadix, eqOptionalAddress, isEmptyAddress, } from '@hyperlane-xyz/utils';
+import { getMailboxConfig } from './mailbox-query.js';
+import { getCreateMailboxTx, getSetMailboxDefaultHookTx, getSetMailboxDefaultIsmTx, getSetMailboxOwnerTx, getSetMailboxRequiredHookTx, } from './mailbox-tx.js';
+export class RadixMailboxReader {
+    gateway;
+    constructor(gateway) {
+        this.gateway = gateway;
+    }
+    async read(address) {
+        const mailboxConfig = await getMailboxConfig(this.gateway, address);
+        return {
+            artifactState: ArtifactState.DEPLOYED,
+            config: {
+                owner: mailboxConfig.owner,
+                defaultIsm: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: {
+                        address: mailboxConfig.defaultIsm || ZERO_ADDRESS_HEX_32,
+                    },
+                },
+                defaultHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: {
+                        address: mailboxConfig.defaultHook || ZERO_ADDRESS_HEX_32,
+                    },
+                },
+                requiredHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: {
+                        address: mailboxConfig.requiredHook || ZERO_ADDRESS_HEX_32,
+                    },
+                },
+            },
+            deployed: {
+                address: mailboxConfig.address,
+                domainId: mailboxConfig.localDomain,
+            },
+        };
+    }
+}
+export class RadixMailboxWriter extends RadixMailboxReader {
+    signer;
+    base;
+    domainId;
+    constructor(gateway, signer, base, domainId) {
+        super(gateway);
+        this.signer = signer;
+        this.base = base;
+        this.domainId = domainId;
+    }
+    async create(artifact) {
+        const { config } = artifact;
+        const allReceipts = [];
+        // Extract addresses from artifact references
+        const defaultIsmAddress = config.defaultIsm.deployed.address;
+        const defaultHookAddress = config.defaultHook.deployed.address;
+        const requiredHookAddress = config.requiredHook.deployed.address;
+        const createTx = await getCreateMailboxTx(this.base, this.signer.getAddress(), this.domainId);
+        const createReceipt = await this.signer.signAndBroadcast(createTx);
+        const address = await this.base.getNewComponent(createReceipt);
+        allReceipts.push(createReceipt);
+        // Set default ISM (only if address is set)
+        if (!isEmptyAddress(defaultIsmAddress)) {
+            const setIsmTx = await getSetMailboxDefaultIsmTx(this.base, this.signer.getAddress(), {
+                mailboxAddress: address,
+                ismAddress: defaultIsmAddress,
+            });
+            const ismReceipt = await this.signer.signAndBroadcast(setIsmTx);
+            allReceipts.push(ismReceipt);
+        }
+        // Set default hook (only if address is set)
+        if (!isEmptyAddress(defaultHookAddress)) {
+            const setDefaultHookTx = await getSetMailboxDefaultHookTx(this.base, this.signer.getAddress(), {
+                mailboxAddress: address,
+                hookAddress: defaultHookAddress,
+            });
+            const defaultHookReceipt = await this.signer.signAndBroadcast(setDefaultHookTx);
+            allReceipts.push(defaultHookReceipt);
+        }
+        // Set required hook (only if address is set)
+        if (!isEmptyAddress(requiredHookAddress)) {
+            const setRequiredHookTx = await getSetMailboxRequiredHookTx(this.base, this.signer.getAddress(), {
+                mailboxAddress: address,
+                hookAddress: requiredHookAddress,
+            });
+            const requiredHookReceipt = await this.signer.signAndBroadcast(setRequiredHookTx);
+            allReceipts.push(requiredHookReceipt);
+        }
+        // Note: Ownership is NOT transferred during creation. The deployer retains
+        // ownership to allow setting ISM and hooks after initial deployment, which
+        // require owner permissions. Use update() to transfer ownership to the
+        // intended owner once all configuration is complete.
+        const deployedArtifact = {
+            artifactState: ArtifactState.DEPLOYED,
+            config: {
+                ...artifact.config,
+                owner: this.signer.getAddress(),
+            },
+            deployed: {
+                address,
+                domainId: this.domainId,
+            },
+        };
+        return [deployedArtifact, allReceipts];
+    }
+    async update(artifact) {
+        const { config, deployed } = artifact;
+        const updateTxs = [];
+        // Read current state
+        const currentState = await this.read(deployed.address);
+        // Extract addresses from artifact references
+        const expectedDefaultIsmAddress = config.defaultIsm.deployed.address;
+        const expectedDefaultHookAddress = config.defaultHook.deployed.address;
+        const expectedRequiredHookAddress = config.requiredHook.deployed.address;
+        // Extract addresses from current state
+        const currentDefaultIsmAddress = currentState.config.defaultIsm.deployed.address;
+        const currentDefaultHookAddress = currentState.config.defaultHook.deployed.address;
+        const currentRequiredHookAddress = currentState.config.requiredHook.deployed.address;
+        // Update default ISM if changed
+        if (!eqOptionalAddress(currentDefaultIsmAddress, expectedDefaultIsmAddress, eqAddressRadix)) {
+            const setIsmTx = await getSetMailboxDefaultIsmTx(this.base, this.signer.getAddress(), {
+                mailboxAddress: deployed.address,
+                ismAddress: expectedDefaultIsmAddress,
+            });
+            updateTxs.push({
+                annotation: `Update mailbox default ISM to ${expectedDefaultIsmAddress}`,
+                networkId: this.base.getNetworkId(),
+                manifest: setIsmTx,
+            });
+        }
+        // Update default hook if changed
+        if (!eqOptionalAddress(currentDefaultHookAddress, expectedDefaultHookAddress, eqAddressRadix)) {
+            const setDefaultHookTx = await getSetMailboxDefaultHookTx(this.base, this.signer.getAddress(), {
+                mailboxAddress: deployed.address,
+                hookAddress: expectedDefaultHookAddress,
+            });
+            updateTxs.push({
+                annotation: `Update mailbox default hook to ${expectedDefaultHookAddress}`,
+                networkId: this.base.getNetworkId(),
+                manifest: setDefaultHookTx,
+            });
+        }
+        // Update required hook if changed
+        if (!eqOptionalAddress(currentRequiredHookAddress, expectedRequiredHookAddress, eqAddressRadix)) {
+            const setRequiredHookTx = await getSetMailboxRequiredHookTx(this.base, this.signer.getAddress(), {
+                mailboxAddress: deployed.address,
+                hookAddress: expectedRequiredHookAddress,
+            });
+            updateTxs.push({
+                annotation: `Update mailbox required hook to ${expectedRequiredHookAddress}`,
+                networkId: this.base.getNetworkId(),
+                manifest: setRequiredHookTx,
+            });
+        }
+        // Update owner if changed (do this last to avoid permission issues)
+        if (!eqAddressRadix(currentState.config.owner, config.owner)) {
+            const setOwnerTx = await getSetMailboxOwnerTx(this.base, this.gateway, this.signer.getAddress(), {
+                mailboxAddress: deployed.address,
+                newOwner: config.owner,
+            });
+            updateTxs.push({
+                annotation: `Transfer mailbox ownership to ${config.owner}`,
+                networkId: this.base.getNetworkId(),
+                manifest: setOwnerTx,
+            });
+        }
+        return updateTxs;
+    }
+}
+//# sourceMappingURL=mailbox.js.map

package/dist/mailbox/mailbox.js.map

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

package/dist/tests/mailbox.e2e-test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mailbox.e2e-test.d.ts.map

package/dist/tests/mailbox.e2e-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.e2e-test.d.ts","sourceRoot":"","sources":["../../src/tests/mailbox.e2e-test.ts"],"names":[],"mappings":""}

package/dist/tests/mailbox.e2e-test.js

@@ -0,0 +1,254 @@
+import { expect } from 'chai';
+import { ArtifactState } from '@hyperlane-xyz/provider-sdk/artifact';
+import { ZERO_ADDRESS_HEX_32, assert } from '@hyperlane-xyz/utils';
+import { RadixSigner } from '../clients/signer.js';
+import { RadixMailboxArtifactManager } from '../mailbox/mailbox-artifact-manager.js';
+import { DEFAULT_E2E_TEST_TIMEOUT, TEST_RADIX_BURN_ADDRESS, TEST_RADIX_DEPLOYER_ADDRESS, TEST_RADIX_PRIVATE_KEY, } from '../testing/constants.js';
+import { DEPLOYED_TEST_CHAIN_METADATA } from './e2e-test.setup.js';
+describe('Radix Mailbox (e2e)', function () {
+    this.timeout(DEFAULT_E2E_TEST_TIMEOUT);
+    let radixSigner;
+    let artifactManager;
+    // Test domain ID for mailbox
+    const TEST_DOMAIN_ID = 999999;
+    // We'll create test ISM and Hook addresses (can be burn address for testing)
+    const TEST_ISM_ADDRESS = TEST_RADIX_BURN_ADDRESS;
+    const TEST_HOOK_ADDRESS = TEST_RADIX_BURN_ADDRESS;
+    before(async () => {
+        const rpcUrls = DEPLOYED_TEST_CHAIN_METADATA.rpcUrls?.map((url) => url.http) ?? [];
+        assert(rpcUrls.length > 0, 'Expected at least 1 rpc url for the tests');
+        radixSigner = (await RadixSigner.connectWithSigner(rpcUrls, TEST_RADIX_PRIVATE_KEY, {
+            metadata: {
+                chainId: DEPLOYED_TEST_CHAIN_METADATA.chainId,
+                gatewayUrls: DEPLOYED_TEST_CHAIN_METADATA.gatewayUrls,
+                packageAddress: DEPLOYED_TEST_CHAIN_METADATA.packageAddress,
+            },
+        }));
+        const gateway = radixSigner.gateway;
+        const base = radixSigner.base;
+        artifactManager = new RadixMailboxArtifactManager(gateway, base, TEST_DOMAIN_ID);
+    });
+    describe('Mailbox Artifact Operations', () => {
+        it('should create a mailbox with ISM and hooks', async () => {
+            const config = {
+                owner: TEST_RADIX_DEPLOYER_ADDRESS,
+                defaultIsm: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_ISM_ADDRESS },
+                },
+                defaultHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_HOOK_ADDRESS },
+                },
+                requiredHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_HOOK_ADDRESS },
+                },
+            };
+            const writer = artifactManager.createWriter('mailbox', radixSigner);
+            const [result, receipts] = await writer.create({ config });
+            expect(result.artifactState).to.equal(ArtifactState.DEPLOYED);
+            expect(result.config.owner).to.equal(TEST_RADIX_DEPLOYER_ADDRESS);
+            expect(result.deployed.address).to.be.a('string').and.not.be.empty;
+            expect(result.deployed.domainId).to.equal(TEST_DOMAIN_ID);
+            expect(receipts).to.be.an('array').with.length.greaterThan(0);
+            // Verify all setters were called (create + 3 setters + optional owner transfer)
+            // Should be at least 4 receipts (create + setIsm + setDefaultHook + setRequiredHook)
+            expect(receipts.length).to.be.greaterThanOrEqual(4);
+        });
+        it('should skip optional mailbox setters when zero addresses are provided', async () => {
+            const zeroAddressConfig = {
+                owner: TEST_RADIX_DEPLOYER_ADDRESS,
+                defaultIsm: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: ZERO_ADDRESS_HEX_32 },
+                },
+                defaultHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: ZERO_ADDRESS_HEX_32 },
+                },
+                requiredHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: ZERO_ADDRESS_HEX_32 },
+                },
+            };
+            const writer = artifactManager.createWriter('mailbox', radixSigner);
+            const [deployedMailbox, receipts] = await writer.create({
+                config: zeroAddressConfig,
+            });
+            expect(receipts).to.be.an('array').with.length(1);
+            const reader = artifactManager.createReader('mailbox');
+            const readMailbox = await reader.read(deployedMailbox.deployed.address);
+            expect(readMailbox.config.defaultIsm.deployed.address).to.equal(ZERO_ADDRESS_HEX_32);
+            expect(readMailbox.config.defaultHook.deployed.address).to.equal(ZERO_ADDRESS_HEX_32);
+            expect(readMailbox.config.requiredHook.deployed.address).to.equal(ZERO_ADDRESS_HEX_32);
+        });
+        it('should read a mailbox configuration from chain', async () => {
+            const config = {
+                owner: TEST_RADIX_DEPLOYER_ADDRESS,
+                defaultIsm: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_ISM_ADDRESS },
+                },
+                defaultHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_HOOK_ADDRESS },
+                },
+                requiredHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_HOOK_ADDRESS },
+                },
+            };
+            const writer = artifactManager.createWriter('mailbox', radixSigner);
+            const [deployedMailbox] = await writer.create({ config });
+            const reader = artifactManager.createReader('mailbox');
+            const readMailbox = await reader.read(deployedMailbox.deployed.address);
+            expect(readMailbox.artifactState).to.equal(ArtifactState.DEPLOYED);
+            expect(readMailbox.config.owner).to.equal(TEST_RADIX_DEPLOYER_ADDRESS);
+            expect(readMailbox.deployed.address).to.equal(deployedMailbox.deployed.address);
+            expect(readMailbox.deployed.domainId).to.equal(TEST_DOMAIN_ID);
+            // Verify ISM and hooks are set correctly
+            expect(readMailbox.config.defaultIsm.deployed.address).to.equal(TEST_ISM_ADDRESS);
+            expect(readMailbox.config.defaultHook.deployed.address).to.equal(TEST_HOOK_ADDRESS);
+            expect(readMailbox.config.requiredHook.deployed.address).to.equal(TEST_HOOK_ADDRESS);
+        });
+        it('should update mailbox when ISM changes', async () => {
+            // Create initial mailbox
+            const initialConfig = {
+                owner: TEST_RADIX_DEPLOYER_ADDRESS,
+                defaultIsm: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_ISM_ADDRESS },
+                },
+                defaultHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_HOOK_ADDRESS },
+                },
+                requiredHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_HOOK_ADDRESS },
+                },
+            };
+            const writer = artifactManager.createWriter('mailbox', radixSigner);
+            const [deployedMailbox] = await writer.create({ config: initialConfig });
+            // Update with new ISM address (use deployer address as different address)
+            const newIsmAddress = TEST_RADIX_DEPLOYER_ADDRESS;
+            const updatedConfig = {
+                owner: TEST_RADIX_DEPLOYER_ADDRESS,
+                defaultIsm: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: newIsmAddress },
+                },
+                defaultHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_HOOK_ADDRESS },
+                },
+                requiredHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_HOOK_ADDRESS },
+                },
+            };
+            const updateTxs = await writer.update({
+                artifactState: ArtifactState.DEPLOYED,
+                config: updatedConfig,
+                deployed: deployedMailbox.deployed,
+            });
+            // Should have 1 transaction to update the ISM
+            expect(updateTxs).to.be.an('array').with.length(1);
+            expect(updateTxs[0].annotation).to.include('default ISM');
+        });
+        it('should update mailbox when owner changes', async () => {
+            // Create initial mailbox
+            const initialConfig = {
+                owner: TEST_RADIX_DEPLOYER_ADDRESS,
+                defaultIsm: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_ISM_ADDRESS },
+                },
+                defaultHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_HOOK_ADDRESS },
+                },
+                requiredHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_HOOK_ADDRESS },
+                },
+            };
+            const writer = artifactManager.createWriter('mailbox', radixSigner);
+            const [deployedMailbox] = await writer.create({ config: initialConfig });
+            // Update with new owner
+            const newOwner = TEST_RADIX_BURN_ADDRESS;
+            const updatedConfig = {
+                owner: newOwner,
+                defaultIsm: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_ISM_ADDRESS },
+                },
+                defaultHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_HOOK_ADDRESS },
+                },
+                requiredHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_HOOK_ADDRESS },
+                },
+            };
+            const updateTxs = await writer.update({
+                artifactState: ArtifactState.DEPLOYED,
+                config: updatedConfig,
+                deployed: deployedMailbox.deployed,
+            });
+            // Should have 1 transaction to transfer ownership
+            expect(updateTxs).to.be.an('array').with.length(1);
+            expect(updateTxs[0].annotation).to.include('ownership');
+        });
+        it('should return no transactions when mailbox state matches desired state', async () => {
+            // Create mailbox
+            const config = {
+                owner: TEST_RADIX_DEPLOYER_ADDRESS,
+                defaultIsm: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_ISM_ADDRESS },
+                },
+                defaultHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_HOOK_ADDRESS },
+                },
+                requiredHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_HOOK_ADDRESS },
+                },
+            };
+            const writer = artifactManager.createWriter('mailbox', radixSigner);
+            const [deployedMailbox] = await writer.create({ config });
+            // Update with same config
+            const updateTxs = await writer.update(deployedMailbox);
+            // Should have no update transactions since nothing changed
+            expect(updateTxs).to.be.an('array').with.length(0);
+        });
+        it('should use readMailbox convenience method', async () => {
+            const config = {
+                owner: TEST_RADIX_DEPLOYER_ADDRESS,
+                defaultIsm: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_ISM_ADDRESS },
+                },
+                defaultHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_HOOK_ADDRESS },
+                },
+                requiredHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: TEST_HOOK_ADDRESS },
+                },
+            };
+            const writer = artifactManager.createWriter('mailbox', radixSigner);
+            const [deployedMailbox] = await writer.create({ config });
+            // Use the convenience method
+            const readMailbox = await artifactManager.readMailbox(deployedMailbox.deployed.address);
+            expect(readMailbox.artifactState).to.equal(ArtifactState.DEPLOYED);
+            expect(readMailbox.deployed.address).to.equal(deployedMailbox.deployed.address);
+        });
+    });
+});
+//# sourceMappingURL=mailbox.e2e-test.js.map

package/dist/tests/mailbox.e2e-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.e2e-test.js","sourceRoot":"","sources":["../../src/tests/mailbox.e2e-test.ts"],"names":[],"mappings":"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"}

package/dist/tests/validator-announce.e2e-test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validator-announce.e2e-test.d.ts.map

package/dist/tests/validator-announce.e2e-test.d.ts.map

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

package/dist/tests/validator-announce.e2e-test.js

@@ -0,0 +1,116 @@
+import { expect } from 'chai';
+import { ArtifactState } from '@hyperlane-xyz/provider-sdk/artifact';
+import { assert } from '@hyperlane-xyz/utils';
+import { RadixSigner } from '../clients/signer.js';
+import { RadixMailboxArtifactManager } from '../mailbox/mailbox-artifact-manager.js';
+import { DEFAULT_E2E_TEST_TIMEOUT, TEST_RADIX_BURN_ADDRESS, TEST_RADIX_DEPLOYER_ADDRESS, TEST_RADIX_PRIVATE_KEY, } from '../testing/constants.js';
+import { RadixValidatorAnnounceArtifactManager } from '../validator-announce/validator-announce-artifact-manager.js';
+import { DEPLOYED_TEST_CHAIN_METADATA } from './e2e-test.setup.js';
+describe('Radix ValidatorAnnounce (e2e)', function () {
+    this.timeout(DEFAULT_E2E_TEST_TIMEOUT);
+    let radixSigner;
+    let artifactManager;
+    let mailboxArtifactManager;
+    // Will be set after creating a test mailbox
+    let testMailboxAddress;
+    const TEST_DOMAIN_ID = 999998;
+    before(async () => {
+        const rpcUrls = DEPLOYED_TEST_CHAIN_METADATA.rpcUrls?.map((url) => url.http) ?? [];
+        assert(rpcUrls.length > 0, 'Expected at least 1 rpc url for the tests');
+        radixSigner = (await RadixSigner.connectWithSigner(rpcUrls, TEST_RADIX_PRIVATE_KEY, {
+            metadata: {
+                chainId: DEPLOYED_TEST_CHAIN_METADATA.chainId,
+                gatewayUrls: DEPLOYED_TEST_CHAIN_METADATA.gatewayUrls,
+                packageAddress: DEPLOYED_TEST_CHAIN_METADATA.packageAddress,
+            },
+        }));
+        const gateway = radixSigner.gateway;
+        const base = radixSigner.base;
+        artifactManager = new RadixValidatorAnnounceArtifactManager(gateway, base);
+        mailboxArtifactManager = new RadixMailboxArtifactManager(gateway, base, TEST_DOMAIN_ID);
+        // Create a test mailbox for validator announce to reference
+        const mailboxConfig = {
+            owner: TEST_RADIX_DEPLOYER_ADDRESS,
+            defaultIsm: {
+                artifactState: ArtifactState.UNDERIVED,
+                deployed: { address: TEST_RADIX_BURN_ADDRESS },
+            },
+            defaultHook: {
+                artifactState: ArtifactState.UNDERIVED,
+                deployed: { address: TEST_RADIX_BURN_ADDRESS },
+            },
+            requiredHook: {
+                artifactState: ArtifactState.UNDERIVED,
+                deployed: { address: TEST_RADIX_BURN_ADDRESS },
+            },
+        };
+        const mailboxWriter = mailboxArtifactManager.createWriter('mailbox', radixSigner);
+        const [deployedMailbox] = await mailboxWriter.create({
+            config: mailboxConfig,
+        });
+        testMailboxAddress = deployedMailbox.deployed.address;
+    });
+    describe('ValidatorAnnounce Artifact Operations', () => {
+        it('should create a validator announce contract', async () => {
+            const config = {
+                mailboxAddress: testMailboxAddress,
+            };
+            const writer = artifactManager.createWriter('validatorAnnounce', radixSigner);
+            const [result, receipts] = await writer.create({ config });
+            expect(result.artifactState).to.equal(ArtifactState.DEPLOYED);
+            expect(result.config.mailboxAddress).to.equal(testMailboxAddress);
+            expect(result.deployed.address).to.be.a('string').and.not.be.empty;
+            expect(receipts).to.be.an('array').with.length(1);
+        });
+        it('should read a validator announce configuration from chain', async () => {
+            const config = {
+                mailboxAddress: testMailboxAddress,
+            };
+            const writer = artifactManager.createWriter('validatorAnnounce', radixSigner);
+            const [deployedValidatorAnnounce] = await writer.create({ config });
+            const reader = artifactManager.createReader('validatorAnnounce');
+            const readValidatorAnnounce = await reader.read(deployedValidatorAnnounce.deployed.address);
+            expect(readValidatorAnnounce.artifactState).to.equal(ArtifactState.DEPLOYED);
+            expect(readValidatorAnnounce.config.mailboxAddress).to.equal(testMailboxAddress);
+            expect(readValidatorAnnounce.deployed.address).to.equal(deployedValidatorAnnounce.deployed.address);
+        });
+        it('should return no transactions when calling update (immutable)', async () => {
+            const config = {
+                mailboxAddress: testMailboxAddress,
+            };
+            const writer = artifactManager.createWriter('validatorAnnounce', radixSigner);
+            const [deployedValidatorAnnounce] = await writer.create({ config });
+            // ValidatorAnnounce is immutable - update should return empty array
+            const txs = await writer.update(deployedValidatorAnnounce);
+            expect(txs).to.be.an('array').with.length(0);
+        });
+        it('should use readValidatorAnnounce convenience method', async () => {
+            const config = {
+                mailboxAddress: testMailboxAddress,
+            };
+            const writer = artifactManager.createWriter('validatorAnnounce', radixSigner);
+            const [deployedValidatorAnnounce] = await writer.create({ config });
+            // Use the convenience method
+            const readValidatorAnnounce = await artifactManager.readValidatorAnnounce(deployedValidatorAnnounce.deployed.address);
+            expect(readValidatorAnnounce.artifactState).to.equal(ArtifactState.DEPLOYED);
+            expect(readValidatorAnnounce.config.mailboxAddress).to.equal(testMailboxAddress);
+            expect(readValidatorAnnounce.deployed.address).to.equal(deployedValidatorAnnounce.deployed.address);
+        });
+        it('should create validator announce with same mailbox address', async () => {
+            const config1 = {
+                mailboxAddress: testMailboxAddress,
+            };
+            const config2 = {
+                mailboxAddress: testMailboxAddress,
+            };
+            const writer = artifactManager.createWriter('validatorAnnounce', radixSigner);
+            const [result1] = await writer.create({ config: config1 });
+            const [result2] = await writer.create({ config: config2 });
+            // Different validator announce instances should have different addresses
+            expect(result1.deployed.address).to.not.equal(result2.deployed.address);
+            // But both should have the same mailbox address
+            expect(result1.config.mailboxAddress).to.equal(result2.config.mailboxAddress);
+        });
+    });
+});
+//# sourceMappingURL=validator-announce.e2e-test.js.map

package/dist/tests/validator-announce.e2e-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator-announce.e2e-test.js","sourceRoot":"","sources":["../../src/tests/validator-announce.e2e-test.ts"],"names":[],"mappings":"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"}

package/dist/utils/base-query.d.ts

@@ -137,6 +137,18 @@ export declare function tryGetFieldHexValueFromEntityState<T>(fieldName: string,
  */
 export declare function getFieldHexValueFromEntityState(fieldName: string, entityAddress: string, entityState: EntityDetails['state']): string;
 export declare function getFieldHexValueFromEntityState<T>(fieldName: string, entityAddress: string, entityState: EntityDetails['state'], formatter: (value: string) => T): T;
+/**
+ * Extracts an optional field value from a Radix component's entity state.
+ *
+ * Similar to getFieldValueFromEntityState, but returns undefined instead of throwing
+ * if the field is not found or if it's an Option::None variant.
+ *
+ * @param fieldName - The name of the field to extract
+ * @param entityState - The component state containing the fields
+ * @returns The field value as a string, or undefined if not found/None
+ */
+export declare function getOptionalFieldValueFromEntityState(fieldName: string, entityState: EntityDetails['state']): string | undefined;
+export declare function getOptionalFieldValueFromEntityState<T>(fieldName: string, entityState: EntityDetails['state'], formatter: (value: string) => T): T | undefined;
 /**
  * Extracts field elements (array values) from a Radix component's entity state.
  *

package/dist/utils/base-query.d.ts.map

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