Contract Factories

​

What are Factories?

• Type Safety: Full TypeScript types for all contract methods, events, and parameters
• Deployment: Methods to deploy new contract instances
• Connection: Methods to connect to existing deployed contracts
• ABI Access: Direct access to contract ABIs
• Bytecode: Access to contract bytecode for deployment

​

Factory Naming Convention

• GenericSwapFacet → GenericSwapFacet__factory
• Executor → Executor__factory
• DiamondCutFacet → DiamondCutFacet__factory

​

Available Factories

​

Bridge Facets

• AcrossFacet__factory
• AcrossFacetV3__factory
• ArbitrumBridgeFacet__factory
• HopFacet__factory
• StargateFacet__factory
• And many more…

​

Swap Facets

• GenericSwapFacet__factory
• GenericSwapFacetV3__factory
• SwapperV2__factory

​

Utility Facets

• Executor__factory
• FeeCollector__factory
• WithdrawFacet__factory
• WhitelistManagerFacet__factory
• AccessManagerFacet__factory

​

Diamond Standard

• DiamondCutFacet__factory
• DiamondLoupeFacet__factory
• OwnershipFacet__factory

​

Interfaces

• ILiFi__factory
• IERC20__factory
• IDiamondLoupe__factory

​

Common Factory Properties

class ContractName__factory {
  // Contract ABI
  static readonly abi: any[];
  
  // Contract bytecode (for deployable contracts)
  static readonly bytecode?: string;
  
  // Create type-safe contract instance
  static connect(
    address: string,
    signerOrProvider: Signer | Provider
  ): ContractName;
  
  // Deploy new contract (if bytecode available)
  static deploy(
    signer: Signer,
    ...constructorArgs: any[]
  ): Promise<ContractName>;
}

​

Import Patterns

​

Individual Import

import { GenericSwapFacet__factory } from '@lifi/contract-types';

​

Multiple Imports

import {
  GenericSwapFacet__factory,
  Executor__factory,
  DiamondCutFacet__factory
} from '@lifi/contract-types';

​

Factories Directory Import

import { GenericSwapFacet__factory } from '@lifi/contract-types/factories/GenericSwapFacet__factory';

​

Type Imports

import {
  GenericSwapFacet,
  GenericSwapFacet__factory
} from '@lifi/contract-types';

const facet: GenericSwapFacet = GenericSwapFacet__factory.connect(
  address,
  provider
);

​

Next Steps

• See Factory Usage for detailed examples
• Explore specific facet documentation for contract-specific usage
• Check the TypeChain documentation for advanced features