Universal Composer

A LayerZero Composer served as a starting point of arbitrary tx operation after bridged token from another blockchain using stargate.

for more info, please refer to Stargate Composability

Contracts

Testnet

Optimism Sepolia

UniversalComposer

MockedYearnV3

Mainnet

Polygon

UniversalComposer

Usage

Build

$ forge build

Run Scripts

Testnet

Stargate does not support amoy testnet yet, so we use Arbitrum Sepolia -> Optimism Sepolia instead.

1.) Make sure to fill the PRIVATE_KEY to .env file

2.) Deploy Composer to destination chain and verify contract

source .env

forge create src/UniversalComposer.sol:UniversalComposer \
--rpc-url optimismSepolia \
--constructor-args 0x6EDCE65403992e310A62460808c4b910D972f10f 0x0d7aB83370b492f2AB096c80111381674456e8d8 \
--private-key $PRIVATE_KEY \
--etherscan-api-key $OP_ETHERSCAN_API_KEY \
--verify

or

Fill in your sender to the script below

forge script ./script/DeployComposerScript.s.sol:DeployComposerScript \
--via-ir \
-vvvv \
--broadcast \
--rpc-url optimismSepolia \
--sender 0x436f795B64E23E6cE7792af4923A68AFD3967952

source .env

forge verify-contract \
0x0310B6291086981C5773434684c3D3dD12D6d57e \
--chain optimism-sepolia \
--verifier-url $OPTIMISM_SEPOLIA_ETHERSCAN_API \
src/UniversalComposer.sol:UniversalComposer \
--constructor-args $(cast abi-encode "constructor(address,address)" 0x6EDCE65403992e310A62460808c4b910D972f10f 0x0d7aB83370b492f2AB096c80111381674456e8d8) \
--etherscan-api-key $OP_ETHERSCAN_API_KEY

3.) Send token with message from Arbitum Sepolia

forge script ./script/BridgeTestnetTokenScript.s.sol:BridgeTestnetTokenScript \
--via-ir \
-vvvv \
--rpc-url arbitrumSepolia \
--sender 0x436f795B64E23E6cE7792af4923A68AFD3967952 \
--sig "run(address,uint128,string)" -- 0x15d1d4ba9095379eafd6ec62711c581fd09ba703 32000 "9352001271a0af0d09a4e7f6c431663a2d5aa9d200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044095ea7b300000000000000000000000042c2dfd03934ee63c869a973834b16ce3fb97399000000000000000000000000000000000000000000000000000000000000006342c2dfd03934ee63c869a973834b16ce3fb97399000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000446e553f650000000000000000000000000000000000000000000000000000000000000063000000000000000000000000436f795b64e23e6ce7792af4923a68afd3967952" \
--broadcast

Addition

Deploy Mocked YearnV3 vault and verify contract

forge create src/MockYearnV3Vault.sol:MockYearnV3Vault \
--rpc-url optimismSepolia \
--constructor-args 0x9352001271a0af0d09a4e7F6C431663A2D5AA9d2 \
--private-key $PRIVATE_KEY \
--etherscan-api-key $OP_ETHERSCAN_API_KEY \
--verify

Mainnet

1.) Make sure to fill the PRIVATE_KEY to .env file

2.) Deploy Composer to destination chain and verify contract

source .env

forge create src/UniversalComposer.sol:UniversalComposer \
--rpc-url polygon \
--via-ir \
--constructor-args 0x1a44076050125825900e736c501f859c50fE728c 0xd47b03ee6d86Cf251ee7860FB2ACf9f91B9fD4d7 \
--private-key $PRIVATE_KEY \
--etherscan-api-key $POLYGONSCAN_API_KEY \
--verify

3.) Send token with message from Arbitum -> Polygon

forge script ./script/BridgeMainnetTokenScript.s.sol:BridgeMainnetTokenScript \
--via-ir \
--rpc-url arbitrum \
-vvvv \
--broadcast \
--sender 0x436f795B64E23E6cE7792af4923A68AFD3967952 \
--sig "run(address,uint128,string)" -- 0x108877f830F2D15A8FB7D74991B00A5c4D480b63 200000 "c2132d05d31c914a87c6611c10748aeb04b58e8f00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044095ea7b3000000000000000000000000bb287e6017d3deb0e2e65061e8684eab210601230000000000000000000000000000000000000000000000000000000000000063bb287e6017d3deb0e2e65061e8684eab21060123000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000446e553f650000000000000000000000000000000000000000000000000000000000000063000000000000000000000000be988fc9f6f8ad1ebb3a58b6c25bd6be9d1f56fe"

LayerZero Scan
Success Composer Tx

Multichain deployment

Make sure there are no broadcast/multi/DeployComposerScript.s.sol-latest under broadcast/multi first, otherwise you might get response:

• server returned an error response: error code -32000: nonce too low
• No associated wallet for addresses: [0x436f795b64e23e6ce7792af4923a68afd3967952]. Unlocked wallets: []

forge script ./script/DeployComposerScript.s.sol:DeployComposerScript \
--via-ir \
--multi \
--broadcast \
-vvvv \
--sender 0x436f795B64E23E6cE7792af4923A68AFD3967952 \
--private-key $PRIVATE_KEY \
--verify

To resume verifying the above deployed contracts

forge script ./script/DeployComposerScript.s.sol:DeployComposerScript \
--verify \
--resume \
--multi \
--via-ir \
-vvvv \
--sender 0x436f795B64E23E6cE7792af4923A68AFD3967952 \
--private-key $PRIVATE_KEY

If you encountered Invalid API Key error even if the api key is correct try below.

forge verify-contract \
0x648CAd82944eDe9149556bd01fD9B3F437A87B9e \
--via-ir \
--chain optimism \
--etherscan-api-key $OP_ETHERSCAN_API_KEY \
src/UniversalComposer.sol:UniversalComposer \
--constructor-args $(cast abi-encode "constructor(address,address)" 0x1a44076050125825900e736c501f859c50fE728c 0xe8CDF27AcD73a434D661C84887215F7598e7d0d3)

or

forge script ./script/DeployComposerScript.s.sol:DeployComposerScript \
--rpc-url $ARBITRUM_RPC_URL \
--private-keys $PRIVATE_KEY \
--etherscan-api-key $ARB_ETHERSCAN_API_KEY \
--verify \
--resume \
--via-ir \
-vvvv \
--sender your_address

If still no luck, we should verify manually by outputing the standard-json-input.
remember to add --via-ir if used it to compile otherwise it will fail.

forge verify-contract \
0x648CAd82944eDe9149556bd01fD9B3F437A87B9e \
--via-ir \
--show-standard-json-input \
--chain optimism \
--etherscan-api-key $OP_ETHERSCAN_API_KEY \
src/UniversalComposer.sol:UniversalComposer \
--constructor-args $(cast abi-encode "constructor(address,address)" 0x1a44076050125825900e736c501f859c50fE728c 0xe8CDF27AcD73a434D661C84887215F7598e7d0d3)

Test

$ forge test