@recoillink/sdk 0.0.0-stage → 45.0.1

package/dist/utils/ism.test.js

@@ -0,0 +1,445 @@
+import { expect } from 'chai';
+import { ethers } from 'ethers';
+import { test1, test2, test3 } from '../consts/testChains.js';
+import { CompositeIsmNodeType, IsmType } from '../ism/types.js';
+import { MultiProvider } from '../providers/MultiProvider.js';
+import { DelayedFlowRemoteIsmsSourceType, canonicalizeRemoteIsms, collectHybridIsmNodes, completeHybridIsmNodes, ismTreeContainsCompositeRateLimited, ismTreeContainsHybridHookIsm, ismTreeContainsMailboxDefaultOrHybrid, ismTreeContainsRateLimited, prepareHybridIsmNodesForDeploy, resolveDelayedFlowRemoteIsms, } from './ism.js';
+const WARP_ROUTER = '0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa';
+const DEPLOYER = '0xdddddddddddddddddddddddddddddddddddddddd';
+const DEFAULT_OWNER = '0xcccccccccccccccccccccccccccccccccccccccc';
+const OWNER = '0x1111111111111111111111111111111111111111';
+const RELAYER = '0x2222222222222222222222222222222222222222';
+const REMOTE_ISM_BYTES32 = ethers.utils.hexZeroPad('0x3333333333333333333333333333333333333333', 32);
+const STALE_REMOTE_ISM_BYTES32 = ethers.utils.hexZeroPad('0x4444444444444444444444444444444444444444', 32);
+// The test chains all use chainId === domainId, which would let a chain-id key
+// pass by coincidence. This one keeps the two apart.
+const oddChain = {
+    ...test1,
+    name: 'oddchain',
+    displayName: 'Odd Chain',
+    chainId: 4242,
+    domainId: 777777,
+};
+const chainLookup = new MultiProvider({
+    test1,
+    test2,
+    test3,
+    oddchain: oddChain,
+});
+const delayedNode = {
+    type: IsmType.DELAYED_FLOW_ROUTER,
+    thresholdBps: 10000,
+    maxDelay: 3600,
+    duration: 86400n,
+    owner: OWNER,
+};
+const netFlowNode = {
+    type: IsmType.NET_FLOW_RATE_LIMITED,
+    thresholdBps: 500,
+    duration: 86400n,
+    owner: OWNER,
+};
+function aggregationOf(...modules) {
+    return {
+        type: IsmType.AGGREGATION,
+        threshold: modules.length,
+        modules,
+    };
+}
+describe('typed ISM tree traversal', () => {
+    it('finds EVM rate limiting through SDK containers only', () => {
+        const tree = {
+            type: IsmType.AMOUNT_ROUTING,
+            threshold: 1,
+            lowerIsm: { type: IsmType.TEST_ISM },
+            upperIsm: aggregationOf({
+                type: IsmType.ROUTING,
+                owner: OWNER,
+                domains: {
+                    test2: {
+                        type: IsmType.RATE_LIMITED,
+                        maxCapacity: '86400',
+                        duration: 86400n,
+                    },
+                },
+            }),
+        };
+        expect(ismTreeContainsRateLimited(tree)).to.be.true;
+        expect(ismTreeContainsCompositeRateLimited(tree)).to.be.false;
+    });
+    it('finds composite rate limiting through both container unions', () => {
+        const tree = aggregationOf({
+            type: IsmType.ROUTING,
+            owner: OWNER,
+            domains: {
+                test2: {
+                    type: IsmType.COMPOSITE,
+                    owner: OWNER,
+                    root: {
+                        type: CompositeIsmNodeType.AMOUNT_ROUTING,
+                        threshold: '1',
+                        lower: { type: CompositeIsmNodeType.TEST, accept: true },
+                        upper: {
+                            type: CompositeIsmNodeType.ROUTING,
+                            domains: {
+                                test3: {
+                                    type: CompositeIsmNodeType.RATE_LIMITED,
+                                    maxCapacity: '86400',
+                                    mailbox: WARP_ROUTER,
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        });
+        expect(ismTreeContainsRateLimited(tree)).to.be.false;
+        expect(ismTreeContainsCompositeRateLimited(tree)).to.be.true;
+    });
+    it('traverses past routingMessageIdMultisigIsm leaves without matching', () => {
+        const tree = aggregationOf({
+            type: IsmType.ROUTING_MESSAGE_ID_MULTISIG,
+            owner: OWNER,
+            domains: {
+                test2: { validators: [RELAYER], threshold: 1 },
+            },
+        });
+        expect(ismTreeContainsRateLimited(tree)).to.be.false;
+        expect(ismTreeContainsCompositeRateLimited(tree)).to.be.false;
+        expect(ismTreeContainsMailboxDefaultOrHybrid(tree)).to.be.false;
+    });
+    it('finds mailbox-incompatible ISMs through SDK containers', () => {
+        const tree = {
+            type: IsmType.ROUTING,
+            owner: OWNER,
+            domains: {
+                test2: aggregationOf({ type: IsmType.MAILBOX_DEFAULT }),
+            },
+        };
+        expect(ismTreeContainsMailboxDefaultOrHybrid(tree)).to.be.true;
+    });
+});
+describe('hybrid hook/ISM tree helpers', () => {
+    describe('ismTreeContainsHybridHookIsm', () => {
+        it('detects hybrid nodes nested in containers', () => {
+            const tree = aggregationOf({ type: IsmType.TRUSTED_RELAYER, relayer: RELAYER }, delayedNode);
+            expect(ismTreeContainsHybridHookIsm(tree)).to.be.true;
+        });
+        it('returns false for trees without hybrid nodes', () => {
+            const tree = aggregationOf({
+                type: IsmType.TRUSTED_RELAYER,
+                relayer: RELAYER,
+            });
+            expect(ismTreeContainsHybridHookIsm(tree)).to.be.false;
+        });
+    });
+    describe('collectHybridIsmNodes', () => {
+        it('collects hybrid nodes across aggregation, routing, and amount routing containers', () => {
+            const tree = {
+                type: IsmType.AMOUNT_ROUTING,
+                threshold: 1,
+                lowerIsm: aggregationOf(netFlowNode),
+                upperIsm: {
+                    type: IsmType.ROUTING,
+                    owner: OWNER,
+                    domains: { test2: delayedNode },
+                },
+            };
+            const nodes = collectHybridIsmNodes(tree);
+            expect(nodes.map((node) => node.type)).to.have.members([
+                IsmType.NET_FLOW_RATE_LIMITED,
+                IsmType.DELAYED_FLOW_ROUTER,
+            ]);
+        });
+        it('returns a hybrid node when it is the tree root', () => {
+            expect(collectHybridIsmNodes(delayedNode)).to.deep.equal([delayedNode]);
+        });
+    });
+    describe('prepareHybridIsmNodesForDeploy', () => {
+        it('injects warpRouter and overrides DELAYED owner to the intermediate deployer, dropping remoteIsms', () => {
+            const tree = aggregationOf({ type: IsmType.TRUSTED_RELAYER, relayer: RELAYER }, {
+                type: IsmType.DELAYED_FLOW_ROUTER,
+                thresholdBps: 10000,
+                maxDelay: 3600,
+                duration: 86400n,
+                owner: OWNER,
+                remoteIsms: { test2: REMOTE_ISM_BYTES32 },
+            });
+            const prepared = prepareHybridIsmNodesForDeploy(tree, WARP_ROUTER, DEPLOYER);
+            const nodes = collectHybridIsmNodes(prepared);
+            expect(nodes).to.deep.equal([
+                {
+                    type: IsmType.DELAYED_FLOW_ROUTER,
+                    warpRouter: WARP_ROUTER,
+                    thresholdBps: 10000,
+                    maxDelay: 3600,
+                    duration: 86400n,
+                    owner: DEPLOYER,
+                },
+            ]);
+        });
+        it('injects warpRouter and overrides NET_FLOW owner to the intermediate deployer', () => {
+            const prepared = prepareHybridIsmNodesForDeploy(netFlowNode, WARP_ROUTER, DEPLOYER);
+            expect(prepared).to.deep.equal({
+                type: IsmType.NET_FLOW_RATE_LIMITED,
+                warpRouter: WARP_ROUTER,
+                thresholdBps: 500,
+                duration: 86400n,
+                owner: DEPLOYER,
+            });
+        });
+        it('overrides an omitted NET_FLOW owner to the intermediate deployer', () => {
+            const ownerlessNetFlow = {
+                type: IsmType.NET_FLOW_RATE_LIMITED,
+                thresholdBps: 500,
+                duration: 86400n,
+            };
+            const prepared = prepareHybridIsmNodesForDeploy(ownerlessNetFlow, WARP_ROUTER, DEPLOYER);
+            expect(prepared).to.deep.equal({
+                type: IsmType.NET_FLOW_RATE_LIMITED,
+                warpRouter: WARP_ROUTER,
+                thresholdBps: 500,
+                duration: 86400n,
+                owner: DEPLOYER,
+            });
+        });
+        it('leaves non-hybrid nodes untouched', () => {
+            const tree = aggregationOf({
+                type: IsmType.TRUSTED_RELAYER,
+                relayer: RELAYER,
+            });
+            expect(prepareHybridIsmNodesForDeploy(tree, WARP_ROUTER, DEPLOYER)).to.deep.equal(tree);
+        });
+        it('prepareHybridIsmNodesForDeploy rejects a warpRouter that disagrees with the containing router', () => {
+            const foreignRouter = {
+                type: IsmType.DELAYED_FLOW_ROUTER,
+                warpRouter: RELAYER,
+                thresholdBps: 10000,
+                maxDelay: 3600,
+                duration: 86400n,
+                owner: OWNER,
+            };
+            expect(() => prepareHybridIsmNodesForDeploy(aggregationOf(foreignRouter), WARP_ROUTER, DEPLOYER)).to.throw('installed on warp router');
+        });
+        it('accepts a warpRouter matching the containing router in any casing', () => {
+            const explicitRouter = {
+                type: IsmType.NET_FLOW_RATE_LIMITED,
+                warpRouter: WARP_ROUTER.toUpperCase().replace('0X', '0x'),
+                thresholdBps: 500,
+                duration: 86400n,
+                owner: OWNER,
+            };
+            expect(prepareHybridIsmNodesForDeploy(explicitRouter, WARP_ROUTER, DEPLOYER)).to.deep.equal({
+                type: IsmType.NET_FLOW_RATE_LIMITED,
+                warpRouter: WARP_ROUTER,
+                thresholdBps: 500,
+                duration: 86400n,
+                owner: DEPLOYER,
+            });
+        });
+    });
+    describe('canonicalizeRemoteIsms', () => {
+        it('keys by chain name and normalizes the counterpart to lowercase bytes32', () => {
+            expect(canonicalizeRemoteIsms({ test2: '0x3333333333333333333333333333333333333333' }, chainLookup, 'test')).to.deep.equal({ test2: REMOTE_ISM_BYTES32 });
+        });
+        it('resolves a domain-id key to the same entry as the chain name', () => {
+            expect(canonicalizeRemoteIsms({ [test2.domainId]: REMOTE_ISM_BYTES32 }, chainLookup, 'test')).to.deep.equal({ test2: REMOTE_ISM_BYTES32 });
+        });
+        it('rejects a chain-id key that is not the chain domain id', () => {
+            // deploy/update resolve keys through the registry, where a numeric key is
+            // a domain id: taking a chain id here would enroll the wrong domain (or
+            // none), and only after the contracts are on-chain.
+            expect(() => canonicalizeRemoteIsms({ [oddChain.chainId]: REMOTE_ISM_BYTES32 }, chainLookup, 'test')).to.throw('resolves to no known chain');
+            expect(canonicalizeRemoteIsms({ [oddChain.domainId]: REMOTE_ISM_BYTES32 }, chainLookup, 'test')).to.deep.equal({ oddchain: REMOTE_ISM_BYTES32 });
+        });
+        it('rejects a misspelled chain rather than skipping it', () => {
+            expect(() => canonicalizeRemoteIsms({ tset2: REMOTE_ISM_BYTES32 }, chainLookup, 'test')).to.throw("names 'tset2'");
+        });
+        it('rejects a chain named twice through two key forms', () => {
+            // Both entries describe domain test2, which has a single on-chain
+            // counterpart: submitting both can never converge.
+            expect(() => canonicalizeRemoteIsms({
+                test2: REMOTE_ISM_BYTES32,
+                [test2.domainId]: REMOTE_ISM_BYTES32,
+            }, chainLookup, 'test')).to.throw('same chain test2');
+        });
+    });
+    describe('resolveDelayedFlowRemoteIsms', () => {
+        it('takes the derived pairing when the config omits the field', () => {
+            expect(resolveDelayedFlowRemoteIsms(undefined, { test2: REMOTE_ISM_BYTES32 }, 'test', chainLookup)).to.deep.equal({ test2: REMOTE_ISM_BYTES32 });
+        });
+        it('uses the route-derived pairing for an in-route chain while preserving external configured peers', () => {
+            expect(resolveDelayedFlowRemoteIsms({
+                test2: STALE_REMOTE_ISM_BYTES32,
+                test3: REMOTE_ISM_BYTES32,
+            }, { test2: REMOTE_ISM_BYTES32 }, 'test', chainLookup)).to.deep.equal({
+                test2: REMOTE_ISM_BYTES32,
+                test3: REMOTE_ISM_BYTES32,
+            });
+        });
+        it('keeps a configured pairing when nothing is derived', () => {
+            expect(resolveDelayedFlowRemoteIsms({ test3: REMOTE_ISM_BYTES32 }, undefined, 'test', chainLookup)).to.deep.equal({ test3: REMOTE_ISM_BYTES32 });
+        });
+        it('canonicalizes a configured pairing keyed by domain id', () => {
+            // What `warp check` compares and what `warp apply` submits both come from
+            // here, so a domain-keyed config must resolve to the chain-name form the
+            // reader emits — otherwise the route reports drift forever.
+            expect(resolveDelayedFlowRemoteIsms({ [test3.domainId]: REMOTE_ISM_BYTES32 }, { test3: REMOTE_ISM_BYTES32 }, 'test', chainLookup)).to.deep.equal({ test3: REMOTE_ISM_BYTES32 });
+        });
+        it('resolves to nothing when neither side has a pairing', () => {
+            expect(resolveDelayedFlowRemoteIsms(undefined, undefined, 'test', chainLookup)).to.be.undefined;
+        });
+    });
+    describe('completeHybridIsmNodes', () => {
+        const resolved = (derived) => ({
+            type: DelayedFlowRemoteIsmsSourceType.Resolved,
+            derived,
+        });
+        const deferred = {
+            type: DelayedFlowRemoteIsmsSourceType.Deferred,
+        };
+        it('fills missing warpRouter and remoteIsms', () => {
+            const completed = completeHybridIsmNodes(delayedNode, WARP_ROUTER, resolved({ test2: REMOTE_ISM_BYTES32 }), DEFAULT_OWNER, chainLookup);
+            expect(completed).to.deep.equal({
+                type: IsmType.DELAYED_FLOW_ROUTER,
+                warpRouter: WARP_ROUTER,
+                thresholdBps: 10000,
+                maxDelay: 3600,
+                duration: 86400n,
+                owner: OWNER,
+                remoteIsms: { test2: REMOTE_ISM_BYTES32 },
+            });
+        });
+        it('uses route-derived remoteIsms over a stale configured in-route pairing', () => {
+            const userNode = {
+                type: IsmType.DELAYED_FLOW_ROUTER,
+                warpRouter: WARP_ROUTER,
+                thresholdBps: 10000,
+                maxDelay: 3600,
+                duration: 86400n,
+                owner: OWNER,
+                remoteIsms: { test2: STALE_REMOTE_ISM_BYTES32 },
+            };
+            const completed = completeHybridIsmNodes(userNode, WARP_ROUTER, resolved({ test2: REMOTE_ISM_BYTES32 }), DEFAULT_OWNER, chainLookup);
+            expect(completed).to.deep.equal({
+                type: IsmType.DELAYED_FLOW_ROUTER,
+                warpRouter: WARP_ROUTER,
+                thresholdBps: 10000,
+                maxDelay: 3600,
+                duration: 86400n,
+                owner: OWNER,
+                remoteIsms: { test2: REMOTE_ISM_BYTES32 },
+            });
+        });
+        it('keeps a configured remoteIsms when no pairing is derived', () => {
+            const userNode = {
+                type: IsmType.DELAYED_FLOW_ROUTER,
+                warpRouter: WARP_ROUTER,
+                thresholdBps: 10000,
+                maxDelay: 3600,
+                duration: 86400n,
+                owner: OWNER,
+                remoteIsms: { test3: REMOTE_ISM_BYTES32 },
+            };
+            const completed = completeHybridIsmNodes(userNode, WARP_ROUTER, resolved(undefined), DEFAULT_OWNER, chainLookup);
+            expect(completed).to.deep.equal({
+                type: IsmType.DELAYED_FLOW_ROUTER,
+                warpRouter: WARP_ROUTER,
+                thresholdBps: 10000,
+                maxDelay: 3600,
+                duration: 86400n,
+                owner: OWNER,
+                remoteIsms: { test3: REMOTE_ISM_BYTES32 },
+            });
+        });
+        it('clears remoteIsms when the field is deferred to the enrollment pass', () => {
+            const userNode = {
+                type: IsmType.DELAYED_FLOW_ROUTER,
+                warpRouter: WARP_ROUTER,
+                thresholdBps: 10000,
+                maxDelay: 3600,
+                duration: 86400n,
+                owner: OWNER,
+                remoteIsms: { test3: REMOTE_ISM_BYTES32 },
+            };
+            const completed = completeHybridIsmNodes(userNode, WARP_ROUTER, deferred, DEFAULT_OWNER, chainLookup);
+            expect(completed).to.deep.equal({
+                type: IsmType.DELAYED_FLOW_ROUTER,
+                warpRouter: WARP_ROUTER,
+                thresholdBps: 10000,
+                maxDelay: 3600,
+                duration: 86400n,
+                owner: OWNER,
+                remoteIsms: undefined,
+            });
+        });
+        it('completeHybridIsmNodes rejects a warpRouter that disagrees with the containing router', () => {
+            const foreignRouter = {
+                type: IsmType.DELAYED_FLOW_ROUTER,
+                warpRouter: RELAYER,
+                thresholdBps: 10000,
+                maxDelay: 3600,
+                duration: 86400n,
+                owner: OWNER,
+            };
+            expect(() => completeHybridIsmNodes(aggregationOf(foreignRouter), WARP_ROUTER, resolved(undefined), DEFAULT_OWNER, chainLookup)).to.throw('installed on warp router');
+        });
+        it('fills warpRouter without a resolvable owner when nodes carry one', () => {
+            const completed = completeHybridIsmNodes(aggregationOf(delayedNode, netFlowNode), WARP_ROUTER, resolved(undefined), undefined, chainLookup);
+            expect(collectHybridIsmNodes(completed)).to.deep.equal([
+                {
+                    type: IsmType.DELAYED_FLOW_ROUTER,
+                    warpRouter: WARP_ROUTER,
+                    thresholdBps: 10000,
+                    maxDelay: 3600,
+                    duration: 86400n,
+                    owner: OWNER,
+                    remoteIsms: undefined,
+                },
+                {
+                    type: IsmType.NET_FLOW_RATE_LIMITED,
+                    warpRouter: WARP_ROUTER,
+                    thresholdBps: 500,
+                    duration: 86400n,
+                    owner: OWNER,
+                },
+            ]);
+        });
+        it('rejects a NET_FLOW node with neither an owner nor a resolvable default', () => {
+            const ownerlessNetFlow = {
+                type: IsmType.NET_FLOW_RATE_LIMITED,
+                thresholdBps: 500,
+                duration: 86400n,
+            };
+            expect(() => completeHybridIsmNodes(ownerlessNetFlow, WARP_ROUTER, resolved(undefined), undefined, chainLookup)).to.throw("omits 'owner'");
+        });
+        it('completes NET_FLOW nodes with warpRouter, preserving an explicit owner', () => {
+            const completed = completeHybridIsmNodes(aggregationOf(netFlowNode), WARP_ROUTER, resolved(undefined), DEFAULT_OWNER, chainLookup);
+            expect(collectHybridIsmNodes(completed)).to.deep.equal([
+                {
+                    type: IsmType.NET_FLOW_RATE_LIMITED,
+                    warpRouter: WARP_ROUTER,
+                    thresholdBps: 500,
+                    duration: 86400n,
+                    owner: OWNER,
+                },
+            ]);
+        });
+        it('completeHybridIsmNodes defaults an omitted NET_FLOW owner to the chain config owner', () => {
+            const ownerlessNetFlow = {
+                type: IsmType.NET_FLOW_RATE_LIMITED,
+                thresholdBps: 500,
+                duration: 86400n,
+            };
+            const completed = completeHybridIsmNodes(ownerlessNetFlow, WARP_ROUTER, resolved(undefined), DEFAULT_OWNER, chainLookup);
+            expect(completed).to.deep.equal({
+                type: IsmType.NET_FLOW_RATE_LIMITED,
+                warpRouter: WARP_ROUTER,
+                thresholdBps: 500,
+                duration: 86400n,
+                owner: DEFAULT_OWNER,
+            });
+        });
+    });
+});
+//# sourceMappingURL=ism.test.js.map

package/dist/utils/ism.test.js.map

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

package/dist/utils/logUtils.d.ts

@@ -0,0 +1,4 @@
+import { ethers } from 'ethers';
+import { Log } from 'viem';
+export declare function findMatchingLogEvents(logs: (ethers.providers.Log | Log<bigint, number, false>)[], iface: ethers.utils.Interface, eventName: string): ethers.utils.LogDescription[];
+//# sourceMappingURL=logUtils.d.ts.map

package/dist/utils/logUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logUtils.d.ts","sourceRoot":"","sources":["../../src/utils/logUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAE3B,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,EAC3D,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,EAC7B,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,KAAK,CAAC,cAAc,EAAE,CAa/B"}

package/dist/utils/logUtils.js

@@ -0,0 +1,13 @@
+export function findMatchingLogEvents(logs, iface, eventName) {
+    return logs
+        .map((log) => {
+        try {
+            return iface.parseLog(log);
+        }
+        catch {
+            return undefined;
+        }
+    })
+        .filter((log) => !!log && log.name === eventName);
+}
+//# sourceMappingURL=logUtils.js.map

package/dist/utils/logUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logUtils.js","sourceRoot":"","sources":["../../src/utils/logUtils.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,qBAAqB,CACnC,IAA2D,EAC3D,KAA6B,EAC7B,SAAiB;IAEjB,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,IAAI,CAAC;YACH,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;SACD,MAAM,CACL,CAAC,GAAG,EAAsC,EAAE,CAC1C,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,CAClC,CAAC;AACN,CAAC"}

package/dist/utils/numbers.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Converts a numeric value coming from an RPC or a block explorer to a number.
+ *
+ * The same field is returned as a JSON number by some providers, as a decimal
+ * string by others and as a hex string by the rest, so all three forms are
+ * accepted and validated against the safe integer range. A hex string carrying
+ * no digits reads as zero, which is how Etherscan and Blockscout report a zero
+ * valued field.
+ */
+export declare function toNumber(value: unknown, field: string): number;
+//# sourceMappingURL=numbers.d.ts.map

package/dist/utils/numbers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../../src/utils/numbers.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAuC9D"}

package/dist/utils/numbers.js

@@ -0,0 +1,36 @@
+import { assert, strip0x } from '@recoillink/utils';
+/**
+ * Converts a numeric value coming from an RPC or a block explorer to a number.
+ *
+ * The same field is returned as a JSON number by some providers, as a decimal
+ * string by others and as a hex string by the rest, so all three forms are
+ * accepted and validated against the safe integer range. A hex string carrying
+ * no digits reads as zero, which is how Etherscan and Blockscout report a zero
+ * valued field.
+ */
+export function toNumber(value, field) {
+    if (typeof value === 'number') {
+        assert(Number.isSafeInteger(value), `${field} is not a safe integer: ${value}`);
+        return value;
+    }
+    if (typeof value === 'bigint') {
+        const num = Number(value);
+        // The doubles from 2n ** 53n up step by two, so a value that reads back as
+        // the same bigint is not by itself a faithful reading of it.
+        assert(Number.isSafeInteger(num), `${field} bigint value ${value} exceeds safe integer range`);
+        return num;
+    }
+    if (typeof value === 'string') {
+        assert(/^0x[0-9a-fA-F]*$/.test(value) || /^[0-9]+$/.test(value), `${field} string "${value}" is not a valid hex or decimal number`);
+        // A zero valued field arrives as a bare "0x", which strips to nothing and
+        // which parseInt reads as NaN.
+        const num = value.startsWith('0x')
+            ? parseInt(strip0x(value) || '0', 16)
+            : parseInt(value, 10);
+        assert(!Number.isNaN(num), `${field} parsed to NaN from "${value}"`);
+        assert(Number.isSafeInteger(num), `${field} string value "${value}" exceeds safe integer range`);
+        return num;
+    }
+    assert(false, `Unable to convert ${field} to number`);
+}
+//# sourceMappingURL=numbers.js.map

package/dist/utils/numbers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.js","sourceRoot":"","sources":["../../src/utils/numbers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc,EAAE,KAAa;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,CACJ,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,EAC3B,GAAG,KAAK,2BAA2B,KAAK,EAAE,CAC3C,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,2EAA2E;QAC3E,6DAA6D;QAC7D,MAAM,CACJ,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,EACzB,GAAG,KAAK,iBAAiB,KAAK,6BAA6B,CAC5D,CAAC;QACF,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,CACJ,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EACxD,GAAG,KAAK,YAAY,KAAK,wCAAwC,CAClE,CAAC;QACF,0EAA0E;QAC1E,+BAA+B;QAC/B,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;YAChC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC;YACrC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxB,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,wBAAwB,KAAK,GAAG,CAAC,CAAC;QACrE,MAAM,CACJ,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,EACzB,GAAG,KAAK,kBAAkB,KAAK,8BAA8B,CAC9D,CAAC;QACF,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,qBAAqB,KAAK,YAAY,CAAC,CAAC;AACxD,CAAC"}

package/dist/utils/numbers.test.d.ts

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

package/dist/utils/numbers.test.d.ts.map

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

package/dist/utils/numbers.test.js

@@ -0,0 +1,80 @@
+import { expect } from 'chai';
+import { toNumber } from './numbers.js';
+const parsedCases = [
+    {
+        // How Etherscan and Blockscout report a zero valued hex field, which
+        // parseInt reads as NaN.
+        name: 'a hex string carrying no digits',
+        value: '0x',
+        expected: 0,
+    },
+    { name: 'a zero hex string', value: '0x0', expected: 0 },
+    { name: 'a hex string', value: '0xff', expected: 255 },
+    { name: 'an upper case hex string', value: '0xFF', expected: 255 },
+    { name: 'a decimal string', value: '5755676', expected: 5_755_676 },
+    { name: 'a JSON number', value: 5_755_676, expected: 5_755_676 },
+    { name: 'a bigint', value: 5755676n, expected: 5_755_676 },
+    {
+        name: 'the largest bigint a number represents exactly',
+        value: 2n ** 53n - 1n,
+        expected: 9_007_199_254_740_991,
+    },
+];
+const rejectedCases = [
+    {
+        name: 'a block tag',
+        value: 'pending',
+        expectedError: 'blockNumber string "pending" is not a valid hex or decimal number',
+    },
+    {
+        name: 'an empty string',
+        value: '',
+        expectedError: 'blockNumber string "" is not a valid hex or decimal number',
+    },
+    {
+        name: 'a hex string with a non hex digit',
+        value: '0xfg',
+        expectedError: 'blockNumber string "0xfg" is not a valid hex or decimal number',
+    },
+    {
+        name: 'a hex string above the safe integer range',
+        value: '0x20000000000000',
+        expectedError: 'blockNumber string value "0x20000000000000" exceeds safe integer range',
+    },
+    {
+        name: 'a bigint above the safe integer range',
+        value: 9007199254740993n,
+        expectedError: 'blockNumber bigint value 9007199254740993 exceeds safe integer range',
+    },
+    {
+        // The boundary itself: Number(2n ** 53n) is finite and reads back as the
+        // same bigint, which is what a round trip check accepted, but the doubles
+        // above it step by two so it is not a safe integer.
+        name: 'a bigint at the safe integer boundary',
+        value: 2n ** 53n,
+        expectedError: 'blockNumber bigint value 9007199254740992 exceeds safe integer range',
+    },
+    {
+        name: 'a fractional number',
+        value: 1.5,
+        expectedError: 'blockNumber is not a safe integer: 1.5',
+    },
+    {
+        name: 'a missing value',
+        value: undefined,
+        expectedError: 'Unable to convert blockNumber to number',
+    },
+];
+describe('toNumber', () => {
+    for (const c of parsedCases) {
+        it(`parses ${c.name}`, () => {
+            expect(toNumber(c.value, 'blockNumber')).to.equal(c.expected);
+        });
+    }
+    for (const c of rejectedCases) {
+        it(`rejects ${c.name}`, () => {
+            expect(() => toNumber(c.value, 'blockNumber')).to.throw(c.expectedError);
+        });
+    }
+});
+//# sourceMappingURL=numbers.test.js.map

package/dist/utils/numbers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.test.js","sourceRoot":"","sources":["../../src/utils/numbers.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAQxC,MAAM,WAAW,GAAiB;IAChC;QACE,qEAAqE;QACrE,yBAAyB;QACzB,IAAI,EAAE,iCAAiC;QACvC,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,CAAC;KACZ;IACD,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE;IACxD,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE;IACtD,EAAE,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE;IAClE,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE;IACnE,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE;IAChE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,QAAU,EAAE,QAAQ,EAAE,SAAS,EAAE;IAC5D;QACE,IAAI,EAAE,gDAAgD;QACtD,KAAK,EAAE,EAAE,IAAI,GAAG,GAAG,EAAE;QACrB,QAAQ,EAAE,qBAAqB;KAChC;CACF,CAAC;AAQF,MAAM,aAAa,GAAmB;IACpC;QACE,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,SAAS;QAChB,aAAa,EACX,mEAAmE;KACtE;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,EAAE;QACT,aAAa,EAAE,4DAA4D;KAC5E;IACD;QACE,IAAI,EAAE,mCAAmC;QACzC,KAAK,EAAE,MAAM;QACb,aAAa,EACX,gEAAgE;KACnE;IACD;QACE,IAAI,EAAE,2CAA2C;QACjD,KAAK,EAAE,kBAAkB;QACzB,aAAa,EACX,wEAAwE;KAC3E;IACD;QACE,IAAI,EAAE,uCAAuC;QAC7C,KAAK,EAAE,iBAAsB;QAC7B,aAAa,EACX,sEAAsE;KACzE;IACD;QACE,yEAAyE;QACzE,0EAA0E;QAC1E,oDAAoD;QACpD,IAAI,EAAE,uCAAuC;QAC7C,KAAK,EAAE,EAAE,IAAI,GAAG;QAChB,aAAa,EACX,sEAAsE;KACzE;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,GAAG;QACV,aAAa,EAAE,wCAAwC;KACxD;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,SAAS;QAChB,aAAa,EAAE,yCAAyC;KACzD;CACF,CAAC;AAEF,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,EAAE,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE;YAC1B,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;QAC9B,EAAE,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE;YAC3B,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC"}