From 6f6e5fb4834d2b37535d4cec0880ce66ee8da1f3 Mon Sep 17 00:00:00 2001 From: Steven Truong Date: Wed, 22 Apr 2026 09:18:36 -0400 Subject: [PATCH 1/2] docs: clarify virtual address protocol compatibility warning --- src/pages/guide/payments/virtual-addresses.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/guide/payments/virtual-addresses.mdx b/src/pages/guide/payments/virtual-addresses.mdx index 2fef5fef..c9f20a61 100644 --- a/src/pages/guide/payments/virtual-addresses.mdx +++ b/src/pages/guide/payments/virtual-addresses.mdx @@ -120,7 +120,7 @@ A few things matter in production: - virtual forwarding applies only to **TIP-20** transfer and mint paths - `balanceOf(virtualAddress)` stays `0`; use events and your own `userTag` mapping for attribution - policy checks apply to the **resolved master wallet**, not the literal virtual address -- protocols that treat addresses literally should reject virtual addresses unless they explicitly support them +- Avoid sending virtual addresses to DeFi protocols like lending pools or DEXs — they won't resolve them, and funds may become stuck. Use virtual addresses only for TIP-20 deposits to your master wallet. ## Learn more From b0d702012d3c9f8ab3e33d5c63578ac76f5df24b Mon Sep 17 00:00:00 2001 From: Steven Truong Date: Wed, 22 Apr 2026 09:30:06 -0400 Subject: [PATCH 2/2] chore: up --- src/pages/guide/payments/virtual-addresses.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/guide/payments/virtual-addresses.mdx b/src/pages/guide/payments/virtual-addresses.mdx index c9f20a61..41158913 100644 --- a/src/pages/guide/payments/virtual-addresses.mdx +++ b/src/pages/guide/payments/virtual-addresses.mdx @@ -120,7 +120,7 @@ A few things matter in production: - virtual forwarding applies only to **TIP-20** transfer and mint paths - `balanceOf(virtualAddress)` stays `0`; use events and your own `userTag` mapping for attribution - policy checks apply to the **resolved master wallet**, not the literal virtual address -- Avoid sending virtual addresses to DeFi protocols like lending pools or DEXs — they won't resolve them, and funds may become stuck. Use virtual addresses only for TIP-20 deposits to your master wallet. +- avoid using virtual addresses in reward protocols (lending pools, DEX rewards, etc) unless explicitly supported, as they can't track or hold funds ## Learn more