Demos for Brige and Call

List of Demos

• L1 -> L2

  • TODO: Bridge and Convert
  • Bridge and Deposit
  • TODO: Bridge and Swap

• L2 -> L1

  • Bridge and Swap

• L2 -> L2

  • Bridge and Deposit
  • TODO: Bridge, Swap, and Return Change
  • TODO: Bridge, Swap, Bridge, and Deposit

• L1 -> L2 -> L1

  • TODO: TBD

• L1 -> L2 -> L2 -> L1

  • TODO: TBD

Relevant Information

You'll most likely need this info for testing things.

RPCs

Network	RPC	Chain Id	Explorer	Currency
Sepolia	https://1rpc.io/sepolia	11155111	https://sepolia.etherscan.io	ETH
ZkEVM Cardona	https://rpc.cardona.zkevm-rpc.com	2442	https://cardona-zkevm.polygonscan.com	ETH
Astar zKyoto	https://rpc.startale.com/zkyoto	6038361	https://zkyoto.explorer.startale.com/	ETH
X Layer testnet	https://testrpc.xlayer.tech	195	https://www.okx.com/explorer/xlayer-test	OKB

Contracts

Contract	Sepolia (network id 0)	Cardona (network id 1)	zKyoto (network id 2)	XLayer Testnet (network id 3)
LxLy Bridge	0x528e26b25a34a4A5d0dbDa1d57D318153d2ED582	0x528e26b25a34a4A5d0dbDa1d57D318153d2ED582	0x528e26b25a34a4A5d0dbDa1d57D318153d2ED582	TODO
BridgeExtension	0x2311BFA86Ae27FC10E1ad3f805A2F9d22Fc8a6a1	0x2311BFA86Ae27FC10E1ad3f805A2F9d22Fc8a6a1	0x2311BFA86Ae27FC10E1ad3f805A2F9d22Fc8a6a1	TODO
MultiCall	TODO	0x188A500BAdb18E1EBe7ced5D685d5808f13366f7	0x2bF80055C826899911690C30489930F7573fF037	TODO
USDC	0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238	0xc1EF3FC60d6CfC83fe58Fd5f48aB75A20b2518C1	TODO	TODO
FakeDolla	0x805023692260d1aefb0b4e622e03e77e21adf5cf	TODO	0xe6e6809bBFA49cEE58988e532d71bddf83aD2A38	TODO
FakeAggLayerToken	0x2170cc348ae3cfb77cde9c3ca6b279863df7e0bf	0x88342beb50513c9994696c1dadeedad5e8b763df	0xaf154A248d8C4061b728F49795065C0CD847BA3C	TODO
(bw)USDC	TODO	0x150aE9614A43361775D9D3A006f75CCc558B598F	0x150aE9614A43361775D9D3A006f75CCc558B598F	TODO
(bw)FakeAggLayerToken	TODO	TODO	sepolia:0x757413d0ae85d44e2aa8adf09b00c19be27346c7	TODO
	TODO	TODO	cardona:0xA239f92e2d4356b26118A0Cfb1d515C5C5AC5f16	TODO
(bw)Dolla	zkyoto:0xb89a7eb06f277c9105a91e523357972384c8a27d	TODO	TODO	TODO
L1Escrow	cardona:0x7242023A8C682A1B67376C82B36Fb49e098199E4	TODO	TODO	TODO
MinterBurner	n/a	sepolia:0x1fF8889219DdF5Fc867635716AEE2F4C9F21f980	TODO	TODO
NativeConverter (old)	n/a	sepolia:0x4D758bD4CE9F7ed1e03AdE50f1E2ef83c477113F	TODO	TODO
FakeQuickSwap	0xcc1d701a479979673715285c1ad768fa37b04856	0x820bf8c6Afc30c7934071779C3e2b175a15C3419	0xf43Fc6ae7eed237aB6d58fa2F4fB45d84C2Ff483	TODO
Fake kUSDC	n/a	TODO	TODO	TODO
Fake kbwAGG	n/a	TODO	sepolia:0x37715A4B43Abee5407d2D516a065c38d5A3C3A0E	TODO
	n/a	TODO	cardona:0x082b1110e5A9068dBfC654C54A23C4C10F23E9b2	TODO
KEOM Helper	TODO	0xDE978991D6756d0980B3435c3d6EB3CF7a4fE3cf	0x330bEaDD49c8E599442d2B51f02B23a087bf56cc	TODO
Swap Helper	0xC7458D4D5b6c5Acf627D3E27fa61E7BB393C5b51	TODO	TODO	TODO

Values Used for Deployment / Configuration

Role	Address
deployer	0xb67826C2176682Fd3Ae3e31A561fc4b9fb012225
owner/admin	0xf36aFDe6aE535D4445A17D2B63841FF34cF6C52b

Helpers

• Mint Fake ERC20s (AggLayerToken, Dolla)

export RPC=https://rpc.cardona.zkevm-rpc.com
export AGG=0x88342beb50513c9994696c1dadeedad5e8b763df
cast send --rpc-url ${RPC} -i --legacy ${AGG} "mint(address,uint256)" 0xb67826C2176682Fd3Ae3e31A561fc4b9fb012225 1000000000000000000000000

export RPC=https://rpc.startale.com/zkyoto
export DOLLA=0xe6e6809bBFA49cEE58988e532d71bddf83aD2A38
cast send --rpc-url ${RPC} -i --legacy ${DOLLA} "mint(address,uint256)" 0xb67826C2176682Fd3Ae3e31A561fc4b9fb012225 1000000000000000000000000

• Call USDC Native Converter

export RPC=https://rpc.cardona.zkevm-rpc.com

# convert (bwUSDC -> USDC)
cast send --rpc-url ${RPC} -i --legacy bwUSDC "approve(address,uint256)" 0x4D758bD4CE9F7ed1e03AdE50f1E2ef83c477113F 2000000
cast send --rpc-url ${RPC} -i --legacy 0x4D758bD4CE9F7ed1e03AdE50f1E2ef83c477113F "convert(address,uint256,bytes)" 0xb67826C2176682Fd3Ae3e31A561fc4b9fb012225 2000000 0x

# convert (USDC -> bwUSDC)
cast send --rpc-url ${RPC} -i --legacy 0xc1EF3FC60d6CfC83fe58Fd5f48aB75A20b2518C1 "approve(address,uint256)" 0x4D758bD4CE9F7ed1e03AdE50f1E2ef83c477113F 2000000
cast send --rpc-url ${RPC} -i --legacy 0x4D758bD4CE9F7ed1e03AdE50f1E2ef83c477113F "deconvert(address,uint256,bytes)" 0xb67826C2176682Fd3Ae3e31A561fc4b9fb012225 2000000 0x

• Find a Bridge Wrapped Address (without bridging)

export RPC=https://1rpc.io/sepolia
cast call --rpc-url ${RPC} 0x528e26b25a34a4A5d0dbDa1d57D318153d2ED582 "precalculatedWrapperAddress(uint32,address,string,string,uint8)" 2 0xe6e6809bBFA49cEE58988e532d71bddf83aD2A38 "Dolla" "DOLLA" 18

0. SETUP

CONTRACT DEPLOYMENT

export L1_RPC=
export L2_RPC=

USDC.e

1. Deploy USDC.e contracts to L2

forge script script/setup/USDCe.s.sol:DeployUSDCe --rpc-url ${L2_RPC} -vvvvv --legacy --broadcast

2. Deploy and initialize USDC-LxLy

3. Initialize USDC.e

forge script script/setup/USDCe.s.sol:InitUSDCe --rpc-url ${L2_RPC} -vvvvv --legacy --broadcast

USDC-LxLy

1. Deploy L1Escrow to L1

forge script script/setup/USDCLxLy.s.sol:DeployL1 --rpc-url ${L1_RPC} -vvvv --legacy --broadcast

2. Deploy MinterBurner+NativeConverter to L2

forge script script/setup/USDCLxLy.s.sol:DeployL2 --rpc-url ${L2_RPC} -vvvv --legacy --broadcast

3. set values in .env for ADDRESS_L1_ESCROW_PROXY, ADDRESS_ZK_MINTER_BURNER_PROXY, ADDRESS_NATIVE_CONVERTER_PROXY

4. Initialize L1Escrow

forge script script/setup/USDCLxLy.s.sol:InitL1 --rpc-url ${L1_RPC} -vvvv --legacy --broadcast

5. Initialize MinterBurner+NativeConverter

forge script script/setup/USDCLxLy.s.sol:InitL2 --rpc-url ${L2_RPC} -vvvv --legacy --broadcast

Bridge And Call

Deploy and Initialize BridgeExtension in all chains

export RPC=
forge script script/DeployInitBridgeAndCall.s.sol:DeployInitBridgeAndCall --rpc-url ${RPC} -vvvvv --legacy --broadcast

Helpers

• Deploy MultiCall

export RPC=
forge create ./src/MultiCall.sol:MultiCall --rpc-url ${RPC} --legacy --interactive

• Deploy a KEOMHelper

export RPC=https://rpc.cardona.zkevm-rpc.com
forge create --rpc-url ${RPC} ./src/KEOMHelper.sol:KEOMHelper --legacy --interactive

export RPC=https://rpc.startale.com/zkyoto
forge create --rpc-url ${RPC} ./src/KEOMHelper.sol:KEOMHelper --legacy --interactive

• Deploy a SwapHelper

export RPC=https://1rpc.io/sepolia
forge create --rpc-url ${RPC} ./src/SwapHelper.sol:SwapHelper --legacy --interactive

Mocks

• Deploy a FakeDolla

export RPC=https://rpc.startale.com/zkyoto
forge create ./src/FakeDolla.sol:FakeDolla --rpc-url ${RPC} --legacy --interactive

• Deploy a FakeQuickSwap

export RPC=https://1rpc.io/sepolia
forge create ./src/FakeQuickSwap.sol:FakeQuickSwap --rpc-url ${RPC} --legacy --interactive

• Deploy a FakeKEOM

export RPC=https://rpc.cardona.zkevm-rpc.com
forge create --rpc-url ${RPC} ./src/FakeKEOM.sol:FakeKEOM --constructor-args "KEOM USDC Market" "KUSDC" 0x150aE9614A43361775D9D3A006f75CCc558B598F --legacy --interactive

export RPC=https://rpc.startale.com/zkyoto
forge create --rpc-url ${RPC} ./src/FakeKEOM.sol:FakeKEOM --constructor-args "KEOM bwAggLayerToken Market" "KbwAGG" 0x757413d0ae85d44e2aa8adf09b00c19be27346c7 --legacy --interactive

1. DEMOS

TODO: excalidraw the demos

L1 to L2

Bridge L1 USDC for L2 USDCe

• run bridgeAndCall to L2 Native Converter
• claim asset, claim message
• check balance

Deposit L1 Token to L2 KEOM

• Setup required env vars (examples for Sepolia -> zKyoto)

export RPC=https://1rpc.io/sepolia
export DEPLOYER_PRIVATE_KEY=
export ADDRESS_BRIDGE_EXTENSION=0x2311BFA86Ae27FC10E1ad3f805A2F9d22Fc8a6a1
export LY_NETWORK_ID=2

export ADDRESS_LX_TOKEN=0x2170cc348ae3cfb77cde9c3ca6b279863df7e0bf
export ADDRESS_LY_TARGET=0x330bEaDD49c8E599442d2B51f02B23a087bf56cc
export ADDRESS_LY_TOKEN_BW=0x757413d0ae85d44e2aa8adf09b00c19be27346c7
export ADDRESS_LY_KTOKEN=0x37715A4B43Abee5407d2D516a065c38d5A3C3A0E
export AMOUNT_IN_DECIMALS=1000000000000000000000
export ADDRESS_DEPLOYER=0xb67826C2176682Fd3Ae3e31A561fc4b9fb012225

• Send the bridgeAndCall tx: this bridges $AGG from Sepolia to zKyoto ($bwAGG) and calls deposit to the corresponding KEOM market

forge script script/demos/L1L2BridgeAndDeposit.s.sol:KEOM --rpc-url ${RPC} -vvvv --legacy --broadcast

• Update the claim script with the token, tx hash, and networks

EDIT script/demos/L1L2BridgeAndDepositClaim.js

• Claim the message

node script/demos/L1L2BridgeAndDepositClaim.js

Note: You'll need to run npm install before using the script for the first time.

Swap L1 USDC for L2 AggLayerToken

• run bridgeAndCall to L2 QuickSwap for AggLayerToken
• claim asset, claim message
• check balance

L2 to L1

Bridge from L2 and Swap in L1

• Setup required env vars (examples for zKyoto -> Sepolia)

export RPC=https://rpc.startale.com/zkyoto
export DEPLOYER_PRIVATE_KEY=
export ADDRESS_BRIDGE_EXTENSION=0x2311BFA86Ae27FC10E1ad3f805A2F9d22Fc8a6a1
export LY_NETWORK_ID=0

export ADDRESS_LX_TOKEN=0xe6e6809bBFA49cEE58988e532d71bddf83aD2A38
export ADDRESS_LY_TARGET=0xC7458D4D5b6c5Acf627D3E27fa61E7BB393C5b51
export ADDRESS_LY_SWAPPER=0xcc1d701a479979673715285c1ad768fa37b04856
export ADDRESS_LY_TOKEN_SELL=0xb89a7eb06f277c9105a91e523357972384c8a27d
export ADDRESS_LY_TOKEN_BUY=0x0000000000000000000000000000000000000000
export AMOUNT_IN_DECIMALS=5000000000000000000000
export ADDRESS_DEPLOYER=0xb67826C2176682Fd3Ae3e31A561fc4b9fb012225

• Send the bridgeAndCall tx:

forge script script/demos/L2L1BridgeAndSwap.s.sol:BridgeAndSwap --rpc-url ${RPC} -vvvv --legacy --broadcast

• Update the claim script with the token, tx hash, and networks

EDIT script/demos/L2L1BridgeAndSwapClaim.js

• Claim the message

node script/demos/L2L1BridgeAndSwapClaim.js

Note: You'll need to run npm install before using the script for the first time.

L2 to L2

Deposit Lx AggLayerToken to Ly KEOM

• Setup required env vars (examples for Cardona -> zKyoto)

export RPC=https://rpc.cardona.zkevm-rpc.com
export DEPLOYER_PRIVATE_KEY=
export ADDRESS_BRIDGE_EXTENSION=0x2311BFA86Ae27FC10E1ad3f805A2F9d22Fc8a6a1
export LY_NETWORK_ID=2

export ADDRESS_LX_TOKEN=0x88342beb50513c9994696c1dadeedad5e8b763df
export ADDRESS_LY_TARGET=0x330bEaDD49c8E599442d2B51f02B23a087bf56cc
export ADDRESS_LY_TOKEN_BW=0xA239f92e2d4356b26118A0Cfb1d515C5C5AC5f16
export ADDRESS_LY_KTOKEN=0x082b1110e5A9068dBfC654C54A23C4C10F23E9b2
export AMOUNT_IN_DECIMALS=8000000000000000000000
export ADDRESS_DEPLOYER=0xb67826C2176682Fd3Ae3e31A561fc4b9fb012225

• Send the bridgeAndCall tx: this bridges $AGG from Cardona to zKyoto ($bwAGG) and calls deposit to the corresponding KEOM market

forge script script/demos/L2L2BridgeAndDeposit.s.sol:AGG --rpc-url ${RPC} -vvvv --legacy --broadcast

• Update the claim script with the token, tx hash, and networks

EDIT script/demos/L2L2BridgeAndDepositClaim.js

• Claim the message

node script/demos/L2L2BridgeAndDepositClaim.js

Note: You'll need to run npm install before using the script for the first time.

Bridge, Swap, and Return Unused

• send the bridge and call tx (for swaping)
• claim the tx 1 (does the swap for new token and sends a bridge tx)
• claim the tx 2

Bridge, Swap, Bridge, and Deposit

• TODO

L1 to L2 to L1

TODO:

L1 to L2 to L2 to L1

TODO: