Deployment Guide

# Clone the repository
git clone https://github.com/zkp2p/zkp2p-v2-contracts.git
cd zkp2p-v2-contracts

# Install dependencies
yarn install

cp .env.default .env

# Required for deployment
ALCHEMY_API_KEY=your_alchemy_api_key_here
BASE_DEPLOY_PRIVATE_KEY=your_mainnet_deployer_private_key
TESTNET_DEPLOY_PRIVATE_KEY=your_testnet_deployer_private_key

# Required for contract verification
BASESCAN_API_KEY=your_basescan_api_key_here
ETHERSCAN_KEY=your_etherscan_api_key_here

# Optional: For legacy networks
INFURA_TOKEN=your_infura_token_here

yarn chain

yarn deploy:localhost

yarn deploy:base_sepolia

deployments/base_sepolia/
├── Escrow.json
├── Orchestrator.json
├── UnifiedPaymentVerifier.json
└── ...

deployments/outputs/baseSepoliaContracts.ts

yarn etherscan:base_sepolia

export const INTENT_EXPIRATION_PERIOD = {
  "base": SIX_HOURS_IN_SECONDS,  // 6 hours
};

export const PROTOCOL_TAKER_FEE = {
  "base": ZERO,  // No protocol fee
};

export const MULTI_SIG = {
  "base": "0x0bC26FF515411396DD588Abd6Ef6846E04470227",
};

export const USDC = {
  "base": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
};

yarn deploy:base

yarn etherscan:base

// Intent expiration periods
export const INTENT_EXPIRATION_PERIOD = {
  "localhost": ONE_DAY_IN_SECONDS,
  "base": SIX_HOURS_IN_SECONDS,
  "base_sepolia": ONE_HOUR_IN_SECONDS,
};

// Protocol fees
export const PROTOCOL_TAKER_FEE = {
  "localhost": ether(.001),
  "base": ZERO,
  "base_sepolia": ZERO,
};

// Dust collection
export const ESCROW_DUST_THRESHOLD = {
  "localhost": usdc(0.1),
  "base": usdc(0.1),
  "base_sepolia": usdc(0.1),
};

// Concurrent intents
export const MAX_INTENTS_PER_DEPOSIT = {
  "localhost": 100,
  "base": 200,
  "base_sepolia": 200,
};

export const DEPLOY_TX_DELAY_MS = {
  localhost: 0,           // No delay needed
  base: 8000,            // 8 seconds
  base_staging: 5000,    // 5 seconds
  base_sepolia: 5000,    // 5 seconds
};

cat deployments/base/Escrow.json | jq '.address'
cat deployments/base/Orchestrator.json | jq '.address'

yarn test:deploy

test/deploy/00_system.spec.ts
test/deploy/01_unifiedVerifier.spec.ts
test/deploy/02_venmoPaymentMethod.spec.ts
...

npx hardhat console --network base

> const escrow = await ethers.getContractAt('Escrow', '<ESCROW_ADDRESS>')
> await escrow.owner()
// Should return multisig: 0x0bC26FF515411396DD588Abd6Ef6846E04470227

export const DEPLOY_TX_DELAY_MS = {
  base: 10000,  // Increase from 8000 to 10000
};

# Get deployer address
npx hardhat console --network base_sepolia
> const [deployer] = await ethers.getSigners()
> deployer.address

func.skip = async (hre: HardhatRuntimeEnvironment): Promise<boolean> => {
  const network = hre.network.name;
  if (network === "localhost" || network === "hardhat") {
    return false;  // Don't skip for local networks
  }
  return true;  // Skip for other networks (already deployed)
};

// config/contracts.ts
export const CONTRACTS = {
  base: {
    escrow: '0x2f121CDDCA6d652f35e8B3E560f9760898888888',
    orchestrator: '0x88888883Ed048FF0a415271B28b2F52d431810D0',
    // ... other contracts
  }
};

# Deploy only the core system
npx hardhat deploy --network base_sepolia --tags system

# Deploy only payment verifiers
npx hardhat deploy --network base_sepolia --tags verifiers

func.skip = async (hre: HardhatRuntimeEnvironment): Promise<boolean> => {
  return true;  // Always skip this script
};

# Start local node
yarn chain

# Deploy locally
yarn deploy:localhost

# Run integration tests
yarn test:integration