kortana-dev-sdk 1.0.0

Official Kortana SDK for Python

kortana-dev-sdk — Official Kortana Python SDK

The official Python SDK for the Kortana blockchain payments platform.

Installation

pip install kortana-dev-sdk
# or
poetry add kortana-dev-sdk

Quick Start

import asyncio
import os
from kortana import kortana

async def main():
    async with kortana(
        api_key=os.environ["KORTANA_API_KEY"],
        environment="mainnet",
    ) as client:
        # Check network status
        status = await client.blockchain.get_network_status()
        print(f"Block: {status.block_number}")

        # Get wallet balance
        balance = await client.wallets.get_balance()
        print(f"Balance: {balance.available} DNR")

        # Create a payment link
        link = await client.payments.create_link(
            amount=1_000_000_000_000_000_000,  # 1 DNR in wei
            currency="DNR",
            description="Invoice #1001",
        )
        print(f"Payment URL: {link.url}")

asyncio.run(main())

Webhook Verification

from kortana import kortana

client = kortana(api_key="kt_live_...", webhook_secret="whsec_...")

@app.post("/webhooks")
async def handle_webhook(request: Request):
    payload = await request.body()
    signature = request.headers.get("X-Kortana-Signature", "")
    event = client.validate_webhook(payload.decode(), signature)
    if event["type"] == "transfer.completed":
        print("Transfer done!", event["data"])
    return {"received": True}

Modules

Module	Description
client.blockchain	Read-only blockchain data (blocks, txs, gas)
client.contracts	Deploy and interact with smart contracts
client.wallets	HD wallet management and transfers
client.payments	Payment intents, invoices, subscriptions
client.banking	Customer and bank account management
client.cards	Virtual and physical card issuance
client.compliance	KYC, KYB, and AML screening
client.settlement	Ledger settlement and treasury
client.merchants	Merchant onboarding and management

Requirements

• Python 3.9+
• httpx >= 0.27
• pydantic >= 2.5

License

MIT © Kortana Labs