Protocol Documentation
Welcome to the CrossWire documentation. CrossWire is an enterprise-grade payment routing protocol designed to replace SWIFT communications with immediate, stablecoin-based settlement on the Arc blockchain.
Why Build on Arc & Circle?
Traditional wire transfers depend on correspondent banking networks, creating delays of up to 5 days, manual reconciliations, and unpredictable intermediary fees. CrossWire leverages:
- USDC Native Gas on Arc: Transactions are executed directly using native stablecoin transaction routing. Developers and users do not need to purchase or handle volatile native network tokens.
- Circle CCTP (Cross-Chain Transfer Protocol): Bridges assets securely across blockchain networks by burning USDC on source networks and minting on destination networks, removing bridging pools.
- ISO 20022 standard metadata: Links on-chain transactions directly to traditional corporate accounting structures.
Quick Start
Test your first wire transfer using the CrossWire UI or Web3 SDK integrations in under 3 minutes.
1. Acquire Testnet Funds
Visit the Circle Faucet to request Testnet USDC on Arbitrum Sepolia, Base Sepolia, or Ethereum Sepolia.
2. Bridge Assets
Access the CCTP Bridge in our app dashboard to burn USDC on Sepolia networks and mint native USDC on Arc Testnet. Settlement finalizes in sub-second times.
3. Execute a SWIFT-styled Wire
Use our Send page to supply recipient addresses, amount, purpose codes, and invoice references.
import { initiateWire } from '@crosswire/sdk';
// Initiate a professional wire transfer using stablecoin rails
const tx = await initiateWire({
recipient: '0x71C4B1c62fdc51c2411649692482390f772e73A9',
amount: 25000, // 25,000 USDC
purposeCode: 'GDDS', // Goods Trade (ISO 20022 Purpose Code)
reference: 'INV-2026-904', // Custom reference
memo: 'Q1 Consulting Services'
});
console.log(`Wire Transfer Initiated! Transaction Hash: ${tx.hash}`);ISO 20022 Purpose Codes
CrossWireRouter embeds transaction classification tags that mirror SWIFT purpose messaging standards, improving regulatory checks and enterprise invoice reconciliations.
| Code | SWIFT Name | Common Use Case |
|---|---|---|
GDDS | Goods Trade | Supplier payments for inventory and materials |
SCVE | Services | Contractor invoices, consulting, marketing fees |
SALA | Salary | Employee payroll, remote workforce rewards |
TREA | Treasury | Internal treasury transfers, rebalancing |
Secondary Approvals
Security rules are written directly into smart contracts. Any single wire transfer transaction exceeding $10,000 USDC requires secondary corporate signatory validation.
A minimum of 2 signatory authorizations must be recorded in the contract registry before the pending transfer is executed.
Contract References
CrossWire is deployed and active on the Arc Testnet. Explore the addresses and ABI declarations below to integrate directly.
| Contract Name | Network | On-chain Address |
|---|---|---|
| CrossWireRouter | Arc Testnet | 0x28972Ea3B462bCc711BCE1a1D13426e64906a46C |
| USDC ERC20 Gas Token | Arc Testnet | 0x07865c6E87B9F70255377e024ace6630C1Eaa37F |
| Circle CCTP MessageTransmitter | Ethereum Sepolia | 0x7865c6E87B9F70255377e024ace6630C1Eaa37F |