From 6e4c795b51b9f51f56866ea74c40b05e1d3e82aa Mon Sep 17 00:00:00 2001
From: bz <88026162+bz-hashtag-0780@users.noreply.github.com>
Date: Mon, 19 Jan 2026 21:51:31 +0700
Subject: [PATCH] Add PYUSD0 integration guide

---
 docs/defi/pyusd0-integration-guide.md | 85 +++++++++++++++++++++++++++
 1 file changed, 85 insertions(+)
 create mode 100644 docs/defi/pyusd0-integration-guide.md

diff --git a/docs/defi/pyusd0-integration-guide.md b/docs/defi/pyusd0-integration-guide.md
new file mode 100644
index 0000000000..d48f3a1fd5
--- /dev/null
+++ b/docs/defi/pyusd0-integration-guide.md
@@ -0,0 +1,85 @@
+---
+id: pyusd0-integration-guide
+title: PYUSD0 Integration Guide
+description: A developer reference for integrating PYUSD0 on Flow, covering token architecture, contract addresses, bridging mechanics, and migration from USDF.
+keywords:
+  - PYUSD0
+  - PYUSD
+  - stablecoins
+  - Flow blockchain
+  - Flow EVM
+  - Flow Cadence
+  - Flow EVM Mainnet
+  - LayerZero
+  - OFT
+  - omnichain fungible token
+  - bridges
+  - stablecoin liquidity
+  - USDF migration
+  - decentralized exchanges
+  - DEX
+sidebar_position: 9
+sidebar_label: PYUSD0 Integration
+---
+# PYUSD0 Integration Guide
+
+## Overview
+
+This guide is for developers and protocols integrating PYUSD0 on Flow EVM. PYUSD0 is an OFT (Omnichain Fungible Token) deployed via LayerZero, replacing USDF as the canonical USD stablecoin on Flow.
+
+## Contract Addresses
+
+### Flow EVM Mainnet
+
+| Contract | Address |
+| ----- | ----- |
+| [PYUSD0][2] | `0x99af3eea856556646c98c8b9b2548fe815240750` |
+| [Migration Pool (USDF/PYUSD0)][3] | `0x6ddDFa511A940cA3fD5Ec7F6a4f23947cA30f030` |
+
+### Flow Cadence Mainnet
+
+| Token Name | Contract Address | Contract Name |
+| ----- | ----- | ----- |
+| [PYUSD0][1] | `0x1e4aa0b87d10b141` | `EVMVMBridgedToken_99af3eea856556646c98c8b9b2548fe815240750` |
+
+### Testnet
+
+**No official PYUSD0 testnet deployment.** For local testing, deploy the PYUSD contract directly:
+
+* [Paxos PYUSD Contract][4]  
+* This gives you a functionally equivalent token you can mint/control for testing.
+
+### **Deprecated (USDF)**
+
+| Contract | Address | Status |
+| ----- | ----- | ----- |
+| USDF | `0x2aaBea2058b5aC2D339b163C6Ab6f2b6d53aabED` | Deprecating |
+
+## **Token Specifications**
+
+```
+Name: PYUSD0
+Symbol: PYUSD0
+Decimals: 6
+Standard: ERC-20 + LayerZero OFT
+Backing: 1:1 PYUSD (PayPal USD)
+```
+
+---
+
+## **Code Examples**
+
+Visit [the GitHub Repository][5] for code examples on bridging PYUSD0 via LayerZero OFT.
+
+## **Migration Path for Existing USDF Integrations**
+
+1. **Add PYUSD0 support** alongside USDF  
+2. **Update defaults** to use PYUSD0 instead of USDF  
+3. **Communicate to users** about migration timeline  
+4. **Deprecate USDF** after grace period 
+
+[1]: https://www.flowscan.io/contract/A.1e4aa0b87d10b141.EVMVMBridgedToken_99af3eea856556646c98c8b9b2548fe815240750
+[2]: https://evm.flowscan.io/token/0x99aF3EeA856556646C98c8B9b2548Fe815240750
+[3]: https://evm.flowscan.io/token/0x6ddDFa511A940cA3fD5Ec7F6a4f23947cA30f030?tab=contract
+[4]: https://github.com/paxosglobal/paxos-token-contracts/blob/master/contracts/stablecoins/PYUSD.sol
+[5]: https://github.com/onflow/flow-bridge-app/tree/main/ethereum-oapp
\ No newline at end of file