Cross-chain treasury rebalancing

​

Prerequisites

• A working USDC transfer integration
• Treasury wallets and source-chain RPC access
• A balance source that accounts for transfers already in progress
• Amount limits, gas reserves, and a policy for failed or delayed transfers

​

Define the balance policy

interface RebalancePolicy {
  threshold: bigint;
  minTransfer: bigint;
  maxTransfer: bigint;
  sourceReserve: bigint;
}

function rebalanceAmount(
  sourceBalance: bigint,
  destinationBalance: bigint,
  policy: RebalancePolicy,
): bigint | null {
  const difference = sourceBalance - destinationBalance;
  if (difference <= 0n || difference < policy.threshold) return null;
  const available = sourceBalance > policy.sourceReserve
    ? sourceBalance - policy.sourceReserve
    : 0n;
  const amount = [difference / 2n, available, policy.maxTransfer]
    .reduce((smallest, value) => value < smallest ? value : smallest);
  return amount > 0n && amount >= policy.minTransfer ? amount : null;
}

​

Quote and execute

​

Schedule without duplicate transfers

​

Troubleshooting

• If no quote is available, keep the treasury balance unchanged and record the failure for a later policy evaluation.
• If funding succeeds but delivery remains pending, continue tracking that transfer instead of treating the source balance decrease as a completed rebalance.
• If an intent becomes refundable, reconcile the refund transaction before counting the funds as available again.

​

Next steps

• Intent status reference
• Errors and retries