rosud 0.1.0__tar.gz

rosud-0.1.0/.gitignore

@@ -0,0 +1,42 @@
+# Dependencies - NEVER commit these
+node_modules/
+.pnp/
+.pnp.js
+
+# Next.js build
+.next/
+out/
+dist/
+build/
+
+# Python
+__pycache__/
+*.pyc
+*.pyo
+.pytest_cache/
+*.egg-info/
+.venv/
+venv/
+env/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+!*.example
+
+# Logs
+*.log
+npm-debug.log*
+
+# OS
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode/
+.idea/
+
+__pycache__/
+*.pyc
+.pytest_cache/

rosud-0.1.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: rosud
+Version: 0.1.0
+Summary: Rosud Python SDK - AI 에이전트 자율 USDC 결제 인프라
+Project-URL: Homepage, https://rosud.com
+Project-URL: Documentation, https://docs.rosud.com
+Project-URL: Repository, https://github.com/rosud-com/rosud-python
+Project-URL: Issues, https://github.com/rosud-com/rosud-python/issues
+Author-email: Rosud Team <team@rosud.com>
+License: MIT
+Keywords: agents,ai,payments,stablecoin,usdc,web3
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: autogen
+Requires-Dist: pyautogen>=0.2.0; extra == 'autogen'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: respx>=0.20.0; extra == 'dev'
+Provides-Extra: langchain
+Requires-Dist: langchain>=0.1.0; extra == 'langchain'
+Description-Content-Type: text/markdown
+
+# rosud · Python SDK
+
+> AI agent USDC payment infrastructure — Official Python SDK
+
+```bash
+pip install rosud
+```
+
+## Quick Start
+
+```python
+import rosud
+
+client = rosud.Rosud(api_key="rosud_live_xxx")
+# or set ROSUD_API_KEY environment variable
+
+# Create a payment
+payment = client.payments.create(
+    amount=5.00,
+    to="0x742d35Cc6634C0532925a3b8D4C9E3Ff9C4A6bB",
+    memo="api_call_fee",
+)
+print(payment.status)   # "confirmed"
+print(payment.tx_hash)  # "0x..."
+
+# Check balance
+balance = client.wallets.balance()
+print(f"Balance: {balance.usdc} USDC")
+```
+
+## Async
+
+```python
+import asyncio
+import rosud
+
+async def main():
+    client = rosud.AsyncRosud(api_key="rosud_live_xxx")
+    payment = await client.payments.create(amount=1.00, to="0x...")
+    await client.close()
+
+asyncio.run(main())
+```
+
+## Resources
+
+- **Payments** — `client.payments.create()`, `.list()`, `.get()`
+- **Agents** — `client.agents.create()`, `.list()`, `.get()`, `.delete()`
+- **Wallets** — `client.wallets.balance()`
+- **Webhooks** — `client.webhooks.create()`, `.list()`, `.delete()`
+
+## Error Handling
+
+```python
+from rosud.exceptions import RosudAPIError, RosudAuthError
+
+try:
+    payment = client.payments.create(amount=5.00, to="0x...")
+except RosudAuthError:
+    print("Invalid API key")
+except RosudAPIError as e:
+    print(e.status_code, e.message)
+```
+
+## Links
+
+- [Dashboard](https://rosud.com/dashboard)
+- [API Docs](https://rosud.com/docs)
+- [TypeScript SDK](https://www.npmjs.com/package/rosud)
+- [MCP Server](https://pypi.org/project/rosud-mcp)

rosud-0.1.0/README.md

@@ -0,0 +1,70 @@
+# rosud · Python SDK
+
+> AI agent USDC payment infrastructure — Official Python SDK
+
+```bash
+pip install rosud
+```
+
+## Quick Start
+
+```python
+import rosud
+
+client = rosud.Rosud(api_key="rosud_live_xxx")
+# or set ROSUD_API_KEY environment variable
+
+# Create a payment
+payment = client.payments.create(
+    amount=5.00,
+    to="0x742d35Cc6634C0532925a3b8D4C9E3Ff9C4A6bB",
+    memo="api_call_fee",
+)
+print(payment.status)   # "confirmed"
+print(payment.tx_hash)  # "0x..."
+
+# Check balance
+balance = client.wallets.balance()
+print(f"Balance: {balance.usdc} USDC")
+```
+
+## Async
+
+```python
+import asyncio
+import rosud
+
+async def main():
+    client = rosud.AsyncRosud(api_key="rosud_live_xxx")
+    payment = await client.payments.create(amount=1.00, to="0x...")
+    await client.close()
+
+asyncio.run(main())
+```
+
+## Resources
+
+- **Payments** — `client.payments.create()`, `.list()`, `.get()`
+- **Agents** — `client.agents.create()`, `.list()`, `.get()`, `.delete()`
+- **Wallets** — `client.wallets.balance()`
+- **Webhooks** — `client.webhooks.create()`, `.list()`, `.delete()`
+
+## Error Handling
+
+```python
+from rosud.exceptions import RosudAPIError, RosudAuthError
+
+try:
+    payment = client.payments.create(amount=5.00, to="0x...")
+except RosudAuthError:
+    print("Invalid API key")
+except RosudAPIError as e:
+    print(e.status_code, e.message)
+```
+
+## Links
+
+- [Dashboard](https://rosud.com/dashboard)
+- [API Docs](https://rosud.com/docs)
+- [TypeScript SDK](https://www.npmjs.com/package/rosud)
+- [MCP Server](https://pypi.org/project/rosud-mcp)

rosud-0.1.0/examples/async_example.py

@@ -0,0 +1,105 @@
+"""
+비동기 사용 예시 - Rosud Python SDK
+
+asyncio 또는 비동기 프레임워크(FastAPI, aiohttp 등)와 함께 사용하는 예시
+"""
+import asyncio
+import os
+
+import rosud
+from rosud.exceptions import RosudError
+
+
+async def single_payment_example() -> None:
+    """단순 비동기 결제 예시"""
+    client = rosud.AsyncRosud(api_key=os.environ.get("ROSUD_API_KEY", "rosud_live_xxx"))
+
+    try:
+        payment = await client.payments.create(
+            amount=1.00,
+            to="0xRecipientAddress",
+            memo="async_payment",
+        )
+        print(f"결제 완료: {payment.id} ({payment.status})")
+    except RosudError as e:
+        print(f"결제 오류: {e.message}")
+    finally:
+        await client.aclose()
+
+
+async def concurrent_payments_example() -> None:
+    """여러 결제를 동시에 처리하는 예시 (고성능)"""
+    async with rosud.AsyncRosud(api_key=os.environ.get("ROSUD_API_KEY", "rosud_live_xxx")) as client:
+        # 병렬로 여러 작업 실행
+        balance_task = client.wallets.get_balance()
+        payments_task = client.payments.list(limit=5)
+
+        balance, payments = await asyncio.gather(balance_task, payments_task)
+
+        print(f"현재 잔액: {balance.amount} USDC")
+        print(f"최근 결제 {len(payments)}건:")
+        for p in payments:
+            print(f"  - {p.id}: {p.amount} USDC ({p.status})")
+
+
+async def batch_payments_example() -> None:
+    """배치 결제 처리 예시"""
+    recipients = [
+        {"to": "0xRecipient1", "amount": 1.00, "memo": "service_fee_1"},
+        {"to": "0xRecipient2", "amount": 2.50, "memo": "service_fee_2"},
+        {"to": "0xRecipient3", "amount": 0.50, "memo": "service_fee_3"},
+    ]
+
+    async with rosud.AsyncRosud(api_key=os.environ.get("ROSUD_API_KEY", "rosud_live_xxx")) as client:
+        # 모든 결제를 동시에 처리
+        tasks = [
+            client.payments.create(
+                amount=r["amount"],
+                to=r["to"],
+                memo=r["memo"],
+                idempotency_key=f"batch-{i}",  # 중복 방지
+            )
+            for i, r in enumerate(recipients)
+        ]
+
+        results = await asyncio.gather(*tasks, return_exceptions=True)
+
+        for i, result in enumerate(results):
+            if isinstance(result, Exception):
+                print(f"결제 {i+1} 실패: {result}")
+            else:
+                print(f"결제 {i+1} 성공: {result.id} ({result.status})")
+
+
+async def webhook_setup_example() -> None:
+    """웹훅 설정 예시"""
+    async with rosud.AsyncRosud(api_key=os.environ.get("ROSUD_API_KEY", "rosud_live_xxx")) as client:
+        try:
+            webhook = await client.webhooks.create(
+                url="https://myapp.com/webhooks/rosud",
+                events=["payment.confirmed", "payment.failed"],
+                secret="my-super-secret-hmac-key",
+            )
+            print(f"웹훅 등록 완료: {webhook.id}")
+            print(f"URL: {webhook.url}")
+            print(f"구독 이벤트: {webhook.events}")
+        except RosudError as e:
+            print(f"웹훅 등록 실패: {e.message}")
+
+
+async def main() -> None:
+    print("=== 단순 결제 ===")
+    await single_payment_example()
+
+    print("\n=== 병렬 처리 ===")
+    await concurrent_payments_example()
+
+    print("\n=== 배치 결제 ===")
+    await batch_payments_example()
+
+    print("\n=== 웹훅 설정 ===")
+    await webhook_setup_example()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

rosud-0.1.0/examples/autogen_agent.py

@@ -0,0 +1,197 @@
+"""
+AutoGen 통합 예시 - Rosud Python SDK
+
+Microsoft AutoGen 프레임워크와 Rosud를 통합하여
+AI 에이전트가 자율적으로 USDC 결제를 처리하는 예시.
+
+설치:
+    pip install rosud-python pyautogen
+"""
+import os
+from typing import Annotated, Optional
+
+import rosud
+from rosud.exceptions import PaymentError, RosudError
+
+# Rosud 클라이언트 초기화
+client = rosud.Rosud(api_key=os.environ.get("ROSUD_API_KEY", "rosud_live_xxx"))
+
+
+# ──────────────────────────────────────────────────────────
+# AutoGen 함수 정의 (에이전트가 호출할 함수들)
+# ──────────────────────────────────────────────────────────
+
+def make_payment(
+    amount: Annotated[float, "Payment amount in USDC"],
+    recipient: Annotated[str, "Recipient wallet address (0x...)"],
+    memo: Annotated[str, "Payment memo or description"] = "",
+) -> str:
+    """Make a USDC payment via Rosud.
+
+    This function allows an AI agent to make cryptocurrency payments
+    in USDC on the Base L2 network.
+    """
+    try:
+        payment = client.payments.create(
+            amount=amount,
+            to=recipient,
+            memo=memo or "autogen_payment",
+        )
+        return (
+            f"Payment successful!\n"
+            f"  ID: {payment.id}\n"
+            f"  Amount: {payment.amount} USDC\n"
+            f"  Recipient: {payment.to_wallet}\n"
+            f"  Status: {payment.status}\n"
+            f"  TX Hash: {payment.tx_hash or 'pending'}"
+        )
+    except PaymentError as e:
+        return f"Payment failed: {e.message} (code: {e.error_code})"
+    except RosudError as e:
+        return f"Error: {e.message}"
+
+
+def get_balance() -> str:
+    """Get current USDC wallet balance."""
+    try:
+        balance = client.wallets.get_balance()
+        return (
+            f"Wallet Balance:\n"
+            f"  Amount: {balance.amount} {balance.currency}\n"
+            f"  Network: {balance.network}\n"
+            f"  Address: {balance.address}"
+        )
+    except RosudError as e:
+        return f"Error getting balance: {e.message}"
+
+
+def get_payment_history(limit: Annotated[int, "Number of payments to retrieve"] = 5) -> str:
+    """Get recent payment history."""
+    try:
+        payments = client.payments.list(limit=limit)
+        if not payments.items:
+            return "No payments found."
+
+        lines = [f"Recent {len(payments)} payment(s) (total: {payments.total}):"]
+        for p in payments:
+            lines.append(
+                f"  [{p.status.upper()}] {p.amount} USDC → "
+                f"{p.to_wallet[:12]}... | {p.created_at:%Y-%m-%d %H:%M}"
+            )
+        return "\n".join(lines)
+    except RosudError as e:
+        return f"Error: {e.message}"
+
+
+# ──────────────────────────────────────────────────────────
+# AutoGen 에이전트 실행 예시
+# ──────────────────────────────────────────────────────────
+
+def run_autogen_example() -> None:
+    """AutoGen ConversableAgent 예시"""
+    try:
+        import autogen
+        from autogen import ConversableAgent, UserProxyAgent
+
+        # LLM 설정
+        llm_config = {
+            "config_list": [
+                {
+                    "model": "gpt-4",
+                    "api_key": os.environ.get("OPENAI_API_KEY"),
+                }
+            ],
+            "temperature": 0,
+        }
+
+        # AI 에이전트 (결제 처리 담당)
+        payment_agent = ConversableAgent(
+            name="PaymentAgent",
+            system_message=(
+                "You are a payment processing agent. "
+                "You can check wallet balances and make USDC payments. "
+                "Always check the balance before making payments. "
+                "Be careful and confirm the recipient address before paying."
+            ),
+            llm_config=llm_config,
+        )
+
+        # Function 등록
+        payment_agent.register_for_llm(name="make_payment", description="Make a USDC payment")(make_payment)
+        payment_agent.register_for_llm(name="get_balance", description="Check wallet balance")(get_balance)
+        payment_agent.register_for_llm(name="get_payment_history", description="Get payment history")(get_payment_history)
+
+        # UserProxy (함수 실행자)
+        user_proxy = UserProxyAgent(
+            name="UserProxy",
+            human_input_mode="NEVER",
+            max_consecutive_auto_reply=5,
+            is_termination_msg=lambda x: "TERMINATE" in x.get("content", ""),
+        )
+
+        user_proxy.register_for_execution(name="make_payment")(make_payment)
+        user_proxy.register_for_execution(name="get_balance")(get_balance)
+        user_proxy.register_for_execution(name="get_payment_history")(get_payment_history)
+
+        # 대화 시작
+        user_proxy.initiate_chat(
+            payment_agent,
+            message=(
+                "Please check my wallet balance and show me the last 3 payments. "
+                "If my balance is over 10 USDC, pay 1.50 USDC to "
+                "0xServiceProvider123 with memo 'autogen_test'. "
+                "Reply TERMINATE when done."
+            ),
+        )
+
+    except ImportError:
+        print("AutoGen이 설치되지 않았습니다. pip install pyautogen 을 실행하세요.")
+        print("\n직접 함수 테스트:")
+        print(get_balance())
+        print("\n" + get_payment_history(3))
+
+
+# ──────────────────────────────────────────────────────────
+# AutoGen v0.4+ (새 API) 예시
+# ──────────────────────────────────────────────────────────
+
+def run_autogen_v04_example() -> None:
+    """AutoGen v0.4+ AssistantAgent 예시"""
+    try:
+        from autogen_agentchat.agents import AssistantAgent
+        from autogen_agentchat.ui import Console
+        from autogen_ext.models.openai import OpenAIChatCompletionClient
+
+        # 도구 함수들
+        async def async_get_balance() -> str:
+            async with rosud.AsyncRosud(api_key=os.environ.get("ROSUD_API_KEY")) as c:
+                balance = await c.wallets.get_balance()
+                return f"{balance.amount} {balance.currency} on {balance.network}"
+
+        async def async_make_payment(amount: float, to: str, memo: str = "") -> str:
+            async with rosud.AsyncRosud(api_key=os.environ.get("ROSUD_API_KEY")) as c:
+                payment = await c.payments.create(amount=amount, to=to, memo=memo)
+                return f"Payment {payment.id}: {payment.status} ({payment.amount} USDC)"
+
+        model_client = OpenAIChatCompletionClient(model="gpt-4o")
+
+        agent = AssistantAgent(
+            "payment_agent",
+            model_client=model_client,
+            tools=[async_get_balance, async_make_payment],
+            system_message=(
+                "You are a payment agent. "
+                "Use the available tools to check balance and make payments."
+            ),
+        )
+
+        import asyncio
+        asyncio.run(Console(agent.run_stream(task="Check my USDC balance")))
+
+    except ImportError:
+        print("autogen-agentchat이 설치되지 않았습니다.")
+
+
+if __name__ == "__main__":
+    print("=== AutoGen + Rosud 통합 예시 ===\n")
+    run_autogen_example()

rosud-0.1.0/examples/basic_payment.py

@@ -0,0 +1,108 @@
+"""
+기본 결제 예시 - Rosud Python SDK
+
+이 예시는 Rosud SDK의 기본 사용법을 보여줍니다:
+- 결제 생성
+- 결제 목록 조회
+- 지갑 잔액 조회
+- 에이전트 생성
+"""
+import os
+
+import rosud
+from rosud.exceptions import InsufficientFundsError, PaymentError, RosudError
+
+
+def main() -> None:
+    # API 키 설정 (환경변수 또는 직접 전달)
+    client = rosud.Rosud(
+        api_key=os.environ.get("ROSUD_API_KEY", "rosud_live_your_key_here"),
+        base_url=os.environ.get("ROSUD_BASE_URL", "https://api.rosud.com"),
+    )
+
+    # ──────────────────────────────────────────────
+    # 1. 지갑 잔액 확인
+    # ──────────────────────────────────────────────
+    print("=== 지갑 잔액 ===")
+    try:
+        balance = client.wallets.get_balance()
+        print(f"잔액: {balance.amount} {balance.currency}")
+        print(f"주소: {balance.address}")
+        print(f"네트워크: {balance.network}")
+    except RosudError as e:
+        print(f"잔액 조회 실패: {e.message}")
+
+    # ──────────────────────────────────────────────
+    # 2. 결제 생성
+    # ──────────────────────────────────────────────
+    print("\n=== 결제 생성 ===")
+    try:
+        payment = client.payments.create(
+            amount=5.00,
+            currency="USDC",
+            to="0xRecipientWalletAddress123456789012345678",
+            memo="api_call_fee",
+            idempotency_key="unique-payment-key-001",  # 중복 방지
+        )
+        print(f"결제 ID: {payment.id}")
+        print(f"상태: {payment.status}")
+        print(f"금액: {payment.amount} {payment.currency}")
+        print(f"수신자: {payment.to_wallet}")
+        print(f"TX Hash: {payment.tx_hash or '(pending)'}")
+    except InsufficientFundsError:
+        print("잔액이 부족합니다.")
+    except PaymentError as e:
+        print(f"결제 오류 [{e.error_code}]: {e.message}")
+    except RosudError as e:
+        print(f"오류: {e.message}")
+
+    # ──────────────────────────────────────────────
+    # 3. 결제 목록 조회
+    # ──────────────────────────────────────────────
+    print("\n=== 최근 결제 목록 ===")
+    try:
+        payments = client.payments.list(limit=10)
+        print(f"총 {payments.total}건 중 {len(payments)}건 조회")
+        for p in payments:
+            print(f"  - {p.id} | {p.amount} USDC | {p.status} | {p.created_at:%Y-%m-%d %H:%M}")
+    except RosudError as e:
+        print(f"결제 목록 조회 실패: {e.message}")
+
+    # ──────────────────────────────────────────────
+    # 4. 에이전트 생성 (AI 에이전트용 서브계정)
+    # ──────────────────────────────────────────────
+    print("\n=== 에이전트 생성 ===")
+    try:
+        agent = client.agents.create(
+            name="Payment Bot v1",
+            spending_limit_daily=100.00,      # 일 100 USDC 한도
+            spending_limit_per_tx=10.00,       # 건당 10 USDC 한도
+            allowed_recipients=[               # 화이트리스트 (보안)
+                "0xApprovedRecipient1",
+                "0xApprovedRecipient2",
+            ],
+        )
+        print(f"에이전트 ID: {agent.id}")
+        print(f"에이전트 이름: {agent.name}")
+        print(f"API 키: {agent.api_key}")  # 최초 1회만 반환!
+        print("⚠️  API 키를 안전하게 보관하세요. 다시 조회할 수 없습니다.")
+    except RosudError as e:
+        print(f"에이전트 생성 실패: {e.message}")
+
+    # ──────────────────────────────────────────────
+    # 5. context manager 사용법
+    # ──────────────────────────────────────────────
+    print("\n=== Context Manager 사용 ===")
+    with rosud.Rosud(api_key=os.environ.get("ROSUD_API_KEY", "rosud_live_key")) as c:
+        try:
+            balance = c.wallets.get_balance()
+            print(f"잔액: {balance.amount} USDC")
+        except RosudError as e:
+            print(f"오류: {e}")
+
+    client.close()
+    print("\n완료!")
+
+
+if __name__ == "__main__":
+    main()