How the Address Factory Works

​

Purpose

• Address generation: Computes programmable addresses without onchain transactions
• Contract deployment: Deploys programmable address contracts when funds are received
• Configuration storage: Holds immutable settings for all programmable address contracts it creates

​

Constructor

constructor(
    uint64 _destinationChain,
    address _sourceToken,
    bytes32 _targetToken,
    address _portalAddress,
    address _proverAddress,
    bytes32 _destinationPortal,
    uint64 _intentDeadlineDuration
)

​

Functions

​

getDepositAddress

function getDepositAddress(bytes32 destinationAddress)
    external view returns (address)

• destinationAddress: destination wallet address as bytes32 (cross-VM compatible)

• The EVM address where the user should send tokens

​

isDeployed

function isDeployed(bytes32 destinationAddress)
    external view returns (bool)

​

deploy

function deploy(
    bytes32 destinationAddress,
    address depositor
) external returns (address deployed)

• destinationAddress: destination wallet address as bytes32 (cross-VM compatible)
• depositor: Address authorized to trigger refunds

• Address of the deployed programmable address contract

​

getConfiguration

function getConfiguration() external view returns (
    uint64 destinationChain,
    address sourceToken,
    bytes32 targetToken,
    address portalAddress,
    address proverAddress,
    bytes32 destinationPortal,
    uint64 intentDeadlineDuration
)

​

Configuration Getters

• DESTINATION_CHAIN() - Target chain ID
• SOURCE_TOKEN() - Source token address
• TARGET_TOKEN() - Target token (bytes32)
• PORTAL_ADDRESS() - Portal contract address
• PROVER_ADDRESS() - Prover contract address
• DESTINATION_PORTAL() - Destination portal (bytes32)
• INTENT_DEADLINE_DURATION() - Deadline duration
• DEPOSIT_IMPLEMENTATION() - Implementation contract address

​

Events

​

DepositContractDeployed

event DepositContractDeployed(
    bytes32 indexed destinationAddress,
    address indexed depositAddress
)

​

Errors

​

ContractAlreadyDeployed

error ContractAlreadyDeployed(address depositAddress)

​

InvalidDeadlineDuration

error InvalidDeadlineDuration()

​

InvalidPortalAddress

error InvalidPortalAddress()

​

InvalidProverAddress

error InvalidProverAddress()

​

InvalidSourceToken

error InvalidSourceToken()

​

InvalidTargetToken

error InvalidTargetToken()

​

InvalidDestinationPortal

error InvalidDestinationPortal()