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.

QuickStart.ts
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.

CodeSWIFT NameCommon Use Case
GDDSGoods TradeSupplier payments for inventory and materials
SCVEServicesContractor invoices, consulting, marketing fees
SALASalaryEmployee payroll, remote workforce rewards
TREATreasuryInternal 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.

Signatory Requirement:

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 NameNetworkOn-chain Address
CrossWireRouterArc Testnet0x28972Ea3B462bCc711BCE1a1D13426e64906a46C
USDC ERC20 Gas TokenArc Testnet0x07865c6E87B9F70255377e024ace6630C1Eaa37F
Circle CCTP MessageTransmitterEthereum Sepolia0x7865c6E87B9F70255377e024ace6630C1Eaa37F
HomeSendContactsInvoicesAnalytics