{"id":51226027,"url":"https://github.com/pitill0/euroledger-xrpl","last_synced_at":"2026-06-28T11:31:18.503Z","repository":{"id":367382278,"uuid":"1280478921","full_name":"pitill0/euroledger-xrpl","owner":"pitill0","description":"Open proof of concept for euro-denominated payments, payment intents, merchant webhooks and WooCommerce checkout flows on the XRP Ledger.","archived":false,"fork":false,"pushed_at":"2026-06-25T18:06:07.000Z","size":321,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-25T20:06:44.231Z","etag":null,"topics":["fastapi","open-source","payments","postgresql","webhooks","woocommerce","xrpl"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pitill0.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-25T16:14:16.000Z","updated_at":"2026-06-25T18:06:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/pitill0/euroledger-xrpl","commit_stats":null,"previous_names":["pitill0/euroledger-xrpl"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/pitill0/euroledger-xrpl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pitill0%2Feuroledger-xrpl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pitill0%2Feuroledger-xrpl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pitill0%2Feuroledger-xrpl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pitill0%2Feuroledger-xrpl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pitill0","download_url":"https://codeload.github.com/pitill0/euroledger-xrpl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pitill0%2Feuroledger-xrpl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34887328,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-28T02:00:05.809Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fastapi","open-source","payments","postgresql","webhooks","woocommerce","xrpl"],"created_at":"2026-06-28T11:31:17.920Z","updated_at":"2026-06-28T11:31:18.497Z","avatar_url":"https://github.com/pitill0.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EuroLedger XRPL\n\nEuroLedger XRPL is an open, testnet-first proof of concept for euro-denominated payment intents, XRPL payment detection, merchant webhooks and WooCommerce checkout integration.\n\nThe project explores how the XRP Ledger can be used as an open technical settlement layer while keeping the merchant and customer experience centered around euro-denominated payments and reconciliation.\n\n\u003e Status: proof of concept, local development and XRPL testnet validation. Not production financial infrastructure.\n\n## What it does today\n\nEuroLedger XRPL currently provides:\n\n- a FastAPI backend for merchant-scoped payment intents;\n- idempotent payment intent creation and lifecycle management;\n- XRPL testnet payment detection using references and memos;\n- payment intent expiration and cancellation flows;\n- merchant API key authentication;\n- merchant webhook endpoint management;\n- signed webhook delivery with retry and delivery tracking;\n- worker health and Prometheus metrics;\n- Grafana, Prometheus and Alertmanager observability examples;\n- n8n alerting workflows for Telegram notifications;\n- a WooCommerce payment gateway supporting classic checkout and Checkout Blocks;\n- merchant-facing WooCommerce installation documentation;\n- release packaging workflow for the WooCommerce plugin.\n\n## What this project is not\n\nEuroLedger XRPL is not:\n\n- a cryptocurrency investment product;\n- a stablecoin issuer;\n- a custody service;\n- a regulated financial service;\n- a replacement for the euro or a digital euro;\n- a recommendation to buy, sell or hold XRP.\n\nSee [Legal disclaimer](docs/legal-disclaimer.md) and [Scope](docs/scope.md).\n\n## High-level architecture\n\n```mermaid\nflowchart LR\n    Merchant[Merchant / Store] --\u003e Woo[WooCommerce Gateway]\n    Merchant --\u003e APIClient[Merchant API Client]\n\n    Woo --\u003e Backend[EuroLedger XRPL Backend API]\n    APIClient --\u003e Backend\n\n    Backend --\u003e DB[(PostgreSQL)]\n    Backend --\u003e Dashboard[Payment Intent Dashboard]\n\n    XRPLWorker[XRPL Worker] --\u003e XRPL[XRPL Testnet]\n    XRPLWorker --\u003e Backend\n    XRPLWorker --\u003e DB\n\n    Expirer[Payment Intent Expirer] --\u003e DB\n    WebhookWorker[Webhook Delivery Worker] --\u003e DB\n    WebhookWorker --\u003e MerchantWebhook[Merchant Webhook Endpoint]\n\n    Backend --\u003e Metrics[Prometheus Metrics]\n    XRPLWorker --\u003e Metrics\n    WebhookWorker --\u003e Metrics\n    Expirer --\u003e Metrics\n    Metrics --\u003e Grafana[Grafana]\n    Metrics --\u003e Alertmanager[Alertmanager]\n    Alertmanager --\u003e N8N[n8n / Telegram]\n```\n\n## Payment flow\n\n```mermaid\nsequenceDiagram\n    participant Customer\n    participant Store as WooCommerce Store\n    participant Gateway as EuroLedger Gateway\n    participant API as EuroLedger Backend\n    participant XRPL as XRPL Testnet\n    participant Worker as XRPL Worker\n    participant Webhook as Webhook Worker\n\n    Customer-\u003e\u003eStore: Place order\n    Store-\u003e\u003eGateway: Process payment\n    Gateway-\u003e\u003eAPI: Create payment intent\n    API--\u003e\u003eGateway: Payment intent + reference\n    Gateway--\u003e\u003eStore: Order on-hold\n    Customer-\u003e\u003eXRPL: Send payment with reference\n    Worker-\u003e\u003eXRPL: Scan account transactions\n    Worker-\u003e\u003eAPI: Confirm detected payment\n    API-\u003e\u003eWebhook: Queue merchant event\n    Webhook-\u003e\u003eStore: Deliver signed webhook\n    Store--\u003e\u003eCustomer: Order processing\n```\n\n## Repository layout\n\n```text\nautomation/n8n/          n8n workflow exports for alert routing\nbackend/                 FastAPI application, models, migrations, workers and tests\ndocs/                    Project, operations, webhook, WooCommerce and release docs\nexamples/                Standalone webhook receiver examples\nobservability/           Prometheus, Grafana and Alertmanager configuration\nplugin-woocommerce/      WooCommerce gateway plugin and local dev environment\nscripts/dev/             Development and packaging helper scripts\nsdk/                     Reserved for future SDKs\ntests/                   Reserved for future top-level tests\nworker/                  Reserved for future worker split-out\n```\n\n## Quick start\n\nFrom the repository root:\n\n```bash\ndocker compose up --build -d\n```\n\nCheck the backend:\n\n```bash\ncurl http://localhost:8000/health\n```\n\nRun backend quality checks:\n\n```bash\ndocker compose exec backend ruff check app tests\ndocker compose exec backend ruff format --check app tests\ndocker compose exec backend pytest\n```\n\nFor backend-specific commands, see [Backend README](backend/README.md).\n\n## WooCommerce gateway\n\nThe WooCommerce gateway lives in:\n\n```text\nplugin-woocommerce/euroledger-xrpl-gateway/\n```\n\nCurrent documented plugin release: `0.1.3`.\n\nIt supports:\n\n- classic WooCommerce checkout;\n- WooCommerce Checkout Blocks;\n- EuroLedger payment intent creation;\n- signed webhook updates from EuroLedger;\n- order metadata and admin visibility;\n- local smoke and end-to-end validation scripts;\n- distributable ZIP packaging.\n\nStart with:\n\n- [WooCommerce integration README](plugin-woocommerce/README.md)\n- [Gateway plugin README](plugin-woocommerce/euroledger-xrpl-gateway/README.md)\n- [Merchant installation guide](docs/woocommerce-merchant-installation-guide.md)\n- [Checkout Blocks documentation](docs/woocommerce-checkout-blocks.md)\n- [WooCommerce gateway 0.1.3 release notes](docs/woocommerce-gateway-0.1.3.md)\n\n## Documentation\n\nThe documentation entry point is:\n\n- [Documentation index](docs/index.md)\n\nKey documents:\n\n- [Vision](docs/vision.md)\n- [Scope](docs/scope.md)\n- [Architecture](docs/architecture.md)\n- [Merchant webhooks](docs/merchant-webhooks.md)\n- [Merchant webhook operations](docs/merchant-webhook-operations.md)\n- [Observability](docs/observability.md)\n- [CI](docs/ci.md)\n\n## Observability and alerting\n\nThe repository includes local examples for:\n\n- Prometheus metrics scraping;\n- Grafana dashboards;\n- Alertmanager routing;\n- n8n workflows for Telegram alert delivery.\n\nStart with:\n\n- [Observability](docs/observability.md)\n- [Alerting](docs/alerting.md)\n- [Alertmanager routing](docs/alertmanager-routing.md)\n- [n8n Alertmanager workflow](docs/n8n-alertmanager-workflow.md)\n- [n8n Telegram notifications](docs/n8n-telegram-notifications.md)\n\n## Releases\n\nRelease documentation currently focuses on the WooCommerce gateway:\n\n- [WooCommerce gateway 0.1.1](docs/releases/woocommerce-gateway-0.1.1.md)\n- [WooCommerce gateway 0.1.2](docs/releases/woocommerce-gateway-0.1.2.md)\n- [WooCommerce gateway 0.1.3 public release notes](docs/releases/woocommerce-gateway-0.1.3-public.md)\n\nGenerated release ZIPs belong in `dist/`, which is intentionally ignored by Git.\n\n## License\n\nThis project is licensed under the terms included in [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpitill0%2Feuroledger-xrpl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpitill0%2Feuroledger-xrpl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpitill0%2Feuroledger-xrpl/lists"}