INTRODUCING

TheFeawsProtocol

// Initialize Feaws Protocol with account credentials
const feaws = new FeawsProtocol({
  network: 'mainnet',
  apiKey: process.env.FEAWS_API_KEY,
  stellarAccount: publicKey,
  signerFunction: async (tx) => {
    return await signTransaction(tx, privateKey);
  }
});

// Example 1: USD to EUR remittance
const euroRemittance = await feaws.createRemittance({
  sourceAsset: 'USD',       // The currency you're sending
  destinationAsset: 'EUR',  // The currency to be received
  amount: '1000.00',        // Amount in source currency
  recipient: {
    stellarAddress: 'G...', // Stellar public key
    name: 'Marie Dubois',   // Optional recipient info
    country: 'FR'           // Destination country code (France)
  },
  optimizationPreference: {
    priority: 'BALANCED',   // SPEED, COST, or BALANCED
    maxSlippage: '0.3%',    // Maximum acceptable slippage
    useML: true             // Enable AI route optimization
  }
});

// Track the EUR remittance status
const status = await feaws.trackRemittance(euroRemittance.id);
console.log(`Remittance status: ${status.status}`);
console.log(`Exchange rate: 1 USD = ${status.exchangeRate} EUR`);
console.log(`Estimated arrival: ${status.estimatedDelivery}`);

// Example 2: Multi-currency support
// Get supported destination currencies for USD
const currencies = await feaws.getSupportedCurrencies('USD');
/* Output example:
[  
  { code: 'EUR', name: 'Euro', countries: ['DE','FR','IT','ES',...] },
  { code: 'GBP', name: 'British Pound', countries: ['GB'] },
  { code: 'JPY', name: 'Japanese Yen', countries: ['JP'] },
  // And many more supported currencies
]
*/

// Create a USD to GBP remittance
const gbpRemittance = await feaws.createRemittance({
  sourceAsset: 'USD',
  destinationAsset: 'GBP',
  amount: '750.00',
  recipient: {
    stellarAddress: 'G...',
    name: 'James Wilson',
    country: 'GB'
  },
  optimizationPreference: { priority: 'COST' }
});