Skip to content

README.md

Latest commit

 

History

History
60 lines (46 loc) · 1.78 KB

README.md

File metadata and controls

60 lines (46 loc) · 1.78 KB
Raw

Contracts

Minimal on-chain footprint to keep things simple.

PaymentRouter.sol

  • Forwards ETH/ERC20 (e.g., USDC) directly to the merchant.
  • Emits PaymentReceived(invoiceId, payer, token, merchant, amount) for off-chain attribution.
  • No custody, no storage; purely pass-through.

Compile & Deploy (Foundry)

forge init invoisio-contracts
cp contracts/PaymentRouter.sol src/PaymentRouter.sol
forge build
forge create --rpc-url $RPC --private-key $PK src/PaymentRouter.sol:PaymentRouter

Compile & Deploy (Hardhat)

# one-time setup already scaffolded in repo under /hardhat
cd hardhat
npm install
cp ../contracts/PaymentRouter.sol contracts/PaymentRouter.sol  # optional if you change the contract

# fill .env with your Base RPC and PRIVATE_KEY
cp .env.example .env
# edit .env to set PRIVATE_KEY and RPC_URL

# compile and deploy to Base Sepolia
npm run compile
npm run deploy:baseSepolia

# after deploy, set the backend env
# EVM_ROUTER_ADDRESS=<deployed_address>

Note: You can start without deploying this contract. Direct ETH/USDC transfers to EVM_MERCHANT_ADDRESS work fine, and the backend watcher will detect payments.

Deployment Records (Base)

Fill these in for submission:

  • Network: Base Sepolia (chainId=84532)
  • Router address: 0x____________________________
  • USDC address (optional): 0x____________________________
  • Default merchant (optional): 0x____________________________

Proof of Transaction

  • Demo payment tx hash: 0x________________________________________
  • Basescan link: https://sepolia.basescan.org/tx/0x________________________________________
  • Block: _______

Generate via:

cd hardhat
set ROUTER_ADDRESS=0xDeployedRouter
set MERCHANT_ADDRESS=0xYourMerchant
npx hardhat run scripts/tx-demo.js --network baseSepolia