@wormhole-foundation/sdk-base 0.1.0-beta.3

package/__tests__/finality.ts

@@ -0,0 +1,8 @@
+import { finalityThreshold } from "../src/constants/finality";
+
+describe("Finality tests", function () {
+  const mainnetFinality = finalityThreshold("Mainnet", "Ethereum");
+  it("should correctly access values", function () {
+    expect(mainnetFinality).toEqual(64);
+  });
+});

package/__tests__/layout.ts

@@ -0,0 +1,173 @@
+import { describe, expect, it } from "@jest/globals";
+
+import { Layout, addFixedValues } from "@wormhole-foundation/sdk-base";
+
+const testLayout = [
+  { name: "fixedDirectPrimitive", binary: "uint", size: 1, custom: 3 },
+  {
+    name: "fixedDirectCustom",
+    binary: "uint",
+    size: 1,
+    custom: { to: 42, from: 1 },
+  },
+  { name: "dynamicDirectPrimitive", binary: "uint", size: 1 },
+  {
+    name: "dynamicDirectCustom",
+    binary: "uint",
+    size: 1,
+    custom: { to: (val: number) => val + 1, from: (val: number) => val - 1 },
+  },
+  {
+    name: "someDynamicObject",
+    binary: "object",
+    layout: [
+      { name: "someDynamicBytes", binary: "bytes", size: 4 },
+      { name: "someDynamicLengthBytes", binary: "bytes", lengthSize: 4 },
+    ],
+  },
+  {
+    name: "objectWithOnlyFixed",
+    binary: "object",
+    layout: [
+      {
+        name: "someFixedObjectUint",
+        binary: "uint",
+        size: 1,
+        custom: { to: 13, from: 1 },
+      },
+    ],
+  },
+  {
+    name: "objectWithSomeFixed",
+    binary: "object",
+    layout: [
+      {
+        name: "someFixedBytes",
+        binary: "bytes",
+        custom: { to: new Uint8Array(4), from: new Uint8Array(4) },
+      },
+      {
+        name: "someFixedUint",
+        binary: "uint",
+        size: 1,
+        custom: { to: 33, from: 1 },
+      },
+      { name: "someDynamicUint", binary: "uint", size: 1 },
+    ],
+  },
+  {
+    name: "arrayWithOnlyFixed",
+    binary: "array",
+    lengthSize: 1,
+    layout: [
+      { name: "someFixedArrayUint", binary: "uint", size: 1, custom: 12 },
+    ],
+  },
+  {
+    name: "arrayWithSomeFixed",
+    binary: "array",
+    lengthSize: 1,
+    layout: [
+      { name: "someDynamicUint", binary: "uint", size: 1 },
+      { name: "someFixedUint", binary: "uint", size: 1, custom: 25 },
+      {
+        name: "someFixedBytes",
+        binary: "bytes",
+        custom: { to: new Uint8Array(4), from: new Uint8Array(4) },
+      },
+    ],
+  },
+  {
+    name: "arrayWithOnlyDynamic",
+    binary: "array",
+    lengthSize: 1,
+    layout: [{ name: "someDynamicArrayUint", binary: "uint", size: 1 }],
+  },
+] as const satisfies Layout;
+
+describe("Layout tests", function () {
+  it("should correctly add fixed values", function () {
+    const dynamicValues = {
+      dynamicDirectPrimitive: 2,
+      dynamicDirectCustom: 4,
+      someDynamicObject: {
+        someDynamicBytes: new Uint8Array(4),
+        someDynamicLengthBytes: new Uint8Array(5),
+      },
+      objectWithSomeFixed: { someDynamicUint: 8 },
+      arrayWithSomeFixed: [{ someDynamicUint: 10 }, { someDynamicUint: 11 }],
+      arrayWithOnlyDynamic: [
+        { someDynamicArrayUint: 14 },
+        { someDynamicArrayUint: 16 },
+      ],
+    };
+
+    const complete = addFixedValues(testLayout, dynamicValues);
+    expect(complete).toEqual({
+      fixedDirectPrimitive: 3,
+      fixedDirectCustom: 42,
+      dynamicDirectPrimitive: 2,
+      dynamicDirectCustom: 4,
+      someDynamicObject: {
+        someDynamicBytes: new Uint8Array(4),
+        someDynamicLengthBytes: new Uint8Array(5),
+      },
+      objectWithOnlyFixed: { someFixedObjectUint: 13 },
+      objectWithSomeFixed: {
+        someDynamicUint: 8,
+        someFixedBytes: new Uint8Array(4),
+        someFixedUint: 33,
+      },
+      arrayWithOnlyFixed: [],
+      arrayWithSomeFixed: [
+        {
+          someDynamicUint: 10,
+          someFixedUint: 25,
+          someFixedBytes: new Uint8Array(4),
+        },
+        {
+          someDynamicUint: 11,
+          someFixedUint: 25,
+          someFixedBytes: new Uint8Array(4),
+        },
+      ],
+      arrayWithOnlyDynamic: [
+        { someDynamicArrayUint: 14 },
+        { someDynamicArrayUint: 16 },
+      ],
+    });
+  });
+});
+
+// type FixedItems = FixedItemsOfLayout<typeof testLayout>;
+// type DynamicItems = DynamicItemsOfLayout<typeof testLayout>;
+
+// const testFunc = <L extends Layout>(layout: L, fixedVals: LayoutToType<FixedItemsOfLayout<L>>) => {
+//   return Object.keys(fixedVals).reduce((acc, key) => acc + key, "");
+// }
+
+// const test = testFunc(
+//   testLayout, {
+//     "fixedDirectPrimitive": 3,
+//     "fixedDirectCustom": 42,
+//     "objectWithOnlyFixed": { "someFixedObjectUint": 13 },
+//     "objectWithSomeFixed": {
+//       "someFixedBytes": new Uint8Array(4),
+//       "someFixedUint": 33,
+//     },
+//     "arrayWithOnlyFixed": [
+//       { "someFixedArrayUint": 12 },
+//       { "someFixedArrayUint": 12 },
+//     ],
+//     "arrayWithSomeFixed": [
+//       {
+//         "someFixedUint": 25,
+//         "someFixedBytes": new Uint8Array(4),
+//       },
+//       {
+//         "someFixedUint": 25,
+//         "someFixedBytes": new Uint8Array(4),
+//       },
+//     ]
+//   }
+// );

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@wormhole-foundation/sdk-base",
+  "version": "0.1.0-beta.3",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types":"./dist/esm/index.d.ts",
+  "scripts": {
+    "test": "jest --config ../../jest.config.ts __tests__/*.ts",
+    "build:cjs":"tsc -p ./tsconfig.cjs.json",
+    "build:esm":"tsc -p ./tsconfig.esm.json",
+    "build":"npm run build:cjs && npm run build:esm",
+    "rebuild":"npm run clean && npm run build:cjs && npm run build:esm",
+    "clean": "rm -rf ./dist && rm -f ./*.tsbuildinfo"
+  }
+}

package/src/constants/chains.ts

@@ -0,0 +1,104 @@
+import { zip } from "../utils/array";
+import { constMap } from "../utils/mapping";
+
+//Typescript being the absolute mess that it is has no way to turn the keys of an object that is
+//  declared `as const` into an `as const` array (see:
+//  https://github.com/microsoft/TypeScript/issues/31652), however the other way around works fine,
+//  hence we're defining the mapping via its entry representation and deriving it from taht
+const chainsAndChainIdEntries = [
+  //Unlike the old sdk, we are not including an "Unset" chain with chainId 0 here because:
+  //  * no other types would be associated with it (such as contracts or a platform)
+  //  * avoids awkward "chain but not 'Unset'" checks
+  //  * "off" is not a TV channel either
+  //Instead we'll use `null` for chain and 0 as the chainId where appropriate (e.g. governance VAAs)
+  ["Solana", 1],
+  ["Ethereum", 2],
+  ["Terra", 3],
+  ["Bsc", 4],
+  ["Polygon", 5],
+  ["Avalanche", 6],
+  ["Oasis", 7],
+  ["Algorand", 8],
+  ["Aurora", 9],
+  ["Fantom", 10],
+  ["Karura", 11],
+  ["Acala", 12],
+  ["Klaytn", 13],
+  ["Celo", 14],
+  ["Near", 15],
+  ["Moonbeam", 16],
+  ["Neon", 17],
+  ["Terra2", 18],
+  ["Injective", 19],
+  ["Osmosis", 20],
+  ["Sui", 21],
+  ["Aptos", 22],
+  ["Arbitrum", 23],
+  ["Optimism", 24],
+  ["Gnosis", 25],
+  ["Pythnet", 26],
+  ["Xpla", 28],
+  ["Btc", 29],
+  ["Base", 30],
+  ["Sei", 32],
+  ["Wormchain", 3104],
+  // holy cow, how ugly of a hack is that?! - a chainId that's exclusive to a testnet!
+  ["Sepolia", 10002],
+] as const;
+
+export const [chains, chainIds] = zip(chainsAndChainIdEntries);
+export type ChainName = (typeof chains)[number];
+export type ChainId = (typeof chainIds)[number];
+export type Chain = ChainName | ChainId;
+
+export const chainToChainId = constMap(chainsAndChainIdEntries);
+export const chainIdToChain = constMap(chainsAndChainIdEntries, [1, 0]);
+
+export const isChain = (chain: string): chain is ChainName =>
+  chainToChainId.has(chain);
+export const isChainId = (chainId: number): chainId is ChainId =>
+  chainIdToChain.has(chainId);
+
+export function assertChainId(chainId: number): asserts chainId is ChainId {
+  if (!isChainId(chainId)) throw Error(`Unknown Wormhole chain id: ${chainId}`);
+}
+
+export function assertChain(chain: string): asserts chain is ChainName {
+  if (!isChain(chain)) throw Error(`Unknown Wormhole chain: ${chain}`);
+}
+
+//safe assertion that allows chaining
+export const asChainId = (chainId: number): ChainId => {
+  assertChainId(chainId);
+  return chainId;
+};
+
+export const toChainId = (chain: number | string | Chain): ChainId => {
+  switch (typeof chain) {
+    case "string":
+      if (isChain(chain)) return chainToChainId(chain);
+      break;
+    case "number":
+      if (isChainId(chain)) return chain;
+      break;
+  }
+  throw Error(`Cannot convert to ChainId: ${chain}`);
+};
+
+export const toChainName = (
+  chain: number | string | Chain | bigint
+): ChainName => {
+  switch (typeof chain) {
+    case "string":
+      if (isChain(chain)) return chain;
+      break;
+    case "number":
+      if (isChainId(chain)) return chainIdToChain(chain);
+      break;
+    case "bigint":
+      if (isChainId(Number(chain)))
+        return chainIdToChain(Number(chain) as ChainId);
+      break;
+  }
+  throw Error(`Cannot convert to ChainName: ${chain}`);
+};

package/src/constants/circle.ts

@@ -0,0 +1,119 @@
+import { Network } from "./networks";
+import { Chain, ChainName } from "./chains";
+import { zip, constMap, RoArray } from "../utils";
+
+const circleAPIs = [
+  ["Mainnet", "https://iris-api.circle.com/v1/attestations"],
+  ["Testnet", "https://iris-api-sandbox.circle.com/v1/attestations"],
+] as const satisfies RoArray<readonly [Network, string]>;
+
+// https://developers.circle.com/stablecoin/docs/cctp-technical-reference#domain-list
+const circleDomains = [
+  ["Ethereum", 0],
+  ["Avalanche", 1],
+  ["Optimism", 2],
+  ["Arbitrum", 3],
+] as const satisfies RoArray<readonly [ChainName, number]>;
+
+const usdcContracts = [
+  [
+    "Mainnet",
+    [
+      ["Ethereum", "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"],
+      ["Avalanche", "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e"],
+      ["Arbitrum", "0xaf88d065e77c8cC2239327C5EDb3A432268e5831"],
+      ["Optimism", "0x179522635726710dd7d2035a81d856de4aa7836c"],
+    ],
+  ],
+  [
+    "Testnet",
+    [
+      ["Avalanche", "0x5425890298aed601595a70AB815c96711a31Bc65"],
+      ["Arbitrum", "0xfd064A18f3BF249cf1f87FC203E90D8f650f2d63"],
+      ["Ethereum", "0x07865c6e87b9f70255377e024ace6630c1eaa37f"],
+      ["Optimism", "0xe05606174bac4A6364B31bd0eCA4bf4dD368f8C6"],
+    ],
+  ],
+] as const satisfies RoArray<
+  readonly [Network, RoArray<readonly [ChainName, string]>]
+>;
+
+export const [circleChains, circleChainIds] = zip(circleDomains);
+export type CircleChainName = (typeof circleChains)[number];
+export type CircleChainId = (typeof circleChainIds)[number];
+
+export const [circleNetworks, _] = zip(usdcContracts);
+export type CircleNetwork = (typeof circleNetworks)[number];
+
+export const circleChainId = constMap(circleDomains);
+export const circleChainIdToChainName = constMap(circleDomains, [1, 0]);
+export const circleAPI = constMap(circleAPIs);
+
+export const usdcContract = constMap(usdcContracts);
+
+export const isCircleChain = (
+  chain: string | ChainName | CircleChainName
+): chain is CircleChainName => circleChainId.has(chain);
+
+export const isCircleChainId = (chainId: number): chainId is CircleChainId =>
+  circleChainIdToChainName.has(chainId);
+
+export const isCircleSupported = (
+  network: Network,
+  chain: string | ChainName | CircleChainName
+): network is CircleNetwork => usdcContract.has(network, chain);
+
+export function assertCircleChainId(
+  chainId: number
+): asserts chainId is CircleChainId {
+  if (!isCircleChainId(chainId))
+    throw Error(`Unknown Circle chain id: ${chainId}`);
+}
+
+export function assertCircleChain(
+  chain: string
+): asserts chain is CircleChainName {
+  if (!isCircleChain(chain)) throw Error(`Unknown Circle chain: ${chain}`);
+}
+
+//safe assertion that allows chaining
+export const asCircleChainId = (chainId: number): CircleChainId => {
+  assertCircleChainId(chainId);
+  return chainId;
+};
+
+export const toCircleChainId = (
+  chain: number | bigint | string | Chain
+): CircleChainId => {
+  switch (typeof chain) {
+    case "string":
+      if (isCircleChain(chain)) return circleChainId(chain);
+      break;
+    case "number":
+      if (isCircleChainId(chain)) return chain;
+      break;
+    case "bigint":
+      const ci = Number(chain);
+      if (isCircleChainId(ci)) return ci;
+      break;
+  }
+  throw Error(`Cannot convert to ChainId: ${chain}`);
+};
+
+export const toCircleChainName = (
+  chain: number | string | Chain | bigint
+): ChainName => {
+  switch (typeof chain) {
+    case "string":
+      if (isCircleChain(chain)) return chain;
+      break;
+    case "number":
+      if (isCircleChainId(chain)) return circleChainIdToChainName(chain);
+      break;
+    case "bigint":
+      const cid = Number(chain);
+      if (isCircleChainId(cid)) return circleChainIdToChainName(cid);
+      break;
+  }
+  throw Error(`Cannot convert to ChainName: ${chain}`);
+};

package/src/constants/contracts/circle.ts

@@ -0,0 +1,99 @@
+import { RoArray } from "../../utils";
+import { ChainName } from "../chains";
+import { Network } from "../networks";
+
+export type CircleContracts = {
+  tokenMessenger: string;
+  messageTransmitter: string;
+  wormholeRelayer: string;
+  wormhole: string;
+};
+
+export const circleContracts = [
+  [
+    "Mainnet",
+    [
+      [
+        "Arbitrum",
+        {
+          tokenMessenger: "0x19330d10D9Cc8751218eaf51E8885D058642E08A",
+          messageTransmitter: "0xC30362313FBBA5cf9163F0bb16a0e01f01A896ca",
+          wormholeRelayer: "0x4cb69FaE7e7Af841e44E1A1c30Af640739378bb2",
+          wormhole: "0x2703483b1a5a7c577e8680de9df8be03c6f30e3c",
+        },
+      ],
+
+      [
+        "Avalanche",
+        {
+          tokenMessenger: "0x6b25532e1060ce10cc3b0a99e5683b91bfde6982",
+          messageTransmitter: "0x8186359af5f57fbb40c6b14a588d2a59c0c29880",
+          wormholeRelayer: "0x4cb69FaE7e7Af841e44E1A1c30Af640739378bb2",
+          wormhole: "0x09Fb06A271faFf70A651047395AaEb6265265F13",
+        },
+      ],
+      [
+        "Ethereum",
+        {
+          tokenMessenger: "0xbd3fa81b58ba92a82136038b25adec7066af3155",
+          messageTransmitter: "0x0a992d191deec32afe36203ad87d7d289a738f81",
+          wormholeRelayer: "0x4cb69FaE7e7Af841e44E1A1c30Af640739378bb2",
+          wormhole: "0x09Fb06A271faFf70A651047395AaEb6265265F13",
+        },
+      ],
+      [
+        "Optimism",
+        {
+          tokenMessenger: "0x2B4069517957735bE00ceE0fadAE88a26365528f",
+          messageTransmitter: "0x09Fb06A271faFf70A651047395AaEb6265265F13",
+          wormholeRelayer: "0x4cb69FaE7e7Af841e44E1A1c30Af640739378bb2",
+          wormhole: "0x2703483b1a5a7c577e8680de9df8be03c6f30e3c",
+        },
+      ],
+    ],
+  ],
+
+  [
+    "Testnet",
+    [
+      [
+        "Arbitrum",
+        {
+          tokenMessenger: "0x12dcfd3fe2e9eac2859fd1ed86d2ab8c5a2f9352",
+          messageTransmitter: "0x109bc137cb64eab7c0b1dddd1edf341467dc2d35",
+          wormholeRelayer: "0xbf683d541e11320418ca78ec13309938e6c5922f",
+          wormhole: "0x2e8f5e00a9c5d450a72700546b89e2b70dfb00f2",
+        },
+      ],
+      [
+        "Avalanche",
+        {
+          tokenMessenger: "0xeb08f243e5d3fcff26a9e38ae5520a669f4019d0",
+          messageTransmitter: "0xa9fb1b3009dcb79e2fe346c16a604b8fa8ae0a79",
+          wormholeRelayer: "0x774a70bbd03327c21460b60f25b677d9e46ab458",
+          wormhole: "0x58f4c17449c90665891c42e14d34aae7a26a472e",
+        },
+      ],
+      [
+        "Ethereum",
+        {
+          tokenMessenger: "0xd0c3da58f55358142b8d3e06c1c30c5c6114efe8",
+          messageTransmitter: "0x26413e8157cd32011e726065a5462e97dd4d03d9",
+          wormholeRelayer: "0x17da1ff5386d044c63f00747b5b8ad1e3806448d",
+          wormhole: "0x0a69146716b3a21622287efa1607424c663069a4",
+        },
+      ],
+      [
+        "Optimism",
+        {
+          tokenMessenger: "0x23a04d5935ed8bc8e3eb78db3541f0abfb001c6e",
+          messageTransmitter: "0x9ff9a4da6f2157a9c82ce756f8fd7e0d75be8895",
+          wormholeRelayer: "0x4cb69FaE7e7Af841e44E1A1c30Af640739378bb2",
+          wormhole: "0x2703483b1a5a7c577e8680de9df8be03c6f30e3c",
+        },
+      ],
+    ],
+  ],
+] as const satisfies RoArray<
+  readonly [Network, RoArray<readonly [ChainName, CircleContracts]>]
+>;

package/src/constants/contracts/core.ts

@@ -0,0 +1,125 @@
+import { Network } from "../networks";
+import { ChainName } from "../chains";
+import { RoArray } from "../../utils";
+
+export const coreBridgeContracts = [
+  [
+    "Mainnet",
+    [
+      ["Solana", "worm2ZoG2kUd4vFXhvjh93UUH596ayRfgQ2MgjNMTth"],
+      ["Ethereum", "0x98f3c9e6E3fAce36bAAd05FE09d375Ef1464288B"],
+      ["Terra", "terra1dq03ugtd40zu9hcgdzrsq6z2z4hwhc9tqk2uy5"],
+      ["Bsc", "0x98f3c9e6E3fAce36bAAd05FE09d375Ef1464288B"],
+      ["Polygon", "0x7A4B5a56256163F07b2C80A7cA55aBE66c4ec4d7"],
+      ["Avalanche", "0x54a8e5f9c4CbA08F9943965859F6c34eAF03E26c"],
+      ["Oasis", "0xfE8cD454b4A1CA468B57D79c0cc77Ef5B6f64585"],
+      ["Algorand", "842125965"],
+      ["Aurora", "0xa321448d90d4e5b0A732867c18eA198e75CAC48E"],
+      ["Fantom", "0x126783A6Cb203a3E35344528B26ca3a0489a1485"],
+      ["Karura", "0xa321448d90d4e5b0A732867c18eA198e75CAC48E"],
+      ["Acala", "0xa321448d90d4e5b0A732867c18eA198e75CAC48E"],
+      ["Klaytn", "0x0C21603c4f3a6387e241c0091A7EA39E43E90bb7"],
+      ["Celo", "0xa321448d90d4e5b0A732867c18eA198e75CAC48E"],
+      ["Near", "contract.wormhole_crypto.near"],
+      ["Injective", "inj17p9rzwnnfxcjp32un9ug7yhhzgtkhvl9l2q74d"],
+      [
+        "Aptos",
+        "0x5bc11445584a763c1fa7ed39081f1b920954da14e04b32440cba863d03e19625",
+      ],
+      [
+        "Sui",
+        "0xaeab97f96cf9877fee2883315d459552b2b921edc16d7ceac6eab944dd88919c",
+      ],
+      ["Moonbeam", "0xC8e2b0cD52Cf01b0Ce87d389Daa3d414d4cE29f3"],
+      [
+        "Terra2",
+        "terra12mrnzvhx3rpej6843uge2yyfppfyd3u9c3uq223q8sl48huz9juqffcnhp",
+      ],
+      ["Arbitrum", "0xa5f208e072434bC67592E4C49C1B991BA79BCA46"],
+      ["Optimism", "0xEe91C335eab126dF5fDB3797EA9d6aD93aeC9722"],
+      ["Gnosis", "0xa321448d90d4e5b0A732867c18eA198e75CAC48E"],
+      ["Pythnet", "H3fxXJ86ADW2PNuDDmZJg6mzTtPxkYCpNuQUTgmJ7AjU"],
+      [
+        "Xpla",
+        "xpla1jn8qmdda5m6f6fqu9qv46rt7ajhklg40ukpqchkejcvy8x7w26cqxamv3w",
+      ],
+      ["Sei", "sei1gjrrme22cyha4ht2xapn3f08zzw6z3d4uxx6fyy9zd5dyr3yxgzqqncdqn"],
+    ],
+  ],
+  [
+    "Testnet",
+    [
+      ["Solana", "3u8hJUVTA4jH1wYAyUur7FFZVQ8H635K3tSHHF4ssjQ5"],
+      ["Ethereum", "0x706abc4E45D419950511e474C7B9Ed348A4a716c"],
+      ["Terra", "terra1pd65m0q9tl3v8znnz5f5ltsfegyzah7g42cx5v"],
+      ["Bsc", "0x68605AD7b15c732a30b1BbC62BE8F2A509D74b4D"],
+      ["Polygon", "0x0CBE91CF822c73C2315FB05100C2F714765d5c20"],
+      ["Avalanche", "0x7bbcE28e64B3F8b84d876Ab298393c38ad7aac4C"],
+      ["Oasis", "0xc1C338397ffA53a2Eb12A7038b4eeb34791F8aCb"],
+      ["Algorand", "86525623"],
+      ["Aurora", "0xBd07292de7b505a4E803CEe286184f7Acf908F5e"],
+      ["Fantom", "0x1BB3B4119b7BA9dfad76B0545fb3F531383c3bB7"],
+      ["Karura", "0xE4eacc10990ba3308DdCC72d985f2a27D20c7d03"],
+      ["Acala", "0x4377B49d559c0a9466477195C6AdC3D433e265c0"],
+      ["Klaytn", "0x1830CC6eE66c84D2F177B94D544967c774E624cA"],
+      ["Celo", "0x88505117CA88e7dd2eC6EA1E13f0948db2D50D56"],
+      ["Near", "wormhole.wormhole.Testnet"],
+      ["Injective", "inj1xx3aupmgv3ce537c0yce8zzd3sz567syuyedpg"],
+      [
+        "Osmosis",
+        "osmo1hggkxr0hpw83f8vuft7ruvmmamsxmwk2hzz6nytdkzyup9krt0dq27sgyx",
+      ],
+      [
+        "Aptos",
+        "0x5bc11445584a763c1fa7ed39081f1b920954da14e04b32440cba863d03e19625",
+      ],
+      [
+        "Sui",
+        "0x31358d198147da50db32eda2562951d53973a0c0ad5ed738e9b17d88b213d790",
+      ],
+      ["Moonbeam", "0xa5B7D85a8f27dd7907dc8FdC21FA5657D5E2F901"],
+      ["Neon", "0x268557122Ffd64c85750d630b716471118F323c8"],
+      [
+        "Terra2",
+        "terra19nv3xr5lrmmr7egvrk2kqgw4kcn43xrtd5g0mpgwwvhetusk4k7s66jyv0",
+      ],
+      ["Arbitrum", "0xC7A204bDBFe983FCD8d8E61D02b475D4073fF97e"],
+      ["Optimism", "0x6b9C8671cdDC8dEab9c719bB87cBd3e782bA6a35"],
+      ["Gnosis", "0xE4eacc10990ba3308DdCC72d985f2a27D20c7d03"],
+      ["Pythnet", "EUrRARh92Cdc54xrDn6qzaqjA77NRrCcfbr8kPwoTL4z"],
+      [
+        "Xpla",
+        "xpla1upkjn4mthr0047kahvn0llqx4qpqfn75lnph4jpxfn8walmm8mqsanyy35",
+      ],
+      ["Base", "0x23908A62110e21C04F3A4e011d24F901F911744A"],
+      ["Sei", "sei1nna9mzp274djrgzhzkac2gvm3j27l402s4xzr08chq57pjsupqnqaj0d5s"],
+      ["Sepolia", "0x4a8bc80Ed5a4067f1CCf107057b8270E0cC11A78"],
+    ],
+  ],
+  [
+    "Devnet",
+    [
+      ["Solana", "Bridge1p5gheXUvJ6jGWGeCsgPKgnE3YgdGKRVCMY9o"],
+      ["Ethereum", "0xC89Ce4735882C9F0f0FE26686c53074E09B0D550"],
+      ["Terra", "terra18vd8fpwxzck93qlwghaj6arh4p7c5n896xzem5"],
+      ["Bsc", "0xC89Ce4735882C9F0f0FE26686c53074E09B0D550"],
+      ["Algorand", "4"],
+      ["Near", "wormhole.test.near"],
+      [
+        "Aptos",
+        "0xde0036a9600559e295d5f6802ef6f3f802f510366e0c23912b0655d972166017",
+      ],
+      [
+        "Sui",
+        "0x5a5160ca3c2037f4b4051344096ef7a48ebf4400b3f385e57ea90e1628a8bde0",
+      ],
+      [
+        "Terra2",
+        "terra14hj2tavq8fpesdwxxcu44rty3hh90vhujrvcmstl4zr3txmfvw9ssrc8au",
+      ],
+      ["Wormchain", "wormhole1ap5vgur5zlgys8whugfegnn43emka567dtq0jl"],
+    ],
+  ],
+] as const satisfies RoArray<
+  readonly [Network, RoArray<readonly [ChainName, string]>]
+>;

package/src/constants/contracts/index.ts

@@ -0,0 +1,15 @@
+import * as core from "./core";
+import * as tb from "./tokenBridge";
+import * as nb from "./nftBridge";
+import * as r from "./relayer";
+import * as circle from "./circle";
+
+import { constMap } from "../../utils";
+
+export const coreBridge = constMap(core.coreBridgeContracts);
+export const tokenBridge = constMap(tb.tokenBridgeContracts);
+export const nftBridge = constMap(nb.nftBridgeContracts);
+export const relayer = constMap(r.relayerContracts);
+
+export { CircleContracts } from "./circle";
+export const circleContracts = constMap(circle.circleContracts);