feat(script): support custom create2 deployer

[jsvisa]

Motivation

Currently when deploy contracts using CREATE2 method, it is default to

foundry/crates/evm/core/src/constants.rs

Line 44 in fcaa2a7

pub const DEFAULT_CREATE2_DEPLOYER: Address = address!("4e59b44847b379578588920ca78fbf26c0b4956c");

But in some circumstances, we can't access or deploy the 0x4e59b44847b379578588920ca78fbf26c0b4956c contract, may be caused of not able to send the pre EIP155 raw transaction. So try to introduce a env to change the default create2 deployer.

Solution

If user run forge with env FOUNDRY_CREATE2_DEPLOYER, it will use this address instead of the default one.

[grandizzy]

@jsvisa thank you! there's #2638 I think your PR could be closing it, can you pls confirm?

[jsvisa]

@jsvisa thank you! there's #2638 I think your PR could be closing it, can you pls confirm?

I think we can close the later one 😀

let user define create2 factory

[grandizzy]

I think we can close the later one 😀

Makes sense, waiting for a follow up project to close it then 😀

[jsvisa]

Makes sense, waiting for a follow up project to close it then 😀

Haha, so how about this one, is there anything I need to adjust

[grandizzy]

From what I see the PR is only for script, but it won't be applied in other scopes, as for labels in traces, contract verification, (default) computeCreate2Address cheatcode and other places, which I think could lead to inconsistencies in deployment process? I'd say a consistent experience would be preferred here, that is when setting the address as env var then to be reflected in all places.

[jsvisa]

@grandizzy thanks for the advice, I use forge to deploy contracts in a private evm chain, so only tested the script yet. Thanks for the scope you mentioned, I'll implement them later(maybe after the Devcon) :)

And If the changes are large, I'd prefer to split them into small PRs to include them all, else just in this one PR, WDYT?

[grandizzy]

@grandizzy thanks for the advice, I use forge to deploy contracts in a private evm chain, so only tested the script yet. Thanks for the scope you mentioned, I'll implement them later(maybe after the Devcon) :)

And If the changes are large, I'd prefer to split them into small PRs to include them all, else just in this one PR, WDYT?

ah, I see, then maybe should be done as a new --create2-address script arg instead env var... @zerosnacks @mattsse @yash-atreya could you please share your thoughts on this approach? thank you!

[jsvisa]

ah, I see, then maybe should be done as a new --create2-address script arg instead env var

I've tried this approach, but failed, we need to register the create2 handler here

foundry/crates/evm/core/src/utils.rs

Lines 177 to 210 in 5e254e0

	pub fn create2_handler_register<I: InspectorExt>(
	handler: &mut EvmHandler<'_, I, &mut dyn DatabaseExt>,
	) {
	let create2_overrides = Rc::<RefCell<Vec<_>>>::new(RefCell::new(Vec::new()));
	let create2_overrides_inner = create2_overrides.clone();
	let old_handle = handler.execution.create.clone();
	handler.execution.create =
	Arc::new(move |ctx, mut inputs| -> Result<FrameOrResult, EVMError<DatabaseError>> {
	let CreateScheme::Create2 { salt } = inputs.scheme else {
	return old_handle(ctx, inputs);
	};
	if !ctx.external.should_use_create2_factory(&mut ctx.evm, &mut inputs) {
	return old_handle(ctx, inputs);
	}
	let gas_limit = inputs.gas_limit;
	// Get CREATE2 deployer.
	let create2_deployer = get_create2_deployer();
	// Generate call inputs for CREATE2 factory.
	let mut call_inputs = get_create2_factory_call_inputs(salt, *inputs, create2_deployer);
	// Call inspector to change input or return outcome.
	let outcome = ctx.external.call(&mut ctx.evm, &mut call_inputs);
	// Push data about current override to the stack.
	create2_overrides_inner
	.borrow_mut()
	.push((ctx.evm.journaled_state.depth(), call_inputs.clone()));
	// Sanity check that CREATE2 deployer exists.
	let code_hash = ctx.evm.load_account(create2_deployer)?.info.code_hash;
	if code_hash == KECCAK_EMPTY {

seems it's hard to pass the cli argument into create2 schema, else maybe we need to adjust it in revm's codebase.

[klkvr]

@grandizzy wdyt on making this a Config field? so that you can configure it through foundry.toml as well

[grandizzy]

good point, yep, would be great to have such

[klkvr]

ah, I see, then maybe should be done as a new --create2-address script arg instead env var

I've tried this approach, but failed, we need to register the create2 handler here

foundry/crates/evm/core/src/utils.rs

Lines 177 to 210 in 5e254e0

	pub fn create2_handler_register<I: InspectorExt>(
	handler: &mut EvmHandler<'_, I, &mut dyn DatabaseExt>,
	) {
	let create2_overrides = Rc::<RefCell<Vec<_>>>::new(RefCell::new(Vec::new()));
	let create2_overrides_inner = create2_overrides.clone();
	let old_handle = handler.execution.create.clone();
	handler.execution.create =
	Arc::new(move |ctx, mut inputs| -> Result<FrameOrResult, EVMError<DatabaseError>> {
	let CreateScheme::Create2 { salt } = inputs.scheme else {
	return old_handle(ctx, inputs);
	};
	if !ctx.external.should_use_create2_factory(&mut ctx.evm, &mut inputs) {
	return old_handle(ctx, inputs);
	}
	let gas_limit = inputs.gas_limit;
	// Get CREATE2 deployer.
	let create2_deployer = get_create2_deployer();
	// Generate call inputs for CREATE2 factory.
	let mut call_inputs = get_create2_factory_call_inputs(salt, *inputs, create2_deployer);
	// Call inspector to change input or return outcome.
	let outcome = ctx.external.call(&mut ctx.evm, &mut call_inputs);
	// Push data about current override to the stack.
	create2_overrides_inner
	.borrow_mut()
	.push((ctx.evm.journaled_state.depth(), call_inputs.clone()));
	// Sanity check that CREATE2 deployer exists.
	let code_hash = ctx.evm.load_account(create2_deployer)?.info.code_hash;
	if code_hash == KECCAK_EMPTY {

seems it's hard to pass the cli argument into create2 schema, else maybe we need to adjust it in revm's codebase.

we can add a helper to InspectorExt to get the deployer address and then just configureInspectorStack with it

[jsvisa]

ah, I see, then maybe should be done as a new --create2-address script arg instead env var

I've tried this approach, but failed, we need to register the create2 handler here

foundry/crates/evm/core/src/utils.rs

Lines 177 to 210 in 5e254e0

	pub fn create2_handler_register<I: InspectorExt>(
	handler: &mut EvmHandler<'_, I, &mut dyn DatabaseExt>,
	) {
	let create2_overrides = Rc::<RefCell<Vec<_>>>::new(RefCell::new(Vec::new()));
	let create2_overrides_inner = create2_overrides.clone();
	let old_handle = handler.execution.create.clone();
	handler.execution.create =
	Arc::new(move |ctx, mut inputs| -> Result<FrameOrResult, EVMError<DatabaseError>> {
	let CreateScheme::Create2 { salt } = inputs.scheme else {
	return old_handle(ctx, inputs);
	};
	if !ctx.external.should_use_create2_factory(&mut ctx.evm, &mut inputs) {
	return old_handle(ctx, inputs);
	}
	let gas_limit = inputs.gas_limit;
	// Get CREATE2 deployer.
	let create2_deployer = get_create2_deployer();
	// Generate call inputs for CREATE2 factory.
	let mut call_inputs = get_create2_factory_call_inputs(salt, *inputs, create2_deployer);
	// Call inspector to change input or return outcome.
	let outcome = ctx.external.call(&mut ctx.evm, &mut call_inputs);
	// Push data about current override to the stack.
	create2_overrides_inner
	.borrow_mut()
	.push((ctx.evm.journaled_state.depth(), call_inputs.clone()));
	// Sanity check that CREATE2 deployer exists.
	let code_hash = ctx.evm.load_account(create2_deployer)?.info.code_hash;
	if code_hash == KECCAK_EMPTY {

seems it's hard to pass the cli argument into create2 schema, else maybe we need to adjust it in revm's codebase.

we can add a helper to InspectorExt to get the deployer address and then just configureInspectorStack with it

Thanks for the advice, I'll have a try, cli argument is much more implicit than environment.