#fleursdelys #api
Presentation Fleurs de Lys API
The Fleurs de Lys API resolves domain names minted on XDC Web3 Domains (XWD) contract — .xdc, .rwa, and .depin — to their associated wallet addresses and generates verifiable transaction receipts with embedded QR codes.
Domain Resolution
Resolves registered XWD domains (.xdc, .rwa, .depin) to their associated wallet addresses by querying the XWD smart contract.
Sender Verification
Before a transaction is submitted, the API verifies that the selected sender domain resolves to the connected wallet address. If the domain does not match the connected wallet, the transaction is blocked.
Multi-Token Transfers
Supported assets:
#XDC (native coin)
@XDCNetwork
#USDC @circle
#CGO (Comtech Gold)
@ComTechOfficial
#SRX (StorX)
@StorXNetwork
#PLI (Plugin)
@GoPlugin
#LBT (Law Blocks)
@lawblockstoken
#FXD (Fathom Dollar)
@Fathom_fi
Business Categorization
The API handles all domains of
xdcdomains.xyz. The API's native networking has grouped the 400 domains belonging to Fleurs de Lys into 14 sectors:
-Agriculture & Food
-Energy & Resources
-Computing & AI
-Finance & Liquidity
-Identity & Governance
-Real Estate & Logistics
-Metals & Luxury
-Wine & Spirits
-Healthcare
-Culture & Languages
-Territories
-Media & Art
-Lore & Myths
-Hardware & Sensors
Receipts display the business categories assigned by the Fleurs de Lys directory to both sender and recipient domains. Subdomains inherit the category of their parent domain.
Transaction Receipt
For every confirmed transaction, the API generates a receipt containing:
-FDL receipt reference number
-Sender
-Recipient
-Business categories
-Amount and currency
-Blockchain timestamp (UTC)
-Transaction hash
-Direct link to XDCScan
-Verification QR code
Example:
FDL Receipt Reference
Each receipt receives a unique FDL reference derived from the underlying blockchain transaction.
Format:
FDL-YYYY-HASHPREFIX-NONCE
Example:
FDL-2026-97294f075433
Where: FDL = fixed receipt prefix 2026 = year of issuance, 97294f07 = first 8 characters of the transaction hash (excluding 0x), 5433 = sender transaction nonce.
The reference is designed to uniquely identify a specific blockchain transaction while remaining human-readable and easy to communicate.
QR Code Verification
Each receipt includes a QR code containing the receipt reference and transaction verification data.
The QR code allows any smartphone or device to instantly access the corresponding blockchain record without manually entering the transaction hash.
The QR code is not the proof itself. The blockchain transaction is the proof.
Can the QR Code Be Faked?
Someone could create a fake receipt using a fabricated transaction hash or by copying a real hash from an unrelated transaction.
However, verification is straightforward:
-If the hash does not exist on XDCScan, the receipt is invalid.
-If the hash exists but the transaction details do not match the receipt, the receipt has been altered.
-If the hash exists and all details match, the receipt accurately reflects the recorded blockchain transaction.
Because the transaction record is stored on-chain, a confirmed transaction cannot be modified retroactively.
The QR code simply provides a convenient way to access the verification record.
Traceability.
The FDL receipt reference provides a practical transaction identifier.
Using the receipt reference and associated transaction data, users can:
-Locate the corresponding blockchain transaction
-Verify the transaction on XDCScan
-Confirm sender and recipient addresses
-Confirm transferred amounts and assets
-Confirm transaction timestamps
The transaction hash remains the authoritative on-chain identifier, while the FDL reference provides a shorter, human-readable reference for receipts, customer support, record keeping, and transaction verification.
Hash Lookup
Enter any transaction hash to retrieve its details and generate a corresponding receipt.
Receipts can be:
-Copied as JSON
-Downloaded as standalone HTML files
-Shared with embedded QR codes
-Architecture
-Resolver and API hosted on Vercel
-Single-page browser interface
-Direct integration with XDC Web3 Domains
-Direct integration with XDC Network transactions
(Resolving via domain name semantics greatly reduces typos of the 0X address, as well as classic scams of the fake address looking almost identical to that of users.)
Use Cases :
-Payment confirmation
-Transaction verification
-Customer support and dispute resolution
-Product return verification
-Freelance payment records
-Franchise revenue monitoring
-Accounting support documentation
-Internal audit trails
-Digital record keeping
There may be bugs depending on your RPC configuration; never use an RPC whose reliability you are unsure of, and always use official RPCs. The API supports emojis, accessions "é", "è", etc. XDCPpay has a bug with names containing accessions. The QR code has been tested with QR & Barcode Scanner.
Fleurs de Lys is not a startup; the goal is to provide practical applications for
#RWA and
#DEPIN on
#xdc, with functional tools available today. An SME could easily use the Fleurs de Lys API to manage its accounting, after-sales service, and returns of defective goods, and to issue a time-stamped "receipt" on-chain.
An on-chain or paper receipt is not a product warranty; it is simply proof of purchase of a good or service recorded on-chain. It does not constitute insurance. It is an indelible marker of a transaction with sender and receiver.
What's missing from many Web3 tools today?
A blockchain transaction typically looks like this:
0x97294f07c...
0.123 XDC
Block 12345678
For a developer, it's perfect. For an accountant, a franchisee, customer service, or a client, it's unusable.
It's missing:
-human verification
-a receipt
-an easy way to verify
-document retention
What the Fleurs de Lys API adds?
Let's take a payment:
compute.rwa
→ credits.bourse.xdc
0.123 XDC
The API generates:
FDL-2026-97294f075433
with:
-the amount
-the parties
-the categories
-the date
-the hash
-the QR code.
From there, the transaction becomes a document.
The QR Code: The Most Underestimated Part
Many Web 3.0 projects claim, "Everything is on the blockchain." Which is true. But in reality, nobody is going to copy:
0x97294f07a6f5f7d7b5f... into their phone.
The QR code transforms the blockchain hash into:
-scan → immediate verification.
This makes a huge difference in usability.
On-Chain Timestamping
Most SMEs use:
PDFs, emails, screenshots, Excel files.
All of these can be modified.
The Fleurs de Lys receipt is reconstructed from a transaction that is:
dated, confirmed, public, and immutable.
It's not just: "Here's a PDF," but: "Here's a document whose data comes from an event recorded on the blockchain on this date."
For Web3 SMEs:
"We make payments"
but:
"We transform a blockchain payment into a verifiable receipt."
An SME that sells:
services, tokenized products, freelance services, RWA assets, often needs to answer simple questions:
-Who paid?
-When?
-How much?
-Where is the proof?
-Can it be verified?
The Fleur de Lys API answers these questions precisely.
The API:
fleurs-resolver-final.vercel… does not record any user data; everything is saved temporarily in your browser.
Built by
@focalzero 2026
#iso20022 #tokenization #market #PME #entreprise #ticket #invoice #blockchain #tool #qr #QR #proof #DEV #dev #web3 #web3domain #xdcdomains #xrpdomains