Detailed Instructions

Begin by evaluating the target market and technical requirements. The primary choice is between Ethereum mainnet for broad acceptance and Layer 2 solutions like Polygon or Arbitrum for lower fees. For the stablecoin, USDC (USD Coin) is a widely trusted, regulated option. You must verify the official contract addresses from the issuer's documentation to avoid scams. For example, the canonical USDC contract on Ethereum is 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48.

• Sub-step 1: Research Networks: Compare transaction costs (gas fees), finality times, and recipient accessibility.
• Sub-step 2: Verify Contracts: Always fetch the token contract address from the official issuer's website or verified block explorer.
• Sub-step 3: Check Compliance: Ensure the chosen stablecoin and network comply with the regulatory requirements of the sending and receiving jurisdictions.

Tip: For high-frequency, low-value payments, a low-fee Layer 2 is essential. Use a service like Alchemy or Infura to get reliable RPC endpoints for your chosen chain.

Detailed Instructions

Non-custodial wallets are crucial, giving users full control of their funds. Implement wallet generation using established libraries. For a web application, use ethers.js or viem to create and manage wallets programmatically. The core action is generating a new Ethereum wallet, which creates a private key and a derived public address. Never log or transmit the private key. Store it securely encrypted if necessary, but ideally, prompt the user to back it up immediately.

• Sub-step 1: Generate Wallet: Create a new wallet instance using a cryptographically secure random number generator.
• Sub-step 2: Derive Address: Extract the public address from the wallet object. This is the string (e.g., 0x742d35Cc6634C0532925a3b844Bc9e...) that will receive funds.
• Sub-step 3: Secure Backup: Guide the user to safely store their 12 or 24-word mnemonic seed phrase or exported private key.

javascriptCopy
// Example using ethers.js v6
import { ethers } from 'ethers';
const wallet = ethers.Wallet.createRandom();
console.log('Address:', wallet.address);
console.log('Private Key:', wallet.privateKey); // WARNING: Handle with extreme security
console.log('Mnemonic:', wallet.mnemonic.phrase);

Tip: For production, consider integrating with WalletConnect or MetaMask to allow users to use their existing wallets instead of creating new ones.

Detailed Instructions

Users need to acquire the chosen stablecoin. This often involves an on-ramp service like MoonPay or Transak for fiat conversion, or a transfer from a centralized exchange. If the sender's funds are on a different network than the recipient's, you must use a cross-chain bridge. Bridges lock tokens on the source chain and mint representative tokens on the destination chain. Always use official or highly audited bridges to minimize risk.

• Sub-step 1: On-Ramp Integration: Use a provider's API to embed a fiat-to-crypto purchase widget. Expect KYC checks.
• Sub-step 2: Check Balance: Verify the sender's wallet has sufficient stablecoin balance before initiating a transfer. Use the token contract's balanceOf function.
• Sub-step 3: Execute Bridge Transfer: If needed, interact with the bridge's smart contract. For example, to bridge USDC from Ethereum to Polygon, you would use the official Polygon POS bridge.

javascriptCopy
// Example: Checking a USDC balance on Ethereum using ethers.js
const usdcAbi = ['function balanceOf(address owner) view returns (uint256)'];
const usdcContract = new ethers.Contract('0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', usdcAbi, provider);
const balance = await usdcContract.balanceOf(userAddress);
console.log('Balance:', ethers.formatUnits(balance, 6)); // USDC has 6 decimals

Tip: Bridge transactions can take several minutes to hours. Implement status polling using the bridge's API to confirm completion on the destination chain.

Detailed Instructions

This is the core transfer function. You will construct and broadcast a transaction that calls the stablecoin's transfer function. Gas fees must be estimated and paid in the native currency of the blockchain (e.g., ETH for Ethereum, MATIC for Polygon). The transaction must be signed with the sender's private key. Always request a medium or high gas priority fee (tip) during network congestion to ensure timely processing.

• Sub-step 1: Construct Tx: Build the transaction object, specifying the recipient's address, the amount (in the token's smallest unit, e.g., wei for ETH, micro-dollars for USDC), and gas parameters.
• Sub-step 2: Estimate Gas: Use eth_estimateGas RPC call to get a safe gas limit. For a simple ERC-20 transfer, 65,000 gas is a good starting point, but always estimate.
• Sub-step 3: Sign and Send: Sign the transaction with the sender's private key and broadcast it to the network via an RPC node.
• Sub-step 4: Monitor Confirmation: Poll for the transaction receipt using the returned txHash. A common standard is to wait for 3-6 block confirmations.

javascriptCopy
// Example: Sending USDC on Ethereum
const tx = await usdcContract.transfer.populateTransaction(recipientAddress, ethers.parseUnits('100', 6)); // Send 100 USDC
const gasLimit = await provider.estimateGas(tx);
const feeData = await provider.getFeeData();
tx.gasLimit = gasLimit;
tx.maxFeePerGas = feeData.maxFeePerGas;
tx.maxPriorityFeePerGas = feeData.maxPriorityFeePerGas;
const signedTx = await wallet.signTransaction(tx);
const txResponse = await provider.broadcastTransaction(signedTx);
console.log('Transaction Hash:', txResponse.hash);

Tip: For a better user experience, consider using meta-transactions or gas sponsorship via services like Biconomy to abstract away gas fees from the end-user.

Detailed Instructions

Final settlement occurs on-chain. You must verify the transaction receipt's status and parse the event logs to confirm the transfer. Look for a successful Transfer event from the stablecoin contract, emitted to the recipient's address. Block explorers like Etherscan are useful for manual verification, but your system should automate this. Once confirmed, update your internal database to mark the payment as settled and notify both sender and recipient.

• Sub-step 1: Fetch Receipt: Use the transaction hash (txHash) to query for the transaction receipt via your RPC provider.
• Sub-step 2: Check Status: Verify that receipt.status equals 1 (success). A status of 0 indicates failure, often due to insufficient gas or a revert.
• Sub-step 3: Parse Logs: Decode the event logs in the receipt to find the Transfer(from, to, value) event and confirm the recipient address and amount match.
• Sub-step 4: Final Settlement: Update your application state. Trigger notifications (email, SMS) and provide the recipient with the transaction hash as proof of payment.

javascriptCopy
// Example: Verifying a transaction receipt and logs
const receipt = await provider.getTransactionReceipt(txHash);
if (receipt && receipt.status === 1) {
  console.log('Transaction succeeded!');
  // Parse Transfer events from the logs
  const iface = new ethers.Interface(['event Transfer(address indexed from, address indexed to, uint256 value)']);
  for (const log of receipt.logs) {
    try {
      const parsedLog = iface.parseLog(log);
      if (parsedLog.name === 'Transfer' && parsedLog.args.to === recipientAddress) {
        console.log(`Confirmed transfer of ${ethers.formatUnits(parsedLog.args.value, 6)} USDC`);
      }
    } catch (e) { /* Log not from USDC contract */ }
  }
} else {
  console.error('Transaction failed or was reverted.');
}

Tip: Implement a idempotent webhook or background job that periodically checks for confirmations of pending transactions to handle cases where real-time listening fails.