PWN Safe Factory

1. Summary

PWN Safe Factory is used to deploy new PWN Safes and keep track of all deployed PWN Safes. This contract also implements IPWNSafeValidator interface so it can validate genuine PWN Safes.

2. Important links

https://github.com/PWNFinance/pwn_safe/blob/main/src/factory/PWNSafeFactory.solgithub.com

GitHub

5KB

PWNSafeFactory.json

3. Contract details

• PWNSafeFactory.sol is written in Solidity version 0.8.15

Features

• Deploy new PWN Safe Proxys

• Check if an address is a valid PWN Safe

Functions

deployProxy

Overview

A user can deploy a new PWN Safe proxy by calling the deployProxy function.

This function takes two arguments supplied by the caller:

• address[] calldataowners - Array of addresses which will be able to sign transactions for this Safe

• uint256threshold - Amount of owner signatures required for a valid transaction

Implementation

function deployProxy(
	address[] calldata owners,
	uint256 threshold
) external returns (GnosisSafe) {
	// Deploy new gnosis safe proxy
	GnosisSafeProxy proxy = gnosisSafeProxyFactory.createProxy(gnosisSafeSingleton, "");
	GnosisSafe safe = GnosisSafe(payable(address(proxy)));

	// Setup safe
	safe.setup(
		owners, // _owners
		threshold, // _threshold
		address(this), // to
		abi.encodeWithSelector(PWNSafeFactory.setupNewSafe.selector), // data
		fallbackHandler, // fallbackHandler
		address(0), // paymentToken
		0, // payment
		payable(address(0)) // paymentReceiver
	);

	// Store as valid address
	isValidSafe[address(safe)] = true;

	// Emit event
	emit PWNSafeDeployed(address(safe));

	return safe;
}

isValidSafe

Overview

Getter function for the isValidSafe mapping (address => bool) stored inside the PWN Safe Factory contract.

This function returns true if a given address is a valid PWN Safe Proxy and returns false otherwise.

Implementation

function isValidSafe(address safe) external view returns (bool);

mapping(address => bool) public isValidSafe;

setupNewSafe

Overview

Set up function for a new PWN Safe. It ensures Safe has the correct Safe singleton, and initialises the Safe with the correct ATR Module and Guard. Only the PWN Safe Proxy can call this function.

This function does not define any parameters.

Implementation

function setupNewSafe() external {
    // Check that is called via delegatecall
    require(
        address(this) != pwnFactorySingleton,
        "Should only be called via delegatecall"
    );

    // Check that caller is GnosisSafeProxy
    // Need to hash bytes arrays first, because solidity cannot compare byte arrays directly
    require(
        keccak256(gnosisSafeProxyFactory.proxyRuntimeCode()) ==
            keccak256(address(this).code),
        "Caller is not gnosis safe proxy"
    );

    // Check that proxy has correct singleton set
    // GnosisSafeStorage.sol defines singleton address at the first position (-> index 0)
    bytes memory singletonValue = StorageAccessible(address(this))
        .getStorageAt(0, 1);
    require(
        bytes32(singletonValue) ==
            bytes32(uint256(uint160(gnosisSafeSingleton))),
        "Proxy has unsupported singleton"
    );

    _storeGuardAndModule();
}

Events

The PWN Safe Factory contract defines one event and no custom errors.

event PWNSafeDeployed(address indexed safe);

PWNSafeDeployed

PWNSafeDeployed event is emitted when a new PWN Safe Proxy is deployed by the deployProxy function.

This event has one parameter:

• address indexedsafe - Address of the newly deployed proxy contract