ab833b38cf
* refactoring for multidelivery * partial ts-test fixes * use typechain in integration tests, update prettier, fix remaining integration tests * run formatter on solidity files * gas refunding * gas forwarding logic * msg.send -> refundAmount * minor test refactor & additions * created relayer engine directory * more testing & tilt environment config for relayer engine * starting work on the xMint example contracts * additions for relayer engine * minor modifications & todos * fixed some errors * refactoring + cleaned up some TODOs * updated ICoreRelayer interface * adjusted tests for new interface * Working testSend * Merged refactoring + cleaned up some TODOs * updated ICoreRelayer interface * adjusted tests for new interface * Working testSend with new interface' * refactoring interfaces & files for single VAA design * GasOracle implementation of new interface * GasOracle compiles * Gas oracle upgradable * Fix compile errors in GasOracleGovernance * minor core relayer cleanup * Changes to getters, setters, state * implement quoteEvmDeliveryPrice, quoteTargetEvmGas, assetConversionAmount for corerelayer * Correcting interface inconsistencies between CoreRelayerStructs and ICoreRelayer * Fix encodeDeliveryRequestsContainer * added single vaa delivery entrypoint logic * Encode and Decode delivery instructions * Fixed many compile errors * First attempt at removing stacktoodeep error * Commenting out chunks of code to identify stack too deep error * Continue stack too deep quest * Revert "Commenting out chunks of code to identify stack too deep error" This reverts commit |
||
---|---|---|
.. | ||
contracts | ||
forge-scripts | ||
forge-test | ||
shell-scripts | ||
ts-scripts | ||
ts-test | ||
.dockerignore | ||
.env.template | ||
.env.test | ||
.gitignore | ||
Dockerfile | ||
Makefile | ||
README.md | ||
VERIFY.md | ||
anvil_fork | ||
copy-from-container.sh | ||
foundry | ||
foundry.toml | ||
package-lock.json | ||
package.json | ||
truffle-config.js | ||
tsconfig.json |
README.md
Wormhole bridge - ETH
These smart contracts allow to use Ethereum as foreign chain in the Wormhole protocol.
The Wormhole
contract is the bridge contract and allows tokens to be transferred out of ETH and VAAs to be submitted
to transfer tokens in or change configuration settings.
The WrappedAsset
is a ERC-20 token contract that holds metadata about a wormhole asset on ETH. Wormhole assets are all
wrapped non-ETH assets that are currently held on ETH.
Deploying
To deploy the bridge on Ethereum you first need to compile all smart contracts:
npx truffle compile
To deploy you can either use the bytecode from the build/contracts
folder or the oz cli oz deploy <Contract>
(Documentation).
You first need to deploy one Wrapped Asset
and initialize it using dummy data.
Then deploy the Wormhole
using the initial guardian key (key_x,y_parity,0
) and the address of the previously deployed
WrappedAsset
. The wrapped asset contract will be used as proxy library to all the creation of cheap proxy wrapped
assets.
Testing
For each test run:
Run npx ganache-cli --deterministic --time "1970-01-01T00:00:00+00:00"
to start a chain.
Run the all ethereum tests using make test
Run a specific test file using npx truffle test test/wormhole.js
Run a specific test file while skipping compile npx truffle test test/wormhole.js --compile-none
User methods
submitVAA(bytes vaa)
can be used to execute a VAA.
lockAssets(address asset, uint256 amount, bytes32 recipient, uint8 target_chain)
can be used
to transfer any ERC20 compliant asset out of ETH to any recipient on another chain that is connected to the Wormhole
protocol. asset
is the asset to be transferred, amount
is the amount to transfer (this must be <= the allowance that
you have previously given to the bridge smart contract if the token is not a wormhole token), recipient
is the foreign
chain address of the recipient, target_chain
is the id of the chain to transfer to.
lockETH(bytes32 recipient, uint8 target_chain)
is a convenience function to wrap the Ether sent with the function call
and transfer it as described in lockAssets
.
Forge
Some tests and scripts use Foundry. It can be installed via the official installer, or by running
wormhole/ethereum $ ../scripts/install-foundry
The installer script installs foundry and the appropriate solc version to build the contracts.
Batched VAAs
To send a transaction that will create multiple VAAs, invoke the sendMultipleMessages
method of ethereum/contracts/mock/MockBatchedVAASender.sol with the truffle script:
npx truffle exec scripts/send_batched_vaa.js
or invoke the same script in the tilt devnet:
minikube kubectl -- exec -n wormhole eth-devnet-0 -c tests -- npx truffle exec scripts/send_batched_vaa.js