@townsq/mm-sdk 1.0.1

package/src/chains/evm/common/constant/abi/wormhole-relayer-abi.ts

@@ -0,0 +1,500 @@
+export const IWormholeRelayerAbi = [
+  {
+    anonymous: false,
+    inputs: [
+      {
+        indexed: true,
+        internalType: "address",
+        name: "recipientContract",
+        type: "address",
+      },
+      {
+        indexed: true,
+        internalType: "uint16",
+        name: "sourceChain",
+        type: "uint16",
+      },
+      {
+        indexed: true,
+        internalType: "uint64",
+        name: "sequence",
+        type: "uint64",
+      },
+      {
+        indexed: false,
+        internalType: "bytes32",
+        name: "deliveryVaaHash",
+        type: "bytes32",
+      },
+      {
+        indexed: false,
+        internalType: "enum IWormholeRelayerDelivery.DeliveryStatus",
+        name: "status",
+        type: "uint8",
+      },
+      {
+        indexed: false,
+        internalType: "uint256",
+        name: "gasUsed",
+        type: "uint256",
+      },
+      {
+        indexed: false,
+        internalType: "enum IWormholeRelayerDelivery.RefundStatus",
+        name: "refundStatus",
+        type: "uint8",
+      },
+      {
+        indexed: false,
+        internalType: "bytes",
+        name: "additionalStatusInfo",
+        type: "bytes",
+      },
+      {
+        indexed: false,
+        internalType: "bytes",
+        name: "overridesInfo",
+        type: "bytes",
+      },
+    ],
+    name: "Delivery",
+    type: "event",
+  },
+  {
+    anonymous: false,
+    inputs: [
+      {
+        indexed: true,
+        internalType: "uint64",
+        name: "sequence",
+        type: "uint64",
+      },
+      {
+        indexed: false,
+        internalType: "uint256",
+        name: "deliveryQuote",
+        type: "uint256",
+      },
+      {
+        indexed: false,
+        internalType: "uint256",
+        name: "paymentForExtraReceiverValue",
+        type: "uint256",
+      },
+    ],
+    name: "SendEvent",
+    type: "event",
+  },
+  {
+    inputs: [
+      { internalType: "bytes[]", name: "encodedVMs", type: "bytes[]" },
+      { internalType: "bytes", name: "encodedDeliveryVAA", type: "bytes" },
+      {
+        internalType: "address payable",
+        name: "relayerRefundAddress",
+        type: "address",
+      },
+      { internalType: "bytes", name: "deliveryOverrides", type: "bytes" },
+    ],
+    name: "deliver",
+    outputs: [],
+    stateMutability: "payable",
+    type: "function",
+  },
+  {
+    inputs: [{ internalType: "bytes32", name: "deliveryHash", type: "bytes32" }],
+    name: "deliveryAttempted",
+    outputs: [{ internalType: "bool", name: "attempted", type: "bool" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [{ internalType: "bytes32", name: "deliveryHash", type: "bytes32" }],
+    name: "deliveryFailureBlock",
+    outputs: [{ internalType: "uint256", name: "blockNumber", type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [{ internalType: "bytes32", name: "deliveryHash", type: "bytes32" }],
+    name: "deliverySuccessBlock",
+    outputs: [{ internalType: "uint256", name: "blockNumber", type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "getDefaultDeliveryProvider",
+    outputs: [{ internalType: "address", name: "deliveryProvider", type: "address" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [{ internalType: "uint16", name: "chainId", type: "uint16" }],
+    name: "getRegisteredWormholeRelayerContract",
+    outputs: [{ internalType: "bytes32", name: "", type: "bytes32" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "uint16", name: "targetChain", type: "uint16" },
+      { internalType: "uint256", name: "receiverValue", type: "uint256" },
+      {
+        internalType: "bytes",
+        name: "encodedExecutionParameters",
+        type: "bytes",
+      },
+      {
+        internalType: "address",
+        name: "deliveryProviderAddress",
+        type: "address",
+      },
+    ],
+    name: "quoteDeliveryPrice",
+    outputs: [
+      { internalType: "uint256", name: "nativePriceQuote", type: "uint256" },
+      { internalType: "bytes", name: "encodedExecutionInfo", type: "bytes" },
+    ],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "uint16", name: "targetChain", type: "uint16" },
+      { internalType: "uint256", name: "receiverValue", type: "uint256" },
+      { internalType: "uint256", name: "gasLimit", type: "uint256" },
+      {
+        internalType: "address",
+        name: "deliveryProviderAddress",
+        type: "address",
+      },
+    ],
+    name: "quoteEVMDeliveryPrice",
+    outputs: [
+      { internalType: "uint256", name: "nativePriceQuote", type: "uint256" },
+      {
+        internalType: "uint256",
+        name: "targetChainRefundPerGasUnused",
+        type: "uint256",
+      },
+    ],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "uint16", name: "targetChain", type: "uint16" },
+      { internalType: "uint256", name: "receiverValue", type: "uint256" },
+      { internalType: "uint256", name: "gasLimit", type: "uint256" },
+    ],
+    name: "quoteEVMDeliveryPrice",
+    outputs: [
+      { internalType: "uint256", name: "nativePriceQuote", type: "uint256" },
+      {
+        internalType: "uint256",
+        name: "targetChainRefundPerGasUnused",
+        type: "uint256",
+      },
+    ],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "uint16", name: "targetChain", type: "uint16" },
+      { internalType: "uint256", name: "currentChainAmount", type: "uint256" },
+      {
+        internalType: "address",
+        name: "deliveryProviderAddress",
+        type: "address",
+      },
+    ],
+    name: "quoteNativeForChain",
+    outputs: [{ internalType: "uint256", name: "targetChainAmount", type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        components: [
+          { internalType: "uint16", name: "chainId", type: "uint16" },
+          { internalType: "bytes32", name: "emitterAddress", type: "bytes32" },
+          { internalType: "uint64", name: "sequence", type: "uint64" },
+        ],
+        internalType: "struct VaaKey",
+        name: "deliveryVaaKey",
+        type: "tuple",
+      },
+      { internalType: "uint16", name: "targetChain", type: "uint16" },
+      { internalType: "uint256", name: "newReceiverValue", type: "uint256" },
+      {
+        internalType: "bytes",
+        name: "newEncodedExecutionParameters",
+        type: "bytes",
+      },
+      {
+        internalType: "address",
+        name: "newDeliveryProviderAddress",
+        type: "address",
+      },
+    ],
+    name: "resend",
+    outputs: [{ internalType: "uint64", name: "sequence", type: "uint64" }],
+    stateMutability: "payable",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        components: [
+          { internalType: "uint16", name: "chainId", type: "uint16" },
+          { internalType: "bytes32", name: "emitterAddress", type: "bytes32" },
+          { internalType: "uint64", name: "sequence", type: "uint64" },
+        ],
+        internalType: "struct VaaKey",
+        name: "deliveryVaaKey",
+        type: "tuple",
+      },
+      { internalType: "uint16", name: "targetChain", type: "uint16" },
+      { internalType: "uint256", name: "newReceiverValue", type: "uint256" },
+      { internalType: "uint256", name: "newGasLimit", type: "uint256" },
+      {
+        internalType: "address",
+        name: "newDeliveryProviderAddress",
+        type: "address",
+      },
+    ],
+    name: "resendToEvm",
+    outputs: [{ internalType: "uint64", name: "sequence", type: "uint64" }],
+    stateMutability: "payable",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "uint16", name: "targetChain", type: "uint16" },
+      { internalType: "bytes32", name: "targetAddress", type: "bytes32" },
+      { internalType: "bytes", name: "payload", type: "bytes" },
+      { internalType: "uint256", name: "receiverValue", type: "uint256" },
+      {
+        internalType: "uint256",
+        name: "paymentForExtraReceiverValue",
+        type: "uint256",
+      },
+      {
+        internalType: "bytes",
+        name: "encodedExecutionParameters",
+        type: "bytes",
+      },
+      { internalType: "uint16", name: "refundChain", type: "uint16" },
+      { internalType: "bytes32", name: "refundAddress", type: "bytes32" },
+      {
+        internalType: "address",
+        name: "deliveryProviderAddress",
+        type: "address",
+      },
+      {
+        components: [
+          { internalType: "uint16", name: "chainId", type: "uint16" },
+          { internalType: "bytes32", name: "emitterAddress", type: "bytes32" },
+          { internalType: "uint64", name: "sequence", type: "uint64" },
+        ],
+        internalType: "struct VaaKey[]",
+        name: "vaaKeys",
+        type: "tuple[]",
+      },
+      { internalType: "uint8", name: "consistencyLevel", type: "uint8" },
+    ],
+    name: "send",
+    outputs: [{ internalType: "uint64", name: "sequence", type: "uint64" }],
+    stateMutability: "payable",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "uint16", name: "targetChain", type: "uint16" },
+      { internalType: "bytes32", name: "targetAddress", type: "bytes32" },
+      { internalType: "bytes", name: "payload", type: "bytes" },
+      { internalType: "uint256", name: "receiverValue", type: "uint256" },
+      {
+        internalType: "uint256",
+        name: "paymentForExtraReceiverValue",
+        type: "uint256",
+      },
+      {
+        internalType: "bytes",
+        name: "encodedExecutionParameters",
+        type: "bytes",
+      },
+      { internalType: "uint16", name: "refundChain", type: "uint16" },
+      { internalType: "bytes32", name: "refundAddress", type: "bytes32" },
+      {
+        internalType: "address",
+        name: "deliveryProviderAddress",
+        type: "address",
+      },
+      {
+        components: [
+          { internalType: "uint8", name: "keyType", type: "uint8" },
+          { internalType: "bytes", name: "encodedKey", type: "bytes" },
+        ],
+        internalType: "struct MessageKey[]",
+        name: "messageKeys",
+        type: "tuple[]",
+      },
+      { internalType: "uint8", name: "consistencyLevel", type: "uint8" },
+    ],
+    name: "send",
+    outputs: [{ internalType: "uint64", name: "sequence", type: "uint64" }],
+    stateMutability: "payable",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "uint16", name: "targetChain", type: "uint16" },
+      { internalType: "address", name: "targetAddress", type: "address" },
+      { internalType: "bytes", name: "payload", type: "bytes" },
+      { internalType: "uint256", name: "receiverValue", type: "uint256" },
+      { internalType: "uint256", name: "gasLimit", type: "uint256" },
+      { internalType: "uint16", name: "refundChain", type: "uint16" },
+      { internalType: "address", name: "refundAddress", type: "address" },
+    ],
+    name: "sendPayloadToEvm",
+    outputs: [{ internalType: "uint64", name: "sequence", type: "uint64" }],
+    stateMutability: "payable",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "uint16", name: "targetChain", type: "uint16" },
+      { internalType: "address", name: "targetAddress", type: "address" },
+      { internalType: "bytes", name: "payload", type: "bytes" },
+      { internalType: "uint256", name: "receiverValue", type: "uint256" },
+      { internalType: "uint256", name: "gasLimit", type: "uint256" },
+    ],
+    name: "sendPayloadToEvm",
+    outputs: [{ internalType: "uint64", name: "sequence", type: "uint64" }],
+    stateMutability: "payable",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "uint16", name: "targetChain", type: "uint16" },
+      { internalType: "address", name: "targetAddress", type: "address" },
+      { internalType: "bytes", name: "payload", type: "bytes" },
+      { internalType: "uint256", name: "receiverValue", type: "uint256" },
+      {
+        internalType: "uint256",
+        name: "paymentForExtraReceiverValue",
+        type: "uint256",
+      },
+      { internalType: "uint256", name: "gasLimit", type: "uint256" },
+      { internalType: "uint16", name: "refundChain", type: "uint16" },
+      { internalType: "address", name: "refundAddress", type: "address" },
+      {
+        internalType: "address",
+        name: "deliveryProviderAddress",
+        type: "address",
+      },
+      {
+        components: [
+          { internalType: "uint16", name: "chainId", type: "uint16" },
+          { internalType: "bytes32", name: "emitterAddress", type: "bytes32" },
+          { internalType: "uint64", name: "sequence", type: "uint64" },
+        ],
+        internalType: "struct VaaKey[]",
+        name: "vaaKeys",
+        type: "tuple[]",
+      },
+      { internalType: "uint8", name: "consistencyLevel", type: "uint8" },
+    ],
+    name: "sendToEvm",
+    outputs: [{ internalType: "uint64", name: "sequence", type: "uint64" }],
+    stateMutability: "payable",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "uint16", name: "targetChain", type: "uint16" },
+      { internalType: "address", name: "targetAddress", type: "address" },
+      { internalType: "bytes", name: "payload", type: "bytes" },
+      { internalType: "uint256", name: "receiverValue", type: "uint256" },
+      {
+        internalType: "uint256",
+        name: "paymentForExtraReceiverValue",
+        type: "uint256",
+      },
+      { internalType: "uint256", name: "gasLimit", type: "uint256" },
+      { internalType: "uint16", name: "refundChain", type: "uint16" },
+      { internalType: "address", name: "refundAddress", type: "address" },
+      {
+        internalType: "address",
+        name: "deliveryProviderAddress",
+        type: "address",
+      },
+      {
+        components: [
+          { internalType: "uint8", name: "keyType", type: "uint8" },
+          { internalType: "bytes", name: "encodedKey", type: "bytes" },
+        ],
+        internalType: "struct MessageKey[]",
+        name: "messageKeys",
+        type: "tuple[]",
+      },
+      { internalType: "uint8", name: "consistencyLevel", type: "uint8" },
+    ],
+    name: "sendToEvm",
+    outputs: [{ internalType: "uint64", name: "sequence", type: "uint64" }],
+    stateMutability: "payable",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "uint16", name: "targetChain", type: "uint16" },
+      { internalType: "address", name: "targetAddress", type: "address" },
+      { internalType: "bytes", name: "payload", type: "bytes" },
+      { internalType: "uint256", name: "receiverValue", type: "uint256" },
+      { internalType: "uint256", name: "gasLimit", type: "uint256" },
+      {
+        components: [
+          { internalType: "uint16", name: "chainId", type: "uint16" },
+          { internalType: "bytes32", name: "emitterAddress", type: "bytes32" },
+          { internalType: "uint64", name: "sequence", type: "uint64" },
+        ],
+        internalType: "struct VaaKey[]",
+        name: "vaaKeys",
+        type: "tuple[]",
+      },
+    ],
+    name: "sendVaasToEvm",
+    outputs: [{ internalType: "uint64", name: "sequence", type: "uint64" }],
+    stateMutability: "payable",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "uint16", name: "targetChain", type: "uint16" },
+      { internalType: "address", name: "targetAddress", type: "address" },
+      { internalType: "bytes", name: "payload", type: "bytes" },
+      { internalType: "uint256", name: "receiverValue", type: "uint256" },
+      { internalType: "uint256", name: "gasLimit", type: "uint256" },
+      {
+        components: [
+          { internalType: "uint16", name: "chainId", type: "uint16" },
+          { internalType: "bytes32", name: "emitterAddress", type: "bytes32" },
+          { internalType: "uint64", name: "sequence", type: "uint64" },
+        ],
+        internalType: "struct VaaKey[]",
+        name: "vaaKeys",
+        type: "tuple[]",
+      },
+      { internalType: "uint16", name: "refundChain", type: "uint16" },
+      { internalType: "address", name: "refundAddress", type: "address" },
+    ],
+    name: "sendVaasToEvm",
+    outputs: [{ internalType: "uint64", name: "sequence", type: "uint64" }],
+    stateMutability: "payable",
+    type: "function",
+  },
+] as const;

package/src/chains/evm/common/constant/chain.ts

@@ -0,0 +1,88 @@
+import {
+  arbitrum,
+  arbitrumSepolia,
+  avalanche,
+  avalancheFuji,
+  base,
+  baseSepolia,
+  bsc,
+  bscTestnet,
+  mainnet,
+  polygon,
+  sepolia,
+} from 'viem/chains';
+
+import type { EvmChainName, EvmTsChainId } from '../types/chain.js';
+import type { Chain } from 'viem';
+import { defineChain } from 'viem';
+export const monadMainnet = /*#__PURE__*/ defineChain({
+  id: 143,
+  name: 'Monad',
+  nativeCurrency: {
+    name: 'Mainnet MON Token',
+    symbol: 'MON',
+    decimals: 18,
+  },
+  rpcUrls: {
+    default: {
+      http: [
+        'https://rpc-mainnet.monadinfra.com/rpc/4TvOS5nC96kJ0ruECksFYLGchPAELyf2',
+      ],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Monad Testnet explorer',
+      url: 'https://mainnet-beta.monvision.io',
+    },
+  },
+
+  contracts: {
+    multicall3: {
+      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+      blockCreated: 9248132,
+    },
+  },
+  testnet: false,
+});
+
+export const MAINNET_EVM_CHAIN_NAMES = [] as const;
+export const TESTNET_EVM_CHAIN_NAMES = ['MONAD_TESTNET'] as const;
+export const EVM_CHAIN_NAMES = [
+  ...MAINNET_EVM_CHAIN_NAMES,
+  ...TESTNET_EVM_CHAIN_NAMES,
+] as const;
+
+export const MAINNET_EVM_CHAIN_ID = {
+  MONAD: monadMainnet.id,
+} as const;
+
+export const EVM_CHAIN_ID = {
+  ...MAINNET_EVM_CHAIN_ID,
+} as const;
+
+export const MAINNET_EVM_TS_CHAIN_ID = {
+  MONAD: 143,
+} as const;
+
+export const TESTNET_EVM_TS_CHAIN_ID = {} as const;
+
+export const EVM_TS_CHAIN_ID = {
+  ...MAINNET_EVM_TS_CHAIN_ID,
+} as const;
+
+export const MAINNET_CHAIN_VIEM = {
+  [EVM_TS_CHAIN_ID.MONAD]: monadMainnet,
+} as const;
+
+export const CHAIN_VIEM = {
+  ...MAINNET_CHAIN_VIEM,
+} as const satisfies Record<EvmTsChainId, Chain>;
+
+export const MAINNET_CHAIN_NODE = {
+  [EVM_TS_CHAIN_ID.MONAD]: [...monadMainnet.rpcUrls.default.http],
+};
+
+export const CHAIN_NODE = {
+  ...MAINNET_CHAIN_NODE,
+} as const satisfies Record<EvmTsChainId, Array<string>>;

package/src/chains/evm/common/constant/contract.ts

@@ -0,0 +1,15 @@
+import type { EventParams } from '../types/contract.js';
+
+export const defaultEventParams: EventParams = {
+  fromBlock: 'earliest',
+  toBlock: 'latest',
+  strict: true,
+};
+
+export const GAS_LIMIT_ESTIMATE_INCREASE = 10_000n;
+export const SEND_TOKEN_ACTION_RETURN_GAS_LIMIT = 500_000n;
+export const RECEIVER_VALUE_SLIPPAGE = 0.01;
+export const RETRY_REVERSE_GAS_LIMIT_SLIPPAGE = 0.05;
+export const UPDATE_USER_POINTS_IN_LOANS_GAS_LIMIT_SLIPPAGE = 0.1;
+export const UPDATE_ACCOUNT_POINTS_FOR_REWARDS_GAS_LIMIT_SLIPPAGE = 0.01;
+export const CLAIM_REWARDS_GAS_LIMIT_SLIPPAGE = 0;

package/src/chains/evm/common/constant/tokens.ts

@@ -0,0 +1,33 @@
+import { MAINNET_TS_TOKEN_ID } from '../../../../common/types/token.js';
+
+import { EVM_TS_CHAIN_ID } from './chain.js';
+
+import type { TSTokenId as LendingTokenId } from '../../../../common/types/token.js';
+import type { EvmTsChainId } from '../types/chain.js';
+import type { Erc20ContractSlot } from '../types/token.js';
+
+export const CONTRACT_SLOT: Partial<
+  Record<
+    EvmTsChainId,
+    {
+      erc20: Partial<Record<LendingTokenId, Erc20ContractSlot>>;
+    }
+  >
+> = {
+  [EVM_TS_CHAIN_ID.MONAD]: {
+    erc20: {
+      [MAINNET_TS_TOKEN_ID.MON]: {
+        balanceOf: 9n,
+        allowance: 10n,
+      },
+      [MAINNET_TS_TOKEN_ID.wMON]: {
+        balanceOf: 9n,
+        allowance: 10n,
+      },
+      [MAINNET_TS_TOKEN_ID.USDC]: {
+        balanceOf: 9n,
+        allowance: 10n,
+      },
+    },
+  },
+} as const;

package/src/chains/evm/common/types/chain.ts

@@ -0,0 +1,26 @@
+import type {
+  EVM_CHAIN_ID,
+  MAINNET_EVM_CHAIN_ID,
+  EVM_CHAIN_NAMES,
+  MAINNET_EVM_CHAIN_NAMES,
+  TESTNET_EVM_CHAIN_NAMES,
+  EVM_TS_CHAIN_ID,
+  MAINNET_EVM_TS_CHAIN_ID,
+  TESTNET_EVM_TS_CHAIN_ID,
+} from '../constant/chain.js';
+
+export type MainnetEvmChainName = (typeof MAINNET_EVM_CHAIN_NAMES)[number];
+export type TestnetEvmChainName = (typeof TESTNET_EVM_CHAIN_NAMES)[number];
+export type EvmChainName = (typeof EVM_CHAIN_NAMES)[number];
+
+export type MainnetEvmChainId =
+  (typeof MAINNET_EVM_CHAIN_ID)[keyof typeof MAINNET_EVM_CHAIN_ID];
+
+export type EvmChainId = (typeof EVM_CHAIN_ID)[keyof typeof EVM_CHAIN_ID];
+
+export type MainnetEvmTsChainId =
+  (typeof MAINNET_EVM_TS_CHAIN_ID)[keyof typeof MAINNET_EVM_TS_CHAIN_ID];
+export type TestnetEvmTsChainId =
+  (typeof TESTNET_EVM_TS_CHAIN_ID)[keyof typeof TESTNET_EVM_TS_CHAIN_ID];
+export type EvmTsChainId =
+  (typeof EVM_TS_CHAIN_ID)[keyof typeof EVM_TS_CHAIN_ID];

package/src/chains/evm/common/types/contract.ts

@@ -0,0 +1,17 @@
+import type {
+  Abi,
+  GetContractReturnType,
+  Client,
+  GetContractEventsParameters,
+} from 'viem';
+
+type OmitWrite<T> = Omit<T, 'write'>;
+export type GetReadContractReturnType<TAbi extends Abi> = OmitWrite<
+  GetContractReturnType<TAbi, Client>
+>;
+
+export type EventParams = Pick<
+  GetContractEventsParameters,
+  'strict' | 'fromBlock' | 'toBlock'
+>;
+export type GetEventParams = { eventParams: EventParams };