@humanode-hyperlane/starknet-sdk 0.0.0-stage → 27.2.3-humanode.1

package/dist/contracts.test.js

@@ -0,0 +1,56 @@
+import { expect } from 'chai';
+import { CallData } from 'starknet';
+import { ContractType, getCompiledContract, } from '@humanode-hyperlane/starknet-core';
+import { ZERO_ADDRESS_HEX_32 } from '@humanode-hyperlane/utils';
+import { StarknetContractName, callContract, extractEnumVariant, getFeeTokenAddress, normalizeStarknetAddressSafe, populateInvokeTx, toNumber, } from './contracts.js';
+describe('starknet-sdk contracts helpers', () => {
+    it('normalizes zeroish addresses to 32-byte zero address', () => {
+        expect(normalizeStarknetAddressSafe('0x0')).to.equal(ZERO_ADDRESS_HEX_32);
+    });
+    it('uses native denom as fee token when provided', () => {
+        const nativeDenom = '0x1234';
+        expect(getFeeTokenAddress({ chainName: 'starknetsepolia', nativeDenom })).to.equal('0x0000000000000000000000000000000000000000000000000000000000001234');
+    });
+    it('falls back to known fee token by chain name', () => {
+        expect(getFeeTokenAddress({ chainName: 'starknetsepolia' })).to.equal('0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d');
+    });
+    it('extracts enum variant key from starknet-like object', () => {
+        expect(extractEnumVariant({ MERKLE_TREE: {} })).to.equal('MERKLE_TREE');
+    });
+    it('preserves single-key enum variants with undefined payloads', () => {
+        expect(extractEnumVariant({ NOOP: undefined })).to.equal('NOOP');
+        expect(extractEnumVariant({ NOOP: null })).to.equal('NOOP');
+    });
+    it('preserves zero-like enum values instead of treating them as empty', () => {
+        expect(extractEnumVariant(0)).to.equal('0');
+        expect(extractEnumVariant(0n)).to.equal('0');
+        expect(extractEnumVariant({ MERKLE_TREE: 0 })).to.equal('MERKLE_TREE');
+    });
+    it('preserves contract context in callContract fallback path', async () => {
+        const contract = {
+            address: '0x1234',
+            abi: [{ type: 'function', name: 'balance_of' }],
+            call(method, args) {
+                return `${this.address}:${method}:${args.length}`;
+            },
+        };
+        const result = await callContract(contract, 'balance_of', ['0x1']);
+        expect(result).to.equal('0x1234:balance_of:1');
+    });
+    it('compiles calldata when populateTransaction helper is unavailable', async () => {
+        const { abi } = getCompiledContract(StarknetContractName.HYP_ERC20, ContractType.TOKEN);
+        const contract = {
+            address: '0x1234',
+            abi,
+        };
+        const tx = await populateInvokeTx(contract, 'owner');
+        expect(tx.kind).to.equal('invoke');
+        expect(tx.contractAddress).to.equal('0x0000000000000000000000000000000000000000000000000000000000001234');
+        expect(tx.entrypoint).to.equal('owner');
+        expect(tx.calldata).to.deep.equal(new CallData(abi).compile('owner', []));
+    });
+    it('throws when coercing bigint values above the safe integer range', () => {
+        expect(() => toNumber(BigInt(Number.MAX_SAFE_INTEGER) + 1n)).to.throw(/safe integer/i);
+    });
+});
+//# sourceMappingURL=contracts.test.js.map

package/dist/contracts.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.test.js","sourceRoot":"","sources":["../src/contracts.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,OAAO,EACL,YAAY,EACZ,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,4BAA4B,EAC5B,gBAAgB,EAChB,QAAQ,GACT,MAAM,gBAAgB,CAAC;AAExB,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,WAAW,GAAG,QAAQ,CAAC;QAC7B,MAAM,CACJ,kBAAkB,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC,CAClE,CAAC,EAAE,CAAC,KAAK,CACR,oEAAoE,CACrE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,kBAAkB,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CACnE,oEAAoE,CACrE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,kBAAkB,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjE,MAAM,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,CAAC,kBAAkB,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,QAAQ,GAAG;YACf,OAAO,EAAE,QAAQ;YACjB,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;YAC/C,IAAI,CAA4B,MAAc,EAAE,IAAe;gBAC7D,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACpD,CAAC;SACF,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,QAAiB,EAAE,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5E,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,EAAE,GAAG,EAAE,GAAG,mBAAmB,CACjC,oBAAoB,CAAC,SAAS,EAC9B,YAAY,CAAC,KAAK,CACnB,CAAC;QACF,MAAM,QAAQ,GAAG;YACf,OAAO,EAAE,QAAQ;YACjB,GAAG;SACJ,CAAC;QAEF,MAAM,EAAE,GAAG,MAAM,gBAAgB,CAAC,QAAiB,EAAE,OAAO,CAAC,CAAC;QAE9D,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,KAAK,CACjC,oEAAoE,CACrE,CAAC;QACF,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CACnE,eAAe,CAChB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/hook/hook-artifact-manager.d.ts

@@ -0,0 +1,18 @@
+import { type ChainMetadataForAltVM } from '@humanode-hyperlane/provider-sdk';
+import { type ISigner } from '@humanode-hyperlane/provider-sdk/altvm';
+import { type ArtifactReader, type ArtifactWriter } from '@humanode-hyperlane/provider-sdk/artifact';
+import { type DeployedHookAddress, type DeployedHookArtifact, type HookType, type IRawHookArtifactManager, type RawHookArtifactConfigs } from '@humanode-hyperlane/provider-sdk/hook';
+import { type AnnotatedTx, type TxReceipt } from '@humanode-hyperlane/provider-sdk/module';
+export declare class StarknetHookArtifactManager implements IRawHookArtifactManager {
+    private readonly chainMetadata;
+    private readonly provider;
+    private readonly mailboxAddress;
+    constructor(chainMetadata: ChainMetadataForAltVM, context?: {
+        mailbox?: string;
+    });
+    private requireStarknetSigner;
+    readHook(address: string): Promise<DeployedHookArtifact>;
+    createReader<T extends HookType>(type: T): ArtifactReader<RawHookArtifactConfigs[T], DeployedHookAddress>;
+    createWriter<T extends HookType>(type: T, signer: ISigner<AnnotatedTx, TxReceipt>): ArtifactWriter<RawHookArtifactConfigs[T], DeployedHookAddress>;
+}
+//# sourceMappingURL=hook-artifact-manager.d.ts.map

package/dist/hook/hook-artifact-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-artifact-manager.d.ts","sourceRoot":"","sources":["../../src/hook/hook-artifact-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,wCAAwC,CAAC;AACtE,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,QAAQ,EACb,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAE5B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,yCAAyC,CAAC;AAuBjD,qBAAa,2BAA4B,YAAW,uBAAuB;IAKvE,OAAO,CAAC,QAAQ,CAAC,aAAa;IAJhC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAGrB,aAAa,EAAE,qBAAqB,EACrD,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAYhC,OAAO,CAAC,qBAAqB;IAOvB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAiB9D,YAAY,CAAC,CAAC,SAAS,QAAQ,EAC7B,IAAI,EAAE,CAAC,GACN,cAAc,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC;IAqBjE,YAAY,CAAC,CAAC,SAAS,QAAQ,EAC7B,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,GACtC,cAAc,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC;CA+BlE"}

package/dist/hook/hook-artifact-manager.js

@@ -0,0 +1,70 @@
+import { AltVM, } from '@humanode-hyperlane/provider-sdk';
+import { throwUnsupportedHookType, } from '@humanode-hyperlane/provider-sdk/hook';
+import { assert } from '@humanode-hyperlane/utils';
+import { StarknetProvider } from '../clients/provider.js';
+import { StarknetSigner } from '../clients/signer.js';
+import { normalizeStarknetAddressSafe } from '../contracts.js';
+import { createStarknetInterchainGasPaymasterHookReader, createStarknetInterchainGasPaymasterHookWriter, } from './interchain-gas-paymaster-hook-artifact-manager.js';
+import { StarknetMerkleTreeHookReader, StarknetMerkleTreeHookWriter, } from './merkle-tree-hook-artifact-manager.js';
+import { StarknetProtocolFeeHookReader, StarknetProtocolFeeHookWriter, } from './protocol-fee-hook-artifact-manager.js';
+import { StarknetUnknownHookReader, StarknetUnknownHookWriter, } from './unknown-hook-artifact-manager.js';
+export class StarknetHookArtifactManager {
+    chainMetadata;
+    provider;
+    mailboxAddress;
+    constructor(chainMetadata, context) {
+        this.chainMetadata = chainMetadata;
+        this.provider = StarknetProvider.connect((chainMetadata.rpcUrls ?? []).map(({ http }) => http), chainMetadata.chainId, { metadata: chainMetadata });
+        this.mailboxAddress = context?.mailbox
+            ? normalizeStarknetAddressSafe(context.mailbox)
+            : '';
+    }
+    requireStarknetSigner(signer) {
+        assert(signer instanceof StarknetSigner, 'Expected StarknetSigner');
+        return signer;
+    }
+    async readHook(address) {
+        const hookType = await this.provider.getHookType({
+            hookAddress: address,
+        });
+        switch (hookType) {
+            case AltVM.HookType.CUSTOM:
+                return this.createReader('unknownHook').read(address);
+            case AltVM.HookType.MERKLE_TREE:
+                return this.createReader(AltVM.HookType.MERKLE_TREE).read(address);
+            case AltVM.HookType.PROTOCOL_FEE:
+                return this.createReader(AltVM.HookType.PROTOCOL_FEE).read(address);
+            default:
+                return throwUnsupportedHookType(hookType, 'Starknet');
+        }
+    }
+    createReader(type) {
+        const readers = {
+            merkleTreeHook: () => new StarknetMerkleTreeHookReader(),
+            interchainGasPaymaster: () => createStarknetInterchainGasPaymasterHookReader(),
+            protocolFee: () => new StarknetProtocolFeeHookReader(this.chainMetadata, this.provider),
+            unknownHook: () => new StarknetUnknownHookReader(),
+        };
+        const readerFactory = readers[type];
+        if (!readerFactory) {
+            return throwUnsupportedHookType(type, 'Starknet');
+        }
+        return readerFactory();
+    }
+    createWriter(type, signer) {
+        const starknetSigner = this.requireStarknetSigner(signer);
+        assert(this.mailboxAddress || type !== AltVM.HookType.MERKLE_TREE, 'mailbox address required for Starknet merkle tree hook deployment');
+        const writers = {
+            merkleTreeHook: () => new StarknetMerkleTreeHookWriter(starknetSigner, this.mailboxAddress),
+            interchainGasPaymaster: () => createStarknetInterchainGasPaymasterHookWriter(),
+            protocolFee: () => new StarknetProtocolFeeHookWriter(this.chainMetadata, this.provider, starknetSigner),
+            unknownHook: () => new StarknetUnknownHookWriter(),
+        };
+        const writerFactory = writers[type];
+        if (!writerFactory) {
+            return throwUnsupportedHookType(type, 'Starknet');
+        }
+        return writerFactory();
+    }
+}
+//# sourceMappingURL=hook-artifact-manager.js.map

package/dist/hook/hook-artifact-manager.js.map

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

package/dist/hook/hook-artifact-manager.test.d.ts

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

package/dist/hook/hook-artifact-manager.test.d.ts.map

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

package/dist/hook/hook-artifact-manager.test.js

@@ -0,0 +1,166 @@
+import { expect } from 'chai';
+import { RpcProvider } from 'starknet';
+import { AltVM, ProtocolType } from '@humanode-hyperlane/provider-sdk';
+import { ArtifactState } from '@humanode-hyperlane/provider-sdk/artifact';
+import { StarknetSigner } from '../clients/signer.js';
+import { normalizeStarknetAddressSafe } from '../contracts.js';
+import { StarknetHookArtifactManager } from './hook-artifact-manager.js';
+describe('StarknetHookArtifactManager', () => {
+    const chainMetadata = {
+        name: 'starknetsepolia',
+        protocol: ProtocolType.Starknet,
+        chainId: 'SN_SEPOLIA',
+        domainId: 421614,
+        rpcUrls: [{ http: 'http://localhost:9545' }],
+        nativeToken: {
+            name: 'Ether',
+            symbol: 'ETH',
+            decimals: 18,
+            denom: '0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d',
+        },
+    };
+    class MockStarknetSigner extends StarknetSigner {
+        capturedTx;
+        capturedTxs = [];
+        constructor() {
+            super(new RpcProvider({ nodeUrl: 'http://localhost:9545' }), chainMetadata, ['http://localhost:9545'], '0x1', '0x1111111111111111111111111111111111111111111111111111111111111111');
+        }
+        async sendAndConfirmTransaction(tx) {
+            this.capturedTx = tx;
+            this.capturedTxs.push(tx);
+            return {
+                transactionHash: '0x123',
+                contractAddress: '0xabc',
+            };
+        }
+    }
+    it('rejects interchainGasPaymaster hook operations on Starknet', async () => {
+        const manager = new StarknetHookArtifactManager(chainMetadata);
+        const signer = new MockStarknetSigner();
+        const reader = manager.createReader('interchainGasPaymaster');
+        const writer = manager.createWriter('interchainGasPaymaster', signer);
+        let readerError;
+        try {
+            await reader.read('0x1');
+        }
+        catch (error) {
+            readerError = error;
+        }
+        expect(String(readerError)).to.match(/Unsupported hook artifact type .* for protocol Starknet/i);
+        let writerError;
+        try {
+            await writer.create({
+                artifactState: ArtifactState.NEW,
+                // @ts-expect-error runtime unsupported path; config shape is irrelevant
+                config: {},
+            });
+        }
+        catch (error) {
+            writerError = error;
+        }
+        expect(String(writerError)).to.match(/Unsupported hook artifact type .* for protocol Starknet/i);
+    });
+    it('deploys protocolFee hook with maxProtocolFee and protocolFee args', async () => {
+        const manager = new StarknetHookArtifactManager(chainMetadata);
+        const signer = new MockStarknetSigner();
+        const writer = manager.createWriter('protocolFee', signer);
+        const [artifact] = await writer.create({
+            artifactState: ArtifactState.NEW,
+            config: {
+                type: 'protocolFee',
+                owner: '0x1',
+                beneficiary: '0x2',
+                maxProtocolFee: '20',
+                protocolFee: '10',
+            },
+        });
+        expect(signer.capturedTx).to.not.equal(undefined);
+        expect(signer.capturedTx?.kind).to.equal('deploy');
+        if (signer.capturedTx?.kind !== 'deploy') {
+            throw new Error('Expected deploy transaction');
+        }
+        expect(Array.isArray(signer.capturedTx.constructorArgs)).to.equal(true);
+        if (!Array.isArray(signer.capturedTx.constructorArgs)) {
+            throw new Error('Expected constructorArgs to be an array');
+        }
+        expect(signer.capturedTx.constructorArgs[0]).to.equal('20');
+        expect(signer.capturedTx.constructorArgs[1]).to.equal('10');
+        expect(artifact.config.maxProtocolFee).to.equal('20');
+        expect(artifact.config.protocolFee).to.equal('10');
+    });
+    it('returns merkleTree hook deployment receipts', async () => {
+        const manager = new StarknetHookArtifactManager(chainMetadata, {
+            mailbox: '0x111',
+        });
+        const signer = new MockStarknetSigner();
+        const writer = manager.createWriter('merkleTreeHook', signer);
+        const [, receipts] = await writer.create({
+            artifactState: ArtifactState.NEW,
+            config: { type: 'merkleTreeHook' },
+        });
+        expect(receipts).to.have.length(1);
+        expect(signer.capturedTxs).to.have.length(1);
+        expect(signer.capturedTxs[0]?.kind).to.equal('deploy');
+    });
+    it('reads custom Starknet hooks as unknownHook artifacts', async () => {
+        const manager = new StarknetHookArtifactManager(chainMetadata);
+        const provider = Reflect.get(manager, 'provider');
+        provider.getHookType = async () => AltVM.HookType.CUSTOM;
+        const artifact = await manager.readHook('0xabc');
+        expect(artifact.config).to.deep.equal({ type: 'unknownHook' });
+        expect(artifact.deployed.address).to.equal(normalizeStarknetAddressSafe('0xabc'));
+    });
+    it('rejects creating unknownHook artifacts on Starknet', async () => {
+        const manager = new StarknetHookArtifactManager(chainMetadata);
+        const signer = new MockStarknetSigner();
+        const writer = manager.createWriter('unknownHook', signer);
+        let error;
+        try {
+            await writer.create({
+                artifactState: ArtifactState.NEW,
+                config: { type: 'unknownHook' },
+            });
+        }
+        catch (caughtError) {
+            error = caughtError;
+        }
+        expect(String(error)).to.match(/unknownHook artifacts are read-only on Starknet/i);
+    });
+    it('rejects protocolFee in-place updates when maxProtocolFee changes', async () => {
+        const manager = new StarknetHookArtifactManager(chainMetadata);
+        const signer = new MockStarknetSigner();
+        const writer = manager.createWriter('protocolFee', signer);
+        Object.assign(writer, {
+            read: async () => ({
+                artifactState: ArtifactState.DEPLOYED,
+                config: {
+                    type: 'protocolFee',
+                    owner: '0x1',
+                    beneficiary: '0x2',
+                    maxProtocolFee: '20',
+                    protocolFee: '10',
+                },
+                deployed: { address: '0xabc' },
+            }),
+        });
+        let error;
+        try {
+            await writer.update({
+                artifactState: ArtifactState.DEPLOYED,
+                config: {
+                    type: 'protocolFee',
+                    owner: '0x1',
+                    beneficiary: '0x2',
+                    maxProtocolFee: '30',
+                    protocolFee: '10',
+                },
+                deployed: { address: '0xabc' },
+            });
+        }
+        catch (caughtError) {
+            error = caughtError;
+        }
+        expect(String(error)).to.match(/Changing maxProtocolFee requires redeploying/i);
+    });
+});
+//# sourceMappingURL=hook-artifact-manager.test.js.map

package/dist/hook/hook-artifact-manager.test.js.map

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

package/dist/hook/interchain-gas-paymaster-hook-artifact-manager.d.ts

@@ -0,0 +1,5 @@
+import { type ArtifactReader, type ArtifactWriter } from '@humanode-hyperlane/provider-sdk/artifact';
+import { type DeployedHookAddress, type RawHookArtifactConfigs } from '@humanode-hyperlane/provider-sdk/hook';
+export declare function createStarknetInterchainGasPaymasterHookReader(): ArtifactReader<RawHookArtifactConfigs['interchainGasPaymaster'], DeployedHookAddress>;
+export declare function createStarknetInterchainGasPaymasterHookWriter(): ArtifactWriter<RawHookArtifactConfigs['interchainGasPaymaster'], DeployedHookAddress>;
+//# sourceMappingURL=interchain-gas-paymaster-hook-artifact-manager.d.ts.map

package/dist/hook/interchain-gas-paymaster-hook-artifact-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interchain-gas-paymaster-hook-artifact-manager.d.ts","sourceRoot":"","sources":["../../src/hook/interchain-gas-paymaster-hook-artifact-manager.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAE5B,MAAM,uCAAuC,CAAC;AAE/C,wBAAgB,8CAA8C,IAAI,cAAc,CAC9E,sBAAsB,CAAC,wBAAwB,CAAC,EAChD,mBAAmB,CACpB,CASA;AAED,wBAAgB,8CAA8C,IAAI,cAAc,CAC9E,sBAAsB,CAAC,wBAAwB,CAAC,EAChD,mBAAmB,CACpB,CAqBA"}

package/dist/hook/interchain-gas-paymaster-hook-artifact-manager.js

@@ -0,0 +1,23 @@
+import { AltVM } from '@humanode-hyperlane/provider-sdk';
+import { throwUnsupportedHookType, } from '@humanode-hyperlane/provider-sdk/hook';
+export function createStarknetInterchainGasPaymasterHookReader() {
+    return {
+        read: async () => {
+            return throwUnsupportedHookType(AltVM.HookType.INTERCHAIN_GAS_PAYMASTER, 'Starknet');
+        },
+    };
+}
+export function createStarknetInterchainGasPaymasterHookWriter() {
+    return {
+        read: async () => {
+            return throwUnsupportedHookType(AltVM.HookType.INTERCHAIN_GAS_PAYMASTER, 'Starknet');
+        },
+        create: async () => {
+            return throwUnsupportedHookType(AltVM.HookType.INTERCHAIN_GAS_PAYMASTER, 'Starknet');
+        },
+        update: async () => {
+            return throwUnsupportedHookType(AltVM.HookType.INTERCHAIN_GAS_PAYMASTER, 'Starknet');
+        },
+    };
+}
+//# sourceMappingURL=interchain-gas-paymaster-hook-artifact-manager.js.map

package/dist/hook/interchain-gas-paymaster-hook-artifact-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interchain-gas-paymaster-hook-artifact-manager.js","sourceRoot":"","sources":["../../src/hook/interchain-gas-paymaster-hook-artifact-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAKzD,OAAO,EAGL,wBAAwB,GACzB,MAAM,uCAAuC,CAAC;AAE/C,MAAM,UAAU,8CAA8C;IAI5D,OAAO;QACL,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,OAAO,wBAAwB,CAC7B,KAAK,CAAC,QAAQ,CAAC,wBAAwB,EACvC,UAAU,CACX,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8CAA8C;IAI5D,OAAO;QACL,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,OAAO,wBAAwB,CAC7B,KAAK,CAAC,QAAQ,CAAC,wBAAwB,EACvC,UAAU,CACX,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,KAAK,IAAI,EAAE;YACjB,OAAO,wBAAwB,CAC7B,KAAK,CAAC,QAAQ,CAAC,wBAAwB,EACvC,UAAU,CACX,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,KAAK,IAAI,EAAE;YACjB,OAAO,wBAAwB,CAC7B,KAAK,CAAC,QAAQ,CAAC,wBAAwB,EACvC,UAAU,CACX,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/hook/merkle-tree-hook-artifact-manager.d.ts

@@ -0,0 +1,18 @@
+import { type ArtifactDeployed, type ArtifactNew, type ArtifactReader, type ArtifactWriter } from '@humanode-hyperlane/provider-sdk/artifact';
+import { type DeployedHookAddress, type RawHookArtifactConfigs } from '@humanode-hyperlane/provider-sdk/hook';
+import { type AnnotatedTx, type TxReceipt } from '@humanode-hyperlane/provider-sdk/module';
+import { StarknetSigner } from '../clients/signer.js';
+export declare class StarknetMerkleTreeHookReader implements ArtifactReader<RawHookArtifactConfigs['merkleTreeHook'], DeployedHookAddress> {
+    read(address: string): Promise<ArtifactDeployed<RawHookArtifactConfigs['merkleTreeHook'], DeployedHookAddress>>;
+}
+export declare class StarknetMerkleTreeHookWriter extends StarknetMerkleTreeHookReader implements ArtifactWriter<RawHookArtifactConfigs['merkleTreeHook'], DeployedHookAddress> {
+    private readonly signer;
+    private readonly mailboxAddress;
+    constructor(signer: StarknetSigner, mailboxAddress: string);
+    create(artifact: ArtifactNew<RawHookArtifactConfigs['merkleTreeHook']>): Promise<[
+        ArtifactDeployed<RawHookArtifactConfigs['merkleTreeHook'], DeployedHookAddress>,
+        TxReceipt[]
+    ]>;
+    update(_artifact: ArtifactDeployed<RawHookArtifactConfigs['merkleTreeHook'], DeployedHookAddress>): Promise<AnnotatedTx[]>;
+}
+//# sourceMappingURL=merkle-tree-hook-artifact-manager.d.ts.map

package/dist/hook/merkle-tree-hook-artifact-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merkle-tree-hook-artifact-manager.d.ts","sourceRoot":"","sources":["../../src/hook/merkle-tree-hook-artifact-manager.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,cAAc,EAEnB,KAAK,cAAc,EACpB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC5B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,yCAAyC,CAAC;AAGjD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,qBAAa,4BAA6B,YAAW,cAAc,CACjE,sBAAsB,CAAC,gBAAgB,CAAC,EACxC,mBAAmB,CACpB;IACO,IAAI,CACR,OAAO,EAAE,MAAM,GACd,OAAO,CACR,gBAAgB,CACd,sBAAsB,CAAC,gBAAgB,CAAC,EACxC,mBAAmB,CACpB,CACF;CAOF;AAED,qBAAa,4BACX,SAAQ,4BACR,YACE,cAAc,CACZ,sBAAsB,CAAC,gBAAgB,CAAC,EACxC,mBAAmB,CACpB;IAGD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc;gBADd,MAAM,EAAE,cAAc,EACtB,cAAc,EAAE,MAAM;IAKnC,MAAM,CACV,QAAQ,EAAE,WAAW,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC,GAC9D,OAAO,CACR;QACE,gBAAgB,CACd,sBAAsB,CAAC,gBAAgB,CAAC,EACxC,mBAAmB,CACpB;QACD,SAAS,EAAE;KACZ,CACF;IAmBK,MAAM,CACV,SAAS,EAAE,gBAAgB,CACzB,sBAAsB,CAAC,gBAAgB,CAAC,EACxC,mBAAmB,CACpB,GACA,OAAO,CAAC,WAAW,EAAE,CAAC;CAG1B"}

package/dist/hook/merkle-tree-hook-artifact-manager.js

@@ -0,0 +1,43 @@
+import { AltVM } from '@humanode-hyperlane/provider-sdk';
+import { ArtifactState, } from '@humanode-hyperlane/provider-sdk/artifact';
+import { assert } from '@humanode-hyperlane/utils';
+import { normalizeStarknetAddressSafe } from '../contracts.js';
+export class StarknetMerkleTreeHookReader {
+    async read(address) {
+        return {
+            artifactState: ArtifactState.DEPLOYED,
+            config: { type: AltVM.HookType.MERKLE_TREE },
+            deployed: { address: normalizeStarknetAddressSafe(address) },
+        };
+    }
+}
+export class StarknetMerkleTreeHookWriter extends StarknetMerkleTreeHookReader {
+    signer;
+    mailboxAddress;
+    constructor(signer, mailboxAddress) {
+        super();
+        this.signer = signer;
+        this.mailboxAddress = mailboxAddress;
+    }
+    async create(artifact) {
+        const tx = await this.signer.getCreateMerkleTreeHookTransaction({
+            signer: this.signer.getSignerAddress(),
+            mailboxAddress: this.mailboxAddress,
+        });
+        const receipt = await this.signer.sendAndConfirmTransaction(tx);
+        const hookAddress = receipt.contractAddress;
+        assert(hookAddress, 'failed to deploy Starknet merkle tree hook');
+        return [
+            {
+                artifactState: ArtifactState.DEPLOYED,
+                config: artifact.config,
+                deployed: { address: hookAddress },
+            },
+            [receipt],
+        ];
+    }
+    async update(_artifact) {
+        return [];
+    }
+}
+//# sourceMappingURL=merkle-tree-hook-artifact-manager.js.map

package/dist/hook/merkle-tree-hook-artifact-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merkle-tree-hook-artifact-manager.js","sourceRoot":"","sources":["../../src/hook/merkle-tree-hook-artifact-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AACzD,OAAO,EAIL,aAAa,GAEd,MAAM,2CAA2C,CAAC;AASnD,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAGnD,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAE/D,MAAM,OAAO,4BAA4B;IAIvC,KAAK,CAAC,IAAI,CACR,OAAe;QAOf,OAAO;YACL,aAAa,EAAE,aAAa,CAAC,QAAQ;YACrC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE;YAC5C,QAAQ,EAAE,EAAE,OAAO,EAAE,4BAA4B,CAAC,OAAO,CAAC,EAAE;SAC7D,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,4BACX,SAAQ,4BAA4B;IAQjB;IACA;IAFnB,YACmB,MAAsB,EACtB,cAAsB;QAEvC,KAAK,EAAE,CAAC;QAHS,WAAM,GAAN,MAAM,CAAgB;QACtB,mBAAc,GAAd,cAAc,CAAQ;IAGzC,CAAC;IAED,KAAK,CAAC,MAAM,CACV,QAA+D;QAU/D,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,kCAAkC,CAAC;YAC9D,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE;YACtC,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC;QAChE,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;QAC5C,MAAM,CAAC,WAAW,EAAE,4CAA4C,CAAC,CAAC;QAElE,OAAO;YACL;gBACE,aAAa,EAAE,aAAa,CAAC,QAAQ;gBACrC,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,QAAQ,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE;aACnC;YACD,CAAC,OAAO,CAAC;SACV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CACV,SAGC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/hook/protocol-fee-hook-artifact-manager.d.ts

@@ -0,0 +1,22 @@
+import { type ChainMetadataForAltVM } from '@humanode-hyperlane/provider-sdk';
+import { type ArtifactDeployed, type ArtifactNew, type ArtifactReader, type ArtifactWriter } from '@humanode-hyperlane/provider-sdk/artifact';
+import { type DeployedHookAddress, type RawHookArtifactConfigs } from '@humanode-hyperlane/provider-sdk/hook';
+import { type AnnotatedTx, type TxReceipt } from '@humanode-hyperlane/provider-sdk/module';
+import { StarknetProvider } from '../clients/provider.js';
+import { StarknetSigner } from '../clients/signer.js';
+export declare class StarknetProtocolFeeHookReader implements ArtifactReader<RawHookArtifactConfigs['protocolFee'], DeployedHookAddress> {
+    protected readonly chainMetadata: ChainMetadataForAltVM;
+    protected readonly provider: StarknetProvider;
+    constructor(chainMetadata: ChainMetadataForAltVM, provider: StarknetProvider);
+    read(address: string): Promise<ArtifactDeployed<RawHookArtifactConfigs['protocolFee'], DeployedHookAddress>>;
+}
+export declare class StarknetProtocolFeeHookWriter extends StarknetProtocolFeeHookReader implements ArtifactWriter<RawHookArtifactConfigs['protocolFee'], DeployedHookAddress> {
+    private readonly signer;
+    constructor(chainMetadata: ChainMetadataForAltVM, provider: StarknetProvider, signer: StarknetSigner);
+    create(artifact: ArtifactNew<RawHookArtifactConfigs['protocolFee']>): Promise<[
+        ArtifactDeployed<RawHookArtifactConfigs['protocolFee'], DeployedHookAddress>,
+        TxReceipt[]
+    ]>;
+    update(artifact: ArtifactDeployed<RawHookArtifactConfigs['protocolFee'], DeployedHookAddress>): Promise<AnnotatedTx[]>;
+}
+//# sourceMappingURL=protocol-fee-hook-artifact-manager.d.ts.map

package/dist/hook/protocol-fee-hook-artifact-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-fee-hook-artifact-manager.d.ts","sourceRoot":"","sources":["../../src/hook/protocol-fee-hook-artifact-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,cAAc,EAEnB,KAAK,cAAc,EACpB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC5B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,yCAAyC,CAAC;AASjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AA2FtD,qBAAa,6BAA8B,YAAW,cAAc,CAClE,sBAAsB,CAAC,aAAa,CAAC,EACrC,mBAAmB,CACpB;IAEG,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,qBAAqB;IACvD,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB;gBAD1B,aAAa,EAAE,qBAAqB,EACpC,QAAQ,EAAE,gBAAgB;IAGzC,IAAI,CACR,OAAO,EAAE,MAAM,GACd,OAAO,CACR,gBAAgB,CAAC,sBAAsB,CAAC,aAAa,CAAC,EAAE,mBAAmB,CAAC,CAC7E;CA8CF;AAED,qBAAa,6BACX,SAAQ,6BACR,YACE,cAAc,CAAC,sBAAsB,CAAC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAK1E,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFvB,aAAa,EAAE,qBAAqB,EACpC,QAAQ,EAAE,gBAAgB,EACT,MAAM,EAAE,cAAc;IAKnC,MAAM,CACV,QAAQ,EAAE,WAAW,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC,GAC3D,OAAO,CACR;QACE,gBAAgB,CACd,sBAAsB,CAAC,aAAa,CAAC,EACrC,mBAAmB,CACpB;QACD,SAAS,EAAE;KACZ,CACF;IAoCK,MAAM,CACV,QAAQ,EAAE,gBAAgB,CACxB,sBAAsB,CAAC,aAAa,CAAC,EACrC,mBAAmB,CACpB,GACA,OAAO,CAAC,WAAW,EAAE,CAAC;CAuD1B"}