Integrate the Ripio Bridge

// BridgeDeposit — same address on every supported chain
const BRIDGE_DEPOSIT = '0x465e642387d3d73a57CDc1368fFA53A800bA5D47';

// Supported chain ids
const CHAINS = {
  ethereum: 1,
  base: 8453,
  worldchain: 480,
  bsc: 56,
  polygon: 137,
  gnosis: 100,
};

// Stablecoins — same address on every supported chain, all 18 decimals
const TOKENS = {
  wARS: '0x0DC4F92879B7670e5f4e4e6e3c801D229129D90D',
  wBRL: '0xD76f5Faf6888e24D9F04Bf92a0c8B921FE4390e0',
  wMXN: '0x337E7456B420bD3481e7FA61fA9850343d610d34',
  wPEN: '0x4F34c8b3b5FB6D98Da888F0feA543d4d9C9F2eBE',
  wCLP: '0x61D450a098b6a7f69fC4b98CE68198fe59768651',
  wCOP: '0x8a1D45e102e886510e891d2Ec656a708991e2D76',
};

import { parseAbi } from 'viem';

// Minimal ABI — enough for a full integration.
// Full ABI: verified contract on any block explorer, or the source on GitHub.
const BRIDGE_ABI = parseAbi([
  'function depositForBridge(address token, uint256 amount, uint256 destChainId, address destRecipient, bytes32 clientDepositId) returns (uint256 depositId)',
  'function routeConfigs(address token, uint256 destChainId) view returns (bool enabled, uint256 fixedFee)',
  'function remainingMintCapacity(address token) view returns (uint256 remaining, uint256 dailyMaxMint, uint256 mintedToday)',
  'event BridgeDepositInitiated(uint256 indexed depositId, address indexed token, address indexed from, uint256 amount, uint256 destChainId, address destRecipient, bytes32 clientDepositId)',
  'event BridgeMintFulfilled(address indexed token, address indexed to, uint256 amount, uint256 sourceChainId, bytes32 sourceTxHash, uint256 indexed sourceDepositId)',
]);

const ERC20_ABI = parseAbi([
  'function approve(address spender, uint256 amount) returns (bool)',
  'function allowance(address owner, address spender) view returns (uint256)',
]);

import { createPublicClient, http, formatUnits } from 'viem';
import { mainnet } from 'viem/chains';

const publicClient = createPublicClient({ chain: mainnet, transport: http() });

// Check the wARS route from Ethereum (1) to Base (8453)
const [enabled, fixedFee] = await publicClient.readContract({
  address: BRIDGE_DEPOSIT,
  abi: BRIDGE_ABI,
  functionName: 'routeConfigs',
  args: [TOKENS.wARS, 8453n],
});

if (!enabled) throw new Error('Route is not enabled');
console.log(`Fixed fee: ${formatUnits(fixedFee, 18)} wARS`);

import { keccak256, encodePacked, parseUnits, parseEventLogs, pad } from 'viem';

const amount = parseUnits('1000', 18); // total, inclusive of the route's fixed fee

// 1. Approve the BridgeDeposit contract for at least `amount`
//    (the contract pulls via burnFrom + transferFrom)
const approveHash = await walletClient.writeContract({
  address: TOKENS.wARS,
  abi: ERC20_ABI,
  functionName: 'approve',
  args: [BRIDGE_DEPOSIT, amount],
});
await publicClient.waitForTransactionReceipt({ hash: approveHash });

// 2. Optional: your own id for off-chain correlation.
//    Echoed in BridgeDepositInitiated. Use pad('0x0', { size: 32 }) to skip.
const clientDepositId = keccak256(encodePacked(
  ['address', 'uint256', 'uint256'],
  [account.address, BigInt(Date.now()), BigInt(myInternalOrderId)],
));

// 3. Initiate the bridge — burns on the source chain
const depositHash = await walletClient.writeContract({
  address: BRIDGE_DEPOSIT,
  abi: BRIDGE_ABI,
  functionName: 'depositForBridge',
  args: [
    TOKENS.wARS,   // token
    amount,        // total amount (fee is deducted from it)
    8453n,         // destination chain id (Base)
    recipient,     // recipient on destination — can differ from sender
    clientDepositId,
  ],
});

// 4. Extract the depositId from the BridgeDepositInitiated event
const receipt = await publicClient.waitForTransactionReceipt({ hash: depositHash });
const [initiated] = parseEventLogs({
  abi: BRIDGE_ABI,
  eventName: 'BridgeDepositInitiated',
  logs: receipt.logs,
});
console.log('depositId:', initiated.args.depositId);

import { createPublicClient, http } from 'viem';
import { base } from 'viem/chains';

// Watch on the DESTINATION chain
const destClient = createPublicClient({ chain: base, transport: http() });

const unwatch = destClient.watchContractEvent({
  address: BRIDGE_DEPOSIT,
  abi: BRIDGE_ABI,
  eventName: 'BridgeMintFulfilled',
  args: { to: recipient },
  onLogs: (logs) => {
    for (const log of logs) {
      // Idempotent: exactly one mint per (sourceChainId, sourceDepositId)
      console.log('Minted', log.args.amount, 'for deposit', log.args.sourceDepositId);
    }
  },
});

// Minting is subject to a daily cap per token, per chain.
// Check capacity on the DESTINATION chain before large transfers —
// deposits above the remaining capacity are queued until the cap resets.
const [remaining, dailyMaxMint, mintedToday] = await destClient.readContract({
  address: BRIDGE_DEPOSIT,
  abi: BRIDGE_ABI,
  functionName: 'remainingMintCapacity',
  args: [TOKENS.wARS],
});

if (amount > remaining) {
  console.warn('Transfer exceeds remaining daily capacity — it will be queued');
}

function depositForBridge(
    address token,           // stable to bridge
    uint256 amount,          // total amount, inclusive of the route's fixed fee
    uint256 destChainId,     // destination chain id
    address destRecipient,   // recipient on destination (can differ from sender)
    bytes32 clientDepositId  // optional, your own id for off-chain correlation
) returns (uint256 depositId)

# Look up a bridge operation by its source transaction hash
curl "https://bridge.ripio.com/api/operations/{sourceTxHash}?chainId=1"

# List operations for an address (add &pending=true for in-flight only)
curl "https://bridge.ripio.com/api/operations?address=0xYourAddress&limit=20"

{
  "operation": {
    "id": "…",
    "source_chain_id": 1,
    "source_tx_hash": "0x…",
    "dest_chain_id": 8453,
    "dest_tx_hash": "0x…",
    "deposit_id": "42",
    "token_symbol": "wARS",
    "token_address": "0x0DC4F92879B7670e5f4e4e6e3c801D229129D90D",
    "from_address": "0x…",
    "dest_recipient": "0x…",
    "amount_in": "1000000000000000000000",
    "fee_amount": "…",
    "amount_out": "…",
    "status": "COMPLETED",
    "error_reason": null,
    "created_at": "2026-07-21T12:00:00.000Z",
    "updated_at": "2026-07-21T12:15:00.000Z"
  }
}