Skip to content

README-PROD.md

Latest commit

 

History

History
270 lines (186 loc) · 6.43 KB

README-PROD.md

File metadata and controls

270 lines (186 loc) · 6.43 KB
Raw

安装依赖

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

[注意] 生产环境更改namedAccounts配置

时间锁合约

[注意] 生产环境更改TimeLockConfig配置

npx hardhat deploy --network bscMainnetTest --tags Timelock

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

npx hardhat deploy --network bscMainnetTest --tags WithdrawVault

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

[注意] 更改BNB_CHAIN_WRAPPED

npx hardhat deploy --network bscMainnetTest --tags Earn

验证合约

npx hardhat deploy --network bscMainnetTest --tags TimelockVerify
npx hardhat deploy --network bscMainnetTest --tags WithdrawVaultVerify

[注意] 更改BNB_CHAIN_WRAPPED

npx hardhat deploy --network bscMainnetTest --tags EarnVerify

合约升级

hardhat deploy --network bscMainnetTest --tags WithdrawVaultImplementation

[注意] 更改BNB_CHAIN_WRAPPED

hardhat deploy --network bscMainnetTest --tags EarnImplementation

AssXXX 部署

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

npx hardhat deploy --network bscMainnetTest --tags AsBTC

验证合约

npx hardhat deploy --network bscMainnetTest --tags AsBTCVerify

测试合约升级

npx hardhat upgrade:WithdrawVault --network bscMainnetTest
npx hardhat upgrade:Earn --network bscMainnetTest

分配权限

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 角色下 更改address 为bot地址

npx hardhat grantRole:earn --network bscMainnetTest

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

npx hardhat grantRole:transfer_role --network bscMainnetTest

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

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

更改 const contract='AsBTC' 变量值

npx hardhat grantRole:minter_and_burn_role --network bscMainnetTest

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 发起交易

img.png

sepoliaTestnet AssUSDC

设置setTransferLimitConfigs

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

send 发起交易

img_1.png

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，后面通过这个退款地址，返回给发起方