![\"Solidity\"](\"https://img.shields.io/badge/Solidity-0.8.30-363636?logo=solidity&logoColor=white\"){kind=icon}
![\"Hardhat\"](\"https://img.shields.io/badge/Hardhat-2.x-yellow?logo=ethereum&logoColor=white\"){kind=icon}
=18.16.0"},"exports":{".":{"types":"./dist/sdk/index.d.ts","import":"./dist/sdk/index.js","default":"./dist/sdk/index.js"},"./package.json":"./package.json"},"scripts":{"lint":"$npm_execpath run lint:ts && $npm_execpath run lint:sol","test":"pnpm run compile --force && hardhat test","build":"tsc --project tsconfig.build.json && cp -r ./artifacts/contracts ./dist/artifacts","clean":"rm -rf ./artifacts ./cache ./coverage ./types ./coverage.json ./ignition/deployments","compile":"cross-env TS_NODE_TRANSPILE_ONLY=true hardhat compile","lint:ts":"eslint --ignore-path ./.eslintignore --ext .js,.ts .","lint:fix":"eslint --fix '**/*.{pajs,ts,json}' && prettier --write . && solhint 'contracts/**/*.sol' --fix --noPrompt","lint:sol":"solhint --max-warnings 0 \"contracts/**/*.sol\"","test-local":"hardhat test --network localhost","contract-size":"pnpm compile && tsx scripts/plugins/contract-size.ts"},"_npmUser":{"name":"michaelthebra","email":"michael@beraji.io"},"_resolved":"/tmp/de79a3beb91c2a98d224f3a5f999e916/prime-vaults-contract-0.3.0.tgz","_integrity":"sha512-eD+ZrrW2uTw87BKdMrRJMmJZHP0wgK5ZLUPWp5Y3i7eHHPu56pE9Z5ouRAg3g+EYMk2xF43k+tNgyOHETuMa9w==","_npmVersion":"10.9.4","description":"
=18.16.0"},"exports":{".":{"types":"./dist/sdk/index.d.ts","import":"./dist/sdk/index.js","default":"./dist/sdk/index.js"},"./package.json":"./package.json"},"scripts":{"lint":"$npm_execpath run lint:ts && $npm_execpath run lint:sol","test":"pnpm run compile --force && hardhat test","build":"tsc --project tsconfig.build.json && cp -r ./artifacts/contracts ./dist/artifacts","clean":"rm -rf ./artifacts ./cache ./coverage ./types ./coverage.json ./ignition/deployments","compile":"cross-env TS_NODE_TRANSPILE_ONLY=true hardhat compile","lint:ts":"eslint --ignore-path ./.eslintignore --ext .js,.ts .","lint:fix":"eslint --fix '**/*.{pajs,ts,json}' && prettier --write . && solhint 'contracts/**/*.sol' --fix --noPrompt","lint:sol":"solhint --max-warnings 0 \"contracts/**/*.sol\"","test-local":"hardhat test --network localhost","contract-size":"pnpm compile && tsx scripts/plugins/contract-size.ts"},"_npmUser":{"name":"michaelthebra","email":"michael@beraji.io"},"_resolved":"/tmp/d39de3f5bf65c090e33ec7eb1948b83d/prime-vaults-contract-0.3.1.tgz","_integrity":"sha512-ouL48HpIPnqZ89g/EB+X2gLhbr+D1DhjcTtRKhE89bdi49K9Vo0GKthXLw+xEeKVd+nSi5N4RtHtRhTkjL5rEQ==","_npmVersion":"10.9.4","description":"
=18.16.0"},"exports":{".":{"types":"./dist/sdk/index.d.ts","import":"./dist/sdk/index.js","default":"./dist/sdk/index.js"},"./package.json":"./package.json"},"scripts":{"lint":"$npm_execpath run lint:ts && $npm_execpath run lint:sol","test":"pnpm run compile --force && hardhat test","build":"tsc --project tsconfig.build.json && cp -r ./artifacts/contracts ./dist/artifacts","clean":"rm -rf ./artifacts ./cache ./coverage ./types ./coverage.json ./ignition/deployments","compile":"cross-env TS_NODE_TRANSPILE_ONLY=true hardhat compile","lint:ts":"eslint --ignore-path ./.eslintignore --ext .js,.ts .","lint:fix":"eslint --fix '**/*.{pajs,ts,json}' && prettier --write . && solhint 'contracts/**/*.sol' --fix --noPrompt","lint:sol":"solhint --max-warnings 0 \"contracts/**/*.sol\"","test-local":"hardhat test --network localhost","contract-size":"pnpm compile && tsx scripts/plugins/contract-size.ts"},"_npmUser":{"name":"michaelthebra","email":"michael@beraji.io"},"_resolved":"/tmp/b55878d41f54a9fe132d8d63933506cd/prime-vaults-contract-0.3.2.tgz","_integrity":"sha512-fqdih3NAxbxZNoZPlLMsQq+Y2rBTUwJQ4gmrILWlXi7qrwebZsSMtcuLs0+Sh3xxSK0EyoRsWWWDWa+t+UeIiA==","_npmVersion":"10.9.4","description":"
=18.16.0"},"exports":{".":{"types":"./dist/sdk/index.d.ts","import":"./dist/sdk/index.js","default":"./dist/sdk/index.js"},"./package.json":"./package.json"},"scripts":{"lint":"$npm_execpath run lint:ts && $npm_execpath run lint:sol","test":"pnpm run compile --force && hardhat test","build":"tsc --project tsconfig.build.json && cp -r ./artifacts/contracts ./dist/artifacts","clean":"rm -rf ./artifacts ./cache ./coverage ./types ./coverage.json ./ignition/deployments","compile":"cross-env TS_NODE_TRANSPILE_ONLY=true hardhat compile","lint:ts":"eslint --ignore-path ./.eslintignore --ext .js,.ts .","lint:fix":"eslint --fix '**/*.{pajs,ts,json}' && prettier --write . && solhint 'contracts/**/*.sol' --fix --noPrompt","lint:sol":"solhint --max-warnings 0 \"contracts/**/*.sol\"","test-local":"hardhat test --network localhost","contract-size":"pnpm compile && tsx scripts/plugins/contract-size.ts"},"_npmUser":{"name":"michaelthebra","email":"michael@beraji.io"},"_resolved":"/tmp/dd73e4f918a3848e1d5dfe2e7f9c09a6/prime-vaults-contract-0.4.0.tgz","_integrity":"sha512-TmH85uFcLMeBCrMPXk1lN7fmepO0eT1e2Z/oTB7uwTHTK5E3LBSWFGHD98ZRoH1hBpYpNrL0MvgiESi/2agHfg==","_npmVersion":"10.9.4","description":"
=18.16.0"},"exports":{".":{"types":"./dist/sdk/index.d.ts","import":"./dist/sdk/index.js","default":"./dist/sdk/index.js"},"./package.json":"./package.json"},"scripts":{"lint":"$npm_execpath run lint:ts && $npm_execpath run lint:sol","test":"pnpm run compile --force && hardhat test","build":"tsc --project tsconfig.build.json && cp -r ./artifacts/contracts ./dist/artifacts","clean":"rm -rf ./artifacts ./cache ./coverage ./types ./coverage.json ./ignition/deployments","compile":"cross-env TS_NODE_TRANSPILE_ONLY=true hardhat compile","lint:ts":"eslint --ignore-path ./.eslintignore --ext .js,.ts .","lint:fix":"eslint --fix '**/*.{pajs,ts,json}' && prettier --write . && solhint 'contracts/**/*.sol' --fix --noPrompt","lint:sol":"solhint --max-warnings 0 \"contracts/**/*.sol\"","test-local":"hardhat test --network localhost","contract-size":"pnpm compile && tsx scripts/plugins/contract-size.ts"},"_npmUser":{"name":"michaelthebra","email":"michael@beraji.io"},"_resolved":"/tmp/023b0d4d36224b131da2836ee33103d1/prime-vaults-contract-0.4.1.tgz","_integrity":"sha512-ZmA/ZepkCDILo7LBtIBoVriXL1pH+Od4+sRyYwyObUrd3z1HkbMdvB+U6n3dstsX+FuYTqxMqk5JX/OhMKi0bw==","_npmVersion":"10.9.4","description":"
=18.16.0"},"devDependencies":{"@layerzerolabs/lz-evm-oapp-v2":"^3.0.152","@nomicfoundation/hardhat-ignition":"^3.0.3","@nomicfoundation/hardhat-toolbox-viem":"^5.0.0","@openzeppelin/contracts":"^5.4.0","@trivago/prettier-plugin-sort-imports":"^5.2.2","@types/node":"^22.8.5","@types/prompts":"^2.4.9","@typescript-eslint/eslint-plugin":"^8.46.2","@typescript-eslint/parser":"^8.46.2","chalk":"^5.6.2","citty":"^0.1.6","cross-env":"^10.1.0","dotenv":"^17.2.3","eslint":"^8.55.0","eslint-config-prettier":"^10.1.8","forge-std":"github:foundry-rs/forge-std#v1.9.4","hardhat":"^3.0.7","prettier":"^3.6.2","prettier-plugin-solidity":"^2.1.0","prompts":"^2.4.2","solhint":"^6.0.1","solhint-plugin-prettier":"^0.1.0","solmate":"^6.8.0","tsx":"^4.20.6","typescript":"~5.8.0","viem":"^2.30.0"},"keywords":["blockchain","ethers","ethereum","hardhat","smart-contracts","solidity","template","typescript","viem"],"dependencies":{"viem":"^2.30.0"},"peerDependencies":{"viem":"^2.x"},"scripts":{"clean":"rm -rf ./artifacts ./cache ./coverage ./types ./coverage.json ./ignition/deployments","compile":"cross-env TS_NODE_TRANSPILE_ONLY=true hardhat compile","build":"tsc --project tsconfig.build.json && cp -r ./artifacts/contracts ./dist/artifacts","lint":"$npm_execpath run lint:ts && $npm_execpath run lint:sol","lint:sol":"solhint --max-warnings 0 \"contracts/**/*.sol\"","lint:ts":"eslint --ignore-path ./.eslintignore --ext .js,.ts .","lint:fix":"eslint --fix '**/*.{pajs,ts,json}' && prettier --write . && solhint 'contracts/**/*.sol' --fix --noPrompt","test":"pnpm run compile --force && hardhat test","test-local":"hardhat test --network localhost","contract-size":"pnpm compile && tsx scripts/plugins/contract-size.ts"},"_id":"@prime-vaults/contract@0.4.2","description":"
\n
![\"License\"](\"https://img.shields.io/badge/License-MIT-green\"){kind=icon}
![\"Audited\"](\"https://img.shields.io/badge/Security-Audited-brightgreen\"){kind=icon}
\n A Modular Multi-Chain DeFi Vault System\n
\n Deposit assets β’ Earn yield β’ Execute cross-chain strategies\n
\n Architecture β’\n PrimeVault β’\n PrimeStrategy β’\n PrimeExecutor β’\n Deployments β’\n Getting Started\n
\n\n---\n\n## π Overview\n\n**Prime Vaults** is a sophisticated DeFi infrastructure built on the **BoringVault architecture** that enables users to:\n\n- π **Deposit assets** and receive ERC20 vault shares\n- π° **Earn passive income** through automated DeFi strategies\n- π **Cross-chain execution** via bridge integrations (Stargate, LiFi)\n- π **Multi-token rewards** with automatic distribution\n\n---\n\n## π Architecture\n\n```\nβββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ\nβ PRIME VAULTS ECOSYSTEM β\nβββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€\nβ β\nβ π€ USER (Any Chain) β\nβ β β\nβ βΌ β\nβ ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β\nβ β π PRIMEEXECUTOR (Bridge Layer) β β\nβ β βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ β β\nβ β β Stargate β β LiFi β β LayerZero β β β\nβ β β Bridge β β Bridge β β Messaging β β β\nβ β βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ β β\nβ ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β\nβ β β\nβ βΌ Cross-chain transfer to Native Chain β\nβ ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β\nβ β π± SMART ACCOUNT (User Wallet) β β\nβ ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β\nβ β β\nβ βΌ β\nβ ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β\nβ β π¦ PRIMEVAULT (Core Vault) β β\nβ β βββββββββββββββ ββββββββββββββββ ββββββββββββββββ β β\nβ β βBoringVault βββββ€ Accountant βββββ€ Teller ββββ Deposit β β\nβ β β(ERC20 Vault)β β(Rates & Fees)β β (Gateway) β β β\nβ β ββββββββ¬βββββββ ββββββββββββββββ ββββββββββββββββ β β\nβ β β β β\nβ β ββββββββΌβββββββ ββββββββββββββββ ββββββββββββββββ β β\nβ β β Manager β βDelayedWithdrawβ β Distributor βββ Rewards β β\nβ β β (Merkle) β β (Time-lock) β β (Multi-tok) β β β\nβ β ββββββββ¬βββββββ ββββββββββββββββ ββββββββββββββββ β β\nβ βββββββββββΌβββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β\nβ β β\nβ βΌ β\nβ ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β\nβ β β‘ PRIMESTRATEGY (Yield) β β\nβ β Deploy vault assets to DeFi protocols for yield β β\nβ ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β\nβ β\nβ ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β\nβ β π ACCESS CONTROL (PrimeRBAC) β β\nβ β OWNER_ROLE β PROTOCOL_ADMIN_ROLE β OPERATOR_ROLE β β\nβ ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β\nβββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ\n```\n\n---\n\n## π¦ PrimeVault (Core)\n\nThe core vault system manages asset custody, share issuance, and yield generation.\n\n### Components\n\n| Component | Description | Key Features |\n| ------------------- | ------------------------------------- | ---------------------------------------------------- |\n| **BoringVault** | Minimal ERC20 vault (~100 lines) | Asset custody, share minting/burning, DeFi execution |\n| **Accountant** | Exchange rate & fee manager | Time-based fee accrual, rate calculations |\n| **Teller** | User gateway for deposits/withdrawals | Slippage protection, deposit caps |\n| **DelayedWithdraw** | Time-locked withdrawal security | 3-day delay, expedited option with fee |\n| **Distributor** | Multi-token reward distribution | Automatic accrual, compounding support |\n| **Manager** | Merkle-verified strategy executor | Whitelist all DeFi operations |\n\n### Key Formulas\n\n```\nπ Exchange Rate:\n shareValue = (totalAssets - feesOwed) / totalShares\n\nπ° Platform Fee (Annual):\n fees = (shares Γ rate Γ platformFee Γ timeDelta) / (10000 Γ 365 days)\n\nπ Rewards per Token:\n rewardPerToken = stored + ((now - lastUpdate) Γ rate Γ 1e27) / totalSupply\n```\n\n### User Flows\n\n\n Prime Vaults\n
\n Building the future of cross-chain DeFi\n
\n Website β’\n Docs β’\n X β’\n