INVALID_ADDRESS_FORMAT error

​

What happened

{
  "type": "INVALID_ADDRESS_FORMAT",
  "title": "Invalid Address Format",
  "status": 400,
  "detail": "The provided blockchain address does not match the expected format for ETHEREUM.",
  "resolution": "Use an all-lowercase EVM address or a correctly EIP-55-checksummed mixed-case address.",
  "docs": "/errors#invalid-address-format",
  "instance": "/v2/payouts",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

​

Common causes

• Mixed-case EVM address with wrong checksum — the address has a mix of upper and lower case letters but does not satisfy EIP-55; the checksum is defined by the hex value of the address, not arbitrary capitalization
• Copy-paste truncation — the address was truncated or has extra whitespace, making it the wrong length
• Mistyped Tron or Stellar address — one wrong character breaks the address checksum; copy the address again from its source wallet
• Wrong chain’s format — a Tron Base58 address was supplied for an Ethereum destination, or vice versa

​

Recovery

0xABCdef... → 0xabcdef...

import { getAddress } from "viem";
const checksummed = getAddress("0xabcdef..."); // Returns correctly capitalized EIP-55 form

curl -X POST https://api.conduit.financial/v2/payouts \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: idem_NEW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cus_034A0gCCVsxdV2PjHLx9k1",
    "assetAmount": {"code": "USDC", "amount": "50.000000", "chain": "ethereum"},
    "destination": {
      "type": "crypto",
      "recipient": {
        "chain": "ethereum",
        "address": "0xabcdef1234567890abcdef1234567890abcdef12",
        "attestation": { "custody": "self" }
      }
    }
  }'

​

Prevention

• Normalize EVM addresses at collection time — when accepting an EVM address from a user or an upstream system, normalize it to lowercase (or apply EIP-55 checksumming) before storing it and before sending it to Conduit. Never change the case of a Tron or Solana address: Base58 is case-sensitive. A case-changed Tron address fails its checksum, and a case-changed Solana address can still be valid but name a different account
• Validate before submitting — run EIP-55 checksum validation client-side on any mixed-case EVM address before it reaches the API; many web3 libraries expose this as isAddress or getAddress
• Chain-specific rules — for Tron, validate Base58Check encoding; for Stellar, validate the StrKey checksum; for Solana, validate Base58 and check that it decodes to a 32-byte public key

​

Related endpoints

• POST /v2/payouts — submit a payout
• POST /v2/customers/:customerId/wallets/registered-addresses — register a destination address (also validates format)