v0.1.0-dev: initial public extraction + new abstractions

cardano_checkout/__init__.py

@@ -0,0 +1,48 @@
+"""cardano_checkout — Python SDK for merchant-side Cardano payments + NFT cert minting.
+
+Zero-custody by design: consumers provide a wallet xpub (account-level
+extended public key). The SDK derives unique receive addresses per
+invoice, polls the chain for payment, and (optionally) mints a CIP-25
+NFT certificate of authenticity on confirmation.
+
+Quick start::
+
+    from cardano_checkout import addresses, oracles
+
+    addr = addresses.derive_address(xpub_hex, index=42, network="mainnet")
+    price = await oracles.get_ada_usd_price()
+    lovelace = await oracles.convert_usd_to_lovelace(99.00)
+
+For full invoice lifecycle see :mod:`cardano_checkout.invoice` +
+:mod:`cardano_checkout.store` (Protocol-based persistence).
+
+For NFT minting see :mod:`cardano_checkout.mint`.
+"""
+
+from __future__ import annotations
+
+__version__ = "0.1.0-dev"
+
+# Pure modules — stable API from extraction
+from cardano_checkout import addresses, oracles  # noqa: F401
+
+# Payment lifecycle
+from cardano_checkout.invoice import Invoice, InvoiceStatus  # noqa: F401
+from cardano_checkout.store import InvoiceStore  # noqa: F401
+
+# NFT + IPFS
+from cardano_checkout.mint import MintPolicy, mint_nft_cert  # noqa: F401
+from cardano_checkout.ipfs import IPFSClient, pin_bytes  # noqa: F401
+
+__all__ = [
+    "__version__",
+    "addresses",
+    "oracles",
+    "Invoice",
+    "InvoiceStatus",
+    "InvoiceStore",
+    "MintPolicy",
+    "mint_nft_cert",
+    "IPFSClient",
+    "pin_bytes",
+]