@recoillink/sdk 0.0.0-stage → 45.0.1

package/dist/ism/blacklist.js

@@ -0,0 +1,98 @@
+import { getAbiItem, parseEventLogs, toEventSelector } from 'viem';
+import { BlacklistIsm__factory } from '@recoillink/core';
+import { rootLogger } from '@recoillink/utils';
+import { EvmEventLogsReader } from '../rpc/evm/EvmEventLogsReader.js';
+import { viemLogFromGetEventLogsResponse } from '../rpc/evm/utils.js';
+import { throwIfNotMissingSelector } from '../utils/contract.js';
+const logger = rootLogger.child({ module: 'BlacklistIsmUtils' });
+/**
+ * Puts a set of blacklisted IDs in the shape `readBlacklistedIds` returns:
+ * lowercased, de-duplicated and sorted. Both of its sources go through this, so
+ * a caller cannot tell which one served a set, and a config compared against one
+ * has to be put in the same shape first. The log replay also relies on the
+ * de-duplication, since deployments that predate on-chain enumeration emit on
+ * re-adds.
+ */
+export function normalizeBlacklistedIds(ids) {
+    return [...new Set(ids.map((id) => id.toLowerCase()))].sort();
+}
+const MESSAGE_BLACKLISTED_EVENT_SELECTOR = toEventSelector(getAbiItem({
+    abi: BlacklistIsm__factory.abi,
+    name: 'MessageBlacklisted',
+}));
+/**
+ * Reads the blacklisted message IDs of a Blacklist ISM.
+ *
+ * Deployments that predate on-chain enumeration expose no `values()`; for those
+ * the set is replayed from `MessageBlacklisted` logs. Entries are append-only,
+ * so a complete log sequence defines the current set. Those deployments also
+ * emit on re-adds, hence the de-duplication.
+ *
+ * Throws rather than returning a set it can tell is incomplete. A truncated set
+ * would be diffed as "these IDs are missing on-chain" and could be written back
+ * as the complete set, and a Blacklist ISM config without its entries does not
+ * describe the deployment it claims to. Errors that are not a missing `values()`
+ * selector propagate, so a transient RPC failure is never read as a legacy
+ * deployment.
+ *
+ * What it cannot tell is covered by the caveat at the end of this comment:
+ * a source that answers successfully but incompletely is taken at its word,
+ * because nothing in such a response distinguishes it from a complete one.
+ *
+ * An empty set is a result, not a failure: a Blacklist ISM that has never
+ * blacklisted anything returns [].
+ *
+ * Result size does not constrain the replay. `EvmEventLogsReader` reads a block
+ * explorer first, and that path pages until a page comes back short; a range
+ * holding more logs than the explorer will page through, or a page it fails to
+ * serve, raises an unrecoverable error rather than a prefix of the range, which
+ * moves the read to the RPC fallback. That fallback pages by block range and so
+ * has no equivalent ceiling.
+ *
+ * Indexer lag is not covered, and this is where the replay can be wrong. The
+ * explorer path trusts the explorer's index: a set read while the explorer is
+ * behind the chain omits entries that are already on-chain and is reported as
+ * complete, since nothing in the response distinguishes the two. Append-only
+ * entries do not make that harmless. An in-place update computed from a stale
+ * set only re-adds an entry that is already set, but a redeploy — the path this
+ * design takes for deployments that predate on-chain enumeration — seeds the
+ * replacement from the target config, so an entry missing from a stale set that
+ * was persisted into a registry is dropped permanently. This is shared
+ * `EvmEventLogsReader` behaviour rather than anything specific to blacklists;
+ * every consumer reading logs through an explorer has the same exposure.
+ *
+ * The replay requires an explorer-derived deployment block. The explorer either
+ * reports the block directly or supplies the deployment transaction whose
+ * receipt establishes it. That bound is passed explicitly to the log reader, so
+ * an explorer log failure can still fall back to RPC without replacing the
+ * bound with one derived by bisecting historical `eth_getCode` responses.
+ */
+export async function readBlacklistedIds(chain, address, multiProvider, eventLogsReader) {
+    const blacklistIsm = BlacklistIsm__factory.connect(address, multiProvider.getProvider(chain));
+    try {
+        return normalizeBlacklistedIds(await blacklistIsm.values());
+    }
+    catch (error) {
+        throwIfNotMissingSelector(error);
+        logger.debug({ chain, address }, 'Error accessing "values" property, implying this is a Blacklist ISM that predates on-chain enumeration.');
+    }
+    const logsReader = eventLogsReader ?? EvmEventLogsReader.fromConfig({ chain }, multiProvider);
+    try {
+        const fromBlock = await logsReader.getContractDeploymentBlockFromExplorer(address);
+        const logs = await logsReader.getLogsByTopic({
+            contractAddress: address,
+            eventTopic: MESSAGE_BLACKLISTED_EVENT_SELECTOR,
+            fromBlock,
+        });
+        const events = parseEventLogs({
+            abi: BlacklistIsm__factory.abi,
+            eventName: 'MessageBlacklisted',
+            logs: logs.map(viemLogFromGetEventLogsResponse),
+        });
+        return normalizeBlacklistedIds(events.map((event) => event.args.messageId));
+    }
+    catch (error) {
+        throw new Error(`Unable to read the blacklisted IDs of the Blacklist ISM at "${address}" on chain "${chain}": rebuilding the set from MessageBlacklisted logs failed`, { cause: error });
+    }
+}
+//# sourceMappingURL=blacklist.js.map

package/dist/ism/blacklist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blacklist.js","sourceRoot":"","sources":["../../src/ism/blacklist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAEnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAEtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAsB;IAC5D,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,kCAAkC,GAAG,eAAe,CACxD,UAAU,CAAC;IACT,GAAG,EAAE,qBAAqB,CAAC,GAAG;IAC9B,IAAI,EAAE,oBAAoB;CAC3B,CAAC,CACH,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAoB,EACpB,OAAgB,EAChB,aAA4B,EAC5B,eAAoC;IAEpC,MAAM,YAAY,GAAG,qBAAqB,CAAC,OAAO,CAChD,OAAO,EACP,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CACjC,CAAC;IAEF,IAAI,CAAC;QACH,OAAO,uBAAuB,CAAC,MAAM,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yBAAyB,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CACV,EAAE,KAAK,EAAE,OAAO,EAAE,EAClB,yGAAyG,CAC1G,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GACd,eAAe,IAAI,kBAAkB,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,EAAE,aAAa,CAAC,CAAC;IAE7E,IAAI,CAAC;QACH,MAAM,SAAS,GACb,MAAM,UAAU,CAAC,sCAAsC,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,cAAc,CAAC;YAC3C,eAAe,EAAE,OAAO;YACxB,UAAU,EAAE,kCAAkC;YAC9C,SAAS;SACV,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,cAAc,CAAC;YAC5B,GAAG,EAAE,qBAAqB,CAAC,GAAG;YAC9B,SAAS,EAAE,oBAAoB;YAC/B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,+BAA+B,CAAC;SAChD,CAAC,CAAC;QAEH,OAAO,uBAAuB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,+DAA+D,OAAO,eAAe,KAAK,2DAA2D,EACrJ,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/ism/delayedFlow.d.ts

@@ -0,0 +1,31 @@
+import type { Logger } from 'pino';
+import { DelayedFlowRouterHookIsm } from '@recoillink/core';
+import { MultiProvider } from '../providers/MultiProvider.js';
+import { ChainName } from '../types.js';
+import { DelayedFlowRouterHookIsmConfig } from './types.js';
+export interface DelayedFlowEnrollment {
+    chainName: ChainName;
+    /** bytes32 counterpart address as stored on-chain, lowercased. */
+    router: string;
+}
+export interface DelayedFlowEnrollments {
+    /** Enrollments whose domain the MultiProvider can name. */
+    named: DelayedFlowEnrollment[];
+    /**
+     * Enrolled domains the MultiProvider cannot name. A config can neither
+     * express nor drop them, so callers comparing against a config must surface
+     * them rather than ignore them.
+     */
+    unnamedDomains: number[];
+}
+/**
+ * Reads a DelayedFlowRouterHookIsm's enrollment and resolves each enrolled
+ * domain to a chain name.
+ */
+export declare function readDelayedFlowEnrollments(ism: DelayedFlowRouterHookIsm, multiProvider: MultiProvider, concurrency: number, logger: Logger): Promise<DelayedFlowEnrollments>;
+/**
+ * Derives the chain-name-keyed remote ISM enrollment map shared by the hook
+ * and ISM readers.
+ */
+export declare function deriveDelayedFlowRemoteIsms(ism: DelayedFlowRouterHookIsm, multiProvider: MultiProvider, concurrency: number, logger: Logger): Promise<NonNullable<DelayedFlowRouterHookIsmConfig['remoteIsms']>>;
+//# sourceMappingURL=delayedFlow.d.ts.map

package/dist/ism/delayedFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delayedFlow.d.ts","sourceRoot":"","sources":["../../src/ism/delayedFlow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,SAAS,CAAC;IACrB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,2DAA2D;IAC3D,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B;;;;OAIG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,wBAAwB,EAC7B,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,sBAAsB,CAAC,CA8BjC;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,wBAAwB,EAC7B,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC,8BAA8B,CAAC,YAAY,CAAC,CAAC,CAAC,CAUpE"}

package/dist/ism/delayedFlow.js

@@ -0,0 +1,33 @@
+import { concurrentMap, isNullish } from '@recoillink/utils';
+/**
+ * Reads a DelayedFlowRouterHookIsm's enrollment and resolves each enrolled
+ * domain to a chain name.
+ */
+export async function readDelayedFlowEnrollments(ism, multiProvider, concurrency, logger) {
+    const domainIds = await ism.domains();
+    const resolved = domainIds.map((domainId) => ({
+        domainId,
+        chainName: multiProvider.tryGetChainName(domainId),
+    }));
+    const unnamedDomains = resolved
+        .filter(({ chainName }) => isNullish(chainName))
+        .map(({ domainId }) => domainId);
+    if (unnamedDomains.length > 0) {
+        logger.warn(`Unknown domain ID(s) ${unnamedDomains.join(', ')} enrolled on DelayedFlowRouterHookIsm at ${ism.address}; they cannot be named in a config`);
+    }
+    const nameable = resolved.filter((entry) => !isNullish(entry.chainName));
+    const named = await concurrentMap(concurrency, nameable, async ({ domainId, chainName }) => ({
+        chainName,
+        router: (await ism.routers(domainId)).toLowerCase(),
+    }));
+    return { named, unnamedDomains };
+}
+/**
+ * Derives the chain-name-keyed remote ISM enrollment map shared by the hook
+ * and ISM readers.
+ */
+export async function deriveDelayedFlowRemoteIsms(ism, multiProvider, concurrency, logger) {
+    const { named } = await readDelayedFlowEnrollments(ism, multiProvider, concurrency, logger);
+    return Object.fromEntries(named.map(({ chainName, router }) => [chainName, router]));
+}
+//# sourceMappingURL=delayedFlow.js.map

package/dist/ism/delayedFlow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delayedFlow.js","sourceRoot":"","sources":["../../src/ism/delayedFlow.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAwB7D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,GAA6B,EAC7B,aAA4B,EAC5B,WAAmB,EACnB,MAAc;IAEd,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC5C,QAAQ;QACR,SAAS,EAAE,aAAa,CAAC,eAAe,CAAC,QAAQ,CAAC;KACnD,CAAC,CAAC,CAAC;IAEJ,MAAM,cAAc,GAAG,QAAQ;SAC5B,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;SAC/C,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CACT,wBAAwB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,4CAA4C,GAAG,CAAC,OAAO,oCAAoC,CAC7I,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAC9B,CAAC,KAAK,EAAuD,EAAE,CAC7D,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAC9B,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,aAAa,CAC/B,WAAW,EACX,QAAQ,EACR,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAkC,EAAE,CAAC,CAAC;QAClE,SAAS;QACT,MAAM,EAAE,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE;KACpD,CAAC,CACH,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,GAA6B,EAC7B,aAA4B,EAC5B,WAAmB,EACnB,MAAc;IAEd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,0BAA0B,CAChD,GAAG,EACH,aAAa,EACb,WAAW,EACX,MAAM,CACP,CAAC;IACF,OAAO,MAAM,CAAC,WAAW,CACvB,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAC1D,CAAC;AACJ,CAAC"}

package/dist/ism/multisig.d.ts

@@ -0,0 +1,6 @@
+import { ChainMap, ChainName } from '../types.js';
+import { AggregationIsmConfig, MultisigConfig, MultisigIsmConfig } from './types.js';
+export declare const multisigConfigToIsmConfig: (type: MultisigIsmConfig['type'], config: MultisigConfig) => MultisigIsmConfig;
+export declare const buildMultisigIsmConfigs: (type: MultisigIsmConfig['type'], local: ChainName, chains: ChainName[], multisigConfigs: ChainMap<MultisigConfig>) => ChainMap<MultisigIsmConfig>;
+export declare const buildAggregationIsmConfigs: (local: ChainName, chains: ChainName[], multisigConfigs: ChainMap<MultisigConfig>) => ChainMap<AggregationIsmConfig>;
+//# sourceMappingURL=multisig.d.ts.map

package/dist/ism/multisig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multisig.d.ts","sourceRoot":"","sources":["../../src/ism/multisig.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EACL,oBAAoB,EAEpB,cAAc,EACd,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,yBAAyB,SAC9B,iBAAiB,CAAC,MAAM,CAAC,UACvB,cAAc,KACrB,iBAID,CAAC;AAKH,eAAO,MAAM,uBAAuB,SAC5B,iBAAiB,CAAC,MAAM,CAAC,SACxB,SAAS,UACR,SAAS,EAAE,mBACF,QAAQ,CAAC,cAAc,CAAC,KACxC,QAAQ,CAAC,iBAAiB,CAS5B,CAAC;AAEF,eAAO,MAAM,0BAA0B,UAC9B,SAAS,UACR,SAAS,EAAE,mBACF,QAAQ,CAAC,cAAc,CAAC,KACxC,QAAQ,CAAC,oBAAoB,CAgB/B,CAAC"}

package/dist/ism/multisig.js

@@ -0,0 +1,25 @@
+import { objFilter, objMap } from '@recoillink/utils';
+import { IsmType, } from './types.js';
+// Convert a MultisigConfig to a MultisigIsmConfig with the specified ISM type
+export const multisigConfigToIsmConfig = (type, config) => ({
+    type,
+    threshold: config.threshold,
+    validators: config.validators.map((v) => v.address),
+});
+// build multisigIsmConfig from multisigConfig
+// eg. for { sepolia (local), arbitrumsepolia, basesepolia }
+// arbitrumsepolia => Ism, basesepolia => Ism
+export const buildMultisigIsmConfigs = (type, local, chains, multisigConfigs) => {
+    return objMap(objFilter(multisigConfigs, (chain, _) => chain !== local && chains.includes(chain)), (_, config) => multisigConfigToIsmConfig(type, config));
+};
+export const buildAggregationIsmConfigs = (local, chains, multisigConfigs) => {
+    return objMap(objFilter(multisigConfigs, (chain, _config) => chain !== local && chains.includes(chain)), (_, config) => ({
+        type: IsmType.AGGREGATION,
+        modules: [
+            multisigConfigToIsmConfig(IsmType.MESSAGE_ID_MULTISIG, config),
+            multisigConfigToIsmConfig(IsmType.MERKLE_ROOT_MULTISIG, config),
+        ],
+        threshold: 1,
+    }));
+};
+//# sourceMappingURL=multisig.js.map

package/dist/ism/multisig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multisig.js","sourceRoot":"","sources":["../../src/ism/multisig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAItD,OAAO,EAEL,OAAO,GAGR,MAAM,YAAY,CAAC;AAEpB,8EAA8E;AAC9E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,IAA+B,EAC/B,MAAsB,EACH,EAAE,CAAC,CAAC;IACvB,IAAI;IACJ,SAAS,EAAE,MAAM,CAAC,SAAS;IAC3B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;CACpD,CAAC,CAAC;AAEH,8CAA8C;AAC9C,4DAA4D;AAC5D,6CAA6C;AAC7C,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,IAA+B,EAC/B,KAAgB,EAChB,MAAmB,EACnB,eAAyC,EACZ,EAAE;IAC/B,OAAO,MAAM,CACX,SAAS,CACP,eAAe,EACf,CAAC,KAAK,EAAE,CAAC,EAAuB,EAAE,CAChC,KAAK,KAAK,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC5C,EACD,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,CACvD,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,KAAgB,EAChB,MAAmB,EACnB,eAAyC,EACT,EAAE;IAClC,OAAO,MAAM,CACX,SAAS,CACP,eAAe,EACf,CAAC,KAAK,EAAE,OAAO,EAA6B,EAAE,CAC5C,KAAK,KAAK,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC5C,EACD,CAAC,CAAC,EAAE,MAAM,EAAwB,EAAE,CAAC,CAAC;QACpC,IAAI,EAAE,OAAO,CAAC,WAAW;QACzB,OAAO,EAAE;YACP,yBAAyB,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC;YAC9D,yBAAyB,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC;SAChE;QACD,SAAS,EAAE,CAAC;KACb,CAAC,CACH,CAAC;AACJ,CAAC,CAAC"}

package/dist/ism/serialization.d.ts

@@ -0,0 +1,74 @@
+import { PublicKey } from '@solana/web3.js';
+/**
+ * MultisigIsm instruction types matching Rust enum
+ * See: rust/sealevel/programs/ism/multisig-ism-message-id/src/instruction.rs
+ */
+export declare enum SealevelMultisigIsmInstructionType {
+    INIT = 0,
+    SET_VALIDATORS_AND_THRESHOLD = 1,
+    GET_OWNER = 2,
+    TRANSFER_OWNERSHIP = 3
+}
+export declare const SealevelMultisigIsmInstructionName: Record<SealevelMultisigIsmInstructionType, string>;
+/**
+ * SetValidatorsAndThreshold instruction data
+ * Matches: rust/sealevel/programs/ism/multisig-ism-message-id/src/instruction.rs
+ *
+ * Note: Instruction format AFTER 8-byte program discriminator:
+ * [enum_discriminator: u8, domain: u32, validators: Vec<[u8; 20]>, threshold: u8]
+ */
+export declare class SealevelMultisigIsmSetValidatorsInstruction {
+    domain: number;
+    validators: Uint8Array[];
+    threshold: number;
+    get validatorAddresses(): string[];
+    constructor(fields: any);
+}
+export declare const SealevelMultisigIsmSetValidatorsInstructionSchema: Map<any, any>;
+/**
+ * TransferOwnership instruction data
+ */
+export declare class SealevelMultisigIsmTransferOwnershipInstruction {
+    newOwner: Uint8Array | null;
+    newOwnerPubkey?: PublicKey;
+    constructor(fields: any);
+}
+export declare const SealevelMultisigIsmTransferOwnershipInstructionSchema: Map<any, any>;
+/**
+ * On-chain account data structures
+ * See: rust/sealevel/programs/ism/multisig-ism-message-id/src/accounts.rs
+ */
+/**
+ * SealevelValidatorsAndThreshold - Configuration of a validator set and threshold
+ * Matches: rust/sealevel/programs/ism/multisig-ism-message-id/src/instruction.rs
+ */
+export declare class SealevelValidatorsAndThreshold {
+    validators: Uint8Array[];
+    threshold: number;
+    get validatorAddresses(): string[];
+    constructor(fields: any);
+}
+export declare const SealevelValidatorsAndThresholdSchema: Map<any, any>;
+/**
+ * SealevelDomainData - The data of a "domain data" PDA account
+ * One of these exists for each domain that's been enrolled
+ * Matches: rust/sealevel/programs/ism/multisig-ism-message-id/src/accounts.rs
+ */
+export declare class SealevelDomainData {
+    bumpSeed: number;
+    validatorsAndThreshold: SealevelValidatorsAndThreshold;
+    constructor(fields: any);
+}
+export declare const SealevelDomainDataSchema: Map<any, any>;
+/**
+ * SealevelAccessControlData - The data of the access control PDA account
+ * Matches: rust/sealevel/programs/ism/multisig-ism-message-id/src/accounts.rs
+ */
+export declare class SealevelAccessControlData {
+    bumpSeed: number;
+    owner: Uint8Array | null;
+    ownerPubkey?: PublicKey;
+    constructor(fields: any);
+}
+export declare const SealevelAccessControlDataSchema: Map<any, any>;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/ism/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/ism/serialization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C;;;GAGG;AACH,oBAAY,kCAAkC;IAC5C,IAAI,IAAI;IACR,4BAA4B,IAAI;IAChC,SAAS,IAAI;IACb,kBAAkB,IAAI;CACvB;AAED,eAAO,MAAM,kCAAkC,EAAE,MAAM,CACrD,kCAAkC,EAClC,MAAM,CAOP,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,2CAA2C;IACtD,MAAM,EAAG,MAAM,CAAC;IAChB,UAAU,EAAG,UAAU,EAAE,CAAC;IAC1B,SAAS,EAAG,MAAM,CAAC;IAGnB,IAAI,kBAAkB,IAAI,MAAM,EAAE,CAEjC;IAED,YAAY,MAAM,EAAE,GAAG,EAEtB;CACF;AAED,eAAO,MAAM,iDAAiD,eAyB5D,CAAC;AAEH;;GAEG;AACH,qBAAa,+CAA+C;IAC1D,QAAQ,EAAG,UAAU,GAAG,IAAI,CAAC;IAC7B,cAAc,CAAC,EAAE,SAAS,CAAC;IAE3B,YAAY,MAAM,EAAE,GAAG,EAKtB;CACF;AAED,eAAO,MAAM,qDAAqD,eAuBhE,CAAC;AAEH;;;GAGG;AAEH;;;GAGG;AACH,qBAAa,8BAA8B;IACzC,UAAU,EAAG,UAAU,EAAE,CAAC;IAC1B,SAAS,EAAG,MAAM,CAAC;IAGnB,IAAI,kBAAkB,IAAI,MAAM,EAAE,CAEjC;IAED,YAAY,MAAM,EAAE,GAAG,EAEtB;CACF;AAED,eAAO,MAAM,oCAAoC,eAW/C,CAAC;AAEH;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,QAAQ,EAAG,MAAM,CAAC;IAClB,sBAAsB,EAAG,8BAA8B,CAAC;IAExD,YAAY,MAAM,EAAE,GAAG,EAEtB;CACF;AAED,eAAO,MAAM,wBAAwB,eAYnC,CAAC;AAEH;;;GAGG;AACH,qBAAa,yBAAyB;IACpC,QAAQ,EAAG,MAAM,CAAC;IAClB,KAAK,EAAG,UAAU,GAAG,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,SAAS,CAAC;IAExB,YAAY,MAAM,EAAE,GAAG,EAGtB;CACF;AAED,eAAO,MAAM,+BAA+B,eAW1C,CAAC"}

package/dist/ism/serialization.js

@@ -0,0 +1,177 @@
+import { PublicKey } from '@solana/web3.js';
+import { SealevelInstructionWrapper } from '../utils/sealevelSerialization.js';
+/**
+ * MultisigIsm instruction types matching Rust enum
+ * See: rust/sealevel/programs/ism/multisig-ism-message-id/src/instruction.rs
+ */
+export var SealevelMultisigIsmInstructionType;
+(function (SealevelMultisigIsmInstructionType) {
+    SealevelMultisigIsmInstructionType[SealevelMultisigIsmInstructionType["INIT"] = 0] = "INIT";
+    SealevelMultisigIsmInstructionType[SealevelMultisigIsmInstructionType["SET_VALIDATORS_AND_THRESHOLD"] = 1] = "SET_VALIDATORS_AND_THRESHOLD";
+    SealevelMultisigIsmInstructionType[SealevelMultisigIsmInstructionType["GET_OWNER"] = 2] = "GET_OWNER";
+    SealevelMultisigIsmInstructionType[SealevelMultisigIsmInstructionType["TRANSFER_OWNERSHIP"] = 3] = "TRANSFER_OWNERSHIP";
+})(SealevelMultisigIsmInstructionType || (SealevelMultisigIsmInstructionType = {}));
+export const SealevelMultisigIsmInstructionName = {
+    [SealevelMultisigIsmInstructionType.INIT]: 'Init',
+    [SealevelMultisigIsmInstructionType.SET_VALIDATORS_AND_THRESHOLD]: 'SetValidatorsAndThreshold',
+    [SealevelMultisigIsmInstructionType.GET_OWNER]: 'GetOwner',
+    [SealevelMultisigIsmInstructionType.TRANSFER_OWNERSHIP]: 'TransferOwnership',
+};
+/**
+ * SetValidatorsAndThreshold instruction data
+ * Matches: rust/sealevel/programs/ism/multisig-ism-message-id/src/instruction.rs
+ *
+ * Note: Instruction format AFTER 8-byte program discriminator:
+ * [enum_discriminator: u8, domain: u32, validators: Vec<[u8; 20]>, threshold: u8]
+ */
+export class SealevelMultisigIsmSetValidatorsInstruction {
+    domain;
+    validators; // Vec<[u8; 20]> - Ethereum addresses
+    threshold;
+    // Helper to format validators as 0x-prefixed hex strings
+    get validatorAddresses() {
+        return this.validators.map((v) => `0x${Buffer.from(v).toString('hex')}`);
+    }
+    constructor(fields) {
+        Object.assign(this, fields);
+    }
+}
+export const SealevelMultisigIsmSetValidatorsInstructionSchema = new Map([
+    [
+        SealevelInstructionWrapper,
+        {
+            kind: 'struct',
+            fields: [
+                ['instruction', 'u8'], // Enum discriminator (1 byte, after 8-byte program discriminator)
+                ['data', SealevelMultisigIsmSetValidatorsInstruction],
+            ],
+        },
+    ],
+    [
+        SealevelMultisigIsmSetValidatorsInstruction,
+        {
+            kind: 'struct',
+            fields: [
+                ['domain', 'u32'],
+                ['validators', [[20]]], // Vec of 20-byte arrays (Ethereum addresses)
+                ['threshold', 'u8'],
+            ],
+        },
+    ],
+]);
+/**
+ * TransferOwnership instruction data
+ */
+export class SealevelMultisigIsmTransferOwnershipInstruction {
+    newOwner;
+    newOwnerPubkey;
+    constructor(fields) {
+        Object.assign(this, fields);
+        this.newOwnerPubkey = this.newOwner
+            ? new PublicKey(this.newOwner)
+            : undefined;
+    }
+}
+export const SealevelMultisigIsmTransferOwnershipInstructionSchema = new Map([
+    [
+        SealevelInstructionWrapper,
+        {
+            kind: 'struct',
+            fields: [
+                ['instruction', 'u8'],
+                ['data', SealevelMultisigIsmTransferOwnershipInstruction],
+            ],
+        },
+    ],
+    [
+        SealevelMultisigIsmTransferOwnershipInstruction,
+        {
+            kind: 'struct',
+            fields: [
+                ['newOwner', { kind: 'option', type: [32] }], // Option<Pubkey>
+            ],
+        },
+    ],
+]);
+/**
+ * On-chain account data structures
+ * See: rust/sealevel/programs/ism/multisig-ism-message-id/src/accounts.rs
+ */
+/**
+ * SealevelValidatorsAndThreshold - Configuration of a validator set and threshold
+ * Matches: rust/sealevel/programs/ism/multisig-ism-message-id/src/instruction.rs
+ */
+export class SealevelValidatorsAndThreshold {
+    validators; // Vec<H160> - 20-byte Ethereum addresses
+    threshold; // u8
+    // Helper to format validators as 0x-prefixed hex strings
+    get validatorAddresses() {
+        return this.validators.map((v) => `0x${Buffer.from(v).toString('hex')}`);
+    }
+    constructor(fields) {
+        Object.assign(this, fields);
+    }
+}
+export const SealevelValidatorsAndThresholdSchema = new Map([
+    [
+        SealevelValidatorsAndThreshold,
+        {
+            kind: 'struct',
+            fields: [
+                ['validators', [[20]]], // Vec of 20-byte arrays (Ethereum addresses)
+                ['threshold', 'u8'],
+            ],
+        },
+    ],
+]);
+/**
+ * SealevelDomainData - The data of a "domain data" PDA account
+ * One of these exists for each domain that's been enrolled
+ * Matches: rust/sealevel/programs/ism/multisig-ism-message-id/src/accounts.rs
+ */
+export class SealevelDomainData {
+    bumpSeed; // u8
+    validatorsAndThreshold;
+    constructor(fields) {
+        Object.assign(this, fields);
+    }
+}
+export const SealevelDomainDataSchema = new Map([
+    ...SealevelValidatorsAndThresholdSchema,
+    [
+        SealevelDomainData,
+        {
+            kind: 'struct',
+            fields: [
+                ['bumpSeed', 'u8'],
+                ['validatorsAndThreshold', SealevelValidatorsAndThreshold],
+            ],
+        },
+    ],
+]);
+/**
+ * SealevelAccessControlData - The data of the access control PDA account
+ * Matches: rust/sealevel/programs/ism/multisig-ism-message-id/src/accounts.rs
+ */
+export class SealevelAccessControlData {
+    bumpSeed; // u8
+    owner; // Option<Pubkey>
+    ownerPubkey;
+    constructor(fields) {
+        Object.assign(this, fields);
+        this.ownerPubkey = this.owner ? new PublicKey(this.owner) : undefined;
+    }
+}
+export const SealevelAccessControlDataSchema = new Map([
+    [
+        SealevelAccessControlData,
+        {
+            kind: 'struct',
+            fields: [
+                ['bumpSeed', 'u8'],
+                ['owner', { kind: 'option', type: [32] }], // Option<Pubkey>
+            ],
+        },
+    ],
+]);
+//# sourceMappingURL=serialization.js.map

package/dist/ism/serialization.js.map

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