Metadata-Version: 2.1
Name: ogwallet-ct-lib
Version: 0.2.0
Summary: 
Author: Angel R. L.
Author-email: angel.delriolobato@onchainlabs.ch
Requires-Python: >=3.11,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: requests (>=2.32.3,<3.0.0)
Description-Content-Type: text/markdown

# CT OgWallet Integration Library

## Installation

```bash
pip install ogwallet-ct-lib
```

or with poetry:

```bash
poetry add ogwallet-ct-lib
```

## Usage

### Login

#### Step 1: Generate login URL and redirect user to it

```python
from ct_lib.og_wallet import OgWallet, GenerateLoginUrlResponse, AuthenticateResponse

base_url = "https://www.example.com/api/v1"
client_id = "client_id"
client_secret = "client_secret"

og_wallet = OgWallet(base_url, client_id, client_secret) # raises error on missing or invalid credentials/URL

# generate login URL
try:
    response = og_wallet.generate_login_url("http://crowdtransfer.com/login_callback", ["scope1", "scope2"])
except ValueError as e:
    print("Invalid URL or scopes provided!")
except RuntimeError as e:
    print("Network error or server responded with non 2xx status code!")
except Exception as e:
    print(f"An unexpected error occurred: {e}")

if not isinstance(response, GenerateLoginUrlResponse):
    print(f"Failed to generate login URL")
    exit(1)

login_url = response["url"]
# redirect user to login_url...
```

The user now logs in and authorizes the scopes. The user is then redirected back to the callback URL with the auth token.

#### Step 2: Handle login callback

```python
from django.http import HttpResponse
from ct_lib.og_wallet import OgWallet, GenerateLoginUrlResponse, AuthenticateResponse

og_wallet = OgWallet(base_url, client_id, client_secret)

def og_wallet_login_callback(request):
    token = request.GET.get("token")

    if not token:
        return HttpResponse("Token not found in request", status=400)

    try:
        response = og_wallet.authenticate(token)
    except ValueError as e:
        return HttpResponse("Invalid token provided!", status=400)
    except RuntimeError as e:
        return HttpResponse("Network error or server responded with non 2xx status code!", status=500)
    except Exception as e:
        return HttpResponse(f"An unexpected error occurred: {e}", status=500)

    if not isinstance(response, AuthenticateResponse):
        return HttpResponse("Unexpected response from server", status=500)

    print(f"User authenticated: {response.id} - {response.email}")

### rest of the code...
```

## Development

### Requirements
- Python 3.11
- Poetry

```bash
poetry install
```

### Testing

```bash
poetry run pytest
```



