v0.25.0

Changes

• feat(xrpl): XRPL full parity - payload model, parse helper, tests (v0.25.0)
• chore: remove accidentally-committed .claude/irc-agent files; gitignore .claude
• feat(xrpl): add XRP Ledger support; normalize line endings to LF (0.24.0)
• feat(xrpl): add XRP Ledger network support (v0.23.0)
• fix(escrow): update SKALE + Base operator addresses to Fase 5 production

Installation

pip install uvd-x402-sdk==0.25.0

v0.22.1

docs: comprehensive README update

• Updated version banner to v0.22.0
• Added Server-Side Signing section (connect_with_private_key)
• Added commerce scheme to features list
• Updated ERC-8004 from 18 to 20 networks
• Added changelog entries for v0.13.2 through v0.22.0 (9 missing versions)

v0.22.0

feat: add commerce + escrow scheme support

• PaymentPayload, PaymentRequirements, PaymentRequirementsV2 now accept scheme: exact | escrow | commerce
• Aligns with facilitator v1.43.0 which serves 'commerce' as alias for 'escrow'
• Default scheme remains 'exact' — no breaking changes
• 4 new tests for scheme validation

v0.21.0

feat: AdvancedEscrowClient supports WalletAdapter for OWS escrow

• AdvancedEscrowClient now accepts WalletAdapter protocol for signing
• Enables Open Wallet Standard (OWS) integration for escrow operations
• Backward compatible: still supports direct private key usage

v0.20.0

WalletAdapter Protocol (v0.20.0)

• WalletAdapter - Abstract Protocol interface for any wallet backend (runtime-checkable)
• EnvKeyAdapter - Uses raw private key from env var (WALLET_PRIVATE_KEY / PRIVATE_KEY) or direct param
• OWSWalletAdapter - Stub for Open Wallet Standard (not yet on PyPI)
• TypedDict types: EIP3009Params, EIP3009Authorization, SignedTypedData
• Auto-detects USDC contract addresses and EIP-712 domain names per network
• Uses proven encode_typed_data() + sign_message() signing pattern

Install

pip install uvd-x402-sdk[wallet]

Breaking Changes

• eth-account minimum bumped from >=0.10.0 to >=0.11.0 across all extras (signer, wallet, web3)

v0.19.4

What's New

• feat(erc8004): add get_identity_by_owner(network, address) — resolve agent ID by wallet address
• feat(erc8004): add SKALE to ERC-8004 networks (20 total)
• docs: register_agent() is now idempotent (returns existing agent if recipient already owns one)

Install

pip install uvd-x402-sdk==0.19.4

v0.19.3

What's New

• feat(erc8004): add SKALE to ERC-8004 networks (20 total)
• feat(escrow): add OPERATOR_ABI_V2 with bytes data param for CREATE3 chains
• fix(escrow): update SKALE default operator to EM-deployed 0x28c2
• feat(escrow): add SKALE Base escrow support via CREATE3 contracts
• fix: add EVM-only guard in create_authorization + update CLAUDE.md docs

Install

pip install uvd-x402-sdk==0.19.3

v0.19.2

SKALE Base Escrow Support + ABI v2

New Features

• SKALE Base escrow (chain 1187947933) via CREATE3 contracts — 11 escrow chains total
• OPERATOR_ABI_V2 with bytes data param on release() and refundInEscrow() for CREATE3 chains
• CREATE3_CHAIN_IDS set + get_operator_abi() helper for automatic ABI selection

Fixes

• Default SKALE operator updated to EM-deployed 0x28c23AE8f55aDe5Ea10a5353FC40418D0c1B3d33
• Legacy chains (Base, Ethereum, etc.) unaffected — still use v1 ABI

Contract Addresses (SKALE Base)

• Escrow: 0xBC151792f80C0EB1973d56b0235e6bee2A60e245
• Operator: 0x28c23AE8f55aDe5Ea10a5353FC40418D0c1B3d33
• OperatorFactory: 0x3Cd5c76Fefe46CB07788Ee8f80B93B20D81941D4
• TokenCollector: 0x9A12A116a44636F55c9e135189A1321Abcfe2f30
• ProtocolFeeConfig: 0xf62788834C99B2E85a6891C0b46D1EB996f8f596
• RefundRequest: 0x69e9BF2b40Ed472b55E47e9D4205d93Ed673093F

Compatibility

• Facilitator v1.40.5+
• TS SDK v2.32.2+

v0.18.0

What's New

• connect_with_private_key() — Server-side EVM signer without browser wallet
• create_authorization() — Create signed EIP-3009 X-PAYMENT headers programmatically
• New [signer] optional dependency: pip install uvd-x402-sdk[signer]
• Fixed supported_networks default config to include all 21 chains (was missing Scroll, SKALE, Algorand, Sui)

Usage

from uvd_x402_sdk import X402Client
from decimal import Decimal
import os

client = X402Client(recipient_address="0xMerchant...")
client.connect_with_private_key(os.environ['PRIVATE_KEY'], 'skale-base')

header = client.create_authorization(
    pay_to="0xRecipient...",
    amount_usd=Decimal("0.01"),
)
# Use header as X-PAYMENT in HTTP requests

Install

pip install uvd-x402-sdk[signer]==0.18.0

v0.17.0

What's New

• SKALE Base network support — Added skale-base (mainnet, chainId 1187947933) and skale-base-sepolia (testnet, chainId 324705682)
• EIP-712 domain name: Bridged USDC (SKALE Bridge) (version 2)
• USDC.e bridged token support via SKALE Bridge
• Gasless transactions (CREDIT gas token)
• CAIP-2 identifiers: eip155:1187947933, eip155:324705682

Recent Commits

• feat(networks): add SKALE Base network support (skale-base + skale-base-sepolia)
• docs: update CLAUDE.md and README.md for SKALE Base network

Install

pip install uvd-x402-sdk==0.17.0