# DMF (Digital Monetary Framework) -- llms.txt
# https://dmfam.org/llms.txt
#
# Machine-readable index for AI assistants and developer tools.
# See https://llmstxt.org/ for the convention.

## Documentation

- AI Assistant Guide (full protocol context): https://dmfam.org/support
- White Paper (readable): https://dmfam.org/white-paper
- White Paper (markdown): https://dmfam.org/WhitePaper.md
- Security Report: https://dmfam.org/security
- FAQ: https://dmfam.org/faq
- Risk & Assumptions: https://dmfam.org/risk
- Swap & Bridge (external service — BlockchainBridge, opens on its own site): https://bridge.blockchainbridge.ai/
- How to Swap (step-by-step): https://dmfam.org/knowledge/docs/how-to-swap
- Swap Fees: https://dmfam.org/knowledge/docs/swap-fees
- Swap Tips: https://dmfam.org/knowledge/docs/swap-tips
- Troubleshooting: https://dmfam.org/knowledge/docs/swap-troubleshooting
- Architecture: https://dmfam.org/architecture
- Terms of Service: https://dmfam.org/terms
- Privacy Policy: https://dmfam.org/privacy
- Disclaimer: https://dmfam.org/disclaimer

## AI / Full Knowledge

- Full knowledge base (AI-readable, single file): https://dmfam.org/llms-full.txt
- Knowledge index: https://raw.githubusercontent.com/dmf-frame/knowledge/main/index.md
- Knowledge llms.txt: https://raw.githubusercontent.com/dmf-frame/knowledge/main/llms.txt
- What is DMF: https://raw.githubusercontent.com/dmf-frame/knowledge/main/overview/what-is-dmf.md
- Key Concepts: https://raw.githubusercontent.com/dmf-frame/knowledge/main/overview/key-concepts.md
- Architecture: https://raw.githubusercontent.com/dmf-frame/knowledge/main/overview/architecture.md
- Smart Contracts: https://raw.githubusercontent.com/dmf-frame/knowledge/main/protocol/smart-contracts.md
- Contract Addresses: https://raw.githubusercontent.com/dmf-frame/knowledge/main/protocol/addresses.md
- Fee Mechanism: https://raw.githubusercontent.com/dmf-frame/knowledge/main/protocol/fee-mechanism.md
- For Developers: https://raw.githubusercontent.com/dmf-frame/knowledge/main/guides/for-developers.md
- For Users: https://raw.githubusercontent.com/dmf-frame/knowledge/main/guides/for-users.md
- FAQ: https://raw.githubusercontent.com/dmf-frame/knowledge/main/guides/faq.md
- Security Summary (in-house): https://raw.githubusercontent.com/dmf-frame/knowledge/main/security/audit-summary.md
- Certora Verification: https://raw.githubusercontent.com/dmf-frame/knowledge/main/security/certora-verification.md
- Invariants Testing: https://raw.githubusercontent.com/dmf-frame/knowledge/main/security/invariants-testing.md
- Threat Model: https://raw.githubusercontent.com/dmf-frame/knowledge/main/security/threat-model.md
- AI Assistant Guide: https://raw.githubusercontent.com/dmf-frame/knowledge/main/agents/ai-assistant-guide.md
- Bot Integration Guide: https://raw.githubusercontent.com/dmf-frame/knowledge/main/agents/bot-integration-guide.md
- WebMCP Tool Catalog: https://raw.githubusercontent.com/dmf-frame/knowledge/main/agents/webmcp-tool-catalog.md
- Glossary: https://raw.githubusercontent.com/dmf-frame/knowledge/main/education/glossary.md
- How to Use DMF: https://raw.githubusercontent.com/dmf-frame/knowledge/main/education/how-to-use-dmf.md
- Understanding Fees: https://raw.githubusercontent.com/dmf-frame/knowledge/main/education/understanding-fees.md
- How to Verify Backing: https://raw.githubusercontent.com/dmf-frame/knowledge/main/education/how-to-verify-backing.md
- Chain Config: https://raw.githubusercontent.com/dmf-frame/knowledge/main/reference/chain-config.md
- Comparison: Backed Token Models: https://raw.githubusercontent.com/dmf-frame/knowledge/main/reference/comparison/backed-token-models.md
- Comparison: vs Traditional Stablecoins: https://raw.githubusercontent.com/dmf-frame/knowledge/main/reference/comparison/vs-traditional-stablecoins.md
- Changelog: https://raw.githubusercontent.com/dmf-frame/knowledge/main/meta/changelog.md

## Source Code

- Knowledge base: https://github.com/dmf-frame/knowledge

## Where to transact

- Buy / Sell dmfUSD: https://dmfam.org (on-site buy/sell card, wallet-connected)
- Swap / Bridge (external service — BlockchainBridge, opens on its own site): https://bridge.blockchainbridge.ai/

## Network

- Chain: Base Mainnet (chain ID 8453)
- Explorer: https://basescan.org

## Core Contracts

- dmfUSD (token contract): https://basescan.org/address/0x3a6f90b8517ff16b7a8c368f05f38bb03afd4aa7
- USDC (Circle native): https://basescan.org/address/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

## WebMCP Tools

DMF supports WebMCP (Web Model Context Protocol) — a browser API that lets AI agents
interact with the site through structured tools instead of visual DOM guessing.
Available in Chrome 151+ (Canary) with chrome://flags/#enable-webmcp-testing enabled.

### dmfam.org (7 site tools)

- site_read_page_state: Returns current page URL, title, and section
- site_get_transparency: Live reserves, circulation, and backing ratio
- site_get_protocol_facts: Full protocol fact sheet
- site_search_faq: Search FAQ by keyword
- site_list_docs: Categorized documentation index
- site_navigate: Navigate to any DMF page
- site_open_app: Open the external Swap & Bridge service (BlockchainBridge) in a new tab

(site_ask_support — Susan's support question tool — stays defined in the code but is not registered while
the support service is offline, so agents never see a tool that cannot answer.)

### Safety Tiers

- T0 (read-only, no confirm): page state, transparency, protocol facts, FAQ search, docs list
- T1 (page state, no transaction): site_navigate, site_open_app

No WebMCP tool executes a transaction or signs for the user — buy and sell are user-driven in the on-site buy/sell card.

## AI Context Snippet

Copy-paste from https://dmfam.org/support or use the following:

DMF (Digital Monetary Framework) is a non-custodial protocol on Base that issues dmfUSD, a fully backed digital token. dmfUSD is not a stablecoin — there is no peg, no oracle, no debt. USDC collateral sits in the contract and backing-per-token grows as fees accumulate.

Key facts:
- Chain: Base (mainnet, chain ID 8453)
- Token: dmfUSD (ERC-20, 6 decimals, matching USDC)
- Buy: deposit USDC → receive dmfUSD minus 0.25% fee (capped at $20)
- Refund: burn dmfUSD → receive USDC minus same fee (0.25%, capped at $20)
- Fee split: 60% (0.15%) retained as USDC backing → backing-per-token grows, 40% (0.10%) minted as dmfUSD for operations
- Backing: live USDC.balanceOf(this) / totalSupply — ratio grows as fees accumulate
- Transfers: 0% fee
- Standards: ERC-20 + ERC-20 Permit + Ownable2Step + ReentrancyGuard
- Read-only quotes: ERC-4626-style asset(), totalAssets(), convertToShares/convertToAssets and preview/max helpers for integrations — not an ERC-4626 implementation: no deposit(), mint(), withdraw() or redeem() functions exist (buy() and refund() are the entry points)
- Multi-chain swap: 100+ chains via BlockchainBridge, an external swap and bridge service not operated by DMF (bridge.blockchainbridge.ai — opens on its own site) — it donates a share of its swap and bridge fee income to the dmfUSD contract as USDC, increasing backing-per-token for all holders
- Security: Foundry (60 tests: 24 unit + 12 economic scenario + 16 fuzz + 8 invariant, zero failures — 104M+ executed contract operations) + Certora Prover (10 checks) + Slither + Aderyn (0 High)
- Deployment: Base mainnet, contract 0x3a6f90b8517ff16b7a8c368f05f38bb03afd4aa7

Minimums (interface-level, not a contract limit — the contract itself only rejects zero amounts):
- Buy: 0.1 USDC
- Sell: 0.1 dmfUSD

Links:
- Security report: https://dmfam.org/security
- FAQ: https://dmfam.org/faq
- Swap & Bridge (external service): https://bridge.blockchainbridge.ai/
- Contract: https://basescan.org/address/0x3a6f90b8517ff16b7a8c368f05f38bb03afd4aa7
- White paper (readable): https://dmfam.org/white-paper
- White paper (markdown): https://dmfam.org/WhitePaper.md
- Developer reference: https://raw.githubusercontent.com/dmf-frame/knowledge/main/guides/for-developers.md
- Changelog: https://raw.githubusercontent.com/dmf-frame/knowledge/main/meta/changelog.md

Not financial advice. Smart-contract and asset-issuer risk apply. DYOR.

## About

DMF is a non-custodial protocol and not a legal entity or financial institution. dmfUSD is a fully backed digital token on Base with deterministic mint and redemption, transparent on-chain reserves, and explicit fee rules that grow its USDC collateral over time. Built for programmable digital dollars with institutional resilience.