greenlandai (Python)
Unified SDK for the GreenlandAI ecosystem — ENYAL, JoulePAI, RAREEAI, GreenlandAI.
Supersedes but does not replace enyal-sdk v2.1.x (permanent coexistence — the
standalone enterprise track stays published and maintained; see design §5).
Install
pip install greenlandai # core
pip install "greenlandai[bip39]" # + mnemonic recovery primitives
pip install "greenlandai[otel]" # + OpenTelemetry metrics (opt-in; OFF by default)
Auth
from greenlandai import Client
client = Client(api_key="eyl_...") # eyl_ (ENYAL / cross-product) API key
client = Client(api_key="gai_...") # gai_ (GreenlandAI agent key) — for the gldai intelligence family
client = Client(oauth_token=jwt) # web sessions: ENYAL-issued OAuth JWT
# Any api_key → X-API-Key; an oauth_token (JWT) → Authorization: Bearer. Pass exactly one.
# Passing an API key via oauth_token (or a JWT via api_key) raises immediately — no silent mis-route.
# 401s surface to you (no auto-refresh); hook: Client(..., on_auth_expired=cb)
# Key rotation = generate a new key server-side and rebuild the Client (no dual-validation window).
gai_+ marketplace — resolved in 0.3.2:client.rareeai.*now routes through the GreenlandAI door (greenlandai.ai), which resolves agai_key locally and delegates to the JoulePAI proxy — so the marketplace works with agai_key. (<= 0.3.1pointed at joulepai.ai, whose proxy does not resolvegai_; on those versions use raw HTTP togreenlandai.ai/api/v1/marketplace/*.)eyl_/ OAuth marketplace access is unaffected.
Hello world (one per submodule)
client.enyal.archive("agent-1", "decision_record", "k1", {"decision": "x"})
client.joulepai.transfer("@bob", 1000, note="thanks") # auto idempotency key
client.rareeai.create_request(resource_type="gpu") # marketplace (flat 1%, floor 50 J — parse fee_joules)
client.rareeai.oracle_assignments() # oracle queue (0.3.6; the pool is invite-only at launch)
client.gldai.query("lithium deposits greenland")
Idempotency promise matrix (auto-retry behavior — design §6, post-G1 2026-06-10)
| Method (py / js) | Wire class | Tier | Auto-retry |
|---|---|---|---|
| enyal.archive | A body client_chunk_id | ENFORCED | ON |
| enyal.timestamp / create_agreement | A body client_chunk_id | ENFORCED | ON |
| enyal.compliance_attest | A body client_attestation_id | ENFORCED | ON |
| enyal.prove / prove_batch / prove_share_combination | B body idempotency_key | ENFORCED | ON |
| enyal.disclose / request_client_disclosure | B | ENFORCED | ON |
| enyal.send_message | B | ENFORCED | ON |
| enyal.knowledge_upgrade · memory_structured_query · memory_content_query · queue_proof | — | NOT SUPPORTED | OFF (retries may duplicate billed effects) |
| joulepai.transfer (pay) | D body idempotency_key (proc-enforced) | ENFORCED | ON |
| joulepai.fund | — | NOT SUPPORTED | OFF (duplicate Stripe sessions possible) |
| rareeai.create_provider/create_request/deliver/resolve | B | ENFORCED | ON |
| rareeai.approve/reject/dispute/extend_dispute | — | NOT SUPPORTED | OFF |
| gldai metered queries (companies/deposits/infrastructure/query/projects/mapdata) | C header X-Idempotency-Key | ENFORCED | ON |
| all GET reads | — | safe | ON |
Every billed call auto-generates a UUID4 key (stable across retries) unless you pass idempotency_key / idempotencyKey yourself.
Observability (OFF by default)
Client(logger=my_logger, on_retry=..., on_terminal_failure=..., metrics=otel_metrics()) —
DEBUG logs redact Authorization + X-API-Key structurally.
Migration from enyal-sdk 2.1.0: see MIGRATION.md. Changelog: CHANGELOG.md.
1 maintainer
Metadata
1 maintainer
Release files for greenlandai 0.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| greenlandai-0.5.0.tar.gz | 53.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| greenlandai-0.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 103.0 kB
Release files / greenlandai-0.5.0.tar.gz
| Download URL | greenlandai-0.5.0.tar.gz |
|---|---|
| Size | 53.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5b16285f1b424d0f5662fa78bf383a6c3fa7a76747e1ae43170ed68a45e253fe
|
|
BLAKE2b-256 checksum How to use checksums |
29278b2dca498322a5effeea47103cd44d9bfb2b8ed2590c8829d37f6d3efedb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / greenlandai-0.5.0-py3-none-any.whl
| Download URL | greenlandai-0.5.0-py3-none-any.whl |
|---|---|
| Size | 49.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cbb6ad75e1cf68329e67d5b795088926b63ae19cecfe11bfec7ea9907bfe6dc3
|
|
BLAKE2b-256 checksum How to use checksums |
5c6d9e82531d7c25e934863c3243dc30827bd3f83014e3d3e08d9950c006f755
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
