Hash Time Locked Contract

Enables trustless atomic swaps and escrow for inscriptions and NFTs on EVM chains using Hash Time Locked Contracts.

HTLC Trade

Atomic swap trading using Hash Time Locked Contracts.

Quick Start

bash

# Install dependencies
npm install ethers viem

# Set environment
export PRIVATE_KEY=0x...
export BASE_ETH_RPC=https://mainnet.base.org

Commands

Generate Preimage

bash

node scripts/htlc.js preimage

Lock Funds (Buyer)

bash

node scripts/htlc.js lock <seller> <preimageHash> <timeout> <amountETH>

Reveal (Seller)

bash

node scripts/htlc.js reveal <lockHash> <preimage>

Full Trade

bash

node scripts/htlc.js trade <seller> <inscriptionTx> <amountETH>

Contract

BaseTimelock: 0xa7f9f88e753147d69baf8f2fef89a551680dbac1

Flow

1. Seller generates preimage, shares hash + inscription
2. Buyer verifies inscription, calls lock() with ETH
3. Seller calls reveal() with preimage → ETH released
4. Buyer confirms receipt → trade complete