# Transvia

# Global money movement, powered by USDC. Humans: https://transvia.xyz — developers: https://transvia.xyz/docs

> Transvia is a global money movement platform. Anyone holding USDC can send
> value to bank-backed payout routes across ten destination currencies
> (EUR, GBP, MXN, BRL, PHP, NGN, AED, SGD, CAD, AUD) with transparent fees
> (0.50% total), automation rules, and settlement on Arc (Circle's EVM L1,
> chainId 5042002, USDC as gas). The same platform is machine-native:
> software gets quotes, creates transfers, automates decisions under
> policies, and pays for resources via x402.

## Product surfaces
- Landing:            https://transvia.xyz/
- Send money:         https://transvia.xyz/send
- Transfers:          https://transvia.xyz/transfers
- Routes:             https://transvia.xyz/routes
- Automation:         https://transvia.xyz/automation
- Developers:         https://transvia.xyz/developers
- Documentation:      https://transvia.xyz/docs
- Business console:   https://transvia.xyz/console

## Core API (humans and machines — same rail)
- GET  https://transvia.xyz/api/health — rail mode ("simulated" | "live"), chainId, escrow status
- POST https://transvia.xyz/api/quote {corridor, amountUsdc} — FX quote with full fee split
- POST https://transvia.xyz/api/send {quoteId, recipientLabel, recipientAddr?} — escrow deposit
- POST https://transvia.xyz/api/claim {intentId, signature?, deadline?} — recipient release (EIP-712)
- GET  https://transvia.xyz/api/intents — settlement feed (advances the state machine)
- GET  https://transvia.xyz/api/intents/{id} — single transfer + full event trail
- GET  https://transvia.xyz/api/agent/actions — automation decision log
- GET  https://transvia.xyz/api/agent/payments — x402 machine-payment ledger
- POST https://transvia.xyz/api/mcp — MCP JSON-RPC 2.0 (Streamable HTTP)

## x402 machine payments
- Callers identifying as external agents (`x-corridor-client: external-agent`)
  receive HTTP 402 with machine-readable payment terms on POST /api/quote.
  Retry with an `x-payment` header (0.01 USDC, Arc Testnet) → 200 + quote.
- Full walkthrough: https://transvia.xyz/docs/x402

## MCP
- Transport: JSON-RPC 2.0 over Streamable HTTP at https://transvia.xyz/api/mcp
- Flow: `initialize` → `tools/list` → `tools/call`
- Tools: rail_overview, corridor_quote, corridor_send, corridor_status, corridor_claim, corridor_refund
- Claude Code: `claude mcp add --transport http transvia https://transvia.xyz/api/mcp`

## Settlement lifecycle
- quoted → deposited → fx_locked → settling → claimable → claimed | refunded
- Fees (bps of source amount, split atomically onchain in TransviaEscrow.settle()):
  FX/liquidity 35 · Protocol 10 · Compliance automation 5 — total 50 bps
- Destination-currency conversion is computed offchain at quote time and locked
  to the intent; the escrow settles net USDC onchain and emits settlement data.

## Onchain facts (Arc Testnet)
- chainId: 5042002 · gas token: USDC · RPC: https://rpc.testnet.arc.io
- Explorer: https://testnet.arcscan.app · Faucet: https://faucet.circle.com
- USDC (ERC-20 surface, 6 dp): 0x3600000000000000000000000000000000000000
- EURC: 0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a
- Settlement contract: TransviaEscrow (MIT) — authoritative address recorded
  in contracts/README.md; do not hardcode addresses from this file.
- Index TransviaEscrow events (FxLegSettled / PayoutReleased / FeeSplit), not USDC Transfer logs.
- EVM notes: 20 Gwei maxFeePerGas floor; address(0) transfers revert; native USDC is 18 dp.
- Mainnet: preparation in progress (see docs/MAINNET-PREP.md).

## Documentation map
- Getting started:   https://transvia.xyz/docs
- Sending USDC:      https://transvia.xyz/docs/sending-usdc
- API reference:     https://transvia.xyz/docs/api
- SDK:               https://transvia.xyz/docs/sdk
- MCP:               https://transvia.xyz/docs/mcp
- x402:              https://transvia.xyz/docs/x402
- Automation/agents: https://transvia.xyz/docs/agents
- Policies:          https://transvia.xyz/docs/policies
- Smart contracts:   https://transvia.xyz/docs/smart-contracts
- Architecture:      https://transvia.xyz/docs/architecture
- Examples:          https://transvia.xyz/docs/examples