@usdu-core/usdu-core 0.0.1

package/exports/index.ts

@@ -0,0 +1,61 @@
+// helpers
+export * from '../helper/wallet';
+
+// address config and types
+export * from './address.config';
+export * from './address.types';
+
+// curve abis
+export * from './abis/curve/CurveAdapterV1';
+export * from './abis/curve/CurveAdapterV1_1';
+export * from './abis/curve/CurveAdapterV1_2';
+export * from './abis/curve/helper/ICurveStableSwapNG';
+
+// morpho abis
+export * from './abis/morpho/MorphoAdapterV1';
+export * from './abis/morpho/MorphoAdapterV1_1';
+export * from './abis/morpho/MorphoAdapterV1_2';
+export * from './abis/morpho/helper/AggregatorV3Interface';
+export * from './abis/morpho/helper/IMetaMorphoV1_1';
+export * from './abis/morpho/helper/IMetaMorphoV1_1Base';
+export * from './abis/morpho/helper/IMetaMorphoV1_1StaticTyping';
+export * from './abis/morpho/helper/IMorpho';
+export * from './abis/morpho/helper/IMorphoBase';
+export * from './abis/morpho/helper/IMorphoChainlinkOracleV2';
+export * from './abis/morpho/helper/IMorphoChainlinkOracleV2Factory';
+export * from './abis/morpho/helper/IMorphoFlashLoanCallback';
+export * from './abis/morpho/helper/IMorphoLiquidateCallback';
+export * from './abis/morpho/helper/IMorphoRepayCallback';
+export * from './abis/morpho/helper/IMorphoStaticTyping';
+export * from './abis/morpho/helper/IMorphoSupplyCallback';
+export * from './abis/morpho/helper/IMorphoSupplyCollateralCallback';
+export * from './abis/morpho/helper/IMulticall';
+export * from './abis/morpho/helper/IOracle';
+export * from './abis/morpho/helper/IOwnable';
+export * from './abis/morpho/helper/MorphoChainlinkOracleV2';
+
+// openzeppelin abis
+export * from './abis/openzeppelin/ERC20';
+export * from './abis/openzeppelin/ERC20Permit';
+export * from './abis/openzeppelin/IERC20';
+export * from './abis/openzeppelin/IERC20Metadata';
+export * from './abis/openzeppelin/IERC20Permit';
+export * from './abis/openzeppelin/IERC4626';
+
+// reward abis
+export * from './abis/reward/RewardDistributionV1';
+
+// stablecoin abis
+export * from './abis/stablecoin/ErrorsLib';
+export * from './abis/stablecoin/EventsLib';
+export * from './abis/stablecoin/IStablecoin';
+export * from './abis/stablecoin/IStablecoinMetadata';
+export * from './abis/stablecoin/IStablecoinModifier';
+export * from './abis/stablecoin/Stablecoin';
+
+// termmax abis
+export * from './abis/termmax/ITermMaxVault';
+
+// vault abis
+export * from './abis/vault/VaultAdapterRecoverV1';
+export * from './abis/vault/VaultAdapterV1';

package/hardhat.config.ts

@@ -0,0 +1,231 @@
+import '@nomicfoundation/hardhat-ethers';
+import '@nomicfoundation/hardhat-verify';
+import '@nomicfoundation/hardhat-toolbox';
+import '@nomicfoundation/hardhat-network-helpers';
+import '@nomicfoundation/hardhat-ignition-ethers';
+import 'hardhat-deploy';
+import 'hardhat-abi-exporter';
+import 'hardhat-contract-sizer';
+import { HardhatUserConfig } from 'hardhat/config';
+import { getChildFromSeed } from './helper/wallet';
+
+import dotenv from 'dotenv';
+dotenv.config();
+
+import * as tdly from '@tenderly/hardhat-tenderly';
+import { tenderly } from 'hardhat';
+
+// ---------------------------------------------------------------------------------------
+
+const indexParsed = process.env.DEPLOYER_SEED_INDEX;
+const index = indexParsed && indexParsed?.length > 0 ? parseInt(indexParsed) : 0;
+
+const seed = process.env.DEPLOYER_SEED;
+if (!seed) throw new Error('Failed to import the seed string from .env');
+const wallet = getChildFromSeed(seed, index); // deployer
+
+// log infos
+console.log('### Deployer Wallet ###');
+console.log(wallet.address, `index: `, wallet.index);
+
+const alchemy = process.env.ALCHEMY_RPC_KEY;
+if (alchemy?.length == 0 || !alchemy) console.log('WARN: No Alchemy Key found in .env');
+
+const etherscan = process.env.ETHERSCAN_API;
+if (etherscan?.length == 0 || !etherscan) console.log('WARN: No Etherscan Key found in .env');
+
+// ---------------------------------------------------------------------------------------
+
+const config: HardhatUserConfig = {
+	solidity: {
+		version: '0.8.20',
+		settings: {
+			optimizer: {
+				enabled: true,
+				runs: 200,
+			},
+		},
+	},
+	tenderly: {
+		project: process.env.TENDERLY_PROJECT ?? '',
+		username: process.env.TENDERLY_USERNAME ?? '',
+		privateVerification: true,
+	},
+	networks: {
+		mainnet: {
+			url: `https://eth-mainnet.g.alchemy.com/v2/${alchemy}`,
+			chainId: 1,
+			gas: 'auto',
+			gasPrice: 'auto',
+			gasMultiplier: 0.5,
+			accounts: [wallet.privateKey],
+			timeout: 50_000,
+		},
+		hardhat: {
+			forking: {
+				url: `https://eth-mainnet.g.alchemy.com/v2/${alchemy}`,
+				blockNumber: 23599470,
+			},
+			gas: 'auto',
+			gasPrice: 'auto',
+			initialBaseFeePerGas: 100000000,
+			gasMultiplier: 2,
+		},
+		tenderly: {
+			url: process.env.TENDERLY_RPC_URL,
+			chainId: 42069,
+			gas: 'auto',
+			gasPrice: 'auto',
+			accounts: [wallet.privateKey],
+			timeout: 50_000,
+		},
+		sepolia: {
+			url: `https://eth-sepolia.g.alchemy.com/v2/${alchemy}`,
+			chainId: 11155111,
+			gas: 'auto',
+			gasPrice: 'auto',
+			accounts: [wallet.privateKey],
+			timeout: 50_000,
+		},
+		polygon: {
+			url: `https://polygon-mainnet.g.alchemy.com/v2/${alchemy}`,
+			chainId: 137,
+			gas: 'auto',
+			gasPrice: 'auto',
+			accounts: [wallet.privateKey],
+			timeout: 50_000,
+		},
+		optimism: {
+			url: `https://opt-mainnet.g.alchemy.com/v2/${alchemy}`,
+			chainId: 10,
+			gas: 'auto',
+			gasPrice: 'auto',
+			accounts: [wallet.privateKey],
+			timeout: 50_000,
+		},
+		arbitrum: {
+			url: `https://arb-mainnet.g.alchemy.com/v2/${alchemy}`,
+			chainId: 42161,
+			gas: 'auto',
+			gasPrice: 'auto',
+			accounts: [wallet.privateKey],
+			timeout: 50_000,
+		},
+		base: {
+			url: `https://base-mainnet.g.alchemy.com/v2/${alchemy}`,
+			chainId: 8453,
+			gas: 'auto',
+			gasPrice: 'auto',
+			accounts: [wallet.privateKey],
+			timeout: 50_000,
+		},
+		avalanche: {
+			url: `https://avax-mainnet.g.alchemy.com/v2/${alchemy}`,
+			chainId: 43114,
+			gas: 'auto',
+			gasPrice: 'auto',
+			accounts: [wallet.privateKey],
+			timeout: 50_000,
+		},
+		gnosis: {
+			url: `https://gnosis-mainnet.g.alchemy.com/v2/${alchemy}`,
+			chainId: 100,
+			gas: 'auto',
+			gasPrice: 'auto',
+			accounts: [wallet.privateKey],
+			timeout: 50_000,
+		},
+		citrea: {
+			url: `https://rpc.testnet.citrea.xyz`,
+			chainId: 5115,
+			gas: 'auto',
+			gasPrice: 'auto',
+			accounts: [wallet.privateKey],
+			timeout: 50_000,
+		},
+	},
+	etherscan: {
+		apiKey: {
+			// @ts-ignore
+			mainnet: etherscan,
+			tenderly: '',
+			citrea: 'your API key',
+		},
+		customChains: [
+			{
+				network: 'mainnet',
+				chainId: 1,
+				urls: {
+					apiURL: 'https://api.etherscan.io/v2/api?chainid=1',
+					browserURL: 'https://etherscan.io',
+				},
+			},
+			{
+				network: 'tenderly',
+				chainId: 42069,
+				urls: {
+					apiURL: `${process.env.TENDERLY_RPC_URL ?? ''}/verify/etherscan`,
+					browserURL: process.env.TENDERLY_RPC_URL ?? '',
+				},
+			},
+			{
+				network: 'citrea',
+				chainId: 5115,
+				urls: {
+					apiURL: 'https://explorer.testnet.citrea.xyz/api',
+					browserURL: 'https://explorer.testnet.citrea.xyz',
+				},
+			},
+		],
+	},
+	sourcify: {
+		enabled: true,
+	},
+	namedAccounts: {
+		deployer: {
+			default: 0,
+		},
+	},
+	paths: {
+		sources: './contracts',
+		tests: './test',
+		cache: './cache',
+		artifacts: './artifacts',
+	},
+	contractSizer: {
+		alphaSort: false,
+		runOnCompile: false,
+		disambiguatePaths: false,
+	},
+	gasReporter: {
+		enabled: true,
+		currency: 'USD',
+	},
+	abiExporter: [
+		{
+			path: './abi',
+			clear: false,
+			runOnCompile: true,
+			flat: false,
+			spacing: 4,
+			pretty: false,
+		},
+		{
+			path: './abi/signature',
+			clear: false,
+			runOnCompile: true,
+			flat: false,
+			spacing: 4,
+			pretty: true,
+		},
+	],
+	mocha: {
+		timeout: 120000,
+	},
+	typechain: {
+		outDir: 'typechain',
+		target: 'ethers-v6',
+	},
+};
+
+export default config;

package/helper/store.args.ts

@@ -0,0 +1,17 @@
+import { writeFileSync } from 'fs';
+
+export function storeConstructorArgs(deployment: string, args: any[], timestamp: boolean = false) {
+	const d: string[] = new Date().toLocaleString().split(', ');
+	const id: string = `${d[0].replace(/\//g, '-')}_${d[1].replace(/:/g, '-').replace(/ /g, '_')}`;
+	const dir: string = __dirname.split('/').slice(0, -1).join('/') + '/ignition/constructor-args/';
+	const file: string = timestamp ? `${deployment}-${id}.js` : `${deployment}.js`;
+	writeFileSync(
+		dir + file,
+		`module.exports = ${JSON.stringify(
+			args.map((a) => {
+				if (typeof a === 'bigint') return a.toString();
+				else return a;
+			})
+		)};`
+	);
+}

package/helper/wallet.info.ts

@@ -0,0 +1,3 @@
+import { getWalletInto } from './wallet';
+
+getWalletInto();

package/helper/wallet.ts

@@ -0,0 +1,41 @@
+import { ethers } from 'ethers';
+
+export function getChildFromSeed(seed: string, index: number) {
+	return ethers.HDNodeWallet.fromPhrase(seed, undefined, `m/44'/60'/0'/0/${index}`);
+}
+
+export function getAddressFromChildIndex(seed: string, index: number): string {
+	return getChildFromSeed(seed, index).address;
+}
+
+export function getPublicKeyFromChildIndex(seed: string, index: number): string {
+	return getChildFromSeed(seed, index).publicKey;
+}
+
+export function getPrivateKeyFromChildIndex(seed: string, index: number): string {
+	return getChildFromSeed(seed, index).privateKey;
+}
+
+export function getWalletInto(
+	seed = process.env.DEPLOYER_SEED,
+	index = process.env.DEPLOYER_SEED_INDEX,
+	amount: number = 3
+) {
+	if (!seed) throw new Error('Failed to import the seed string from .env');
+	if (!index) throw new Error('Failed to import the index string from .env');
+	console.log('seed:', seed);
+
+	const start = index && index?.length > 0 ? parseInt(index) : 0;
+
+	for (let i = start; i < start + amount; i++) {
+		const w = getChildFromSeed(seed, i);
+		console.log('Wallet', i);
+		console.log({
+			address: w.address,
+			pubKey: w.publicKey,
+			privKey: w.privateKey,
+			path: w.path,
+			index: w.index,
+		});
+	}
+}

package/install-macos.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+
+CUR_VERSION=""
+NEW_VERSION="$(curl -s https://api.github.com/repos/Tenderly/tenderly-cli/releases/latest | grep tag_name | cut -d'v' -f2 | cut -d'"' -f1)"
+EXISTS="$(command -v tenderly)"
+
+if [ "$EXISTS" != "" ]; then
+  CUR_VERSION="$(tenderly version | sed -n 1p | cut -d'v' -f3)"
+  printf "\nCurrent Version: %s => New Version: %s\n" $CUR_VERSION $NEW_VERSION
+fi
+
+if [ "$NEW_VERSION" != "$CUR_VERSION" ]; then
+
+  printf "Installing version %s\n" $NEW_VERSION
+
+  cd /tmp/ > /dev/null
+
+  tarball="tenderly-binary.tar.gz"
+
+  curl -s https://api.github.com/repos/Tenderly/tenderly-cli/releases/latest \
+  | grep "browser_download_url.*Darwin_amd64\.tar\.gz" \
+  | cut -d ":" -f 2,3 \
+  | tr -d \" \
+  | xargs curl -sLo $tarball
+
+  tar -xzf $tarball
+
+  chmod +x tenderly
+
+  unlink $tarball
+
+  printf "Moving CLI to /usr/local/bin/\n"
+
+  mv tenderly /usr/local/bin/
+
+  cd - > /dev/null
+
+  location="$(which tenderly)"
+  printf "Tenderly CLI installed to: %s\n" $location
+
+  version="$(tenderly version | sed -n 1p | cut -d'v' -f3)"
+  printf "New Tenderly version installed: %s\n" $version
+
+else
+  printf "Latest version already installed\n"
+fi

package/package.json

@@ -0,0 +1,73 @@
+{
+	"name": "@usdu-core/usdu-core",
+	"version": "0.0.1",
+	"private": false,
+	"license": "GPL-3.0",
+	"main": "./dist/index.js",
+	"module": "./dist/index.mjs",
+	"types": "./dist/index.d.ts",
+	"author": "samclassix <samclassix@proton.me>",
+	"description": "Core implementation",
+	"directories": {
+		"docs": "docs",
+		"test": "tests"
+	},
+	"scripts": {
+		"wallet": "npx ts-node helper/wallet.info.ts",
+		"wallet:info": "npx ts-node helper/wallet.info.ts",
+		"compile": "npx hardhat compile",
+		"test": "npx hardhat test",
+		"coverage": "npx hardhat coverage",
+		"deploy": "npx hardhat ignition deploy",
+		"verify": "npx hardhat verify",
+		"npm:build": "tsup",
+		"npm:publish": "npm publish --access public"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/USDU-Core/usdu-core"
+	},
+	"keywords": [],
+	"bugs": {
+		"url": "https://github.com/USDU-Core/usdu-core/issues"
+	},
+	"homepage": "https://github.com/USDU-Core/usdu-core#readme",
+	"devDependencies": {
+		"@nomicfoundation/hardhat-chai-matchers": "^2.0.9",
+		"@nomicfoundation/hardhat-ethers": "^3.0.9",
+		"@nomicfoundation/hardhat-ignition": "^0.15.11",
+		"@nomicfoundation/hardhat-ignition-ethers": "^0.15.12",
+		"@nomicfoundation/hardhat-network-helpers": "^1.0.12",
+		"@nomicfoundation/hardhat-toolbox": "^5.0.0",
+		"@nomicfoundation/hardhat-verify": "^2.1.1",
+		"@nomicfoundation/ignition-core": "^0.15.11",
+		"@openzeppelin/contracts": "^5.1.0",
+		"@openzeppelin/contracts-upgradeable": "^5.4.0",
+		"@tenderly/hardhat-tenderly": "^2.5.2",
+		"@types/chai": "^4.3.6",
+		"@types/mocha": "^10.0.1",
+		"@uniswap/v3-core": "^1.0.1",
+		"@uniswap/v3-periphery": "^1.4.4",
+		"chai": "4",
+		"dotenv": "^16.3.1",
+		"ethers": "^6.14.4",
+		"hardhat": "^2.24.3",
+		"hardhat-abi-exporter": "^2.11.0",
+		"hardhat-contract-sizer": "^2.10.0",
+		"hardhat-deploy": "^1.0.3",
+		"hardhat-gas-reporter": "^2.3.0",
+		"mocha": "^10.7.0",
+		"solidity-coverage": "^0.8.16",
+		"ts-node": "^10.9.1",
+		"tsc-watch": "^6.2.0",
+		"tsup": "^8.3.0",
+		"viem": "^2.31.2"
+	},
+	"dependencies": {
+		"@typechain/ethers-v6": "^0.5.1",
+		"@typechain/hardhat": "^9.1.0",
+		"@types/node": "^24.0.1",
+		"typechain": "^8.3.2",
+		"typescript": "^5.8.3"
+	}
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+	"compilerOptions": {
+		"target": "ES2021",
+		"module": "commonjs",
+		"declaration": true,
+		"declarationMap": true,
+		"sourceMap": true,
+		"strict": true,
+		"esModuleInterop": true,
+		"noEmitOnError": true,
+		"skipDefaultLibCheck": true,
+		"skipLibCheck": true
+	},
+	"include": ["hardhat.config.ts", "./scripts", "./deploy", "./test/**/*.ts", "./typechain", "deploy", "utils"]
+}

package/tsup.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+	format: ['cjs', 'esm'],
+	entry: ['./exports/index.ts'],
+	dts: true,
+	shims: true,
+	skipNodeModulesBundle: true,
+	clean: true,
+});