Trading on CoW Protocol

# Order is signed off-chain
signature = sign_order(chain, account, order)

# Submitted to orderbook API, not blockchain
order_uid = await order_book_api.post_order(order_creation)

# Alice wants to sell 1000 USDC for WETH
alice_order = Order(
    sell_token=USDC,
    buy_token=WETH,
    sell_amount="1000000000",  # 1000 USDC
    buy_amount="500000000",    # At least 0.5 WETH
    kind="sell",
)

# Bob wants to sell 0.6 WETH for USDC
bob_order = Order(
    sell_token=WETH,
    buy_token=USDC,
    sell_amount="600000000",   # 0.6 WETH
    buy_amount="1100000000",   # At least 1100 USDC
    kind="sell",
)

# These orders can be matched directly!
# Both users get better prices than market rates
# No DEX fees, no slippage, minimal gas costs

# Traditional: Specify HOW to trade
router.swapExactTokensForTokens(
    amount_in=1000,
    amount_out_min=500,
    path=[USDC, WETH, DAI],  # You specify the route
    to=receiver,
    deadline=timestamp,
)

# CoW Protocol: Specify WHAT you want
order = Order(
    sell_token=USDC,
    buy_token=DAI,
    sell_amount="1000000000",
    buy_amount="990000000",  # Minimum acceptable
    # No routing path needed!
)

# Solvers figure out the optimal HOW:
# - Direct CoW matching?
# - Uniswap V3?
# - Curve?
# - Multi-hop routing?
# - Combination of sources?

# Just specify what you want to trade
result = await swap_tokens(
    amount=Wei(1000000000),
    account=account,
    chain=Chain.MAINNET,
    sell_token=SELL_TOKEN,
    buy_token=BUY_TOKEN,
)
# That's it! No routing, no path finding, no complex parameters

order = Order(
    sell_token=USDC,
    buy_token=WETH,
    sell_amount="1000000000",
    buy_amount="500000000",
    fee_amount="0",  # No explicit fee
)

order_quote = await order_book_api.post_quote(
    order_quote_request,
    order_side,
)
# quote.buyAmount already accounts for all fees

# You specify minimum acceptable
order = Order(
    sell_amount="1000000000",  # Sell 1000 USDC
    buy_amount="500000000",    # Get at least 0.5 WETH
)

# Solver finds better execution
# You might receive: 0.52 WETH
# Extra 0.02 WETH is your surplus!

import asyncio
from web3 import Account, Web3
from web3.types import Wei
from cowdao_cowpy.cow.swap import swap_tokens
from cowdao_cowpy.common.chains import Chain

async def simple_swap():
    account = Account.from_key(PRIVATE_KEY)

    result = await swap_tokens(
        amount=Wei(1000000000),
        account=account,
        chain=Chain.MAINNET,
        sell_token=Web3.to_checksum_address("0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"),  # USDC
        buy_token=Web3.to_checksum_address("0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"),   # WETH
    )

    print(f"Order submitted: {result.url}")

asyncio.run(simple_swap())

async def swap_with_slippage():
    account = Account.from_key(PRIVATE_KEY)

    result = await swap_tokens(
        amount=Wei(1000000000),
        account=account,
        chain=Chain.MAINNET,
        sell_token=SELL_TOKEN,
        buy_token=BUY_TOKEN,
        slippage_tolerance=0.01,  # 1% slippage tolerance
    )

    return result

asyncio.run(swap_with_slippage())

async def large_order():
    account = Account.from_key(PRIVATE_KEY)

    result = await swap_tokens(
        amount=Wei(1000000000000),  # Very large amount
        account=account,
        chain=Chain.MAINNET,
        sell_token=SELL_TOKEN,
        buy_token=BUY_TOKEN,
        partially_fillable=True,  # Allow partial fills
    )

    return result

asyncio.run(large_order())

from cowdao_cowpy.common.chains import Chain

# Ethereum Mainnet
result = await swap_tokens(chain=Chain.MAINNET, ...)

# Gnosis Chain - lower fees
result = await swap_tokens(chain=Chain.GNOSIS, ...)

# Arbitrum - L2 scaling
result = await swap_tokens(chain=Chain.ARBITRUM_ONE, ...)

# Sepolia Testnet - for testing
result = await swap_tokens(chain=Chain.SEPOLIA, ...)