时间锁合约

安装依赖

pnpm install

mac 安装 forge

npm install -g @forge/cli
foundryup

编译

pnpm compile

If you prefer one over the other, you can use the tooling-specific commands:

pnpm compile:forge

pnpm compile:hardhat

Running tests

Similarly to the contract compilation, we support both hardhat and forge tests. By default, the test command will execute both:

pnpm test

If you prefer one over the other, you can use the tooling-specific commands:

pnpm test:forge
pnpm test:hardhat

Deploying Contracts

Set up deployer wallet/account:

Rename .env.example -> .env
Choose your preferred means of setting up your deployer wallet/account:

MNEMONIC="test test test test test test test test test test test junk"
or...
PRIVATE_KEY="0xabc...def"

生成abi：

npx hardhat 尝试使用全局安装的 Hardhat，但 Hardhat 需要在本地项目中安装才能正常工作

pnpm install --save-dev hardhat
npx hardhat export-abi

时间锁合约

npx hardhat deploy --network bscTestnet --tags Timelock

代理合约和逻辑合约部署[WithdrawVault]

npx hardhat deploy --network bscTestnet --tags WithdrawVault

代理合约和逻辑主合约部署[Earn]

npx hardhat deploy --network bscTestnet --tags Earn

验证合约

npx hardhat deploy --network bscTestnet --tags TimelockVerify

npx hardhat deploy --network bscTestnet --tags WithdrawVaultVerify

npx hardhat deploy --network bscTestnet --tags EarnVerify

合约升级

hardhat deploy --network bscTestnet --tags WithdrawVaultImplementation

hardhat deploy --network bscTestnet --tags EarnImplementation

AssXXX 部署

【注意】每次部署成功之后,生成的AssXXX.json要改成正确的代币名称比如 AssBTC AssBNB ...

npx hardhat deploy --network bscTestnet --tags AssBTC

npx hardhat deploy --network bscTestnet --tags AssBNB

npx hardhat deploy --network bscTestnet --tags AssUSDT

npx hardhat deploy --network bscTestnet --tags AssUSDC

部署测试asset BTC BNB USDT USDC

BNB 地址 const BNB_CHAIN_TESTNET_WRAPPED = '0xae13d989daC2f0dEbFf460aC112a837C89BAa7cd'; const BNB_CHAIN_WRAPPED = '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c';

hardhat deploy --network bscTestnet --tags BTCTest

hardhat deploy --network bscTestnet --tags USDTTest

hardhat deploy --network bscTestnet --tags USDCTest

测试合约升级

npx hardhat upgrade:WithdrawVault --network bscTestnet

npx hardhat upgrade:Earn --network bscTestnet

分配权限

AssXXX 合约

grantRole: 把 Earn合约地址加到 MINTER_AND_BURN_ROLE 角色下 approve: 授权spender(Earn合约地址)使用多少数量的token

XXX 合约

approve: 授权spender(Earn合约地址)使用多少数量的token

Earn

grantRole: 把 bot(后端发起交易地址)地址加到 BOT_ROLE 角色下

WithdrawVault 合约

grantRole: 把 Earn合约地址加到 TRANSFER_ROLE 角色下

测试操作流程

1. 授权

[Earn 合约] grantRole: 把 bot(后端发起交易地址)地址加到 BOT_ROLE 角色下 npx hardhat grantRole:minter_and_burn_role --network bscTestnet [WithdrawVault 合约] grantRole: 把 Earn合约地址加到 TRANSFER_ROLE 角色下

2.[AssXXX 合约] 部署AssXXX合约

2.1 grantRole: 把 Earn合约地址加到 MINTER_AND_BURN_ROLE 角色下

更改 const contract='AssUSDT' 变量值

npx hardhat grantRole:minter_and_burn_role --network bscTestnet

2.2 approve: 授权spender(Earn合约地址)使用多少数量的token

3.addToken

4. deposit 或者 depositNative

5. transferToCeffu

6. uploadExchangeRate

例子

[{"assTokenAddress":"0x3f41a2d00D9D294B4097B68EbFBE7dfE955fc3Cc","assToSourceExchangeRate":"100000000","exchangeRateExpiredTimestamp":"1735660800"}]

7. requestWithdraw

8. 向Ceffu提现

9. distributeWithdraw

例子

[{"assTokenAddress":"0x3f41a2d00D9D294B4097B68EbFBE7dfE955fc3Cc","sourceTokenAmount":"100000000000000000","requestWithdrawNo":1,"receipt":"0xf4903f4544558515b26ec4C6D6e91D2293b27275"}]

[{"assTokenAddress":"0xbb8f7E2321c4a7D8b9B432792103A5d48A74ace8","sourceTokenAmount":"10000000000000000","requestWithdrawNo":2,"receipt":"0xf4903f4544558515b26ec4C6D6e91D2293b27275"}]

10. claimWithdraw

oft 跨链相关步骤

跨链部署文档 https://docs.layerzero.network/v2/developers/evm/create-lz-oapp/start 查看交易 https://testnet.layerzeroscan.com/address/0xf4903f4544558515b26ec4c6d6e91d2293b27275 链上跟踪交易 https://dashboard.tenderly.co/tx/bnb-testnet/0xeb394f04f8a578d1bbecbdee25093f98bff892c9289cf7d064a37ab04d36c1cb

npx hardhat deploy --network bscTestnet --tags AssUSDC

npx hardhat deploy --network sepoliaTestnet --tags AssUSDC

npx hardhat deploy --network bscTestnet --tags AssUSDCVerify

npx hardhat deploy --network sepoliaTestnet --tags AssUSDCVerify

npx hardhat lz:oapp:config:init --contract-name AssXXX --oapp-config testnet.layerzero.config.ts

npx hardhat lz:oapp:wire --oapp-config testnet.layerzero.config.ts

bscTestnet AssUSDC

设置setTransferLimitConfigs

[{"dstEid":40161,"maxDailyTransferAmount":"1000000000000000000000000000","singleTransferUpperLimit":"10000000000000000000000000","singleTransferLowerLimit":"0","dailyTransferAmountPerAddress":"100000000000000000000000000","dailyTransferAttemptPerAddress":"10000000"}]

send 发起交易

sepoliaTestnet AssUSDC

设置setTransferLimitConfigs

[{"dstEid":40102,"maxDailyTransferAmount":"1000000000000000000000000000","singleTransferUpperLimit":"10000000000000000000000000","singleTransferLowerLimit":"0","dailyTransferAmountPerAddress":"100000000000000000000000000","dailyTransferAttemptPerAddress":"10000000"}]

send 发起交易

send 发起交易注意事项

send要于nativeFee价值上保持一致，注意单位。自行调整数值

amountLD 于minAmountLD 保持一致

to

    const toBytes32Value = arrayToBytes32(ethers.utils.zeroPad('0xf4903f4544558515b26ec4C6D6e91D2293b27275', 32));
    console.log(toBytes32Value);

extraOptions

    const extraOptions = Options.newOptions().addExecutorLzReceiveOption(600000, 0).toHex().toString()
    console.log(extraOptions)

composeMsg 0x

oftCmd 0x

lzTokenFee 0

_refundAddress 先多扣native fee，后面通过这个退款地址，返回给发起方

Test

$ forge test

test a specific contract

forge test --match-contract SignTest -vvvvv --via-ir 
forge clean && forge test --match-contract SignTest -vvvvv --via-ir
forge clean && forge test --match-contract SignTest --match-test "testSign" -vvvv --via-ir


### storage slot

cast storage 0x0612Aaa3Dd5E50368A95Bd2D2dB0025641B79cE5 --via-ir --rpc-url https://data-seed-prebsc-1-s1.bnbchain.org:8545/ --etherscan-api-key TDID7NM35CIQ35RU4TUV5XQV9GBDKCBJYI
cast storage 0x7f1be83A1CDA4a903323cfF3390a2721D46f219E --via-ir --rpc-url https://data-seed-prebsc-1-s1.bnbchain.org:8545/ --etherscan-api-key TDID7NM35CIQ35RU4TUV5XQV9GBDKCBJYI
cast storage 0x541d298047312DCBCc4Ae55d9f9FAb6104132c9e --via-ir --rpc-url https://data-seed-prebsc-1-s1.bnbchain.org:8545/ --etherscan-api-key TDID7NM35CIQ35RU4TUV5XQV9GBDKCBJYI

Name		Name	Last commit message	Last commit date
Latest commit History 72 Commits
abi		abi
contracts		contracts
deploy		deploy
deployments		deployments
tasks		tasks
test		test
.eslintignore		.eslintignore
.eslintrc.js		.eslintrc.js
.gitignore		.gitignore
.nvmrc		.nvmrc
.prettierignore		.prettierignore
.prettierrc.js		.prettierrc.js
README-PROD.md		README-PROD.md
README.md		README.md
foundry.toml		foundry.toml
hardhat.config.js		hardhat.config.js
hardhat.config.ts		hardhat.config.ts
img.png		img.png
img_1.png		img_1.png
layerzero.config.ts		layerzero.config.ts
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
solhint.config.js		solhint.config.js
testnet.layerzero.config.ts		testnet.layerzero.config.ts
timelock.config.js		timelock.config.js
tsconfig.json		tsconfig.json

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

安装依赖

mac 安装 forge

编译

Running tests

Deploying Contracts

生成abi：

时间锁合约

代理合约和逻辑合约部署[WithdrawVault]

代理合约和逻辑主合约部署[Earn]

验证合约

合约升级

AssXXX 部署

【注意】每次部署成功之后,生成的AssXXX.json要改成正确的代币名称 比如 AssBTC AssBNB ...

部署测试asset BTC BNB USDT USDC

测试合约升级

分配权限

AssXXX 合约

XXX 合约

Earn

WithdrawVault 合约

测试操作流程

1. 授权

2.[AssXXX 合约] 部署AssXXX合约

2.1 grantRole: 把 Earn合约地址加到 MINTER_AND_BURN_ROLE 角色下

2.2 approve: 授权spender(Earn合约地址)使用多少数量的token

3.addToken

4. deposit 或者 depositNative

5. transferToCeffu

6. uploadExchangeRate

例子

7. requestWithdraw

8. 向Ceffu提现

9. distributeWithdraw

例子

10. claimWithdraw

oft 跨链相关步骤

bscTestnet AssUSDC

设置setTransferLimitConfigs

send 发起交易

sepoliaTestnet AssUSDC

设置setTransferLimitConfigs

send 发起交易

send 发起交易注意事项

send要于nativeFee价值上保持一致，注意单位。自行调整数值

amountLD 于minAmountLD 保持一致

to

extraOptions

composeMsg 0x

oftCmd 0x

lzTokenFee 0

_refundAddress 先多扣native fee，后面通过这个退款地址，返回给发起方

Test

test a specific contract

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

【注意】每次部署成功之后,生成的AssXXX.json要改成正确的代币名称比如 AssBTC AssBNB ...

Packages